创建代收订单

POST

/api/pay/unifiedOrder

代收方式

编码	说明
PROMPTPAY	PROMPTPAY

限额信息

	代收金额规则
代收渠道	最低单笔	最高单笔
QR	50	500,000

Request

Header Params

Body Params application/json

Example

{
    "amount": "100",
    "customerContact": "01085230144",
    "mchOrderNo": "D1730277342330",
    "customerEmail": "199199@gmail.com",
    "wayCode": "PROMPTPAY",
    "notifyUrl": "https:/notifyUrl.com",
    "currency": "THA",
    "bankName": "BBL",
    "customerAccountNumber": "01817999051",
    "returnUrl": "https://returnUrl.com",
    "mchNo": "M1688444708",
    "customerName": "GDW"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://payment.tarspay.com/api/pay/unifiedOrder' \
--header 'X-API-KEY: 02106af2a085fbfc6d1bb49f485205fcdfcc79a4ddb1913c72a271fedd24c2d7fe' \
--header 'X-API-NONCE: 1702279880267' \
--header 'X-API-SIGNATURE: 304502207a4a88a5b0def29b9dbbf8563112d090c0e0b793ff6a5c57fe9d4fd1254d8ecf022100ff63c279f5926069fa1d161598e8d3249cb90e9d728e88e514352cdae6feff72' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": "100",
    "customerContact": "01085230144",
    "mchOrderNo": "D1730277342330",
    "customerEmail": "199199@gmail.com",
    "wayCode": "PROMPTPAY",
    "notifyUrl": "https:/notifyUrl.com",
    "currency": "THA",
    "bankName": "BBL",
    "customerAccountNumber": "01817999051",
    "returnUrl": "https://returnUrl.com",
    "mchNo": "M1688444708",
    "customerName": "GDW"
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Examples

收银台成功示例BANK成功示例PROMPTPAY成功示例

{
    "code": 0,
    "data": {
        "amount": "50",
        "body": "Test",
        "countryCode": "th",
        "currency": "THA",
        "customerContact": "13116709877",
        "mchOrderNo": "TG2520230300170",
        "orderState": 0,
        "payDataType": "payurl",
        "payOrderId": "P1742757150174674946",
        "payUrl": "https://payment.tpservice.ai/#/order/th/P1742757150174674946",
        "payWays": {
            "TRUEMONEY": [
                {
                    "countryCode": "th",
                    "createdAt": 0,
                    "id": 60,
                    "payWay": "TRUEMONEY",
                    "payWayLogo": "https://tarspay.oss-ap-southeast-1.aliyuncs.com/tarspay_v_1.0/f11776e0-702d-4520-82f5-f6efa066490c.png",
                    "payWayType": "TRUEMONEY",
                    "skipMode": 2,
                    "state": 1,
                    "updatedAt": 0
                }
            ],
            "PROMPTPAY": [
                {
                    "countryCode": "th",
                    "createdAt": 0,
                    "id": 59,
                    "payWay": "PROMPTPAY",
                    "payWayLogo": "https://tarspay.oss-ap-southeast-1.aliyuncs.com/tarspay_v_1.0/363afea6-c8cf-46ae-948d-5517a258ecfd.png",
                    "payWayType": "PROMPTPAY",
                    "skipMode": 3,
                    "state": 1,
                    "updatedAt": 0
                }
            ],
            "BANK": [
                {
                    "countryCode": "th",
                    "createdAt": 0,
                    "id": 58,
                    "payWay": "BANK",
                    "payWayLogo": "https://tarspay.oss-ap-southeast-1.aliyuncs.com/tarspay_v_1.0/bf8f03a8-0d2b-40b0-b65c-18e01ce1597a.png",
                    "payWayType": "BANK",
                    "skipMode": 1,
                    "state": 1,
                    "updatedAt": 0
                }
            ]
        },
        "subject": "buycar"
    },
    "msg": "SUCCESS",
    "sign": "3045022006c26a41d4cac3be103b9ba00926fef05b0e27116f3cdae3b573b0d5c8399d37022100b99650ff4134ecf0b638317f34087bc7747b97d4e76564aa627982b63e037d7a"
}

Modified at 2026-06-04 10:15:18

附件码表

获取代收订单状态