Freeze and Unfreeze Card
Endpoint
POST {{baseUrl}}/customer/virtual/cards/update/{{card_id}}
Description
This endpoint allows you to freeze or unfreeze a virtual card using the card's unique identifier. Freezing a card prevents any transactions from being processed until it is unfrozen.
Headers
No specific headers are required for this endpoint, but typically, you might need to include authorization tokens or other headers as per your API's authentication requirements.
Request Body
The request body must include the action you want to perform on the virtual card. It can either be "freeze" or "unfreeze".
Example Request Body
{
"action": "freeze"
}
or
{
"action": "unfreeze"
}
{"action":"freeze"}
PUT /api/v1/customer/virtual/cards/update/c9aa5757-c22d-48ca-a08b-aebdee325fde HTTP/1.1
Host: smtp.yativo.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 19
{
"action": "freeze"
}
No content
Response
The response will include the status of the request, a relevant message, and details about the action performed if the request is successful. If there is an error, a message indicating the issue will be returned.
Successful Unfreeze Response
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"action": "unfreeze card successful"
}
}
Successful Freeze Response
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"action": "freeze card successfully"
}
}
Error Response
If the request is invalid or there are issues processing the request, the following error response will be returned:
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"error": "Error encountered, please check your request"
}
}
Fields in Successful Response
status: Indicates the success status of the request (e.g., "success").
status_code: HTTP status code of the response (e.g., 200 for success).
message: A message describing the result of the request (e.g., "Request successful").
data: Contains details about the action performed on the virtual card.
action: A message indicating the action that was successfully performed (e.g., "unfreeze card successful" or "freeze card successfully").
Fields in Error Response
status: Indicates the success status of the request (in this case, still "success" but with an error in the data).
status_code: HTTP status code of the response (e.g., 200 for processed requests).
message: A message describing the result of the request (e.g., "Request successful").
data: Contains details about the error encountered.
error: A message indicating the issue (e.g., "Error encountered, please check your request").
By following the above details, you can successfully freeze or unfreeze a virtual card.
Last updated