com.stripe.model.ConfirmationToken Maven / Gradle / Ivy
// File generated from our OpenAPI spec
package com.stripe.model;
import com.google.gson.annotations.SerializedName;
import com.stripe.exception.StripeException;
import com.stripe.net.ApiMode;
import com.stripe.net.ApiRequest;
import com.stripe.net.ApiRequestParams;
import com.stripe.net.ApiResource;
import com.stripe.net.BaseAddress;
import com.stripe.net.RequestOptions;
import com.stripe.net.StripeResponseGetter;
import com.stripe.param.ConfirmationTokenCreateParams;
import com.stripe.param.ConfirmationTokenRetrieveParams;
import java.util.List;
import java.util.Map;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.Setter;
/**
* ConfirmationTokens help transport client side data collected by Stripe JS over to your server for
* confirming a PaymentIntent or SetupIntent. If the confirmation is successful, values present on
* the ConfirmationToken are written onto the Intent.
*
* To learn more about how to use ConfirmationToken, visit the related guides: - Finalize payments on the
* server - Build
* two-step confirmation.
*/
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public class ConfirmationToken extends ApiResource implements HasId {
/** Time at which the object was created. Measured in seconds since the Unix epoch. */
@SerializedName("created")
Long created;
/**
* Time at which this ConfirmationToken expires and can no longer be used to confirm a
* PaymentIntent or SetupIntent. This is set to null once this ConfirmationToken has been used.
*/
@SerializedName("expires_at")
Long expiresAt;
/** Unique identifier for the object. */
@Getter(onMethod_ = {@Override})
@SerializedName("id")
String id;
/**
* Has the value {@code true} if the object exists in live mode or the value {@code false} if the
* object exists in test mode.
*/
@SerializedName("livemode")
Boolean livemode;
/** Data used for generating a Mandate. */
@SerializedName("mandate_data")
MandateData mandateData;
/**
* String representing the object's type. Objects of the same type share the same value.
*
*
Equal to {@code confirmation_token}.
*/
@SerializedName("object")
String object;
/**
* ID of the PaymentIntent that this ConfirmationToken was used to confirm, or null if this
* ConfirmationToken has not yet been used.
*/
@SerializedName("payment_intent")
String paymentIntent;
/**
* Payment details collected by the Payment Element, used to create a PaymentMethod when a
* PaymentIntent or SetupIntent is confirmed with this ConfirmationToken.
*/
@SerializedName("payment_method_preview")
PaymentMethodPreview paymentMethodPreview;
/** Return URL used to confirm the Intent. */
@SerializedName("return_url")
String returnUrl;
/**
* Indicates that you intend to make future payments with this ConfirmationToken's payment method.
*
*
The presence of this property 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.
*
*
One of {@code off_session}, or {@code on_session}.
*/
@SerializedName("setup_future_usage")
String setupFutureUsage;
/**
* ID of the SetupIntent that this ConfirmationToken was used to confirm, or null if this
* ConfirmationToken has not yet been used.
*/
@SerializedName("setup_intent")
String setupIntent;
/** Shipping information collected on this ConfirmationToken. */
@SerializedName("shipping")
Shipping shipping;
/**
* Indicates whether the Stripe SDK is used to handle confirmation flow. Defaults to {@code true}
* on ConfirmationToken.
*/
@SerializedName("use_stripe_sdk")
Boolean useStripeSdk;
/** Retrieves an existing ConfirmationToken object. */
public static ConfirmationToken retrieve(String confirmationToken) throws StripeException {
return retrieve(confirmationToken, (Map) null, (RequestOptions) null);
}
/** Retrieves an existing ConfirmationToken object. */
public static ConfirmationToken retrieve(String confirmationToken, RequestOptions options)
throws StripeException {
return retrieve(confirmationToken, (Map) null, options);
}
/** Retrieves an existing ConfirmationToken object. */
public static ConfirmationToken retrieve(
String confirmationToken, Map params, RequestOptions options)
throws StripeException {
String path =
String.format("/v1/confirmation_tokens/%s", ApiResource.urlEncodeId(confirmationToken));
ApiRequest request =
new ApiRequest(
BaseAddress.API, ApiResource.RequestMethod.GET, path, params, options, ApiMode.V1);
return getGlobalResponseGetter().request(request, ConfirmationToken.class);
}
/** Retrieves an existing ConfirmationToken object. */
public static ConfirmationToken retrieve(
String confirmationToken, ConfirmationTokenRetrieveParams params, RequestOptions options)
throws StripeException {
String path =
String.format("/v1/confirmation_tokens/%s", ApiResource.urlEncodeId(confirmationToken));
ApiResource.checkNullTypedParams(path, params);
ApiRequest request =
new ApiRequest(
BaseAddress.API,
ApiResource.RequestMethod.GET,
path,
ApiRequestParams.paramsToMap(params),
options,
ApiMode.V1);
return getGlobalResponseGetter().request(request, ConfirmationToken.class);
}
/** Data used for generating a Mandate. */
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class MandateData extends StripeObject {
/** This hash contains details about the customer acceptance of the Mandate. */
@SerializedName("customer_acceptance")
CustomerAcceptance customerAcceptance;
/** This hash contains details about the customer acceptance of the Mandate. */
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class CustomerAcceptance extends StripeObject {
/**
* If this is a Mandate accepted online, this hash contains details about the online
* acceptance.
*/
@SerializedName("online")
Online online;
/** The type of customer acceptance information included with the Mandate. */
@SerializedName("type")
String type;
/** This hash contains details about the online acceptance. */
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Online extends StripeObject {
/** The IP address from which the Mandate was accepted by the customer. */
@SerializedName("ip_address")
String ipAddress;
/** The user agent of the browser from which the Mandate was accepted by the customer. */
@SerializedName("user_agent")
String userAgent;
}
}
}
/** Details of the PaymentMethod collected by Payment Element. */
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class PaymentMethodPreview extends StripeObject {
@SerializedName("acss_debit")
AcssDebit acssDebit;
@SerializedName("affirm")
Affirm affirm;
@SerializedName("afterpay_clearpay")
AfterpayClearpay afterpayClearpay;
@SerializedName("alipay")
Alipay alipay;
@SerializedName("au_becs_debit")
AuBecsDebit auBecsDebit;
@SerializedName("bacs_debit")
BacsDebit bacsDebit;
@SerializedName("bancontact")
Bancontact bancontact;
@SerializedName("billing_details")
BillingDetails billingDetails;
@SerializedName("blik")
Blik blik;
@SerializedName("boleto")
Boleto boleto;
@SerializedName("card")
Card card;
@SerializedName("card_present")
CardPresent cardPresent;
@SerializedName("cashapp")
Cashapp cashapp;
@SerializedName("customer_balance")
CustomerBalance customerBalance;
@SerializedName("eps")
Eps eps;
@SerializedName("fpx")
Fpx fpx;
@SerializedName("giropay")
Giropay giropay;
@SerializedName("grabpay")
Grabpay grabpay;
@SerializedName("ideal")
Ideal ideal;
@SerializedName("interac_present")
InteracPresent interacPresent;
@SerializedName("klarna")
Klarna klarna;
@SerializedName("konbini")
Konbini konbini;
@SerializedName("link")
Link link;
@SerializedName("mobilepay")
Mobilepay mobilepay;
@SerializedName("oxxo")
Oxxo oxxo;
@SerializedName("p24")
P24 p24;
@SerializedName("paynow")
Paynow paynow;
@SerializedName("paypal")
Paypal paypal;
@SerializedName("pix")
Pix pix;
@SerializedName("promptpay")
Promptpay promptpay;
@SerializedName("revolut_pay")
RevolutPay revolutPay;
@SerializedName("sepa_debit")
SepaDebit sepaDebit;
@SerializedName("sofort")
Sofort sofort;
@SerializedName("swish")
Swish swish;
/**
* The type of the PaymentMethod. An additional hash is included on the PaymentMethod with a
* name matching this value. It contains additional information specific to the PaymentMethod
* type.
*
* One of {@code acss_debit}, {@code affirm}, {@code afterpay_clearpay}, {@code alipay},
* {@code au_becs_debit}, {@code bacs_debit}, {@code bancontact}, {@code blik}, {@code boleto},
* {@code card}, {@code card_present}, {@code cashapp}, {@code customer_balance}, {@code eps},
* {@code fpx}, {@code giropay}, {@code grabpay}, {@code ideal}, {@code interac_present}, {@code
* klarna}, {@code konbini}, {@code link}, {@code mobilepay}, {@code oxxo}, {@code p24}, {@code
* paynow}, {@code paypal}, {@code pix}, {@code promptpay}, {@code revolut_pay}, {@code
* sepa_debit}, {@code sofort}, {@code swish}, {@code us_bank_account}, {@code wechat_pay}, or
* {@code zip}.
*/
@SerializedName("type")
String type;
@SerializedName("us_bank_account")
UsBankAccount usBankAccount;
@SerializedName("wechat_pay")
WechatPay wechatPay;
@SerializedName("zip")
Zip zip;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class AcssDebit extends StripeObject {
/** Name of the bank associated with the bank account. */
@SerializedName("bank_name")
String bankName;
/**
* Uniquely identifies this particular bank account. You can use this attribute to check
* whether two bank accounts are the same.
*/
@SerializedName("fingerprint")
String fingerprint;
/** Institution number of the bank account. */
@SerializedName("institution_number")
String institutionNumber;
/** Last four digits of the bank account number. */
@SerializedName("last4")
String last4;
/** Transit number of the bank account. */
@SerializedName("transit_number")
String transitNumber;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Affirm extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class AfterpayClearpay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Alipay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class AuBecsDebit extends StripeObject {
/** Six-digit number identifying bank and branch associated with this bank account. */
@SerializedName("bsb_number")
String bsbNumber;
/**
* Uniquely identifies this particular bank account. You can use this attribute to check
* whether two bank accounts are the same.
*/
@SerializedName("fingerprint")
String fingerprint;
/** Last four digits of the bank account number. */
@SerializedName("last4")
String last4;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class BacsDebit extends StripeObject {
/**
* Uniquely identifies this particular bank account. You can use this attribute to check
* whether two bank accounts are the same.
*/
@SerializedName("fingerprint")
String fingerprint;
/** Last four digits of the bank account number. */
@SerializedName("last4")
String last4;
/** Sort code of the bank account. (e.g., {@code 10-20-30}) */
@SerializedName("sort_code")
String sortCode;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Bancontact extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class BillingDetails extends StripeObject {
/** Billing address. */
@SerializedName("address")
Address address;
/** Email address. */
@SerializedName("email")
String email;
/** Full name. */
@SerializedName("name")
String name;
/** Billing phone number (including extension). */
@SerializedName("phone")
String phone;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Blik extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Boleto extends StripeObject {
/** Uniquely identifies the customer tax id (CNPJ or CPF). */
@SerializedName("tax_id")
String taxId;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Card extends StripeObject {
/**
* Card brand. Can be {@code amex}, {@code diners}, {@code discover}, {@code eftpos_au},
* {@code jcb}, {@code mastercard}, {@code unionpay}, {@code visa}, or {@code unknown}.
*/
@SerializedName("brand")
String brand;
/** Checks on Card address and CVC if provided. */
@SerializedName("checks")
Checks checks;
/**
* Two-letter ISO code representing the country of the card. You could use this attribute to
* get a sense of the international breakdown of cards you've collected.
*/
@SerializedName("country")
String country;
/**
* A high-level description of the type of cards issued in this range. (For internal use only
* and not typically available in standard API requests.)
*/
@SerializedName("description")
String description;
/**
* The brand to use when displaying the card, this accounts for customer's brand choice on
* dual-branded cards. Can be {@code american_express}, {@code cartes_bancaires}, {@code
* diners_club}, {@code discover}, {@code eftpos_australia}, {@code interac}, {@code jcb},
* {@code mastercard}, {@code union_pay}, {@code visa}, or {@code other} and may contain more
* values in the future.
*/
@SerializedName("display_brand")
String displayBrand;
/** Two-digit number representing the card's expiration month. */
@SerializedName("exp_month")
Long expMonth;
/** Four-digit number representing the card's expiration year. */
@SerializedName("exp_year")
Long expYear;
/**
* Uniquely identifies this particular card number. You can use this attribute to check
* whether two customers who’ve signed up with you are using the same card number, for
* example. For payment methods that tokenize card information (Apple Pay, Google Pay), the
* tokenized number might be provided instead of the underlying card number.
*
*
As of May 1, 2021, card fingerprint in India for Connect changed to allow two
* fingerprints for the same card---one for India and one for the rest of the world.
*/
@SerializedName("fingerprint")
String fingerprint;
/**
* Card funding type. Can be {@code credit}, {@code debit}, {@code prepaid}, or {@code
* unknown}.
*/
@SerializedName("funding")
String funding;
/**
* Issuer identification number of the card. (For internal use only and not typically
* available in standard API requests.)
*/
@SerializedName("iin")
String iin;
/**
* The name of the card's issuing bank. (For internal use only and not typically available in
* standard API requests.)
*/
@SerializedName("issuer")
String issuer;
/** The last four digits of the card. */
@SerializedName("last4")
String last4;
/** Contains information about card networks that can be used to process the payment. */
@SerializedName("networks")
Networks networks;
/** Contains details on how this Card may be used for 3D Secure authentication. */
@SerializedName("three_d_secure_usage")
ThreeDSecureUsage threeDSecureUsage;
/** If this Card is part of a card wallet, this contains the details of the card wallet. */
@SerializedName("wallet")
Wallet wallet;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Checks extends StripeObject {
/**
* If a address line1 was provided, results of the check, one of {@code pass}, {@code fail},
* {@code unavailable}, or {@code unchecked}.
*/
@SerializedName("address_line1_check")
String addressLine1Check;
/**
* If a address postal code was provided, results of the check, one of {@code pass}, {@code
* fail}, {@code unavailable}, or {@code unchecked}.
*/
@SerializedName("address_postal_code_check")
String addressPostalCodeCheck;
/**
* If a CVC was provided, results of the check, one of {@code pass}, {@code fail}, {@code
* unavailable}, or {@code unchecked}.
*/
@SerializedName("cvc_check")
String cvcCheck;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Networks extends StripeObject {
/** All available networks for the card. */
@SerializedName("available")
List available;
/**
* The preferred network for co-branded cards. Can be {@code cartes_bancaires}, {@code
* mastercard}, {@code visa} or {@code invalid_preference} if requested network is not valid
* for the card.
*/
@SerializedName("preferred")
String preferred;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class ThreeDSecureUsage extends StripeObject {
/** Whether 3D Secure is supported on this card. */
@SerializedName("supported")
Boolean supported;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Wallet extends StripeObject {
@SerializedName("amex_express_checkout")
AmexExpressCheckout amexExpressCheckout;
@SerializedName("apple_pay")
ApplePay applePay;
/** (For tokenized numbers only.) The last four digits of the device account number. */
@SerializedName("dynamic_last4")
String dynamicLast4;
@SerializedName("google_pay")
GooglePay googlePay;
@SerializedName("link")
Link link;
@SerializedName("masterpass")
Masterpass masterpass;
@SerializedName("samsung_pay")
SamsungPay samsungPay;
/**
* The type of the card wallet, one of {@code amex_express_checkout}, {@code apple_pay},
* {@code google_pay}, {@code masterpass}, {@code samsung_pay}, {@code visa_checkout}, or
* {@code link}. An additional hash is included on the Wallet subhash with a name matching
* this value. It contains additional information specific to the card wallet type.
*/
@SerializedName("type")
String type;
@SerializedName("visa_checkout")
VisaCheckout visaCheckout;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class AmexExpressCheckout extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class ApplePay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class GooglePay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Link extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Masterpass extends StripeObject {
/**
* Owner's verified billing address. Values are verified or provided by the wallet
* directly (if supported) at the time of authorization or settlement. They cannot be set
* or mutated.
*/
@SerializedName("billing_address")
Address billingAddress;
/**
* Owner's verified email. Values are verified or provided by the wallet directly (if
* supported) at the time of authorization or settlement. They cannot be set or mutated.
*/
@SerializedName("email")
String email;
/**
* Owner's verified full name. Values are verified or provided by the wallet directly (if
* supported) at the time of authorization or settlement. They cannot be set or mutated.
*/
@SerializedName("name")
String name;
/**
* Owner's verified shipping address. Values are verified or provided by the wallet
* directly (if supported) at the time of authorization or settlement. They cannot be set
* or mutated.
*/
@SerializedName("shipping_address")
Address shippingAddress;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class SamsungPay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class VisaCheckout extends StripeObject {
/**
* Owner's verified billing address. Values are verified or provided by the wallet
* directly (if supported) at the time of authorization or settlement. They cannot be set
* or mutated.
*/
@SerializedName("billing_address")
Address billingAddress;
/**
* Owner's verified email. Values are verified or provided by the wallet directly (if
* supported) at the time of authorization or settlement. They cannot be set or mutated.
*/
@SerializedName("email")
String email;
/**
* Owner's verified full name. Values are verified or provided by the wallet directly (if
* supported) at the time of authorization or settlement. They cannot be set or mutated.
*/
@SerializedName("name")
String name;
/**
* Owner's verified shipping address. Values are verified or provided by the wallet
* directly (if supported) at the time of authorization or settlement. They cannot be set
* or mutated.
*/
@SerializedName("shipping_address")
Address shippingAddress;
}
}
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class CardPresent extends StripeObject {
/**
* Card brand. Can be {@code amex}, {@code diners}, {@code discover}, {@code eftpos_au},
* {@code jcb}, {@code mastercard}, {@code unionpay}, {@code visa}, or {@code unknown}.
*/
@SerializedName("brand")
String brand;
/**
* The cardholder name as read from the card, in ISO 7813 format. May include
* alphanumeric characters, special characters and first/last name separator ({@code /}). In
* some cases, the cardholder name may not be available depending on how the issuer has
* configured the card. Cardholder name is typically not available on swipe or contactless
* payments, such as those made with Apple Pay and Google Pay.
*/
@SerializedName("cardholder_name")
String cardholderName;
/**
* Two-letter ISO code representing the country of the card. You could use this attribute to
* get a sense of the international breakdown of cards you've collected.
*/
@SerializedName("country")
String country;
/**
* A high-level description of the type of cards issued in this range. (For internal use only
* and not typically available in standard API requests.)
*/
@SerializedName("description")
String description;
/** Two-digit number representing the card's expiration month. */
@SerializedName("exp_month")
Long expMonth;
/** Four-digit number representing the card's expiration year. */
@SerializedName("exp_year")
Long expYear;
/**
* Uniquely identifies this particular card number. You can use this attribute to check
* whether two customers who’ve signed up with you are using the same card number, for
* example. For payment methods that tokenize card information (Apple Pay, Google Pay), the
* tokenized number might be provided instead of the underlying card number.
*
* As of May 1, 2021, card fingerprint in India for Connect changed to allow two
* fingerprints for the same card---one for India and one for the rest of the world.
*/
@SerializedName("fingerprint")
String fingerprint;
/**
* Card funding type. Can be {@code credit}, {@code debit}, {@code prepaid}, or {@code
* unknown}.
*/
@SerializedName("funding")
String funding;
/**
* Issuer identification number of the card. (For internal use only and not typically
* available in standard API requests.)
*/
@SerializedName("iin")
String iin;
/**
* The name of the card's issuing bank. (For internal use only and not typically available in
* standard API requests.)
*/
@SerializedName("issuer")
String issuer;
/** The last four digits of the card. */
@SerializedName("last4")
String last4;
/** Contains information about card networks that can be used to process the payment. */
@SerializedName("networks")
Networks networks;
/**
* How card details were read in this transaction.
*
*
One of {@code contact_emv}, {@code contactless_emv}, {@code contactless_magstripe_mode},
* {@code magnetic_stripe_fallback}, or {@code magnetic_stripe_track2}.
*/
@SerializedName("read_method")
String readMethod;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Networks extends StripeObject {
/** All available networks for the card. */
@SerializedName("available")
List available;
/** The preferred network for the card. */
@SerializedName("preferred")
String preferred;
}
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Cashapp extends StripeObject {
/** A unique and immutable identifier assigned by Cash App to every buyer. */
@SerializedName("buyer_id")
String buyerId;
/** A public identifier for buyers using Cash App. */
@SerializedName("cashtag")
String cashtag;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class CustomerBalance extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Eps extends StripeObject {
/**
* The customer's bank. Should be one of {@code arzte_und_apotheker_bank}, {@code
* austrian_anadi_bank_ag}, {@code bank_austria}, {@code bankhaus_carl_spangler}, {@code
* bankhaus_schelhammer_und_schattera_ag}, {@code bawag_psk_ag}, {@code bks_bank_ag}, {@code
* brull_kallmus_bank_ag}, {@code btv_vier_lander_bank}, {@code capital_bank_grawe_gruppe_ag},
* {@code deutsche_bank_ag}, {@code dolomitenbank}, {@code easybank_ag}, {@code
* erste_bank_und_sparkassen}, {@code hypo_alpeadriabank_international_ag}, {@code
* hypo_noe_lb_fur_niederosterreich_u_wien}, {@code hypo_oberosterreich_salzburg_steiermark},
* {@code hypo_tirol_bank_ag}, {@code hypo_vorarlberg_bank_ag}, {@code
* hypo_bank_burgenland_aktiengesellschaft}, {@code marchfelder_bank}, {@code oberbank_ag},
* {@code raiffeisen_bankengruppe_osterreich}, {@code schoellerbank_ag}, {@code
* sparda_bank_wien}, {@code volksbank_gruppe}, {@code volkskreditbank_ag}, or {@code
* vr_bank_braunau}.
*/
@SerializedName("bank")
String bank;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Fpx extends StripeObject {
/** Account holder type, if provided. Can be one of {@code individual} or {@code company}. */
@SerializedName("account_holder_type")
String accountHolderType;
/**
* The customer's bank, if provided. Can be one of {@code affin_bank}, {@code agrobank},
* {@code alliance_bank}, {@code ambank}, {@code bank_islam}, {@code bank_muamalat}, {@code
* bank_rakyat}, {@code bsn}, {@code cimb}, {@code hong_leong_bank}, {@code hsbc}, {@code
* kfh}, {@code maybank2u}, {@code ocbc}, {@code public_bank}, {@code rhb}, {@code
* standard_chartered}, {@code uob}, {@code deutsche_bank}, {@code maybank2e}, {@code
* pb_enterprise}, or {@code bank_of_china}.
*/
@SerializedName("bank")
String bank;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Giropay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Grabpay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Ideal extends StripeObject {
/**
* The customer's bank, if provided. Can be one of {@code abn_amro}, {@code asn_bank}, {@code
* bunq}, {@code handelsbanken}, {@code ing}, {@code knab}, {@code moneyou}, {@code n26},
* {@code nn}, {@code rabobank}, {@code regiobank}, {@code revolut}, {@code sns_bank}, {@code
* triodos_bank}, {@code van_lanschot}, or {@code yoursafe}.
*/
@SerializedName("bank")
String bank;
/**
* The Bank Identifier Code of the customer's bank, if the bank was provided.
*
* One of {@code ABNANL2A}, {@code ASNBNL21}, {@code BITSNL2A}, {@code BUNQNL2A}, {@code
* FVLBNL22}, {@code HANDNL2A}, {@code INGBNL2A}, {@code KNABNL2H}, {@code MOYONL21}, {@code
* NNBANL2G}, {@code NTSBDEB1}, {@code RABONL2U}, {@code RBRBNL21}, {@code REVOIE23}, {@code
* REVOLT21}, {@code SNSBNL2A}, or {@code TRIONL2U}.
*/
@SerializedName("bic")
String bic;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class InteracPresent extends StripeObject {
/** Card brand. Can be {@code interac}, {@code mastercard} or {@code visa}. */
@SerializedName("brand")
String brand;
/**
* The cardholder name as read from the card, in ISO 7813 format. May include
* alphanumeric characters, special characters and first/last name separator ({@code /}). In
* some cases, the cardholder name may not be available depending on how the issuer has
* configured the card. Cardholder name is typically not available on swipe or contactless
* payments, such as those made with Apple Pay and Google Pay.
*/
@SerializedName("cardholder_name")
String cardholderName;
/**
* Two-letter ISO code representing the country of the card. You could use this attribute to
* get a sense of the international breakdown of cards you've collected.
*/
@SerializedName("country")
String country;
/**
* A high-level description of the type of cards issued in this range. (For internal use only
* and not typically available in standard API requests.)
*/
@SerializedName("description")
String description;
/** Two-digit number representing the card's expiration month. */
@SerializedName("exp_month")
Long expMonth;
/** Four-digit number representing the card's expiration year. */
@SerializedName("exp_year")
Long expYear;
/**
* Uniquely identifies this particular card number. You can use this attribute to check
* whether two customers who’ve signed up with you are using the same card number, for
* example. For payment methods that tokenize card information (Apple Pay, Google Pay), the
* tokenized number might be provided instead of the underlying card number.
*
*
As of May 1, 2021, card fingerprint in India for Connect changed to allow two
* fingerprints for the same card---one for India and one for the rest of the world.
*/
@SerializedName("fingerprint")
String fingerprint;
/**
* Card funding type. Can be {@code credit}, {@code debit}, {@code prepaid}, or {@code
* unknown}.
*/
@SerializedName("funding")
String funding;
/**
* Issuer identification number of the card. (For internal use only and not typically
* available in standard API requests.)
*/
@SerializedName("iin")
String iin;
/**
* The name of the card's issuing bank. (For internal use only and not typically available in
* standard API requests.)
*/
@SerializedName("issuer")
String issuer;
/** The last four digits of the card. */
@SerializedName("last4")
String last4;
/** Contains information about card networks that can be used to process the payment. */
@SerializedName("networks")
Networks networks;
/** EMV tag 5F2D. Preferred languages specified by the integrated circuit chip. */
@SerializedName("preferred_locales")
List preferredLocales;
/**
* How card details were read in this transaction.
*
* One of {@code contact_emv}, {@code contactless_emv}, {@code contactless_magstripe_mode},
* {@code magnetic_stripe_fallback}, or {@code magnetic_stripe_track2}.
*/
@SerializedName("read_method")
String readMethod;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Networks extends StripeObject {
/** All available networks for the card. */
@SerializedName("available")
List available;
/** The preferred network for the card. */
@SerializedName("preferred")
String preferred;
}
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Klarna extends StripeObject {
/** The customer's date of birth, if provided. */
@SerializedName("dob")
Dob dob;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Dob extends StripeObject {
/** The day of birth, between 1 and 31. */
@SerializedName("day")
Long day;
/** The month of birth, between 1 and 12. */
@SerializedName("month")
Long month;
/** The four-digit year of birth. */
@SerializedName("year")
Long year;
}
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Konbini extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Link extends StripeObject {
/** Account owner's email address. */
@SerializedName("email")
String email;
/** [Deprecated] This is a legacy parameter that no longer has any function. */
@SerializedName("persistent_token")
String persistentToken;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Mobilepay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Oxxo extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class P24 extends StripeObject {
/**
* The customer's bank, if provided.
*
* One of {@code alior_bank}, {@code bank_millennium}, {@code bank_nowy_bfg_sa}, {@code
* bank_pekao_sa}, {@code banki_spbdzielcze}, {@code blik}, {@code bnp_paribas}, {@code boz},
* {@code citi_handlowy}, {@code credit_agricole}, {@code envelobank}, {@code
* etransfer_pocztowy24}, {@code getin_bank}, {@code ideabank}, {@code ing}, {@code inteligo},
* {@code mbank_mtransfer}, {@code nest_przelew}, {@code noble_pay}, {@code pbac_z_ipko},
* {@code plus_bank}, {@code santander_przelew24}, {@code tmobile_usbugi_bankowe}, {@code
* toyota_bank}, {@code velobank}, or {@code volkswagen_bank}.
*/
@SerializedName("bank")
String bank;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Paynow extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Paypal extends StripeObject {
/**
* Owner's email. Values are provided by PayPal directly (if supported) at the time of
* authorization or settlement. They cannot be set or mutated.
*/
@SerializedName("payer_email")
String payerEmail;
/** PayPal account PayerID. This identifier uniquely identifies the PayPal customer. */
@SerializedName("payer_id")
String payerId;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Pix extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Promptpay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class RevolutPay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class SepaDebit extends StripeObject {
/** Bank code of bank associated with the bank account. */
@SerializedName("bank_code")
String bankCode;
/** Branch code of bank associated with the bank account. */
@SerializedName("branch_code")
String branchCode;
/** Two-letter ISO code representing the country the bank account is located in. */
@SerializedName("country")
String country;
/**
* Uniquely identifies this particular bank account. You can use this attribute to check
* whether two bank accounts are the same.
*/
@SerializedName("fingerprint")
String fingerprint;
/** Information about the object that generated this PaymentMethod. */
@SerializedName("generated_from")
GeneratedFrom generatedFrom;
/** Last four characters of the IBAN. */
@SerializedName("last4")
String last4;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class GeneratedFrom extends StripeObject {
/** The ID of the Charge that generated this PaymentMethod, if any. */
@SerializedName("charge")
@Getter(lombok.AccessLevel.NONE)
@Setter(lombok.AccessLevel.NONE)
ExpandableField charge;
/** The ID of the SetupAttempt that generated this PaymentMethod, if any. */
@SerializedName("setup_attempt")
@Getter(lombok.AccessLevel.NONE)
@Setter(lombok.AccessLevel.NONE)
ExpandableField setupAttempt;
/** Get ID of expandable {@code charge} object. */
public String getCharge() {
return (this.charge != null) ? this.charge.getId() : null;
}
public void setCharge(String id) {
this.charge = ApiResource.setExpandableFieldId(id, this.charge);
}
/** Get expanded {@code charge}. */
public Charge getChargeObject() {
return (this.charge != null) ? this.charge.getExpanded() : null;
}
public void setChargeObject(Charge expandableObject) {
this.charge = new ExpandableField(expandableObject.getId(), expandableObject);
}
/** Get ID of expandable {@code setupAttempt} object. */
public String getSetupAttempt() {
return (this.setupAttempt != null) ? this.setupAttempt.getId() : null;
}
public void setSetupAttempt(String id) {
this.setupAttempt = ApiResource.setExpandableFieldId(id, this.setupAttempt);
}
/** Get expanded {@code setupAttempt}. */
public SetupAttempt getSetupAttemptObject() {
return (this.setupAttempt != null) ? this.setupAttempt.getExpanded() : null;
}
public void setSetupAttemptObject(SetupAttempt expandableObject) {
this.setupAttempt =
new ExpandableField(expandableObject.getId(), expandableObject);
}
}
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Sofort extends StripeObject {
/** Two-letter ISO code representing the country the bank account is located in. */
@SerializedName("country")
String country;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Swish extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class UsBankAccount extends StripeObject {
/**
* Account holder type: individual or company.
*
* One of {@code company}, or {@code individual}.
*/
@SerializedName("account_holder_type")
String accountHolderType;
/**
* Account type: checkings or savings. Defaults to checking if omitted.
*
*
One of {@code checking}, or {@code savings}.
*/
@SerializedName("account_type")
String accountType;
/** The name of the bank. */
@SerializedName("bank_name")
String bankName;
/** The ID of the Financial Connections Account used to create the payment method. */
@SerializedName("financial_connections_account")
String financialConnectionsAccount;
/**
* Uniquely identifies this particular bank account. You can use this attribute to check
* whether two bank accounts are the same.
*/
@SerializedName("fingerprint")
String fingerprint;
/** Last four digits of the bank account number. */
@SerializedName("last4")
String last4;
/** Contains information about US bank account networks that can be used. */
@SerializedName("networks")
Networks networks;
/** Routing number of the bank account. */
@SerializedName("routing_number")
String routingNumber;
/** Contains information about the future reusability of this PaymentMethod. */
@SerializedName("status_details")
StatusDetails statusDetails;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Networks extends StripeObject {
/** The preferred network. */
@SerializedName("preferred")
String preferred;
/** All supported networks. */
@SerializedName("supported")
List supported;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class StatusDetails extends StripeObject {
@SerializedName("blocked")
Blocked blocked;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Blocked extends StripeObject {
/**
* The ACH network code that resulted in this block.
*
* One of {@code R02}, {@code R03}, {@code R04}, {@code R05}, {@code R07}, {@code R08},
* {@code R10}, {@code R11}, {@code R16}, {@code R20}, {@code R29}, or {@code R31}.
*/
@SerializedName("network_code")
String networkCode;
/**
* The reason why this PaymentMethod's fingerprint has been blocked
*
*
One of {@code bank_account_closed}, {@code bank_account_frozen}, {@code
* bank_account_invalid_details}, {@code bank_account_restricted}, {@code
* bank_account_unusable}, or {@code debit_not_authorized}.
*/
@SerializedName("reason")
String reason;
}
}
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class WechatPay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Zip extends StripeObject {}
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Shipping extends StripeObject {
@SerializedName("address")
Address address;
/** Recipient name. */
@SerializedName("name")
String name;
/** Recipient phone (including extension). */
@SerializedName("phone")
String phone;
}
public static class TestHelpers {
private TestHelpers() {}
/** Creates a test mode Confirmation Token server side for your integration tests. */
public static ConfirmationToken create(Map params) throws StripeException {
return create(params, (RequestOptions) null);
}
/** Creates a test mode Confirmation Token server side for your integration tests. */
public static ConfirmationToken create(Map params, RequestOptions options)
throws StripeException {
String path = "/v1/test_helpers/confirmation_tokens";
ApiRequest request =
new ApiRequest(
BaseAddress.API, ApiResource.RequestMethod.POST, path, params, options, ApiMode.V1);
return getGlobalResponseGetter().request(request, ConfirmationToken.class);
}
/** Creates a test mode Confirmation Token server side for your integration tests. */
public static ConfirmationToken create(ConfirmationTokenCreateParams params)
throws StripeException {
return create(params, (RequestOptions) null);
}
/** Creates a test mode Confirmation Token server side for your integration tests. */
public static ConfirmationToken create(
ConfirmationTokenCreateParams params, RequestOptions options) throws StripeException {
String path = "/v1/test_helpers/confirmation_tokens";
ApiResource.checkNullTypedParams(path, params);
ApiRequest request =
new ApiRequest(
BaseAddress.API,
ApiResource.RequestMethod.POST,
path,
ApiRequestParams.paramsToMap(params),
options,
ApiMode.V1);
return getGlobalResponseGetter().request(request, ConfirmationToken.class);
}
}
@Override
public void setResponseGetter(StripeResponseGetter responseGetter) {
super.setResponseGetter(responseGetter);
trySetResponseGetter(mandateData, responseGetter);
trySetResponseGetter(paymentMethodPreview, responseGetter);
trySetResponseGetter(shipping, responseGetter);
}
}