Inicio

API de pagos Pix.

Direcciones #

Credenciales #

Solicítelas a su contacto comercial. Usted recibe:

1. el client_id (el nombre corto de su cuenta, como loja01);
2. el client_secret, entregado una sola vez por un canal seguro. Guárdelo en una bóveda: no se vuelve a mostrar;
3. la lista de alcances concedidos.

Con los tres, continúe en Autenticación.

Reglas que valen en toda la API #

• El dinero es una cadena decimal con dos decimales: "150.00". Nunca un número.
• Los instantes son RFC 3339 en UTC: 2026-09-18T12:00:00Z. Las fechas del extracto son el día contable en America/Sao_Paulo.
• Los identificadores de cobro, retiro y subcuenta son suyos: de 26 a 35 caracteres alfanuméricos. El id de la devolución también es suyo, de 1 a 35. Recomendamos ULID.
• El CPF tiene 11 dígitos, sin puntuación. El CNPJ tiene 14 posiciones, sin puntuación: las 12 primeras pueden ser dígitos o letras mayúsculas, y las 2 últimas son dígitos, como 12ABC34501DE35. Guarde el CNPJ como texto, nunca como número.
• Toda respuesta trae x-correlation-id, incluso la de la solicitud de token. Guárdelo para hablar con soporte.
• Su parser debe tolerar campos y valores nuevos.

Para la máquina #

• llms.txt: la lista de estas páginas, una frase cada una.
• La especificación OpenAPI de las rutas /v2/ex/ está disponible en GET /v2/openapi.yaml. Las rutas de cobro, Pix recibido y devolución siguen el estándar del Banco Central y no están en esa especificación.