com.stripe.model.PaymentMethod 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.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.PaymentMethodAttachParams;
import com.stripe.param.PaymentMethodCreateParams;
import com.stripe.param.PaymentMethodDetachParams;
import com.stripe.param.PaymentMethodListParams;
import com.stripe.param.PaymentMethodRetrieveParams;
import com.stripe.param.PaymentMethodUpdateParams;
import java.util.List;
import java.util.Map;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.Setter;
/**
* PaymentMethod objects represent your customer's payment instruments. You can use them with PaymentIntents to collect payments or
* save them to Customer objects to store instrument details for future payments.
*
* Related guides: Payment Methods
* and More Payment Scenarios.
*/
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public class PaymentMethod extends ApiResource implements HasId, MetadataStore {
@SerializedName("acss_debit")
AcssDebit acssDebit;
@SerializedName("affirm")
Affirm affirm;
@SerializedName("afterpay_clearpay")
AfterpayClearpay afterpayClearpay;
@SerializedName("alipay")
Alipay alipay;
/**
* This field indicates whether this payment method can be shown again to its customer in a
* checkout flow. Stripe products such as Checkout and Elements use this field to determine
* whether a payment method can be shown as a saved payment method in a checkout flow. The field
* defaults to “unspecified”.
*
* One of {@code always}, {@code limited}, or {@code unspecified}.
*/
@SerializedName("allow_redisplay")
String allowRedisplay;
@SerializedName("amazon_pay")
AmazonPay amazonPay;
@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;
/** Time at which the object was created. Measured in seconds since the Unix epoch. */
@SerializedName("created")
Long created;
/**
* The ID of the Customer to which this PaymentMethod is saved. This will not be set when the
* PaymentMethod has not been saved to a Customer.
*/
@SerializedName("customer")
@Getter(lombok.AccessLevel.NONE)
@Setter(lombok.AccessLevel.NONE)
ExpandableField customer;
@SerializedName("customer_balance")
CustomerBalance customerBalance;
@SerializedName("eps")
Eps eps;
@SerializedName("fpx")
Fpx fpx;
@SerializedName("giropay")
Giropay giropay;
@SerializedName("grabpay")
Grabpay grabpay;
/** Unique identifier for the object. */
@Getter(onMethod_ = {@Override})
@SerializedName("id")
String id;
@SerializedName("ideal")
Ideal ideal;
@SerializedName("interac_present")
InteracPresent interacPresent;
@SerializedName("klarna")
Klarna klarna;
@SerializedName("konbini")
Konbini konbini;
@SerializedName("link")
Link link;
/**
* 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;
@SerializedName("mb_way")
MbWay mbWay;
/**
* 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.
*/
@Getter(onMethod_ = {@Override})
@SerializedName("metadata")
Map metadata;
@SerializedName("mobilepay")
Mobilepay mobilepay;
@SerializedName("multibanco")
Multibanco multibanco;
/**
* String representing the object's type. Objects of the same type share the same value.
*
* Equal to {@code payment_method}.
*/
@SerializedName("object")
String object;
@SerializedName("oxxo")
Oxxo oxxo;
@SerializedName("p24")
P24 p24;
@SerializedName("paynow")
Paynow paynow;
@SerializedName("paypal")
Paypal paypal;
@SerializedName("payto")
Payto payto;
@SerializedName("pix")
Pix pix;
@SerializedName("promptpay")
Promptpay promptpay;
/**
* Options to configure Radar. See Radar
* Session for more information.
*/
@SerializedName("radar_options")
RadarOptions radarOptions;
@SerializedName("rechnung")
Rechnung rechnung;
@SerializedName("revolut_pay")
RevolutPay revolutPay;
@SerializedName("sepa_debit")
SepaDebit sepaDebit;
@SerializedName("sofort")
Sofort sofort;
@SerializedName("swish")
Swish swish;
@SerializedName("twint")
Twint twint;
/**
* 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
* amazon_pay}, {@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 mb_way}, {@code
* mobilepay}, {@code multibanco}, {@code oxxo}, {@code p24}, {@code paynow}, {@code paypal},
* {@code payto}, {@code pix}, {@code promptpay}, {@code rechnung}, {@code revolut_pay}, {@code
* sepa_debit}, {@code sofort}, {@code swish}, {@code twint}, {@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;
/** Get ID of expandable {@code customer} object. */
public String getCustomer() {
return (this.customer != null) ? this.customer.getId() : null;
}
public void setCustomer(String id) {
this.customer = ApiResource.setExpandableFieldId(id, this.customer);
}
/** Get expanded {@code customer}. */
public Customer getCustomerObject() {
return (this.customer != null) ? this.customer.getExpanded() : null;
}
public void setCustomerObject(Customer expandableObject) {
this.customer = new ExpandableField(expandableObject.getId(), expandableObject);
}
/**
* Attaches a PaymentMethod object to a Customer.
*
* To attach a new PaymentMethod to a customer for future payments, we recommend you use a SetupIntent or a PaymentIntent with setup_future_usage.
* These approaches will perform any necessary steps to set up the PaymentMethod for future
* payments. Using the {@code /v1/payment_methods/:id/attach} endpoint without first using a
* SetupIntent or PaymentIntent with {@code setup_future_usage} does not optimize the
* PaymentMethod for future use, which makes later declines and payment friction more likely. See
* Optimizing cards for
* future payments for more information about setting up future payments.
*
*
To use this PaymentMethod as the default for invoice or subscription payments, set {@code
* invoice_settings.default_payment_method}, on the Customer to the PaymentMethod’s ID.
*/
public PaymentMethod attach(Map params) throws StripeException {
return attach(params, (RequestOptions) null);
}
/**
* Attaches a PaymentMethod object to a Customer.
*
* To attach a new PaymentMethod to a customer for future payments, we recommend you use a SetupIntent or a PaymentIntent with setup_future_usage.
* These approaches will perform any necessary steps to set up the PaymentMethod for future
* payments. Using the {@code /v1/payment_methods/:id/attach} endpoint without first using a
* SetupIntent or PaymentIntent with {@code setup_future_usage} does not optimize the
* PaymentMethod for future use, which makes later declines and payment friction more likely. See
* Optimizing cards for
* future payments for more information about setting up future payments.
*
*
To use this PaymentMethod as the default for invoice or subscription payments, set {@code
* invoice_settings.default_payment_method}, on the Customer to the PaymentMethod’s ID.
*/
public PaymentMethod attach(Map params, RequestOptions options)
throws StripeException {
String path =
String.format("/v1/payment_methods/%s/attach", ApiResource.urlEncodeId(this.getId()));
ApiRequest request =
new ApiRequest(BaseAddress.API, ApiResource.RequestMethod.POST, path, params, options);
return getResponseGetter().request(request, PaymentMethod.class);
}
/**
* Attaches a PaymentMethod object to a Customer.
*
* To attach a new PaymentMethod to a customer for future payments, we recommend you use a SetupIntent or a PaymentIntent with setup_future_usage.
* These approaches will perform any necessary steps to set up the PaymentMethod for future
* payments. Using the {@code /v1/payment_methods/:id/attach} endpoint without first using a
* SetupIntent or PaymentIntent with {@code setup_future_usage} does not optimize the
* PaymentMethod for future use, which makes later declines and payment friction more likely. See
* Optimizing cards for
* future payments for more information about setting up future payments.
*
*
To use this PaymentMethod as the default for invoice or subscription payments, set {@code
* invoice_settings.default_payment_method}, on the Customer to the PaymentMethod’s ID.
*/
public PaymentMethod attach(PaymentMethodAttachParams params) throws StripeException {
return attach(params, (RequestOptions) null);
}
/**
* Attaches a PaymentMethod object to a Customer.
*
*
To attach a new PaymentMethod to a customer for future payments, we recommend you use a SetupIntent or a PaymentIntent with setup_future_usage.
* These approaches will perform any necessary steps to set up the PaymentMethod for future
* payments. Using the {@code /v1/payment_methods/:id/attach} endpoint without first using a
* SetupIntent or PaymentIntent with {@code setup_future_usage} does not optimize the
* PaymentMethod for future use, which makes later declines and payment friction more likely. See
* Optimizing cards for
* future payments for more information about setting up future payments.
*
*
To use this PaymentMethod as the default for invoice or subscription payments, set {@code
* invoice_settings.default_payment_method}, on the Customer to the PaymentMethod’s ID.
*/
public PaymentMethod attach(PaymentMethodAttachParams params, RequestOptions options)
throws StripeException {
String path =
String.format("/v1/payment_methods/%s/attach", ApiResource.urlEncodeId(this.getId()));
ApiResource.checkNullTypedParams(path, params);
ApiRequest request =
new ApiRequest(
BaseAddress.API,
ApiResource.RequestMethod.POST,
path,
ApiRequestParams.paramsToMap(params),
options);
return getResponseGetter().request(request, PaymentMethod.class);
}
/**
* Creates a PaymentMethod object. Read the Stripe.js
* reference to learn how to create PaymentMethods via Stripe.js.
*
*
Instead of creating a PaymentMethod directly, we recommend using the PaymentIntents API to accept a
* payment immediately or the SetupIntent API to collect payment
* method details ahead of a future payment.
*/
public static PaymentMethod create(Map params) throws StripeException {
return create(params, (RequestOptions) null);
}
/**
* Creates a PaymentMethod object. Read the Stripe.js
* reference to learn how to create PaymentMethods via Stripe.js.
*
* Instead of creating a PaymentMethod directly, we recommend using the PaymentIntents API to accept a
* payment immediately or the SetupIntent API to collect payment
* method details ahead of a future payment.
*/
public static PaymentMethod create(Map params, RequestOptions options)
throws StripeException {
String path = "/v1/payment_methods";
ApiRequest request =
new ApiRequest(BaseAddress.API, ApiResource.RequestMethod.POST, path, params, options);
return getGlobalResponseGetter().request(request, PaymentMethod.class);
}
/**
* Creates a PaymentMethod object. Read the Stripe.js
* reference to learn how to create PaymentMethods via Stripe.js.
*
* Instead of creating a PaymentMethod directly, we recommend using the PaymentIntents API to accept a
* payment immediately or the SetupIntent API to collect payment
* method details ahead of a future payment.
*/
public static PaymentMethod create(PaymentMethodCreateParams params) throws StripeException {
return create(params, (RequestOptions) null);
}
/**
* Creates a PaymentMethod object. Read the Stripe.js
* reference to learn how to create PaymentMethods via Stripe.js.
*
*
Instead of creating a PaymentMethod directly, we recommend using the PaymentIntents API to accept a
* payment immediately or the SetupIntent API to collect payment
* method details ahead of a future payment.
*/
public static PaymentMethod create(PaymentMethodCreateParams params, RequestOptions options)
throws StripeException {
String path = "/v1/payment_methods";
ApiResource.checkNullTypedParams(path, params);
ApiRequest request =
new ApiRequest(
BaseAddress.API,
ApiResource.RequestMethod.POST,
path,
ApiRequestParams.paramsToMap(params),
options);
return getGlobalResponseGetter().request(request, PaymentMethod.class);
}
/**
* Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no
* longer be used for a payment or re-attached to a Customer.
*/
public PaymentMethod detach() throws StripeException {
return detach((Map) null, (RequestOptions) null);
}
/**
* Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no
* longer be used for a payment or re-attached to a Customer.
*/
public PaymentMethod detach(RequestOptions options) throws StripeException {
return detach((Map) null, options);
}
/**
* Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no
* longer be used for a payment or re-attached to a Customer.
*/
public PaymentMethod detach(Map params) throws StripeException {
return detach(params, (RequestOptions) null);
}
/**
* Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no
* longer be used for a payment or re-attached to a Customer.
*/
public PaymentMethod detach(Map params, RequestOptions options)
throws StripeException {
String path =
String.format("/v1/payment_methods/%s/detach", ApiResource.urlEncodeId(this.getId()));
ApiRequest request =
new ApiRequest(BaseAddress.API, ApiResource.RequestMethod.POST, path, params, options);
return getResponseGetter().request(request, PaymentMethod.class);
}
/**
* Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no
* longer be used for a payment or re-attached to a Customer.
*/
public PaymentMethod detach(PaymentMethodDetachParams params) throws StripeException {
return detach(params, (RequestOptions) null);
}
/**
* Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no
* longer be used for a payment or re-attached to a Customer.
*/
public PaymentMethod detach(PaymentMethodDetachParams params, RequestOptions options)
throws StripeException {
String path =
String.format("/v1/payment_methods/%s/detach", ApiResource.urlEncodeId(this.getId()));
ApiResource.checkNullTypedParams(path, params);
ApiRequest request =
new ApiRequest(
BaseAddress.API,
ApiResource.RequestMethod.POST,
path,
ApiRequestParams.paramsToMap(params),
options);
return getResponseGetter().request(request, PaymentMethod.class);
}
/**
* Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods
* attached to a Customer for payments, you should use the List a Customer’s
* PaymentMethods API instead.
*/
public static PaymentMethodCollection list(Map params) throws StripeException {
return list(params, (RequestOptions) null);
}
/**
* Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods
* attached to a Customer for payments, you should use the List a Customer’s
* PaymentMethods API instead.
*/
public static PaymentMethodCollection list(Map params, RequestOptions options)
throws StripeException {
String path = "/v1/payment_methods";
ApiRequest request =
new ApiRequest(BaseAddress.API, ApiResource.RequestMethod.GET, path, params, options);
return getGlobalResponseGetter().request(request, PaymentMethodCollection.class);
}
/**
* Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods
* attached to a Customer for payments, you should use the List a Customer’s
* PaymentMethods API instead.
*/
public static PaymentMethodCollection list(PaymentMethodListParams params)
throws StripeException {
return list(params, (RequestOptions) null);
}
/**
* Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods
* attached to a Customer for payments, you should use the List a Customer’s
* PaymentMethods API instead.
*/
public static PaymentMethodCollection list(PaymentMethodListParams params, RequestOptions options)
throws StripeException {
String path = "/v1/payment_methods";
ApiResource.checkNullTypedParams(path, params);
ApiRequest request =
new ApiRequest(
BaseAddress.API,
ApiResource.RequestMethod.GET,
path,
ApiRequestParams.paramsToMap(params),
options);
return getGlobalResponseGetter().request(request, PaymentMethodCollection.class);
}
/**
* Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method
* attached to a Customer, you should use Retrieve a Customer’s
* PaymentMethods
*/
public static PaymentMethod retrieve(String paymentMethod) throws StripeException {
return retrieve(paymentMethod, (Map) null, (RequestOptions) null);
}
/**
* Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method
* attached to a Customer, you should use Retrieve a Customer’s
* PaymentMethods
*/
public static PaymentMethod retrieve(String paymentMethod, RequestOptions options)
throws StripeException {
return retrieve(paymentMethod, (Map) null, options);
}
/**
* Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method
* attached to a Customer, you should use Retrieve a Customer’s
* PaymentMethods
*/
public static PaymentMethod retrieve(
String paymentMethod, Map params, RequestOptions options)
throws StripeException {
String path = String.format("/v1/payment_methods/%s", ApiResource.urlEncodeId(paymentMethod));
ApiRequest request =
new ApiRequest(BaseAddress.API, ApiResource.RequestMethod.GET, path, params, options);
return getGlobalResponseGetter().request(request, PaymentMethod.class);
}
/**
* Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method
* attached to a Customer, you should use Retrieve a Customer’s
* PaymentMethods
*/
public static PaymentMethod retrieve(
String paymentMethod, PaymentMethodRetrieveParams params, RequestOptions options)
throws StripeException {
String path = String.format("/v1/payment_methods/%s", ApiResource.urlEncodeId(paymentMethod));
ApiResource.checkNullTypedParams(path, params);
ApiRequest request =
new ApiRequest(
BaseAddress.API,
ApiResource.RequestMethod.GET,
path,
ApiRequestParams.paramsToMap(params),
options);
return getGlobalResponseGetter().request(request, PaymentMethod.class);
}
/** Updates a PaymentMethod object. A PaymentMethod must be attached a customer to be updated. */
@Override
public PaymentMethod update(Map params) throws StripeException {
return update(params, (RequestOptions) null);
}
/** Updates a PaymentMethod object. A PaymentMethod must be attached a customer to be updated. */
@Override
public PaymentMethod update(Map params, RequestOptions options)
throws StripeException {
String path = String.format("/v1/payment_methods/%s", ApiResource.urlEncodeId(this.getId()));
ApiRequest request =
new ApiRequest(BaseAddress.API, ApiResource.RequestMethod.POST, path, params, options);
return getResponseGetter().request(request, PaymentMethod.class);
}
/** Updates a PaymentMethod object. A PaymentMethod must be attached a customer to be updated. */
public PaymentMethod update(PaymentMethodUpdateParams params) throws StripeException {
return update(params, (RequestOptions) null);
}
/** Updates a PaymentMethod object. A PaymentMethod must be attached a customer to be updated. */
public PaymentMethod update(PaymentMethodUpdateParams params, RequestOptions options)
throws StripeException {
String path = String.format("/v1/payment_methods/%s", ApiResource.urlEncodeId(this.getId()));
ApiResource.checkNullTypedParams(path, params);
ApiRequest request =
new ApiRequest(
BaseAddress.API,
ApiResource.RequestMethod.POST,
path,
ApiRequestParams.paramsToMap(params),
options);
return getResponseGetter().request(request, PaymentMethod.class);
}
@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 AmazonPay 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;
/** Details of the original PaymentMethod that created this object. */
@SerializedName("generated_from")
GeneratedFrom generatedFrom;
/**
* 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 GeneratedFrom extends StripeObject {
/** The charge that created this object. */
@SerializedName("charge")
String charge;
/** Transaction-specific details of the payment method used in the payment. */
@SerializedName("payment_method_details")
PaymentMethodDetails paymentMethodDetails;
/** 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 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 PaymentMethodDetails extends StripeObject {
@SerializedName("card_present")
CardPresent cardPresent;
/**
* The type of payment method transaction-specific details from the transaction that
* generated this {@code card} payment method. Always {@code card_present}.
*/
@SerializedName("type")
String type;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class CardPresent extends StripeObject {
/** The authorized amount. */
@SerializedName("amount_authorized")
Long amountAuthorized;
/**
* 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 product code that
* identifies the specific program or product associated with a card.
*/
@SerializedName("brand_product")
String brandProduct;
/**
* When using manual capture, a future timestamp after which the charge will be
* automatically refunded if uncaptured.
*/
@SerializedName("capture_before")
Long captureBefore;
/**
* 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;
/** Authorization response cryptogram. */
@SerializedName("emv_auth_data")
String emvAuthData;
/** 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;
/**
* ID of a card PaymentMethod generated from the card_present PaymentMethod that may be
* attached to a Customer for future transactions. Only present if it was possible to
* generate a card PaymentMethod.
*/
@SerializedName("generated_card")
String generatedCard;
/**
* Issuer identification number of the card. (For internal use only and not typically
* available in standard API requests.)
*/
@SerializedName("iin")
String iin;
/**
* Whether this PaymentIntent is
* eligible for incremental authorizations. Request support using request_incremental_authorization_support.
*/
@SerializedName("incremental_authorization_supported")
Boolean incrementalAuthorizationSupported;
/**
* 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;
/**
* Identifies which network this charge was processed on. Can be {@code amex}, {@code
* cartes_bancaires}, {@code diners}, {@code discover}, {@code eftpos_au}, {@code
* interac}, {@code jcb}, {@code mastercard}, {@code unionpay}, {@code visa}, or {@code
* unknown}.
*/
@SerializedName("network")
String network;
/**
* This is used by the financial networks to identify a transaction. Visa calls this the
* Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the
* Acquirer Reference Data. The first three digits of the Trace ID is the Financial
* Network Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits
* represent the date (MM/DD). This field will be available for successful Visa,
* Mastercard, or American Express transactions and always null for other card brands.
*/
@SerializedName("network_transaction_id")
String networkTransactionId;
/** Details about payments collected offline. */
@SerializedName("offline")
Offline offline;
/** Defines whether the authorized amount can be over-captured or not. */
@SerializedName("overcapture_supported")
Boolean overcaptureSupported;
/** 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;
/**
* A collection of fields required to be displayed on receipts. Only required for EMV
* transactions.
*/
@SerializedName("receipt")
Receipt receipt;
@SerializedName("wallet")
Wallet wallet;
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Offline extends StripeObject {
/** Time at which the payment was collected while offline. */
@SerializedName("stored_at")
Long storedAt;
/**
* The method used to process this payment method offline. Only deferred is allowed.
*
*
Equal to {@code deferred}.
*/
@SerializedName("type")
String type;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Receipt extends StripeObject {
/**
* The type of account being debited or credited
*
*
One of {@code checking}, {@code credit}, {@code prepaid}, or {@code unknown}.
*/
@SerializedName("account_type")
String accountType;
/** EMV tag 9F26, cryptogram generated by the integrated circuit chip. */
@SerializedName("application_cryptogram")
String applicationCryptogram;
/** Mnenomic of the Application Identifier. */
@SerializedName("application_preferred_name")
String applicationPreferredName;
/** Identifier for this transaction. */
@SerializedName("authorization_code")
String authorizationCode;
/** EMV tag 8A. A code returned by the card issuer. */
@SerializedName("authorization_response_code")
String authorizationResponseCode;
/**
* Describes the method used by the cardholder to verify ownership of the card. One of
* the following: {@code approval}, {@code failure}, {@code none}, {@code offline_pin},
* {@code offline_pin_and_signature}, {@code online_pin}, or {@code signature}.
*/
@SerializedName("cardholder_verification_method")
String cardholderVerificationMethod;
/**
* EMV tag 84. Similar to the application identifier stored on the integrated circuit
* chip.
*/
@SerializedName("dedicated_file_name")
String dedicatedFileName;
/** The outcome of a series of EMV functions performed by the card reader. */
@SerializedName("terminal_verification_results")
String terminalVerificationResults;
/** An indication of various EMV functions performed during the transaction. */
@SerializedName("transaction_status_information")
String transactionStatusInformation;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Wallet extends StripeObject {
/**
* The type of mobile wallet, one of {@code apple_pay}, {@code google_pay}, {@code
* samsung_pay}, or {@code unknown}.
*/
@SerializedName("type")
String type;
}
}
}
}
@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 product code that identifies the
* specific program or product associated with a card.
*/
@SerializedName("brand_product")
String brandProduct;
/**
* 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;
/** Details about payment methods collected offline. */
@SerializedName("offline")
Offline offline;
/** 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;
@SerializedName("wallet")
Wallet wallet;
@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 Offline extends StripeObject {
/** Time at which the payment was collected while offline. */
@SerializedName("stored_at")
Long storedAt;
/**
* The method used to process this payment method offline. Only deferred is allowed.
*
* Equal to {@code deferred}.
*/
@SerializedName("type")
String type;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Wallet extends StripeObject {
/**
* The type of mobile wallet, one of {@code apple_pay}, {@code google_pay}, {@code
* samsung_pay}, or {@code unknown}.
*/
@SerializedName("type")
String type;
}
}
@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")
@Deprecated
String persistentToken;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class MbWay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Mobilepay extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Multibanco 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 {
/**
* Uniquely identifies this particular PayPal account. You can use this attribute to check
* whether two PayPal accounts are the same.
*/
@SerializedName("fingerprint")
String fingerprint;
/**
* 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;
/**
* Owner's verified email. Values are verified or provided by PayPal directly (if supported) at
* the time of authorization or settlement. They cannot be set or mutated.
*/
@SerializedName("verified_email")
String verifiedEmail;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Payto extends StripeObject {
/** Bank-State-Branch number of the bank account. */
@SerializedName("bsb_number")
String bsbNumber;
/** Last four digits of the bank account number. */
@SerializedName("last4")
String last4;
/** The PayID alias for the bank account. */
@SerializedName("pay_id")
String payId;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Pix extends StripeObject {}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Promptpay extends StripeObject {}
/**
* Options to configure Radar. See Radar
* Session for more information.
*/
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class RadarOptions extends StripeObject {
/**
* A Radar Session is a snapshot of
* the browser metadata and device details that help Radar make more accurate predictions on
* your payments.
*/
@SerializedName("session")
String session;
}
@Getter
@Setter
@EqualsAndHashCode(callSuper = false)
public static class Rechnung extends StripeObject {
@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 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 Twint 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 number of the bank account. */
@SerializedName("account_number")
String accountNumber;
/**
* 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 {}
@Override
public void setResponseGetter(StripeResponseGetter responseGetter) {
super.setResponseGetter(responseGetter);
trySetResponseGetter(acssDebit, responseGetter);
trySetResponseGetter(affirm, responseGetter);
trySetResponseGetter(afterpayClearpay, responseGetter);
trySetResponseGetter(alipay, responseGetter);
trySetResponseGetter(amazonPay, responseGetter);
trySetResponseGetter(auBecsDebit, responseGetter);
trySetResponseGetter(bacsDebit, responseGetter);
trySetResponseGetter(bancontact, responseGetter);
trySetResponseGetter(billingDetails, responseGetter);
trySetResponseGetter(blik, responseGetter);
trySetResponseGetter(boleto, responseGetter);
trySetResponseGetter(card, responseGetter);
trySetResponseGetter(cardPresent, responseGetter);
trySetResponseGetter(cashapp, responseGetter);
trySetResponseGetter(customer, responseGetter);
trySetResponseGetter(customerBalance, responseGetter);
trySetResponseGetter(eps, responseGetter);
trySetResponseGetter(fpx, responseGetter);
trySetResponseGetter(giropay, responseGetter);
trySetResponseGetter(grabpay, responseGetter);
trySetResponseGetter(ideal, responseGetter);
trySetResponseGetter(interacPresent, responseGetter);
trySetResponseGetter(klarna, responseGetter);
trySetResponseGetter(konbini, responseGetter);
trySetResponseGetter(link, responseGetter);
trySetResponseGetter(mbWay, responseGetter);
trySetResponseGetter(mobilepay, responseGetter);
trySetResponseGetter(multibanco, responseGetter);
trySetResponseGetter(oxxo, responseGetter);
trySetResponseGetter(p24, responseGetter);
trySetResponseGetter(paynow, responseGetter);
trySetResponseGetter(paypal, responseGetter);
trySetResponseGetter(payto, responseGetter);
trySetResponseGetter(pix, responseGetter);
trySetResponseGetter(promptpay, responseGetter);
trySetResponseGetter(radarOptions, responseGetter);
trySetResponseGetter(rechnung, responseGetter);
trySetResponseGetter(revolutPay, responseGetter);
trySetResponseGetter(sepaDebit, responseGetter);
trySetResponseGetter(sofort, responseGetter);
trySetResponseGetter(swish, responseGetter);
trySetResponseGetter(twint, responseGetter);
trySetResponseGetter(usBankAccount, responseGetter);
trySetResponseGetter(wechatPay, responseGetter);
trySetResponseGetter(zip, responseGetter);
}
}