Last updated · May 9, 20266 min read

API Reference

The ReloadCard API lets you manage gift cards programmatically. All endpoints use Bearer-token authentication and return JSON.

Download OpenAPI Spec

Base URL

text

https://merchant.reloadcard.app/api/v1

Authentication

All API requests require a Bearer token. Generate API keys from your merchant dashboard under Settings → API Keys.

bash

curl -H "Authorization: Bearer rc_live_your_api_key_here" \
  https://merchant.reloadcard.app/api/v1/cards

Authentication details →

Endpoints

Cards

GET/cards→
List all cards
POST/cards→
Create a new card
GET/cards/:uuid→
Get card details + transactions
POST/cards/:uuid/activate→
Activate with initial balance
POST/cards/:uuid/credit→
Add balance
POST/cards/:uuid/debit→
Remove balance (POS redemption)
GET/cards/:uuid/balance
Check balance
POST/cards/:uuid/disable
Disable card permanently
POST/cards/:uuid/claim
Claim a pre-loaded card
POST/cards/load
Load money onto a card

Card endpoints in detail →

Batches

POST/batches/:id/provision
Provision Shopify gift cards for a batch

Transfers

GET/transfers/fx-rate
Get exchange rate for cross-currency transfer

Store Credit

POST/store-credit→
Issue store credit to a consumer

Store credit details →

Transactions

GET/transactions
List all transactions

Webhooks

POST/webhooks→
Register a new webhook
GET/webhooks→
List all webhooks
PATCH/webhooks/:id→
Update a webhook (URL, events, active status)
DELETE/webhooks/:id→
Delete a webhook

Webhook endpoints in detail →

Idempotency

The debit and credit endpoints support idempotency keys to prevent duplicate operations. Include an Idempotency-Key header with a unique string (e.g., a UUID) for each request. If the same key is sent again within 24 hours, the original response is returned without re-processing the operation.

bash

curl -X POST https://merchant.reloadcard.app/api/v1/cards/a1b2c3d4/debit \
  -H "Authorization: Bearer rc_live_your_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -d '{ "amountCents": 1500, "note": "Order #1234" }'

Rate limits

Endpoint	Limit
Card create	50 / minute
Activate	20 / minute
Debit / Credit	50 / minute
Store credit	100 / hour
Read endpoints	No limit

Error codes

Status	Meaning
`200`	Success
`201`	Created
`400`	Bad request — check your parameters
`401`	Unauthorized — invalid or missing API key
`404`	Not found — card doesn't exist or doesn't belong to you
`409`	Conflict — card already in that state
`429`	Rate limited — slow down
`500`	Server error — retry or contact support