Skip to main content
POST
/
cards
/
{cardId}
/
unload
Unload Card
curl --request POST \
  --url https://api.fyatu.com/api/v3/cards/{cardId}/unload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 25,
  "reference": "withdraw-67890"
}
'
{
  "success": true,
  "status": 200,
  "message": "Card unloaded successfully",
  "data": {
    "cardId": "crd_8f3a2b1c4d5e6f7890abcdef12345678",
    "amountUnloaded": 25,
    "fee": 0.25,
    "amountCredited": 24.75,
    "reference": "withdraw-67890"
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6",
    "timestamp": "2026-01-17T10:00:00+00:00"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Remove balance from a card and return it to your business wallet. Use this to reclaim funds from unused or low-activity cards.

​
Path Parameters

ParameterTypeDescription
cardIdstringThe card ID

​
Request Body

FieldTypeRequiredDescription
amountnumberYesAmount to remove from card (in card’s currency). Must not exceed current card balance.

​
Behavior

  • Card balance decreases by amount
  • Business wallet is credited by the equivalent amount (after any applicable FX conversion for EUR cards)
  • Transaction appears in both card and wallet transaction history

​
Error Codes

CodeDescription
RESOURCE_NOT_FOUNDCard not found or belongs to another business
CARD_NOT_ACTIVECard must be ACTIVE to unload
INSUFFICIENT_CARD_BALANCEUnload amount exceeds current card balance
PROVIDER_ERRORCard provider rejected the unload operation

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

​
cardId
string
required

Body

application/json
​
amount
number
required

Amount to unload in USD

​
reference
string

Your unique reference for this operation. Defaults to cardId if not provided.

Maximum string length: 100

Response

Funds unloaded successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
​
data
object
​
meta
object