跳转至

分期付款

信用卡分期付款与信用卡普通付款类似。终端用户可以选择将付款总金额在定期时间内分别支付分期交易金额。第一笔分期付款金额将立即记入终端用户的信用卡,剩下的分期付款金额将定期自动扣款。

发起信用卡分期交易前,您需要先联系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
        }
    },
    ...  # 其它响应字段
}

HTTP Headers 字段说明

Key Value
Authorization "bearer" + " " + {{access_token}}
x-api-key {{api_key}}

Request Body 字段说明

参数 必填 类型 描述
paymentProposalInfo JSON 分期付款方案信息。创建分期付款支付时为必填
installments Integer 分期付款期数。创建分期付款支付时为必填

Response Body 字段说明

参数 类型 描述
amountDetails JSON 分期付款金额详情

对象字段说明

paymentProposalInfo
参数 必填 类型 描述
proposalId String 分期付款方案ID。创建分期付款支付时为必填
amountDetails
参数 类型 描述
taxAmountDetails JSON 税率金额详情。
fxAmountDetails JSON 换汇金额详情。
installmentAmountDetails JSON 分期付款金额详情。
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 汇率
回到页面顶部