本文へ移動

加盟店 API ​

GMPayは主要な決済プロトコルです。EPayは、同じ認証情報、注文サービス、冪等性ルール、状態遷移、チェックアウト、クエリ動作、およびコールバックパイプラインとの互換性を実現するためのアダプターです。

権威のあるフィールドやステータス値については、デプロイされたインスタンスの/docsページ、またはリポジトリの追跡されたOpenAPI仕様を使用してください:public/openapi.yaml.

GMPay の署名 ​

GMPay リクエストには数値の pid と、小文字の16進数で表した HMAC-SHA256 の signature を含めます。

申請を承認するために

  1. signature と空の値を除外します。
  2. ASCII順でフィールドを並べます。
  3. key=value の各組を & で連結します。
  4. 「秘密のクレデンシャルをHMACキーとして使用してください。」
  5. 小文字で 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境界を使用します。