メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://waffo.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
2つのチェックアウトモード

Waffoは2つのチェックアウト統合モードをサポートしています。ニーズに合ったものをお選びください。
  • Waffoホスト型チェックアウト: 完全な決済ページをWaffoが提供します。ユーザーはWaffo側で決済手段を選択し、決済を完了します。
  • 加盟店構築型チェックアウト(API直接): 加盟店自身で決済ページを構築します。ユーザーは加盟店側で決済手段を選択し、加盟店がAPIパラメータを通じて決済チャネルを指定します。

​
比較

観点Waffo Checkout加盟店構築型チェックアウト
決済手段の選択ユーザーがWaffoチェックアウトページで選択ユーザーが加盟店ページで選択
統合の複雑さ低(リダイレクトのみ)高(カスタムUI + 決済手段パラメータの指定)
決済手段のカバレッジ自動で全カバー。新しい決済手段の追加にコード変更不要サポートリストを手動で保守する必要あり
PCI DSS準拠Waffoが処理加盟店側の責任(カード決済の場合)
UIカスタマイズテーマカラー、ロゴ、言語などをサポート完全カスタム
推奨利用者大半の加盟店独自チェックアウトを持つ大規模加盟店

​
Waffo Checkout: リクエストパラメータ

ユーザーがWaffo側で決済手段を選択する場合、加盟店は payMethodType や payMethodName を渡す必要はありません。Waffoチェックアウトが利用可能なすべての決済手段を自動で表示します。 以下の決済手段については、payMethodType のみ(payMethodName なし)を指定することを推奨します:
決済手段推奨パラメータ理由
カードpayMethodType: "CREDITCARD,DEBITCARD"WaffoがBINを通じてカード種別を自動識別し、ユーザーの選択ステップを削減
VA(バーチャル口座)payMethodType: "VA"ユーザーがチェックアウトページで具体的な銀行を選択
その他省略チェックアウトが利用可能なすべての決済手段を自動で表示

​
最小リクエスト(決済手段の指定なし)

{
  "paymentRequestId": "REQ_20260420_001",
  "merchantOrderId": "ORDER_001",
  "orderCurrency": "IDR",
  "orderAmount": "50000",
  "orderDescription": "Product description",
  "orderRequestedAt": "2026-04-20T12:00:00Z",
  "notifyUrl": "https://merchant.com/webhook",
  "merchantInfo": {
    "merchantId": "M000001"
  },
  "userInfo": {
    "userId": "user_001",
    "userTerminal": "WEB"
  },
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT"
  }
}

​
カード決済の推奨リクエスト

{
  "paymentRequestId": "REQ_20260420_002",
  "merchantOrderId": "ORDER_002",
  "orderCurrency": "USD",
  "orderAmount": "29.99",
  "orderDescription": "Premium Plan",
  "orderRequestedAt": "2026-04-20T12:00:00Z",
  "notifyUrl": "https://merchant.com/webhook",
  "merchantInfo": {
    "merchantId": "M000001"
  },
  "userInfo": {
    "userId": "user_001",
    "userTerminal": "WEB"
  },
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT",
    "payMethodType": "CREDITCARD,DEBITCARD"
  }
}

​
加盟店構築型チェックアウト: リクエストパラメータ

ユーザーは加盟店ページですでに具体的な決済手段を選択済みです。どのチャネルを使用するかをWaffoに伝えるためにパラメータを渡します。
シナリオパラメータの指定方法例
ユーザーがDANAを選択payMethodType + payMethodName"EWALLET" + "DANA"
ユーザーがクレジットカードを選択payMethodType のみ(payMethodName を省略)"CREDITCARD,DEBITCARD"(WaffoがBINで自動識別)
ユーザーがVAを選択payMethodType"VA"(Waffo側でユーザーが具体的な銀行を選択)
カード決済: payMethodName は渡さず、payMethodType のみを渡してください。WaffoがカードのBINを通じてVisa / Mastercard / JCB / AMEXを自動識別します。VA: payMethodType: "VA" のみを渡してください。ユーザーがWaffo側で具体的な銀行を選択します。Eウォレット: ウォレットを指定するには payMethodName を渡します(例: DANA、GCash)。これによりWaffoチェックアウトページをバイパスし、指定ウォレットの決済フローに直接ユーザーを遷移させます。Waffoチェックアウト自体はすべての決済手段をサポートしており、payMethodName を渡すのは、チェックアウトの選択画面を表示せずに特定のウォレットへ直接遷移させるための方法です。

​
Eウォレット直接遷移(DANA)

{
  "paymentRequestId": "REQ_20260420_003",
  "merchantOrderId": "ORDER_003",
  "orderCurrency": "IDR",
  "orderAmount": "50000",
  "orderDescription": "Product description",
  "orderRequestedAt": "2026-04-20T12:00:00Z",
  "notifyUrl": "https://merchant.com/webhook",
  "merchantInfo": {
    "merchantId": "M000001"
  },
  "userInfo": {
    "userId": "user_001",
    "userTerminal": "WEB"
  },
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT",
    "payMethodType": "EWALLET",
    "payMethodName": "DANA"
  }
}

​
カード決済の直接遷移

{
  "paymentRequestId": "REQ_20260420_004",
  "merchantOrderId": "ORDER_004",
  "orderCurrency": "USD",
  "orderAmount": "29.99",
  "orderDescription": "Premium Plan",
  "orderRequestedAt": "2026-04-20T12:00:00Z",
  "notifyUrl": "https://merchant.com/webhook",
  "merchantInfo": {
    "merchantId": "M000001"
  },
  "userInfo": {
    "userId": "user_001",
    "userTerminal": "WEB"
  },
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT",
    "payMethodType": "CREDITCARD,DEBITCARD"
  }
}

​
VAの直接遷移

{
  "paymentRequestId": "REQ_20260420_005",
  "merchantOrderId": "ORDER_005",
  "orderCurrency": "IDR",
  "orderAmount": "100000",
  "orderDescription": "Product description",
  "orderRequestedAt": "2026-04-20T12:00:00Z",
  "notifyUrl": "https://merchant.com/webhook",
  "merchantInfo": {
    "merchantId": "M000001"
  },
  "userInfo": {
    "userId": "user_001",
    "userTerminal": "WEB"
  },
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT",
    "payMethodType": "VA"
  }
}

​
埋め込みオプション

orderAction を受信した後、ユーザーを決済ページへ誘導する方法は3通りあります:
方法推奨シーン備考
リダイレクトWebでのデフォルトwindow.location.href = orderAction.webUrl
iframe埋め込みユーザーを加盟店ページから離脱させたくない場合allow="payment" とReferrer Policyの設定が必要
アプリWebViewモバイルアプリWebView が外部起動、ダウンロード/コピー、URL パラメータの保持に対応しているか確認
詳細な要件については、チェックアウト統合手順と決済手段別の連携注意事項を参照してください。