PAB Error Codes

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

AttributeMandatoryDescription
typeTrueThe error type: FATAL, VALIDATION_FIELD, or VALIDATION_GLOBAL
errorCodeTrueThe technical error code
messageTrueA human-readable message explaining the error
formObjectNameFalseThe object within the response that triggered the error
fieldFalseThe specific field that caused the error

Error Codes by Type

FATAL

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

Error CodeMessage
ACCESS_DENIEDInvalid Authorization
BLACKLISTEDBlocked
BAD_ACCOUNT_NUMBERInvalid Account Number
DUPLICATED_TRANSACTION_IDDuplicate trace id submitted
INSUFFICIENT_FUNDSInsufficient Funds in Merchant E-wallet
TRANSACTION_AMOUNT_LIMIT_ERRORTransaction amount outside permitted limits
OTHEROther
VALIDATION_FIELD

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

Error CodeMessage
VALIDATIONValidation error under Field Attribute
VALIDATION_GLOBAL

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

Error CodeMessage
DAILY_VELOCITY_EXCEEDEDDaily velocity exceeded
WEEKLY_VELOCITY_EXCEEDEDWeekly velocity exceeded
MONTHLY_VELOCITY_EXCEEDEDMonthly velocity exceeded
OPERATION_NOT_POSSIBLEVelocities: Zero amount