Skip to main content
POST
/
cardholders
/
{id}
/
reactivate
Reactivate a cardholder
curl --request POST \
  --url https://api.fyatu.com/api/v3.20/cardholders/{id}/reactivate \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.fyatu.com/api/v3.20/cardholders/{id}/reactivate"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fyatu.com/api/v3.20/cardholders/{id}/reactivate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fyatu.com/api/v3.20/cardholders/{id}/reactivate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.fyatu.com/api/v3.20/cardholders/{id}/reactivate"

req, _ := http.NewRequest("POST", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.fyatu.com/api/v3.20/cardholders/{id}/reactivate")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.fyatu.com/api/v3.20/cardholders/{id}/reactivate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "success": true,
  "status": 200,
  "message": "Cardholder retrieved",
  "data": {
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@example.com",
    "phone": "+12025551234",
    "dateOfBirth": "1990-05-15",
    "nationality": "US",
    "address": {
      "address": "123 Main Street, Apt 4B",
      "city": "Newark",
      "country": "US",
      "state": "Delaware",
      "postalCode": "19701"
    },
    "kycDocument": {
      "documentType": "PASSPORT",
      "documentNumber": "AB123456",
      "issuingCountry": "US",
      "frontUrl": "https://storage.example.com/doc-front.jpg",
      "backUrl": null,
      "selfieUrl": "https://storage.example.com/selfie.jpg"
    },
    "externalId": "usr_123456",
    "metadata": {
      "plan": "premium"
    },
    "status": "ACTIVE",
    "kycStatus": "APPROVED",
    "kycVerifiedAt": "2026-05-10T14:23:00Z",
    "kycRejectionReason": null,
    "totalCards": 2,
    "suspendedAt": null,
    "terminatedAt": null,
    "createdAt": "2026-05-01T09:00:00Z",
    "updatedAt": "2026-05-10T14:23:00Z"
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-22T15:00:00Z"
  }
}

Overview

Reactivates a suspended cardholder. Once reactivated, the cardholder’s status returns to ACTIVE and their cards can transact again immediately. This endpoint has no request body.

Path Parameters

ParameterTypeDescription
idstringThe cardholder ID (prefix chl_)

Example

curl -X POST https://api.fyatu.com/api/v3.20/cardholders/chl_01HXYZ1234ABCDEF5678/reactivate \
  -H "Authorization: Bearer $FYATU_API_KEY"
const resp = await fetch(
  'https://api.fyatu.com/api/v3.20/cardholders/chl_01HXYZ1234ABCDEF5678/reactivate',
  {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${process.env.FYATU_API_KEY}` }
  }
);
const body = await resp.json();
console.log(body.data.status);      // "ACTIVE"
console.log(body.data.suspendedAt); // null
import os, requests

resp = requests.post(
    'https://api.fyatu.com/api/v3.20/cardholders/chl_01HXYZ1234ABCDEF5678/reactivate',
    headers={'Authorization': f'Bearer {os.environ["FYATU_API_KEY"]}'}
)
cardholder = resp.json()['data']
print(cardholder['status'])      # ACTIVE
print(cardholder['suspendedAt']) # None

Success Response (200)

Returns the full updated cardholder object with status: ACTIVE and suspendedAt: null:
{
  "success": true,
  "status": 200,
  "message": "Cardholder reactivated",
  "data": {
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "programId":    "prg_01HXYZ9876ABCDEF0000",
    "firstName":    "John",
    "lastName":     "Smith",
    "email":        "john.smith@example.com",
    "status":       "ACTIVE",
    "kycStatus":    "APPROVED",
    "kycVerifiedAt": "2026-05-01T09:05:00Z",
    "suspendedAt":  null,
    "totalCards":   2,
    "totalSpendCents": 125000,
    "createdAt":    "2026-05-01T09:00:00Z",
    "updatedAt":    "2026-05-22T10:15:00Z"
  },
  "meta": {
    "requestId": "req_01HXY123456ABCDEF",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-22T10:15:00Z"
  }
}

Webhook

A CARDHOLDER_REACTIVATED event fires immediately after a successful reactivation:
{
  "event":      "CARDHOLDER_REACTIVATED",
  "eventId":    "evt_01HXY123456ABCDEF",
  "businessId": "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":  "2026-05-22T10:15:00Z",
  "data": {
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "status":       "ACTIVE"
  }
}

Error Codes

CodeHTTPCause
ALREADY_ACTIVE409Cardholder is already active (not suspended)
CARDHOLDER_TERMINATED409Terminated cardholder cannot be reactivated
CARDHOLDER_NOT_FOUND404Cardholder does not exist or belongs to another business
INSUFFICIENT_SCOPE403Key lacks cardholders:write scope

Authorizations

Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Path Parameters

id
string
required

Response

Cardholder reactivated

success
boolean
Example:

true

status
integer
Example:

200

message
string
Example:

"Cardholder retrieved"

data
object
meta
object