Verificación KYC

Cómo activar el KYC

Se configura al momento de crear la empresa, durante el onboarding del producto de Domiciliación. Una vez activo, cada domiciliación de tus clientes podrá pasar por el flujo de verificación según la configuración de tu cuenta.

Dónde ver el estado del KYC en el panel

En el Panel de Conekta entra a Domiciliación. Ahí verás una tabla con todas las domiciliaciones de tus clientes.

Cada fila muestra, entre otros datos:

ID de la domiciliación
Fecha
Cliente y Correo electrónico
Banco (cuenta asociada)
KYC: proveedor o flujo de verificación asignado
Estado: estado actual del proceso de KYC de esa domiciliación

Estados del KYC

Estado	Significado
Creado	Se inició el proceso de verificación; el cliente aún no ha completado los pasos.
Pendiente	El cliente tiene pasos por completar o la verificación está en revisión.
Activo	El KYC fue aprobado; la domiciliación puede usarse para cobros.
Rechazado	La verificación no fue aprobada (documentos, monto o firma). La domiciliación no podrá usarse para cobros hasta que se resuelva o se registre una nueva.

Solo cuando el estado sea Activo podrás crear órdenes de pago usando ese método de pago (cuenta CLABE) del cliente.

Pasos del flujo de verificación (qué hace el cliente)

Según la configuración de tu cuenta, el cliente puede tener que completar uno o varios de estos pasos:

1. Validación de monto

Se hace un depósito de un monto bajo en la cuenta CLABE del cliente. El cliente debe indicar correctamente ese monto en el flujo. Así se verifica que es el titular de la cuenta.

2. Firma digital

El cliente firma electrónicamente el contrato o la autorización de domiciliación asociada a esa cuenta.

3. Verificación de documento

El cliente sube documentos de identidad (por ejemplo INE o pasaporte, frente y reverso) y, si se requiere, una selfie. Con esto se verifica su identidad.

El orden y la combinación de pasos dependen de la configuración que tengas en el onboarding; no todos los clientes verán exactamente los mismos pasos.

Crear cliente con domiciliación y KYC

Al crear un cliente con un método de pago de tipo direct_debit_recurrent, Conekta inicia automáticamente un proceso de verificación de identidad (KYC) para esa domiciliación. En la respuesta obtendrás un process_url dentro del objeto de la fuente de pago; Conekta enviará un correo al cliente con ese enlace para que complete el flujo de validación de identidad.

Request

curl --location 'https://api.stg.conekta.io/customers' \
--header 'Accept: application/vnd.conekta-v2.2.0+json' \
--header 'Content-type: application/json' \
--header 'Authorization: Bearer key_YOUR_PRIVATE_API_KEY' \
--data-raw '{
    "name": "Pedro Perez",
    "email": "[email protected]",
    "phone": "5528661416",
    "payment_sources": [
        {
            "type": "direct_debit_recurrent",
            "clabe": "012345678901234568",
            "city": "Ciudad de México",
            "state": "Test state",
            "service_description": "Membresía mensual de gimnasio",
            "frequency": "monthly",
            "contract_date": "2026-01-01T00:00:00Z",
            "max_amount": 15000,
            "contract_type": "domiciliation_simple"
        }
    ]
}'

{
    "livemode": true,
    "name": "Pedro Perez",
    "email": "[email protected]",
    "phone": "5528661416",
    "default_shipping_contact_id": null,
    "default_fiscal_entity_id": null,
    "referrer": null,
    "subscription": null,
    "document_front_url": null,
    "document_back_url": null,
    "id": "cus_2zXoxqWTeL2DRbysb",
    "object": "customer",
    "created_at": 1770922157,
    "corporate": false,
    "metadata": null,
    "custom_reference": "",
    "payment_sources": {
        "object": "list",
        "has_more": false,
        "total": 1,
        "data": [
            {
                "id": "off_ref_2zXoxqWTeL2DRbysc",
                "clabe": "012345678901234568",
                "status": "pending_documents",
                "city": "Ciudad de México",
                "state": "Test state",
                "service_description": "Membresía mensual de gimnasio",
                "frequency": "monthly",
                "contract_type": "domiciliation_simple",
                "contract_date": "2026-01-01T00:00:00+00:00",
                "max_amount": 15000,
                "object": "payment_source",
                "type": "direct_debit_recurrent",
                "expires_at": 0,
                "created_at": 1770922158,
                "parent_id": "cus_2zXoxqWTeL2DRbysb",
                "contract_url": null,
                "kyc": [
                    {
                        "id": "fb190f93-b543-45ab-9e45-9ab56a72a9a6",
                        "status": "pending",
                        "process_url": "https://kyc.stg.conekta.io/flow/fb190f93-b543-45ab-9e45-9ab56a72a9a6"
                    }
                ]
            }
        ]
    },
    "fiscal_entities": null,
    "shipping_contacts": null
}

En cada fuente de pago de tipo direct_debit_recurrent aparece un arreglo kyc. Cada elemento incluye:

Campo	Descripción
id	Identificador único del proceso de KYC.
status	Estado actual del proceso (por ejemplo `pending` mientras el cliente no ha completado los pasos).
process_url	URL del flujo de verificación. Conekta envía un correo al email del cliente con este enlace para que complete la validación de identidad.

El cliente debe seguir las instrucciones del correo y completar el flujo en process_url. Cuando el KYC sea aprobado, el status del payment source podrá cambiar a un estado que permita cobros (por ejemplo ready_to_transactional). Puedes consultar el estado en el Panel de Conekta → Domiciliación.