- 集成指南
- 支持的功能（付款选项）
- 付款方案
- 自定义付款方案
自定义付款方案
自定义付款方案基于模板实例系统，在系统中，您可以通过指定分期付款次数和延期期间（如果适用）来创建 5 个付款方案模板中其中一个的实例。
- 分期付款（无利息）
- 延期后分期付款（有利息）
- 分期付款（有利息）
- 延期后全额付款
- 延期后分期付款（无利息）
例如，您可以创建以下付款方案：
- 财政年末优惠 - 六个月无利息、无付款（模板 5 的实例）
- 轻松还款 - 三个月固定付款，无利息（模板 1 的实例）
- 圣诞节优惠 - 立即购买，六个月内一次付清（模板 4 的实例）
您可以使用 Merchant Administration 创建付款方案模板的实例。 模板对 your payment service provider 配置的商家可用。
自定义付款方案目前由以下机构提供：
- Banamex
- BBVA Bancomer
- First Data 巴西
- First Data 阿根廷
自定义付款方案适用于使用墨西哥比索、巴西雷亚尔和阿根廷比索货币进行的交易。
Payment Plan Inquiry
您可以使用 Payment Options Inquiry 操作向网关请求交易的有效方案列表。 将返回有关支持的付款方案的以下详细信息：
paymentTypes.card.paymentPlans[n].startDate：付款方案的开始日期。paymentTypes.card.paymentPlans[n].endDate：付款方案的结束日期。paymentTypes.card.paymentPlans[n].numberOfPayments[n]: 付款人按月分期付款的次数（如果适用于方案类型）。paymentTypes.card.paymentPlans[n].numberOfDeferrals[n]: 付款可延期的最长月数（如果适用于方案类型）。paymentTypes.card.paymentPlans[n].minimumOrderAmounts[n].amount: 付款方案的最低订单金额（按受支持的币种计）。 只有在订单总金额大于或等于此最小订单金额时才会提供配置的付款方案。paymentTypes.card.paymentPlans[n].minimumOrderAmounts[n].currency: 最小订单金额的货币。paymentTypes.card.paymentPlans[n].payerInterest: 指示是否在付款方案中向付款人收取利息。paymentTypes.card.paymentPlans[n].planId: 系统生成的付款方案的唯一标识符。 方案标识符在您可能配置的所有付款方案类型中是唯一的。paymentTypes.card.paymentPlans[n].planName: 商家为付款方案提供的标识符。 例如，财政年末优惠。paymentTypes.card.paymentPlans[n].planTemplate: 用于生成付款方案实例的付款方案模板。 例如，分期付款（无利息）。
通常包含最大分期付款次数 99 次和/或延期月数。 不过，your payment service provider 可以在商家配置中为每个模板配置最大限制。
从版本 70 起，对于系统生成的付款方案 ID，将返回可用的付款方案优惠。 付款方案优惠列表根据货币和最低订单金额返回。
每个付款方案优惠将有一个唯一的优惠 ID：
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrlpaymentTypes.card.paymentPlanOffer.{id}paymentTypes.card.paymentPlanOffer{id}.paymentPlanProductIdpaymentTypes.card.paymentPlanOffer.{id}.currencypaymentTypes.card.paymentPlanOffer.{id}.numberofPaymentspaymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmountpaymentTypes.card.paymentPlanOffer{id}.minimumOrderAmountpaymentTypes.card.paymentPlanOffer.{id}.deferralPeriodpaymentTypes.card.paymentPlanOffer.{id}.interest.chargedpaymentTypes.card.paymentPlanOffer.{id}.startDatepaymentTypes.card.paymentPlanOffer.{id}.endDatepaymentTypes.card.paymentPlanOffer.{id}.planTemplate
Payment Options Inquiry API 参考 [REST][NVP]
请求付款方案
若要请求交易的付款方案，请在 Authorize/Pay 或 Update Session 请求中提供以下字段：
paymentPlan.numberOfDeferralspaymentPlan.numberOfPaymentspaymentPlan.planId
仅当满足以下条件时网关才会处理付款方案：
- 当前日期晚于或等于开始日期。
- 当前日期早于或等于结束日期。
- 订单金额超过付款方案中定义的最小订单金额。
- 订单货币在付款方案中受支持。
- 卡类型在付款方案中受支持。
从版本 70 起，仅提供 Authorize/Pay 或 Update Session 请求中的 paymentPlan.offerID 字段以及 Payment Options Inquiry 响应中提供的优惠 ID。
付款方案约束
您可以使用付款方案约束字段来限制特定交易的付款方案标识符和延期/分期付款月数：
constraints.paymentPlans.numberOfDeferrals: 付款方案允许的延期月数。constraints.paymentPlans.numberOfPayments: 付款方案允许的分期付款次数。constraints.paymentPlans.supported[n]: 为此交易支持的付款方案提供标识符。 如果您不希望提供任何付款方案，请在传送时将其保留为空。
从版本 70 开始，
constraints.paymentPlans.deferralPeriod: 付款方案允许的延期月数。constraints.paymentPlans.numberOfPayments: 付款方案允许的分期付款次数。constraints.paymentPlans.supported[n]: 为此交易支持的付款方案提供标识符。 如果您不希望提供任何付款方案，请在传送时将其保留为空。