QRs

Create QR

Create a static or dynamic QR code

post/v1/aggregators/{raast-aggregator-id}/qrs

Request

  • Base URL: https://api.getsafepay.com/raastwire
  • URL: https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/qrs
  • Auth: API key in header X-SFPY-AGGREGATOR-SECRET-KEY

Request body

typestring required

QR code type to create; accepts STATIC or DYNAMIC

aggregator_merchant_identifierstring required

Identifier of the aggregator merchant the QR code belongs to

request_idstring uuid

Client-supplied idempotency key. Must be a UUID v4 (exactly 36 characters with hyphens). Required for DYNAMIC QR codes.

order_idstring

Merchant-supplied order reference for dynamic QR codes

amountinteger

Optional amount to embed in the QR code for dynamic payments

expiry_in_minutesinteger

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

Example request

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response

This response contains details of a QR Code

api_versionstring

The current version of the API spec

Example response

{
  "api_version": "v1"
}

Changes

No recorded changes to this operation across all 1 revision of this API.