Get started
Environments
Xpend separates sandbox and live completely: credentials, data, balances, payouts, and webhooks are environment-scoped.
Environment model
Xpend separates sandbox and live completely: credentials, data, balances, payouts, and webhooks are environment-scoped. Each environment ships its own keys, webhook endpoints, ledger, and balances.
Base URL and key usage
export XPEND_BASE="https://sandbox.bapi.justxpend.ai"
export XPEND_SECRET_KEY="sk_sandbox_..."Don't reuse IDs
Do not expect IDs created in sandbox to exist in live. Promote configuration, not data.
Recommended release flow
- Build and test end-to-end in sandbox.
- Create a separate live credential and live webhook endpoint.
- Confirm live key with /v1/merchant/principal.
- Run a short canary window in live with low-risk transactions first.
- Consume webhook events for status transitions.
- Confirm balance and ledger visibility in dashboards.
- Ramp traffic after webhook and reconciliation stability is confirmed.