Installation
npm install -g @useaxra/cli
Commands
Login
Save your API key for future commands:
axra login --api-key sk_test_...
~/.config/axra/credentials.json with 0600 permissions.
You can also use environment variables:
export AXRA_API_KEY=sk_test_...
export AXRA_API_BASE=https://api.useaxra.com # optional
Listen (webhook forwarding)
Forward webhook events to your local development server:
axra listen --forward-to http://localhost:3000/webhooks
Axra-Signature header intact — so you can test signature verification locally.
Trigger (test events)
Send a test webhook event to your active axra listen session:
axra trigger payment.completed
| Event | Description |
|---|
payment.completed | Successful payment |
payment.failed | Failed payment (card declined) |
treasury.payout.completed | Payout completed |
treasury.payout.failed | Payout failed |
treasury.wallet.deposit.completed | Wallet deposit received |
treasury.user.created | New end-user created |
Full workflow
# Terminal 1: start webhook listener
axra listen --forward-to http://localhost:3000/webhooks
# Terminal 2: trigger a test event
axra trigger payment.completed
# Your local server receives the event with valid signature
Use axra listen during development instead of exposing your local server with ngrok. It’s faster and doesn’t require port forwarding.
