クイックスタート

環境

環境	管理画面	API
Sandbox	app.sandbox.zafapay.com	`api.sandbox.zafapay.com`
Production	app.zafapay.com	`api.zafapay.com`

開発・テスト時はSandbox環境をご利用ください。本番環境への切り替えはAPIエンドポイントのURLを変更するだけです。

1. アクセストークンを取得

加盟店管理画面の「加盟店設定」から、アクセストークンを確認します。

# 全てのAPIリクエストにAuthorizationヘッダーが必要です
Authorization: Bearer YOUR_ACCESS_TOKEN

詳しい取得方法は認証を参照してください。

2. 決済を作成

curl -X POST https://api.sandbox.zafapay.com/v1/payments \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "currency": "usd",
    "external_id": "order_12345"
  }'

const response = await fetch('https://api.sandbox.zafapay.com/v1/payments', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 100,
    currency: 'usd',
    external_id: 'order_12345'
  })
});

const payment = await response.json();
console.log(payment.payment_url);

レスポンス:

{
  "success": true,
  "status": "pending",
  "transaction_id": "tx_abc123",
  "gateway_transaction_id": "depot_xxxxx",
  "payment_url": "https://pay.sandbox.zafapay.com/checkout/tx_abc123?sig=xxxxxxxxxxxxxxxx"
}

3. 顧客をリダイレクト

レスポンスの payment_url に顧客をリダイレクトします。決済完了後、顧客は加盟店管理画面で設定したURL（success_redirect_url / failure_redirect_url）にリダイレクトされます。決済ごとに異なるページへ戻したい場合は、決済作成時に success_url / failure_url / cancel_url を指定します。その決済に限り管理画面のデフォルトより優先されます。リダイレクト先URLには request_id・transaction_id・status がクエリパラメータとして付与されます。

4. 決済結果を確認

curl https://api.sandbox.zafapay.com/v1/payments/tx_abc123 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

レスポンス:

{
  "id": "tx_abc123",
  "status": "completed",
  "amount": 100,
  "currency": "usd"
}

はじめに

ダッシュボード

統合ガイド

環境

1. アクセストークンを取得

2. 決済を作成

3. 顧客をリダイレクト

4. 決済結果を確認

次のステップ

APIリファレンス

返金を実装

​環境

​1. アクセストークンを取得

​2. 決済を作成

​3. 顧客をリダイレクト

​4. 決済結果を確認

​次のステップ

APIリファレンス

返金を実装

環境

1. アクセストークンを取得

2. 決済を作成

3. 顧客をリダイレクト

4. 決済結果を確認

次のステップ