Install
Start from the CLI
The public command is the main product entry. It creates a hosted session, prints a callback URL, waits for callbacks, and forwards each payload to your local endpoint.
npx callbackdesk doctor http://localhost:3000/api/mpesa/callback
During alpha, use the repo-built CLI until the custom-domain HTTPS gate passes and the npm package is published.
node packages/cli/dist/index.js doctor http://localhost:3000/api/mpesa/callback --api https://api.loremipsum.co.ke
No account
Debug one integration immediately
- Run Doctor with your local callback handler URL.
- Paste the printed provider callback URL into the provider setting or sandbox request.
- Keep the terminal open while CallbackDesk forwards payloads to localhost.
- Use
callbackdesk replay <event-id>after fixing the handler.
Account mode
Create projects only when you need persistence
Sign in through Supabase Auth, create a project, issue a one-time CLI token, then run Doctor with --project and --token. Tokens are shown once and stored only as hashes.
callbackdesk doctor http://localhost:3000/api/mpesa/callback --project prj_... --token cbds_...
Provider URL
Use the generated HTTPS callback URL
The hosted receiver accepts provider POSTs on https://api.loremipsum.co.ke/c/<slug>/<token>. The token is part of the anonymous session security model, so treat generated URLs as sensitive.
Evidence
Inspect, export, and replay
The inbox shows redacted body and headers, normalized fields, delivery attempts, status codes, and replay commands. The CLI can also export JSON evidence for the current session.
callbackdesk evidence