---
title: "Changes to Refund Payment"
method: POST
path: "/payments/{id}/refund"
---

# Changes to Refund Payment

`POST /payments/{id}/refund`

> Every recorded change to this endpoint, newest first.
> 74 revisions in range; 1 not diffed.

## Timeline

Changed in 26 of 74 revisions.

- **2026-09-25** `86b97292852d` — 1 warning
- **2026-09-24** `7fcefabddb0a` — 1 warning
- **2026-09-23** `140d015b9966` — 1 breaking, 4 info
- **2026-09-17** `076176906e3f` — 1 info
- **2026-09-17** `ef86d14ef691` — 1 warning
- **2026-09-16** `ff3a76573563` — 2 info
- **2026-09-15** `c19acf2e2548` — 2 warning, 1 info
- **2026-09-09** `18cde81b6763` — 1 info
- **2026-09-09** `5fa504e78695` — 1 info
- **2026-09-05** `2fa9dfe9535a` — 5 warning
- **2026-09-04** `8473fa1d1f47` — 3 warning
- **2026-09-03** `697924df40d1` — 82 breaking, 13 warning, 35 info
- **2026-08-29** `1b5d50d09479` — 1 info
- **2026-08-28** `4da7133b2de7` — 4 warning
- **2026-08-27** `16c82685be35` — 2 warning
- **2026-08-26** `86d0a97abfe5` — 10 warning
- **2026-08-21** `715c4defcbbf` — 2 warning
- **2026-08-20** `6a23760847c8` — 1 info
- **2026-08-19** `23dfbe1a0d1f` — 4 warning
- **2026-08-18** `f67a043e3190` — 1 info
- **2026-08-11** `a01100378e59` — 1 info
- **2026-08-05** `6c970f803b46` — 3 info
- **2026-08-04** `ca841fbd6786` — 3 info
- **2026-07-31** `099fdc3be422` — 1 info
- **2026-07-26** `60bbb4a6ffbc` — 2 warning, 1 info
- **2026-07-14** `3a06a605784b` — 1 info

## Changes

- **2026-09-25** `86b97292852d` — 1 warning
  - added the new `alipayhk` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-09-24** `7fcefabddb0a` — 1 warning
  - added the new `tabby` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-09-23** `140d015b9966` — 1 breaking, 4 info
  - the response property `payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/brand` became nullable for the status `200`
  - added the required property `holds` to the response with the `200` status
  - added the required property `payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/exp_month` to the response with the `200` status
  - added the required property `payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/exp_year` to the response with the `200` status
  - added the required property `verification_checks/oneOf[#/components/schemas/PaymentVerificationChecks]/authorization_code` to the response with the `200` status
- **2026-09-17** `076176906e3f` — 1 info
  - added the required property `line_items` to the response with the `200` status
- **2026-09-17** `ef86d14ef691` — 1 warning
  - added the new `review` enum value to the `payment_rule_matches/items/action` response property for the response status `200`
- **2026-09-16** `ff3a76573563` — 2 info
  - response property `risk_signals` deprecated
  - added the required property `payment_rule_matches` to the response with the `200` status
- **2026-09-15** `c19acf2e2548` — 2 warning, 1 info
  - added the new `blocked` enum value to the `substatus` response property for the response status `200`
  - added the new `touch_n_go` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - removed the `bizum` enum value from the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-09-09** `18cde81b6763` — 1 info
  - added the required property `payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/issuer_identification_number` to the response with the `200` status
- **2026-09-09** `5fa504e78695` — 1 info
  - added the required property `recovery_url` to the response with the `200` status
