加盟店 API
GMPayは主要な決済プロトコルです。EPayは、同じ認証情報、注文サービス、冪等性ルール、状態遷移、チェックアウト、クエリ動作、およびコールバックパイプラインとの互換性を実現するためのアダプターです。
権威のあるフィールドやステータス値については、デプロイされたインスタンスの/docsページ、またはリポジトリの追跡されたOpenAPI仕様を使用してください:public/openapi.yaml.
GMPay の署名
GMPay リクエストには数値の pid と、小文字の16進数で表した HMAC-SHA256 の signature を含めます。
申請を承認するために
signatureと空の値を除外します。- ASCII順でフィールドを並べます。
key=valueの各組を&で連結します。- 「秘密のクレデンシャルをHMACキーとして使用してください。」
- 小文字で HMAC-SHA256 を計算する。
秩序を築く
POST /payments/gmpay/v1/order/create-transaction
既存の order_id を再利用しても、別の注文は作成されません。token と network の両方を省略すると、選択可能な注文が作成されます。GMPay Edge は、黙って TRON にデフォルトしないように設計されています。
クエリ順
GET /payments/gmpay/v1/order/query
trade_id と order_id のどちらか一方だけを指定し、注文を作成した認証情報でリクエストに署名します。照会できるのは、その認証情報で作成した注文だけです。
折り返し連絡を受ける
注文を作成する際に、商人(またはシステム)は notify_url を提供します。コールバック先は、SSRF(ステートフル反射型分散型サービス攻撃)対策とセキュリティポリシーを確認する必要があります。
手動で実施されたイベントは、一貫性のあるパターン、保存された試行、制限された再試行、および監査された手動再試行パスを持っています。ハンドラは、パターンを検証し、重複するイベントを同一性を持って処理し、ローカルの状態をコミットした後のみ、確認を行う必要があります。
GMPay のリクエストに対する応答として、処理が成功した場合、シンプルなテキスト形式の "ok" と HTTP 200 ステータスコードを返してください。
EPayとの互換性
EPayとの互換性では、同じ認証情報と注文パイプラインを使用しますが、受信リクエストと互換性のあるコールバックについては、従来のEPayのMD5境界を使用します。