Status list¶
Payment statuses¶
Payment status defines the stage of transaction. The status can be transitional and final.
| Status code | Final | Description |
|---|---|---|
created | Invoice has been created; processing has not started. If PaymentsTrust does not return response 201 (Created) HTTP status code on your request, you should admit that the payment invoice creation was failed. | |
expired | ✔ | Invoice hit the lifetime limit without successful processing. |
process_pending | Process still being unknown and may not be known for an extended period. | |
processed | ✔* | Processed successfully. It isn't a final status since the payment can be refunded for different reasons. |
process_failed | ✔ | Processing has failed, may be set when an error occurs and the corresponding payment request has failed. This status is considered final due to the maximum number of attempts has been reached (default—after 5 attempts). |
refund_pending | Refunding is still being unknown and may not be known for an extended period. | |
partially_refunded | ✔ | Successfully refunded amount is less than the invoice amount. |
refunded | ✔ | Successfully refunded in full. |
refund_failed | ✔ | Refunding has been failed or cannot be completed. |
charged_back | ✔ | The payment transaction was claimed as a chargeback in full amount. |
partially_charged_back | ✔ | The payment transaction was claimed as a chargeback but in amount less than the invoice amount. |
* — The status is considered as final, but the payment can be rejected for additional reasons or recovered (in refund or chargeback cases).
Payment resolutions¶
A resolution is a transaction status clarification.
With transitional and successful final statuses, the related resolutions have an ok code. With failed final status, the resolutions get one of the following codes:
| Resolution Code | Description |
|---|---|
amount_conversion_error | Error occurred while converting the transaction amount between currencies |
ACCESS_DENIED | The user is not authorized or does not have permission |
ACCESS_ERROR | Not enough rights to perform the operation |
AMOUNT_IS_GREATER | The transaction amount is greater than the minimum amount allowed by the provider |
AMOUNT_IS_LESS | The transaction amount is less than the minimum amount allowed by the provider |
ANTIFRAUD_ERROR | The payment did not pass the fraud check (deprecated) |
antifraud_error | The payment did not pass the fraud check |
AUTH_3DS_REQUIRED | 3D-Secure check is required (deprecated) |
AUTH_CVV_REQUIRED | CVV entry is required |
AUTH_FATAL_ERROR | Authorization fatal error (deprecated) |
AUTH_LOOKUP_REQUIRED | Authorization lookup is required |
AUTH_OTP_REQUIRED | OTP-Secure check is required (deprecated) |
auth_3ds_required | 3D-Secure check is required |
auth_fatal_error | Authorization fatal error |
auth_otp_required | OTP-Secure check is required |
blocked_by_firewall | The transaction was blocked by a firewall |
CARD_EXPIRED | The card has expired (deprecated) |
CARD_IS_3DS_ENROLLED | The card is 3D-Secure enrolled |
CARD_IS_NOT_3DS_ENROLLED | The card is not 3D-Secure enrolled |
card_is_not_3ds_v2_enrolled | The card is not enrolled in 3D-Secure version 2 |
card_3ds_enrolled | The card is 3D-Secure enrolled |
card_blocked_by_invalid_pin | The card has been blocked due to invalid PIN attempts |
card_expired | The card has expired |
card_is_blocked_by_invalid_pin | The card has been blocked because an incorrect PIN was entered several times |
card_is_lost | The card has been lost |
card_is_lost_or_stolen | Card has been lost or stolen |
card_is_stolen | The card has been stolen |
card_lost | The card has been reported as lost |
card_not_3ds_enrolled | The card is not enrolled in 3D-Secure |
card_restricted | The card is restricted for use |
card_restricted_by_acquirer | The card is restricted by the acquirer |
card_status_is_restricted | The card is restricted to where it can be used |
card_status_is_restricted_for_provider | The card is restricted for the provider |
card_stolen | The card has been reported as stolen |
card_type_not_supported | The card type is not supported |
card_usage_frequency_limit_violation | The number of transactions exceeded the limit of card usage frequency |
card_usage_issuer_limit_violation | The card usage limit set by the issuer has been exceeded |
card_usage_limit_violation | The card usage limit has been exceeded |
card_verification_failed | The card verification process has failed |
client_auth_failed | Client authentication has failed |
COMPLETE_AUTH_REQUIRED | Complete authorization is required |
connection_error | A connection error occurs |
contact_issuer | An error occurs: contact the issuer to clarify |
CREATED_FROM_STATEMENT | Created from statement |
CREDENTIALS_BLOCKED | The payment credentials are blocked |
customer_blocked | The customer account is blocked |
customer_is_blocked | The customer account is blocked |
declined | The transaction is declined |
DECLINED_ERROR | The transaction is declined |
DUPLICATED_ID | The transaction ID is duplicated |
DUPLICATED_TRANSACTION | The operation ID already exists |
dynamic_pvv_expired | A dynamic PVV code is expired |
error | Something went wrong |
expired | The transaction has been expired |
fatal_card_expired | The card has expired and the error is considered fatal |
FATAL_ISSUER_UNAVAILABLE | The card issuer is unavailable and the error is considered fatal |
fatal_decline | The transaction was declined and the error is considered fatal |
fatal_error | A fatal error occurred during the transaction |
fatal_invalid_card | The card is invalid and the error is considered fatal |
fatal_timeout | The connection is terminated due to idle-in-transaction timeout |
fee_calculation_error | The error of the fee calculation |
FORBIDDEN_IP | The IP is forbidden |
forced_captured | The transaction was forcibly captured |
FUNCTIONALITY_IS_NOT_PERMITTED | The set of functions is not permitted for the commerce account |
GATEWAY_INTERNAL_ERROR | Gateway internal error |
GATEWAY_VALIDATION_PARAMS_ERROR | Validation error |
GENERAL_FATAL_ERROR | Fatal error in which further processing of the operation is meaningless |
general_decline | The transaction was declined for a general reason |
INSUFFICIENT_FUNDS | The funds are insufficient (deprecated) |
insufficient_funds | There are insufficient funds to complete the transaction |
INTERNAL_ERROR | System error (internal) |
invalid_account | Invalid account |
INVALID_3DS_CODE | The 3D-Secure code is invalid (deprecated) |
invalid_3ds_code | The 3D-Secure code provided is invalid |
INVALID_AMOUNT | The payment amount is invalid: insufficient funds or transaction limit was exceeded (deprecated) |
invalid_amount | The transaction amount is invalid |
INVALID_CARD | The card number is invalid (deprecated) |
invalid_card | The card used is invalid |
invalid_card_type | The type of card used is invalid for this transaction |
invalid_cardholder | The cardholder information is invalid |
INVALID_CARD_STATUS | The card status is invalid |
INVALID_CREDENTIALS | The payment credentials are invalid |
INVALID_CVV | CVV is invalid (deprecated) |
invalid_cvv | The CVV provided is invalid |
INVALID_DETAILS | Account details are invalid (deprecated) |
invalid_details | The details provided for the transaction are invalid |
invalid_expire_date | The expiration date of the card is invalid |
INVALID_LOOKUP_CODE | The lookup code provided is invalid |
INVALID_METHOD | The used payment method is invalid |
INVALID_OTP | The OTP is invalid |
invalid_otp_code | The OTP code provided is invalid |
INVALID_PAN | PAN is invalid |
INVALID_PIN | PIN code is invalid |
INVALID_RECIPIENT | Recipient is invalid |
INVALID_REQUEST | Invalid request format |
INVALID_TOKEN | The transmitted token is invalid |
issuer_decline | The transaction was declined by the issuer |
issuer_unavailable | The card issuer is currently unavailable |
LIMIT_VIOLATION | The transactions' amount exceeded the issuer's limit (deprecated) |
limit_violation | A transaction limit has been violated |
LOST_OR_STOLEN_CARD | The card has been lost or stolen |
no_routes_by_conditions | No available payment routes match the provided conditions |
no_routes_by_history | No suitable payment routes found based on the transaction history |
ok | The process completed successfully |
OK | The process completed successfully (deprecated) |
OPERATION_EXPIRED | Operation is overdue |
payment_hard_declined | The payment was permanently declined by the provider with no retry allowed |
pin_tries_limit_was_reached | An incorrect PIN was entered several times, and the limit of attempts was reached |
PROCESSING_ERROR | Processing error |
provider_error | The Payment Provider returns an error |
provider_fatal_error | The Payment Provider returns a fatal error |
PROVIDER_MODERATION_REQUIRED | Provider moderation is required |
RECIPIENT_NOT_FOUND | Recipient not found |
reconcile_required | Reconciliation is required |
refund_error | An error occurred during the refund process |
REQUEST_ERROR | An error occurred while processing the request by the payment provider |
reserve_calculation_error | The error of the calculation of the reserve |
ROUTING_ERROR | Routing error |
SIGNATURE_ERROR | Invalid signature |
timeout | A timeout occurred during the transaction |
transaction_expired | The transaction has expired |
TRANSACTION_NOT_FOUND | Transaction not found |
UNABLE_TO_DETERMINE_3DS_ENROLMENT | It is unable to determine 3D-Secure enrollment |
UNABLE_TO_RECONCILE | The transaction is unable to reconcile |
unable_determine_3ds_enrolment | Unable to determine the 3D-Secure enrollment status |
unknown | An unknown error occurred |
UNKNOWN | An unknown error occurred (deprecated) |
The detailed level of the transaction's failure reason depends on the information openness of payment service providers (PSP) and issuer banks (for card transactions).
Note
- PaymentsTrust could expand the list of resolutions lately.
- Receiving a resolution other than listed should not affect the transaction processing because this attribute only informs about possible errors.
- The finality and success of the transaction processing are determined solely by the payment status (
status).
Payment identifiers¶
At different stages of the payment received, the identifiers are processed with different names. Check the relations between them in the diagram below.
Note
Receiver Reference Number (RRN) and Acquirer Reference Number (ARN) are used only for card payments' identification.