Quickstart

Get your API key

We email your key (bpk_xxxxxxxx_...) to you when your account is created. Store it in server-side secret storage. See Authentication.

Check your balance

curl https://orders.balaipedia.com/v1/balance \
  -H "Authorization: Bearer YOUR_KEY"

{"object":"balance","balance":42.35,"currency":"USD","price_per_order":0.15}

Create an order

We recommend sending an Idempotency-Key header (optional; 8-64 characters, e.g. a UUID) so a retry never creates the same order twice.

curl -X POST https://orders.balaipedia.com/v1/orders \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2f7e-9a4b-4d0e-8f3a-1b2c3d4e5f60" \
  -d '{"email":"[email protected]","name":"Budi","lang":"en","reference":"ORD-10293"}'

Save the returned id (e.g. BP-7K3M9QXA) with your own order. See Create order.

Track the status

curl https://orders.balaipedia.com/v1/orders/BP-7K3M9QXA \
  -H "Authorization: Bearer YOUR_KEY"

Getting Started

Guides

Orders

Account

Webhook endpoints

Utility

Telegram bot