com.stripe.param

Class PaymentIntentCreateParams.Builder

java.lang.Object

com.stripe.param.PaymentIntentCreateParams.Builder

Enclosing class:

PaymentIntentCreateParams

public static class PaymentIntentCreateParams.Builder
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
PaymentIntentCreateParams.Builder	addAllExpand(java.util.List<java.lang.String> elements) Add all elements to `expand` list.
PaymentIntentCreateParams.Builder	addAllPaymentMethodType(java.util.List<java.lang.String> elements) Add all elements to `paymentMethodTypes` list.
PaymentIntentCreateParams.Builder	addExpand(java.lang.String element) Add an element to `expand` list.
PaymentIntentCreateParams.Builder	addPaymentMethodType(java.lang.String element) Add an element to `paymentMethodTypes` list.
PaymentIntentCreateParams	build() Finalize and obtain parameter instance from this builder.
PaymentIntentCreateParams.Builder	putAllExtraParam(java.util.Map<java.lang.String,java.lang.Object> map) Add all map key/value pairs to `extraParams` map.
PaymentIntentCreateParams.Builder	putAllMetadata(java.util.Map<java.lang.String,java.lang.String> map) Add all map key/value pairs to `metadata` map.
PaymentIntentCreateParams.Builder	putExtraParam(java.lang.String key, java.lang.Object value) Add a key/value pair to `extraParams` map.
PaymentIntentCreateParams.Builder	putMetadata(java.lang.String key, java.lang.String value) Add a key/value pair to `metadata` map.
PaymentIntentCreateParams.Builder	setAmount(java.lang.Long amount) A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency).
PaymentIntentCreateParams.Builder	setApplicationFeeAmount(java.lang.Long applicationFeeAmount) 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.Builder	setCaptureMethod(PaymentIntentCreateParams.CaptureMethod captureMethod) One of `automatic` (default) or `manual`.
PaymentIntentCreateParams.Builder	setConfirm(java.lang.Boolean confirm) Set to `true` to attempt to confirm this PaymentIntent immediately.
PaymentIntentCreateParams.Builder	setConfirmationMethod(PaymentIntentCreateParams.ConfirmationMethod confirmationMethod) One of `automatic` (default) or `manual`.
PaymentIntentCreateParams.Builder	setCurrency(java.lang.String currency) Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase.
PaymentIntentCreateParams.Builder	setCustomer(java.lang.String customer) ID of the customer this PaymentIntent is for if one exists.
PaymentIntentCreateParams.Builder	setDescription(java.lang.String description) An arbitrary string attached to the object.
PaymentIntentCreateParams.Builder	setOffSession(PaymentIntentCreateParams.OffSession offSession) Used in payment flows that collect payment details and charge later, when the customer is not available to complete additional required steps for the payment.
PaymentIntentCreateParams.Builder	setOnBehalfOf(java.lang.String onBehalfOf) The Stripe account ID for which these funds are intended.
PaymentIntentCreateParams.Builder	setPaymentMethod(java.lang.String paymentMethod) ID of the payment method (a PaymentMethod, Card, BankAccount, or saved Source object) to attach to this PaymentIntent.
PaymentIntentCreateParams.Builder	setReceiptEmail(java.lang.String receiptEmail) Email address that the receipt for the resulting payment will be sent to.
PaymentIntentCreateParams.Builder	setReturnUrl(java.lang.String returnUrl) The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site.
PaymentIntentCreateParams.Builder	setSavePaymentMethod(java.lang.Boolean savePaymentMethod) 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.
PaymentIntentCreateParams.Builder	setShipping(PaymentIntentCreateParams.Shipping shipping) Shipping information for this PaymentIntent.
PaymentIntentCreateParams.Builder	setSource(java.lang.String source) This is a legacy field that will be removed in the future.
PaymentIntentCreateParams.Builder	setStatementDescriptor(java.lang.String statementDescriptor) Extra information about a PaymentIntent.
PaymentIntentCreateParams.Builder	setTransferData(PaymentIntentCreateParams.TransferData transferData) The parameters used to automatically create a Transfer when the payment succeeds.
PaymentIntentCreateParams.Builder	setTransferGroup(java.lang.String transferGroup) A string that identifies the resulting payment as part of a group.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

build

public PaymentIntentCreateParams build()

Finalize and obtain parameter instance from this builder.

setAmount

public PaymentIntentCreateParams.Builder setAmount(java.lang.Long amount)

