Steps to Go Live
- In Settings → API Keys, create a new key with Activate Sandbox Clicked — prefix will be
sk_live_
- Update base URL to
https://api.usebila.com/api/v1
- Replace
sk_test_ keys with sk_live_ in your environment variables
- Register a new production webhook and save the new signing secret
Production keys process real money immediately. Never use them for testing.
Pre-Launch Checklist
Setup
- Sandbox activated via Settings → Environment
sk_test_ key created and stored in environment variable- Connection verified —
GET /bila/accounts returns wallet data
Collections
- Successful collection returns
"status": "successful"
- Reference with
fail returns "status": "failed"
- Duplicate reference returns
409
- Status polling transitions correctly from
pending
Transfers
- Successful transfer returns
"status": "successful"
- Reference with
fail returns "status": "failed"
- Amount exceeding balance returns
400 INSUFFICIENT_BALANCE
- Status polling transitions correctly from
pending
Webhooks
- Webhook registered and signing secret stored
- Signature verification implemented and tested
payment.completed and payment.failed received correctly- Duplicate delivery detection via
X-Bila-Delivery working
- Endpoint returns
200 in under 10 seconds
Support
