Errors

Plutu provides a list of error codes and messages for troubleshooting payment integration issues.

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
indicates that the request has succeeded, and everything works as expected.
400 - Bad Request
indicates that the server cannot or will not process the request.
401 - Unauthorized
indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource. An invalid access token/API key was provided.
403 - Forbidden
indicates that the server understands the request but refuses to authorize it. 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
indicates the user has sent too many requests in a given amount of time.
500, 502, 503, 504 - Server Errors
Something went wrong on Plutu's end. (These are rare).
REVIEWING ERRORS
To monitor your integration and review errors, Plutu logs every API request your integration makes, whether it was successful or failed. You can access the logs section of the Dashboard under Gateways to review these errors.
General Errors
General errors are a type of error that can occur when using a payment gateway integration. They are not specific to any particular endpoint or gateway and can be caused by a variety of issues such as incorrect input data, network connectivity problems, or errors with the integration itself. It's important to review these errors and understand their root cause in order to address them and ensure the smooth functioning of your payment gateway integration.
Error Code
MAINTENANCE_MODE
Description
Plutu maintenance mode is enabled
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: 50000 per transaction. 
For sandbox: maximum 500 per transaction
Error Code
CURRENCY_NOT_SUPPORTED
Description
Currency is not supported
Error Code
SANDBOX_TRANSACTION_LIMIT_EXCEEDED
Description
Reaching the maximum number of transactions allowed during the period specified in the sandbox environment
Sadad Errors
The following errors, as well as General Errors, can be returned.
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
ALLOWED_ATTEMPTS_EXCEEDED
Description
You have exceeded the number of allowed transaction attempts
Error Code
INVALID_CREDENTIALS
Description
Invalid Sadad credentials
Error Code
UNKNOWN
Description
Unknown error, related to the service provider
Error Code
​
Description
​
Adfali Errors
The following errors, as well as General Errors, can be returned.
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
Error Code
INVALID_CREDENTIALS
Description
Invalid Adfali credentials
Local Bank Cards 
There are no errors for Local Bank Cards, Only the General Errors can be returned
Lightbox Errors
On the checkout page (Lightbox), service providers may return error messages that are not specific to Plutu API. Here is an explanation for those error messages.
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
MPGS Errors
The following errors, as well as General Errors, can be returned.
Error Message
CURRENCY_NOT_SUPPORTED
Description
Transaction currency is not supported by the merchant account. 
You need to check your MPGS account that supports the selected currency
Error Message
INACTIVE_API
Description
MPGS account is not enabled for purchase. You need to contact your service provider to enable the 'PURCHASE' operation
​

Status	Description
200 - OK	indicates that the request has succeeded, and everything works as expected.
400 - Bad Request	indicates that the server cannot or will not process the request.
401 - Unauthorized	indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource. An invalid access token/API key was provided.
403 - Forbidden	indicates that the server understands the request but refuses to authorize it. 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	indicates the user has sent too many requests in a given amount of time.
500, 502, 503, 504 - Server Errors	Something went wrong on Plutu's end. (These are rare).

MPGS

Next - API Documentation

Testing

Last modified 3d ago