A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (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](https://support.stripe.com/questions/what-is-the-minimum-amount-i-can-charge-with-stripe).

setApplicationFeeAmount

public PaymentIntentCreateParams.Builder setApplicationFeeAmount(java.lang.Long applicationFeeAmount)

The amount of the application fee (if any) that will be applied to the payment and transferred to the application owner's Stripe account. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).

setCaptureMethod

public PaymentIntentCreateParams.Builder setCaptureMethod(PaymentIntentCreateParams.CaptureMethod captureMethod)

One of `automatic` (default) or `manual`.

When the capture method is `automatic`, Stripe automatically captures funds when the customer authorizes the payment.

Change `capture_method` to manual if you wish to [separate authorization and capture](https://stripe.com/docs/payments/payment-intents/creating-payment-intents#separate-authorization-and-capture) for payment methods that support this.

setConfirm

public PaymentIntentCreateParams.Builder setConfirm(java.lang.Boolean confirm)

Set to `true` to attempt to confirm this PaymentIntent immediately. This parameter defaults to `false`. If the payment method attached is a card, a return_url may be provided in case additional authentication is required.

setConfirmationMethod

public PaymentIntentCreateParams.Builder setConfirmationMethod(PaymentIntentCreateParams.ConfirmationMethod confirmationMethod)

One of `automatic` (default) or `manual`.

When the confirmation method is `automatic`, a PaymentIntent can be confirmed using a publishable key. After `next_action`s are handled, no additional confirmation is required to complete the payment.

When the confirmation method is `manual`, all payment attempts must be made using a secret key. The PaymentIntent returns to the `requires_confirmation` state after handling `next_action`s, and requires your server to initiate each payment attempt with an explicit confirmation.

Learn more about the different [confirmation flows](https://stripe.com/docs/payments/payment-intents#one-time-payments).

setCurrency

public PaymentIntentCreateParams.Builder setCurrency(java.lang.String currency)

Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).

setCustomer

public PaymentIntentCreateParams.Builder setCustomer(java.lang.String customer)

ID of the customer this PaymentIntent is for if one exists.

setDescription

public PaymentIntentCreateParams.Builder setDescription(java.lang.String description)

An arbitrary string attached to the object. Often useful for displaying to users.

addExpand

public PaymentIntentCreateParams.Builder addExpand(java.lang.String element)

Add an element to `expand` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See PaymentIntentCreateParams.expand for the field documentation.

addAllExpand

public PaymentIntentCreateParams.Builder addAllExpand(java.util.List<java.lang.String> elements)

Add all elements to `expand` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See PaymentIntentCreateParams.expand for the field documentation.

putExtraParam

public PaymentIntentCreateParams.Builder putExtraParam(java.lang.String key,
                                                       java.lang.Object value)

Add a key/value pair to `extraParams` map. A map is initialized for the first `put/putAll` call, and subsequent calls add additional key/value pairs to the original map. See PaymentIntentCreateParams.extraParams for the field documentation.

putAllExtraParam

public PaymentIntentCreateParams.Builder putAllExtraParam(java.util.Map<java.lang.String,java.lang.Object> map)

Add all map key/value pairs to `extraParams` map. A map is initialized for the first `put/putAll` call, and subsequent calls add additional key/value pairs to the original map. See PaymentIntentCreateParams.extraParams for the field documentation.

putMetadata

public PaymentIntentCreateParams.Builder putMetadata(java.lang.String key,
                                                     java.lang.String value)

Add a key/value pair to `metadata` map. A map is initialized for the first `put/putAll` call, and subsequent calls add additional key/value pairs to the original map. See PaymentIntentCreateParams.metadata for the field documentation.

putAllMetadata

public PaymentIntentCreateParams.Builder putAllMetadata(java.util.Map<java.lang.String,java.lang.String> map)

Add all map key/value pairs to `metadata` map. A map is initialized for the first `put/putAll` call, and subsequent calls add additional key/value pairs to the original map. See PaymentIntentCreateParams.metadata for the field documentation.

setOffSession

public PaymentIntentCreateParams.Builder setOffSession(PaymentIntentCreateParams.OffSession offSession)

Used in payment flows that collect payment details and charge later, when the customer is not available to complete additional required steps for the payment. Setting this parameter indicates that this payment attempt is happening while the customer is not in your checkout flow. Use `recurring` for payments made on a recurring basis (for example, subscriptions) and `one_off` for all other off-session payments.

setOnBehalfOf

public PaymentIntentCreateParams.Builder setOnBehalfOf(java.lang.String onBehalfOf)

The Stripe account ID for which these funds are intended. For details, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).

setPaymentMethod

public PaymentIntentCreateParams.Builder setPaymentMethod(java.lang.String paymentMethod)

ID of the payment method (a PaymentMethod, Card, BankAccount, or saved Source object) to attach to this PaymentIntent.

addPaymentMethodType

public PaymentIntentCreateParams.Builder addPaymentMethodType(java.lang.String element)

Add an element to `paymentMethodTypes` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See PaymentIntentCreateParams.paymentMethodTypes for the field documentation.

addAllPaymentMethodType

public PaymentIntentCreateParams.Builder addAllPaymentMethodType(java.util.List<java.lang.String> elements)

Add all elements to `paymentMethodTypes` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See PaymentIntentCreateParams.paymentMethodTypes for the field documentation.

setReceiptEmail

public PaymentIntentCreateParams.Builder setReceiptEmail(java.lang.String receiptEmail)

Email address that the receipt for the resulting payment will be sent to.

setReturnUrl

public PaymentIntentCreateParams.Builder setReturnUrl(java.lang.String returnUrl)

The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site. If you'd prefer to redirect to a mobile application, you can alternatively supply an application URI scheme. This param can only be used if `confirm=true`.

setSavePaymentMethod

public PaymentIntentCreateParams.Builder setSavePaymentMethod(java.lang.Boolean savePaymentMethod)

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. Defaults to `false`.

If the payment method is already saved to a customer, this does nothing. If this type of payment method cannot be saved to a customer, the request will error.

setShipping

public PaymentIntentCreateParams.Builder setShipping(PaymentIntentCreateParams.Shipping shipping)

Shipping information for this PaymentIntent.

setSource

public PaymentIntentCreateParams.Builder setSource(java.lang.String source)

This is a legacy field that will be removed in the future. It is the ID of the Source object to attach to this PaymentIntent. Please use the `payment_method` field instead, which also supports Source, Card, and BankAccount objects.

setStatementDescriptor

public PaymentIntentCreateParams.Builder setStatementDescriptor(java.lang.String statementDescriptor)

Extra information about a PaymentIntent. This will appear on your customer's statement when this PaymentIntent succeeds in creating a charge.

setTransferData

public PaymentIntentCreateParams.Builder setTransferData(PaymentIntentCreateParams.TransferData transferData)

The parameters used to automatically create a Transfer when the payment succeeds. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).

setTransferGroup

public PaymentIntentCreateParams.Builder setTransferGroup(java.lang.String transferGroup)

A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for details.