- ステップ 1
リクエストに署名
タイムスタンプ、メソッド、パス、本文ハッシュの HMAC-SHA256。キーは貴社サーバーにだけ置きます。
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - ステップ 2
決済を作成
金額は最小単位。同じ Idempotency-Key で再送すると同じ決済が返ります。
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - ステップ 3
お客様を支払いへ案内
決済ページが国と通貨に応じた手段を表示し、支払いを受けてお客様を貴社サイトに戻します。
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - ステップ 4
Webhook を受信
署名を検証して注文を支払い済みにします。2xx 応答がなければ 2 日間再試行します。
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
決済の受け付けを始めましょう
ダッシュボードで登録し、会社の審査を受けてください。ストアが承認されるとすぐに API キーを発行します。