---
title: "Changes to Top up wallet"
method: POST
path: "/wallets/{id}/top-up"
---

# Changes to Top up wallet

`POST /wallets/{id}/top-up`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 31 of 139 revisions.

- **2026-10-20** `a24bd13338e3`: 1 info
- **2026-10-12** `80eb0267435c`: 1 info
- **2026-10-12** `de915dc839fe`: 1 warning, 4 info
- **2026-10-12** `e1ac9f73d09c`: 1 info
- **2026-10-12** `9b1ab5a75b5e`: 1 warning
- **2026-10-12** `d663503436ad`: 1 info
- **2026-10-08** `477ea6131062`: 1 info
- **2026-09-28** `91efded425ee`: 1 warning, 1 info
- **2026-09-28** `fa71deaf653b`: 1 breaking, 1 info
- **2026-09-27** `758871229df8`: 1 warning, 1 info
- **2026-09-21** `15dcbc3c880b`: 2 info
- **2026-09-21** `56ac1e6adeb7`: 2 warning
- **2026-09-21** `0aa0bf7c01e1`: 2 info
- **2026-09-11** `614c3fd4a9b1`: 1 warning
- **2026-09-09** `ac5fdb062f59`: 9 warning, 4 info
- **2026-09-03** `e36fe54e0efb`: 2 warning, 4 info
- **2026-09-02** `87ce400e15de`: 1 warning, 3 info
- **2026-09-01** `e1d4e27b5677`: 1 info
- **2026-08-20** `562f13cf61dd`: 1 warning
- **2026-08-14** `29f14678f58f`: 1 warning, 2 info
- **2026-07-31** `50b7421a9690`: 6 info
- **2026-07-15** `f8ecf435d25d`: 5 warning, 8 info
- **2026-07-09** `7d57386313c7`: 24 breaking, 57 warning, 13 info
- **2026-07-09** `4b1a811c4179`: 53 breaking, 2 warning, 57 info
- **2026-06-29** `7857ddc6e44d`: 1 info
- **2026-06-16** `257509e66883`: 1 info
- **2026-06-03** `7adf4f33ea1a`: 2 info
- **2026-05-18** `8ec2edea6b20`: 6 warning
- **2026-04-06** `95af41a12111`: 8 warning, 12 info
- **2026-04-04** `3d452eb9ebcc`: 1 info
- **2026-03-20** `d563556cdaf1`: 1 warning, 1 info

## Changes

- **2026-10-20** `a24bd13338e3`: 1 info
  - added the new optional request property `effective_date`
- **2026-10-12** `80eb0267435c`: 1 info
  - added the optional property `wallet_transaction/customer/contact_persons` to the response with the `200` status
- **2026-10-12** `de915dc839fe`: 1 warning, 4 info
  - removed the optional property `wallet_transaction/customer/contact_persons` from the response with the `200` status
  - added the new optional request property `coupons`
  - added the optional property `wallet_transaction/consumption_breakdown` to the response with the `200` status
  - added the optional property `wallet_transaction/source_id` to the response with the `200` status
  - added the optional property `wallet_transaction/source_type` to the response with the `200` status
- **2026-10-12** `e1ac9f73d09c`: 1 info
  - added the optional property `wallet_transaction/customer/contact_persons` to the response with the `200` status
- **2026-10-12** `9b1ab5a75b5e`: 1 warning
  - removed the optional property `wallet_transaction/customer/contact_persons` from the response with the `200` status
- **2026-10-12** `d663503436ad`: 1 info
  - added the optional property `wallet_transaction/customer/contact_persons` to the response with the `200` status
- **2026-10-08** `477ea6131062`: 1 info
  - added the optional property `wallet_transaction/customer/billing_currency` to the response with the `200` status
- **2026-09-28** `91efded425ee`: 1 warning, 1 info
  - added the new `stripe` enum value to the `checkout_session/payment_provider` response property for the response status `200`
  - added the new `stripe` enum value to the request property `checkout/payment_provider`
- **2026-09-28** `fa71deaf653b`: 1 breaking, 1 info
  - removed the enum value `stripe` of the request property `checkout/payment_provider`
  - removed the `stripe` enum value from the `checkout_session/payment_provider` response property for the response status `200`
- **2026-09-27** `758871229df8`: 1 warning, 1 info
  - added the new `stripe` enum value to the `checkout_session/payment_provider` response property for the response status `200`
  - added the new `stripe` enum value to the request property `checkout/payment_provider`
