Documentation contents

Integration guide

Identify a card in your POS

Send the complete scanned code to POST /cards/resolve. The response includes card_id, program_version_id and currency, without contact data.

  • Use the full barcode or the exact public card code; do not convert it into a UUID.
  • The key needs checkouts:write and access to the supplied location.
  • Inactive, test and other-business cards return 404.
  • This lookup does not require Idempotency-Key. Keep your POS customer mapping in your own system.