Package com.stripe.model
Class InvoicePayment
java.lang.Object
com.stripe.model.StripeObject
com.stripe.net.ApiResource
com.stripe.model.InvoicePayment
- All Implemented Interfaces:
HasId,StripeActiveObject,StripeObjectInterface
Invoice Payments represent payments made against invoices. Invoice Payments can be accessed in
two ways: 1. By expanding the
payments field on the Invoice resource. 2. By using the Invoice Payment
retrieve and list endpoints.
Invoice Payments include the mapping between payment objects, such as Payment Intent, and Invoices. This resource and its endpoints allows you to easily track if a payment is associated with a specific invoice and monitor the allocation details of the payments.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classFor more details about Payment, please refer to the API Reference.static classFor more details about StatusTransitions, please refer to the API Reference.Nested classes/interfaces inherited from class com.stripe.net.ApiResource
ApiResource.RequestMethod -
Field Summary
Fields inherited from class com.stripe.net.ApiResource
CHARSET, GSON, INTERNAL_GSONFields inherited from class com.stripe.model.StripeObject
PRETTY_PRINT_GSON -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected booleanbooleanAmount that was actually paid for this invoice, in cents (or local equivalent).Amount intended to be paid toward this invoice, in cents (or local equivalent).Time at which the object was created.Three-letter ISO currency code, in lowercase.getId()Unique identifier for the object.Get ID of expandableinvoiceobject.Get expandedinvoice.Stripe automatically creates a default InvoicePayment when the invoice is finalized, and keeps it synchronized with the invoice’samount_remaining.Has the valuetrueif the object exists in live mode or the valuefalseif the object exists in test mode.String representing the object's type.The status of the payment, one ofopen,paid, orcanceled.inthashCode()static InvoicePaymentCollectionlist(InvoicePaymentListParams params) When retrieving an invoice, there is an includable payments property containing the first handful of those items.static InvoicePaymentCollectionlist(InvoicePaymentListParams params, RequestOptions options) When retrieving an invoice, there is an includable payments property containing the first handful of those items.static InvoicePaymentCollectionWhen retrieving an invoice, there is an includable payments property containing the first handful of those items.static InvoicePaymentCollectionlist(Map<String, Object> params, RequestOptions options) When retrieving an invoice, there is an includable payments property containing the first handful of those items.static InvoicePaymentRetrieves the invoice payment with the given ID.static InvoicePaymentretrieve(String invoicePayment, RequestOptions options) Retrieves the invoice payment with the given ID.static InvoicePaymentretrieve(String invoicePayment, InvoicePaymentRetrieveParams params, RequestOptions options) Retrieves the invoice payment with the given ID.static InvoicePaymentRetrieves the invoice payment with the given ID.voidsetAmountPaid(Long amountPaid) Amount that was actually paid for this invoice, in cents (or local equivalent).voidsetAmountRequested(Long amountRequested) Amount intended to be paid toward this invoice, in cents (or local equivalent).voidsetCreated(Long created) Time at which the object was created.voidsetCurrency(String currency) Three-letter ISO currency code, in lowercase.voidUnique identifier for the object.voidsetInvoice(String id) voidsetInvoiceObject(Invoice expandableObject) voidsetIsDefault(Boolean isDefault) Stripe automatically creates a default InvoicePayment when the invoice is finalized, and keeps it synchronized with the invoice’samount_remaining.voidsetLivemode(Boolean livemode) Has the valuetrueif the object exists in live mode or the valuefalseif the object exists in test mode.voidString representing the object's type.voidsetPayment(InvoicePayment.Payment payment) voidsetResponseGetter(StripeResponseGetter responseGetter) Method is used by the containing object orStripeResponseGetterimplementations to set theStripeResponseGetterinstance used to make further requests.voidThe status of the payment, one ofopen,paid, orcanceled.voidsetStatusTransitions(InvoicePayment.StatusTransitions statusTransitions) Methods inherited from class com.stripe.net.ApiResource
checkNullTypedParams, getGlobalResponseGetter, getResponseGetter, setExpandableFieldId, setGlobalResponseGetter, urlEncode, urlEncodeIdMethods inherited from class com.stripe.model.StripeObject
deserializeStripeObject, deserializeStripeObject, deserializeStripeObject, deserializeStripeObject, equals, getLastResponse, getRawJsonObject, setLastResponse, toJson, toStringMethods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface com.stripe.model.StripeActiveObject
trySetResponseGetter
-
Constructor Details
-
InvoicePayment
public InvoicePayment()
-
-
Method Details
-
getInvoice
Get ID of expandableinvoiceobject. -
setInvoice
-
getInvoiceObject
Get expandedinvoice. -
setInvoiceObject
-
list
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.- Throws:
StripeException
-
list
public static InvoicePaymentCollection list(Map<String, Object> params, RequestOptions options) throws StripeExceptionWhen 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.- Throws:
StripeException
-
list
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.- Throws:
StripeException
-
list
public static InvoicePaymentCollection list(InvoicePaymentListParams params, RequestOptions options) throws StripeException 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.- Throws:
StripeException
-
retrieve
Retrieves the invoice payment with the given ID.- Throws:
StripeException
-
retrieve
public static InvoicePayment retrieve(String invoicePayment, RequestOptions options) throws StripeException Retrieves the invoice payment with the given ID.- Throws:
StripeException
-
retrieve
public static InvoicePayment retrieve(String invoicePayment, Map<String, Object> params, RequestOptions options) throws StripeExceptionRetrieves the invoice payment with the given ID.- Throws:
StripeException
-
retrieve
public static InvoicePayment retrieve(String invoicePayment, InvoicePaymentRetrieveParams params, RequestOptions options) throws StripeException Retrieves the invoice payment with the given ID.- Throws:
StripeException
-
setResponseGetter
Description copied from interface:StripeActiveObjectMethod is used by the containing object orStripeResponseGetterimplementations to set theStripeResponseGetterinstance used to make further requests.- Specified by:
setResponseGetterin interfaceStripeActiveObject- Overrides:
setResponseGetterin classApiResource- Parameters:
responseGetter- theStripeResponseGetterinstance to use for making further requests.
-
getAmountPaid
Amount that was actually paid for this invoice, in cents (or local equivalent). This field is null until the payment ispaid. This amount can be less than theamount_requestedif the PaymentIntent’samount_receivedis not sufficient to pay all of the invoices that it is attached to. -
getAmountRequested
Amount intended to be paid toward this invoice, in cents (or local equivalent). -
getCreated
Time at which the object was created. Measured in seconds since the Unix epoch. -
getCurrency
Three-letter ISO currency code, in lowercase. Must be a supported currency. -
getIsDefault
Stripe automatically creates a default InvoicePayment when the invoice is finalized, and keeps it synchronized with the invoice’samount_remaining. The PaymentIntent associated with the default payment can’t be edited or canceled directly. -
getLivemode
Has the valuetrueif the object exists in live mode or the valuefalseif the object exists in test mode. -
getObject
String representing the object's type. Objects of the same type share the same value.Equal to
invoice_payment. -
getPayment
-
getStatus
The status of the payment, one ofopen,paid, orcanceled. -
getStatusTransitions
-
setAmountPaid
Amount that was actually paid for this invoice, in cents (or local equivalent). This field is null until the payment ispaid. This amount can be less than theamount_requestedif the PaymentIntent’samount_receivedis not sufficient to pay all of the invoices that it is attached to. -
setAmountRequested
Amount intended to be paid toward this invoice, in cents (or local equivalent). -
setCreated
Time at which the object was created. Measured in seconds since the Unix epoch. -
setCurrency
Three-letter ISO currency code, in lowercase. Must be a supported currency. -
setId
Unique identifier for the object. -
setIsDefault
Stripe automatically creates a default InvoicePayment when the invoice is finalized, and keeps it synchronized with the invoice’samount_remaining. The PaymentIntent associated with the default payment can’t be edited or canceled directly. -
setLivemode
Has the valuetrueif the object exists in live mode or the valuefalseif the object exists in test mode. -
setObject
String representing the object's type. Objects of the same type share the same value.Equal to
invoice_payment. -
setPayment
-
setStatus
The status of the payment, one ofopen,paid, orcanceled. -
setStatusTransitions
-
equals
-
canEqual
-
hashCode
public int hashCode() -
getId
Unique identifier for the object.
-