Bragg Sandbox — Developer Portal

Sandbox Credentials

⚠ These credentials are shared. Do not store real user data or real BVNs in the sandbox. Data is reset periodically.

Demo Partner Account

Ready to use

Base URL

sandbox.bragglabs.com.ng

Partner ID

sandboxdemo

Partner Secret

sandboxdemo2026xx

Test Wallet ID

e6b39d91-f896-4e32-8252-bc3aa6912874

Wallet PIN

1234

Test Merchant ID

3402923e-74b9-4c93-9ad1-ae58b88cea62

Quick Start

Get a partner token

Authenticate with the sandbox API to get a JWT for all subsequent calls.

# POST /auth/token
curl -s -X POST https://sandbox.bragglabs.com.ng/auth/token \
  -H "Content-Type: application/json" \
  -d '{"partner_id":"sandboxdemo","secret":"sandboxdemo2026xx"}' | jq .token

Generate an NFC payment token

The customer app calls this before tapping. Token expires in 5 minutes.

# GET /v1/wallets/{wallet_id}/token?amount={kobo}
curl -s "https://sandbox.bragglabs.com.ng/v1/wallets/WALLET_ID/token?amount=5000" \
  -H "Authorization: Bearer $TOKEN" | jq .

Submit a transaction

The merchant terminal submits the tap after receiving the NFC token and cryptogram.

# POST /v1/transactions
curl -s -X POST https://sandbox.bragglabs.com.ng/v1/transactions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id":  "WALLET_ID",
    "merchant_id": "MERCHANT_ID",
    "amount":     5000,
    "currency":   "NGN",
    "pin":        "1234"
  }' | jq .

Receive webhooks

curl -s -X POST https://sandbox.bragglabs.com.ng/v1/webhooks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "sandboxdemo",
    "url":        "https://your-app.com/bragg/webhook",
    "secret":     "your-webhook-secret-min-16",
    "events":     ["tap.completed","settlement.batch"]
  }' | jq .

Portals

🏦

Partner Dashboard

View wallets, transactions, settlements and webhooks

→ /partner

⚙️

Admin Dashboard

Approve merchants, fraud queue, audit log

→ /admin

📱

User Wallet

Customer-facing wallet view and transaction history