Activar 3DS - Link de Pago

En esta sección se describe cómo realizar la integración para utilizar 3D Secure 2 a través de Link de Pago. Es aconsejable que previamente se haya leído y/o implementado la guía para Generar Link de Pago

Para integrar una orden con 3DS2 es necesario realizar los siguientes pasos:

1. Crear orden con modalidad 3DS2.

En la creación del link de pago deberás enviar el atributo de three_ds_mode en alguna de sus modalidades (smart/strict):

curl --request POST \
  --url https://api.conekta.io/checkouts \
  --header 'accept: application/vnd.conekta-v2.3.0+json' \
  -u key_eYvWV7gSDkNYXsmr: \
  --header 'content-type: application/json' \
  --data '{
    "three_ds_mode": "strict",
    "name": "Payment Link Name",
    "type": "PaymentLink",
    "recurrent": false,
    "expires_at": 1590882634,
    "needs_shipping_contact": true,
    "order_template": {
        "line_items": [{
            "name": "Red Wine",
            "unit_price": 1000,
            "quantity": 10
        }],
        "currency": "MXN",
        "customer_info": {
            "name": "Juan Perez",
            "email": "[email protected]",
            "phone": "5566982090"
        }
    }
 }'

Notas de los campos:

  • unit_price: con este valor y quantity se calculará el parámetro amount de la petición.

2. Compartir Link de Pago.

Compartir el link recibido como indica aquí

3. Consultar estado de la orden.

Recibir la notificación del pago como indica aquí

Personalizar métodos de pago (opcional)

Por defecto, todos los métodos de pago disponibles en tu cuenta se habilitan automáticamente. Si necesitas personalizarlos:

Usa excluded_payment_methods para ocultar métodos específicos del flujo de pago.

"excluded_payment_methods": ["cash", "bnpl"]

Valores posibles: card, cash, bank_transfer, bnpl, pay_by_bank, google, apple.


Did this page help you?