分期付款

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

发起信用卡分期交易前，您需要先联系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": "GTQ",
    "country": "GT",
    "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": "GTQ",
    "finalAmount": 306000,
    "finalCurrency": "GTQ",
    "country": "GT",
    ...  # 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.01GTQ
installments	Integer	分期付款期数
totalAmount	Long	分期付款总金额，单位是货币最小粒度。如 1 = 0.01GTQ