Catálogos del API Bancario

API 1.0.0

El grupo Catalogs publica los valores que tu integración debe usar en los campos de identificación de cliente, en vez de codificarlos a mano.

GET /api/public/v1/catalogs/customer-identification-types

Filtrá por country_code de dos letras para obtener los tipos vigentes en ese país. Consultá el catálogo al iniciar la integración y cacheá el resultado; leelo de nuevo antes de agregar un país nuevo.

Operaciones#

Listar tipos de persona para identificación de clientes

GET /api/public/v1/catalogs/customer-identification-types

Host: https://api-baas-sandbox.tilopay.com — requiere Authorization: Bearer <access_token>.

Devuelve los tipos de persona disponibles (individual, business, both) para el comercio autenticado, opcionalmente filtrados por país. Es una clasificación de tipo de persona, no el catálogo de documentos de identificación de pagos (cedula, juridica, dimex, ...) que usa identification.type en POST /payments.

Parámetros

Parámetro	En	Tipo	Obligatorio	Descripción
`X-Correlation-Id`	header	string	no	Id de correlación opcional que enviás para trazar la solicitud de punta a punta. Se devuelve como `correlation_id` en el sobre de respuesta. Si lo omitís, la API genera uno y igual lo devuelve.
`country_code`	query	string	no	Código de país ISO-2 opcional para filtrar resultados. También se acepta el parámetro histórico `country` como alias cuando `country_code` no se envía; preferí `country_code`.

Respuesta 200

La solicitud se procesó correctamente.

Campo	Tipo	Obligatorio	Descripción
`items`	array<object>	sí	—
`items[].code`	string	sí	—Valores: individual, business, both

Ejemplo de respuesta

{
  "success": true,
  "http_status_code": 200,
  "response_code": "OK",
  "message": "The request was processed successfully.",
  "correlation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "data": {
    "items": [
      {
        "code": "individual"
      },
      {
        "code": "business"
      },
      {
        "code": "both"
      }
    ]
  }
}

Respuestas de error

HTTP	response_code	Descripción
401	`UNAUTHORIZED`	Unauthorized. Verify your session or credentials.
403	`FORBIDDEN`	You do not have permission to perform this action.
500	`INTERNAL_ERROR`	An unexpected error occurred. Please try again later.
502	—	Error de dependencia
503	`SERVICE_UNAVAILABLE`	A required service is temporarily unavailable. Please try again later.

Última verificación: 2026-10-20

Ver como Markdown crudo