MSI

Suggest Edits

Que es MSI?

Los "meses sin intereses" en México son una estrategia de venta muy popular que beneficia tanto a los consumidores como a los comercios. Como comercio interesado en implementar esta opción, es esencial comprender cómo funciona.

En México, los meses sin intereses permiten a los clientes realizar compras y pagarlas en cuotas mensuales, sin que se les cobren intereses adicionales. Aunque esto puede sonar como una pérdida para el comercio, en realidad es una estrategia efectiva para aumentar las ventas. Aquí te explico algunos puntos clave:

  1. Atractivo para los Clientes: Ofrecer meses sin intereses hace que tus productos o servicios sean más accesibles para un público más amplio. Muchos consumidores prefieren pagar en cuotas para distribuir el costo de una compra grande a lo largo del tiempo.
  2. Incremento en las Ventas: La posibilidad de pagar en cuotas puede motivar a los clientes a realizar compras más grandes de lo que harían si tuvieran que pagar de inmediato. Esto significa que podrías experimentar un aumento en el valor promedio de compra.
  3. Colaboración con Entidades Financieras: Para ofrecer meses sin intereses, generalmente trabajas en colaboración con instituciones financieras que asumen el costo financiero de los intereses en algunas promociones incentivadas por las mismas. Esto implica un acuerdo entre tu comercio y la entidad financiera para ofrecer esta opción a tus clientes.
  4. Requisitos y Comisiones: Al implementar meses sin intereses, es importante entender los requisitos y posibles comisiones asociadas. Las entidades financieras cobraran una tarifa por el servicio, pero esto puede compensarse con el aumento en las ventas y la lealtad del cliente.
  5. Promoción y Marketing: Puedes utilizar la oferta de meses sin intereses como una herramienta de marketing. Anuncia esta opción en tus materiales promocionales y canales de marketing para atraer a más clientes.
  6. Educación al Cliente: Es fundamental educar a tus clientes sobre cómo funciona el sistema de meses sin intereses. Asegúrate de que comprendan que no se les cobrará interés adicional siempre que cumplan con los términos del plan de pagos.

Como funciona MSI?

  1. El merchant configura en el admin de DEUNA las diferentes mensualidades por PSP (según negociación con los mismos), teniendo en cuenta la franquicia de la tarjeta de crédito en las que aplica, así como el monto mínimo respectivo para cada exhibición configurada.
  2. El checkout del merchant muestra la disponibilidad de los meses al momento en que el comprador ingresa el BIN de la tarjeta.
  3. Tras seleccionar la mensualidad en la lista desplegable mostrada en el checkout, según disponibilidad, la transacción es enviada al PSP para ser procesada.

Como Implementar MSI

  1. En primer lugar debemos configurar al menos una campaña de installments, la cual se consumirá al momento de generar el plan de installments. En el momento que se realice eso, se requiere que la/s campañas estén vigentes. Para ofrecer opciones de financiación con MSI, es fundamental que las opciones de la campaña tengan el installments_type correspondiente (”MSI”).
