There are two kinds of suspensions which are supported in the system currently. Depending on the state passed as part of the request the behavior changes.
Suspended
Suspends the card prevents fresh authorizations on that card. If the card has been already pre-validated by a merchant, an authorization can still be made.
Blocked
Blocking cards will disable all transaction made by that card, and all purchase authorization.
Note
A card with pending settlements cannot be blocked. You are recommended to first suspend the account and wait for pending settlements before blocking
Note
If mask_number config is enabled the number will be in the encrypted form (123456 XX XXXX 1234).
Note
Passing values lost, stolen and damaged will permanently block the card and is irreversible
Response
Response Attributes
Bad Request
| Code | Description |
| :--- | :---------- |
| user_wallet_card_improper_type | Invalid block reason type. |
| resource_card_hash_id_invalid | Invalid card `hash_id` |
| user_wallet_card_improper_id | Resource incomplete |
| resource_wallet_card_already_terminated | Card already terminated |
| resource_unable_to_unsuspend_card | Cards with active status cannot be unsuspended |
Response Attributes
descriptionstring Required
Response Attributes
descriptionstring Required
Forbidden
| Code | Description |
| :--- | :---------- |
| restricted_resource | Access with method `POST` denied |
| resource_unable_to_suspend_card | Cards with inactive status cannot be suspended |
| resource_unable_to_unsuspend_user_card | The user status prevents change of the card status. Update the user status before proceeding with the card status change |
Response Attributes
descriptionstring Required
Resource not found
| Code | Description |
| :--- | :---------- |
| resource_not_found | The requested URL was not found |
Response Attributes
descriptionstring Required
Internal Server Error
| Code | Description |
| :--- | :---------- |
| resource_risk_service_config_error | Unable to process the request due invalid risk service configuration. |
Response Attributes
descriptionstring Required
Response Attributes
descriptionstring Required
Response Attributes
descriptionstring Required
Response Attributes
descriptionstring Required