APIPago PIX
Pagar por PIX si tu empresa ya lo tiene habilitado.
PIX funciona igual que cualquier pago, pero sólo si tu empresa ya lo tiene activo. Si no, la respuesta es 403 not_enabled.
Comprobar si lo tienes
GET /v1/limits lista tus rieles en rails. GET /v1/status muestra payments_pix como not_enabled si no aplica.
Registrar el beneficiario
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
document | texto | No | Documento del titular. Hasta 20 caracteres. |
holder_name | texto | Sí | Titular de la cuenta destino. Hasta 140 caracteres. |
pix_key | texto | Sí | Llave PIX del titular. Hasta 100 caracteres. |
rail | texto | Sí | Riel de pago. Decide qué campos se piden. pix: PIX, en Brasil. |
{
"rail": "pix",
"holder_name": "PROVEEDOR FICTICIO LTDA",
"pix_key": "llave-pix-de-ejemplo",
"document": "00000000000"
}document es opcional. Si lo envías, se conservan sólo sus dígitos.
El alta no pide activación, el pago sí. Después sigue el mismo flujo de Pago SPEI, con currency en BRL: aprobación en el panel, POST /v1/payments, estado y recibo.
Qué significa not_enabled
La función no está activa para tu empresa. No se reintenta. La activación no se hace por API: consulta con tu ejecutivo FITAL.
Practícalo en el simulador con X-Fital-Scenario: pix_not_enabled.
Errores comunes
- Reintentar en bucle un
not_enabled. - Confundirlo con
rail_unavailable, que es temporal.