Developers
Developer Portal
Everything you need to integrate KeyBS Pay — from first API key to production payouts across 190+ countries.
Getting Started
- 1. Request access. Complete KYB onboarding through our sales team. Approved businesses receive dashboard access with a developer role.
- 2. Generate API keys. Create sandbox and production Bearer tokens from the dashboard. Keys are scoped per environment and can be rotated at any time.
- 3. Build against sandbox. Integrate /v1/quotes, /v1/payouts and /v1/beneficiaries against the sandbox with simulated settlement — no real funds move.
- 4. Configure webhooks. Register HMAC-signed webhook endpoints for payout lifecycle events before going live.
- 5. Go live. Pass the go-live checklist (idempotency, webhook verification, error handling) and switch your base URL to production.
Resources
- API Documentation — endpoints, request/response shapes and auth.
- Webhooks — event catalogue, signatures and retry policy.
- Sandbox — test environment behaviour and simulated outcomes.
- Status Page — live platform component status.
- Changelog — API and product release notes.
What Teams Build With The API
Most integrations fall into three patterns: payout automation (ERP or back-office systems triggering supplier and payroll disbursements), marketplace disbursements (platforms paying sellers and service providers across corridors), and treasury workflows (locking FX quotes programmatically and reconciling settlements against webhook events). The same API surface serves all three — the difference is which endpoints your integration leans on.
Frequently Asked Questions
- Do I need to be an approved customer before I get keys? Yes — API keys are issued after KYB onboarding. Sandbox keys arrive with approval, so your build can start before any production payment is made.
- How does authentication work? Bearer tokens scoped per environment. Production and sandbox keys are independent, and either can be rotated from the dashboard without affecting the other.
- What is the difference between sandbox and production keys? Sandbox keys hit the simulated environment — same endpoints and error codes, no real money movement. Production keys move real funds and require the go-live checklist to be complete.
- Where do I find request and response schemas? The API documentation covers endpoints, payloads, idempotency and error handling, with the webhooks page detailing the event catalogue.
Support
Integration support is available at info@keybs.io. Enterprise plans include a dedicated integration engineer and a shared Slack channel.