Skip to content

Integrate Keshless payments ​

Accept payments with safe retries, check status, issue refunds, receive signed webhook events, and retrieve merchant balances and history.

Sandbox access ​

Use this isolated environment for developer testing. Send sandbox API requests to:

text
https://sandbox-api.keshless.com

Request developer access. After administrator approval, create your test key; your workspace receives simulated merchant funds once. Keep the integration key in your server's secret store and send it as X-API-Key. All endpoint paths in this guide include /api.

Integration flow ​

  1. Confirm sandbox access and provision your isolated test customers.
  2. Save a unique retry key and request body for each payment; surface the API's errors.
  3. Confirm results using status lookups and signed webhook events.
  4. Test duplicate requests, low-value PIN requirements, failed delivery retries, and refunds.
  5. Request separate live credentials after testing; keep test and live configuration separate.

Moving to production ​

Existing integrations keep their current connection settings. The isolated sandbox is for new development and test funds only. Contact Keshless to arrange live activation and separate credentials after testing.

Do not use live credentials in the sandbox. Test balances, transactions and webhook events are never promoted into live operations. See the sandbox guide.

See the quick start and payment reference.

Keshless payment integration documentation