创建代收订单

POST

/api/pay/unifiedOrder

代收方式

编码	说明
BANK	BANK
QR	聚合扫码支付，支持银行，钱包等 APP

限额信息

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

请求参数

Header 参数

Body 参数application/json

请求示例代码

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 '{
    "amount": "string",
    "body": "string",
    "currency": "string",
    "customerContact": "string",
    "customerEmail": "string",
    "customerName": "string",
    "mchNo": "string",
    "mchOrderNo": "string",
    "notifyUrl": "string",
    "returnUrl": "string",
    "subject": "string",
    "wayCode": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

收银台CASHIER成功示例BANK成功示例QR成功示例

{
    "code": 0,
    "data": {
        "amount": "220",
        "body": "Test",
        "countryCode": "ph",
        "currency": "PHP",
        "customerContact": "9131167098",
        "mchOrderNo": "FLB3420230300963",
        "orderState": 0,
        "payDataType": "payurl",
        "payOrderId": "P1850124580235935746",
        "payUrl": "https://checkout.tarspay.com/#/order/ph/P1850124580235935746",
        "payWays": {
            "bank": [
                {
                    "countryCode": "ph",
                    "createdAt": 0,
                    "id": 109,
                    "payWay": "BANK",
                    "payWayLogo": "https://tarspay.oss-ap-southeast-1.aliyuncs.com/tarspay_v_1.0/6b238f2a-7336-4b08-98d9-1ccc481b2c79.png",
                    "payWayType": "bank",
                    "skipMode": 2,
                    "state": 1,
                    "updatedAt": 0
                }
            ],
            "qr": [
                {
                    "countryCode": "ph",
                    "createdAt": 0,
                    "id": 110,
                    "payWay": "QR",
                    "payWayLogo": "https://tarspay.oss-ap-southeast-1.aliyuncs.com/tarspay_v_1.0/e982e724-e368-4f4c-83a5-4cdecb6da7eb.png",
                    "payWayType": "qr",
                    "skipMode": 1,
                    "state": 1,
                    "updatedAt": 0
                }
            ]
        },
        "requestUrl": "https://merchant-test.tarspay.com/#/",
        "subject": "buycar"
    },
    "msg": "SUCCESS",
    "sign": "3045022025589697e011007a0ffeb93243aa9bee690b59e77d0e223ec827ae51093f0514022100e147d5f7d2013077167dd1a507cd6577f63e71e8893f618802299f898572bb11"
}

修改于 2024-10-26 10:20:10

核心业务流程说明

获取代收订单状态