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

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