Skip to main content
POST
/
v2
/
payments
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"
}

​
概要

Depotはリダイレクト型の決済フローです。 APIで決済を作成後、顧客をredirect_urlにリダイレクトして決済を完了します。

​
決済フロー

1

決済作成

APIで決済を作成し、redirect_urlを取得
2

顧客をリダイレクト

顧客をredirect_urlにリダイレクト
3

決済完了

顧客が決済を完了すると、return_urlに戻る
4

結果確認

決済取得APIでステータスを確認

​
リクエスト

​
amount
number
required
決済金額（正の整数）
​
currency
string
default:"jpy"
3文字の通貨コード（例: jpy, usd, sgd）
​
return_url
string
required
決済完了後のリダイレクトURL
​
external_id
string
加盟店側の注文ID
​
metadata
object
トランザクションに保存する追加データ

​
レスポンス

​
id
string
トランザクションID（txn_プレフィックス）
​
status
string
ステータス（pending）
​
amount
number
決済金額
​
currency
string
通貨コード
​
redirect_url
string
顧客をリダイレクトする決済ページURL
​
created_at
string
作成日時（ISO 8601形式）
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"
}