Skip to content

Top-ups ​

To top up your Stripe balance, you create a top-up object. You can retrieve individual top-ups, as well as list all top-ups. Top-ups are identified by a unique, random ID.

Related guide: Topping up your platform account

Endpoints ​

Create a top-up ​

  • POST /v1/topups

Update a top-up ​

  • POST /v1/topups/:id

Retrieve a top-up ​

  • GET /v1/topups/:id

List all top-ups ​

  • GET /v1/topups

Cancel a top-up ​

  • POST /v1/topups/:id/cancel

Events ​

  • topup.canceled Occurs whenever a top-up is canceled.

  • topup.created Occurs whenever a top-up is created.

  • topup.failed Occurs whenever a top-up fails.

  • topup.reversed Occurs whenever a top-up is reversed.

  • topup.succeeded Occurs whenever a top-up succeeds.

Stripe API Reference - Self-contained docs reference, refreshed 2026-05-18