Error codes

When an API request fails, Open Fabric returns an HTTP error status code. Depending on the endpoint, the response body may also include an error code and message.

This page documents the platform error codes.

Error code	HTTP	Message
unauthorized	401	The credentials / access token are invalid.
forbidden	403	The requested resource cannot be accessed.
unexpected_error	500	An unexpected error encountered during the process. Please contact to OF admin for more information.
validation_error	400	The request contains invalid data. Please check and correct the input fields.
internal_validation_error	400	An internal validation error occurred. Please refer to the error details for more information.
idempotency_error	409	Idempotency-Key concurrency conflict.
transaction_not_found	404	The requested transaction can not be found.
transaction_amount_invalid	400	The amount is not valid.
transaction_currency_invalid	400	The currency is not valid.
transaction_parameter_invalid	400	Transaction request parameters are invalid.
transaction_status_unexpected	422	The Transaction status was incompatible with the performing operation.
transaction_customer_not_found	404	The requested customer can not be found.
transaction_card_creation_failed	422	Cannot create a card for the transaction
transaction_card_tokenization_failed	422	Cannot tokenize card for the transaction.
transaction_card_charge_failed	422	Cannot charge the transaction.
transaction_pg_refund_failed	422	Cannot refund the transaction.
transaction_card_invalidation_failed	422	Cannot invalidate the card.
transaction_duplicate_reference	409	The Reference ID provided has already been used.
card_config_missing	422	Missing configuration for card.
partner_config_missing	422	Missing configuration for the partner.
tenant_config_missing	422	Missing configuration for the tenant.
card_not_found	404	The requested card can not be found.
card_creation_failed	422	The card creation request to Mastercard failed.
card_update_failed	422	The update card request to Mastercard failed.
card_tokenization_failed	422	The card tokenization request to the PG failed.
card_charge_failed	422	The charge request to the PG failed.
card_refund_failed	422	The refund request to the PG failed.
card_invalidation_failed	422	The card invalidation request to Mastercard failed.
card_parameter_invalid	400	One or more provided card parameters are not valid.
tenant_parameter_invalid	400	One or more provided tenant parameters are not valid.
partner_parameter_invalid	400	One or more provided partner parameters are not valid.
card_config_failed	422	Card configuration failed.
tenant_config_failed	422	Tenant configuration failed.
partner_config_failed	422	Partner configuration failed.
notification_subscription_not_found	404	The requested subscription can not be found.
notification_subscription_parameter_invalid	400	Subscription request parameters are invalid.
notification_parameter_invalid	400	Notification request parameters are invalid.
notification_processing_failed	422	Notification processing failed.
transaction_tenant_creation_failed	422	The request to create a transaction failed at tenant side.
tenant_config_resource_not_found	404	Resource of tenant was not found.
partner_config_resource_not_found	404	Resource of partner was not found.
entity_type_duplicate_reference	409	Entity type provided has already been used
pat_parameter_invalid	400	Pre-approval Transaction link request parameters are invalid
pat_link_duplicate_reference	409	Link reference provided has already been used
pat_link_not_found	404	Pre-approval Transaction link can not be found.
pat_link_tenant_failed	422	The request to for Pre-approval Transaction link failed at tenant side.
customer_not_found	404	The requested customer can not be found.
tenant_customer_duplicate_reference	409	The tenant customer reference ID provided has already been used.
transaction_context_not_found	404	The requested transaction context can not be found.
create_transaction_context_failed	400	Transaction context creation failed.
tenant_device_duplicate_reference	409	The tenant device reference ID provided has already been used.
tenant_account_duplicate_reference	409	The tenant account reference ID provided has already been used.
create_pba_device_failed	400	PBA device creation failed.
pba_device_not_found	404	The requested PBA device can not be found.
delete_pba_device_failed	400	PBA device deletion failed.
pba_account_not_found	404	The requested PBA account can not be found.
create_pba_account_failed	400	PBA account creation failed.
delete_pba_account_failed	404	PBA account deletion failed.
pba_provision_failed	400	PBA provision failed.
static_token_not_found	404	The requested static token can not be found.
wallet_not_found	404	The requested SDK wallet can not be found.
wallet_settings_not_found	404	The requested SDK wallet settings can not be found.
token_not_found	404	The requested SDK token can not be found.
device_not_found	404	The requested SDK device can not be found.