Error codes of the Payment service

Error messages format

The error codes listed on this page are returned starting with Payment service version 1.10.1 when accessing the new API context /v2. Learn more about the contexts at API URLs and release notes v.1.10.1
Error code is a string.

The payment service returns both its own errors and bank errors. Information about an error is provided in the errorCode and errorMessage fields.

To determine whether the error belongs to the Payment service or the bank, check the errorCode:

Alphanumeric codes like AA-000 are for Payment service errors.

{
    "errorCode": "VR-209",
    "errorMessage": "amount is a required parameter"
}

Any other values are for bank errors. The Payment service transmits error codes from the bank's payment gateway to the Partner unchanged. The format of these values depends on the specific bank.
```
{
    "errorCode": "8",
    "errorMessage": "Card data is incorrect"
}
```

errorCode=0 indicates that the operation was carried out without technical errors or failures both in the Payment service and in the bank. However, this does not guarantee that the operation in the bank was completed successfully.

In many cases, the bank's processing center returns its own operation execution code. This code is included in the Payment service response as the actionCode parameter. It may indicate that the requested operation was not executed by the bank's processing, even if errorCode=0. The processing center's response codes (actionCode) are listed here.

Payment service Errors

The exact text of the error is not given, as it can be changed without prior notice. Use the error code for troubleshooting, as it is unique for each cause.

Letters in the code indicate the error type.

BD: stored credential errors

HTTP code	Error code	Data type	Description	Possible reasons
400	BD-101	String	`bindingId` not found (in a stored credentials payment or deactivation request).	The request has incorrect `bindingId` or `clientId`. The stored credentials service is temporarily unavailable in the bank where payment data is stored.
200	BD-102	String	The stored credentials list in the response to the `getBindings.do` request may be incomplete because there were errors requesting stored credentials from at least one bank	The stored credentials service is temporarily unavailable in one or several banks
200	BD-103	String	The `bankName` and `paymentSystem` fields in the response to the `getBindings.do` request may be empty or incorrect because the corresponding service did not return card data.	Card data service is temporarily unavailable
200	BD-104	String	Both errors BD-102 and BD-103 occurred while collecting the list of stored credentials, i.e. the list of stored credentials may be incomplete and the fields may be incorrect	The stored credentials service is temporarily unavailable in one or more banks and the card data service is unavailable at the same time
424	BD-105	String	Incorrect `bindingId` format. Please contact support	The stored credential identifier does not indicate the bank affiliation
424	BD-120	String	Unable to deactivate stored credential. Please contact support if the issue persists	When deactivating the stored credential in the bank, the bank did not return confirmation of the successful completion of the operation (timeout, failure, etc.)
424	BD-201	String	SBP subscription with specified bindingId not found (when deactivate SPB subscription)	Incorrect `bindingId` in the request. The subscription service provider is temporarily unavailable at the bank where the subscription is stored.

MD: errors when retrieving order data

HTTP code	Error code	Data type	Description	Possible reasons
200 or 400	MD-101	String	Order not found in the Payment service. HTTP code 200 is returned in the response to the `getOrderStatusExtended.do` request, in other cases - 400	The request specifies an incorrect `orderNumber` or `mdOrder` for the order
424	MD-102	String	Order not found in the bank. The Payment service knows the bank and the order ID in the bank, but when requesting information from the bank, the bank reports that such an order does not exist	Error in the Payment service's data about the order's location
424	MD-103	String	Failed to retrieve order status from the bank	The bank is currently unavailable Error in the Payment service's data about the order's location
400	MD-105	String	When performing an operation with an order (refund, cancellation), the order ID was not provided	The request does not specify either the `orderNumber` or the `mdOrder` for the order
424	MD-202	String	The order already exists in the bank and was not created by the Payment service. Payment through the Payment service is not allowed.	The order was created directly in the bank bypassing the Payment service
424	MD-204	String	Error retrieving order data from the Payment service gateway	Error in the Payment service Issues with accessing the Payment service gateway

