> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Inscribir un método de pago

> Inscribe el método de pago de un cliente y devuelve un token almacenado para uso futuro

Esta solicitud inscribe un método de pago para un cliente. Con la información que Yuno proporciona después de que el cliente selecciona el método de pago a inscribir, podrás guardar esa información para compras futuras usando el objeto de método de pago creado.

Consulta los [métodos de pago disponibles en Yuno](https://docs.y.uno/es/reference/payment-type-list.md). Deberás configurar tus credenciales para cada método de pago en el dashboard de Yuno para poder usarlos.

Ten en cuenta que esta solicitud requiere un `X-Idempotency-Key`. Consulta la página [Authentication](https://docs.y.uno/es/reference/getting-started/authentication.md#idempotency) para más información.

> [!NOTE]
>
> **Webhooks**
>
> Recomendamos escuchar [Webhooks](https://docs.y.uno/es/docs/webhooks/configure-webhooks.md) para mantenerte al día con el estado de los métodos de pago inscritos de tus clientes.

Si un cliente inscribe la misma tarjeta varias veces, Yuno crea una nueva inscripción cada vez y devuelve un `vaulted_token` distinto. Usa el `fingerprint` de la tarjeta en la respuesta de la inscripción para detectar duplicados de tu lado (el fingerprint puede ser `null` para algunos proveedores). Consulta [Card Fingerprint](https://docs.y.uno/es/docs/security-and-compliance/fingerprint.md).

> [!WARNING]
>
> **Disponible solo para comercios certificados en PCI.**


## OpenAPI

````yaml openapi/es/payment-methods-direct-workflow/enroll-payment-method-api.json POST /customers/{customer_id}/payment-methods
openapi: 3.1.0
info:
  title: customer-api-register-payment-method
  version: 1.0.2
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
    sec2: []
paths:
  /customers/{customer_id}/payment-methods:
    post:
      summary: Inscribir método de pago
      operationId: enroll-payment-method-api
      parameters:
        - name: customer_id
          in: path
          description: >-
            El identificador único del cliente, creado con el endpoint [Create
            Customer](https://docs.y.uno/es/reference/customers/create-customer)
            (MAX 64; MIN 36).
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - account_id
                - country
                - type
              properties:
                account_id:
                  type: string
                  description: >-
                    El identificador único de la cuenta. Encuentras esta
                    información en el [Dashboard de
                    Yuno](https://dashboard.y.uno/) (MAX 64; MIN 36).
                country:
                  type: string
                  description: >-
                    El código de país de la transacción (MAX 2; MIN 2; [ISO
                    3166-1](/es/reference/country-reference)).
                  enum:
                    - AR
                    - BO
                    - BR
                    - CL
                    - CO
                    - CR
                    - EC
                    - SV
                    - GT
                    - HN
                    - MX
                    - NI
                    - PA
                    - PY
                    - PE
                    - US
                    - UY
                type:
                  type: string
                  description: >-
                    El tipo de método de pago (MAX 255; MIN 3; [Tipo de
                    pago](/es/reference/payment-type-list)).
                  enum:
                    - CARD
                    - ACH_ENROLLMENT
                    - NU_PAY_ENROLLMENT
                    - SEPA_ENROLLMENT
                workflow:
                  type: string
                  description: >-
                    El flujo de pago indica si la integración usará el SDK de
                    Yuno o será una conexión directa entre sistemas. Como estás
                    en el flujo Direct, el valor debe ser `DIRECT`.
                  default: DIRECT
                  enum:
                    - DIRECT
                callback_url:
                  type: string
                  description: >-
                    URL a la que se devuelve al cliente después de una
                    inscripción en el entorno de un proveedor. Solo es necesaria
                    para integraciones de métodos de pago alternativos (MAX 255;
                    MIN 3).
                metadata:
                  type: array
                  description: >-
                    Etiquetas personalizadas opcionales de clave y valor para la
                    inscripción (por ejemplo, on_behalf_of, order_ref). Son
                    opacas para Yuno: se almacenan con el método de pago
                    inscrito, se devuelven cuando lo obtienes y en el webhook
                    `enrollment.enroll`, y se envían a la integración del
                    proveedor junto con la inscripción, igual que el `metadata`
                    del pago llega a él en un cobro. La entrada reservada
                    `gateway_options` es la excepción: se almacena y se
                    devuelve, pero no se reenvía con la inscripción. Hasta 120
                    elementos y 75000 caracteres en total, contando cada clave y
                    cada valor.
                  items:
                    properties:
                      key:
                        type: string
                        description: >-
                          La clave de la metadata (MAX 48. Valor: MIN:1,
                          MAX:48). **[Distingue mayúsculas y minúsculas]**
                      value:
                        type: string
                        description: >-
                          El valor de la clave de la metadata (MAX 512. Valor:
                          MIN:1, MAX:512). **[Distingue mayúsculas y
                          minúsculas]**
                    required:
                      - key
                      - value
                    type: object
                token:
                  type: string
                  format: uuid
                  description: >-
                    Token pregenerado usado para hacer referencia al método de
                    pago que se está inscribiendo.
                parent_type:
                  type: string
                  description: >-
                    Tipo del método de pago principal, usado al inscribir un
                    método tokenizado o derivado (por ejemplo, `CARD`).
                account_updater:
                  type: boolean
                  description: >-
                    Control por tarjeta para Card Account Updater. Cuando se
                    define en `false`, esta tarjeta se excluye de Card Account
                    Updater y no recibirá actualizaciones automáticas de los
                    datos de la tarjeta. Cuando se omite, la tarjeta sigue la
                    configuración de Account Updater de tu cuenta. Se aplica en
                    la inscripción.
                card_data:
                  type: object
                  description: >-
                    Especifica los detalles de la tarjeta. Solo para
                    integraciones con flujo `DIRECT`.
                  required:
                    - number
                    - expiration_month
                    - expiration_year
                  properties:
                    number:
                      type: string
                      description: >-
                        Número de la tarjeta sin separadores (MAX 19; MIN 8) -
                        solo disponible para comercios con certificación PCI.
                    expiration_month:
                      type: integer
                      description: >-
                        Mes de vencimiento de la tarjeta - MM (MAX 2; MIN 2) -
                        solo disponible para comercios con certificación PCI.
                      format: int32
                    expiration_year:
                      type: integer
                      description: >-
                        Año de vencimiento de la tarjeta - YYYY  (MAX 4; MIN 4)
                        - solo disponible para comercios con certificación PCI.
                      format: int32
                    security_code:
                      type: string
                      description: >-
                        Código de seguridad de la tarjeta (MAX 4; MIN 3) - solo
                        disponible para comercios con certificación PCI.
                    holder_name:
                      type: string
                      description: >-
                        Nombre completo del titular de la tarjeta tal como
                        aparece en la tarjeta (MAX 26; MIN 2) - solo disponible
                        para comercios con certificación PCI.
                    brand:
                      type: string
                      description: >-
                        Marca de la tarjeta (por ejemplo, `VISA`, `MASTERCARD`,
                        `AMEX`).
                    scheme:
                      type: string
                      description: >-
                        Esquema de tarjeta usado para procesar la transacción
                        (esquema de tarjeta validado).
                    soft_descriptor:
                      type: string
                      description: >-
                        Descriptor del extracto que se muestra en el estado de
                        cuenta bancario del titular de la tarjeta.
                    card_pin:
                      type: string
                      description: >-
                        PIN de la tarjeta, para los métodos de pago que lo
                        requieren.
                    authentication_method:
                      type: string
                      description: Método de autenticación para Click-to-Pay.
                      enum:
                        - FIDO2
                        - OWN_CREDENTIALS
                        - FEDERATED_ID
                customer_payer:
                  type: object
                  description: >-
                    Información sobre el cliente o pagador asociado con el
                    método de pago.
                  properties:
                    code:
                      type: string
                      description: >-
                        Identificador de cliente de Yuno (código de cliente).
                        MIN 3 / MAX 255.
                    organization_customer_external_id:
                      type: string
                      description: >-
                        Identificador del cliente en el propio sistema del
                        comercio, dentro del alcance de la organización. MIN 3 /
                        MAX 255.
                    email:
                      type: string
                      description: Dirección de email del cliente.
                    ip_address:
                      type: string
                      description: >-
                        Dirección IP del cliente en el momento de la
                        inscripción. Requerida por el proveedor para el mandato
                        ACH en línea.
                    browser_info:
                      type: object
                      description: >-
                        Metadatos del navegador. Requeridos por el proveedor
                        para el mandato ACH en línea.
                      properties:
                        user_agent:
                          type: string
                          description: >-
                            Cadena user-agent completa del navegador del
                            cliente.
                payment_method:
                  type: object
                  description: >-
                    Envoltorio del método de pago usado para métodos que no son
                    tarjeta (por ejemplo, transferencia bancaria / ACH) y para
                    las opciones de vault.
                  properties:
                    type:
                      type: string
                      description: >-
                        Etiqueta del tipo de método para el instrumento inscrito
                        (por ejemplo, `ACH_ENROLLMENT`). El tipo de inscripción
                        lo determina el `type` de nivel superior; este campo es
                        informativo.
                    vault_on_success:
                      type: boolean
                      description: >-
                        Cuando es `true`, el método de pago se guarda en el
                        vault después de una inscripción exitosa.
                    network_token:
                      type: boolean
                      description: >-
                        Opcional. Solo `CARD`. Control por tarjeta para los
                        [network
                        tokens](/es/docs/security-and-compliance/network-tokens#choose-per-card).
                        `false`: Yuno no aprovisiona un network token para esta
                        tarjeta, incluidas las tarjetas inscritas sin CVV.
                        `true` u omitido: Yuno aprovisiona uno como hasta ahora.
                        Requiere que tu organización esté incorporada a los
                        network tokens para la red de la tarjeta; cuando no lo
                        está, no se aprovisiona ningún token y la inscripción no
                        falla.
                    vault_only:
                      type: boolean
                      description: >-
                        Cuando es `true`, Yuno almacena los datos bancarios de
                        `payment_method.detail.bank_transfer` e inscribe el
                        método de pago de inmediato como `ENROLLED`, sin ninguna
                        interacción con el proveedor al inscribir ni al anular
                        la inscripción. Solo disponible para inscripciones de
                        transferencia bancaria.
                    detail:
                      type: object
                      description: >-
                        Detalles específicos del método para el instrumento que
                        se inscribe.
                      properties:
                        bank_transfer:
                          type: object
                          required:
                            - beneficiary_name
                            - routing_number
                          properties:
                            account_type:
                              type: string
                              description: Tipo de cuenta bancaria.
                              enum:
                                - CHECKINGS
                                - SAVINGS
                            account_holder_type:
                              type: string
                              description: >-
                                Tipo de titular de la cuenta (por ejemplo,
                                `INDIVIDUAL`, `ENTITY`). Se acepta y se
                                almacena, pero no se reenvía al proveedor para
                                ACH: no controla el tratamiento como persona o
                                empresa en la inscripción ACH.
                              enum:
                                - INDIVIDUAL
                                - ENTITY
                            bank_id:
                              type: string
                              description: Identificador del banco. MIN 3 / MAX 255.
                            bank_name:
                              type: string
                              description: Nombre del banco. MIN 3 / MAX 255.
                            bank_account:
                              type: string
                              description: Número de cuenta bancaria. MIN 3 / MAX 255.
                            beneficiary_name:
                              type: string
                              description: >-
                                Nombre del beneficiario de la cuenta. MIN 3 /
                                MAX 255.
                            branch:
                              type: string
                              description: Código de sucursal bancaria. MIN 1 / MAX 8.
                            branch_digit:
                              type: string
                              description: >-
                                Dígito de verificación de la sucursal. MIN 1 /
                                MAX 2.
                            routing_number:
                              type: string
                              description: Número de ruta bancaria. MIN 3 / MAX 255.
                            code:
                              type: string
                              description: Código del banco. MIN 1 / MAX 8.
                            reference:
                              type: string
                              description: >-
                                Referencia asociada con la cuenta bancaria. MIN
                                1 / MAX 255.
                            bank_account_mask_number:
                              type: string
                              description: >-
                                Número enmascarado de la cuenta bancaria
                                asociada a la transferencia (por ejemplo,
                                ****6789). Es un dato de la cuenta, no del
                                mandato.
                            mandate:
                              type: object
                              description: >-
                                Datos del mandato de débito directo, para los
                                métodos de transferencia bancaria que funcionan
                                con mandatos (por ejemplo, ACH, SEPA, BACS,
                                PAD).
                              properties:
                                id:
                                  type: string
                                  description: >-
                                    Identificador del mandato, tal como lo
                                    entrega el proveedor de pagos.
                                info:
                                  type: string
                                  description: Free-text mandate information.
                                received_status:
                                  type: string
                                  description: >-
                                    Estado del proveedor que indica si se
                                    recibió el mandato. Se reenvía tal como lo
                                    entrega el proveedor de pagos.
                                existing_status:
                                  type: string
                                  description: >-
                                    Estado del proveedor del mandato existente.
                                    Se reenvía tal como lo entrega el proveedor
                                    de pagos.
                                created_at:
                                  type: string
                                  format: date-time
                                  description: >-
                                    Fecha y hora en que se creó el mandato (ISO
                                    8601).
                                updated_at:
                                  type: string
                                  format: date-time
                                  description: >-
                                    Fecha y hora de la última actualización del
                                    mandato (ISO 8601).
                                creditor_id:
                                  type: string
                                  description: >-
                                    Identificador del acreedor del mandato de
                                    débito directo (por ejemplo, el
                                    identificador de acreedor SEPA que aparece
                                    en el extracto bancario del pagador). MIN 1
                                    / MAX 128.
                provider_data:
                  type: object
                  description: >-
                    Datos del proveedor usados para la migración de tokens o la
                    inscripción con token del proveedor. Envía este objeto
                    cuando `token_source` sea `PROVIDER_API`, `MIGRATION_FILE` o
                    `PROVIDER_TOKEN`. Su uso debe acordarse con tu asesor
                    comercial en Yuno.
                  required:
                    - id
                  properties:
                    id:
                      type: string
                      description: El identificador único del proveedor de pago.
                    token_source:
                      type: string
                      description: >-
                        Origen del token proporcionado. Nota: `PROVIDER_TOKEN`
                        solo se admite cuando el `type` de nivel superior es
                        `CARD`. Usarlo con `ACH_ENROLLMENT` devuelve un error.
                      enum:
                        - PROVIDER_API
                        - MIGRATION_FILE
                        - PROVIDER_TOKEN
                    payment_method_token:
                      type: string
                      description: >-
                        Token del método de pago del proveedor. Obligatorio
                        cuando `token_source` es `PROVIDER_TOKEN`.
                    connection_id:
                      type: string
                      format: uuid
                      description: >-
                        Identificador de la conexión del proveedor. Obligatorio
                        cuando `token_source` es `PROVIDER_API` o
                        `PROVIDER_TOKEN`.
                verify:
                  type: object
                  description: >-
                    Indica si se debe verificar el pago con una transacción de
                    verificación o no. Necesitas tener un proveedor definido en
                    tu ruta CARD. False por defecto.
                  required:
                    - vault_on_success
                  properties:
                    vault_on_success:
                      type: boolean
                      description: >-
                        Indica si se debe verificar el pago con una transacción
                        de verificación o no. Necesitas tener un proveedor
                        definido en tu ruta CARD. False por defecto.
                    currency:
                      type: string
                      description: >-
                        Moneda de la verificación de la tarjeta. Para ver la
                        lista completa de códigos de moneda, consulta la
                        [Referencia de países](/es/reference/country-reference)
                        (MAX 3; MIN 3; ISO 4217).
                    external_subscription:
                      type: object
                      description: >-
                        Vincula la verificación de la tarjeta con una
                        suscripción gestionada en una plataforma de facturación
                        externa. El objeto se devuelve en la respuesta de la
                        inscripción y se guarda en el pago de verificación
                        (`verify.payment.id` en la respuesta): correlaciónalo
                        después mediante Retrieve Payment y los webhooks de
                        pago; no lo devuelven el endpoint de obtención del
                        método de pago ni los webhooks de inscripción. Requiere
                        que `vault_on_success` sea `true`; enviarlo de otro modo
                        devuelve `INVALID_PARAMETERS`.
                      properties:
                        id:
                          type: string
                          description: Identificador de la suscripción en tu sistema.
                        customer_id:
                          type: string
                          description: >-
                            Identificador del cliente de la suscripción en tu
                            sistema.
                    metadata:
                      type: array
                      description: >-
                        Etiquetas personalizadas opcionales de clave y valor
                        para la verificación (por ejemplo, order_ref, invoice).
                        Se adjuntan al pago de verificación interno creado por
                        la verificación, y están disponibles más adelante igual
                        que el `metadata` del pago (datos del pago, solicitud al
                        gateway del proveedor, enrutamiento), y se almacenan con
                        la configuración de verificación del método de pago
                        inscrito. Hasta 120 elementos.
                      items:
                        properties:
                          key:
                            type: string
                            description: >-
                              La clave de la metadata (MAX 48. Valor: MIN:1,
                              MAX:48). **[Distingue mayúsculas y minúsculas]**
                          value:
                            type: string
                            description: >-
                              El valor de la clave de la metadata (MAX 512.
                              Valor: MIN:1, MAX:512). **[Distingue mayúsculas y
                              minúsculas]**
                        required:
                          - key
                          - value
                        type: object
                recurring_payment:
                  type: object
                  description: >-
                    Metadatos de facturación recurrente o de suscripción
                    asociados con el método inscrito.
                  properties:
                    regular_billing:
                      type: object
                      properties:
                        label:
                          type: string
                          description: Etiqueta visible del plan de facturación recurrente.
                        amount:
                          type: object
                          properties:
                            currency:
                              type: string
                              description: >-
                                Moneda de facturación, formato ISO 4217 (3
                                letras).
                            value:
                              type: number
                              description: >-
                                Monto de facturación por intervalo. Rango 0 –
                                9999999999.
                        interval_unit:
                          type: string
                          description: Unidad del intervalo de facturación.
                          enum:
                            - DAY
                            - WEEK
                            - MONTH
                            - YEAR
                        interval_count:
                          type: integer
                          description: >-
                            Número de unidades de intervalo entre cobros (por
                            ejemplo, `1` = cada mes cuando `interval_unit` es
                            `MONTH`).
            examples:
              Card Direct:
                value:
                  account_id: dbf0c133-86bc-4be0-94a5-ca2ff6778451
                  country: CO
                  type: CARD
                  workflow: DIRECT
                  card_data:
                    number: '4111111111111111'
                    holder_name: JOHN DOE
                    expiration_month: 12
                    expiration_year: 26
                    security_code: '212'
                    brand: VISA
                  customer_payer:
                    code: '12345'
                    organization_customer_external_id: ext-12345
                  verify:
                    vault_on_success: true
                    currency: COP
              ACH Enrollment:
                value:
                  account_id: dbf0c133-86bc-4be0-94a5-ca2ff6778451
                  country: US
                  type: ACH_ENROLLMENT
                  workflow: DIRECT
                  metadata:
                    - key: on_behalf_of
                      value: acct_1A2b3C4d5E6f7G8h
                    - key: order_ref
                      value: ABC-123
                  customer_payer:
                    code: <customer_code>
                    email: john@example.com
                    ip_address: 203.0.113.5
                    browser_info:
                      user_agent: >-
                        Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0)
                        AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0
                        Safari/537.36
                  payment_method:
                    vault_on_success: true
                    detail:
                      bank_transfer:
                        bank_account: '000123456789'
                        routing_number: '110000000'
                        beneficiary_name: John Doe
                        account_type: CHECKINGS
                        bank_account_mask_number: '****6789'
                        mandate:
                          id: MND-123
                          info: free text mandate info
                          received_status: RECEIVED
                          existing_status: ACTIVE
                          created_at: '2026-07-09T00:00:00Z'
                          updated_at: '2026-07-09T00:00:00Z'
              SEPA mandate import (vault-only):
                value:
                  account_id: dbf0c133-86bc-4be0-94a5-ca2ff6778451
                  country: DE
                  type: SEPA_ENROLLMENT
                  payment_method:
                    vault_only: true
                    detail:
                      bank_transfer:
                        bank_account: DE89370400440532013000
                        bank_account_mask_number: '****3000'
                        beneficiary_name: Max Mustermann
                        account_holder_type: INDIVIDUAL
                        mandate:
                          id: MNDT-2019-000123
                          info: SEPA Core Direct Debit mandate
                          creditor_id: DE98ZZZ09999999999
                          received_status: RECEIVED
                          existing_status: ACTIVE
                          created_at: '2019-05-04T00:00:00Z'
                  customer_payer:
                    first_name: Max
                    last_name: Mustermann
                    email: max@example.com
              Token migration process:
                value:
                  account_id: dbf0c133-86bc-4be0-94a5-ca2ff6778451
                  country: MX
                  type: CARD
                  workflow: DIRECT
                  provider_data:
                    id: DLOCAL
                    token_source: PROVIDER_TOKEN
                    payment_method_token: tok_provider_abc123
                    connection_id: b1a2c3d4-e5f6-7890-abcd-ef1234567890
                  verify:
                    vault_on_success: true
              Card Enrollment With Verification:
                value:
                  account_id: dbf0c133-86bc-4be0-94a5-ca2ff6778451
                  country: US
                  type: CARD
                  workflow: DIRECT
                  card_data:
                    holder_name: John Doe
                    expiration_month: 3
                    expiration_year: 30
                    number: '4111111111111111'
                    security_code: '123'
                  verify:
                    vault_on_success: true
                    currency: USD
                    metadata:
                      - key: order_ref
                        value: ABC-123
              Provider token enrollment:
                summary: Enroll a provider-issued token (PROVIDER_TOKEN flow)
                value:
                  account_id: fe14c7c6-c75e-43b7-bdbe-4c87ad52c482
                  country: CO
                  type: CARD
                  card_data:
                    brand: VISA
                    lfd: '4242'
                  provider_data:
                    id: ADYEN
                    token_source: PROVIDER_TOKEN
                    payment_method_token: tok_provider_xyz
                    connection_id: f00d04b4-584f-4790-b51d-ceede8fd8f0f
      responses:
        '201':
          description: '201'
          content:
            application/json:
              examples:
                ACH Enrollment:
                  value:
                    type: ACH_ENROLLMENT
                    status: READY_TO_ENROLL
                    action: REDIRECT_URL
                    redirect_url: >-
                      https://payments.stripe.com/microdeposit/pacreq_test_placeholder
                    metadata:
                      - key: on_behalf_of
                        value: acct_1A2b3C4d5E6f7G8h
                      - key: order_ref
                        value: ABC-123
                Result:
                  value:
                    idempotency_key: 2ca58c6d-8794-4c8f-a2f6-bba4b7498b74
                    name: VISA ****1111
                    description: VISA ****1111
                    type: CARD
                    category: CARD
                    country: US
                    status: ENROLLED
                    sub_status: null
                    vaulted_token: cbdcc878-ceb4-4dd8-b0f0-49d444855de0
                    callback_url: www.example.com
                    action: null
                    created_at: '2024-06-06T13:32:49.715656Z'
                    updated_at: '2024-06-06T13:32:49.715656Z'
                    card_data:
                      iin: '41111111'
                      lfd: '1111'
                      holder_name: JOHN DOE
                      expiration_month: 3
                      expiration_year: 26
                      number_length: 16
                      security_code_length: 3
                      brand: VISA
                      issuer: JPMORGAN CHASE BANK N A
                      issuer_code: null
                      country_code: US
                      category: CREDIT
                      type: CREDIT
                      fingerprint: 55a7fe38-cdc3-45dc-8c5f-820751799c76
                    last_successfully_used: null
                    last_successfully_used_at: null
                    preferred: null
                    verify:
                      vault_on_success: false
                      payment: null
                    parent_type: null
                    redirect_url: null
                With Verify:
                  value:
                    idempotency_key: 2ca58c6d-8794-4c8f-a2f6-bba4b7498b74
                    name: VISA ****0000
                    description: VISA ****0000
                    type: CARD
                    category: CARD
                    country: US
                    status: ENROLLED
                    sub_status: null
                    vaulted_token: 9c298b36-b005-42ed-92e1-808b2a785e5f
                    callback_url: null
                    action: null
                    created_at: '2023-09-04T16:37:55.314018Z'
                    updated_at: '2023-09-04T16:37:55.314019Z'
                    card_data:
                      iin: '49880800'
                      lfd: '0000'
                      holder_name: JOHN DOE
                      expiration_month: 3
                      expiration_year: 30
                      number_length: 16
                      security_code_length: 3
                      brand: VISA
                      issuer: JPMORGAN CHASE BANK N A
                      issuer_code: null
                      country_code: US
                      category: BUSINESS ENHANCED
                      type: CREDIT
                      fingerprint: 55a7fe38-cdc3-45dc-8c5f-820751799c76
                    last_successfully_used: null
                    last_successfully_used_at: null
                    preferred: null
                    verify:
                      vault_on_success: true
                      currency: USD
                      payment:
                        id: 2ff3872a-9b62-412f-be3e-69689b184e5f
                        account_id: ad59c347-407c-4f11-841b-f3ac260cd018
                        description: VERIFY CARD
                        country: US
                        status: SUCCEEDED
                        sub_status: VERIFIED
                        merchant_order_id: VERIFY_CARD_9c298b36-b005-42ed-92e1-808b2a785e5f
                        created_at: '2023-09-04T16:37:55.352948Z'
                        updated_at: '2023-09-04T16:37:56.429675Z'
                        amount:
                          currency: USD
                          value: 0
                          refunded: 0
                          captured: 0
                        metadata:
                          - key: order_ref
                            value: ABC-123
                        transactions:
                          - id: 1e501f45-583b-4187-b42e-8c3e620d1ef5
                            type: VERIFY
                            status: SUCCEEDED
                            response_code: SUCCEEDED
                            response_message: Transaction successful
                            category: CARD
                            merchant_reference: VERIFY_CARD_9c298b36-b005-42ed-92e1-808b2a785e5f
                            provider_data:
                              id: ADYEN
                              transaction_id: SKCN8ZR5S8NKGK82
                              account_id: ''
                              status: Cancelled
                              sub_status: ''
                              status_detail: ''
                              response_message: ''
                              raw_response:
                                additionalData:
                                  threeds2.cardEnrolled: 'false'
                                merchantReference: >-
                                  VERIFY_CARD_9c298b36-b005-42ed-92e1-808b2a785e5f
                                refusalReason: FRAUD-CANCELLED
                                refusalReasonCode: '22'
                                resultCode: Cancelled
                              third_party_transaction_id: null
                            created_at: '2023-09-04T16:37:55.482510Z'
                            updated_at: '2023-09-04T16:37:56.348742Z'
                    parent_type: null
                    redirect_url: null
              schema:
                oneOf:
                  - type: object
                    properties:
                      idempotency_key:
                        type: string
                        example: 2ca58c6d-8794-4c8f-a2f6-bba4b7498b74
                      name:
                        type: string
                        example: VISA ****1111
                      description:
                        type: string
                        example: VISA ****1111
                      type:
                        type: string
                        example: CARD
                      category:
                        type: string
                        example: CARD
                      country:
                        type: string
                        example: US
                      status:
                        type: string
                        example: ENROLLED
                      sub_status: {}
                      vaulted_token:
                        type: string
                        example: cbdcc878-ceb4-4dd8-b0f0-49d444855de0
                      metadata:
                        type: array
                      callback_url:
                        type: string
                        example: www.example.com
                      action:
                        type: string
                      redirect_url:
                        type: string
                        example: null
                      parent_type:
                        type: string
                        example: CARD
                      created_at:
                        type: string
                        example: '2024-06-06T13:32:49.715656Z'
                      updated_at:
                        type: string
                        example: '2024-06-06T13:32:49.715656Z'
                      card_data:
                        type: object
                        properties:
                          iin:
                            type: string
                            example: '41111111'
                          lfd:
                            type: string
                            example: '1111'
                          holder_name:
                            type: string
                            description: >-
                              Nombre completo del titular de la tarjeta tal como
                              lo devuelve el proveedor de pago.
                            example: JOHN DOE
                          expiration_month:
                            type: integer
                            example: 3
                            default: 0
                          expiration_year:
                            type: integer
                            example: 26
                            default: 0
                          number_length:
                            type: integer
                            example: 16
                            default: 0
                          security_code_length:
                            type: integer
                            example: 3
                            default: 0
                          brand:
                            type: string
                            example: VISA
                          issuer:
                            type: string
                            example: JPMORGAN CHASE BANK N A
                          issuer_code: {}
                          country_code:
                            type: string
                            description: >-
                              Código de país ISO 3166-1 alfa-2 del país emisor
                              de la tarjeta.
                            example: US
                          category:
                            type: string
                            example: CREDIT
                          type:
                            type: string
                            example: CREDIT
                          fingerprint:
                            type: string
                            example: 55a7fe38-cdc3-45dc-8c5f-820751799c76
                      last_successfully_used: {}
                      last_successfully_used_at: {}
                      preferred: {}
                      verify:
                        type: object
                        properties:
                          vault_on_success:
                            type: boolean
                            example: false
                            default: true
                          payment: {}
                      provider_data:
                        type: object
                        description: Datos adicionales del proveedor
                        properties:
                          raw_request:
                            type: object
                            description: >-
                              Copia ofuscada de la solicitud que Yuno envió al
                              proveedor. Solo se devuelve para organizaciones
                              autorizadas.
                          raw_response:
                            type: object
                  - title: Con verificación
                    type: object
                    properties:
                      idempotency_key:
                        type: string
                        example: 2ca58c6d-8794-4c8f-a2f6-bba4b7498b74
                      name:
                        type: string
                        example: VISA ****0000
                      description:
                        type: string
                        example: VISA ****0000
                      type:
                        type: string
                        example: CARD
                      category:
                        type: string
                        example: CARD
                      country:
                        type: string
                        example: US
                      status:
                        type: string
                        example: ENROLLED
                      sub_status: {}
                      vaulted_token:
                        type: string
                        example: 9c298b36-b005-42ed-92e1-808b2a785e5f
                      metadata:
                        type: array
                      callback_url: {}
                      action:
                        type: string
                      redirect_url:
                        type: string
                        example: null
                      created_at:
                        type: string
                        example: '2023-09-04T16:37:55.314018Z'
                      updated_at:
                        type: string
                        example: '2023-09-04T16:37:55.314019Z'
                      card_data:
                        type: object
                        properties:
                          iin:
                            type: string
                            example: '49880800'
                          lfd:
                            type: string
                            example: '0000'
                          holder_name:
                            type: string
                            description: >-
                              Nombre completo del titular de la tarjeta tal como
                              lo devuelve el proveedor de pago.
                            example: JOHN DOE
                          expiration_month:
                            type: integer
                            example: 3
                            default: 0
                          expiration_year:
                            type: integer
                            example: 30
                            default: 0
                          number_length:
                            type: integer
                            example: 16
                            default: 0
                          security_code_length:
                            type: integer
                            example: 3
                            default: 0
                          brand:
                            type: string
                            example: VISA
                          issuer:
                            type: string
                            example: JPMORGAN CHASE BANK N A
                          issuer_code: {}
                          country_code:
                            type: string
                            description: >-
                              Código de país ISO 3166-1 alfa-2 del país emisor
                              de la tarjeta.
                            example: US
                          category:
                            type: string
                            example: BUSINESS ENHANCED
                          type:
                            type: string
                            example: CREDIT
                          fingerprint:
                            type: string
                            example: 55a7fe38-cdc3-45dc-8c5f-820751799c76
                      last_successfully_used: {}
                      last_successfully_used_at: {}
                      preferred: {}
                      verify:
                        type: object
                        properties:
                          vault_on_success:
                            type: boolean
                            example: true
                            default: true
                          currency:
                            type: string
                            example: USD
                          payment:
                            type: object
                            properties:
                              id:
                                type: string
                                example: 2ff3872a-9b62-412f-be3e-69689b184e5f
                              account_id:
                                type: string
                                example: ad59c347-407c-4f11-841b-f3ac260cd018
                              description:
                                type: string
                                example: VERIFY CARD
                              country:
                                type: string
                                example: US
                              status:
                                type: string
                                example: SUCCEEDED
                              sub_status:
                                type: string
                                example: VERIFIED
                              merchant_order_id:
                                type: string
                                example: >-
                                  VERIFY_CARD_9c298b36-b005-42ed-92e1-808b2a785e5f
                              created_at:
                                type: string
                                example: '2023-09-04T16:37:55.352948Z'
                              updated_at:
                                type: string
                                example: '2023-09-04T16:37:56.429675Z'
                              amount:
                                type: object
                                properties:
                                  currency:
                                    type: string
                                    example: USD
                                  value:
                                    type: integer
                                    example: 0
                                    default: 0
                                  refunded:
                                    type: integer
                                    example: 0
                                    default: 0
                                  captured:
                                    type: integer
                                    example: 0
                                    default: 0
                              transactions:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                      example: 1e501f45-583b-4187-b42e-8c3e620d1ef5
                                    type:
                                      type: string
                                      example: VERIFY
                                    status:
                                      type: string
                                      example: SUCCEEDED
                                    response_code:
                                      type: string
                                      example: SUCCEEDED
                                    response_message:
                                      type: string
                                      example: Transaction successful
                                    category:
                                      type: string
                                      example: CARD
                                    merchant_reference:
                                      type: string
                                      example: >-
                                        VERIFY_CARD_9c298b36-b005-42ed-92e1-808b2a785e5f
                                    provider_data:
                                      type: object
                                      properties:
                                        id:
                                          type: string
                                          example: ADYEN
                                        transaction_id:
                                          type: string
                                          example: SKCN8ZR5S8NKGK82
                                        account_id:
                                          type: string
                                          example: ''
                                        status:
                                          type: string
                                          example: Cancelled
                                        sub_status:
                                          type: string
                                          example: ''
                                        status_detail:
                                          type: string
                                          example: ''
                                        response_message:
                                          type: string
                                          example: ''
                                        raw_response:
                                          type: object
                                          properties:
                                            additionalData:
                                              type: object
                                              properties:
                                                threeds2.cardEnrolled:
                                                  type: string
                                                  example: 'false'
                                            merchantReference:
                                              type: string
                                              example: >-
                                                VERIFY_CARD_9c298b36-b005-42ed-92e1-808b2a785e5f
                                            refusalReason:
                                              type: string
                                              example: FRAUD-CANCELLED
                                            refusalReasonCode:
                                              type: string
                                              example: '22'
                                            resultCode:
                                              type: string
                                              example: Cancelled
                                        raw_request:
                                          type: object
                                          description: >-
                                            Copia ofuscada de la solicitud que Yuno
                                            envió al proveedor. Solo se devuelve
                                            para organizaciones autorizadas.
                                        third_party_transaction_id: {}
                                    created_at:
                                      type: string
                                      example: '2023-09-04T16:37:55.482510Z'
                                    updated_at:
                                      type: string
                                      example: '2023-09-04T16:37:56.348742Z'
                              metadata:
                                type: array
                                description: >-
                                  Las etiquetas personalizadas de clave y valor
                                  enviadas en `verify.metadata`, devueltas desde
                                  el pago de verificación interno.
                                items:
                                  type: object
                                  properties:
                                    key:
                                      type: string
                                      example: order_ref
                                    value:
                                      type: string
                                      example: ABC-123
                      provider_data:
                        type: object
                        description: Datos adicionales del proveedor
                        properties:
                          raw_request:
                            type: object
                            description: >-
                              Copia ofuscada de la solicitud que Yuno envió al
                              proveedor. Solo se devuelve para organizaciones
                              autorizadas.
                          raw_response:
                            type: object
                      parent_type:
                        nullable: true
                        description: Tipo principal.
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Bad Request:
                  value:
                    code: INVALID_REQUEST
                    messages:
                      - Invalid request
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_REQUEST
                  messages:
                    type: array
                    items:
                      type: string
                      example: Invalid request
        '401':
          description: '401'
          content:
            application/json:
              examples:
                Unauthorized:
                  value:
                    code: INVALID_CREDENTIALS
                    messages:
                      - Invalid credentials
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_CREDENTIALS
                  messages:
                    type: array
                    items:
                      type: string
                      example: Invalid credentials
        '403':
          description: '403'
          content:
            application/json:
              examples:
                Result:
                  value:
                    code: AUTHORIZATION_REQUIRED
                    messages:
                      - The merchant has no authorization to use this API.
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: AUTHORIZATION_REQUIRED
                  messages:
                    type: array
                    items:
                      type: string
                      example: The merchant has no authorization to use this API.
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      x-default: <Your private-secret-key>
      name: private-secret-key
    sec2:
      type: apiKey
      in: header
      name: X-Idempotency-Key
      x-default: <Your X-Idempotency-Key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.