创建代收订单

代收方式大类及代收下单接口返回取值说明

代收方式大类	返回值取值说明
银行VA 类 Bank VA	payData: 银行的 VA 号码，需商户自建支付详情页 payUrl: TarsPay 的VA支付详情页面
电子钱包类 Ewallet	OVO payData: TarsPay 的 OVO 填写手机号推送账单支付详情页面 payUrl: TarsPay 的 OVO 填写手机号推送账单支付详情页面 DANA 以及 LINKAJA payData: 官方原生跳转链接(唤醒 APP) payUrl: 官方的跳转链接(唤醒 APP)
二维码 QRIS	payData: 二维码图片，需商户自建支付详情页 payUrl: TarsPay 的 QRIS 支付详情页面

备注：

每种代收方式的具体返回值根据实际业务需求有所不同。

请确保在实际使用中正确配置 payData 和 payUrl 字段。

payData为商户自己搭建了支付详情页，支付的核心数据使用接口返回的值，payUrl 为商户没有支付的详情页，而是使用 TarsPay 的支付详情页。

代收方式编码:

银行(bank)类型编码

银行编码	银行名称
BANK_BCA	BANK BCA
BANK_BNI	BANK BNI
BANK_BRI	BANK BRI
BANK_BSI	BANK BSI
BANK_CIMB	BANK CIMB
BANK_MANDIRI	BANK MANDIRI
BANK_DANAMON	BANK DANAMON
BANK_PERMATA	BANK PERMATA

钱包(ewallet)类型编码

电子钱包编码	电子钱包名称
EWALLET_DANA	EWALLET DANA
EWALLET_LINKAJA	EWALLET LINKAJA
EWALLET_OVO	EWALLET OVO
EWALLET_SHOPEEPAY	EWALLET SHOPEEPAY

便利店(mart)类型编码

便利店编码	便利店名称
MART_ALFA	MART ALFA
MART_INDO	MART INDO

扫码(qris)类型编码

扫码编码	扫码名称
QRIS	QRIS

限额信息

	代收金额规则
代收渠道	最低单笔	最高单笔
BANK	10,000	50,000,000
EWALLET	10,000	10,000,000
QIRS	10,000	10,000,000
MART-储蓄卡	10,000	5,000,000
MART-现金	10,000	2,500,000

Request

Header Params

Body Params application/json

Example

{
    "amount": "string",
    "body": "string",
    "currency": "string",
    "customerAccountNumber": "string",
    "customerContact": "string",
    "customerEmail": "string",
    "customerName": "string",
    "mchNo": "string",
    "mchOrderNo": "string",
    "notifyUrl": "string",
    "returnUrl": "string",
    "subject": "string",
    "wayCode": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Bodyapplication/json

Examples

银行VA成功示例电子钱包成功示例QRIS成功示例

{
    "code": 0,
    "data": {
        "amount": "30000",
        "body": "Test",
        "countryCode": "id",
        "currency": "IDR",
        "customerContact": "123445555",
        "expiredTime": 1702287455,
        "mchOrderNo": "YN45620230300675",
        "orderState": 1,
        "payData": "706675107919",
        "payDataType": "payurl",
        "payOrderId": "P1734130292633829377",
        "payUrl": "https://payment.tpservice.ai/#/order/id/P1734130292633829377",
        "payWays": {
            "bank": [
                {
                    "countryCode": "id",
                    "createdAt": 0,
                    "id": 1,
                    "payCode": "706675107919",
                    "payWay": "BANK_PERMATA",
                    "payWayLogo": "https://tarspay.oss-ap-southeast-1.aliyuncs.com/tarspay_v_1.0/589e70d4-6bc7-447a-97bd-b59b4b752d37.png",
                    "payWayType": "bank",
                    "skipMode": 1,
                    "state": 1,
                    "updatedAt": 0
                }
            ]
        },
        "requestUrl": "https://www.tarspay.com/notify/return",
        "subject": "buycar"
    },
    "msg": "SUCCESS",
    "sign": "304502203601332548ddfad0c75bb47bb2188ffe4c209270eb13fba14555c51bf0b0cae5022100ce4f7aae639a313b5b716d0490ef281987efe4c6c8c75c1515b3418a32e4174a"
}

创建代收订单

代收方式大类及代收下单接口返回取值说明#

备注：#

代收方式编码:#

银行(bank)类型编码#

钱包(ewallet)类型编码#

便利店(mart)类型编码#

扫码(qris)类型编码#

限额信息#