- Pautas de integración
- Características soportadas (opciones de pago)
- Planes de pago
- Paylater Installments
Paylater Installments
El plan Paylater Installments permite a los pagadores pagar sus compras en números de pagos mensuales hasta completar el monto total de la compra.
El plan Paylater Installments pone a su disposición las siguientes opciones:
- Ofertas genéricas: los planes de pago que desea ofrecer que no son específicos de los artículos, productos o del carrito.
- Ofertas de artículos: los planes de pago que desea ofrecer para un artículo o producto específico.
- Ofertas del carrito: los planes de pago que desea ofrecer para un carrito con uno o más artículos o productos.
Los términos del plan de pago Paylater Installments pueden incluir lo siguiente:
- El período de diferimiento en el que un pagador puede optar por aplazar su primer pago.
- Componente de tasa de interés o planes de pago sin intereses del banco emisor.
- Recompensas en efectivo por elegir ciertos planes de pago.
Pasos de integración
| Nombre del plan | Identificador de plan | Descripción | API que se va a usar |
|---|---|---|---|
1 |
El pagador visita su sitio web |
Usted quiere saber si hay ofertas genéricas de planes de pago que se puedan presentar. |
Shopping Options Inquiry Debe presentar una solicitud de La respuesta contiene una lista de ofertas de planes de pago para el negocio. |
2 |
El pagador está navegando por una categoría o realizando una búsqueda de producto |
Desea mostrar las ofertas de planes de pago disponibles para cada artículo de la lista. |
Item Payment Plan Offers Debe presentar una solicitud de La respuesta contiene una lista de ofertas de planes de pago para el artículo. |
3 |
El pagador está viendo la página de detalles de un producto |
Desea mostrar las ofertas de planes de pago para este artículo. |
Item Payment Plan Offers Debe enviar una solicitud de ITEM_PAYMENT_PLAN_OFFERS de API de servicios web para consultar sobre las ofertas de planes de pago para un solo artículo (es decir, la lista contiene únicamente un solo artículo). La respuesta contiene una lista de ofertas de planes de pago para el artículo. |
4 |
El pagador está viendo el carrito e indica que desea completar la compra o ir a la página de pago. |
Desea mostrar
|
Opciones de pago, incluidos los productos del plan de pago Debe enviar una solicitud de PAYMENT_OPTIONS_INQUIRY de API de servicios web para consultar sobre:
La respuesta contiene un producto de plan de pago como "Paylater Installments". |
5 |
El pagador ha seleccionado el producto del plan de pago como "Paylater Installments" |
Desea mostrar todas las ofertas de planes de pago para este producto de plan de pago. |
Opciones de pago, incluidos los productos del plan de pago Debe enviar una solicitud de PAYMENT_OPTIONS_INQUIRY de API de servicios web para consultar sobre la oferta de plan de pago disponible para este producto de plan de pago. La respuesta contiene una lista de ofertas de planes de pago para el carrito o pedido y el producto del plan de pago. |
6 |
El pagador ha proporcionado el BIN de la tarjeta (cuando ingresa el número de la tarjeta) |
Dependiendo del BIN de la tarjeta que desee visualizar
|
Opciones de pago, incluidas las ofertas de planes de pago para el carrito o pedido Debe enviar una solicitud de PAYMENT_OPTIONS_INQUIRY de API de servicios web para consultar sobre:
La respuesta contiene una lista de ofertas de planes de pago para el carrito o pedido y BIN. |
7 |
El pagador acepta la oferta de plan de pago del carrito y acepta los términos y condiciones |
Desea enviar la aceptación de la oferta por parte del pagador. |
Si el pagador selecciona una de las ofertas dentro de ese método de pago como "Paylater Installments", debe proporcionar los términos y condiciones devueltos en la respuesta PAYMENT_OPTIONS_INQUIRY para las ofertas del carrito y el pagador debe aceptar la oferta para continuar con este plan de pago. Aceptar la oferta Muestra los términos y condiciones (cuyos detalles se proporcionan en la respuesta de PAYMENT_OPTIONS_INQUIRY) al pagador. El pagador acepta los términos y condiciones.
Luego, envía una solicitud de UPDATE_PAYMENT_PLAN_OFFER. La solicitud debe contener:
La respuesta indica si puede continuar con el pedido, incluida esta oferta. Si la respuesta es
|
8 |
El pagador procede con el pago |
- |
Solicitud Authorize o Pay El negocio envía una solicitud de AUTHORIZE o PAY de API de servicios web con el ID de la oferta de plan aceptada. La oferta de plan de pago del carrito que el pagador ha aceptado ahora se convierte en el plan de pago del pedido o la transacción. |
Referencia de API de Payment Options Inquiry [REST][NVP]
Shopping Options Inquiry
Puede solicitar al motor de pagos una lista de ofertas de planes genéricos válidos mediante la operación Shopping Options Inquiry. Se devuelven los siguientes detalles sobre los planes de pago admitidos:
A partir de la versión 70, la respuesta contiene los productos admitidos de plan de pago, que es "Paylater Installments":
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
Cada oferta de plan de pago tiene un ID de oferta único y el ID de producto de plan de pago correspondiente:
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
Puede solicitar al motor de pagos una lista de ofertas de planes válidas para un artículo específico mediante la operación Item Payment Plan Offers.
La solicitud incluye los siguientes detalles:
merchantpayerlocalecurrencyitem[0].skuitem[0].unitPriceitem[1].skuitem[1].unitPriceSe devuelven los siguientes detalles sobre los planes de pago admitidos. A partir de la versión 70, la respuesta contiene los productos admitidos de plan de pago, que es "Paylater Installments":
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrl
Cada oferta de plan de pago tiene un ID de oferta único y el ID de producto de plan de pago correspondiente:
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
Puede solicitar al motor de pagos una lista de productos de planes de pago válidos y ofertas de planes mediante la operación Payment Options Inquiry.
La solicitud contiene lo siguiente:
payerLocaleorder.amountorder.currencyorder.item[n].skuorder.item[n].quantityorder.item[n].unitPriceorder.itemAmountsourceOfFunds.provided.card.prefix
A partir de la versión 70, la respuesta contiene los productos admitidos de plan de pago, que es "Paylater Installments":
paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrlCada oferta de plan de pago tiene un ID de oferta único y el ID de producto de plan de pago correspondiente:
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
Puede enviar la aceptación del pagador de las ofertas de planes de pago al proveedor mediante la operación Update Payment Plan Offers.
- La solicitud contiene lo siguiente:
sourceOfFunds parameter grouporder.amountorder.currencyorder.item[n].quantityorder.item[n].unitPrice
Puede proporcionar los detalles para la aceptación del pagador indicando:
paymentPlanOffer.payerAcceptance = truepaymentPlanOffer.termsAndConditionsDisplayEl valor puede ser una de las siguientes opciones:
NONE: no mostró ningún texto de términos y condiciones.TERMS_AND_CONDITIONS_ONLY: mostró texto de términos y condiciones.TERMS_AND_CONDITIONS_AND_ACCEPTANCE: mostró texto de términos y condiciones y obligó al pagador a aceptar los términos y condiciones.
Enviar una transacción con el plan de pago
Para enviar una transacción con el plan de pago seleccionado por el pagador, proporcione los siguientes campos en una solicitud Authorize/Pay o Update Session. A partir de la versión 70, proporcione el campo paymentPlan.offerID con el ID de la oferta en la respuesta de Payment Options Inquiry.
El motor de pagos procesa un plan de pago solo si se cumplen las siguientes condiciones:
- La moneda del pedido se admite en el plan de pago.
- El monto del pedido excede el monto mínimo del pedido definido en el plan de pago.
- El tipo de tarjeta se admite en el plan de pago.