Integration checklist
Marketplace inputs and Priizy outputs
Marketplace → Priizy
What marketplace sends
- marketplace_id
- buyer_ref
- cart_ref / order_ref
- cart items
- merchant / category context
- order confirmation event
- refund / cancellation event
Priizy → Marketplace
What Priizy returns
- usable incentive value
- eligibility result (usable vs blocked)
- Priizy wallet (demo)
- lock status (reservation)
- checkout outcome (use / release / reverse)
- metrics / evidence for pilot review
What happens after checkout starts
API names with plain-language labels used in guided flows:
summary = calculate
Priizy checks which incentive value is safe to use at checkout.
reserve = lock
Value is locked before payment finishes.
redeem = use
Locked value is consumed when the order confirms.
void = release
Locked value is released if checkout fails or is cancelled.
refund = reverse
Used value is reversed when a refund applies (policy-dependent).
Checkout failures and refunds can be checked later in an assisted pilot.
Next step
When you are ready to discuss integration scope, request an assisted pilot conversation — not automatic production access.