---
title: "Enroll Payment Method"
method: POST
path: "/customers/sessions/{customer_session}/payment-methods"
---

# Enroll Payment Method

`POST /customers/sessions/{customer_session}/payment-methods`

## Path parameters

- `customer_session` string, required

## Request body

- object
  - `account_id` string, required — The unique identifier of the account. You find this information on [the Yuno dashboard](https://dashboard.y.uno/) (UUID, 36 chars).
  - `payment_method_type` 'CARD' | 'MERCADO_PAGO_WALLET' | 'NEQUI' | 'BANCOLOMBIA_TOKENBOX' | 'NU_PAY_ENROLLMENT', required — The payment method type (MAX 255; MIN 3; [Payment Type List](/reference/payment-type-list)).
  - `country` 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'CR' | 'EC' | 'SV' | 'GT' | 'HN' | 'MX' | 'NI' | 'PA' | 'PY' | 'PE' | 'US' | 'UY', required — The transaction's country code (MAX 2; MIN 2; [ISO 3166-1](/reference/country-reference)).
  - `account_updater` boolean — Per-card control for Card Account Updater. When set to `false`, this card is excluded from Card Account Updater and will not receive automatic card-detail updates. When omitted, the card follows your account's Account Updater configuration. Applies at enrollment.
  - `verify` object — Indicates whether to verify the payment with a verify transaction or not. You’ll need to have a provider defined in your CARD route. False by default. Access the [Card Verification](/docs/card-verification) page for more details.
    - `vault_on_success` boolean, required — Indicates whether to verify the payment with a verify transaction or not. You’ll need to have a provider defined in your CARD route. False by default.
    - `currency` string — Currency of the card verification. For a full list of currency codes, see [Country reference](/reference/country-reference) (MAX 3; MIN 3; ISO 4217).

## Response `201`

201

- union
  - object
    - `id` string
    - `account_id` string
    - `name` string
    - `description` string
    - `type` string
    - `category` string
    - `country` string
    - `status` string
    - `created_at` string
    - `updated_at` string
    - `enrollment` object
      - `session` string
      - `sdk_required_action` boolean
    - `provider` object
      - `id` string
      - `type` string
      - `provider_status` unknown
    - `customer_payer` object
      - `first_name` string
      - `last_name` string
      - `email` string
      - `gender` string
      - `date_of_birth` string
      - `document` object
        - `document_number` string
        - `document_type` string
      - `phone` object
        - `number` string
        - `country_code` string
      - `billing_address` object
        - `address_line_1` string
        - `address_line_2` string
        - `country` string
        - `state` string
        - `city` string
        - `zip_code` string
    - `verify` object
      - `vault_on_success` boolean
      - `payment` unknown
    - `preferred` unknown
  - object
    - `id` string
    - `account_id` string
    - `name` string
    - `description` string
    - `type` string
    - `category` string
    - `country` string
    - `status` string
    - `created_at` string
    - `updated_at` string
    - `enrollment` object
      - `session` string
      - `sdk_required_action` boolean
    - `provider` object
      - `id` string
      - `type` string
      - `provider_status` unknown
    - `customer_payer` object
      - `first_name` string
      - `last_name` string
      - `email` string
      - `gender` string
      - `date_of_birth` string
      - `document` object
        - `document_number` string
        - `document_type` string
      - `phone` object
        - `number` string
        - `country_code` string
      - `billing_address` object
        - `address_line_1` string
        - `address_line_2` string
        - `country` string
        - `state` string
        - `city` string
        - `zip_code` string
    - `verify` object
      - `vault_on_success` boolean
      - `currency` string
      - `payment` unknown
    - `preferred` unknown

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/versions/05b629819b49/schema)