创建代收订单

POST

/api/pay/unifiedOrder

收款方式编码

扫码(qr)类型编码

扫码编码	扫码名称
QR	QR

限额信息

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

请求参数

Header 参数

Body 参数application/json

示例

{
    "amount": "100000",
    "currency": "VND",
    "customerName": "DW",
    "mchNo": "M1688454487",
    "mchOrderNo": "VN31420230300564",
    "notifyUrl": "http://47.241.33.220:8896/tarspay/notify",
    "returnUrl": "https://www.tarspay.com/notify/return",
    "wayCode": "QR"
}

请求示例代码

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: 02d6433f5bedc5bc35b0971b8acce048b2ad4bce74210bea1288a10f42b166e057' \
--header 'X-API-NONCE: 1704183963685' \
--header 'X-API-SIGNATURE: 3046022100e3f77085dd40cd803ed5b74f909b1e775bb0b1a795cd2a464a7258479d663bb6022100f27c27d29d840e641119a2aa4c8126d755e9e16c2965cec51f296a20e34ebdd9' \
--header 'Content-Type: application/json' \
--data '{
    "amount": "100000",
    "currency": "VND",
    "customerName": "DW",
    "mchNo": "M1688454487",
    "mchOrderNo": "VN31420230300564",
    "notifyUrl": "http://47.241.33.220:8896/tarspay/notify",
    "returnUrl": "https://www.tarspay.com/notify/return",
    "wayCode": "QR"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "accountName": "TRAN NGOC HIEU",
        "accountNumber": "100349617",
        "amount": "200000",
        "body": "test",
        "cashierUrl": "https://checkout-test-vn.tpservice.vip/#/pay/P439266522884476929",
        "countryCode": "vn",
        "currency": "VND",
        "customerContact": "03005331179",
        "expiredTime": 1777346900,
        "mchOrderNo": "D1777260495104",
        "orderState": 1,
        "originalAccountNumber": "03123451231",
        "payData": "00020101021238530010A0000007270123000697043101091003496170208QRIBFTTA53037045407200,0005802VN62120808LQSMT6YT630467E7",
        "payDataType": "payurl",
        "payOrderId": "P439266522884476929",
        "payUrl": "https://checkout-test-vn.tpservice.vip/#/pay/P439266522884476929",
        "payWays": {
            "qr": [
                {
                    "countryCode": "vn",
                    "createdAt": 0,
                    "id": 80,
                    "payCode": "00020101021238530010A0000007270123000697043101091003496170208QRIBFTTA53037045407200,0005802VN62120808LQSMT6YT630467E7",
                    "payWay": "QR",
                    "payWayLogo": "https://defipay.oss-ap-southeast-1.aliyuncs.com/tarspay_v_1.0/QR.png",
                    "payWayType": "qr",
                    "skipMode": 1,
                    "state": 1,
                    "updatedAt": 0
                }
            ]
        },
        "reference": "LQSMT6YT",
        "requestUrl": "https://checkout.lioneasy.com/callback",
        "subject": "test",
        "typeBank": "EXIMBANK"
    },
    "msg": "SUCCESS",
    "sign": ""
}

修改于 2026-04-27 03:36:24

附件码表

获取代收订单状态

创建代收订单

扫码(qr)类型编码#

限额信息#

请求参数

请求示例代码

返回响应

扫码(qr)类型编码

限额信息