Static QR payment

Generate a reusable QR code tied to a Raast merchant.

Static QR codes are reusable. They identify your aggregator merchant but leave amount and payer details open, making them ideal for countertop displays and printed invoices.

Prerequisites

• {{aggregator_id}} and {{secret_key}}
• aggregator_merchant_identifier for the merchant collecting funds

Flow summary

1. Load merchant identifiers

   Retrieve the aggregator_merchant_identifier from the merchant creation response.

2. Create the static QR

   Call POST /v1/aggregators/{{aggregator_id}}/qrs with type: STATIC.

3. Render and share

   Render the returned data.code and distribute it digitally or physically.

4. Reconcile payments

   Match webhook payloads or list QR payments to reconcile each payment.

Set {{base_url}} to https://dev.api.getsafepay.com/raastwire in Sandbox or https://api.getsafepay.com/raastwire in Production.

Static QR

Request Fields

type · string · required

Set to STATIC for reusable codes.

aggregator_merchant_identifier · string · required

Token returned from merchant creation (data.token).

request_id · string

Recommended to prevent duplicate QR creation on retries.

API Example

cURL

curl --request POST "{{base_url}}/v1/aggregators/{{aggregator_id}}/qrs" \
  --header "X-SFPY-AGGREGATOR-SECRET-KEY: {{secret_key}}" \
  --header "Content-Type: application/json" \
  --data '{
    "type": "STATIC",
    "aggregator_merchant_identifier": "{{aggregator_merchant_identifier}}",
    "request_id": "{{request_id}}"
  }'

Sample Response

{
  "api_version": "v1",
  "data": {
    "token": "qr_4076ad61-75cf-44a3-97a1-b66643ea3bf2",
    "aggregator_merchant_id": "am_be454a50-7612-4dc6-a97e-284ebbe7ae93",
    "type": "STATIC",
    "code": "000201010211...",
    "created_at": "2025-04-28T10:26:48Z"
  }
}

Rendering tips

• Feed data.code to any QR generation library (qrcode.react, qr-image, etc.).
• Print the QR with usage instructions or embed it in digital invoices.
• Use GET /v1/aggregators/{{aggregator_id}}/qrs/{{qr_id}}/payments to list transactions tied to this QR.

Webhook events to expect

• payment.created
• payment.completed
• payment.settled
• payment.failed
• payment.rejected

See also

• Payment lifecycle guide
• QR codes
• Webhooks delivery
• Pagination
• Create QR