When retrieving an invoice, there is an includable payments property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of payments.
Parameters
- invoicestring
The identifier of the invoice whose payments to return.
- paymentobject
The payment details of the invoice payments to return.
- payment.
typeenumRequired Only return invoice payments associated by this payment type.
Possible enum valuespayment_
intent Indicates that a
PaymentIntent
object is being associated with this invoice payment. - payment.
payment_ intentstring Only return invoice payments associated by this payment intent ID.
- statusenum
The status of the invoice payments to return.
Possible enum valuescanceled
The payment has been canceled; it will not be credited to the invoice.
open
The payment is incomplete and isn’t credited to the invoice. More fine-grained information available on the payment intent
paid
The payment is complete and has been credited to the invoice.
More parameters
- ending_
beforestring A cursor for use in pagination.
ending_
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting withbefore obj_
, your subsequent call can includebar ending_
in order to fetch the previous page of the list.before=obj_ bar - limitinteger
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
- starting_
afterstring A cursor for use in pagination.
starting_
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending withafter obj_
, your subsequent call can includefoo starting_
in order to fetch the next page of the list.after=obj_ foo
Returns
A dictionary with a data
property that contains an array of up to limit
invoice payments, starting after invoice payment starting_
. Each entry in the array is a separate invoice_payment object. If no more invoice payments are available, the resulting array will be empty.
{ "object": "list", "url": "/v1/invoice_payments", "has_more": false, "data": [ { "id": "inpay_1M3USa2eZvKYlo2CBjuwbq0N", "object": "invoice_payment", "amount_paid": 2000, "amount_requested": 2000, "created": 1391288554, "currency": "usd", "invoice": "in_103Q0w2eZvKYlo2C5PYwf6Wf", "is_default": true, "livemode": false, "payment": { "type": "payment_intent", "payment_intent": "pi_103Q0w2eZvKYlo2C364X582Z" }, "status": "paid", "status_transitions": { "canceled_at": null, "paid_at": 1391288554 } } ]}