本地支付
适用于欧洲、美国、南美洲、东南亚等地区的本地钱包支付,比如 Cash_APP
、Boleto
、Klarna
、P24
等。
注意
部分本地支付非即时到账,买家完成支付后,可能需要等待一段时间,订单状态才会变为已支付。
请求参数
POST
名称 | 类型 | 长度 | 必填 | 签名 | 描述 |
---|---|---|---|---|---|
productType | String | 16 | Yes | Yes | 本地支付产品类型填写LPMS |
lpmsInfo | String | / | Yes | Yes | 本地支付方式信息,productType 为LPMS 时,除协议代扣外必填,格式为json 字符串。 请参阅对象 LpmsInfo |
LpmsInfo
名称 | 类型 | 长度 | 必填 | 描述 |
---|---|---|---|---|
lpmsType | String | 64 | Yes | 本地支付方式。 请参阅 LpmsTypeEnum。 |
bankName | String | 128 | No | 银行名称,某些本地支付方式需要。lpmsType 为EFT 时请参阅 。lpmsType 为Przelewy24 时请参阅 Przelewy24BankNameEnum。 |
iBan | String | 64 | No | 银行账户,部分地区转账时需要 |
walletAccountId | String | / | No | 钱包/本地账户id,部分地区转账时需要。场景如下: 1.当 productType 为 LPMS ,并且 lpmsType 为 ATM_CARD 时必填,此时需传送本地银行账户号。2.当 productType 为 PAYMENT_CODE 时必填,此时需传送钱包付款码 |
walletAccountName | String | / | No | 钱包/本地账户名称,部分地区转账时需要。当 productType 为 LPMS ,并且 lpmsType 为 ATM_CARD 时必填,此时需传送本地银行账户名称。 |
prepaidNumber | String | / | No | 预付费卡号,部分支付方式需要 |
本地支付请求响应示例
POST
json
{
"billingInformation": "{\"country\":\"BR\",\"email\":\"abel.wang@onerway.com\",\"firstName\":\"CL\",\"lastName\":\"BRW2\",\"phone\":\"8522847035\",\"address\":\"Apt. 870\",\"city\":\"Hayward\",\"postalCode\":\"66977\",\"identityNumber\":\"86258406122\"}",
"lpmsInfo": "{\"lpmsType\":\"Boleto\",\"bankName\":\"\",\"iban\":\"\"}",
"merchantNo": "800209",
"merchantTxnId": "1721291898000",
"merchantTxnTime": "2024-07-18 16:38:18",
"merchantTxnTimeZone": "+08:00",
"orderAmount": "20.00",
"orderCurrency": "BRL",
"productType": "LPMS",
"shippingInformation": "{\"country\":\"BR\",\"email\":\"abel.wang@onerway.com\",\"firstName\":\"CL\",\"lastName\":\"BRW2\",\"phone\":\"8522847035\",\"address\":\"Apt. 870\",\"city\":\"Hayward\",\"postalCode\":\"66977\",\"identityNumber\":\"86258406122\"}",
"sign": "d342edbc884fb6821c50ff84ce5f8042a9462772c0556f8aea23ae523006e2b8",
"subProductType": "DIRECT",
"txnOrderMsg": "{\"returnUrl\":\"https://www.merchant-store-website.com/\",\"appId\":\"1739545982264549376\",\"notifyUrl\":\"https://www.merchant-store-notify.com/\",\"products\":\"[{\\\"name\\\":\\\"Pro1\\\",\\\"price\\\":\\\"50.00\\\",\\\"num\\\":\\\"2\\\",\\\"currency\\\":\\\"USD\\\"},{\\\"name\\\":\\\"Pro2\\\",\\\"price\\\":\\\"100\\\",\\\"num\\\":\\\"1\\\",\\\"currency\\\":\\\"USD\\\"},{\\\"name\\\":\\\"shipping fee\\\",\\\"price\\\":\\\"10\\\",\\\"num\\\":\\\"1\\\",\\\"currency\\\":\\\"USD\\\",\\\"type\\\":\\\"shipping_fee\\\"},{\\\"name\\\":\\\"discount\\\",\\\"price\\\":\\\"-10\\\",\\\"num\\\":\\\"1\\\",\\\"currency\\\":\\\"USD\\\",\\\"type\\\":\\\"discount\\\"}]\",\"transactionIp\":\"127.0.0.1\"}",
"txnType": "SALE"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
json
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"transactionId": "1813855806303903744",
"responseTime": "2024-07-18 16:38:20",
"txnTime": "2024-07-18 16:38:18",
"txnTimeZone": "+08:00",
"orderAmount": "20.00",
"orderCurrency": "BRL",
"txnAmount": null,
"txnCurrency": null,
"status": "R",
"redirectUrl": "https://sandbox.dlocal.com/gmf-apm/payments/M-a4f04d73-ecf2-4d5f-849b-07c8c48db94f", 本地支付页面链接
"contractId": null,
"tokenId": null,
"eci": null,
"periodValue": null,
"codeForm": null,
"presentContext": null,
"actionType": "RedirectURL",
"sign": "9f6352760bf12bca3395d163a159fba92e2228017118497f69272fd93204ac7d"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
此示例仅限参考 请勿拿此示例直接请求。