v1

latestOpenAPI 3.0.02026-07-24231140.6 KB

BRGC Batches

Create a new BRGC batch

Creates a new BRGC batch and charges your account. The process is:

Balance is checked to ensure you have sufficient funds
Batch generation is queued (async job)
Cards are generated and account is charged
CSV file with all card codes is sent to your email within 1 hour
You can create your batch with EUR or USD cards, and pay with EUR, USD, or BTC

Limits:

Maximum 50,000 cards per batch (total across all denominations)
Maximum 10 different denominations per batch
Maximum 10,000 cards per denomination
Card value: 0.01 to 10,000 per card
Batch ID: 1-50 characters, alphanumeric with hyphens/underscores only

Rate Limit: 60 requests per 10 minutes

post/brgc-batches

Request body

idstring required

A unique identifier for your batch. Must be alphanumeric with hyphens/underscores only. A random suffix will be added server-side.

batch_currency'EUR' | 'USD' required

Currency for the gift card values

payment_currency'EUR' | 'USD' | 'BTC' required

Currency to charge your account. If different from batch_currency, conversion is applied automatically.

expiration_datestring date-time

Optional expiration date (ISO 8601). Must be between now and 1 year from now. Defaults to 1 year if not specified.

Example request

{
  "id": "marketing-campaign-q1",
  "count_and_value_list": [
    {
      "count": 10,
      "value": 5
    }
  ],
  "batch_currency": "EUR",
  "payment_currency": "BTC",
  "expiration_date": "2025-12-31T23:59:59.999Z"
}

Response

Batch queued successfully

messagestring

Example response

{
  "meta": {
    "_endpoint": "/brgc-batches"
  },
  "message": "BRGC batch generation has been queued. You will receive an email with the CSV file within an hour.",
  "data": {
    "batch_id": "batch-marketing-campaign-q1-abc123def456",
    "status": "queued",
    "total_amount": 500,
    "total_quantity": 100,
    "batch_currency": "EUR",
    "payment_currency": "BTC",
    "expiration_date": "2025-01-01T23:59:59.999Z"
  }
}