PLATFORM-NEUTRAL INTEGRATION

Put the promise beside the payment.

Create a receipt after the customer confirms the commercial terms, then place its verified badge on the order-status page or confirmation email.

STEP 01

Collect only the promise

Send the merchant name, public item or service scope, total price, optional deposit split, delivery range, returns window, and cancellation window. Use a non-personal order reference. Never send customer names, email addresses, postal addresses, card data, or secrets.

STEP 02

Create after agreement

Call the receipt endpoint from trusted server-side checkout code after the customer accepts the terms. Store the returned code or verification URL with the order.

STEP 03

Display the badge

The API returns ready-to-use badge HTML. Its image is generated dynamically and reports verified only while the stored receipt still matches its original fingerprint.

STEP 04

Keep it public and small

Link the badge from the order confirmation or status page. The customer can verify without an account; the receipt page quietly introduces the next merchant to OfferChecksum.

EXAMPLE REQUEST

POST /api/receipts
Content-Type: application/json

{
  "merchant": "Northstar Supply",
  "scope": "One Northstar field kit",
  "orderReference": "ORDER-1042",
  "currency": "GBP",
  "price": "400.00",
  "payment": {
    "dueNow": "100.00",
    "remaining": "300.00",
    "remainingDue": "On final proof approval, before production"
  },
  "delivery": {
    "minDays": 2,
    "maxDays": 4,
    "basis": "business"
  },
  "returns": {
    "windowDays": 30,
    "starts": "delivery",
    "returnShipping": "merchant"
  },
  "cancellation": {
    "windowHours": 24
  }
}

USE THE RETURNED LOOP

{
  "code": "OC1-…",
  "verifyUrl": "https://…/r/OC1-…",
  "badgeUrl": "https://…/badge/OC1-….svg",
  "embedHtml": "<a href=…><img src=…></a>"
}

Try the full flow before writing code.

Create a free test receipt