Refund latest purchase

Refunds the authenticated user's most recent paid invoice if it is within 3 days and the user is not in a 30-day cooldown. If the invoice was tied to a subscription, the subscription is cancelled immediately.

post/premium/refund-latest

Response

Success

invoice_idstring required

payment_intent_idstring nullable required

charge_idstring nullable required

refund_idstring nullable required

refunded_amount_centsinteger required

Amount actually refunded so far, in the currency minor unit; 0 until the provider confirms success

invoice_amount_paid_centsinteger required

currencystring required

subscription_idstring nullable required

Subscription that was cancelled along with the refund, when applicable

statusstring nullable required

Provider status of the refund (e.g. pending, succeeded, failed); money only moved once succeeded

Changes

Changed in 4 of the 21 revisions of this API.53229

Sep 18, 2026dd0ad4ea1c8855See the full diff
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ○
  response property charge_id list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property payment_intent_id list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property refund_id list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property status list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property subscription_id list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
Sep 6, 2026a52a2cf49d9b32See the full diff
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
Sep 5, 20264dbb738a3e224See the full diff
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
Sep 3, 2026fa36b1b48ca520See the full diff
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 21 revisions, 2 have no diff computed.

Full history