> ## 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.

# Obtener emisores

> Obtiene la lista de emisores compatibles con un método de pago específico.

Este endpoint obtiene una lista de todos los emisores compatibles con el método de pago específico. Te permite filtrar los emisores según su compatibilidad con un método de pago en particular.

La API responde 201 para cada `payment_method` excepto `PSE`, que responde 200. Por ejemplo, `country_code=CO&payment_method=NEQUI` responde 201 y `country_code=CO&payment_method=PSE` responde 200.


## OpenAPI

````yaml openapi/es/payments/retrieve-issuers.json GET /issuers
openapi: 3.1.0
info:
  title: checkout-api
  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: []
paths:
  /issuers:
    get:
      summary: Obtener emisores
      description: >-
        Devuelve los emisores (bancos) disponibles para un método de pago. La
        API responde 201 para todos los métodos de pago excepto PSE, que
        responde 200.
      operationId: retrieve-issuers
      parameters:
        - name: checkout_session
          in: query
          description: El identificador de la sesión de checkout (UUID, 36 caracteres).
          schema:
            type: string
            example: 9f1c2b7e-5a3d-4e8b-9c6a-1d2e3f4a5b6c
        - name: country_code
          in: query
          description: Código de país ([ISO 3166-1](/es/reference/country-reference)).
          schema:
            type: string
            example: CO
        - name: payment_method
          in: query
          description: >-
            Define el método de pago usado para filtrar los emisores. Este
            parámetro garantiza que la respuesta incluya solo los emisores que
            admiten el método de pago indicado. Ejemplos: `NEQUI` (responde
            201), `PSE` (responde 200).
          schema:
            type: string
            example: NEQUI
      responses:
        '200':
          description: >-
            Se devuelve solo cuando `payment_method` es `PSE`. El cuerpo tiene
            la misma estructura que la respuesta 201.
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuers:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: '1007'
                        name:
                          type: string
                          example: BANCOLOMBIA
        '201':
          description: Se devuelve para todos los `payment_method` excepto `PSE`.
          content:
            application/json:
              examples:
                Result:
                  value:
                    issuers:
                      - id: '1001'
                        name: BANCO DE BOGOTÁ
                      - id: '1002'
                        name: BANCO POPULAR
                      - id: '1005'
                        name: BANCO UNIÓN COLOMBIANO FD2
                      - id: '1006'
                        name: ITAÚ
                      - id: '1007'
                        name: BANCOLOMBIA
                      - id: '1009'
                        name: CITIBANK
                      - id: '1012'
                        name: BANCO GNB SUDAMERIS
                      - id: '1013'
                        name: BBVA COLOMBIA S.A.
                      - id: '1019'
                        name: SCOTIABANK COLPATRIA DESARROLLO
                      - id: '1022'
                        name: BANCO UNIÓN COLOMBIANO
                      - id: '1023'
                        name: BANCO DE OCCIDENTE
                      - id: '1032'
                        name: BANCO CAJA SOCIAL DESARROLLO
                      - id: '1040'
                        name: BANCO AGRARIO
                      - id: '1051'
                        name: BANCO DAVIVIENDA
                      - id: '1052'
                        name: BANCO COMERCIAL AV VILLAS S.A.
                      - id: '1059'
                        name: BANCAMÍA
                      - id: '1060'
                        name: BANCO PICHINCHA S.A.
                      - id: '1061'
                        name: BANCO COOMEVA S.A.
                      - id: '1062'
                        name: BANCO FALABELLA
                      - id: '1063'
                        name: BANCO FINANDINA S.A. BIC
                      - id: '1065'
                        name: BANCO SANTANDER COLOMBIA
                      - id: '1066'
                        name: BANCO COOPERATIVO COOPCENTRAL
                      - id: '1069'
                        name: BANCO SERFINANZA
                      - id: '1070'
                        name: LULO BANK
                      - id: '1078'
                        name: SCOTIABANK COLPATRIA UAT
                      - id: '1097'
                        name: DALE
                      - id: '1283'
                        name: COOPERATIVA FINANCIERA DE ANTIOQUIA CFA
                      - id: '1289'
                        name: COOPERATIVA FINANCIERA COTRAFA
                      - id: '1291'
                        name: COOFINEP COOPERATIVA FINANCIERA
                      - id: '1292'
                        name: CONFIAR COOPERATIVA FINANCIERA
                      - id: '1370'
                        name: COLTEFINANCIERA
                      - id: '1637'
                        name: IRIS
                      - id: '1801'
                        name: MOVII S.A.
                      - id: '1802'
                        name: DING TECNIPAGOS S.A.
                      - id: '1803'
                        name: POWWI
                      - id: '1804'
                        name: UALÁ
                      - id: '1808'
                        name: BOLD CF
                      - id: '1809'
                        name: NU
                      - id: '1811'
                        name: RAPPIPAY
                      - id: '1812'
                        name: COINK S.A.
              schema:
                type: object
                properties:
                  issuers:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: '1001'
                        name:
                          type: string
                          example: BANCO DE BOGOTÁ
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Invalid Request:
                  value:
                    code: INVALID_REQUEST
                    messages:
                      - Invalid request
                  summary: Invalid Request
              schema:
                type: object
                properties: {}
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>

````

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