curl --location --request POST 'https://api.stg.deuna.io:443/merchants/orders' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {{x-api-key}}' \
--data-raw '{
    "order_type": "PAYMENT_LINK",
    "order": {
        "user_id": "95469909-0d54-4e1b-955e-7e0ba9328fbf",
        "order_id": "order-test-123",
        "store_code": "all",
        "total_amount": 5000,
        "currency": "MXN",
        "items_total_amount": 5000,
        "sub_total": 5000,
        "items": [
          {
              "id": "SP40355793993780",
              "name": "producto test",
              "description": "descripcion de producto",
              "total_amount": {
                  "amount": 5000,
                  "currency": "MXN",
                  "currency_symbol": "$",
                  "original_amount": 5000
              },
              "unit_price": {
                  "amount": 5000,
                  "currency": "MXN",
                  "currency_symbol": "$"
              },
              "quantity": 1,
            "image_url": "https://cdn.shopify.com/s/files/1/0586/8339/2052/products/pizza-con-chorizo-jamon-y-queso-1080x671.jpg?v=1656095183",
              "included_in_subscription": true
          }
      ],
			"include_payment_options": [
	        {
	            "payment_method": "credit_card",
	            "processors": ["dlocal"]
	        }
	    ],
			"billing_address": {
          "first_name": "Jhon",
          "last_name": "Doe",
          "phone": "+549222222",
          "identity_document": "1111111111-1",
          "lat": -0.1602236,
          "lng": -78.49664,
          "address1": "Av. del Parque, Quito 170132, Ecuador",
          "address2": "12",
          "city": "Quito",
          "zipcode": "170132",
          "state_name": "Pichincha",
          "state_code": "PICHINCHA",
          "country": "EC",
          "country_code": "EC",
          "additional_description": "12",
          "address_type": "home",
          "email": "[email protected]"
      }
    },   
		"checkout_modules": [
        {
            "name": "LoginPattern",
            "url": "http://cdn.deuna.com/my-pattern/index.js"
        },
        {
            "name": "PaymentFormPattern"
        }
    ]
}'
  1. Posteriormente tenemos que asegurarnos que los merchant payment processors encendidos (enabled) tengan permitido realizar transacciones con installments con el flag allow_installments: true. Se requiere al menos uno con esa opción activa. El flag se puede activar al crear el merchant payment processor o actualizar posterior a su creación.
    Creando merchant payment processor:
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
}'

Actualizando merchant payment processor:

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
}'
  1. Posterior a la creación de la orden, antes de proceder con su pago, podemos consultar las opciones de financiación (installments).
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. Posterior a la selección de la opción, realizar el purchase con la opción de installments seleccionada.
curl --location --request POST 'https://api.dev.deuna.io/merchants/transactions/purchase' \
--header 'x-api-key: {x_api_key}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {user_auth_token}' \
--data-raw '{
    "token": {orden_token},
    "method_type": "credit_card",
    "processor_name": {processor_name},
    "email": "[email protected]",
    "credit_card": {
        "expiry_month": "11",
        "expiry_year": "2025",
        "card_holder": "Duna 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}
        }
    }
}'

Como Probar MSI

  1. Para crear la campaña es necesario autenticarse como merchant y para la misma configurar los “processors” para los cuales se vayan a ofrecer installments. Éstos últimos tienen que tener el id y name del ecosistema Deuna, por ejemplo:

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

    Dentro de “card_branch”, el “name” de las mismas puede ser “visa”, “mastercard” o “amex”.
    Http status codes esperados:

    • 201: creación exitosa de la campaña
    • 401: no autorizado para crear la campaña
    • 400: request inválida

  2. Para crear los merchant payment processors es necesario autenticarse como merchant y tener las credenciales necesarias para luego poder realizar las transacciones con MSI. [debería haber una guía acá de como configurar cada processor].

    Http status codes esperados:

    • 201: creación exitosa del merchant payment processor
    • 401: no autorizado para crear el merchant payment processor
    • 400: request inválida

  3. Posterior a crear la orden [debería de haber algún tutorial de eso] consultar con el bin de la tarjeta (primeros 6 dígitos de la misma) el plan de installments

    Http status codes esperados:

    • 200: obtención exitosa del plan de installments
    • 401: no autorizado para crear el merchant payment processor
    • 400: request inválida
    • 404: no hay merchant payment processors configurados correctamente

  4. Al realizar el purchase con la opción de installments seleccionada, tener en cuenta que todos los datos de prueba de las tarjetas deben proveerse por el procesador (consultar su documentación). En general esos datos son “card_number”, “card_cvv”, “expiry_year” y “expiry_month” (en algunos casos también “card_holder”).

    Http status codes esperados:

    • 200: purchase exitoso
    • 401: usuario no autorizado para realizar el purchase
    • 400: request inválida, como por ejemplo que el merchant no tenga merchant payment processors habilitados
    • 422: el purchase no pudo realizarse debido a que el procesador la declinó

Updated 5 months ago