分期付款
信用卡分期付款与信用卡普通付款类似。终端用户可以选择将付款总金额在定期时间内分别支付分期交易金额。第一笔分期付款金额将立即记入终端用户的信用卡,剩下的分期付款金额将定期自动扣款。
发起信用卡分期交易前,您需要先联系Liquido获取分期计划并拿到Plan ID。然后您需要使用这个Plan ID来创建分期方案,以获取Proposal ID。
请注意,若您需要在方案里面包含除了分期之外的其他目的方案,那么您需要通过创建多目的方案来创建方案。
使用Proposal ID(proposalId) 和分期付款期数(installments),您就可以前往发起信用卡分期付款。
创建一个分期付款的信用卡支付
要创建信用卡分期付款,首先您需要联系我们以创建分期付款计划(Installments Plan),然后您需要创建分期付款方案(Installments Proposal),用于获取分期付款的详情以及创建分期付款的信用卡支付。
使用分期付款方案ID(proposalId)和分期付款期数(installments),可以创建分期付款的信用卡支付。
请注意,无论分多少期,墨西哥大部分的信用卡服务都要求单期金额在100MXN以上。
HTTP请求
POST
/v1/payments/charges/card
Request Headers{
"Content-Type": "application/json",
"Authorization": "Bearer {{access_token}}",
"x-api-key": "{{api_key}}"
}
Request Body{
"idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
"amount": 100000,
"currency": "USD",
"country": "MX",
"paymentMethod": "CREDIT_CARD",
... # 其它请求字段
"paymentProposalInfo": {
"proposalId": "beb199db-fb9c-481b-a951-73b905d5ce43"
},
"installments": 12,
... # 其它请求字段
}
Response{
"transferStatusCode": 200,
"idempotencyKey": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
"referenceId": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
"paymentMethod": "CREDIT_CARD",
"amount": 100000,
"currency": "USD",
"finalAmount": 551093,
"finalCurrency": "MXN",
"country": "MX",
... # 其它响应字段
"amountDetails": {
"fxAmountDetails": {
"fxRate": {
"modifierType": "RATE",
"base": "USD",
"target": "MXN",
"timestamp": 1664443743,
"exchangeRate": 17.4835098
},
"baseAmount": 100000,
"targetAmount": 548351
},
"installmentAmountDetails": {
"installmentAmount": 45924,
"installments": 12,
"totalAmount": 551093
}
},
... # 其它响应字段
}
Key |
Value |
Authorization |
"bearer" + " " + {{access_token}} |
x-api-key |
{{api_key}} |
Request Body 字段说明
参数 |
必填 |
类型 |
描述 |
paymentProposalInfo |
|
JSON |
分期付款方案信息。创建分期付款支付时为必填 |
installments |
|
Integer |
分期付款期数。创建分期付款支付时为必填 |
Response Body 字段说明
对象字段说明
paymentProposalInfo
参数 |
必填 |
类型 |
描述 |
proposalId |
|
String |
分期付款方案ID。创建分期付款支付时为必填 |
amountDetails
taxAmountDetails
参数 |
类型 |
描述 |
taxRate |
JSON |
税率详情 |
amount |
Long |
税费金额,单位是货币最小粒度。 如 1 = 0.01MXN |
fxAmountDetails
参数 |
类型 |
描述 |
fxRate |
JSON |
汇率详情 |
baseAmount |
Long |
当前货币的金额,单位是货币最小粒度。 如 1 = 0.01USD |
targetAmount |
Long |
目标货币的金额,单位是货币最小粒度。 如 1 = 0.01MXN |
installmentAmountDetails
参数 |
类型 |
描述 |
installmentAmount |
Long |
分期付款金额,单位是货币最小粒度。 如 1 = 0.01MXN |
installments |
Integer |
分期付款期数 |
totalAmount |
Long |
分期付款总金额,单位是货币最小粒度。 如 1 = 0.01MXN |
taxRate
参数 |
类型 |
描述 |
rate |
Positive Float |
税率 |
type |
String |
税费类型 |
fxRate
参数 |
类型 |
描述 |
base |
String |
当前货币代码,如 USD |
target |
String |
目标货币代码,如 MXN |
timestamp |
Long |
货币转换时的时间戳 |
exchangeRate |
Positive Float |
汇率 |