Raast integration journey

End-to-end flow from aggregator onboarding to accepting payments and payouts.

Use this journey as your checklist. It strings together the core concepts, guides, and API calls you need to enable Safepay Raast for your business.

Prerequisites

• {{aggregator_id}} issued by Safepay
• {{secret_key}} for the target environment
• Base URL set to https://dev.api.getsafepay.com/raastwire (sandbox) or https://api.getsafepay.com/raastwire (production)

Integration checklist

1. Get aggregator access

   Request access, receive your aggregator, and secure the first {{secret_key}}.

2. Create aggregator merchants

   Link each business you serve to a Raast merchant when creating an aggregator merchant.

3. Complete KYC/KYB

   Safepay validates documentation. Expect same-day approval when the Raast merchant is already onboarded; otherwise provide additional paperwork.

4. Enable payment initiation

   Choose your payment type and follow the respective use case.

5. Subscribe to webhooks

   Create webhook endpoints and verify signatures to receive asynchronous status updates.

6. 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.

See also

• Quickstart
• Payment lifecycle guide
• Payout lifecycle
• Webhooks delivery
• API reference