| 環境 | 管理画面 | API |
|---|
| Sandbox | admin.sandbox.zafapay.com | api.sandbox.zafapay.com |
| Production | admin.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": 1000,
"currency": "usd",
"external_id": "order_12345"
}'
{
"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 に顧客をリダイレクトします。
決済完了後、顧客は加盟店管理画面で設定した success_redirect_url または failure_redirect_url にリダイレクトされます。
4. 決済結果を確認
curl https://api.sandbox.zafapay.com/v1/payments/tx_abc123 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"id": "tx_abc123",
"status": "completed",
"amount": 1000,
"currency": "usd"
}
次のステップ
