DengiOnline

2018-04-26 03:00:20

List of response codes and their descriptions

This action returns the list of all response codes with their indexes and descriptions.

Whether it is possible to use the same transaction ID (txn_id) for the request in the PAY or PAY_STATUS actions depends on the status: 

  • y – fatal status – the payment won't be processed (if it has not been processed yet). You shouldn't use the same transaction ID (txn_id) or invoice for requests.
  • n – non fatal status – can be changed in case of a subsequent request. 

Response codes

Index Code Description fatal Ways to solve the problem

1

OK

Success

y No additional actions needed

2

IN_PROGRESS

Request is being processed

n Repeat pay_status request until receive the final status. Recommended frequencyevery 10 minutes

3

POSTPONED

Operation is postponed to be completed later

n Repeat pay_status request until receive the final status. Recommended frequencyevery 10 minutes

4

MANUAL_VERIFICATION

Operation is postponed to be checked manually

n Repeat pay_status request until receive the final status. Recommended frequencyevery hour

6

PAYMENT_ERROR

Payment processing error

y Repeat sending the invoice with old parameters, but with a new txn_id. The old txn_id cannot be used.
11 BAD_XML Invalid XML y Check the XML specification and correct the error

12

BAD_REQUEST

Invalid request — mandatory nodes are missing

y Check the information from General request and response structure and correct the error
13 AUTH_FAILED Invalid authorization data y Check the authorization data in the request: project number and digital signature

14

NO_PROJECT

Invalid project ID

y Correct the value of parameter <project>

15

NOT_ALLOWED

Unavailable action

y Check request parameters and project activity

16

NOT_ENOUGH_MONEY

Not enough funds

n

To replenish the balance in any way:

  • Refer to the accounts department of your licensor;
  • send a piece of funds through a Bank to your balance;
  • send the request from Merchnt's Account for the finance clearing

17

BAD_ACTION

Invalid action

y Check the information from General request and response structure and correct the value of parameter <action>

18

BAD_PAYSYSTEM

Invalid payment provider ID

y
  • Check the list of available services thru the commissions_action;
  • Don't use the current service id (if it is possible);
  • Refer to your account-manager to activate the service.

19

BAD_ACCOUNT

params\account node failed validation

y

Correct the value of parameter <account>

20

BAD_PARAM

One of the additional params nodes failed validation

y Correct the error in the set of passed parameters

21

BAD_CURRENCY

Invalid currency ID

y

Correct the value of parameter <currency>

22

BAD_INVOICE

Invalid invoice ID

y Correct the value of parameter <invoice>

23

PS_ERROR

Payment Service Provider error

n Repeat sending the invoice after a while

24

DUPLICATE_PAYMENT

Duplicate invoice payment

y Check the value of the invoice: fix it or create new. Don't use the same txn_id in the next pay request

25

DUPLICATE_TXN

Duplicate transaction ID

y

Don't use the existing values of txn_id

26

BAD_AMOUNT

Invalid amount

y

Correct the value of parameter <amount>:

  • it can not be less or equal to 0;
  • the value must be a number

27

AMOUNT_TOO_SMALL

Payment amount is below minimum

y

Check the minimum amount allowed by paysystem (parameter <min_amount> in commissions action and correct the amount of invoice

28

AMOUNT_TOO_BIG

Payment amount is above maximum

y

Check the maximum amount allowed by paysystem (parameter <max_amount> in commissions action) and correct the amount of invoice 

29

BAD_TXN_ID

Invalid transaction ID in the external system

y

Correct the value of parameter <txn_id>

30

EMPTY_SIGNATURE

Digital signature is missing

y

Add to the xmlthe digital signature in the parameter <sign>. See Algorithm for getting the request signing key

31

WRONG_SIGNATURE

Invalid digital signature

y

Correct the error of signature generation. See Algorithm for getting the request signing key  

32

EMPTY_REQUEST

Empty request

y

Correct the code generating xml or json document

34

BAD_EXT_AUTH

Invalid recipient signature

y Refer to the tech support of your licensor

35

DISABLE_BALANCE_TRANSFER

Transfers between main accounts are forbidden for the project

y Refer to the tech support of your licensor

36

CURRENCY_NOT_ALLOWED

The currency is forbidden for the request

y Check the value of parameter <currency>
37 SANCTION_BLOCKED The recipient is on the sanctions list y No additional actions needed
96 REFUND Payment was refunded y No additional actions needed

97

WRONG_EXPIRATION_DATE

Invalid card expiration date

y

Send the correct data

98

WRONG_CARDHOLDER_NAME

Invalid card holder name

y Send the correct cardholder's data

99

CANCELED

Payment canceled

y Create a new invoice

100

PS_CHECK_FAILED

Check failed on the Payment Service Provider side

y Check the payment parameters. If parameters are correct, call to support.

101

BAD_NUMBER_RANGE

Phone number doesn’t belong to the specified Payment Service Provider

y Check the telephone number or service number

102

BAD_CARD_NUMBER

Invalid card number

y Correct the card number (PAN). 

103

BAD_LIMITS

Recipient wallet limit exceeded

y

Use another wallet for the payouts

104

WM_WALLET_NOT_FOUND

WebMoney wallet is not found

y

Check the wallet number

108

INVALID_EMAIL

Invalid e-mail

y Check the email address

109

INVALID_PHONE

Invalid phone number

y

Use the actual telephone number for the payout

200

PS_PAY_FAILED

Payment failed

n

Repeat the payout after a while

201 PAYMENT_NOT_ALLOWED Payments to this account are forbidden y Refer to the tech support of your licensor

202

ACCOUNT_BLOCKED

Recipient account is blocked

y Ask recipient to refer to service support for unblock the account. Then - repeat the payout whit the new txn_id

203

LIMITS_EXCEEDED

Payment is denied by fraud monitoring system

y

Use another recipient's account or card for the payout

204

PS_NOT_CONFIGURED

Service is not configured properly

y Refer to the department of integration to configure service settings. Then - repeat the payout whit the new txn_id

205

UNAVAILABLE_FOR_REGION

The payer's currency is issued outside the region approved from the hub

y

Use another card or another payment method

206 PROJECT_NOT_CONFIGURED Project is not fully configured y Refer to the department of integration to configure service settings. Then - repeat the payout whit the new txn_id

991

INCOMPLETE_PERSONAL_INFO

Personal data are incomplete or incorrect

y

Check the list and the format of recipient's personal data

993

INVOICE_LIFETIME_EXPIRED

Invoice lifetime expired

y Repeat the payout with a new txn_id

994

SECRET_KEY_EXPIRED

Secret key expired

y Request and register the actual value of secret key

995

IP_NOT_WHITELISTED

Access for the current IP denied

y
  • Send PAY_STATUS requests from the same IP as the previous CHECK and PAY requests.

  • Do not change the payment status. Refer to the support of your licensor to enlist the new IP as trusted

996

DEPRECATED_ACTION

Action is deleted

y

Check the documentation: don't use actions which are out of date.

997

PS_UNAVAILABLE

Payment rejected by the payment provider

y Repeat the payout after a while with the new txn_id

999

FORBIDDEN

Access denied

y Send the request to the specified urls from the trusted IP

1000

INTERNAL_ERROR

Internal error

n Repeat the request. Refer to support if the error persists