Saltar al contenido principal
Todos los sistemas operativosNovedadesv1
Iniciar sesión

Cuotas con interés (MCI)

En esta página

Pagos mensuales con intereses es una opción de pago que permite a tus clientes dividir el coste de una compra en varias cuotas mensuales, aplicando intereses sobre el saldo pendiente.

Con MCI, un cliente paga una tasa de interés adicional por dividir el costo de compra en cuotas mensuales.

Cuando un cliente opta por pagar mediante Pagos Mensuales con intereses, el costo total de la compra se divide en cuotas mensuales y se aplican tasas de interés sobre el saldo restante en cada período.

Cómo funciona MCI#

Así es como funciona un flujo MCI:

  1. La tienda configura las diferentes opciones de pago mensual por PSP en el Admin de DEUNA.
  2. Se tiene en cuenta lo siguiente:
    • La franquicia de tarjetas de crédito a la que se aplica.
    • El monto mínimo respectivo para cada cuota configurada.
    • El interés que se aplica a cada franquicia.
  3. La caja de la tienda muestra la disponibilidad de MCI cuando un cliente ingresa el BIN de una tarjeta.
  4. El cliente selecciona el pago mensual de una lista que se muestra en el proceso de pago.
  5. La transacción se envía al PSP para su procesamiento.

Implementar MCI#

Para utilizar MSI o MCI, configure al menos una campaña de cuotas.

Para ofrecer opciones de pago a plazos:

  1. Generar las opciones de campaña. installments_type.
curl --location --request POST 'https://apigw.getduna.com/merchants/{merchant_id}/installments/campaigns' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {merchant_auth_token}' \
--data '{
    "name": "new campaign",
    "description": "testing campaign MCI",
    "status": "active",
    "processors": [
        {
            "id": {processor_id},
            "name": {processor_name}
        }
    ],
		// display_label_template is optional; that configuration allows you to 
		// change the format of the field "display_label_amount" of each available 
    	'// option when you generate an installment plan. If you don`t configurate this'
    	'// field, the template will be the default one.'
    "display_label_template": {
        "language": "es",
        "MSI": "{installments} meses sin intereses de ${amount}",
        "MCI": "{installments} meses de ${amount}"
    },
    "options": [
        {
            "installments": 3,
            "installments_type": "MCI",
            "currency": "MXN",
            "card_branch": [
                {
										// minimum amount for installment amount in the plan, this option
										// will be valid to generate installment plan only in that case;
										// For example, with a total amount of $2100; in 3 installments the amount 
										// will be of $700, so $700 >= $500, then the option is valid to
										// generate an installment plan of $2100 (you can offer 3 installments
										// to pay $2100). In the case of having intallments_rate greater than 0, 
										// first the interest is applied to the amount and then it is compared with the min_amount.
                    "amount_min": 500,
										// optional, the same example than amount_min but with the maximum value.
                    "amount_max": 2000,
                    "name": "visa",
										// is the percentage applied to the amount in order to generate the options for the plan.
										"installment_rate": 1.5,
										// use the operators "amount", "rate" and "installments" when calculate the new amount;
										// if it's not specified, the calculation is the default for interests: "amount+(amount*(rate/100))"
										"installments_interest_formula": "amount+((amount*rate*installments)/100)"
                }
            ]
        },
        {
            "installments": 6,
            "installments_type": "MCI",
            "currency": "MXN",
            "card_branch": [
                {
                    "amount_min": 250,
                    "amount_max": 1000,
                    "name": "visa",
                }
            ]
        }
				// you can offer more options, the installments quantity must be divisible by 3.
    ]
}'
  1. Habilite los procesadores de pagos de su tienda para realizar transacciones con la bandera allow_installments: true. El comportamiento de la bandera es el siguiente:
    • "MCI" or null: El monto que va al procesador no tiene intereses aplicados y la transacción debe actualizarse luego de ser procesada con los intereses aplicados por el procesador. Los campos que se actualizan en función de la respuesta del procesador son:
      • amount
      • installments_amount
      • installments_rate
    • "MSI": Una transacción sin intereses se realiza contra el procesador que realiza la transacción. El importe llega al procesador con el interés calculado. El importe se actualiza antes de realizar la transacción y ser enviado al procesador.

Ejemplo para crear el procesador

curl --location --request POST 'https://apigw.getduna.com/merchants/{merchant_id}/stores/{store_code}/processors' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {merchant_auth_token}' \
--data '{
    "name": {processor_name},
    "payment_processor_id": {processor_id},
    "enabled": true,
    "currency_iso3": "MXN",
    "external_merchant_id": "your merchant id in payment processor",
    "public_api_key": "your public key in payment processor",
		"private_api_key": "your private key in payment processor",
    "allow_installments": true,
		"mci_to_psp_as": "MCI"|"MSI"
}'

Ejemplo para actualizar el procesador

