Skip to main content

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

加盟店管理画面（https://app.zafapay.com）の「加盟店設定」から、アクセストークンを確認します。 
# 全てのAPIリクエストにAuthorizationヘッダーが必要です
Authorization: Bearer YOUR_ACCESS_TOKEN
詳しい取得方法は認証を参照してください。

​
2. 決済を作成

curl -X POST https://sandbox-orchestration.zafapay.com/v2/payments \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "currency": "jpy",
    "return_url": "https://example.com/complete",
    "external_id": "order_12345"
  }'
レスポンス: 
{
  "id": "txn_abc123",
  "status": "pending",
  "amount": 1000,
  "currency": "jpy",
  "redirect_url": "https://payment.example.com/checkout/xxx",
  "created_at": "2024-01-15T10:30:00Z"
}

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

レスポンスの redirect_url に顧客をリダイレクトします。 決済完了後、顧客は return_url に戻ります。

​
4. 決済結果を確認

curl https://sandbox-orchestration.zafapay.com/v2/payments/txn_abc123 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
レスポンス: 
{
  "id": "txn_abc123",
  "status": "succeeded",
  "amount": 1000,
  "currency": "jpy"
}

​
次のステップ

APIリファレンス

全てのAPIエンドポイントの詳細

返金を実装

決済の返金方法