Introduction

Learn how Safepay Raast works and what you need to start integrating.

Raast is Pakistan’s instant payment network operated by the State Bank of Pakistan. Safepay Raast gives you an aggregator-grade API to onboard merchants, initiate payments, and move funds between bank accounts and mobile wallets.

Payment types you can support

1. RTP Now - Request a payment the customer approves immediately.
2. RTP Later - Request a payment that the customer can approve later.
3. Dynamic QR - Generate a per-transaction QR with a known amount.
4. Static QR - Use a reusable QR where the customer enters the amount.

How Safepay fits

• Aggregator model - You create aggregator merchants and link them to Raast merchants.
• Payments and payouts - Initiate RTP and QR payments, and send payouts with the same credentials.
• Operational tooling - Manage access keys, refunds, webhooks, and ledgers through APIs.

Integration path

1. Request aggregator access

   Follow Create aggregator account to receive your {{aggregator_id}}.

2. Secure your secret key

   Store the {{secret_key}} and authenticate with X-SFPY-AGGREGATOR-SECRET-KEY.

3. Create and link merchants

   Create aggregator merchants and link them to Raast merchants.

4. Choose a payment flow

   Implement the right payment type for your use case.

5. Subscribe to webhooks

   Use webhooks to receive status updates and settlements.

Environments and base URLs

Environment	Base URL	Notes
Sandbox	https://dev.api.getsafepay.com/raastwire	Use for integration testing.
Production	https://api.getsafepay.com/raastwire	Live traffic and real money movement.

All API paths are prefixed with /v1/aggregators/{{aggregator_id}}/....

See also

• Quickstart
• Create aggregator account
• Manage aggregator secret keys
• Payment types
• Webhooks