创建代收订单
POST
/api/pay/unifiedOrder
代收方式大类及代收下单接口返回取值说明
| 代收方式大类 | 返回值取值说明 |
|---|---|
| 银行VA 类 Bank VA | payData: 银行的 VA 号码，需商户自建支付详情页 payUrl: PayLinker 的VA支付详情页面 |
| 电子钱包类 Ewallet | OVO payData: PayLinker 的 OVO 填写手机号推送账单支付详情页面 payUrl: PayLinker 的 OVO 填写手机号推送账单支付详情页面 DANA 以及 LINKAJA payData: 官方原生跳转链接(唤醒 APP) payUrl: 官方的跳转链接(唤醒 APP) |
| 二维码 QRIS | payData: 二维码图片，需商户自建支付详情页 payUrl: PayLinker 的 QRIS 支付详情页面 |
备注：
payData 和 payUrl 字段。payData为商户自己搭建了支付详情页，支付的核心数据使用接口返回的值，payUrl 为商户没有支付的详情页，而是使用 PayLinker 的支付详情页。代收方式编码:
银行(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 |
请求参数
Header 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/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": "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"
}'响应示例响应示例
银行VA成功示例
{
"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://id.plservice.vip/#/order/id/P1734130292633829377",
"payWays": {
"bank": [
{
"countryCode": "id",
"createdAt": 0,
"id": 1,
"payCode": "706675107919",
"payWay": "BANK_PERMATA",
"payWayLogo": "https://paylinker.oss-ap-southeast-1.aliyuncs.com/larkpay_v_1.0/589e70d4-6bc7-447a-97bd-b59b4b752d37.png",
"payWayType": "bank",
"skipMode": 1,
"state": 1,
"updatedAt": 0
}
]
},
"requestUrl": "https://www.paylinker.vip/notify/return",
"subject": "buycar"
},
"msg": "SUCCESS",
"sign": "304502203601332548ddfad0c75bb47bb2188ffe4c209270eb13fba14555c51bf0b0cae5022100ce4f7aae639a313b5b716d0490ef281987efe4c6c8c75c1515b3418a32e4174a"
}修改于 2025-06-18 13:13:42