Create a code batch
Creates a batch of up to 32,768 unique single-use codes per batch (create multiple batches for larger runs) to print on physical products. Creation is instant — codes are derived from a per-batch cryptographic secret, not stored — and you are only charged the per-transaction fee when a code is actually redeemed by a customer in the Rigaly app.
Download the codes with the export endpoint. example_code shows the
exact print format ([PREFIX-]XXXX-XXX-XXX-XXX), and
example_deep_link the recommended QR payload — print each code’s
deep_link as a QR code so scanning it opens the Rigaly app with the
code ready to claim (or an install page when the app is missing).
Authorizations
API key from the Rigaly dashboard: Authorization: Bearer rgly_sk_...
Body
100"Summer 2027 bottles"
Points each code awards when claimed
x >= 1250
1 <= x <= 3276830000
"2027-12-31T23:59:59Z"
Cosmetic print prefix
^[A-Z0-9]{1,10}$"SUMMER"