Skip to main content
POST
/
cards
/
{cardId}
/
fund
Fund Card
curl --request POST \
  --url https://api.fyatu.com/api/v3/cards/{cardId}/fund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 50,
  "reference": "my-order-12345"
}
'
{
  "success": true,
  "status": 200,
  "message": "Card funded successfully",
  "data": {
    "cardId": "crd_8f3a2b1c4d5e6f7890abcdef12345678",
    "amountFunded": 50,
    "fee": 0.5,
    "reference": "my-order-12345"
  },
  "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

Add balance to an existing card. The amount is debited from your business wallet and credited to the card immediately. Applicable funding fees are deducted from the wallet in addition to the card amount.

​
Path Parameters

ParameterTypeDescription
cardIdstringThe card ID

​
Request Body

FieldTypeRequiredDescription
amountnumberYesAmount to add to the card (in card’s currency)

​
Behavior

  • Amount is debited from your business wallet immediately
  • Card balance increases by amount
  • Transaction appears on both the card’s transaction history and your wallet transactions

​
Error Codes

CodeDescription
RESOURCE_NOT_FOUNDCard not found or belongs to another business
CARD_NOT_ACTIVECard must be ACTIVE to fund
INSUFFICIENT_BALANCEBusiness wallet balance too low
PROVIDER_ERRORCard provider rejected the funding
Check the card’s current balance with GET /cards/{cardId} before funding. You can also check your wallet balance with GET /account/wallet.

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 fund in USD (min $5)

Required range: x >= 5
​
reference
string

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

Maximum string length: 100

Response

Card funded successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
​
data
object
​
meta
object