Developer platform

Sandbox setup

Use clearly labeled test credentials, fake customer data, base URLs, and webhook checks before moving into signup or the explorer.

Test keys

Test only

These sandbox values are safe examples for local UI wiring. Real issued keys still come from the signup and key custody workflows.

Publishable key

Issued after developer verification

Secret key

Issued once after developer verification

Environment base URLs

REST API

https://billie-api.kenac.co.zw/api/v1

Hosted checkout

Configured by sandbox deployment

Webhook delivery

Configured by sandbox deployment

Test phones, cards, and accounts

Customer phone

+263 77 100 0001

Card number

4242 4242 4242 4242

Biller account

ZESA-SBX-04299811

Bank account

CBZ-SBX-000123456789

Webhook target checklist

  • Use an HTTPS endpoint for production; sandbox can point at a controlled test receiver.
  • Accept POST requests with JSON bodies and return a 2xx status only after validation.
  • Verify the billie-signature header, timestamp tolerance, and replay protection.
  • Store event IDs so retry delivery does not duplicate fulfillment.