Saltar al contenido principal
En esta página

Las campañas de financiación convierten las reglas del comerciante en opciones de pago que DEUNA puede mostrar para un pedido y una tarjeta específicos. Una campaña no cobra al cliente directamente. Define qué condiciones son elegibles; el proceso de pago recupera esas condiciones y la compra envía la opción seleccionada por el cliente.

¿Qué es una campaña de financiación?#

Una campaña es un conjunto de reglas de elegibilidad y precios definido por el comerciante. En el DEUNA Admin, elige el tipo de campaña, la moneda, el período de validez, los proveedores de pago, los términos de financiación y las reglas de las marcas de tarjetas. Cada regla de marca de tarjeta puede definir un importe mínimo y máximo por cuota, así como la tasa o el coste del comerciante aplicable.

En el momento del pago, DEUNA combina la campaña con el contexto de pago en vivo. Una opción se devuelve solo cuando se cumplen las condiciones relevantes.

Campaña o contexto de pagoCómo afecta al resultado
Comerciante, tienda, estado y fechasLa campaña debe pertenecer al comerciante, aplicarse a la tienda de la orden, estar activa y estar dentro de su período de validez. Una campaña sin override de tienda se aplica a all.
MonedaLa opción de moneda de la campaña debe coincidir con la moneda de la orden.
Marca de tarjetaDEUNA determina la marca a partir del BIN suministrado o de la tarjeta almacenada y aplica la regla de marca correspondiente.
Rango del importe por cuotaEl importe calculado de cada cuota debe cumplir con el mínimo y el máximo opcional configurado para ese plazo y marca.
Proveedor de pagosAl menos un procesador configurado en la campaña debe ser elegible para el pago.
Restricciones de enrutamientoEl enrutamiento inteligente o dinámico puede eliminar procesadores o plazos de cuotas que no sean válidos para la ruta seleccionada.

De la campaña al pago#

Diagrama de secuencia
1Merchant in DEUNAAdmin2Merchant checkout3DEUNA4ClienteConfigure and activate MSI or MCIcampaignGet installments for order+ BIN or card IDMatch campaign, card,amount, provider, androuteApplicable options withplan_option_idShow returned labels and amountsSelect one optionPurchase with installments+ exact plan_option_id
DEUNAComercio o cliente

Para DEUNA Widgets, la experiencia de pago compatible recupera y presenta las opciones aplicables. Para una integración de API directa, su proceso de pago recupera, muestra los valores devueltos y envía la selección con Purchase V2.

1. Configurar una campaña#

Acceda a Configuración de cuotas en el DEUNA Admin. Un usuario necesita permiso para ver campañas de cuotas; crear, editar, activar o desactivarlas requiere el permiso de edición correspondiente.

  1. Seleccione MSI o MCI, nombre la campaña y confirme su moneda.
  2. Defina una fecha de inicio y fin opcional, o deje la campaña sin un período de validez fijo.
  3. Seleccione uno o más proveedores de pago compatibles.
  4. Agregue los términos de pago.
  5. Para cada término, habilite las marcas de tarjetas y configure su rango y tasa de importe por cuota.
  6. Guarde y active la campaña.

El soporte del proveedor, los acuerdos comerciales y la configuración de la cuenta determinan qué procesadores aparecen. Confirme los requisitos no compatibles o específicos del mercado con su Administrador Técnico de DEUNA.

2. Obtener las opciones aplicables#

Utilice el token de pedido y un BIN de tarjeta para obtener las opciones para una nueva tarjeta. Un flujo de tarjeta almacenada puede utilizar su identificador de tarjeta compatible. Debido a que la elegibilidad depende del pedido, un viaje de API Direct que muestra las cuotas antes del pago necesita un token de pedido.

curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/transactions/orders/ORDER_TOKEN/installments?bin=411111' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: YOUR_MERCHANT_ID'

Ver Listar las opciones de cuotas para el contrato completo del endpoint.

Una opción devuelta contiene los valores que su punto de venta debe mostrar y conservar:

JSON
{
  "installments": [
    {
      "installments": 6,
      "installments_amount": 16667,
      "display_installments_amount": "MXN 166.67",
      "installment_rate": 0,
      "display_installment_label": "6 payments of MXN 166.67 without interest",
      "plan_option_id": "a4756a5f-7f9b-414d-8712-e3a9da2be337",
      "installment_total_amount": 100000,
      "display_installment_total_amount": "MXN 1,000.00"
    }
  ]
}

Los importes se expresan en la unidad minor del tipo de cambio. Utilice los campos de visualización para mostrar la información al cliente cuando se devuelven, y mantenga los campos numéricos para los cálculos y la conciliación.

3. Enviar la opción seleccionada#

enviar tanto valores del mismo elemento de respuesta:

  • payment_source.card_info.installments: el número de cuotas seleccionado.
  • payment_source.card_info.installment.plan_option_id: el ID exacto de esa opción seleccionada.
JSON
{
  "order_token": "ORDER_TOKEN",
  "payer_info": {
    "email": "customer@example.com"
  },
  "payment_source": {
    "method_type": "credit_card",
    "card_info": {
      "card_id": "CARD_ID",
      "installments": 6,
      "installment": {
        "plan_option_id": "a4756a5f-7f9b-414d-8712-e3a9da2be337"
      }
    }
  }
}

El número y el ID deben describir la misma opción. DEUNA utiliza el ID de la opción para recuperar el plan resuelto y los procesadores elegibles, y utiliza el número de cuotas en la solicitud de pago enviada a través de la conexión seleccionada.

Continuar con Crear pago para el contrato completo de Compra V2.

Lista de verificación de implementación#

  • Mostrar solo las opciones devueltas para el contexto de pedido y tarjeta actual.
  • Conservar plan_option_id con su correspondiente installments value.
  • Para MCI, mostrar el total financiado y el importe de la cuota antes de la confirmación.
  • Obtener las opciones nuevamente cuando cambie el importe del pedido, la moneda, la tarjeta o el contexto de pago relevante.
  • Considerar que una lista de opciones vacía es "una opción de campaña no elegible", y no un fallo de pago.
  • Probar con tarjetas y proveedores de pago aprobados para la campaña configurada.

En esta sección