CARDS

Unfreeze Card

Re-enable a frozen card, returning it to active.

POST /v1/cards/:tracking_id/unfreeze

Use this endpoint to

Restore spending on a card that was previously frozen

Request

Path parameters

Parameter	Type	Required	Description
`tracking_id`	string	Yes	Card id from Issue Card

Code Samples

const response = await fetch(
  "https://sandbox.hitchpay.ng/v1/cards/EXTCARD123456/unfreeze",
  {
    method: "POST",
    headers: { Authorization: "Bearer YOUR_ACCESS_TOKEN" }
  }
);

const data = await response.json();
console.log(data);

<?php

$ch = curl_init();

curl_setopt_array($ch, [
  CURLOPT_URL => "https://sandbox.hitchpay.ng/v1/cards/EXTCARD123456/unfreeze",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ]
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

url = "https://sandbox.hitchpay.ng/v1/cards/EXTCARD123456/unfreeze"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}

response = requests.post(url, headers=headers)
print(response.json())

Response

{
  "status": "success",
  "message": "Card unfrozen successfully.",
  "data": {
    "tracking_id": "EXTCARD…",
    "customer_uuid": "…",
    "card_id": "…",
    "label": "John Doe USD Card",
    "brand": "visa",
    "card_type": "virtual",
    "currency": "USD",
    "masked_pan": "539983******1234",
    "last4": "1234",
    "exp_month": "08",
    "exp_year": "2029",
    "cardholder_name": "JOHN DOE",
    "balance": 75.00,
    "status": "active",
    "date_created": "1782947655"
  }
}

Fields

Returns the full card object. See the card object shape in the Overview page with status: "active".

Errors

Code	Meaning
`UNAUTHORIZED`	Business not found or inactive
`NOT_FOUND`	Card not found
`CARD_TERMINATED`	The card has been permanently closed
`INVALID_STATE`	The card is not currently frozen

Questions? Email [email protected]. Also on GitBook.