Catálogos del API Bancario
API 1.0.0El 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-typesFiltrá 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#
List customer identification person types
GET /api/public/v1/catalogs/customer-identification-types
Host: https://api-baas-sandbox.tilopay.com — requiere Authorization: Bearer <access_token>.
Returns the distinct customer person types (individual, business, both) available for the authenticated tenant, optionally filtered by country. This is a person-type classification, not the payment identification-document catalog (cedula, juridica, dimex, ...) used by identification.type on POST /payments.
Parámetros
| Parámetro | En | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
X-Correlation-Id | header | string | — | Optional client-supplied correlation id for end-to-end tracing.
Echoed back as correlation_id in the response envelope. If omitted,
the API generates one and still returns it. |
country_code | query | string | — | Optional ISO-2 country code used to filter results. A legacy country query
parameter is also accepted as an alias when country_code is omitted; prefer
country_code. |
Respuesta 200
The request was processed successfully.
response_code: OK
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
items | array<object> | sí | — |
items[].code | string | sí | — |
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. |
| 429 | TOO_MANY_REQUESTS | Too many requests. Please retry after a short delay. |
| 500 | INTERNAL_ERROR | An unexpected error occurred. Please try again later. |
| 502 | — | Dependency error |
| 503 | SERVICE_UNAVAILABLE | A required service is temporarily unavailable. Please try again later. |
Última verificación: 2026-09-02 · Responsable: equipo-integraciones