v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-015891,4406.1 MB

Retrieve an InvoicePayment

Retrieves the invoice payment with the given ID.

get/v1/invoice_payments/{invoice_payment}

Path parameters

invoice_paymentstring required

Query parameters

expandstring[]

Specifies which fields in the response should be expanded.

Response

Successful response.

amount_paidinteger nullable

Amount that was actually paid for this invoice, in cents (or local equivalent). This field is null until the payment is paid. This amount can be less than the amount_requested if the PaymentIntent’s amount_received is not sufficient to pay all of the invoices that it is attached to.

amount_requestedinteger required

Amount intended to be paid toward this invoice, in cents (or local equivalent)

createdinteger required

Time at which the object was created. Measured in seconds since the Unix epoch.

currencystring required

Three-letter ISO currency code, in lowercase. Must be a supported currency.

idstring required

Unique identifier for the object.

is_defaultboolean required

Stripe automatically creates a default InvoicePayment when the invoice is finalized, and keeps it synchronized with the invoice’s amount_remaining. The PaymentIntent associated with the default payment can’t be edited or canceled directly.

livemodeboolean required

If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

object'invoice_payment' required

String representing the object's type. Objects of the same type share the same value.

statusstring required

The status of the payment, one of open, paid, or canceled.