Skip to main content
POST
/
v1
/
aggregators
/
{raast-aggregator-id}
/
qrs
curl --request POST \
  --url https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/qrs \
  --header 'Content-Type: application/json' \
  --header 'X-SFPY-AGGREGATOR-SECRET-KEY: <api-key>' \
  --data '
{
  "type": "STATIC",
  "aggregator_merchant_identifier": "am_749fe6ce-91f9-4f6a-9df2-ec6ae9f75a30"
}
'
{
  "api_version": "v1",
  "data": {
    "id": "4",
    "token": "qr_4076ad61-75cf-44a3-97a1-b66643ea3bf2",
    "aggregator_merchant_id": "am_be454a50-7612-4dc6-a97e-284ebbe7ae93",
    "type": "DYNAMIC",
    "code": "0002010102122876003285bc899c1dd443e3b3beb24631aef0930108SAFEPAYZ0224PK08ALFH00050010086764445207343434353035865406100.005802PK5921Timeless Designs Code6006Lahore62130509order12348476003285bc899c1dd443e3b3beb24631aef09301367b165d5f-01df-4bfe-81b4-bef010df9",
    "terminal_label": "",
    "reference_label": "",
    "is_deleted": false,
    "created_at": "2025-04-28T10:26:48Z"
  }
}

Authorizations

​
X-SFPY-AGGREGATOR-SECRET-KEY
string
header
required

Path Parameters

​
raast-aggregator-id
string
required

The unique identifier for the aggregator

Example:

"agg_2288490a-2176-4de5-b373-0ffb6f8e2e6e"

Body

application/json

Request to create a dynamic or static QR code

Parameters accepted when generating a QR code

​
type
string
required

QR code type to create; accepts STATIC or DYNAMIC

​
aggregator_merchant_identifier
string
required

Identifier of the aggregator merchant the QR code belongs to

​
request_id
string

Optional idempotency key provided by the client

​
order_id
string

Merchant-supplied order reference for dynamic QR codes

​
amount
integer

Optional amount to embed in the QR code for dynamic payments

​
expiry_in_minutes
integer

Optional expiry window in minutes for dynamic QR codes; defaults to 180 when omitted

Response

200 - application/json

This response contains details of a QR Code

Standard response structure for successful operations

​
api_version
string

The current version of the API spec

Example:

"v1"

​
data
object

Contains the response data