--- title: "Changes to Refund reward purchase" method: POST path: "/v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund" --- # Changes to Refund reward purchase `POST /v2/loyalties/programs/{programId}/rewards/purchases/{rewardTransactionId}/refund` > Every recorded change to this operation, newest first. ## Timeline Changed in 16 of 211 revisions. - **2026-10-14** (v2) `d29b33490051`: 1 breaking, 13 warning, 1 info - **2026-10-14** (v2) `be14b3318eb3`: 1 breaking, 14 info - **2026-10-14** (v2) `6a418ac8b7b1`: 4 breaking, 1 warning, 1 info - **2026-10-13** (v2) `f95b50556c93`: 1 warning, 5 info - **2026-10-13** (v2) `9905dfce1d1e`: 4 breaking, 1 warning, 1 info - **2026-10-13** (v2) `c59a345c733b`: 1 warning, 5 info - **2026-10-13** (v2) `bc0850dadd24`: 4 breaking, 1 warning, 1 info - **2026-10-09** (v2) `da670ff2cbf9`: 1 breaking, 14 info - **2026-10-08** (v2) `bdf2b9f36c97`: 1 info - **2026-10-07** (v2) `338a5e34004e`: 2 info - **2026-09-02** (v2) `e52bdb3dd876`: 2 warning, 11 info - **2026-09-02** (v2) `a972e3958604`: 2 breaking, 2 info - **2026-09-02** (v2) `ffbad3d9b5e0`: 2 warning, 2 info - **2026-07-31** (v2) `703a0a42ea43`: 2 breaking, 13 info - **2026-07-17** (v2) `4cbaee5a82d5`: 8 info - **2026-07-06** (v2) `341403eb19e5`: 1 info ## Changes - **2026-10-14** (v2) `d29b33490051`: 1 breaking, 13 warning, 1 info - the `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction` response's property type changed from `object` to no type for status `202` - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/card_definition_id` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/card_id` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/card_transaction_id` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/created_at` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/details` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/id` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/member_id` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/object` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/program_id` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/reward_id` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/status` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/type` from the response with the `202` status - removed the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/updated_at` from the response with the `202` status - added `#/components/schemas/MemberCardTransactionBase, subschema #2` to the `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction` response property `allOf` list for the response status `202` - **2026-10-14** (v2) `be14b3318eb3`: 1 breaking, 14 info - the `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction` response's property type changed from no type to `object` for status `202` - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/card_definition_id` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/card_id` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/card_transaction_id` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/created_at` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/details` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/id` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/member_id` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/object` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/program_id` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/reward_id` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/status` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/type` to the response with the `202` status - added the optional property `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction/updated_at` to the response with the `202` status - removed `#/components/schemas/MemberCardTransactionBase, subschema #2` from the `allOf[#/components/schemas/RewardPurchaseRefundResult]/transaction` response property `allOf` list for the response status `202` - **2026-10-14** (v2) `6a418ac8b7b1`: 4 breaking, 1 warning, 1 info - added `#/components/schemas/RewardPurchaseRefundRequest` to the request body `allOf` list - removed the required property `message` from the response with the `202` status - removed the required property `status` from the response with the `202` status - removed the required property `transaction` from the response with the `202` status - removed the request property `policies` - added `#/components/schemas/RewardPurchaseRefundResult` to the response body `allOf` list for the response status `202` - **2026-10-13** (v2) `f95b50556c93`: 1 warning, 5 info - removed `#/components/schemas/RewardPurchaseRefundRequest` from the request body `allOf` list - added the new optional request property `policies` - removed `#/components/schemas/RewardPurchaseRefundResult` from the response body `allOf` list for the response status `202` - added the required property `message` to the response with the `202` status - added the required property `status` to the response with the `202` status - added the required property `transaction` to the response with the `202` status - **2026-10-13** (v2) `9905dfce1d1e`: 4 breaking, 1 warning, 1 info - added `#/components/schemas/RewardPurchaseRefundRequest` to the request body `allOf` list - removed the required property `message` from the response with the `202` status - removed the required property `status` from the response with the `202` status - removed the required property `transaction` from the response with the `202` status - removed the request property `policies` - added `#/components/schemas/RewardPurchaseRefundResult` to the response body `allOf` list for the response status `202` - **2026-10-13** (v2) `c59a345c733b`: 1 warning, 5 info - removed `#/components/schemas/RewardPurchaseRefundRequest` from the request body `allOf` list - added the new optional request property `policies` - removed `#/components/schemas/RewardPurchaseRefundResult` from the response body `allOf` list for the response status `202` - added the required property `message` to the response with the `202` status - added the required property `status` to the response with the `202` status - added the required property `transaction` to the response with the `202` status - **2026-10-13** (v2) `bc0850dadd24`: 4 breaking, 1 warning, 1 info - added `#/components/schemas/RewardPurchaseRefundRequest` to the request body `allOf` list - removed the required property `message` from the response with the `202` status - removed the required property `status` from the response with the `202` status - removed the required property `transaction` from the response with the `202` status - removed the request property `policies` - added `#/components/schemas/RewardPurchaseRefundResult` to the response body `allOf` list for the response status `202` - **2026-10-09** (v2) `da670ff2cbf9`: 1 breaking, 14 info - the `transaction` response's property type changed from no type to `object` for status `202` - added the optional property `transaction/card_definition_id` to the response with the `202` status - added the optional property `transaction/card_id` to the response with the `202` status - added the optional property `transaction/card_transaction_id` to the response with the `202` status - added the optional property `transaction/created_at` to the response with the `202` status - added the optional property `transaction/details` to the response with the `202` status - added the optional property `transaction/id` to the response with the `202` status - added the optional property `transaction/member_id` to the response with the `202` status - added the optional property `transaction/object` to the response with the `202` status - added the optional property `transaction/program_id` to the response with the `202` status - added the optional property `transaction/reward_id` to the response with the `202` status - added the optional property `transaction/status` to the response with the `202` status - added the optional property `transaction/type` to the response with the `202` status - added the optional property `transaction/updated_at` to the response with the `202` status - removed `#/components/schemas/RewardPurchaseTransaction, subschema #2` from the `transaction` response property `oneOf` list for the response status `202` - **2026-10-08** (v2) `bdf2b9f36c97`: 1 info - added the optional property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/card_definition_id` to the response with the `202` status - **2026-10-07** (v2) `338a5e34004e`: 2 info - the endpoint scheme security `X-App-Id AND X-App-Token` was added to the API - the endpoint scheme security `bearerAuth` was added to the API - **2026-09-02** (v2) `e52bdb3dd876`: 2 warning, 11 info - deleted the `path` request parameter `programId` - deleted the `path` request parameter `rewardTransactionId` - added the non-success response with the status `423` - removed the non-success response with the status `409` - the response property `message` became required for the status `202` - the response property `status` became required for the status `202` - the response property `transaction` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[subschema #2: Refund details]/metadata` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[subschema #2: Refund details]/points` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[subschema #2: Refund details]/purchase` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[subschema #2: Refund details]/reason` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[subschema #2: Refund details]/rejection` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[subschema #2: Refund details]/result` became required for the status `202` - **2026-09-02** (v2) `a972e3958604`: 2 breaking, 2 info - added the new path request parameter `programId` - added the new path request parameter `rewardTransactionId` - added the non-success response with the status `400` - removed the non-success response with the status `423` - **2026-09-02** (v2) `ffbad3d9b5e0`: 2 warning, 2 info - deleted the `path` request parameter `programId` - deleted the `path` request parameter `rewardTransactionId` - added the non-success response with the status `423` - removed the non-success response with the status `400` - **2026-07-31** (v2) `703a0a42ea43`: 2 breaking, 13 info - the `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/rejection/oneOf[#/components/schemas/RewardPurchaseRejection]/details` response's property type changed from `string` to `object` for status `202` - the `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsRefund -> subschema #2: Refund details]/rejection/oneOf[#/components/schemas/RewardPurchaseRejection]/details` response's property type changed from `string` to `object` for status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/metadata` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/points` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/points/oneOf[#/components/schemas/RewardPurchasePoints]/total` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/reason` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/rejection` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/rejection/oneOf[#/components/schemas/RewardPurchaseRejection]/reason` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/result` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsRefund -> subschema #2: Refund details]/points/oneOf[#/components/schemas/RewardPurchasePoints]/total` became required for the status `202` - the response property `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsRefund -> subschema #2: Refund details]/rejection/oneOf[#/components/schemas/RewardPurchaseRejection]/reason` became required for the status `202` - removed the `CREDITS_SUBTRACTED` enum value from the `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/result/oneOf[#/components/schemas/RewardPurchaseResult]/digital/oneOf[#/components/schemas/RewardPurchaseResultDigital]/discount_coupons/items/result` response property for the response status `202` - removed the `CREDITS_SUBTRACTED` enum value from the `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsRefund -> subschema #2: Refund details]/result/oneOf[#/components/schemas/RewardPurchaseResult]/digital/oneOf[#/components/schemas/RewardPurchaseResultDigital]/discount_coupons/items/result` response property for the response status `202` - removed the `DELETED` enum value from the `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsPurchase -> subschema #1: Purchase details]/result/oneOf[#/components/schemas/RewardPurchaseResult]/digital/oneOf[#/components/schemas/RewardPurchaseResultDigital]/gift_vouchers/items/result` response property for the response status `202` - removed the `DELETED` enum value from the `transaction/oneOf[#/components/schemas/RewardPurchaseTransaction]/details/oneOf[#/components/schemas/RewardPurchaseTransactionDetailsRefund -> subschema #2: Refund details]/result/oneOf[#/components/schemas/RewardPurchaseResult]/digital/oneOf[#/components/schemas/RewardPurchaseResultDigital]/gift_vouchers/items/result` response property for the response status `202` - **2026-07-17** (v2) `4cbaee5a82d5`: 8 info - added the optional property `resource_id` to the response with the `400` status - added the optional property `resource_id` to the response with the `404` status - added the optional property `resource_id` to the response with the `409` status - added the optional property `resource_id` to the response with the `500` status - added the optional property `resource_type` to the response with the `400` status - added the optional property `resource_type` to the response with the `404` status - added the optional property `resource_type` to the response with the `409` status - added the optional property `resource_type` to the response with the `500` status - **2026-07-06** (v2) `341403eb19e5`: 1 info - endpoint added --- [Operation](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/docs/v2/loyalties/programs/:programId/rewards/purchases/:rewardTransactionId/refund/post.md) - [API](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api.md) - [Page](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/changes/v2/loyalties/programs/:programId/rewards/purchases/:rewardTransactionId/refund/post)