Store Credit API

Issue store credit to consumers programmatically.

Issue store credit

POST /api/v1/store-credit — creates or updates a consumer's store credit wallet at your store. Useful for refunds, loyalty rewards, and promotional credits.

Body parameters

• emailrequired

  string

  Consumer's email address.

• amountCentsrequired

  integer

  Amount in minor units, range 1–1,000,000.

• currency

  string·default: USD

  ISO-4217 currency code.

• source

  string·default: manual

  One of manual, refund, referral, promotion. Stored on the transaction for accounting.

Example request

curl -X POST https://merchant.reloadcard.app/api/v1/store-credit \
  -H "Authorization: Bearer rc_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "amountCents": 1000,
    "currency": "USD",
    "source": "refund"
  }'

Example response (200)

{
  "success": true,
  "walletId": "550e8400-...",
  "transactionId": "660e8400-...",
  "creditBalanceCents": 1000
}

Rate limit

100 requests per hour.