- **2026-09-21** `15dcbc3c880b`: 2 info
  - added the new optional request property `checkout/entity_creation_options`
  - added the optional property `checkout_session/entity_creation_result` to the response with the `200` status
- **2026-09-21** `56ac1e6adeb7`: 2 warning
  - removed the request property `checkout/entity_creation_options`
  - removed the optional property `checkout_session/entity_creation_result` from the response with the `200` status
- **2026-09-21** `0aa0bf7c01e1`: 2 info
  - added the new optional request property `checkout/entity_creation_options`
  - added the optional property `checkout_session/entity_creation_result` to the response with the `200` status
- **2026-09-11** `614c3fd4a9b1`: 1 warning
  - added the new `pay_invoice` enum value to the `checkout_session/action` response property for the response status `200`
- **2026-09-09** `ac5fdb062f59`: 9 warning, 4 info
  - removed the optional property `checkout_session/configuration` from the response with the `200` status
  - removed the optional property `checkout_session/created_by` from the response with the `200` status
  - removed the optional property `checkout_session/environment_id` from the response with the `200` status
  - removed the optional property `checkout_session/payment_provider_config` from the response with the `200` status
  - removed the optional property `checkout_session/provider_result` from the response with the `200` status
  - removed the optional property `checkout_session/result` from the response with the `200` status
  - removed the optional property `checkout_session/status` from the response with the `200` status
  - removed the optional property `checkout_session/tenant_id` from the response with the `200` status
  - removed the optional property `checkout_session/updated_by` from the response with the `200` status
  - added the optional property `checkout_session/next_poll_after_ms` to the response with the `200` status
  - added the optional property `checkout_session/payment` to the response with the `200` status
  - added the optional property `checkout_session/stale` to the response with the `200` status
  - added the optional property `checkout_session/terminal` to the response with the `200` status
- **2026-09-03** `e36fe54e0efb`: 2 warning, 4 info
  - removed the request property `checkout/payment_provider_config/customer_present`
  - removed the optional property `checkout_session/payment_provider_config/customer_present` from the response with the `200` status
  - added the new optional request property `checkout/payment_provider_config/customer_not_present`
  - added the optional property `checkout_session/payment_provider_config/customer_not_present` to the response with the `200` status
  - added the optional property `wallet/alert_settings/alert_threshold_type` to the response with the `200` status
  - added the optional property `wallet_transaction/wallet/alert_settings/alert_threshold_type` to the response with the `200` status
- **2026-09-02** `87ce400e15de`: 1 warning, 3 info
  - added the new `chargebee` enum value to the `checkout_session/payment_provider` response property for the response status `200`
  - added the new optional request property `checkout/payment_provider_config/customer_present`
  - added the new `chargebee` enum value to the request property `checkout/payment_provider`
  - added the optional property `checkout_session/payment_provider_config/customer_present` to the response with the `200` status
- **2026-09-01** `e1d4e27b5677`: 1 info
  - added the optional property `wallet_transaction/customer/tax_treatment` to the response with the `200` status
- **2026-08-20** `562f13cf61dd`: 1 warning
  - added the new `subscription_line_item` enum value to the `wallet_transaction/customer/integrations/items/entity_type` response property for the response status `200`
- **2026-08-14** `29f14678f58f`: 1 warning, 2 info
  - added the new `add_addon` enum value to the `checkout_session/action` response property for the response status `200`
  - added the optional property `checkout_session/configuration/add_addon_params` to the response with the `200` status
  - added the optional property `checkout_session/configuration/create_subscription_params/subscription_id` to the response with the `200` status
- **2026-07-31** `50b7421a9690`: 6 info
  - added the new optional request property `bonus_credits_expiry_date_utc`
  - added the new optional request property `checkout`
  - added the new optional request property `force_sync_invoice`
  - added the optional property `checkout_session` to the response with the `200` status
  - added the optional property `wallet/auto_topup/cooldown` to the response with the `200` status
  - added the optional property `wallet_transaction/wallet/auto_topup/cooldown` to the response with the `200` status