curl --location --request PATCH 'https://apigw.getduna.com/merchants/{merchant_id}/stores/{store_code}/processors/{merchant_payment_processor_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {merchant_auth_token}' \
--data '{
    "allow_installments": true,
		"mci_to_psp_as": "MCI"|"MSI"
}'
  1. Verifique si la tienda puede utilizar los plazos preconfigurados proporcionados por VTEX.
    • Cuando esté soportado, los plazos obtenidos de VTEX deben coincidir con las opciones de la campaña y ya deben incluir los intereses aplicables.
    • De lo contrario, DEUNA construye el plan de pago MCI a partir de la configuración de la campaña. La cantidad depende de:
      • installments_rate: Se aplica al monto directamente si no installments_interest_formula está definido.
      • installments_interest_formula: Si se especifica, define el cálculo de intereses en función de:
        • amount
        • rate
        • installments
  1. Configurar el endpoint DEUNA según las cuotas habilitadas en VTEX.
    1. Cree un punto final externo, especificando que es para MCI.
    2. Si no configura el punto final, se utiliza un punto final predeterminado para el caso.
curl --location 'https://apigw.getduna.com/merchants/{merchant_id}/external-endpoints' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {merchant_auth_token}' \
  --data '{
      "url": "https://middleware.deuna.io/api/v1/merchants/{merchant_id}/transactions/{transaction_id}/installments/mci?bin={bin}&salesChannel=1&paymentProcessors=t1pagos",
      "http_method": "GET",
      "headers": [
          {
              "key": "vtex-key-header",
              "value": "vtex-value-header"
          }
      ],
      "config_type": "MCI"
  }'
  1. Consultar opciones de pago en cuotas.
curl --location --request GET 'https://apigw.getduna.com/merchants/transactions/orders/{orden_token}/installments?bin={card_bin}'
	--header 'x-api-key: {x_api_key}'
	--header 'Authorization: Bearer {merchant_auth_token}'
  1. Seleccione una opción de pago a plazos.
  2. Realiza la compra con la opción de pago en cuotas.
curl --location --request POST 'https://api.sandbox.deuna.io/v2/merchants/orders/purchase' \
--header 'x-api-key: {x_api_key}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {user_auth_token}' \
--data-raw '{
    "order_token": "{order_token}",
    "payer_info": {
        "email": "test123@testuser.com"
    },
    "payment_source": {
        "method_type": "credit_card",
        "processor": "{processor_name}",
        "card_info": {
            "expiry_month": "11",
            "expiry_year": "2028",
            "card_holder": "DEUNA Developers",
            "card_holder_dni": "185396924",
            "card_number": "4111111111111111",
            "card_cvv": "123",
            "address1": "Vergara 548",
            "zip": "001100",
            "city": "Santiago",
            "state": "RM",
            "country": "CL",
            "phone": "12345755",
            "installment": {
                "plan_option_id": "{plan_option_id}"
            }
        }
    }
}'

Prueba de deterioro cognitivo leve#

Para crear la campaña es necesario:

  • Estar autenticado como comerciante.
  • Configura los procesadores que ofrecen cuotas.
  • Los procesadores deben tener el id y nombre del ecosistema DEUNA.

Ejemplo

JavaScript
{
	"processors": [
		{
			"id": 39,
			"name": "mercadopago"
		}
	]
}

La misma campaña debe tener sus opciones con "installments_type": "MCI".

Ejemplo

JavaScript
{
	"options": [
        	{
            	"installments": 3,
            	"installments_type": "MCI",
            	"currency": "MXN",
            	"card_branch": [
                	...
            	]
        	}
	]
}

dentro card_branch, el "name" puede ser:

  • visa
  • mastercard
  • amex

Códigos de respuesta esperados

  • 201: Creación de campaña exitosa.
  • 401: No autorizado para crear la campaña.
  • 400: Solicitud no válida.

Para crear procesadores de pagos comerciales, debe:

  1. Autenticarse como comerciante.
  2. Contar con las credenciales necesarias para realizar transacciones a plazos.

Cuotas con VTEX

Verifique la disponibilidad de MCI para la tienda VTEX requerida con su representante de DEUNA antes de probar la recuperación de plazos.

El representante de DEUNA confirmará la tienda elegible, la campaña, las conexiones de procesadores y si los valores de plazos proporcionados por VTEX o el cálculo de la campaña de DEUNA son los autoritarios.

Si requiere alguna configuración adicional para configurar un endpoint con credenciales específicas para VTEX, deberá crear un endpoint externo.

Códigos de respuesta esperados

  • 200: Creación exitosa de punto final externo.
  • 401: No autorizado para crear un punto final externo.
  • 400: Solicitud no válida.

Consulta de cuotas

Consulta el plan de cuotas con la tarjeta BIN después de crear un pedido.

Códigos de respuesta esperados

  • 200: Recuperación exitosa del plan de cuotas.
  • 401: No autorizado para crear un procesador de pagos comerciales.
  • 400: Solicitud no válida.
  • 404: No hay procesadores de pagos comerciales configurados correctamente.

Tarjetas de prueba

Proporcione todos los datos de la tarjeta de prueba del procesador.

En general los datos son:

  • "card_number"
  • "card_cvv"
  • "expiry_year"
  • "expiry_month"
  • "card_holder"

Códigos de respuesta esperados

  • 200: transacción exitosa.
  • 401: Usuario no autorizado para realizar la compra.
  • 400: Solicitud no válida, como que el comerciante no ha habilitado los procesadores de pagos comerciales.
  • 422: La transacción no se pudo realizar porque el procesador la rechazó.