v1

latestOpenAPI 3.0.1MIT2026-07-263151,3912.3 MB

Programs

Refund a reward purchase

<Badge color="yellow">BETA endpoint</Badge>

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

</Warning>

Refunds a previously approved reward purchase transaction. Creates a REFUND-type reward transaction and schedules the return of the spent points to the member's card ("Reward refund transaction created. Points will be returned to the member's card shortly.").

The refunded purchase transaction must be of type PURCHASE and in APPROVED status, otherwise the request is rejected with a conflict error.

The request body is optional (an empty payload is allowed). When omitted, default policies are applied: refund: DEFAULT, stock: DEFAULT.

post/v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund

Path parameters

programIdstring required

Unique loyalty program identifier (format: lprg_ followed by hexadecimal characters).

rewardTransactionIdstring required

Unique reward transaction identifier of the purchase to refund (format: lrtx_ followed by hexadecimal characters).

Request body

Response

Refund accepted. The refund reward transaction has been created with status APPROVED and points will be returned to the member's card asynchronously.

status'APPROVED'

Result status. Always APPROVED on success.

messagestring

Human-readable result message: "Reward refund transaction created. Points will be returned to the member's card shortly.".