Prerequisites
{{aggregator_id}}issued by Safepay{{secret_key}}for the target environment- Base URL set to
https://dev.api.getsafepay.com/raastwire(sandbox) orhttps://api.getsafepay.com/raastwire(production)
Integration checklist
Get aggregator access
Request access, receive your aggregator, and secure the first
{{secret_key}}.Create aggregator merchants
Link each business you serve to a Raast merchant when creating an aggregator merchant.
Complete KYC/KYB
Safepay validates documentation. Expect same-day approval when the Raast merchant is already onboarded; otherwise provide additional paperwork.
Enable payment initiation
Choose your payment type and follow the respective use case.
Subscribe to webhooks
Create webhook endpoints and verify signatures to receive asynchronous status updates.
Roll out payouts (optional)
Once pay-ins are live, add instant payouts for beneficiaries.
Merchant and Raast merchant linkage
| Scenario | Action |
|---|---|
| Raast merchant already exists in Safepay registry | Use raast_merchant_id from Raast merchants when creating your aggregator merchant. |
| New business entity | Submit documentation so Safepay can create a Raast merchant. Expect longer KYC/KYB timelines. |
A single Raast merchant can link to multiple aggregators. This lets merchants work with different platforms simultaneously.
Key API calls by stage
| Stage | Endpoint | Purpose |
|---|---|---|
| Access keys | POST /v1/aggregators/{{aggregator_id}}/keys | Create additional keys for rotation. |
| Raast merchant lookup | GET /v1/aggregators/{{aggregator_id}}/raast-merchants | Find an existing Raast merchant. |
| Merchant onboarding | POST /v1/aggregators/{{aggregator_id}}/merchants | Create an aggregator merchant. |
| RTP payments | POST /v1/aggregators/{{aggregator_id}}/payments | Initiate RTP Now or RTP Later. |
| QR payments | POST /v1/aggregators/{{aggregator_id}}/qrs | Create static or dynamic QR codes. |
| Payouts | POST /v1/aggregators/{{aggregator_id}}/payout | Send payouts to beneficiaries. |
| Webhooks | POST /v1/aggregators/{{aggregator_id}}/webhooks | Register webhook endpoints. |
Payment orchestration cheat sheet
- RTP Now - Collect once the customer approves immediately. Ideal for cashback or just-in-time payouts.
- RTP Later - Give customers more time to approve. Use when invoices can be paid hours or days later.
- Dynamic QR - Create per transaction at checkout; you know the amount but not the payer until settlement.
- Static QR - Post a reusable QR. Track incoming payments using amount and metadata.
Operational readiness
- Automate webhook retries and reconciliation dashboards.
- Use account validation utilities to prevent bad debtor or beneficiary data.
- Rotate aggregator keys using the Access Keys API before go-live.