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

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.

環境情報

環境ベースURL説明
サンドボックスhttps://api-sandbox.waffo.comテスト環境。実際の課金は発生しません
本番https://api.waffo.com本番環境
SDKは Environment.SANDBOX / Environment.PRODUCTION で切り替えます。URLを手動で変更する必要はありません。

テスト用カード番号

Credit Card

CC_VISA

カード番号結果
4576750000000110決済成功
4576750000000220決済失敗

CC_MASTERCARD

カード番号結果
2226900000000110決済成功
2226900000000220決済失敗

CC_JCB

カード番号結果
3528000000000214決済成功
3528000000120006決済失敗

CC_AMEX

カード番号結果
3400000000000216決済成功
340000000200027決済失敗

Debit Card

DC_VISA

カード番号結果
4001700000000110決済成功
4001700000000220決済失敗

DC_MASTERCARD

カード番号結果
2226930000000110決済成功
2226930000000220決済失敗

DC_JCB

カード番号結果
3088850000000116決済成功
3088850000200004決済失敗

DC_AMEX

カード番号結果
340034000100009決済成功
340034000400003決済失敗

共通カード情報

有効期限: 任意の未来日付

CVV: 任意の3桁(AMEXは4桁)

サンドボックスシミュレーター

サンドボックスは実際の決済チャネルには接続されていません。シミュレーターを使用して決済結果を直接制御します:
  • ワンタイム決済: オーダー作成後、チェックアウトページを開きます。ページには「Payment Success」および「Payment Failed」ボタンが用意されており、いずれかをクリックすると対応する結果とWebhookがトリガーされます。
  • サブスクリプションの初回決済: ワンタイム決済と同様で、チェックアウトページで操作します。
  • サブスクリプション更新のシミュレーション: POST /api/v1/subscription/manage を呼び出して管理ページURLを取得 → 管理ページを開く → ページに「Simulate Next Payment Success」および「Simulate Next Payment Failed」ボタンが用意されており、クリックごとに1回の更新サイクルをシミュレートします。
サブスクリプション更新管理ページの例:
サブスクリプション更新シミュレーター管理ページの例

Apple Pay / Google Pay のテスト

Checkout または独自フロントエンドで Apple Pay / Google Pay を表示する場合は、通常のサンドボックス決済テストに加えて次の確認を行ってください。

Google Pay

  1. Google Pay のテストアカウントでログインします。
  2. そのアカウントを Google Pay test mode stub data グループ に追加します。
  3. 対象の国または地域が Google Pay 対応国リスト に含まれていることを確認します。
  4. Android App WebView 内で決済ページを読み込む場合は、Google Pay Android WebView 設定 を追加します。
  5. 本番公開前に、Android App は Google Pay 公開ガイド に沿って API 権限を申請する必要があります。
  6. 本番権限が承認されていない場合、ユーザーに OR_BIBED_11 または類似のエラーが表示されることがあります。
本番権限を申請する際は、ゲートウェイ種別として Gateway を選択してください。資料提出後に審査の加速が必要な場合は、Google アカウントの加盟店 MID と app name を Waffo の技術連携グループへ提供してください。

Apple Pay

  1. 加盟店自身の Apple Pay アカウントでテストすることを推奨します。
  2. テストアカウントには有効な Visa、Mastercard、または Amex カードを紐付けてください。
  3. Apple Pay テストでは UnionPay カードはサポートされません。
  4. Service unavailable が表示される場合は、端末またはアカウントの地域設定を確認してください。
  5. Web でテストする場合はグローバルプロキシが必要になることがあります。モバイルで決済リンクから Apple Pay シートを起動する場合は、一部のプロキシ設定で足りる場合があります。
  6. 本番公開前に、対象の国または地域が Apple Pay 対応国リスト に含まれていることを確認します。

Webhookのテスト

サンドボックス環境はWebhookコールバックをサポートしています。notifyUrl がパブリックにアクセス可能であることを確認してください。ローカル開発の場合、イントラネットトンネリングツール(ngrokやcloudflaredなど)の使用を推奨します。
サンドボックスと本番では、異なるAPI KeyおよびRSAキーを使用します。Apple Pay / Google Pay には追加の対応国、WebView、本番権限の要件があります。