PM: payment errors

HTTP code	Error code	Data type	Description	Possible reasons
424	PM-101	String	Unable to determine the payment way (card, stored credentials, seToken, etc.)	Error in the Payment service
400	PM-102	String	Payment is prohibited due to specific payment conditions (amount, card issuer, payment method etc.)	There is a rule in the routing table that denies payment with such parameters
424	PM-110	String	Unable to lock the order before starting payment	Error interacting with the Payment service database
424	PM-111	String	Unable to unlock the order after payment completion	Error interacting with the Payment service database
424	PM-112	String	The order is locked by another operation	Attempt to perform an operation on the order while the order is locked by another operation
424	PM-121	String	Payment to the bank (installment or recurrent) failed	Incorrect order data (e.g., duplicate order number) Processing refusal to process the transaction
424	PM-122	String	Payment to the bank (`instantPayment`) failed	Incorrect order data (e.g., duplicate order number) Processing refusal to process the transaction
424	PM-131	String	Failed to convert the order's original currency to the target currency for the selected bank	Incorrect conversion settings in the Payment service Conversion service temporarily unavailable

RC: errors when interacting with external services

HTTP code	Error code	Data type	Description	Possible reasons
424	RC-101	String	The response from the external service contains an error in the response body, but without the error code of that service	Incorrect request from the Payment service to the external service Error in the service itself
424	RC-201	String	Failed to send request to external service	Network unavailability of the service SSL certificate error
424	RC-202	String	Timeout when calling external service	No response to the request was received within the expected response time
424	RC-203	String	Unexpected response from external service	The response body is not valid JSON
424	RC-211	String	Failed to send request to the bank's payment gateway	Network unavailability of the bank SSL certificate error
424	RC-212	String	Timeout when calling the bank's payment gateway	No response to the request was received within the expected response time
424	RC-213	String	Unexpected response from the bank's payment gateway	The response body is not valid JSON
424	RC-221	String	Failed to send request to the Payment service gateway	Network unavailability of the bank SSL certificate error
424	RC-222	String	Timeout when calling the Payment service gateway	No response to the request was received within the expected response time
424	RC-223	String	Unexpected response from the Payment service gateway	The response body is not valid JSON
424	RC-231	String	Failed to send request to the bank's payment gateway	Network unavailability of the bank SSL certificate error
424	RC-232	String	Timeout when calling the bank's payment gateway	No response to the request was received within the expected response time
424	RC-233	String	Unexpected response from the bank's payment gateway	The response body is not valid JSON

RI: errors when using the bank's payment gateway

HTTP code	Error code	Data type	Description	Possible reasons
424	RI-151	String	Failed to get access token	Network unavailability of the bank Incorrect Partner settings in the Payment service
424	RI-152	String	Error preparing payment cryptogram	Incorrect Partner settings in the Payment service Required encryption key missing
424	RI-201	String	Finish redirect URL is not received from the bank	Incorrect payment request data from the Payment service to the bank Network unavailability of the bank
424	RI-202	String	External order ref number is absent in the Payment service	When attempting to pay for the order, the bank rejected the request as invalid and did not create the order on its side.

RO: routing errors

HTTP code	Error code	Data type	Description	Possible reasons
424	RO-101	String	Unable to route authentication request: all configured gateways are currently deactivated	The Payment service has temporarily deactivated all banks available to the Partner (due to network unavailability, exceeding the error threshold, etc.)
424	RO-102	String	Unable to select target gateway for the payment based on current routing rules	Incorrect routing settings
400	RO-201	String	API-method you are calling assumes that order was already routed to a bank, but it is not	Trying to perform refund or reverse for an order that is not routed to any bank
424	RO-202	String	Unable to place order in exclusive target bank	Payment service has temporarily deactivated all banks available to the partner (due to network unavailability, exceeding the error threshold, etc.) Only one bank is available for payment (with no alternatives), and the order registration process ended up with an error in that bank

