Fund Card

Fund a card

curl --request POST \
  --url https://api.cartevo.co/api/v1/cards/{id}/fund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 2
}'

import requests

url = "https://api.cartevo.co/api/v1/cards/{id}/fund"

payload = { "amount": 2 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({amount: 2})
};

fetch('https://api.cartevo.co/api/v1/cards/{id}/fund', 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.cartevo.co/api/v1/cards/{id}/fund",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 2
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.cartevo.co/api/v1/cards/{id}/fund"

	payload := strings.NewReader("{\n  \"amount\": 2\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	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.cartevo.co/api/v1/cards/{id}/fund")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 2\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cartevo.co/api/v1/cards/{id}/fund")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 2\n}"

response = http.request(request)
puts response.read_body

POST

cards

{id}

fund

Fund a card

curl --request POST \
  --url https://api.cartevo.co/api/v1/cards/{id}/fund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 2
}'

import requests

url = "https://api.cartevo.co/api/v1/cards/{id}/fund"

payload = { "amount": 2 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({amount: 2})
};

fetch('https://api.cartevo.co/api/v1/cards/{id}/fund', 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.cartevo.co/api/v1/cards/{id}/fund",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 2
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.cartevo.co/api/v1/cards/{id}/fund"

	payload := strings.NewReader("{\n  \"amount\": 2\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	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.cartevo.co/api/v1/cards/{id}/fund")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 2\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cartevo.co/api/v1/cards/{id}/fund")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 2\n}"

response = http.request(request)
puts response.read_body

Overview

POST /cards/{id}/fund moves USD from your company’s USD wallet onto the specified card. The card balance increases immediately on success, and the cardholder can use the funds for online payments.

When to use it

Top up a card before the cardholder makes a purchase.
Move savings/payroll/per-diem funds onto an active card.

For the reverse direction (card → wallet), see POST /cards/{id}/withdraw.

Prerequisites

Card status must be ACTIVE (not PENDING, FROZEN, SUSPENDED, TERMINATED, or FAILED).
The card must belong to your company.
The company USD wallet must have enough balance to cover amount plus any funding fees configured on your account.

Request

Headers

Name	Required	Description
`Authorization`	Yes	`Bearer <access_token>`
`Content-Type`	Yes	`application/json`

Path parameters

Name	Type	Description
`id`	string	Card ID (UUID).

Body

Field	Type	Required	Constraints	Description
`amount`	number	Yes	≥ `1`. USD.	Amount to move from the USD wallet onto the card.

{
  "amount": 50
}

Idempotency: This endpoint does not currently accept an idempotency key. To avoid double-funding on network retries, store the resulting transaction_id after the first call returns and check before retrying.

Response

200 — Success

{
  "success": true,
  "statusCode": 200,
  "message": "Card funded successfully",
  "data": {
    "transaction_id": "txn_5b7c9d2e4f6a8b1c3d5e7f9a",
    "card_id": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 50.0,
    "currency": "USD",
    "fee_amount": 0.0,
    "card_balance_before": 100.0,
    "card_balance_after": 150.0
  }
}

Field	Type	Description
`transaction_id`	string	Cartevo transaction ID. Use for support and reconciliation.
`card_id`	string	The funded card.
`amount`	number	Net amount added to the card.
`currency`	string	Always `USD`.
`fee_amount`	number	Funding fee charged to the wallet (typically `0`).
`card_balance_before`	number	Card balance before this call.
`card_balance_after`	number	Card balance after this call.

Error responses

Status	`message` example	Trigger	Recommended action
`400`	`"Insufficient wallet balance"`	USD wallet balance < `amount + fee`.	Top up the USD wallet, then retry.
`400`	`"Card not active"`	Card status is not `ACTIVE`.	Unfreeze the card or check it is not terminated.
`400`	`"Amount must be at least 1"`	`amount` < `1`.	Fix the request.
`404`	`"Card not found"`	`id` is invalid or belongs to another company.	Verify the card ID.
`5xx`	`"Funding temporarily unavailable"`	Upstream issuer transient error.	Retry with exponential backoff. Check the card balance before retrying to avoid double-funding.

Webhooks fired

card.fund — emitted on success.
transaction.funding.completed — emitted once the underlying transaction settles.

Code examples

cURL

curl -X POST https://api.cartevo.co/api/v1/cards/550e8400-e29b-41d4-a716-446655440000/fund \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50}'

Node.js (axios)

await axios.post(
  `https://api.cartevo.co/api/v1/cards/${cardId}/fund`,
  { amount: 50 },
  { headers: { Authorization: `Bearer ${token}` } }
);

Python (requests)

requests.post(
    f"https://api.cartevo.co/api/v1/cards/{card_id}/fund",
    headers={"Authorization": f"Bearer {token}"},
    json={"amount": 50},
).raise_for_status()

POST /cards/{id}/withdraw — move funds back to the wallet.
GET /cards/{id} — verify the new balance.
GET /cards/{id}/transactions — see this funding in the card’s history.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string<uuid>

required

Body

application/json

amount

number

required

Required range: x >= 1

Response

Card funded successfully

Unfreeze Card Withdraw from Card

API documentation

Auth

Cards

Customers

Wallets

Payment Collection

Webhook

Overview

When to use it

Prerequisites

Request

Headers

Path parameters

Body

Response

200 — Success

Error responses

Webhooks fired

Code examples

Authorizations

Path Parameters

Body

Response

​Overview

​When to use it

​Prerequisites

​Request

​Headers

​Path parameters

​Body

​Response

​200 — Success

​Error responses

​Webhooks fired

​Code examples

​Related

Authorizations

Path Parameters

Body

Response

Overview

When to use it

Prerequisites

Request

Headers

Path parameters

Body

Response

200 — Success

Error responses

Webhooks fired

Code examples

Related