Overview
A drawdown account is a pre-funded balance that Elite partners can use to purchase gift cards. Using a drawdown account as a payment method at checkout provides an automatic 2.5% discount on the order total.
Drawdown accounts are available to Elite partners only.
Get Balance
Returns the current drawdown account balance breakdown.
Request
curl https://sandbox-api.cardcash.com/v3/customers/drawdown-account \
-H "x-cc-app: YOUR_APP_ID" \
-H "Authorization: Bearer YOUR_TOKEN"
Response
{
"balance": 1500.00,
"availableBalance": 1200.00,
"pendingBalance": 300.00,
"isActive": true
}
Response Fields
| Field | Type | Description |
|---|
balance | number | Total account balance |
availableBalance | number | Balance available for purchases |
pendingBalance | number | Balance reserved for pending orders |
isActive | boolean | Whether the drawdown account is active |
Get Transactions
Returns the transaction history for the drawdown account.
Request
curl https://sandbox-api.cardcash.com/v3/customers/drawdown-account/transactions \
-H "x-cc-app: YOUR_APP_ID" \
-H "Authorization: Bearer YOUR_TOKEN"
Response
{
"transactions": [
{
"id": 123,
"date": "2026-01-15T12:00:00.000Z",
"type": "Purchase",
"amount": -95.50,
"balance": 1404.50,
"description": "Order #12345"
},
{
"id": 122,
"date": "2026-01-10T09:00:00.000Z",
"type": "Deposit",
"amount": 2000.00,
"balance": 1500.00,
"description": "Account funded"
}
]
}
Transaction Fields
| Field | Type | Description |
|---|
id | integer | Transaction ID |
date | string | ISO 8601 timestamp |
type | string | Transaction type (e.g., “Purchase”, “Deposit”) |
amount | number | Amount (negative for debits, positive for credits) |
balance | number | Account balance after this transaction |
description | string | Description of the transaction |
Using Drawdown at Checkout
To pay with a drawdown account, use DRAWDOWN_ACCOUNT as the paymentMethod in the condensed checkout:
curl -X POST "https://sandbox-api.cardcash.com/v3/orders?checkout=condensed" \
-H "x-cc-app: YOUR_APP_ID" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"cartId": "CART_ID",
"paymentMethod": "DRAWDOWN_ACCOUNT",
"shippingDetails": {
"firstname": "John",
"lastname": "Doe",
"street": "123 Main St",
"city": "New York",
"state": "NY",
"postcode": "10001"
}
}'
payment.details or billingDetails are required — the system uses your profile address and debits the drawdown account directly.
Checkout Requirements
- Account must be active (
isActive: true)
- Available balance must cover the order total (after 2.5% discount)
- Your account must have an address and phone number on file
Errors
| Error | Cause |
|---|
"Drawdown account is inactive" | Account not active |
"Insufficient funds available" | Balance too low for this order |
"Customer is not authorized to checkout with a drawdown account" | Account not authorized for drawdown |
"Customer details are required" | Missing address or phone on account profile |
