Package com.stripe.param

Class PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder

java.lang.Object

com.stripe.param.PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder

Enclosing class:

PaymentIntentCreateParams.PaymentMethodOptions.Card

public static class PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder
extends Object

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
PaymentIntentCreateParams.PaymentMethodOptions.Card	build()	Finalize and obtain parameter instance from this builder.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	putAllExtraParam(Map<String,Object> map)	Add all map key/value pairs to `extraParams` map.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	putExtraParam(String key, Object value)	Add a key/value pair to `extraParams` map.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setCaptureMethod(EmptyParam captureMethod)	Controls when the funds are captured from the customer's account.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setCaptureMethod(PaymentIntentCreateParams.PaymentMethodOptions.Card.CaptureMethod captureMethod)	Controls when the funds are captured from the customer's account.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setCvcToken(String cvcToken)	A single-use cvc_update Token that represents a card CVC value.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setInstallments(PaymentIntentCreateParams.PaymentMethodOptions.Card.Installments installments)	Installment configuration for payments attempted on this PaymentIntent (Mexico Only).
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setMandateOptions(PaymentIntentCreateParams.PaymentMethodOptions.Card.MandateOptions mandateOptions)	Configuration options for setting up an eMandate for cards issued in India.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setMoto(Boolean moto)	When specified, this parameter indicates that a transaction will be marked as MOTO (Mail Order Telephone Order) and thus out of scope for SCA.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setNetwork(PaymentIntentCreateParams.PaymentMethodOptions.Card.Network network)	Selected network to process this PaymentIntent on.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setRequestExtendedAuthorization(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestExtendedAuthorization requestExtendedAuthorization)	Request ability to capture beyond the standard authorization validity window for this PaymentIntent.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setRequestIncrementalAuthorization(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestIncrementalAuthorization requestIncrementalAuthorization)	Request ability to increment the authorization for this PaymentIntent.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setRequestMulticapture(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestMulticapture requestMulticapture)	Request ability to make multiple captures for this PaymentIntent.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setRequestOvercapture(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestOvercapture requestOvercapture)	Request ability to overcapture for this PaymentIntent.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setRequestThreeDSecure(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestThreeDSecure requestThreeDSecure)	We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setRequireCvcRecollection(Boolean requireCvcRecollection)	When enabled, using a card that is attached to a customer will require the CVC to be provided again (i.e.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setSetupFutureUsage(EmptyParam setupFutureUsage)	Indicates that you intend to make future payments with this PaymentIntent's payment method.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setSetupFutureUsage(PaymentIntentCreateParams.PaymentMethodOptions.Card.SetupFutureUsage setupFutureUsage)	Indicates that you intend to make future payments with this PaymentIntent's payment method.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setStatementDescriptorSuffixKana(EmptyParam statementDescriptorSuffixKana)	Provides information about a card payment that customers see on their statements.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setStatementDescriptorSuffixKana(String statementDescriptorSuffixKana)	Provides information about a card payment that customers see on their statements.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setStatementDescriptorSuffixKanji(EmptyParam statementDescriptorSuffixKanji)	Provides information about a card payment that customers see on their statements.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setStatementDescriptorSuffixKanji(String statementDescriptorSuffixKanji)	Provides information about a card payment that customers see on their statements.
PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder	setThreeDSecure(PaymentIntentCreateParams.PaymentMethodOptions.Card.ThreeDSecure threeDSecure)	If 3D Secure authentication was performed with a third-party provider, the authentication details to use for this payment.

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

public Builder()

Method Details

build

public PaymentIntentCreateParams.PaymentMethodOptions.Card build()

Finalize and obtain parameter instance from this builder.

setCaptureMethod

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setCaptureMethod(PaymentIntentCreateParams.PaymentMethodOptions.Card.CaptureMethod captureMethod)

Controls when the funds are captured from the customer's account.

If provided, this parameter overrides the behavior of the top-level capture_method for this payment method type when finalizing the payment with this payment method type.

If capture_method is already set on the PaymentIntent, providing an empty value for this parameter unsets the stored value for this payment method type.

setCaptureMethod

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setCaptureMethod(EmptyParam captureMethod)

Controls when the funds are captured from the customer's account.

If provided, this parameter overrides the behavior of the top-level capture_method for this payment method type when finalizing the payment with this payment method type.

If capture_method is already set on the PaymentIntent, providing an empty value for this parameter unsets the stored value for this payment method type.

setCvcToken

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setCvcToken(String cvcToken)

A single-use cvc_update Token that represents a card CVC value. When provided, the CVC value will be verified during the card payment attempt. This parameter can only be provided during confirmation.

putExtraParam

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder putExtraParam(String key,
 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.PaymentMethodOptions.Card.extraParams for the field documentation.

putAllExtraParam

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder putAllExtraParam(Map<String,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.PaymentMethodOptions.Card.extraParams for the field documentation.

setInstallments

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setInstallments(PaymentIntentCreateParams.PaymentMethodOptions.Card.Installments installments)

Installment configuration for payments attempted on this PaymentIntent (Mexico Only).

For more information, see the installments integration guide.

setMandateOptions

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setMandateOptions(PaymentIntentCreateParams.PaymentMethodOptions.Card.MandateOptions mandateOptions)

Configuration options for setting up an eMandate for cards issued in India.

setMoto

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setMoto(Boolean moto)

When specified, this parameter indicates that a transaction will be marked as MOTO (Mail Order Telephone Order) and thus out of scope for SCA. This parameter can only be provided during confirmation.

setNetwork

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setNetwork(PaymentIntentCreateParams.PaymentMethodOptions.Card.Network network)

Selected network to process this PaymentIntent on. Depends on the available networks of the card attached to the PaymentIntent. Can be only set confirm-time.

setRequestExtendedAuthorization

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setRequestExtendedAuthorization(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestExtendedAuthorization requestExtendedAuthorization)

Request ability to capture beyond the standard authorization validity window for this PaymentIntent.

setRequestIncrementalAuthorization

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setRequestIncrementalAuthorization(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestIncrementalAuthorization requestIncrementalAuthorization)

Request ability to increment the authorization for this PaymentIntent.

setRequestMulticapture

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setRequestMulticapture(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestMulticapture requestMulticapture)

Request ability to make multiple captures for this PaymentIntent.

setRequestOvercapture

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setRequestOvercapture(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestOvercapture requestOvercapture)

Request ability to overcapture for this PaymentIntent.

setRequestThreeDSecure

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setRequestThreeDSecure(PaymentIntentCreateParams.PaymentMethodOptions.Card.RequestThreeDSecure requestThreeDSecure)

We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to automatic. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.

setRequireCvcRecollection

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setRequireCvcRecollection(Boolean requireCvcRecollection)

When enabled, using a card that is attached to a customer will require the CVC to be provided again (i.e. using the cvc_token parameter).

setSetupFutureUsage

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setSetupFutureUsage(PaymentIntentCreateParams.PaymentMethodOptions.Card.SetupFutureUsage setupFutureUsage)

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_present and 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_usage to help you comply with regional legislation and network rules, such as SCA.

If you've already set setup_future_usage and you're performing a request using a publishable key, you can only update the value from on_session to off_session.

setSetupFutureUsage

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setSetupFutureUsage(EmptyParam setupFutureUsage)

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_present and 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_usage to help you comply with regional legislation and network rules, such as SCA.

If you've already set setup_future_usage and you're performing a request using a publishable key, you can only update the value from on_session to off_session.

setStatementDescriptorSuffixKana

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setStatementDescriptorSuffixKana(String statementDescriptorSuffixKana)

Provides information about a card payment that customers see on their statements. Concatenated with the Kana prefix (shortened Kana descriptor) or Kana statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 22 characters. On card statements, the concatenation of both prefix and suffix (including separators) will appear truncated to 22 characters.

setStatementDescriptorSuffixKana

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setStatementDescriptorSuffixKana(EmptyParam statementDescriptorSuffixKana)

Provides information about a card payment that customers see on their statements. Concatenated with the Kana prefix (shortened Kana descriptor) or Kana statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 22 characters. On card statements, the concatenation of both prefix and suffix (including separators) will appear truncated to 22 characters.

setStatementDescriptorSuffixKanji

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setStatementDescriptorSuffixKanji(String statementDescriptorSuffixKanji)

Provides information about a card payment that customers see on their statements. Concatenated with the Kanji prefix (shortened Kanji descriptor) or Kanji statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 17 characters. On card statements, the concatenation of both prefix and suffix (including separators) will appear truncated to 17 characters.

setStatementDescriptorSuffixKanji

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setStatementDescriptorSuffixKanji(EmptyParam statementDescriptorSuffixKanji)

Provides information about a card payment that customers see on their statements. Concatenated with the Kanji prefix (shortened Kanji descriptor) or Kanji statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 17 characters. On card statements, the concatenation of both prefix and suffix (including separators) will appear truncated to 17 characters.

setThreeDSecure

public PaymentIntentCreateParams.PaymentMethodOptions.Card.Builder setThreeDSecure(PaymentIntentCreateParams.PaymentMethodOptions.Card.ThreeDSecure threeDSecure)

If 3D Secure authentication was performed with a third-party provider, the authentication details to use for this payment.