API version v1

PrizeNest Developer Documentation

Signed server-to-server purchase and refund events for approved partners. API keys stay separate in the partner dashboard.

Manage API Keys

Webhooks

Inbound partner events are implemented. Partner outbound webhooks are not public yet.

PrizeNest currently accepts inbound signed purchase and refund events from partner servers. The schema contains outbound webhook endpoint and delivery models, but the partner-facing configuration, payload contract, signature contract, retry policy, and delivery worker are not exposed as a complete public webhook product.

Inbound event names recorded

purchase.test

A TEST purchase validated and recorded without live ledger effects.

purchase.processed

A LIVE purchase was accepted and reward processing completed.

purchase.identifier_conflict

Submitted email and phone matched different eligible customer accounts.

purchase.failed

A purchase reached processing and then failed with a Partner API error.

refund.test

A TEST refund validated and recorded without live ledger effects.

refund.processed

A LIVE refund cancelled a pending or awaiting-funding reward.

refund.review_required

A refund arrived after points were already available.

refund.failed

A refund reached processing and then failed with a Partner API error.