- 集成指南
- 支持的功能（付款选项）
- 付款方案
- Paylater Installments
Paylater Installments
Paylater Installments 允许付款人以每月分期付款的方式为所购商品付款，直到完全支付款项。
Paylater Installments 提供：
- 一般优惠: 您想要提供的付款方案不特定于商品、产品或购物车。
- 商品优惠: 您想要为特定商品或产品提供的付款方案。
- 购物车优惠: 您想要为已加入一件或多件商品或产品的购物车提供的付款方案。
Paylater Installments 付款方案条款可能包含以下内容：
- 延迟期，在延迟期内，付款人可以选择推迟首次付款。
- 发卡行的利率组成部分或无息付款方案。
- 为选择某些付款方案提供现金奖励。
集成步骤
| 方案名称 | 方案识别码 | 说明 | 所用 API |
|---|---|---|---|
1 |
付款人访问您的网站 |
您想要知道是否有可以提供的一般付款方案优惠。 |
Shopping Options Inquiry 您必须提交 响应包含商家的付款方案优惠列表。 |
2 |
付款人浏览类别或进行产品搜索 |
您想要显示列表中各个商品可以提供的付款方案优惠。 |
Item Payment Plan Offers 您必须提交 响应包含商品的付款方案优惠列表。 |
3 |
付款人查看产品详细信息页面 |
您想要显示该商品的付款方案优惠 |
Item Payment Plan Offers 您必须提交 WS API ITEM_PAYMENT_PLAN_OFFERS 请求来查询单个商品的付款方案优惠（即列表中仅包含一个商品）。 响应包含商品的付款方案优惠列表。 |
4 |
付款人查看购物车，有想要结账的意向或已进入结账页。 |
您想要显示
|
付款选项包括付款方案产品 您必须提交 WS API PAYMENT_OPTIONS_INQUIRY 请求来查询
响应包含付款方案产品“Paylater Installments”。 |
5 |
付款人选择了付款方案产品“Paylater Installments” |
您想要显示此付款方案产品的所有付款方案优惠 |
付款选项包括付款方案产品 您必须提交 WS API PAYMENT_OPTIONS_INQUIRY 请求来查询此付款方案产品的可用付款方案优惠 响应包含针对购物车或订单的付款方案优惠列表以及付款方案产品。 |
6 |
付款人提供卡 BIN（在输入卡号时） |
根据卡 BIN，您想要显示针对此购物车
|
付款选项包括针对购物车或订单的付款方案优惠 您必须提交 WS API PAYMENT_OPTIONS_INQUIRY 请求来查询
响应包含针对购物车或订单以及 BIN 的付款方案优惠列表。 |
7 |
付款人接受购物车付款方案优惠并同意条款和条件 |
您想要提交付款人接受优惠的信息。 |
如果付款人选择该付款方式中的其中一项优惠“Paylater Installments”，您必须提供购物车优惠的 PAYMENT_OPTIONS_INQUIRY 响应中返回的条款和条件，并且付款人必须接受该优惠才能继续使用此付款方案。 接受优惠 您向付款人显示条款和条件（在 PAYMENT_OPTIONS_INQUIRY 响应中提供相关详细信息）。 付款人接受条款和条件。
然后，您提交 UPDATE_PAYMENT_PLAN_OFFER 请求。 请求中必须包含
响应将指示您是否可以继续处理订单，包括此优惠。 如果为
|
8 |
付款人继续付款 |
- |
Authorize 或 Pay 请求 商家提交 WS API AUTHORIZE 或 PAY 请求，请求中包含已接受优惠的方案优惠 ID。 付款人接受的购物车付款方案优惠现在成为订单或交易的付款方案。 |
Payment Options Inquiry API 参考 [REST][NVP]
Shopping Options Inquiry
您可以使用 Shopping Options Inquiry 操作向网关请求有效的一般方案优惠的列表。 将返回有关支持的付款方案的以下详细信息：
从版本 70 开始，响应将包含支持的付款方案产品，即“Paylater Installments”：
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
每个付款方案优惠均有唯一的优惠 ID 和对应的付款方案产品 ID：
paymentPlanOffer.{id}paymentPlanOffer.{id}.currency (populated with payerCurrency from request)paymentPlanOffer{id}.paymentPlanProductIdpaymentPlanOffer{id}.totalAmountpaymentPlanOffer{id}.numberOfPaymentspaymentPlanOffer{id}.subsequentPaymentAmountpaymentPlanOffer{id}.firstPaymentAmountpaymentPlanOffer{id}.deferalPeriodpaymentPlanOffer{id}.interest.ratepaymentPlanOffer{id}.interest.discountAmountpaymentPlanOffer{id}.feeAmountpaymentPlanOffer{id}.cashAward.amountpaymentPlanOffer{id}.cashAward.payerInstructionTextpaymentPlanOffer{id}.qualifier.descriptionpaymentPlanOffer{id}.qualifier.logoUrlpaymentPlanOffer{id}.minimumAmountpaymentPlanOffer{id}.maximumAmountItem Payment Plan Offers
您可以使用 Item Payment Plan Offers 操作向网关请求特定商品的有效方案优惠列表。
请求中包含以下详细信息：
merchantpayerlocalecurrencyitem[0].skuitem[0].unitPriceitem[1].skuitem[1].unitPrice将返回有关支持的付款方案的以下详细信息。 从版本 70 开始，响应将包含支持的付款方案产品，即“Paylater Installments”：
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
每个付款方案优惠均有唯一的优惠 ID 和对应的付款方案产品 ID：
item[n].paymentPlanOffer.{id}item[n].paymentPlanOffer.{id}.paymentPlanProductIditem[n].paymentPlanOffer.{id}.currencyitem[n].paymentPlanOffer.{id}.totalAmountitem[n].paymentPlanOffer.{id}.numberOfPaymentsitem[n].paymentPlanOffer.{id}.deferalPerioditem[n].paymentPlanOffer.{id}.subsequentPaymentAmountitem[n].paymentPlanOffer{id}.firstPaymentAmountitem[n].paymentPlanOffer{id}.interest.rateitem[n].paymentPlanOffer{id}.interest.discountAmountitem[n].paymentPlanOffer{id}.feeAmountitem[n].paymentPlanOffer{id}.cashAward.amountitem[n].paymentPlanOffer{id}.cashAward.payerInstructionTextitem[n].paymentPlanOffer{id}.qualifier.descriptionitem[n].paymentPlanOffer{id}.qualifier.logoUrlresult
Payment Plan Inquiry
您可以使用 Payment Options Inquiry 操作向网关请求有效的付款方案产品和方案优惠的列表。
请求中包含：
payerLocaleorder.amountorder.currencyorder.item[n].skuorder.item[n].quantityorder.item[n].unitPriceorder.itemAmountsourceOfFunds.provided.card.prefix
从版本 70 开始，响应将包含支持的付款方案产品，即“Paylater Installments”：
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl每个付款方案优惠均有唯一的优惠 ID 和对应的付款方案产品 ID：
paymentTypes.card.paymentPlanOffer.{id}paymentTypes.card.paymentPlanOffer.{id}.paymentPlanProductIdpaymentTypes.card.paymentPlanOffer.{id}.numberofPaymentspaymentTypes.card.paymentPlanOffer.{id}.deferralPeriodpaymentTypes.card.paymentPlanOffer.{id}.interest.chargedpaymentTypes.card.paymentPlanOffer.{id}.currencypaymentTypes.card.paymentPlanOffer.{id}.minimumOrderAmountpaymentTypes.card.paymentPlanOffer.{id}.startDatepaymentTypes.card.paymentPlanOffer.{id}.endDatepaymentTypes.card.paymentPlanOffer.{id}.totalAmountpaymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.feeAmountpaymentTypes.card.paymentPlanOffer.{id}.interest.ratepaymentTypes.card.paymentPlanOffer.{id}.interest.discountAmountpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.textpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.acceptanceRequiredpaymentTypes.card.paymentPlanOffer.{id}.termsAndConditions.acceptanceTextpaymentTypes.card.paymentPlanOffer.{id}.cashAward.amountpaymentTypes.card.paymentPlanOffer.{id}.cashAward.payerInstructionTextpaymentTypes.card.paymentPlanOffer.{id}.qualifier.textpaymentTypes.card.paymentPlanOffer.{id}.qualifier.logoUrl
Update Payment Plan Offers
您可以使用 Update Payment Plan Offers 操作向提供商提交付款人接受付款方案优惠的信息。
- 请求中包含：
sourceOfFunds parameter grouporder.amountorder.currencyorder.item[n].quantityorder.item[n].unitPrice
您可以通过以下字段值提供付款人接受的详细信息：
paymentPlanOffer.payerAcceptance = truepaymentPlanOffer.termsAndConditionsDisplay值可以是以下其中一个值：
NONE- 您没有显示任何条款和条件文本。TERMS_AND_CONDITIONS_ONLY- 您显示了条款和条件文本。TERMS_AND_CONDITIONS_AND_ACCEPTANCE- 您显示了条款和条件文本并强制付款人接受条款和条件。
提交带有付款方案的交易
要使用付款人选择的付款方案提交交易，在 Authorize/Pay 或 Update Session 请求中提供以下字段。 从版本 70 开始，在 Payment Options Inquiry 响应中提供包含优惠 ID 的 paymentPlan.offerID 字段。
仅当满足以下条件时网关才会处理付款方案：
- 订单货币在付款方案中受支持。
- 订单金额超过付款方案中定义的最小订单金额。
- 卡类型在付款方案中受支持。