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

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

1. Crear orden con modalidad 3DS2.

En la creación de la orden que usará component deberás enviar el atributo de three_ds_mode en alguna de sus modalidades (smart/strict):

-H "Accept: application/vnd.conekta-v2.3.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X POST -d '{
    "three_ds_mode": "strict",
    "currency": "MXN",
    "line_items": [{ 
     "name": "Nombre del Producto o Servicio",
     "unit_price": 23000,
     "quantity": 1
   }],
   "customer_info": {
     "name": "Jorge Martínez",
     "email": "[email protected]",
     "phone": "+5218181818181"
   },
    "metadata":{
     "datos_extra": "1234"
   },
   "checkout": {
     		"type": "Integration"
     }
}’https://api.conekta.io/orders

{
    "livemode": false,
    "amount": 23000,
    "currency": "MXN",
    "payment_status": "paid",
    "amount_refunded": 0,
    "customer_info": {
        "email": "[email protected]",
        "phone": "+5218181818181",
        "name": "Jorge Martínez",
        "object": "customer_info"
    },
    "object": "order",
    "id": "ord_2tQAKpPrfkdyzZvfM",
    "metadata": {
        "datos_extra": "1234"
    },
    "is_refundable": true,
    "created_at": 1676929549,
    "updated_at": 1676929551,
    "line_items": {
        "object": "list",
        "has_more": false,
        "data": [
            {
                "name": "Nombre del Producto o Servicio",
                "unit_price": 23000,
                "quantity": 1,
                "object": "line_item",
                "id": "line_item_2tQAKpPrfkdyzZvfK",
                "parent_id": "ord_2tQAKpPrfkdyzZvfM",
                "metadata": {},
                "antifraud_info": {}
            }
        ]
    },
    "charges": {
        "object": "list",
        "has_more": false,
        "data": [
            {
                "id": "63f3ea0d88dc6c0019a3fe39",
                "livemode": false,
                "created_at": 1676929549,
                "currency": "MXN",
                "device_fingerprint": "e6edc7bb5ca296c0c61acb60ad20d083",
                "payment_method": {
                    "name": "ESTEFANIA ALBARRAN",
                    "exp_month": "12",
                    "exp_year": "23",
                    "auth_code": "731650",
                    "object": "card_payment",
                    "type": "credit",
                    "last4": "4242",
                    "brand": "visa",
                    "issuer": "banamex",
                    "account_type": "BANAMEX",
                    "country": "MX",
                    "fraud_indicators": []
                },
                "object": "charge",
                "description": "Payment from order",
                "status": "paid",
                "amount": 23000,
                "paid_at": 1676929550,
                "fee": 1255,
                "customer_id": "",
                "order_id": "ord_2tQAKpPrfkdyzZvfM" 
            }
        ]
    }
}

❗️
Atención
A diferencia de la creación de cargos por Direct API, aquí NO debes enviar el atributo return_url

2. Montar el component.

Inicializar el component como se describe aquí

3. Capturar eventos.

Capturar los eventos de la orden como se describe 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.