Charges

The Charge object represents a single attempt to move money into your Stripe account. PaymentIntent confirmation is the most common way to create Charges, but Account Debits may also create Charges. Some legacy payment flows create Charges directly, which is not recommended for new integrations.

Endpoints

Create a charge

• POST /v1/charges

Update a charge

• POST /v1/charges/:id

Retrieve a charge

• GET /v1/charges/:id

List all charges

• GET /v1/charges

Capture a charge

• POST /v1/charges/:id/capture

Search charges

• GET /v1/charges/search

Events

• charge.captured Occurs whenever a previously uncaptured charge is captured.

• charge.expired Occurs whenever an uncaptured charge expires.

• charge.failed Occurs whenever a failed charge attempt occurs.

• charge.pending Occurs whenever a pending charge is created.

• charge.refunded Occurs whenever a charge is refunded, including partial refunds. Listen to refund.created for information about the refund.

• charge.succeeded Occurs whenever a charge is successful.

• charge.updated Occurs whenever a charge description or metadata is updated, or upon an asynchronous capture.