创建代收订单

POST

/api/pay/unifiedOrder

	代收金额限制规则
代收渠道（wayCode）	最低单笔	最高单笔	说明
EWALLET_BKASH	100	30,000	bKash代理账户
EWALLET_NAGAD	100	30,000	Nagad代理账户
EWALLET_BKASH_OFFICIAL	50	75,000	bKash官方原生支付，用户转账0手续费

请求参数

Header 参数

Body 参数application/json

示例

{
    "amount": "100",
    "currency": "BDT",
    "customerContact": "01011111111",
    "mchNo": "M1688443982",
    "mchOrderNo": "MJL8932024090200244",
    "notifyUrl": "http://47.241.33.220:8896/tarspay/notify",
    "returnUrl": "https://merchant-test.tarspay.com/#/",
    "wayCode": "EWALLET_BKASH"
}

请求示例代码

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: 0221f85d6a09945403ef161b5200f4df152935a748ce2b9f291bb2d351d709b6a0' \
--header 'X-API-NONCE: 1704250498993' \
--header 'X-API-SIGNATURE: 304502203968d3ce6a4c275816fbf71feee790ca4dfb192df71d49e10d6314368470bf79022100b9cacaf8df3fd302bd408b2f0e75c9a54069b3994748b6a31aac1dd3928ff0a6' \
--header 'Content-Type: application/json' \
--data '{
    "amount": "100",
    "currency": "BDT",
    "customerContact": "01011111111",
    "mchNo": "M1688443982",
    "mchOrderNo": "MJL8932024090200244",
    "notifyUrl": "http://47.241.33.220:8896/tarspay/notify",
    "returnUrl": "https://merchant-test.tarspay.com/#/",
    "wayCode": "EWALLET_BKASH"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "amount": "48888",
        "body": "Test",
        "countryCode": "bd",
        "currency": "BDT",
        "customerContact": "01011111111",
        "expiredTime": 1727258344,
        "mchOrderNo": "MJL79420240909000173",
        "orderState": 1,
        "payData": "01740026029",
        "payDataType": "payurl",
        "payOrderId": "P1838873343087747073",
        "payUrl": "https://checkout.tpservice.vip/#/pay/bd/EWALLET_BKASH/P1838873343087747073",
        "payWays": {
            "ewallet": [
                {
                    "countryCode": "bd",
                    "createdAt": 0,
                    "id": 105,
                    "payCode": "01740026029",
                    "payWay": "EWALLET_BKASH",
                    "payWayLogo": "https://defipay.oss-ap-southeast-1.aliyuncs.com/bKash.png",
                    "payWayType": "ewallet",
                    "skipMode": 2,
                    "state": 1,
                    "updatedAt": 0
                }
            ]
        },
        "requestUrl": "https://merchant.tarspay.com/#/",
        "subject": "buycar"
    },
    "msg": "SUCCESS",
    "sign": "3046022100feeaf6130bd3e66bd5b476a67bfbbda05fbe60b3f252385ce49e3f00aa34f905022100f237d98c7d5f32246a862746162f2c14a4b8d4fdc4692f038efdb7f1961b18f4"
}

修改于 2025-07-16 15:08:36

附件码表

获取代收订单状态