Links

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

Sadad Errors

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

Adfali Errors

Error Code
NOT_SUBSCRIBED
Description
The mobile number is not subscribed to Adfali service
Error Code
INVALID_AMOUNT
Description
Invalid amount
Error Code
INVALID_PROCESS_ID
Description
The process ID is invalid or does not match the value received in the (verify) request (lifetime 10 minutes)
Error Code
CONFIRMATION_ERROR
Description
Payment confirmation error, check OTP code
Error Code
INVALID_MOBILE_NUMBER
Description
Incorrect mobile number
Error Code
CHECK_BANK_ACCOUNT
Description
There is a problem with your account, please check with your bank account
Error Code
ADD_PAYMENT_ERROR
Description
payment error, unable to reach server or problem connecting to server
Error Code
BACKEND_SERVER_ERROR
Description
There is a problem connecting to the bank server, please try again later
Error Code
AUTH_ERROR
Description
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
Order Not Found!
Description
General error but the credentials may be incorrect for use in a production environment
Error Message
Invalid Domain Request !
Description
The domain URL associated with your account by the bank is incorrect. The URL must be https://api.plutus.ly
Error Message
Merchant or terminal is currently inactive
Description
Your account has not been activated or has been suspended by the bank or service provider

T-Lync Errors

There are no errors for T-Lync, Only the General Errors can be returned