SUMWARE VoucherIntegration documentation

Voucher payments, customer-bound flows, and refund settlement for POS, eCom, and CRM.

POS (trusted)

Store-bound JWT, full redemption scope set. The till sells, redeems, and refunds without an HQ round-trip.

Build a POS integration

Internet-facing — PIN required, no load, tighter buckets. Plan for the next request to be hostile.

Build an eCom integration

Separate plane for customer + card sync and bound-voucher lifecycle. A leaked CRM token cannot drain a voucher.

Build a CRM integration

Five public-plane endpoints — token, check, load, redeem, refund — cover every redemption integration.

Every mutating call carries Idempotency-Key — a retry of the same key on the same voucher returns the original result and never acts twice.

Every balance change is one transaction with a per-voucher ledger entry and a tamper-evident audit row. Double-spend-safe under concurrency.