API Status Codes

<initialize-payment> Codes

The following table provides information about the codes that you can receive after you initialize a payment.

CodeDescription
1Client ID / Account does not match.
2Invalid client ID
3Unknown client ID
4Client disabled
11Undefined account
12Invalid account
13Unknown account
14Account disabled
53Amount is more than pending amount.
400Wrong operation: initialize.
401Authentication Failed.
415Invalid XML Document.
1002Internal database error - Unable to create a new Transaction.
Contact [email protected]
1003Internal database error - Unable to insert new message for Transaction.
Contact [email protected]
1004Internal database error - Unable to update Transaction.
Contact [email protected]
4021Payment failed: You have exceeded the maximum number of attempts.
4039Payment session is already completed.

<authorize-payment> Codes

The following table describes the codes you can receive after you request to authorize a payment.

CodeDescription
1Undefined client ID
2Invalid client ID
3Unknown client ID
4Client disabled.
11Undefined account.
12Invalid account.
13Unknown account.
14Account disabled.
24The selected payment card is not available.
26Undefined password.
27Password is too short; min length is 6 characters.
28Password is too long; max length is 50 characters.
29Password contains invalid characters or
31Authentication failed.
32Authentication failed – Next invalid attempt will delete the account.
33Authentication failed – Account deleted.
34Authentication rejected by the single sign-on server.
35User account not found.
36A timeout occurred while communicating with the single sign-on server.
37Mobile number not verified.
38Unable to perform single sign-on due to invalid Security Token or Authentication URL.
39User account disabled.
41Undefined card ID.
42ID for the stored card is too small, min value is 1.
43Stored card not found.
43Insufficient balance on voucher.
44Stored card disabled.
45Voucher and Redeem device-ids not equal.
48Voucher payment temporarily locked.
51Insufficient balance on e-money account.
52Amount is more than pending amount.
53Amount is more than pending amount.
59Authorization type not supported for the transaction.
79An unknown error occurred while retrieving payment data from third-party wallet. Card has been blocked.
90The connection timed out while authorizing the payment with the PSP.
92Authorization rejected by PSP / Acquirer.
99Unknown PSP / Acquirer.
100Payment authorized using a stored card/Invoice.
101Payment authorized using e-money account.
102Payment authorized using loyalty account.
103Authorization already in progress.
400Wrong operation: authorization.
401Authentication Failed.
404Transaction with ID:<Transaction ID>.
415Invalid XML Document.
1002Internal database error - Unable to create a new Transaction.
Contact [email protected].
1003Internal database error - Unable to insert new message for Transaction.
Contact [email protected].
1004Internal database error - Unable to update Transaction.
Contact [email protected].
2000Payment authorized.
2009Payment authorized and card stored.
2010Authorization Declined or Rejected

<capture> Codes

The following table provides information about the codes that you can receive after you send a Capture request.

CodeDescription
1Client ID / Account does not match.
400Invalid request
401Authorization failed.
415Invalid XML Document.
500Internal Error.
997Capture not supported.
998Network error.
999Declined.
1000Transaction captured successfully.

<refund> Codes

The following table describes the codes you can receive after you send a Refund request.

CodeDescription
1000Transaction refunded successfully.
1001Transaction cancelled successfully.
1100Refund Initiated.
9400Invalid request.
9502Bad gateway.
9500Internal sever error.

Other Codes

CodeCategoryTypeDescription
1001PaymentPayment Initialized with VelocityThe payment transaction is created in the Velocity database.
1009PaymentPayment Initialized with PSPThe payment processor responsible for authorizing the payment has been initialized.
1991CallbackMerchant Callback ConstructedThe callback to the merchant application sent to callback-url has been constructed.
1992CallbackCallback ConnectedThe connection with the merchant callback URL is established.
1993CallbackCallback Connection FailedThe connection with the merchant callback URL failed.
1990CallbackCallback AcceptedThe merchant system returned an HTTP 200 OK and received the callback.
1995CallbackCallback RejectedThe merchant system returned an HTTP $XX/5XX Error and rejected the callback.
2000PaymentAuthorizedThe payment has been authorized successfully by the PSP.
2002PaymentCancelledThe authorized payment has been cancelled successfully by the PSP.
2003PaymentRefundedThe captured payment refunded successfully (full / partial) by the PSP. The manual operation / delayed refund - pending states, initiated.
2008PaymentPayment via StoredInitialized payment with a stored card.
2009PaymentAuthorized and Card StoredThe payment has been authorized successfully by the PSP and the card stored on a successful authorization.
2001PaymentCapturedThe payment has been captured successfully by the PSP initiated for refund.
2010PaymentRejectedThe payment was rejected by the PSP or Acquirer need more granular states - message tbl front end can continue handling the generic state.
20109PaymentRejected sub state on timeoutIssuer down time; SDK returns this to the Velocity core.
20108PaymentRejected sub state on timeoutPSP down time; SDK returns this to the Velocity core.
2011PaymentDeclinedThe payment was declined by the PSP / Acquirer while performing capture, refund, or cancel.

No Vision impact; however, all declines have common state 2011.
4020SessionSession FailedThe session failed or declined. One or more transactions in the session failed.
4021SessionSession FailedThe session failed (maximum attempt exceeds). One or more transaction attempts failed.
4030SessionSession CompleteThe session completed successfully. The transactions in the session are complete and successful.
4031SessionSession PartialThe session was partially completed. One or more transactions in the session were incomplete.

Additional codes:

CodeDescription
0Payment not made.
200Request validated and accepted by back end.
400Request rejected by back end because of validation error.
401Authentication required.
403Access denied.
415Message transmitted in an unknown format or by using an unsupported content type.
500Velocity server error.
502PSP returned an unknown error.
504A timeout occurred while communicating with the PSP.
1003Card expired.
1005Invalid card number.
1011Invalid card name.
1012Invalid card address.
1013Invalid card date of birth.
1014Card is inactive.
2007Payment processed.
2019Payment duplicated.
2084Card not found.
4030Payment success.
40031Partial payment success.