Skip to main content

Coupon QR Code

Create a QR code for a discount coupon or promotion.

Type Identifier

type: "coupon"

Fields

FieldTypeRequiredDescription
typestringRequiredMust be "coupon"
titlestringRequiredCoupon title
descriptionstringOptionalCoupon description
coupon_codestringOptionalThe coupon/discount code
valid_untilstringOptionalExpiration date (YYYY-MM-DD)
company_namestringOptionalCompany name
sales_badgestringOptionalSales badge text (e.g., "50% OFF")
termsstringOptionalTerms and conditions
button_titlestringOptionalCTA button text
button_urlstringOptionalCTA button URL

Use Cases

  • Retail promotions — Drive in-store and online sales
  • Restaurant deals — Share meal deals and discounts
  • Seasonal sales — Promote limited-time offers
  • Loyalty programs — Reward returning customers

Content Schema

{
"type": "coupon",
"title": "Summer Sale",
"description": "Get 50% off all summer items",
"coupon_code": "SUMMER50",
"valid_until": "2026-08-31",
"company_name": "Acme Store",
"sales_badge": "50% OFF",
"terms": "Valid on summer collection only. Cannot be combined with other offers.",
"button_title": "Shop Now",
"button_url": "https://shop.example.com/summer-sale"
}

Example Request

curl -X POST "https://integration-api.qr-build.com/qr-codes" \
-H "X-API-Key: qrb_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Sale Coupon",
"type": "coupon",
"content": {
"type": "coupon",
"title": "Summer Sale",
"description": "Get 50% off all summer items",
"coupon_code": "SUMMER50",
"valid_until": "2026-08-31",
"company_name": "Acme Store",
"sales_badge": "50% OFF",
"button_title": "Shop Now",
"button_url": "https://shop.example.com/summer-sale"
}
}'