# Pago 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`](/docs/operaciones/consultar-limites/) lista tus rieles en `rails`. [`GET /v1/status`](/docs/operaciones/consultar-estado/) 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. |

```json
{
  "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](/docs/recetas/pago-spei/), con `currency` en `BRL`: aprobación en el panel, [`POST /v1/payments`](/docs/operaciones/crear-pago/), 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.

## Qué sigue

[Pago LatAm](/docs/recetas/pago-latam/).