# GMPay 注文を作成 

**POST**`https://pay.example.com/payments/gmpay/v1/order/create-transaction`

[リクエスト例 ↓](https://epusdt.com/ja/api/endpoints/create-order#request-example)

サーバーで署名し、購入者を `payment_url` に案内します。`token` と `network` は両方指定するか、両方省略して購入者に選択させます。

## パラメータ 

| フィールド         | 型   | 必須   | 説明                                                                                            |
| ------------- | --- | ---- | --------------------------------------------------------------------------------------------- |
| pid           | 文字列 | はい   | 商人のPIDは、以前は署名鍵を検索するために使用されていました。                                                              |
| order\_id     | 文字列 | はい   | 固有の商用注文ID。32文字以内でお願いします。                                                                      |
| currency      | 文字列 | はい   | 法定通貨。例: usd、cny。                                                                              |
| token         | 文字列 | 条件付き | 受取資産。ネットワークとペアリングするか、または両方を省略します。                                                             |
| network       | 文字列 | 条件付き | 公開設定からのネットワークID、例えばbinance。                                                                   |
| amount        | 数値  | はい   | 0.01を超える金額。                                                                                   |
| notify\_url   | 文字列 | はい   | 非同期実行時の成功コールバックURL。                                                                           |
| redirect\_url | 文字列 | いいえ  | ブラウザの戻るURL。                                                                                   |
| name          | 文字列 | いいえ  | 製品名 または 注文名                                                                                   |
| payment\_type | 文字列 | いいえ  | GMPay がデフォルトです。EPay (大文字・小文字区別なし) は、EPay のコールバック形式を選択し、数値の PID を必要とします。署名には、空でない値を含める必要があります。 |
| signature     | 文字列 | はい   | 64文字の小文字の HMAC-SHA256署名。                                                                      |

サンプルの署名はデモ用の鍵 `epusdt_secret_key` で計算しています。パラメータや鍵を変更したらサーバーで再計算してください。

## 関連資料 

* [決済画面を開く](https://epusdt.com/ja/api/endpoints/open-checkout)
* [署名規則](https://epusdt.com/ja/api/payment#signing)

## レスポンス

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` object  
レスポンス本文のデータ。失敗時は null。

  * `trade_id` string
  * `order_id` string
  * `status` integer
  * `expiration_time` integer
  * `payment_url` string
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

application/jsonレスポンスのフィールド
* `status_code` integer  
処理結果のコード。
* `message` string  
結果を説明するメッセージ。
* `data` null  
レスポンス本文のデータ。失敗時は null。
* `request_id` string  
ログを追跡するためのリクエスト ID。

[error-codes.json ↓](https://epusdt.com/agent-setup/error-codes.json)

**リクエスト例**

ゲートウェイ URL 

```
curl -i -X POST \
  'https://pay.example.com/payments/gmpay/v1/order/create-transaction' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "pid": "1000",
  "order_id": "ORD202605230001",
  "currency": "cny",
  "token": "usdt",
  "network": "tron",
  "amount": 100,
  "notify_url": "https://merchant.example/notify",
  "redirect_url": "https://merchant.example/return",
  "name": "VIP",
  "signature": "6f874b1919d95081835e2809b620e354a5866f5a6dbb2e432d1627f1eb10059d"
}'
```

**レスポンス例**200 · 成功401 · 署名が無効です400 · 10009 · 無効なパラメータ400 · 10041 · 無効な通知URL400 · 10002 · 注文は既に存在します400 · 10004 · 支払い精度の下限額400 · 10014 · ネットワークがオフです。400 · 10016 · 該当する資産が見つかりません。400 · 10003 · 受信アドレスが利用できません。400 · 10005 · 利用可能な住所/金額の組み合わせがありません。

application/json · レスポンスの抜粋

```
{
  "status_code": 200,
  "message": "success",
  "data": {
    "trade_id": "20260523171652123456001",
    "order_id": "ORD202605230001",
    "status": 1,
    "expiration_time": 1779530812,
    "payment_url": "https://pay.example.com/pay/checkout-counter/20260523171652123456001"
  },
  "request_id": "b1344d70-ff19-4543-b601-37abfb3b3686"
}
```