RT: internal runtime errors

Errors with the RT-xxx code are internal system errors of the Payment service (caught exceptions). A complete list is not provided.

Text of all RT-xxx errors: System error. Please contact support if the issue persists
The cause of such errors is usually technical, such as incorrect configuration, missing configuration data, database errors, etc.

ST: configuration errors

HTTP code	Error code	Data type	Description	Possible reasons
424	ST-101	String	Error retrieving Payment service settings	Configuration error of the Payment service itself
424	ST-201	String	Partner is not registered in the Payment service	Configuration error of the Partner in the Payment service
424	ST-203	String	Necessary parameters are missing in the Partner's settings	Configuration error of the Partner in the Payment service
424	ST-212	String	Necessary parameters are missing for the BNPL module	Configuration error of the Payment service itself
424	ST-301	String	Error retrieving bank settings	Configuration error of the bank in the Payment service
424	ST-401	String	Necessary parameters are missing in the Partner's settings	Configuration error of the Partner in the Payment service

VP: Vendor Pays errors

HTTP code	Error code	Data type	Description	Possible reasons
424	VP-201	String	Unable to route order to T-pay capable bank	bank services are unavailable
424	VP-202	String	Unable to receive QR-code from T-pay capable bank	bank services are unavailable
424	VP-203	String	Unable to reject Tpay QR-code	bank services are unavailable
424	VP-211	String	Unable to route order to Yandex bank	bank services are unavailable
424	VP-212	String	Unable to receive payment link from Yandex bank	bank services are unavailable
400	VP-251	String	QR code (for payment via the SBP) has not yet been registered	Attempt to call the status or cancel the SBP QR code before it has been registered
424	VP-301	String	MirPay error - link was not received from the bank	bank services unavailable Partner configuration error in bank

VR: incoming request validation errors

