public class PaymentIntentCreateParams extends ApiRequestParams
Modifier and Type | Class and Description |
---|---|
static class |
PaymentIntentCreateParams.Builder |
static class |
PaymentIntentCreateParams.CaptureMethod
Add all map key/value pairs to `extraParams` map.
|
static class |
PaymentIntentCreateParams.ConfirmationMethod |
static class |
PaymentIntentCreateParams.MandateData |
static class |
PaymentIntentCreateParams.OffSession |
static class |
PaymentIntentCreateParams.PaymentMethodOptions
The user agent of the browser from which the Mandate was accepted by the customer.
|
static class |
PaymentIntentCreateParams.SetupFutureUsage |
static class |
PaymentIntentCreateParams.Shipping
Type of installment plan, one of
fixed_count . |
static class |
PaymentIntentCreateParams.TransferData
State, county, province, or region.
|
ApiRequestParams.EnumParam
EXTRA_PARAMS_KEY
Modifier and Type | Method and Description |
---|---|
static PaymentIntentCreateParams.Builder |
builder() |
java.lang.Long |
getAmount()
Amount intended to be collected by this PaymentIntent.
|
java.lang.Long |
getApplicationFeeAmount()
The amount of the application fee (if any) that will be applied to the payment and transferred
to the application owner's Stripe account.
|
PaymentIntentCreateParams.CaptureMethod |
getCaptureMethod()
Controls when the funds will be captured from the customer's account.
|
java.lang.Boolean |
getConfirm()
Set to
true to attempt to confirm this PaymentIntent
immediately. |
PaymentIntentCreateParams.ConfirmationMethod |
getConfirmationMethod() |
java.lang.String |
getCurrency()
Three-letter ISO currency code,
in lowercase.
|
java.lang.String |
getCustomer()
ID of the Customer this PaymentIntent belongs to, if one exists.
|
java.lang.String |
getDescription()
An arbitrary string attached to the object.
|
java.lang.Boolean |
getErrorOnRequiresAction()
Set to
true to fail the payment attempt if the PaymentIntent transitions into requires_action . |
java.util.List<java.lang.String> |
getExpand()
Specifies which fields in the response should be expanded.
|
java.util.Map<java.lang.String,java.lang.Object> |
getExtraParams()
Map of extra parameters for custom features not available in this client library.
|
java.lang.String |
getMandate()
ID of the mandate to be used for this payment.
|
PaymentIntentCreateParams.MandateData |
getMandateData()
This hash contains details about the Mandate to create.
|
java.util.Map<java.lang.String,java.lang.String> |
getMetadata()
Set of key-value pairs that you can attach to an object.
|
java.lang.Object |
getOffSession()
Set to
true to indicate that the customer is not in your checkout flow during this
payment attempt, and therefore is unable to authenticate. |
java.lang.String |
getOnBehalfOf()
The Stripe account ID for which these funds are intended.
|
java.lang.String |
getPaymentMethod()
ID of the payment method (a PaymentMethod, Card, or compatible Source
object) to attach to this PaymentIntent.
|
PaymentIntentCreateParams.PaymentMethodOptions |
getPaymentMethodOptions()
Payment-method-specific configuration for this PaymentIntent.
|
java.util.List<java.lang.String> |
getPaymentMethodTypes()
The list of payment method types (e.g.
|
java.lang.String |
getReceiptEmail()
Email address that the receipt for the resulting payment will be sent to.
|
java.lang.String |
getReturnUrl()
The URL to redirect your customer back to after they authenticate or cancel their payment on
the payment method's app or site.
|
java.lang.Boolean |
getSavePaymentMethod()
If the PaymentIntent has a
payment_method and a customer or if you're attaching
a payment method to the PaymentIntent in this request, you can pass save_payment_method=true to save the payment method to the customer immediately. |
PaymentIntentCreateParams.SetupFutureUsage |
getSetupFutureUsage()
Indicates that you intend to make future payments with this PaymentIntent's payment method.
|
PaymentIntentCreateParams.Shipping |
getShipping()
Shipping information for this PaymentIntent.
|
java.lang.String |
getSource()
This is a legacy field that will be removed in the future.
|
java.lang.String |
getStatementDescriptor()
For non-card charges, you can use this value as the complete description that appears on your
customers’ statements.
|
java.lang.String |
getStatementDescriptorSuffix()
Provides information about a card payment that customers see on their statements.
|
PaymentIntentCreateParams.TransferData |
getTransferData()
The parameters used to automatically create a Transfer when the payment succeeds.
|
java.lang.String |
getTransferGroup()
A string that identifies the resulting payment as part of a group.
|
java.lang.Boolean |
getUseStripeSdk()
Set to
true only when using manual confirmation and the iOS or Android SDKs to handle
additional authentication steps. |
toMap
public static PaymentIntentCreateParams.Builder builder()
public java.lang.Long getAmount()
public java.lang.Long getApplicationFeeAmount()
public PaymentIntentCreateParams.CaptureMethod getCaptureMethod()
public java.lang.Boolean getConfirm()
public PaymentIntentCreateParams.ConfirmationMethod getConfirmationMethod()
public java.lang.String getCurrency()
public java.lang.String getCustomer()
Payment methods attached to other Customers cannot be used with this PaymentIntent.
If present in combination with setup_future_usage, this PaymentIntent's payment method will be attached to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete.
public java.lang.String getDescription()
public java.lang.Boolean getErrorOnRequiresAction()
true
to fail the payment attempt if the PaymentIntent transitions into requires_action
. This parameter is intended for simpler integrations that do not handle
customer actions, like saving cards without
authentication. This parameter can only be used with confirm=true
.public java.util.List<java.lang.String> getExpand()
public java.util.Map<java.lang.String,java.lang.Object> getExtraParams()
@SerializedName
value. Instead, each
key/value pair is serialized as if the key is a root-level field (serialized) name in this
param object. Effectively, this map is flattened to its parent instance.public java.lang.String getMandate()
confirm=true
.public PaymentIntentCreateParams.MandateData getMandateData()
confirm=true
.public java.util.Map<java.lang.String,java.lang.String> getMetadata()
metadata
.public java.lang.Object getOffSession()
true
to indicate that the customer is not in your checkout flow during this
payment attempt, and therefore is unable to authenticate. This parameter is intended for
scenarios where you collect card details and charge them later. This
parameter can only be used with confirm=true
.public java.lang.String getOnBehalfOf()
public java.lang.String getPaymentMethod()
If neither the payment_method
parameter nor the source
parameter are
provided with confirm=true
, source
will be automatically populated with customer.default_source
to improve the migration experience for users of the Charges API. We
recommend that you explicitly provide the payment_method
going forward.
public PaymentIntentCreateParams.PaymentMethodOptions getPaymentMethodOptions()
public java.util.List<java.lang.String> getPaymentMethodTypes()
public java.lang.String getReceiptEmail()
public java.lang.String getReturnUrl()
confirm=true
.public java.lang.Boolean getSavePaymentMethod()
payment_method
and a customer
or if you're attaching
a payment method to the PaymentIntent in this request, you can pass save_payment_method=true
to save the payment method to the customer immediately.
If the payment method is already saved to a customer, this parameter does nothing. If this type of payment method cannot be saved to a customer, the request will error.
Saving a payment method using this parameter is not recommended because it will save the payment method even if it cannot be charged (e.g. the user made a typo). To ensure that only payment methods which are likely to be chargeable are saved to a customer, use the (setup_future_usage)[#payment_intents/object#payment_intent_object-setup_future_usage] property, which saves the payment method after the PaymentIntent has been confirmed and all required actions by the customer are complete.
public PaymentIntentCreateParams.SetupFutureUsage getSetupFutureUsage()
Providing this parameter will attach the payment method to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be attached to a Customer after the transaction completes.
For more, learn to save card details during payment.
Stripe uses setup_future_usage
to dynamically optimize your payment flow and comply
with regional legislation and network rules. For example, if your customer is impacted by SCA, using off_session
will ensure that they are authenticated while processing this PaymentIntent. You
will then be able to collect off-session
payments for this customer.
public PaymentIntentCreateParams.Shipping getShipping()
public java.lang.String getSource()
payment_method
field instead, which also
supports Cards and compatible Source
objects.If neither the payment_method
parameter nor the source
parameter are
provided with confirm=true
, this field will be automatically populated with customer.default_source
to improve the migration experience for users of the Charges API. We
recommend that you explicitly provide the source
or payment_method
parameter
going forward.public java.lang.String getStatementDescriptor()
public java.lang.String getStatementDescriptorSuffix()
public PaymentIntentCreateParams.TransferData getTransferData()
public java.lang.String getTransferGroup()
public java.lang.Boolean getUseStripeSdk()
true
only when using manual confirmation and the iOS or Android SDKs to handle
additional authentication steps.