- **2026-07-15** `f8ecf435d25d`: 5 warning, 8 info
  - added the new `PURCHASED_CREDIT_BONUS` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `invoice_line_item` enum value to the `wallet_transaction/customer/integrations/items/entity_type` response property for the response status `200`
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `404`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
  - added the new optional request property `bonus_credits_to_add`
  - added the new `PURCHASED_CREDIT_BONUS` enum value to the request property `transaction_reason`
  - added the optional property `wallet/real_time_balance` to the response with the `200` status
  - added the optional property `wallet/real_time_credit_balance` to the response with the `200` status
  - added the optional property `wallet_transaction/customer/contact` to the response with the `200` status
  - added the optional property `wallet_transaction/parent_transaction_id` to the response with the `200` status
  - added the optional property `wallet_transaction/wallet/real_time_balance` to the response with the `200` status
  - added the optional property `wallet_transaction/wallet/real_time_credit_balance` to the response with the `200` status
- **2026-07-09** `7d57386313c7`: 24 breaking, 57 warning, 13 info
  - request property `transaction_reason` was restricted to a list of enum values
  - the `metadata` request property type changed from no type to `object`
  - the `transaction_reason` request property type changed from no type to `string`
  - the `wallet/config` response's property type changed from no type to `object` for status `200`
  - the `wallet/metadata` response's property type changed from no type to `object` for status `200`
  - the `wallet/status` response's property type changed from no type to `string` for status `200`
  - the `wallet/wallet_status` response's property type changed from no type to `string` for status `200`
  - the `wallet/wallet_type` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/created_by_user/tenant/metadata` response's property type changed from no type to `object` for status `200`
  - the `wallet_transaction/created_by_user/type` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/customer/integrations/items/entity_type` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/customer/integrations/items/status` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/customer/status` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/metadata` response's property type changed from no type to `object` for status `200`
  - the `wallet_transaction/reference_type` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/status` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/transaction_reason` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/transaction_status` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/type` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/wallet/config` response's property type changed from no type to `object` for status `200`
  - the `wallet_transaction/wallet/metadata` response's property type changed from no type to `object` for status `200`
  - the `wallet_transaction/wallet/status` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/wallet/wallet_status` response's property type changed from no type to `string` for status `200`
  - the `wallet_transaction/wallet/wallet_type` response's property type changed from no type to `string` for status `200`
  - added the new `CREDIT_ADJUSTMENT` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `CREDIT_EXPIRED` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `CREDIT_NOTE` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `EXTERNAL` enum value to the `wallet_transaction/reference_type` response property for the response status `200`
  - added the new `FREE_CREDIT_GRANT` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `INVOICE` enum value to the `wallet_transaction/reference_type` response property for the response status `200`
  - added the new `INVOICE_PAYMENT` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `INVOICE_VOID_REFUND` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `MANUAL_BALANCE_DEBIT` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `PAYMENT` enum value to the `wallet_transaction/reference_type` response property for the response status `200`
  - added the new `POST_PAID` enum value to the `wallet/wallet_type` response property for the response status `200`
  - added the new `POST_PAID` enum value to the `wallet_transaction/wallet/wallet_type` response property for the response status `200`
  - added the new `PRE_PAID` enum value to the `wallet/wallet_type` response property for the response status `200`
  - added the new `PRE_PAID` enum value to the `wallet_transaction/wallet/wallet_type` response property for the response status `200`
  - added the new `PURCHASED_CREDIT_DIRECT` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `PURCHASED_CREDIT_INVOICED` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - …54 more
- **2026-07-09** `4b1a811c4179`: 53 breaking, 2 warning, 57 info
  - removed the enum value `CREDIT_ADJUSTMENT` of the request property `transaction_reason`
  - removed the enum value `CREDIT_EXPIRED` of the request property `transaction_reason`
  - removed the enum value `CREDIT_NOTE` of the request property `transaction_reason`
  - removed the enum value `FREE_CREDIT_GRANT` of the request property `transaction_reason`
  - removed the enum value `INVOICE_PAYMENT` of the request property `transaction_reason`
  - removed the enum value `INVOICE_VOID_REFUND` of the request property `transaction_reason`
  - removed the enum value `MANUAL_BALANCE_DEBIT` of the request property `transaction_reason`
  - removed the enum value `PURCHASED_CREDIT_DIRECT` of the request property `transaction_reason`
  - removed the enum value `PURCHASED_CREDIT_INVOICED` of the request property `transaction_reason`
  - removed the enum value `SUBSCRIPTION_CREDIT_GRANT` of the request property `transaction_reason`
  - removed the enum value `WALLET_TERMINATION` of the request property `transaction_reason`
  - the `metadata` request property type changed from `object` to no type
  - the `transaction_reason` request property type changed from `string` to no type
  - the `wallet/alert_settings/critical/threshold` response's property type changed from `number` to `string` for status `200`
  - the `wallet/alert_settings/info/threshold` response's property type changed from `number` to `string` for status `200`
  - the `wallet/alert_settings/warning/threshold` response's property type changed from `number` to `string` for status `200`
  - the `wallet/config` response's property type changed from `object` to no type for status `200`
  - the `wallet/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet/metadata` response's property type changed from `object` to no type for status `200`
  - the `wallet/status` response's property type changed from `string` to no type for status `200`
  - the `wallet/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet/wallet_status` response's property type changed from `string` to no type for status `200`
  - the `wallet/wallet_type` response's property type changed from `string` to no type for status `200`
  - the `wallet_transaction/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet_transaction/created_by_user/tenant/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet_transaction/created_by_user/tenant/metadata` response's property type changed from `object` to no type for status `200`
  - the `wallet_transaction/created_by_user/tenant/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet_transaction/created_by_user/type` response's property type changed from `string` to no type for status `200`
  - the `wallet_transaction/customer/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet_transaction/customer/integrations/items/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet_transaction/customer/integrations/items/entity_type` response's property type changed from `string` to no type for status `200`
  - the `wallet_transaction/customer/integrations/items/status` response's property type changed from `string` to no type for status `200`
  - the `wallet_transaction/customer/integrations/items/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet_transaction/customer/status` response's property type changed from `string` to no type for status `200`
  - the `wallet_transaction/customer/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `wallet_transaction/expiry_date` response's property format changed from `date-time` to no format for status `200`
  - the `wallet_transaction/metadata` response's property type changed from `object` to no type for status `200`
  - the `wallet_transaction/reference_type` response's property type changed from `string` to no type for status `200`
  - the `wallet_transaction/status` response's property type changed from `string` to no type for status `200`
  - the `wallet_transaction/transaction_reason` response's property type changed from `string` to no type for status `200`
  - …72 more
