Prepare your server
- Call the API from your backend. Keep API secrets out of browsers, mobile bundles and public repositories.
- Prepare an HTTPS callback endpoint and secure secret storage. You do not need access to RuhaPay servers.
Integration guide · Preview
A clear path from testing to live payments.
You can request early access today. The steps below describe the planned onboarding process once sandbox access is released.
- 1
Request early access
Tell us about your business and the platform you want to integrate.
- 2
Sandbox approval
Once sandbox onboarding opens, our team reviews your application before enabling test credentials.
- 3
Build and test
Integrate in an isolated test environment and verify payments, retries and callbacks.
- 4
Production approval
Submit integration results and business details for a separate live-access review.
- 5
Generate live credentials
Only after production approval can you generate credentials and use enabled live services.
Build safe payment handling
- Keep a unique order reference and reuse the same idempotency key when retrying that payment.
- A timeout is an unknown outcome. Check status before taking further action; never assume that the payment failed.
Plan for pending results
- Keep payments pending until a confirmed final result arrives. An HTTP success response alone does not prove payment success.
- Verify callback signatures, deduplicate events and use status enquiries to reconcile missed or delayed updates.
Prepare for production review
- Test success, failure, pending, timeout, duplicate submission and refund scenarios in sandbox.
- Submit your business details and integration evidence. Sandbox approval will not automatically enable production.
Exact request fields, amount formats, limits and signature rules will be documented with the released API contract.
Request early access