- **2026-09-05** `2fa9dfe9535a` — 5 warning
  - added the new `mercado_pago_ar` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `mercado_pago_mx` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `nupay` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `opay` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `verve` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-09-04** `8473fa1d1f47` — 3 warning
  - added the new `oney` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `oney_3x` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `oney_4x` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-09-03** `697924df40d1` — 82 breaking, 13 warning, 35 info
  - added `#/components/schemas/Money, subschema #2` to the `refunded_amount` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Money, subschema #2` to the `subtotal` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Money, subschema #2` to the `tax_amount` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Money, subschema #2` to the `total` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Money, subschema #2` to the `usd_total` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PaymentAddress, subschema #2` to the `billing_address` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PaymentAddress, subschema #2` to the `shipping_address` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PaymentInstrument, subschema #2` to the `payment_instrument` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PaymentVerificationChecks, subschema #2` to the `verification_checks` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/UserSummary, subschema #2` to the `user` response property `oneOf` list for the response status `200`
  - the `amount_after_fees` response's property type changed from `number` to `object` for status `200`
  - the `billing_address` response's property type changed from `object, null` to no type for status `200`
  - the `created_at` response's property format changed from `date-time` to no format for status `200`
  - the `dispute_alerted_at` response's property format changed from `date-time` to no format for status `200`
  - the `financing_installments_count` response's property type changed from `integer, null` to `number, null` for status `200`
  - the `paid_at` response's property format changed from `date-time` to no format for status `200`
  - the `payment_instrument` response's property type changed from `object, null` to no type for status `200`
  - the `payments_failed` response's property type changed from `integer, null` to `number` for status `200`
  - the `refunded_amount` response's property type changed from `number, null` to no type for status `200`
  - the `refunded_at` response's property format changed from `date-time` to no format for status `200`
  - the `risk_score` response's property type changed from `integer, null` to `number, null` for status `200`
  - the `settlement_time_at` response's property format changed from `date-time` to no format for status `200`
  - the `shipping_address` response's property type changed from `object, null` to no type for status `200`
  - the `status` response's property type changed from no type to `string` for status `200`
  - the `subtotal` response's property type changed from `number, null` to no type for status `200`
  - the `tax_amount` response's property type changed from `number, null` to no type for status `200`
  - the `tax_refunded_amount` response's property type changed from `number, null` to `object` for status `200`
  - the `total` response's property type changed from `number, null` to no type for status `200`
  - the `updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `usd_total` response's property type changed from `number, null` to no type for status `200`
  - the `user` response's property type changed from `object, null` to no type for status `200`
  - the `verification_checks` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `application_fee` from the response with the `200` status
  - removed the required property `billing_address/city` from the response with the `200` status
  - removed the required property `billing_address/country` from the response with the `200` status
  - removed the required property `billing_address/line1` from the response with the `200` status
  - removed the required property `billing_address/line2` from the response with the `200` status
  - removed the required property `billing_address/name` from the response with the `200` status
  - removed the required property `billing_address/postal_code` from the response with the `200` status
  - removed the required property `billing_address/state` from the response with the `200` status
  - …90 more
- **2026-08-29** `1b5d50d09479` — 1 info
  - added the required property `fees` to the response with the `200` status
- **2026-08-28** `4da7133b2de7` — 4 warning
  - added the new `flex_pay` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `flex_pay` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `gcash` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `gcash` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-08-27** `16c82685be35` — 2 warning
  - added the new `authorized` enum value to the `status/oneOf[#/components/schemas/ReceiptStatus]/` response property for the response status `200`
  - added the new `requires_capture` enum value to the `substatus` response property for the response status `200`
- **2026-08-26** `86d0a97abfe5` — 10 warning
  - added the new `accel` enum value to the `card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `accel` enum value to the `payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `culiance` enum value to the `card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `culiance` enum value to the `payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `nyce` enum value to the `card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `nyce` enum value to the `payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `pulse` enum value to the `card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `pulse` enum value to the `payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `star` enum value to the `card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `star` enum value to the `payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
- **2026-08-21** `715c4defcbbf` — 2 warning
  - added the new `addi` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `addi` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-08-20** `6a23760847c8` — 1 info
  - added the required property `payment_method/card/fingerprint` to the response with the `200` status
- **2026-08-19** `23dfbe1a0d1f` — 4 warning
  - added the new `modo` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `modo` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `rapipago` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `rapipago` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-08-18** `f67a043e3190` — 1 info
  - added the required property `payment_instrument` to the response with the `200` status
- **2026-08-11** `a01100378e59` — 1 info
  - added the required property `verification_checks` to the response with the `200` status
- **2026-08-05** `6c970f803b46` — 3 info
  - added the required property `card_exp_month` to the response with the `200` status
  - added the required property `card_exp_year` to the response with the `200` status
  - added the required property `decline_code` to the response with the `200` status
- **2026-08-04** `ca841fbd6786` — 3 info
  - the security scope `shipment:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - added the required property `needs_tracking` to the response with the `200` status
  - added the required property `shipment` to the response with the `200` status
- **2026-07-31** `099fdc3be422` — 1 info
  - added the required property `settlement_time_at` to the response with the `200` status
- **2026-07-26** `60bbb4a6ffbc` — 2 warning, 1 info
  - added the new `bank_wire` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `bank_wire` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the required property `customer_phone` to the response with the `200` status
- **2026-07-14** `3a06a605784b` — 1 info
  - added the required property `refunds` to the response with the `200` status

---

[Operation](https://skmtc.dev/whop/apis/whop-api/docs/payments/:id/refund/post.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/payments/:id/refund/post)
