Authentication

All API requests require a Bearer token. API keys are scoped to a single merchant.

API key format

rc_live_a3b8c2d1e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9

Keys start with rc_live_ followed by 64 hexadecimal characters.

Using your key

Include the key in the Authorization header:

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

Creating API keys

1. 1

   Log in to your merchant dashboard

   Sign in at merchant.reloadcard.app.

2. 2

   Open Settings → API Keys

   Find the API Keys panel under Settings in the left navigation.

3. 3

   Generate a new key

   Click Generate New Key. Optionally set an expiry date.

4. 4

   Copy and store the key

   Copy the key immediately and store it somewhere safe — it won't be shown again.

Rate limiting

API requests are rate limited per endpoint. If you exceed the limit, you'll receive a 429 Too Many Requests response. Wait and retry — back off exponentially for best results.

Error responses

// Missing or invalid key — HTTP 401
{ "error": "Invalid or missing API key" }

// Rate limited — HTTP 429
{ "error": "Too many requests" }