---
updatedAt: 2026-06-25T14:47:14.000Z
agentTools:
  projectIndex: https://mifinity.readme.io/llms.txt
---

# PAB Error Codes

When the PAB API returns an error, the response body contains a structured error object with the following attributes:

| Attribute               | Mandatory | Description                                                         |
| ----------------------- | --------- | ------------------------------------------------------------------- |
| type                    | True      | The error type: `FATAL`, `VALIDATION_FIELD`, or `VALIDATION_GLOBAL` |
| [errorCode](#errorCode) | True      | The technical error code                                            |
| message                 | True      | A human-readable message explaining the error                       |
| formObjectName          | False     | The object within the response that triggered the error             |
| field                   | False     | The specific field that caused the error                            |

### Error Codes by Type

<Accordion title="FATAL" icon="fa-info-circle">

Fatal errors indicate a request-level failure that prevents processing.

| Error Code                     | Message                                      |
| ------------------------------ | -------------------------------------------- |
| ACCESS_DENIED                  | Invalid Authorization                        |
| BLACKLISTED                    | Blocked                                      |
| BAD_ACCOUNT_NUMBER             | Invalid Account Number                       |
| DUPLICATED_TRANSACTION_ID      | Duplicate trace id submitted                 |
| INSUFFICIENT_FUNDS             | Insufficient Funds in Merchant E-wallet      |
| TRANSACTION_AMOUNT_LIMIT_ERROR | Transaction amount outside permitted limits  |
| OTHER                          | Other                                        |

</Accordion>

<Accordion title="VALIDATION_FIELD" icon="fa-info-circle">

Validation field errors indicate an issue with a specific field in the request. Check the `field` attribute for the affected field name.

| Error Code | Message                                |
| ---------- | -------------------------------------- |
| VALIDATION | Validation error under Field Attribute |

</Accordion>

<Accordion title="VALIDATION_GLOBAL" icon="fa-info-circle">

Validation global errors apply to the request as a whole, typically related to velocity or transaction limits.

| Error Code                | Message                   |
| ------------------------- | ------------------------- |
| DAILY_VELOCITY_EXCEEDED   | Daily velocity  exceeded  |
| WEEKLY_VELOCITY_EXCEEDED  | Weekly velocity exceeded  |
| MONTHLY_VELOCITY_EXCEEDED | Monthly velocity exceeded |
| OPERATION_NOT_POSSIBLE    | Velocities: Zero amount   |

</Accordion>

<br />