Skip to content

Reserve Plans ​

ReservePlans are used to automatically place holds on a merchant’s funds until the plan expires. It takes a portion of each incoming Charge (including those resulting from a Transfer from a platform account).

Endpoints ​

Create a ReservePlan ​

  • POST /v1/reserve/plans

Update a ReservePlan ​

  • POST /v1/reserve/plans/:id

Retrieve a ReservePlan ​

  • GET /v1/reserve/plans/:id

List ReservePlans ​

  • GET /v1/reserve/plans

Disable a ReservePlan ​

  • POST /v1/reserve/plans/:id/disable

Events ​

  • reserve.plan.created Occurs when a reserve plan is created.

  • reserve.plan.disabled Occurs when a reserve plan is disabled.

  • reserve.plan.expired Occurs when a reserve plan expires.

  • reserve.plan.updated Occurs when a reserve plan is updated.

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