- **2026-06-29** `7857ddc6e44d`: 1 info
  - added the optional property `wallet_transaction/customer/timezone` to the response with the `200` status
- **2026-06-16** `257509e66883`: 1 info
  - added the optional property `wallet_transaction/created_by_user/name` to the response with the `200` status
- **2026-06-03** `7adf4f33ea1a`: 2 info
  - added the optional property `wallet_transaction/created_by_user/metadata` to the response with the `200` status
  - added the optional property `wallet_transaction/customer/integrations/items/metadata` to the response with the `200` status
- **2026-05-18** `8ec2edea6b20`: 6 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `404` status
  - removed the optional property `details` from the response with the `500` status
  - added the new `too_many_requests` enum value to the `code` response property for the response status `400`
  - added the new `too_many_requests` enum value to the `code` response property for the response status `404`
  - added the new `too_many_requests` enum value to the `code` response property for the response status `500`
- **2026-04-06** `95af41a12111`: 8 warning, 12 info
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `error` from the response with the `404` status
  - removed the optional property `error` from the response with the `500` status
  - removed the optional property `success` from the response with the `400` status
  - removed the optional property `success` from the response with the `404` status
  - removed the optional property `success` from the response with the `500` status
  - removed the optional property `wallet_transaction/customer/parent_customer` from the response with the `200` status
  - removed the optional property `wallet_transaction/customer/parent_customer_id` from the response with the `200` status
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `500` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `404` status
  - added the optional property `details` to the response with the `500` status
  - added the optional property `http_status_code` to the response with the `400` status
  - added the optional property `http_status_code` to the response with the `404` status
  - added the optional property `http_status_code` to the response with the `500` status
  - added the optional property `message` to the response with the `400` status
  - added the optional property `message` to the response with the `404` status
  - added the optional property `message` to the response with the `500` status
- **2026-04-04** `3d452eb9ebcc`: 1 info
  - added the optional property `wallet_transaction/customer/integrations` to the response with the `200` status
- **2026-03-20** `d563556cdaf1`: 1 warning, 1 info
  - added the new `INVOICE_VOID_REFUND` enum value to the `wallet_transaction/transaction_reason` response property for the response status `200`
  - added the new `INVOICE_VOID_REFUND` enum value to the request property `transaction_reason`

---

[Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/wallets/:id/top-up/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/wallets/:id/top-up/post)
