Corefy Checkout SDK Texts & Localisation Reference

User-facing texts and localisation keys provide a consistent way to handle validation errors, payment decline reasons, and other payment flow messages. The SDK supplies both ready-to-display English text and stable messageKey values, allowing integrations to use the default messages or map them to their own localised content.

Texts and localisations

How `message` / `messageKey` works?

The SDK delivers every user-facing message in two forms at once:

message — ready-to-show English text by default. If you have no localisation of your own, just display it.
messageKey — a stable translation key, with params sometimes provided for interpolation. Merchants with their own i18n ignore message and map the key onto their texts.

The tables below provide the complete key dictionary for mapping.

For payment decline reasons, the text is chosen in a cascade:

Specific text of the exact code (reason) → group text (resolutionGroup) → generic fallback by context.

The reason / resolution and resolutionGroup fields always travel together, so you can map messages at any level of detail.

Field labels

Used, among other things, to compose the "<label> is required" message.

messageKey	EN text (default)
`field__card _number_label`	Card number
`field__card _expiry_label`	Expiry Date
`field__card_ security_code_label`	CVV
`field__card_ holder_name_label`	Cardholder name

Field validation messages

messageKey	EN text	Context
`validation__is_required`	is required	An empty required field. The ready-made message is composed as "field label + text": e.g. Card number is required.
`validation__ invalid_card_number`	Invalid card number	The card number fails validation (length/Luhn).
`validation__ invalid_cvv`	Invalid CVV	Invalid CVV/CVC.
`validation__ invalid_month`	Invalid month	Invalid expiry month.
`validation__ invalid_year`	Invalid year	Invalid expiry year (including a past one).
`validation__ invalid_format`	Invalid format	A generic format error (e.g. the expiry date is not in MM/YY format).
`validation__default _invalid_card_holder`	Invalid card holder	Invalid cardholder name.
`validation__default _invalid_words_length`	Invalid words length	Cardholder name: invalid word length.

Generic fallback texts

Used when a decline reason has neither a code text nor a group text.

messageKey	EN text	Context
`retry_description`	An unknown error prevented us from making a payment. Would you like to select another method?	Fallback for the `retry` directive.
`auto_retry _description`	An unknown error prevented us from making a payment. Would you like to try again?	Fallback for the `auto_retry` directive.
`status_page__ failed_description_1`	An error occurred when trying to make a payment.	Fallback for the final `fail` status (the `complete` directive).

Decline reasons: groups (`resolutionGroup`)

resolutionGroup	messageKey	EN text
`command_resolution_group`	`resolution__command _group_description`	A system error occurred, preventing the transaction from being completed. Please try again later.
`general_group`	`resolution__general _group_description`	A system error occurred, preventing the transaction from being completed. Please try again later.
`auth_required_group`	`resolution__auth_required _group_description`	There was an error processing your transaction.
`invalid_request_group`	`resolution__invalid_ request_description`	The transaction failed due to incorrect or invalid data. This may include errors in entered information, card status, or sum limits.
`limit_violation_group`	`resolution__limit_violation _group_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`auth_error_group`	`resolution__auth_errors _group_description`	The authorisation process failed due to various reasons related to authentication, card status, or account limitations.
`access_error_group`	`resolution__access_ error_description`	A system error occurred, preventing the transaction from being completed. Please try again later.
`functionality_not_ supported_group`	`resolution__functionality_not _supported_group_description`	The requested functionality is not supported by the vendor account, transaction type, or method.
`provider_error_group`	`resolution__provider_error _group_description`	A system error occurred, preventing the transaction from being completed. Please try again later.
`processing_group`	`resolution__processing _group_description`	An error occurred during the processing of the transaction, including issues like transaction not found, expiration, or reconciliation problems.
`contact_require_group`	`resolution__contact_ require_group_description`	Action is required from the issuer or provider to resolve the issue. This typically involves contacting the relevant parties for further assistance.
`transport_error_group`	`resolution__transport _group_description`	An issue occurred related to network connectivity or communication, including connection errors or fatal timeouts.
`report_error`	`resolution__report_ error_group_description`	An issue occurred with generating or retrieving the report, such as the report being unavailable, missing information, or duplicated slips.

Decline reasons: individual codes (`resolution` / `reason`)

Codes with their own, more specific text override the group text. Any other code falls back to its group's text, then to the generic fallback.

resolution / reason	messageKey	EN text
`invalid_pan`	`resolution__invalid _pan_description`	The card number you entered is invalid.
`provider_error`	`resolution__provider _error_description`	A system error occurred, preventing the transaction from being completed. Please try again later.
`invalid_credentials`	`resolution__invalid_ credentials_description`	One or several card credentials you entered are invalid.
`invalid_cvv`	`resolution__invalid _cvv_description`	The CVV code you entered is incorrect.
`invalid_amount`	`resolution__invalid _amount_description`	We were unable to process your transaction. It may be related to the online payment limits of your card.
`invalid_card_status`	`resolution__invalid_ card_status_description`	We were unable to process your transaction. It may be related to the online payment limits, wrong credentials, card blockage/being expired, insufficient funds, etc.
`invalid_card`	`resolution__invalid_ card_description`	One or several card credentials you entered are invalid.
`invalid_token`	`resolution__invalid _token_description`	There was an error processing your transaction.
`card_expired`	`resolution__card _expired_description`	The card you entered is expired.
`card_is_blocked`	`resolution__card_ is_blocked_description`	This card is blocked and cannot be charged.
`card_is_lost`	`resolution__card_ is_lost_description`	This card is blocked and cannot be charged.
`card_is_stolen`	`resolution__card_is _stolen_description`	This card is blocked and cannot be charged.
`card_is_lost _or_stolen`	`resolution__card_is_ lost_or_stolen_description`	This card is blocked and cannot be charged.
`invalid_details`	`resolution__invalid_ details_description`	One or several card credentials you entered are invalid.
`min_amount_ limit_violation`	`resolution__min_amount _limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`max_amount_ limit_violation`	`resolution__max_amount _limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`amount_limit _violation`	`resolution__amount_limit _violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`issuer_limit _violation`	`resolution__issuer_ limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`acquirer_limit _violation`	`resolution__acquirer_ limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`acquirer_turnover _limit_violation`	`resolution__acquirer_turnover _limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`card_usage_frequency _limit_violation`	`resolution__card_usage_ frequency_limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`card_usage_issuer _limit_violation`	`resolution__card_usage_ issuer_limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`card_turnover_issuer _limit_violation`	`resolution__card_turnover _issuer_limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`card_issuer_daily _limit_reached`	`resolution__card_issuer_daily _limit_reached_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`card_withdrawal _limit_violation`	`resolution__card_withdrawal _limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`card_deposit_ limit_violation`	`resolution__card_deposit_ limit_violation_description`	We were unable to process your transaction because the online payment limit of your card was either exceeded or exhausted.
`insufficient_funds`	`resolution__insufficient _funds_description`	Would you like to try again with lower amount or try a different method?
`card_is_not _3ds_enrolled`	`resolution__card_is_not _3ds_enrolled_description`	There was an error processing your transaction. Your card may not be 3-D Secure.
`credentials_expired`	`resolution__credentials _expired_description`	There was an error processing your transaction.
`antifraud_decline`	`resolution__antifraud _decline_description`	Your payment was marked as suspicious and thus rejected.
`expired`	`resolution__expired _description`	The payment has expired, and the transaction cannot be completed.