> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pay247.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建订单

<Note>
  特别说明:

  1. 在调用代付接口时，可能会遇到网络超时或未知异常（接口返回 code=5000），此时业务处理结果是未知的，需要稍后查询代付订单接口，获取订单最新状态。
  2. 如果网络超时可以在2分钟后重试。
</Note>

### 代付流程图

<img src="https://mintcdn.com/gopay/sF8dw_ucY0cv3ekq/api-reference/cn/images/payout.png?fit=max&auto=format&n=sF8dw_ucY0cv3ekq&q=85&s=0525479b4444fadeb436aeeeb42cdb4a" alt="flowchart" width="3670" height="2020" data-path="api-reference/cn/images/payout.png" />

### 请求URL

* `https://gateway.pay247.io/gateway/payout/create`

### 请求方式

* POST

### 请求参数

| 参数名            | 必选 | 类型     | 说明                                         |
| :------------- | :- | :----- | ------------------------------------------ |
| mch\_id        | 是  | string | 商户号                                        |
| mch\_order\_no | 是  | string | 商户订单号                                      |
| currency       | 是  | string | 通道编码                                       |
| amount         | 是  | string | 订单金额，单位元，两位小数                              |
| pay\_method    | 是  | string | 支付方式，如:BANK                                |
| account\_name  | 否  | string | 收款人开户名                                     |
| account\_no    | 是  | string | 收款人账号：如gcash、grabpay, 支付宝、微信账号、银行账号        |
| bank\_code     | 否  | string | 【选填】【银行卡渠道】银行代码                            |
| bank\_branch   | 否  | string | 【选填】【银行卡渠道】支行信息                            |
| notify\_url    | 否  | string | 异步通知地址，也可以自行使用定时查询的方式                      |
| timestamp      | 是  | string | unix时间戳                                    |
| version        | 是  | string | 接口版本: v3.0                                 |
| uuid           | 是  | string | 请求ID: 550e8400-e29b-41d4-a716-446655440000 |
| sign           | 是  | string | 最后追加的签名                                    |

### 返回参数data说明

| 参数名            | 必选 | 类型     | 说明                                                                   |
| :------------- | :- | :----- | -------------------------------------------------------------------- |
| mch\_id        | 是  | string | 商户号                                                                  |
| mch\_order\_no | 是  | string | 商户订单号                                                                |
| order\_no      | 是  | string | 平台订单号                                                                |
| currency       | 是  | string | 订单币种                                                                 |
| amount         | 是  | string | 订单金额                                                                 |
| fee            | 是  | string | 手续费                                                                  |
| status         | 是  | string | 订单状态，CONFIRMING: 待审批；PENDING：等待支付； DEALING：处理中；SUCCESS：转账成功；FAIL：失败； |
| paid\_at       | 否  | string | 支付成功时，返回支付时间                                                         |
| error          | 否  | string | 支付失败时的错误信息                                                           |

**返回示例**

```
{
    "code": 0,
    "message": "Success",
		"timestamp": 1594099906123,
		"uuid": "7eb3c9e-5a1d-4a19-be2a-c80eac39830a",
    "data": {
        "mch_id": "X3DSKDKII2343",
        "mch_order_no": "R898543254325432",
        "order_no": "202007070427475133333",
        "currency": "USD",
        "amount": "99.11",
    		"status": "PENDING",
        "fee": "3.60",
        "paid_at": 1594223431233,
        "error": ""
    }
}
```

### 印度（INR）代付请求参数说明

| 参数名            | 必选 | 类型     | 说明                                         |
| :------------- | :- | :----- | ------------------------------------------ |
| mch\_id        | 是  | string | 商户号                                        |
| mch\_order\_no | 是  | string | 商户订单号                                      |
| currency       | 是  | string | 订单币种 PHP                                   |
| amount         | 是  | string | 订单金额，单位元，两位小数                              |
| pay\_method    | 是  | string | 支付方式，填 BANK                                |
| account\_no    | 是  | string | 收款人账号：如gcash、grabpay,银行账号                  |
| bank\_code     | 是  | string | 银行IFSC                                     |
| notify\_url    | 否  | string | 异步通知地址，也可以自行使用定时查询的方式                      |
| timestamp      | 是  | string | unix时间戳                                    |
| version        | 是  | string | 接口版本: v3.0                                 |
| uuid           | 是  | string | 请求ID: 550e8400-e29b-41d4-a716-446655440000 |
| sign           | 是  | string | 最后追加的签名                                    |

### 菲律宾比索（PHP）代付请求参数说明

| 参数名            | 必选 | 类型     | 说明                                                           |
| :------------- | :- | :----- | ------------------------------------------------------------ |
| mch\_id        | 是  | string | 商户号                                                          |
| mch\_order\_no | 是  | string | 商户订单号                                                        |
| currency       | 是  | string | 订单币种 PHP                                                     |
| amount         | 是  | string | 订单金额，单位元，两位小数                                                |
| pay\_method    | 是  | string | 支付方式 固定 BANK                                                 |
| account\_no    | 是  | string | 收款人账号：如gcash、grabpay,银行账号                                    |
| bank\_code     | 是  | string | [银行代码 ](https://docs.pay247.io/api-reference/common/bank_ph) |
| notify\_url    | 否  | string | 异步通知地址，也可以自行使用定时查询的方式                                        |
| timestamp      | 是  | string | unix时间戳                                                      |
| version        | 是  | string | 接口版本: v3.0                                                   |
| uuid           | 是  | string | 请求ID: 550e8400-e29b-41d4-a716-446655440000                   |
| sign           | 是  | string | 最后追加的签名                                                      |

### 示例-USDT 付款

* 请求

```
{
  "mch_id": "Q0P5T8DOGN10000",
  "mch_order_no": "TRADE-405189",
  "mch_user_id": "U405189",
  "currency": "USDT",
  "amount": "99.11",
  "pay_mehod": "TRC20",
  "account_no": "TFSPUcgpB4trALA6fqdK8AZ3KxoQjqjuB1",
  "notify_url": "https://x.com/notify",
  "return_url": "https://x.com/return",
  "timestamp": "1693233334134",
  "version": "v3.0",
  "client_ip": "8.8.8.8",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "sign": "81930c5a04d1c58fd1efe33b06e2ffa7"
}
```

* 响应

```
{
    "code": 0,
    "message": "Success",
		"timestamp": 1594099906123,
		"uuid": "7eb3c9e-5a1d-4a19-be2a-c80eac39830a",
    "data": {
        "mch_id": "X3DSKDKII2343",
        "mch_order_no": "R898543254325432",
        "order_no": "202007070427475133333",
        "currency": "USDT",
        "pay_method": "TRC20",
        "amount": "99.11",
    		"status": "PENDING",
        "fee": "3.60",
        "paid_at": 1594223431233,
        "error": ""
    }
}
```