HTTP code	Error code	Data type	Description	Possible reasons
400	VR-101	String	Authentication error - invalid login or password	Invalid login or password
400	VR-102	String	Invalid JSON in request body	Invalid JSON in request body
400	VR-110	String	An order with this number has already been registered	Attempt to re-register an order with the same orderNumber
400	VR-201	String	The registration specifies a payment method that is not supported by the Payment service	Incorrect specification of allowed payment methods
400	VR-202	String	An initiating recurrent payment (with `tii=RI`) must have additional parameters `recurringFrequency` and `recurringExpiry`	Missing required request parameters
400	VR-203	String	An initiating recurrent payment (with `tii=RI`) must have a non-empty `clientId`	Missing required request parameters
400	VR-204	String	An initiating installment (with `tii=II`) must have additional parameters `installments`, `recurringFrequency` and `recurringExpiry`	Missing required request parameters
400	VR-205	String	An initiating installment (with `tii=II`) must have a non-empty `clientId`	Missing required request parameters
400	VR-206	String	Both `recurringFrequency` and `recurringExpiry` parameters are required in the request	Missing required request parameters
400	VR-207	String	An initiating recurrent payment or installment must have a non-empty `clientId` (for cases when tii was not explicitly passed)	Missing required request parameters
400	VR-208	String	When using the `feature VERIFY`, a `clientId` must be specified	Missing required request parameters
400	VR-209	String	{field name} is required	Missing required request parameters
400	VR-210	String	Formal validation errors of request parameters	Invalid value of passed parameters Incorrect type/format of passed parameters
400	VR-211	String	When using a dedicated Partner's login for binding cards, a `clientId` must be specified	Missing required request parameters
400	VR-212	String	When using the `FORCE_CREATE_BINDING` feature, a `clientId` must be specified	Missing required request parameters
400	VR-215	String	The request specifies a currency that is not available to the Partner in any bank	Error when specifying the currency Partner configuration error
400	VR-221	String	At the time of request execution, the order's lifetime has already expired; operations on the order are not allowed	Long period between order registration and payment Too short order lifetime was specified during registration
400	VR-222	String	The order was explicitly canceled; operations on the order are not allowed	Attempt to perform an operation on an order with status `DECLINED`
400	VR-223	String	The order has already been processed. Repeated payment requests for this order are not accepted	Attempt to pay for an already paid order again
400	VR-230	String	Incorrect data in `orderBundle.orderCreationDate`	Bad datetime format or date is further than current date
400	VR-231	String	Incorrect data in `orderBundle.customerDetails`	One or more fields in `customerDetails` is missing or malformed
400	VR-232	String	Incorrect data in `orderBundle.customerDetails.deliveryInfo`	One or more fields in `customerDetails.deliveryInfo` is missing or malformed
400	VR-233	String	Incorrect data in `orderBundle.cartItems.items`	One or more fields in `orderBundle.cartItems.items` is missing or malformed
400	VR-234	String	`itemAmount` shall be equal to `itemPrice` multiplied by `quantity`	`itemAmount` differs from `itemPrice` x `quantity`
400	VR-235	String	Order amount shall be equal to bundle amount	Calculated bundle amount differs from order amount
400	VR-236	String	Incorrect data in `orderBundle.cartItems.items.itemAttributes`	One or more fields in `orderBundle.cartItems.items.itemAttributes` is missing or malformed
400	VR-242	String	`clientId` is required for order registration with `bindingId`	Required request parameters are missing
400	VR-244	String	Either `bindingId` or `defaultBindingId` can be specified in the order registration, but not both of them	Both `bindingId` and `defaultBindingId` were specified in the order registration request. Only one of those is allowed.
400	VR-245	String	Incorrect binding type when pay an order	Trying to pay for a eCom order with recurrent or installment stored credential
400	VR-246	String	Invalid binding type when paying for an order. This binding cannot be used for recurring payment	A non-recurring binding is used for recurring payment
400	VR-261	String	Additional parameters `back2app` and `app2app` must not be used simultaneously	Invalid value of passed parameters
400	VR-264	String	Invalid value of additional parameter `app.osType`	Invalid value of passed parameters
400	VR-265	String	Invalid value of additional parameter `app.deepLink`	Invalid value of passed parameters
400	VR-271	String	Invalid value of additional parameter `yandex_paymentWay`	Invalid value of passed parameters
400	VR-275	String	The target bank for payment is specified incorrectly	Invalid value of passed parameters Partner configuration error
400	VR-306	String	Order has been already processed	Trying to perform `instantPayment.do` again with the same `orderNumber` or calling `instantPayment.do` with previously registered `orderNumber`
400	VR-307	String	Order has been already processed	Trying to perform `recurrentPayment.do` again with the same `orderNumber` or calling `recurrentPayment.do` with previously registered `orderNumber`
424	VR-330	String	No active keys for SeToken decryption	Payment service configuration error
400	VR-331	String	No key in the Payment service could decrypt the SeToken	The Partner is using an incorrect key
400	VR-332 ... VR-337	String	Errors validating the contents of seToken. The reason is specified in the error text.	The token contents are invalid.
400	VR-351	String	Request signature verification error. Empty request body	Request body is missing.
400	VR-352	String	Signature verification error: empty X-Hash header	Request body hash missing
400	VR-353	String	Signature verification error: incorrect X-Hash header	The request hash was generated incorrectly or passed in an invalid encoding. Pass the hash in base64 encoding.
400	VR-354	String	Signature verification error: empty X-Signature header	Request signature missing
400	VR-355	String	Signature verification error: incorrect signature	The request signature is generated incorrectly
424	VR-356	String	No active keys for signature verification	Payment service configuration error
400	VR-357	String	Request signature verification errors - signature not correctly encoded in base64	The signature is encoded incorrectly
400	VR-990	String	Generic error in the request (without specifying the reason)	The specific error has not yet received an individual code