互換性・既知の制約

通常の導入ではこのページを読む必要はありません。productionと先行環境の提供差分を確認する場合や、Custom Payment Flowを実装する場合に参照してください。

検証基準

項目	本番REST API	SDK 0.5.0
Gateway注文の `mode`	`live` / `testnet` / `simulate`（staging では `live` → `testnet` に強制変換）	`createOrder({ mode })` で対応。実際のmodeは `OrderApproved.mode`
Gateway注文の `currency`	`JPY`（既定）/ `USD`	`createOrder({ amount, currency })`、response/status/quoteの `amount` / `currency` を型付け
Gateway statusの入金レシート	`underpaid` / `sent_amount` / `expected_amount` / `tx_hash` / `paid_amount` / `paid_currency` / `paid_network`	`CheckoutStatus` の同名camelCase field
Gateway statusの `mode` / `faucets`	responseに含む	`CheckoutStatus` へmapping
Gateway checkout操作	asset選択、見積り更新、ToS、simulate、参照見積り、wallet確認（verify-status / extend-session / reset-verification）、slippage判定	専用methodで対応
TRON / USDT	マーチャントでTron決済が有効な場合	`network: "tron"` とasset quoteに対応
`bridging` state	13番目のcanonical state	`OrderStateName` に明示
`client_secret` 操作	`X-Client-Secret` またはbodyを受付	`retrieve` / `cryptoQuote` / `confirm` のoptionsで対応

SDKが呼ぶendpointはすべてproductionにdeploy済みです。本番REST APIに対する既知のSDK field欠落はありません。

stagingはFireblocks sandbox workspaceで動作するため、mode を省略した注文と mode: "live" の注文は testnet として作成されます（simulate はそのまま）。response / checkoutStatus の mode を参照してください。
未提供のendpointを呼ぶと404になります。

現行本番では次の制約があります。

PaymentIntentのオンチェーン着金を自動反映する配線は未完了
submit_tx endpointは存在しない
E2Eで完結するのは simulate mode
simulateDeposit(id, { amount }) は不足／超過を分岐せず succeeded へ進む。sk_test_… で作成した simulate modeのintentでのみ使用可
mode はREST側で列挙検証されない（3値以外を送ると作成は成功し、後続の simulate_deposit が失敗する）
Idempotency-Key はマーチャント単位で共有される（sk_test と sk_live で同じkeyを使うと既存intentが返る）

本番・testnetのオンチェーン決済にはHosted Checkoutを利用してください。

配信eventは次の3種類です。

payment_intent.created や refund.created は配信されません。Gateway注文（Hosted Checkout）はwebhookを配信しないため、checkoutStatus で照合してください。

配信は初回を含めて最大5回（初回+再送4回、72時間以内）、1回あたりtimeout 5秒、2xxのみ成功、redirectは追従しません。