Errors
Plutu uses HTTP response status codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, etc.). Codes in the 5xx range indicate an error with Plutu's servers (these are rare).
Some 4xx errors that could be handled programmatically (e.g., an invalid gateway) include an error code—a short string with a brief explanation—as a value for code. Below is a list of possible error codes that can be returned.
200
401 -403 -404 -422 -429
500- 502 -503 - 504 - Server Error
Status
Description
200 - OK
Everything worked as expected.
200 - OK
The request was unacceptable, often due to missing a required parameter.
401 - Unauthorized
No valid Access token/API key provided.
403 - Forbidden
The API key doesn't have permission to perform the request.
404 - Not Found
The requested resource doesn't exist.
422 - Un-processable Entity
Invalid fields will result in a 422 Unprocessable Entity response.
429 - Too Many Requests
Too many requests hit the API too quickly.
500, 502, 503, 504 - Server Errors
Something went wrong on Plutu's end. (These are rare.)

REVIEWING ERRORS

Plutu logs every successful or failed API request your integration makes. Use the Gateways logs section of the Dashboard to review errors and monitor your integration.

General Errors

Error Code
Description
UNAUTHORIZED
Invalid access token/API key provided, or your account has not been approved yet
DENIED_ACCESS_GATEWAY
Access denied, you do not have permission to access the payment method
MISSING_PARAMETER
Due to the missing payment gateway configuration
INVALID_INPUTS
Payment fields are incorrectly filled out
BACKEND_ERROR
Plutu Backend error
FORBIDDEN_IP_ADDRESS
The IP address is not whitelisted
TEST_MODE_NOT_SUPPORTED
Test mode is not supported for payment gateway
TOO_MAY_REQUESTS
Too many requests received
INVALID_AMOUNT_FORMAT
Transaction amount format is invalid, format is allowed with a maximum of two decimal places: XXX, XX.X, XX.XX
AMOUNT_NOT_ALLOWED
Amount must be greater than zero
AMOUNT_EXCEEDED_MAXIMUM
Amount exceeded the maximum amount allowed for a transaction: For sandbox: maximum 10000 per transaction

Sadad Errors

Error Code
Description
INVALID_AMOUNT
Invalid amount
INVALID_PROCESS_ID
The process ID is invalid or does not match the value received in the (verify) request (lifetime 10 minutes)
INVALID_MOBILE_NUMBER
Incorrect mobile number
INVALID_MOBILE_NUMBER_OR_BIRTH_YEAR
Incorrect mobile number/year of birth
INVLIAD_OTP
Invalid OTP. please check your code and try again
INVALID_INVOICE_AMOUNT_OR_NUMBER
Invoice number already exists
EMPTY_MOBILE_NUMBER
The mobile number is empty
EMPTY_BIRTH_YEAR
Birth year is empty
OTP_EXPIRED
The OTP has exceeded the time allowed for its use
OTP_WAIT_BEFORE_RESNED
Please wait a while before requesting an OTP resend again
INVALID_MERCHANT_CATEGORY
Merchant category configuration is missing
UNAUTHORIZED_MERCHANT_ACCOUNT
Unauthorized merchant account
NOT_ALLOWED_AMOUNT
Transaction amount is not allowed
INSUFFICIENT_BALANCE
Insufficient balance for the transaction
PHONE_NUMBER_IS_LOCKED
Phone number is locked

Adfali Errors

Error Code
Description
NOT_SUBSCRIBED
The mobile number is not subscribed to Adfali service
INVALID_AMOUNT
Invalid amount
INVALID_PROCESS_ID
The process ID is invalid or does not match the value received in the (verify) request (lifetime 10 minutes)
CONFIRMATION_ERROR
Payment confirmation error, check OTP code
INVALID_MOBILE_NUMBER
Incorrect mobile number
CHECK_BANK_ACCOUNT
There is a problem with your account, please check with your bank account
ADD_PAYMENT_ERROR
payment error, unable to reach server or problem connecting to server
BACKEND_SERVER_ERROR
There is a problem connecting to the bank server, please try again later
AUTH_ERROR
Unable to reach the Adfali server right now

Local Bank Cards Lightbox Errors

There are error messages that are not Plutu API errors that may be returned by the service provider on the checkout page (Lightbox) and here is the explanation for them
Error Message
Description
Order Not Found!
General error but the credentials may be incorrect for use in a production environment
Invalid Domain Request !
The domain URL associated with your account by the bank is incorrect. The URL must be https://api.plutus.ly
Merchant or terminal is currently inactive
Your account has not been activated or has been suspended by the bank or service provider
Copy link
On this page
REVIEWING ERRORS
General Errors
Sadad Errors
Adfali Errors
Local Bank Cards Lightbox Errors