First API call

Verify your credentials with a simple read request.

Use this page to confirm your {{aggregator_id}} and {{secret_key}} before building payment flows.

Choose your environment

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.

Make the request

1. Set your credentials

   Store {{secret_key}} in a server-side secret manager. Use {{base_url}} for the environment you are calling.

2. Call the aggregator endpoint

   Send a GET request to /v1/aggregators/{{aggregator_id}} with the X-SFPY-AGGREGATOR-SECRET-KEY header.

3. Verify the response

   A successful call returns aggregator metadata and confirms your credentials are valid.

cURL

curl --request GET "{{base_url}}/v1/aggregators/{{aggregator_id}}" \
  --header "X-SFPY-AGGREGATOR-SECRET-KEY: {{secret_key}}"

Expected response

A successful response (status 201) includes your aggregator metadata.

{
  "api_version": "v1",
  "data": {
    "token": "{{aggregator_id}}",
    "name": "Example Aggregator",
    "is_active": true
  }
}

Never expose {{secret_key}} in client-side apps. Always call the API from a secure backend.

See also

• Quickstart
• Manage aggregator secret keys
• Aggregator
• Errors
• API reference