Routes: POST /v1/pix/withdraw/pix-key, POST /v1/pix/withdraw/manual, GET /v1/pix/withdraw/{externalId}
BAD_REQUEST (400)
| Error code | Description |
|---|
InvalidContentType | POST body must be sent as application/json. |
MalformedRequest | Withdraw payload failed validation (amount, externalId, Pix key, or manual account fields). |
InvalidJSON | Withdraw request body could not be parsed. |
InvalidParameter | externalId on GET is not a valid UUID. |
NOT_FOUND (404)
| Error code | Description |
|---|
NotFound | No withdrawal exists for the given externalId. |
PIX_KEY_NOT_FOUND | Pix key withdraw only — key not found in DICT. |
UNPROCESSABLE_ENTITY (422)
| Error code | Description |
|---|
IGAMING_CPF_MISMATCH | Pix key CPF does not match account holder. |
SECURE_LOOP_ACCOUNT_MISMATCH | Secure Loop rules rejected the withdraw. |
See also Common errors and Status Machine — Pix Out.