--- title: "Refund a reward purchase" method: POST path: "/v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund" tags: ["Programs"] --- # Refund a reward purchase `POST /v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund` BETA endpoint 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](https://www.voucherify.io/contact-support) or your Technical Account Manager. 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`. ## Path parameters - `programId` string, required - `rewardTransactionId` string, required ## Request body - RewardPurchaseRefundRequest — Request body for refunding a reward purchase. May be empty; defaults are applied. - `policies` RewardPurchaseRefundPolicies — Refund policies for a reward purchase refund. - `refund` 'DEFAULT' | 'ALLOW' — Refund policy. `DEFAULT` applies the standard refund rules; `ALLOW` forces the refund to be allowed. Defaults to `DEFAULT`. - `stock` 'DEFAULT' | 'WRITE_OFF' — Stock policy. `DEFAULT` returns the purchased quantity to the reward stock; `WRITE_OFF` does not return it. Defaults to `DEFAULT`. ## Response `202` Refund accepted. The refund reward transaction has been created with status APPROVED and points will be returned to the member's card asynchronously. - RewardPurchaseRefundResponse — Result of a reward refund request. - `transaction` RewardPurchaseTransaction — A reward transaction. Represents a reward purchase or a reward refund. - `id` string — Unique reward transaction identifier (format `lrtx_...`). Absent for DRY_RUN (SIMULATED) transactions, which are never persisted. - `card_id` string — Identifier of the loyalty card the points were spent from (format `lcrd_...`). - `card_transaction_id` unknown - `program_id` string — Identifier of the loyalty program (format `lprg_...`). - `member_id` string — Identifier of the program member (format `lmbr_...`). - `reward_id` string — Identifier of the purchased reward (format `lrew_...`). - `status` 'PENDING' | 'PROCESSING' | 'APPROVED' | 'REJECTED' | 'SIMULATED' | 'REFUNDED' — Transaction status. `PENDING` — created, awaiting processing; `PROCESSING` — being processed; `APPROVED` — completed successfully; `REJECTED` — rejected (see `details.rejection`); `SIMULATED` — dry-run result, not persisted; `REFUNDED` — purchase has been refunded. - `type` 'PURCHASE' | 'REFUND' — Transaction type. - `details` union — Transaction details. Shape depends on `type` — purchase details for `PURCHASE`, refund details for `REFUND`. - RewardPurchaseTransactionDetailsPurchase — Details of a PURCHASE reward transaction. - `reason` string — Human-readable reason. For purchases: "Points spent on reward". - `rejection` RewardPurchaseRejection — Rejection details. - `reason` string — Machine-readable rejection reason. - `details` string — Additional human-readable details about the rejection. - `metadata` object — Transaction metadata. Empty object when not set. - `points` RewardPurchasePoints — Points involved in the transaction. - `total` number — Total number of points. - `result` RewardPurchaseResult — Reward fulfillment result. Contains the fulfilled reward reference, quantity and the material or digital fulfillment payload. - `reward` RewardPurchaseResultReward — Reference to the fulfilled reward. - `id` string — Reward identifier (format `lrew_...`). - `type` 'MATERIAL' | 'DIGITAL' — Reward type. - `quantity` unknown - `material` RewardPurchaseResultMaterial — Material reward fulfillment. - `type` 'PRODUCT' | 'SKU' — Material reward type. - `product` object — Product payload (present when `type` is `PRODUCT`). - `sku` object — SKU payload (present when `type` is `SKU`). - `digital` RewardPurchaseResultDigital — Digital reward fulfillment. - `type` 'DISCOUNT_COUPONS' | 'GIFT_VOUCHERS' | 'LOYALTY_CARD_POINTS' — Digital reward type. - `discount_coupons` RewardPurchaseDigitalCoupon[] — Fulfilled discount coupons (present when `type` is `DISCOUNT_COUPONS`). - … - `gift_vouchers` RewardPurchaseDigitalGiftVoucher[] — Fulfilled gift vouchers (present when `type` is `GIFT_VOUCHERS`). - … - `loyalty_card_points` RewardPurchaseDigitalLoyaltyCardPoints — Loyalty card points fulfillment entry. - … - RewardPurchaseTransactionDetailsRefund — Details of a REFUND reward transaction. - `reason` string — Human-readable reason, e.g. "Reward refund — point purchase reversed". - `rejection` RewardPurchaseRejection — Rejection details. - `reason` string — Machine-readable rejection reason. - `details` string — Additional human-readable details about the rejection. - `metadata` object — Transaction metadata. Empty object when not set. - `points` RewardPurchasePoints — Points involved in the transaction. - `total` number — Total number of points. - `result` RewardPurchaseResult — Reward fulfillment result. Contains the fulfilled reward reference, quantity and the material or digital fulfillment payload. - `reward` RewardPurchaseResultReward — Reference to the fulfilled reward. - `id` string — Reward identifier (format `lrew_...`). - `type` 'MATERIAL' | 'DIGITAL' — Reward type. - `quantity` unknown - `material` RewardPurchaseResultMaterial — Material reward fulfillment. - `type` 'PRODUCT' | 'SKU' — Material reward type. - `product` object — Product payload (present when `type` is `PRODUCT`). - `sku` object — SKU payload (present when `type` is `SKU`). - `digital` RewardPurchaseResultDigital — Digital reward fulfillment. - `type` 'DISCOUNT_COUPONS' | 'GIFT_VOUCHERS' | 'LOYALTY_CARD_POINTS' — Digital reward type. - `discount_coupons` RewardPurchaseDigitalCoupon[] — Fulfilled discount coupons (present when `type` is `DISCOUNT_COUPONS`). - … - `gift_vouchers` RewardPurchaseDigitalGiftVoucher[] — Fulfilled gift vouchers (present when `type` is `GIFT_VOUCHERS`). - … - `loyalty_card_points` RewardPurchaseDigitalLoyaltyCardPoints — Loyalty card points fulfillment entry. - … - `purchase` RewardPurchaseRefundPurchaseReference — References to the original purchase transactions being refunded. - `card_transaction` object — Reference to the original card transaction. - `id` string — Card transaction identifier (format `lctx_...`). - `reward_transaction` object — Reference to the original reward transaction. - `id` string — Reward transaction identifier (format `lrtx_...`). - `created_at` string, date-time — Timestamp when the transaction was created (ISO 8601). - `updated_at` string, date-time — Timestamp when the transaction was last updated (ISO 8601), or `null`. - `object` string — Object type marker. Always `reward_transaction`. - `status` 'APPROVED' — Result status. Always `APPROVED` on success. - `message` string — Human-readable result message: "Reward refund transaction created. Points will be returned to the member's card shortly.". ## Other responses - `400` — Validation error - request body or query parameters failed validation, or the operation is not allowed in the current resource state. - `404` — Resource not found. - `409` — Conflict - e.g. duplicate resource or invalid state transition. - `500` — Internal server error. --- [API](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/revisions/4982266e0494?raw)