跳转至

分期付款

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

发起信用卡分期交易前，您需要先联系Liquido获取分期计划并拿到Plan ID。

创建一个Direct流程的信用卡分期付款支付

您需要分期计划的Plan ID来创建分期方案，以获取Proposal ID。请注意，若您需要在方案里面包含除了分期之外的其他目的方案，那么您需要通过创建多目的方案来创建方案。使用Proposal ID(proposalId) 和分期付款期数(installments)，您就可以前往发起信用卡分期付款。

HTTP请求

POST /v1/payments/charges/card

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Request Body
{
    "idempotencyKey": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
    "amount": 300000,
    "currency": "PYG",
    "country": "PY",
    "paymentMethod": "CARD",
    ...  # other basic request fields
    "paymentProposalInfo": {
        "proposalId": "beb199db-fb9c-481b-a951-73b905d5ce43"
    },
    "installments": 3,
    ...  # other basic request fields
}
Response
{
    "transferStatusCode": 200,
    "idempotencyKey": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
    "referenceId": "62cc10c8-baba-4c92-b6da-935cbd422dcd",
    "paymentMethod": "CARD",
    "amount": 300000,
    "currency": "PYG",
    "finalAmount": 306000,
    "finalCurrency": "PYG",
    "country": "PY",
    ...  # other basic response fields
    "amountDetails": {
        "installmentAmountDetails": {
             "installmentAmount": 102000,
            "installments": 3,
            "totalAmount": 306000
        }
    },
    ...  # other basic response fields
}

HTTP Headers 字段说明

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

Request Body 字段说明

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

Response Body 字段说明

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

HTTP Headers 字段说明

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

Request Body 字段说明

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

对象字段说明

paymentProposalInfo
参数 必填 类型 描述
proposalId String 分期付款方案ID。Direct流程时必填。
amountDetails
参数 类型 描述
installmentAmountDetails JSON 分期付款金额详情。
installmentAmountDetails
参数 类型 描述
installmentAmount Long 分期付款金额，单位是货币最小粒度。 如 1 = 0.01PYG
installments Integer 分期付款期数
totalAmount Long 分期付款总金额，单位是货币最小粒度。 如 1 = 0.01PYG
回到页面顶部