Voucher workflow

After a voucher is reserved by calling the "reserve-voucher-by-value" of "reserve-voucher-by-price" endpoint, the voucher starts an asynchronous workflow, described below.

Voucher status :

  • RESERVED: A voucher object with a unique ID is generated inside the Jackpot database, but no voucher code has been purchased from the store yet
  • CONFIRMED: You have definitively confirmed a reserved voucher, the voucher price has to be paid to Jackpot
  • READY: Voucher has been edited and the coupon PDF file is ready
  • CANCELED: You have rejected a reserved voucher
  • SENT: The voucher including the URL to the PDF has been successfully sent to you via the webhook
  • REFUNDEED: You have successfully asked to cancel a confirmed voucher (only the store can accept or denied a cancellation of confirmed or sent vouchers)

Focus on the confirmation step

By default, you have to confirm every reserved voucher calling PUT /v2/voucher/{voucherId}/confirm (or manually through the backoffice section "Coupons à confirmer").

The confirmation is definitive: the voucher will be edited and the voucher price has to be paid to Jackpot.

You can ask for automatic confirmation (contact the Jackpot team): all reserved vouchers will be instantly and definitively confirmed. Nevertheles, even if automatic confirmation is on, you can still require to confirm vouchers for specific sessions (fraud control, higher amounts, onboarding users etc.). You set the forceManualConfirm flag to "true" in the JWT.