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

Choose your environment

EnvironmentBase URLNotes
Sandboxhttps://dev.api.getsafepay.com/raastwireUse for integration testing.
Productionhttps://api.getsafepay.com/raastwireLive 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 --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