Class PaymentIntent
- All Implemented Interfaces:
HasId,MetadataStore<PaymentIntent>,StripeActiveObject,StripeObjectInterface
A PaymentIntent transitions through multiple statuses throughout its lifetime as it interfaces with Stripe.js to perform authentication flows and ultimately creates at most one successful charge.
Related guide: Payment Intents API
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classFor more details about AllocatedFunds, please refer to the API Reference.static classFor more details about AmountDetails, please refer to the API Reference.static classFor more details about AutomaticPaymentMethods, please refer to the API Reference.static classFor more details about Hooks, please refer to the API Reference.static classFor more details about NextAction, please refer to the API Reference.static classFor more details about PaymentDetails, please refer to the API Reference.static classFor more details about PaymentMethodConfigurationDetails, please refer to the API Reference.static classFor more details about PaymentMethodOptions, please refer to the API Reference.static classFor more details about PresentmentDetails, please refer to the API Reference.static classFor more details about Processing, please refer to the API Reference.static classFor more details about TransferData, 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 TypeMethodDescriptionManually reconcile the remaining amount for acustomer_balancePaymentIntent.applyCustomerBalance(RequestOptions options) Manually reconcile the remaining amount for acustomer_balancePaymentIntent.Manually reconcile the remaining amount for acustomer_balancePaymentIntent.applyCustomerBalance(PaymentIntentApplyCustomerBalanceParams params, RequestOptions options) Manually reconcile the remaining amount for acustomer_balancePaymentIntent.applyCustomerBalance(Map<String, Object> params) Manually reconcile the remaining amount for acustomer_balancePaymentIntent.applyCustomerBalance(Map<String, Object> params, RequestOptions options) Manually reconcile the remaining amount for acustomer_balancePaymentIntent.cancel()You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.cancel(RequestOptions options) You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.cancel(PaymentIntentCancelParams params) You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.cancel(PaymentIntentCancelParams params, RequestOptions options) You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.cancel(Map<String, Object> params, RequestOptions options) You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.protected booleancapture()Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.capture(RequestOptions options) Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.capture(PaymentIntentCaptureParams params) Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.capture(PaymentIntentCaptureParams params, RequestOptions options) Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.capture(Map<String, Object> params, RequestOptions options) Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.confirm()Confirm that your customer intends to pay with current or provided payment method.confirm(RequestOptions options) Confirm that your customer intends to pay with current or provided payment method.confirm(PaymentIntentConfirmParams params) Confirm that your customer intends to pay with current or provided payment method.confirm(PaymentIntentConfirmParams params, RequestOptions options) Confirm that your customer intends to pay with current or provided payment method.Confirm that your customer intends to pay with current or provided payment method.confirm(Map<String, Object> params, RequestOptions options) Confirm that your customer intends to pay with current or provided payment method.static PaymentIntentcreate(PaymentIntentCreateParams params) Creates a PaymentIntent object.static PaymentIntentcreate(PaymentIntentCreateParams params, RequestOptions options) Creates a PaymentIntent object.static PaymentIntentCreates a PaymentIntent object.static PaymentIntentcreate(Map<String, Object> params, RequestOptions options) Creates a PaymentIntent object.Perform a decremental authorization on an eligible PaymentIntent.Perform a decremental authorization on an eligible PaymentIntent.decrementAuthorization(Map<String, Object> params) Perform a decremental authorization on an eligible PaymentIntent.decrementAuthorization(Map<String, Object> params, RequestOptions options) Perform a decremental authorization on an eligible PaymentIntent.booleanAllocated Funds configuration for this PaymentIntent.Amount intended to be collected by this PaymentIntent.Amount that can be captured from this PaymentIntent.Amount that this PaymentIntent collects.Get ID of expandableapplicationobject.The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account.Get expandedapplication.Settings to configure compatible payment methods from the Stripe Dashboard.Populated whenstatusiscanceled, this is the time at which the PaymentIntent was canceled.Reason for cancellation of this PaymentIntent, either user-provided (duplicate,fraudulent,requested_by_customer, orabandoned) or generated by Stripe internally (failed_invoice,void_invoice,automatic, orexpired).Controls when the funds will be captured from the customer's account.The client secret of this PaymentIntent.Describes whether we can confirm this PaymentIntent automatically, or if it requires customer action to confirm the payment.Time at which the object was created.Three-letter ISO currency code, in lowercase.Get ID of expandablecustomerobject.ID of the Account this PaymentIntent belongs to, if one exists.Get expandedcustomer.An arbitrary string attached to the object.The list of payment method types to exclude from use with this payment.The FX Quote used for the PaymentIntent.getHooks()getId()Unique identifier for the object.The payment error encountered in the previous PaymentIntent confirmation.Get ID of expandablelatestChargeobject.Get expandedlatestCharge.Has the valuetrueif the object exists in live mode or the valuefalseif the object exists in test mode.Set of key-value pairs that you can attach to an object.If present, this property tells you what actions you need to take in order for your customer to fulfill a payment using the provided source.String representing the object's type.Get ID of expandableonBehalfOfobject.Get expandedonBehalfOf.Get ID of expandablepaymentMethodobject.Information about the payment method configuration used for this PaymentIntent.Get expandedpaymentMethod.Payment-method-specific configuration for this PaymentIntent.The list of payment method types (e.g.If present, this property tells you about the processing state of the payment.Email address that the receipt for the resulting payment will be sent to.Get ID of expandablereviewobject.Get expandedreview.Indicates whether confirmation for this PaymentIntent using a secret key isrequiredoroptional.Indicates that you intend to make future payments with this PaymentIntent's payment method.Shipping information for this PaymentIntent.Get ID of expandablesourceobject.Get expandedsource.Text that appears on the customer's statement as the statement descriptor for a non-card charge.Provides information about a card charge.Status of this PaymentIntent, one ofrequires_payment_method,requires_confirmation,requires_action,processing,requires_capture,canceled, orsucceeded.The data that automatically creates a Transfer after the payment finalizes.A string that identifies the resulting payment as part of a group.inthashCode()Perform an incremental authorization on an eligible PaymentIntent.Perform an incremental authorization on an eligible PaymentIntent.incrementAuthorization(Map<String, Object> params) Perform an incremental authorization on an eligible PaymentIntent.incrementAuthorization(Map<String, Object> params, RequestOptions options) Perform an incremental authorization on an eligible PaymentIntent.static PaymentIntentCollectionlist(PaymentIntentListParams params) Returns a list of PaymentIntents.static PaymentIntentCollectionlist(PaymentIntentListParams params, RequestOptions options) Returns a list of PaymentIntents.static PaymentIntentCollectionReturns a list of PaymentIntents.static PaymentIntentCollectionlist(Map<String, Object> params, RequestOptions options) Returns a list of PaymentIntents.static PaymentIntentRetrieves the details of a PaymentIntent that has previously been created.static PaymentIntentretrieve(String intent, RequestOptions options) Retrieves the details of a PaymentIntent that has previously been created.static PaymentIntentretrieve(String intent, PaymentIntentRetrieveParams params, RequestOptions options) Retrieves the details of a PaymentIntent that has previously been created.static PaymentIntentRetrieves the details of a PaymentIntent that has previously been created.static PaymentIntentSearchResultsearch(PaymentIntentSearchParams params) Search for PaymentIntents you’ve previously created using Stripe’s Search Query Language.static PaymentIntentSearchResultsearch(PaymentIntentSearchParams params, RequestOptions options) Search for PaymentIntents you’ve previously created using Stripe’s Search Query Language.static PaymentIntentSearchResultSearch for PaymentIntents you’ve previously created using Stripe’s Search Query Language.static PaymentIntentSearchResultsearch(Map<String, Object> params, RequestOptions options) Search for PaymentIntents you’ve previously created using Stripe’s Search Query Language.voidsetAllocatedFunds(PaymentIntent.AllocatedFunds allocatedFunds) Allocated Funds configuration for this PaymentIntent.voidAmount intended to be collected by this PaymentIntent.voidsetAmountCapturable(Long amountCapturable) Amount that can be captured from this PaymentIntent.voidsetAmountDetails(PaymentIntent.AmountDetails amountDetails) voidsetAmountReceived(Long amountReceived) Amount that this PaymentIntent collects.voidsetApplication(String id) voidsetApplicationFeeAmount(Long applicationFeeAmount) The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account.voidsetApplicationObject(Application expandableObject) voidsetAutomaticPaymentMethods(PaymentIntent.AutomaticPaymentMethods automaticPaymentMethods) Settings to configure compatible payment methods from the Stripe Dashboard.voidsetCanceledAt(Long canceledAt) Populated whenstatusiscanceled, this is the time at which the PaymentIntent was canceled.voidsetCancellationReason(String cancellationReason) Reason for cancellation of this PaymentIntent, either user-provided (duplicate,fraudulent,requested_by_customer, orabandoned) or generated by Stripe internally (failed_invoice,void_invoice,automatic, orexpired).voidsetCaptureMethod(String captureMethod) Controls when the funds will be captured from the customer's account.voidsetClientSecret(String clientSecret) The client secret of this PaymentIntent.voidsetConfirmationMethod(String confirmationMethod) Describes whether we can confirm this PaymentIntent automatically, or if it requires customer action to confirm the payment.voidsetCreated(Long created) Time at which the object was created.voidsetCurrency(String currency) Three-letter ISO currency code, in lowercase.voidsetCustomer(String id) voidsetCustomerAccount(String customerAccount) ID of the Account this PaymentIntent belongs to, if one exists.voidsetCustomerObject(Customer expandableObject) voidsetDescription(String description) An arbitrary string attached to the object.voidsetExcludedPaymentMethodTypes(List<String> excludedPaymentMethodTypes) The list of payment method types to exclude from use with this payment.voidsetFxQuote(String fxQuote) The FX Quote used for the PaymentIntent.voidsetHooks(PaymentIntent.Hooks hooks) voidUnique identifier for the object.voidsetLastPaymentError(StripeError lastPaymentError) The payment error encountered in the previous PaymentIntent confirmation.voidvoidsetLatestChargeObject(Charge expandableObject) voidsetLivemode(Boolean livemode) Has the valuetrueif the object exists in live mode or the valuefalseif the object exists in test mode.voidsetMetadata(Map<String, String> metadata) Set of key-value pairs that you can attach to an object.voidsetNextAction(PaymentIntent.NextAction nextAction) If present, this property tells you what actions you need to take in order for your customer to fulfill a payment using the provided source.voidString representing the object's type.voidsetOnBehalfOf(String id) voidsetOnBehalfOfObject(Account expandableObject) voidsetPaymentDetails(PaymentIntent.PaymentDetails paymentDetails) voidvoidsetPaymentMethodConfigurationDetails(PaymentIntent.PaymentMethodConfigurationDetails paymentMethodConfigurationDetails) Information about the payment method configuration used for this PaymentIntent.voidsetPaymentMethodObject(PaymentMethod expandableObject) voidsetPaymentMethodOptions(PaymentIntent.PaymentMethodOptions paymentMethodOptions) Payment-method-specific configuration for this PaymentIntent.voidsetPaymentMethodTypes(List<String> paymentMethodTypes) The list of payment method types (e.g.voidsetPresentmentDetails(PaymentIntent.PresentmentDetails presentmentDetails) voidsetProcessing(PaymentIntent.Processing processing) If present, this property tells you about the processing state of the payment.voidsetReceiptEmail(String receiptEmail) Email address that the receipt for the resulting payment will be sent to.voidsetResponseGetter(StripeResponseGetter responseGetter) Method is used by the containing object orStripeResponseGetterimplementations to set theStripeResponseGetterinstance used to make further requests.voidvoidsetReviewObject(Review expandableObject) voidsetSecretKeyConfirmation(String secretKeyConfirmation) Indicates whether confirmation for this PaymentIntent using a secret key isrequiredoroptional.voidsetSetupFutureUsage(String setupFutureUsage) Indicates that you intend to make future payments with this PaymentIntent's payment method.voidsetShipping(ShippingDetails shipping) Shipping information for this PaymentIntent.voidvoidsetSourceObject(PaymentSource expandableObject) voidsetStatementDescriptor(String statementDescriptor) Text that appears on the customer's statement as the statement descriptor for a non-card charge.voidsetStatementDescriptorSuffix(String statementDescriptorSuffix) Provides information about a card charge.voidStatus of this PaymentIntent, one ofrequires_payment_method,requires_confirmation,requires_action,processing,requires_capture,canceled, orsucceeded.voidsetTransferData(PaymentIntent.TransferData transferData) The data that automatically creates a Transfer after the payment finalizes.voidsetTransferGroup(String transferGroup) A string that identifies the resulting payment as part of a group.static PaymentIntenttriggerAction(String intent, PaymentIntentTriggerActionParams params) Trigger an external action on a PaymentIntent.static PaymentIntenttriggerAction(String intent, PaymentIntentTriggerActionParams params, RequestOptions options) Trigger an external action on a PaymentIntent.static PaymentIntenttriggerAction(String intent, Map<String, Object> params) Trigger an external action on a PaymentIntent.static PaymentIntenttriggerAction(String intent, Map<String, Object> params, RequestOptions options) Trigger an external action on a PaymentIntent.update(PaymentIntentUpdateParams params) Updates properties on a PaymentIntent object without confirming.update(PaymentIntentUpdateParams params, RequestOptions options) Updates properties on a PaymentIntent object without confirming.Updates properties on a PaymentIntent object without confirming.update(Map<String, Object> params, RequestOptions options) Updates properties on a PaymentIntent object without confirming.Verifies microdeposits on a PaymentIntent object.verifyMicrodeposits(RequestOptions options) Verifies microdeposits on a PaymentIntent object.Verifies microdeposits on a PaymentIntent object.verifyMicrodeposits(PaymentIntentVerifyMicrodepositsParams params, RequestOptions options) Verifies microdeposits on a PaymentIntent object.verifyMicrodeposits(Map<String, Object> params) Verifies microdeposits on a PaymentIntent object.verifyMicrodeposits(Map<String, Object> params, RequestOptions options) Verifies microdeposits on a PaymentIntent object.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
-
PaymentIntent
public PaymentIntent()
-
-
Method Details
-
getApplication
Get ID of expandableapplicationobject. -
setApplication
-
getApplicationObject
Get expandedapplication. -
setApplicationObject
-
getCustomer
Get ID of expandablecustomerobject. -
setCustomer
-
getCustomerObject
Get expandedcustomer. -
setCustomerObject
-
getLatestCharge
Get ID of expandablelatestChargeobject. -
setLatestCharge
-
getLatestChargeObject
Get expandedlatestCharge. -
setLatestChargeObject
-
getOnBehalfOf
Get ID of expandableonBehalfOfobject. -
setOnBehalfOf
-
getOnBehalfOfObject
Get expandedonBehalfOf. -
setOnBehalfOfObject
-
getPaymentMethod
Get ID of expandablepaymentMethodobject. -
setPaymentMethod
-
getPaymentMethodObject
Get expandedpaymentMethod. -
setPaymentMethodObject
-
getReview
Get ID of expandablereviewobject. -
setReview
-
getReviewObject
Get expandedreview. -
setReviewObject
-
getSource
Get ID of expandablesourceobject. -
setSource
-
getSourceObject
Get expandedsource. -
setSourceObject
-
applyCustomerBalance
Manually reconcile the remaining amount for acustomer_balancePaymentIntent.- Throws:
StripeException
-
applyCustomerBalance
Manually reconcile the remaining amount for acustomer_balancePaymentIntent.- Throws:
StripeException
-
applyCustomerBalance
Manually reconcile the remaining amount for acustomer_balancePaymentIntent.- Throws:
StripeException
-
applyCustomerBalance
public PaymentIntent applyCustomerBalance(Map<String, Object> params, RequestOptions options) throws StripeExceptionManually reconcile the remaining amount for acustomer_balancePaymentIntent.- Throws:
StripeException
-
applyCustomerBalance
public PaymentIntent applyCustomerBalance(PaymentIntentApplyCustomerBalanceParams params) throws StripeException Manually reconcile the remaining amount for acustomer_balancePaymentIntent.- Throws:
StripeException
-
applyCustomerBalance
public PaymentIntent applyCustomerBalance(PaymentIntentApplyCustomerBalanceParams params, RequestOptions options) throws StripeException Manually reconcile the remaining amount for acustomer_balancePaymentIntent.- Throws:
StripeException
-
cancel
You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.After it’s canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a
statusofrequires_capture, the remainingamount_capturableis automatically refunded.You can’t cancel the PaymentIntent for a Checkout Session. Expire the Checkout Session instead.
- Throws:
StripeException
-
cancel
You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.After it’s canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a
statusofrequires_capture, the remainingamount_capturableis automatically refunded.You can’t cancel the PaymentIntent for a Checkout Session. Expire the Checkout Session instead.
- Throws:
StripeException
-
cancel
You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.After it’s canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a
statusofrequires_capture, the remainingamount_capturableis automatically refunded.You can’t cancel the PaymentIntent for a Checkout Session. Expire the Checkout Session instead.
- Throws:
StripeException
-
cancel
public PaymentIntent cancel(Map<String, Object> params, RequestOptions options) throws StripeExceptionYou can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.After it’s canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a
statusofrequires_capture, the remainingamount_capturableis automatically refunded.You can’t cancel the PaymentIntent for a Checkout Session. Expire the Checkout Session instead.
- Throws:
StripeException
-
cancel
You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.After it’s canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a
statusofrequires_capture, the remainingamount_capturableis automatically refunded.You can’t cancel the PaymentIntent for a Checkout Session. Expire the Checkout Session instead.
- Throws:
StripeException
-
cancel
public PaymentIntent cancel(PaymentIntentCancelParams params, RequestOptions options) throws StripeException You can cancel a PaymentIntent object when it’s in one of these statuses:requires_payment_method,requires_capture,requires_confirmation,requires_actionor, in rare cases,processing.After it’s canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a
statusofrequires_capture, the remainingamount_capturableis automatically refunded.You can’t cancel the PaymentIntent for a Checkout Session. Expire the Checkout Session instead.
- Throws:
StripeException
-
capture
Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.Uncaptured PaymentIntents are cancelled a set number of days (7 by default) after their creation.
Learn more about separate authorization and capture.
- Throws:
StripeException
-
capture
Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.Uncaptured PaymentIntents are cancelled a set number of days (7 by default) after their creation.
Learn more about separate authorization and capture.
- Throws:
StripeException
-
capture
Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.Uncaptured PaymentIntents are cancelled a set number of days (7 by default) after their creation.
Learn more about separate authorization and capture.
- Throws:
StripeException
-
capture
public PaymentIntent capture(Map<String, Object> params, RequestOptions options) throws StripeExceptionCapture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.Uncaptured PaymentIntents are cancelled a set number of days (7 by default) after their creation.
Learn more about separate authorization and capture.
- Throws:
StripeException
-
capture
Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.Uncaptured PaymentIntents are cancelled a set number of days (7 by default) after their creation.
Learn more about separate authorization and capture.
- Throws:
StripeException
-
capture
public PaymentIntent capture(PaymentIntentCaptureParams params, RequestOptions options) throws StripeException Capture the funds of an existing uncaptured PaymentIntent when its status isrequires_capture.Uncaptured PaymentIntents are cancelled a set number of days (7 by default) after their creation.
Learn more about separate authorization and capture.
- Throws:
StripeException
-
confirm
Confirm that your customer intends to pay with current or provided payment method. Upon confirmation, the PaymentIntent will attempt to initiate a payment.If the selected payment method requires additional authentication steps, the PaymentIntent will transition to the
requires_actionstatus and suggest additional actions vianext_action. If payment fails, the PaymentIntent transitions to therequires_payment_methodstatus or thecanceledstatus if the confirmation limit is reached. If payment succeeds, the PaymentIntent will transition to thesucceededstatus (orrequires_capture, ifcapture_methodis set tomanual).If the
confirmation_methodisautomatic, payment may be attempted using our client SDKs and the PaymentIntent’s client_secret. Afternext_actions are handled by the client, no additional confirmation is required to complete the payment.If the
confirmation_methodismanual, all payment attempts must be initiated using a secret key.If any actions are required for the payment, the PaymentIntent will return to the
requires_confirmationstate after those actions are completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment attempt.There is a variable upper limit on how many times a PaymentIntent can be confirmed. After this limit is reached, any further calls to this endpoint will transition the PaymentIntent to the
canceledstate.- Throws:
StripeException
-
confirm
Confirm that your customer intends to pay with current or provided payment method. Upon confirmation, the PaymentIntent will attempt to initiate a payment.If the selected payment method requires additional authentication steps, the PaymentIntent will transition to the
requires_actionstatus and suggest additional actions vianext_action. If payment fails, the PaymentIntent transitions to therequires_payment_methodstatus or thecanceledstatus if the confirmation limit is reached. If payment succeeds, the PaymentIntent will transition to thesucceededstatus (orrequires_capture, ifcapture_methodis set tomanual).If the
confirmation_methodisautomatic, payment may be attempted using our client SDKs and the PaymentIntent’s client_secret. Afternext_actions are handled by the client, no additional confirmation is required to complete the payment.If the
confirmation_methodismanual, all payment attempts must be initiated using a secret key.If any actions are required for the payment, the PaymentIntent will return to the
requires_confirmationstate after those actions are completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment attempt.There is a variable upper limit on how many times a PaymentIntent can be confirmed. After this limit is reached, any further calls to this endpoint will transition the PaymentIntent to the
canceledstate.- Throws:
StripeException
-
confirm
Confirm that your customer intends to pay with current or provided payment method. Upon confirmation, the PaymentIntent will attempt to initiate a payment.If the selected payment method requires additional authentication steps, the PaymentIntent will transition to the
requires_actionstatus and suggest additional actions vianext_action. If payment fails, the PaymentIntent transitions to therequires_payment_methodstatus or thecanceledstatus if the confirmation limit is reached. If payment succeeds, the PaymentIntent will transition to thesucceededstatus (orrequires_capture, ifcapture_methodis set tomanual).If the
confirmation_methodisautomatic, payment may be attempted using our client SDKs and the PaymentIntent’s client_secret. Afternext_actions are handled by the client, no additional confirmation is required to complete the payment.If the
confirmation_methodismanual, all payment attempts must be initiated using a secret key.If any actions are required for the payment, the PaymentIntent will return to the
requires_confirmationstate after those actions are completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment attempt.There is a variable upper limit on how many times a PaymentIntent can be confirmed. After this limit is reached, any further calls to this endpoint will transition the PaymentIntent to the
canceledstate.- Throws:
StripeException
-
confirm
public PaymentIntent confirm(Map<String, Object> params, RequestOptions options) throws StripeExceptionConfirm that your customer intends to pay with current or provided payment method. Upon confirmation, the PaymentIntent will attempt to initiate a payment.If the selected payment method requires additional authentication steps, the PaymentIntent will transition to the
requires_actionstatus and suggest additional actions vianext_action. If payment fails, the PaymentIntent transitions to therequires_payment_methodstatus or thecanceledstatus if the confirmation limit is reached. If payment succeeds, the PaymentIntent will transition to thesucceededstatus (orrequires_capture, ifcapture_methodis set tomanual).If the
confirmation_methodisautomatic, payment may be attempted using our client SDKs and the PaymentIntent’s client_secret. Afternext_actions are handled by the client, no additional confirmation is required to complete the payment.If the
confirmation_methodismanual, all payment attempts must be initiated using a secret key.If any actions are required for the payment, the PaymentIntent will return to the
requires_confirmationstate after those actions are completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment attempt.There is a variable upper limit on how many times a PaymentIntent can be confirmed. After this limit is reached, any further calls to this endpoint will transition the PaymentIntent to the
canceledstate.- Throws:
StripeException
-
confirm
Confirm that your customer intends to pay with current or provided payment method. Upon confirmation, the PaymentIntent will attempt to initiate a payment.If the selected payment method requires additional authentication steps, the PaymentIntent will transition to the
requires_actionstatus and suggest additional actions vianext_action. If payment fails, the PaymentIntent transitions to therequires_payment_methodstatus or thecanceledstatus if the confirmation limit is reached. If payment succeeds, the PaymentIntent will transition to thesucceededstatus (orrequires_capture, ifcapture_methodis set tomanual).If the
confirmation_methodisautomatic, payment may be attempted using our client SDKs and the PaymentIntent’s client_secret. Afternext_actions are handled by the client, no additional confirmation is required to complete the payment.If the
confirmation_methodismanual, all payment attempts must be initiated using a secret key.If any actions are required for the payment, the PaymentIntent will return to the
requires_confirmationstate after those actions are completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment attempt.There is a variable upper limit on how many times a PaymentIntent can be confirmed. After this limit is reached, any further calls to this endpoint will transition the PaymentIntent to the
canceledstate.- Throws:
StripeException
-
confirm
public PaymentIntent confirm(PaymentIntentConfirmParams params, RequestOptions options) throws StripeException Confirm that your customer intends to pay with current or provided payment method. Upon confirmation, the PaymentIntent will attempt to initiate a payment.If the selected payment method requires additional authentication steps, the PaymentIntent will transition to the
requires_actionstatus and suggest additional actions vianext_action. If payment fails, the PaymentIntent transitions to therequires_payment_methodstatus or thecanceledstatus if the confirmation limit is reached. If payment succeeds, the PaymentIntent will transition to thesucceededstatus (orrequires_capture, ifcapture_methodis set tomanual).If the
confirmation_methodisautomatic, payment may be attempted using our client SDKs and the PaymentIntent’s client_secret. Afternext_actions are handled by the client, no additional confirmation is required to complete the payment.If the
confirmation_methodismanual, all payment attempts must be initiated using a secret key.If any actions are required for the payment, the PaymentIntent will return to the
requires_confirmationstate after those actions are completed. Your server needs to then explicitly re-confirm the PaymentIntent to initiate the next payment attempt.There is a variable upper limit on how many times a PaymentIntent can be confirmed. After this limit is reached, any further calls to this endpoint will transition the PaymentIntent to the
canceledstate.- Throws:
StripeException
-
create
Creates a PaymentIntent object.After the PaymentIntent is created, attach a payment method and confirm to continue the payment. Learn more about the available payment flows with the Payment Intents API.
When you use
confirm=trueduring creation, it’s equivalent to creating and confirming the PaymentIntent in the same call. You can use any parameters available in the confirm API when you supplyconfirm=true.- Throws:
StripeException
-
create
public static PaymentIntent create(Map<String, Object> params, RequestOptions options) throws StripeExceptionCreates a PaymentIntent object.After the PaymentIntent is created, attach a payment method and confirm to continue the payment. Learn more about the available payment flows with the Payment Intents API.
When you use
confirm=trueduring creation, it’s equivalent to creating and confirming the PaymentIntent in the same call. You can use any parameters available in the confirm API when you supplyconfirm=true.- Throws:
StripeException
-
create
Creates a PaymentIntent object.After the PaymentIntent is created, attach a payment method and confirm to continue the payment. Learn more about the available payment flows with the Payment Intents API.
When you use
confirm=trueduring creation, it’s equivalent to creating and confirming the PaymentIntent in the same call. You can use any parameters available in the confirm API when you supplyconfirm=true.- Throws:
StripeException
-
create
public static PaymentIntent create(PaymentIntentCreateParams params, RequestOptions options) throws StripeException Creates a PaymentIntent object.After the PaymentIntent is created, attach a payment method and confirm to continue the payment. Learn more about the available payment flows with the Payment Intents API.
When you use
confirm=trueduring creation, it’s equivalent to creating and confirming the PaymentIntent in the same call. You can use any parameters available in the confirm API when you supplyconfirm=true.- Throws:
StripeException
-
decrementAuthorization
Perform a decremental authorization on an eligible PaymentIntent. To be eligible, the PaymentIntent’s status must berequires_captureand decremental_authorization.status must beavailable.Decremental authorizations decrease the authorized amount on your customer’s card to the new, lower
amountprovided. A single PaymentIntent can call this endpoint multiple times to further decrease the authorized amount.After decrement, the PaymentIntent object returns with the updated amount. The PaymentIntent will now be capturable up to the new authorized amount.
Each PaymentIntent can have a maximum of 10 decremental or incremental authorization attempts, including declines. After it’s fully captured, a PaymentIntent can no longer be decremented.
- Throws:
StripeException
-
decrementAuthorization
public PaymentIntent decrementAuthorization(Map<String, Object> params, RequestOptions options) throws StripeExceptionPerform a decremental authorization on an eligible PaymentIntent. To be eligible, the PaymentIntent’s status must berequires_captureand decremental_authorization.status must beavailable.Decremental authorizations decrease the authorized amount on your customer’s card to the new, lower
amountprovided. A single PaymentIntent can call this endpoint multiple times to further decrease the authorized amount.After decrement, the PaymentIntent object returns with the updated amount. The PaymentIntent will now be capturable up to the new authorized amount.
Each PaymentIntent can have a maximum of 10 decremental or incremental authorization attempts, including declines. After it’s fully captured, a PaymentIntent can no longer be decremented.
- Throws:
StripeException
-
decrementAuthorization
public PaymentIntent decrementAuthorization(PaymentIntentDecrementAuthorizationParams params) throws StripeException Perform a decremental authorization on an eligible PaymentIntent. To be eligible, the PaymentIntent’s status must berequires_captureand decremental_authorization.status must beavailable.Decremental authorizations decrease the authorized amount on your customer’s card to the new, lower
amountprovided. A single PaymentIntent can call this endpoint multiple times to further decrease the authorized amount.After decrement, the PaymentIntent object returns with the updated amount. The PaymentIntent will now be capturable up to the new authorized amount.
Each PaymentIntent can have a maximum of 10 decremental or incremental authorization attempts, including declines. After it’s fully captured, a PaymentIntent can no longer be decremented.
- Throws:
StripeException
-
decrementAuthorization
public PaymentIntent decrementAuthorization(PaymentIntentDecrementAuthorizationParams params, RequestOptions options) throws StripeException Perform a decremental authorization on an eligible PaymentIntent. To be eligible, the PaymentIntent’s status must berequires_captureand decremental_authorization.status must beavailable.Decremental authorizations decrease the authorized amount on your customer’s card to the new, lower
amountprovided. A single PaymentIntent can call this endpoint multiple times to further decrease the authorized amount.After decrement, the PaymentIntent object returns with the updated amount. The PaymentIntent will now be capturable up to the new authorized amount.
Each PaymentIntent can have a maximum of 10 decremental or incremental authorization attempts, including declines. After it’s fully captured, a PaymentIntent can no longer be decremented.
- Throws:
StripeException
-
incrementAuthorization
Perform an incremental authorization on an eligible PaymentIntent. To be eligible, the PaymentIntent’s status must berequires_captureand incremental_authorization_supported must betrue.Incremental authorizations attempt to increase the authorized amount on your customer’s card to the new, higher
amountprovided. Similar to the initial authorization, incremental authorizations can be declined. A single PaymentIntent can call this endpoint multiple times to further increase the authorized amount.If the incremental authorization succeeds, the PaymentIntent object returns with the updated amount. If the incremental authorization fails, a card_declined error returns, and no other fields on the PaymentIntent or Charge update. The PaymentIntent object remains capturable for the previously authorized amount.
Each PaymentIntent can have a maximum of 10 incremental authorization attempts, including declines. After it’s captured, a PaymentIntent can no longer be incremented.
Learn more about incremental authorizations.
- Throws:
StripeException
-
incrementAuthorization
public PaymentIntent incrementAuthorization(Map<String, Object> params, RequestOptions options) throws StripeExceptionPerform an incremental authorization on an eligible PaymentIntent. To be eligible, the PaymentIntent’s status must berequires_captureand incremental_authorization_supported must betrue.Incremental authorizations attempt to increase the authorized amount on your customer’s card to the new, higher
amountprovided. Similar to the initial authorization, incremental authorizations can be declined. A single PaymentIntent can call this endpoint multiple times to further increase the authorized amount.If the incremental authorization succeeds, the PaymentIntent object returns with the updated amount. If the incremental authorization fails, a card_declined error returns, and no other fields on the PaymentIntent or Charge update. The PaymentIntent object remains capturable for the previously authorized amount.
Each PaymentIntent can have a maximum of 10 incremental authorization attempts, including declines. After it’s captured, a PaymentIntent can no longer be incremented.
Learn more about incremental authorizations.
- Throws:
StripeException
-
incrementAuthorization
public PaymentIntent incrementAuthorization(PaymentIntentIncrementAuthorizationParams params) throws StripeException Perform an incremental authorization on an eligible PaymentIntent. To be eligible, the PaymentIntent’s status must berequires_captureand incremental_authorization_supported must betrue.Incremental authorizations attempt to increase the authorized amount on your customer’s card to the new, higher
amountprovided. Similar to the initial authorization, incremental authorizations can be declined. A single PaymentIntent can call this endpoint multiple times to further increase the authorized amount.If the incremental authorization succeeds, the PaymentIntent object returns with the updated amount. If the incremental authorization fails, a card_declined error returns, and no other fields on the PaymentIntent or Charge update. The PaymentIntent object remains capturable for the previously authorized amount.
Each PaymentIntent can have a maximum of 10 incremental authorization attempts, including declines. After it’s captured, a PaymentIntent can no longer be incremented.
Learn more about incremental authorizations.
- Throws:
StripeException
-
incrementAuthorization
public PaymentIntent incrementAuthorization(PaymentIntentIncrementAuthorizationParams params, RequestOptions options) throws StripeException Perform an incremental authorization on an eligible PaymentIntent. To be eligible, the PaymentIntent’s status must berequires_captureand incremental_authorization_supported must betrue.Incremental authorizations attempt to increase the authorized amount on your customer’s card to the new, higher
amountprovided. Similar to the initial authorization, incremental authorizations can be declined. A single PaymentIntent can call this endpoint multiple times to further increase the authorized amount.If the incremental authorization succeeds, the PaymentIntent object returns with the updated amount. If the incremental authorization fails, a card_declined error returns, and no other fields on the PaymentIntent or Charge update. The PaymentIntent object remains capturable for the previously authorized amount.
Each PaymentIntent can have a maximum of 10 incremental authorization attempts, including declines. After it’s captured, a PaymentIntent can no longer be incremented.
Learn more about incremental authorizations.
- Throws:
StripeException
-
list
Returns a list of PaymentIntents.- Throws:
StripeException
-
list
public static PaymentIntentCollection list(Map<String, Object> params, RequestOptions options) throws StripeExceptionReturns a list of PaymentIntents.- Throws:
StripeException
-
list
Returns a list of PaymentIntents.- Throws:
StripeException
-
list
public static PaymentIntentCollection list(PaymentIntentListParams params, RequestOptions options) throws StripeException Returns a list of PaymentIntents.- Throws:
StripeException
-
retrieve
Retrieves the details of a PaymentIntent that has previously been created.You can retrieve a PaymentIntent client-side using a publishable key when the
client_secretis in the query string.If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the payment intent object reference for more details.
- Throws:
StripeException
-
retrieve
Retrieves the details of a PaymentIntent that has previously been created.You can retrieve a PaymentIntent client-side using a publishable key when the
client_secretis in the query string.If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the payment intent object reference for more details.
- Throws:
StripeException
-
retrieve
public static PaymentIntent retrieve(String intent, Map<String, Object> params, RequestOptions options) throws StripeExceptionRetrieves the details of a PaymentIntent that has previously been created.You can retrieve a PaymentIntent client-side using a publishable key when the
client_secretis in the query string.If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the payment intent object reference for more details.
- Throws:
StripeException
-
retrieve
public static PaymentIntent retrieve(String intent, PaymentIntentRetrieveParams params, RequestOptions options) throws StripeException Retrieves the details of a PaymentIntent that has previously been created.You can retrieve a PaymentIntent client-side using a publishable key when the
client_secretis in the query string.If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the payment intent object reference for more details.
- Throws:
StripeException
-
search
Search for PaymentIntents you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.- Throws:
StripeException
-
search
public static PaymentIntentSearchResult search(Map<String, Object> params, RequestOptions options) throws StripeExceptionSearch for PaymentIntents you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.- Throws:
StripeException
-
search
public static PaymentIntentSearchResult search(PaymentIntentSearchParams params) throws StripeException Search for PaymentIntents you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.- Throws:
StripeException
-
search
public static PaymentIntentSearchResult search(PaymentIntentSearchParams params, RequestOptions options) throws StripeException Search for PaymentIntents you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.- Throws:
StripeException
-
triggerAction
public static PaymentIntent triggerAction(String intent, Map<String, Object> params) throws StripeExceptionTrigger an external action on a PaymentIntent.- Throws:
StripeException
-
triggerAction
public static PaymentIntent triggerAction(String intent, Map<String, Object> params, RequestOptions options) throws StripeExceptionTrigger an external action on a PaymentIntent.- Throws:
StripeException
-
triggerAction
public static PaymentIntent triggerAction(String intent, PaymentIntentTriggerActionParams params) throws StripeException Trigger an external action on a PaymentIntent.- Throws:
StripeException
-
triggerAction
public static PaymentIntent triggerAction(String intent, PaymentIntentTriggerActionParams params, RequestOptions options) throws StripeException Trigger an external action on a PaymentIntent.- Throws:
StripeException
-
update
Updates properties on a PaymentIntent object without confirming.Depending on which properties you update, you might need to confirm the PaymentIntent again. For example, updating the
payment_methodalways requires you to confirm the PaymentIntent again. If you prefer to update and confirm at the same time, we recommend updating properties through the confirm API instead.- Specified by:
updatein interfaceMetadataStore<PaymentIntent>- Throws:
StripeException
-
update
public PaymentIntent update(Map<String, Object> params, RequestOptions options) throws StripeExceptionUpdates properties on a PaymentIntent object without confirming.Depending on which properties you update, you might need to confirm the PaymentIntent again. For example, updating the
payment_methodalways requires you to confirm the PaymentIntent again. If you prefer to update and confirm at the same time, we recommend updating properties through the confirm API instead.- Specified by:
updatein interfaceMetadataStore<PaymentIntent>- Throws:
StripeException
-
update
Updates properties on a PaymentIntent object without confirming.Depending on which properties you update, you might need to confirm the PaymentIntent again. For example, updating the
payment_methodalways requires you to confirm the PaymentIntent again. If you prefer to update and confirm at the same time, we recommend updating properties through the confirm API instead.- Throws:
StripeException
-
update
public PaymentIntent update(PaymentIntentUpdateParams params, RequestOptions options) throws StripeException Updates properties on a PaymentIntent object without confirming.Depending on which properties you update, you might need to confirm the PaymentIntent again. For example, updating the
payment_methodalways requires you to confirm the PaymentIntent again. If you prefer to update and confirm at the same time, we recommend updating properties through the confirm API instead.- Throws:
StripeException
-
verifyMicrodeposits
Verifies microdeposits on a PaymentIntent object.- Throws:
StripeException
-
verifyMicrodeposits
Verifies microdeposits on a PaymentIntent object.- Throws:
StripeException
-
verifyMicrodeposits
Verifies microdeposits on a PaymentIntent object.- Throws:
StripeException
-
verifyMicrodeposits
public PaymentIntent verifyMicrodeposits(Map<String, Object> params, RequestOptions options) throws StripeExceptionVerifies microdeposits on a PaymentIntent object.- Throws:
StripeException
-
verifyMicrodeposits
public PaymentIntent verifyMicrodeposits(PaymentIntentVerifyMicrodepositsParams params) throws StripeException Verifies microdeposits on a PaymentIntent object.- Throws:
StripeException
-
verifyMicrodeposits
public PaymentIntent verifyMicrodeposits(PaymentIntentVerifyMicrodepositsParams params, RequestOptions options) throws StripeException Verifies microdeposits on a PaymentIntent object.- 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.
-
getAllocatedFunds
Allocated Funds configuration for this PaymentIntent. -
getAmount
Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or equivalent in charge currency. The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). -
getAmountCapturable
Amount that can be captured from this PaymentIntent. -
getAmountDetails
-
getAmountReceived
Amount that this PaymentIntent collects. -
getApplicationFeeAmount
The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents use case for connected accounts. -
getAutomaticPaymentMethods
Settings to configure compatible payment methods from the Stripe Dashboard. -
getCanceledAt
Populated whenstatusiscanceled, this is the time at which the PaymentIntent was canceled. Measured in seconds since the Unix epoch. -
getCancellationReason
Reason for cancellation of this PaymentIntent, either user-provided (duplicate,fraudulent,requested_by_customer, orabandoned) or generated by Stripe internally (failed_invoice,void_invoice,automatic, orexpired).One of
abandoned,automatic,duplicate,expired,failed_invoice,fraudulent,requested_by_customer, orvoid_invoice. -
getCaptureMethod
Controls when the funds will be captured from the customer's account.One of
automatic,automatic_async, ormanual. -
getClientSecret
The client secret of this PaymentIntent. Used for client-side retrieval using a publishable key.The client secret can be used to complete a payment from your frontend. It should not be stored, logged, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret.
Refer to our docs to accept a payment and learn about how
client_secretshould be handled. -
getConfirmationMethod
Describes whether we can confirm this PaymentIntent automatically, or if it requires customer action to confirm the payment.One of
automatic, ormanual. -
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. -
getCustomerAccount
ID of the Account this PaymentIntent belongs to, if one exists.Payment methods attached to other Accounts cannot be used with this PaymentIntent.
If setup_future_usage is set and this PaymentIntent's payment method is not
card_present, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method iscard_presentand isn't a digital wallet, then a generated_card payment method representing the card is created and attached to the Account instead. -
getDescription
An arbitrary string attached to the object. Often useful for displaying to users. -
getExcludedPaymentMethodTypes
The list of payment method types to exclude from use with this payment. -
getFxQuote
The FX Quote used for the PaymentIntent. -
getHooks
-
getLastPaymentError
The payment error encountered in the previous PaymentIntent confirmation. It will be cleared if the PaymentIntent is later updated for any reason. -
getLivemode
Has the valuetrueif the object exists in live mode or the valuefalseif the object exists in test mode. -
getNextAction
If present, this property tells you what actions you need to take in order for your customer to fulfill a payment using the provided source. -
getObject
String representing the object's type. Objects of the same type share the same value.Equal to
payment_intent. -
getPaymentDetails
-
getPaymentMethodConfigurationDetails
Information about the payment method configuration used for this PaymentIntent. -
getPaymentMethodOptions
Payment-method-specific configuration for this PaymentIntent. -
getPaymentMethodTypes
The list of payment method types (e.g. card) that this PaymentIntent is allowed to use. A comprehensive list of valid payment method types can be found here. -
getPresentmentDetails
-
getProcessing
If present, this property tells you about the processing state of the payment. -
getReceiptEmail
Email address that the receipt for the resulting payment will be sent to. Ifreceipt_emailis specified for a payment in live mode, a receipt will be sent regardless of your email settings. -
getSecretKeyConfirmation
Indicates whether confirmation for this PaymentIntent using a secret key isrequiredoroptional.One of
optional, orrequired. -
getSetupFutureUsage
Indicates that you intend to make future payments with this PaymentIntent's payment method.If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_presentand isn't a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.When processing card payments, Stripe uses
setup_future_usageto help you comply with regional legislation and network rules, such as SCA.One of
off_session, oron_session. -
getShipping
Shipping information for this PaymentIntent. -
getStatementDescriptor
Text that appears on the customer's statement as the statement descriptor for a non-card charge. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see the Statement Descriptor docs.Setting this value for a card charge returns an error. For card charges, set the statement_descriptor_suffix instead.
-
getStatementDescriptorSuffix
Provides information about a card charge. Concatenated to the account's statement descriptor prefix to form the complete statement descriptor that appears on the customer's statement. -
getStatus
Status of this PaymentIntent, one ofrequires_payment_method,requires_confirmation,requires_action,processing,requires_capture,canceled, orsucceeded. Read more about each PaymentIntent status. -
getTransferData
The data that automatically creates a Transfer after the payment finalizes. Learn more about the use case for connected accounts. -
getTransferGroup
A string that identifies the resulting payment as part of a group. Learn more about the use case for connected accounts. -
setAllocatedFunds
Allocated Funds configuration for this PaymentIntent. -
setAmount
Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or equivalent in charge currency. The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99). -
setAmountCapturable
Amount that can be captured from this PaymentIntent. -
setAmountDetails
-
setAmountReceived
Amount that this PaymentIntent collects. -
setApplicationFeeAmount
The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents use case for connected accounts. -
setAutomaticPaymentMethods
public void setAutomaticPaymentMethods(PaymentIntent.AutomaticPaymentMethods automaticPaymentMethods) Settings to configure compatible payment methods from the Stripe Dashboard. -
setCanceledAt
Populated whenstatusiscanceled, this is the time at which the PaymentIntent was canceled. Measured in seconds since the Unix epoch. -
setCancellationReason
Reason for cancellation of this PaymentIntent, either user-provided (duplicate,fraudulent,requested_by_customer, orabandoned) or generated by Stripe internally (failed_invoice,void_invoice,automatic, orexpired).One of
abandoned,automatic,duplicate,expired,failed_invoice,fraudulent,requested_by_customer, orvoid_invoice. -
setCaptureMethod
Controls when the funds will be captured from the customer's account.One of
automatic,automatic_async, ormanual. -
setClientSecret
The client secret of this PaymentIntent. Used for client-side retrieval using a publishable key.The client secret can be used to complete a payment from your frontend. It should not be stored, logged, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret.
Refer to our docs to accept a payment and learn about how
client_secretshould be handled. -
setConfirmationMethod
Describes whether we can confirm this PaymentIntent automatically, or if it requires customer action to confirm the payment.One of
automatic, ormanual. -
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. -
setCustomerAccount
ID of the Account this PaymentIntent belongs to, if one exists.Payment methods attached to other Accounts cannot be used with this PaymentIntent.
If setup_future_usage is set and this PaymentIntent's payment method is not
card_present, then the payment method attaches to the Account after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method iscard_presentand isn't a digital wallet, then a generated_card payment method representing the card is created and attached to the Account instead. -
setDescription
An arbitrary string attached to the object. Often useful for displaying to users. -
setExcludedPaymentMethodTypes
The list of payment method types to exclude from use with this payment. -
setFxQuote
The FX Quote used for the PaymentIntent. -
setHooks
-
setId
Unique identifier for the object. -
setLastPaymentError
The payment error encountered in the previous PaymentIntent confirmation. It will be cleared if the PaymentIntent is later updated for any reason. -
setLivemode
Has the valuetrueif the object exists in live mode or the valuefalseif the object exists in test mode. -
setMetadata
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Learn more about storing information in metadata. -
setNextAction
If present, this property tells you what actions you need to take in order for your customer to fulfill a payment using the provided source. -
setObject
String representing the object's type. Objects of the same type share the same value.Equal to
payment_intent. -
setPaymentDetails
-
setPaymentMethodConfigurationDetails
public void setPaymentMethodConfigurationDetails(PaymentIntent.PaymentMethodConfigurationDetails paymentMethodConfigurationDetails) Information about the payment method configuration used for this PaymentIntent. -
setPaymentMethodOptions
Payment-method-specific configuration for this PaymentIntent. -
setPaymentMethodTypes
The list of payment method types (e.g. card) that this PaymentIntent is allowed to use. A comprehensive list of valid payment method types can be found here. -
setPresentmentDetails
-
setProcessing
If present, this property tells you about the processing state of the payment. -
setReceiptEmail
Email address that the receipt for the resulting payment will be sent to. Ifreceipt_emailis specified for a payment in live mode, a receipt will be sent regardless of your email settings. -
setSecretKeyConfirmation
Indicates whether confirmation for this PaymentIntent using a secret key isrequiredoroptional.One of
optional, orrequired. -
setSetupFutureUsage
Indicates that you intend to make future payments with this PaymentIntent's payment method.If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_presentand isn't a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.When processing card payments, Stripe uses
setup_future_usageto help you comply with regional legislation and network rules, such as SCA.One of
off_session, oron_session. -
setShipping
Shipping information for this PaymentIntent. -
setStatementDescriptor
Text that appears on the customer's statement as the statement descriptor for a non-card charge. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see the Statement Descriptor docs.Setting this value for a card charge returns an error. For card charges, set the statement_descriptor_suffix instead.
-
setStatementDescriptorSuffix
Provides information about a card charge. Concatenated to the account's statement descriptor prefix to form the complete statement descriptor that appears on the customer's statement. -
setStatus
Status of this PaymentIntent, one ofrequires_payment_method,requires_confirmation,requires_action,processing,requires_capture,canceled, orsucceeded. Read more about each PaymentIntent status. -
setTransferData
The data that automatically creates a Transfer after the payment finalizes. Learn more about the use case for connected accounts. -
setTransferGroup
A string that identifies the resulting payment as part of a group. Learn more about the use case for connected accounts. -
equals
-
canEqual
-
hashCode
public int hashCode() -
getId
Unique identifier for the object. -
getMetadata
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Learn more about storing information in metadata.- Specified by:
getMetadatain interfaceMetadataStore<PaymentIntent>
-