Class: Stripe::PaymentMethodConfiguration

Inherits:
APIResource show all
Extended by:
APIOperations::Create, APIOperations::List
Includes:
APIOperations::Save
Defined in:
lib/stripe/resources/payment_method_configuration.rb

Overview

PaymentMethodConfigurations control which payment methods are displayed to your customers when you don’t explicitly specify payment method types. You can have multiple configurations with different sets of payment methods for different scenarios.

There are two types of PaymentMethodConfigurations. Which is used depends on the [charge type](stripe.com/docs/connect/charges):

Direct configurations apply to payments created on your account, including Connect destination charges, Connect separate charges and transfers, and payments not involving Connect.

Child configurations apply to payments created on your connected accounts using direct charges, and charges with the on_behalf_of parameter.

Child configurations have a ‘parent` that sets default values and controls which settings connected accounts may override. You can specify a parent ID at payment time, and Stripe will automatically resolve the connected account’s associated child configuration. Parent configurations are [managed in the dashboard](dashboard.stripe.com/settings/payment_methods/connected_accounts) and are not available in this API.

Related guides:

Defined Under Namespace

Classes: AcssDebit, Affirm, AfterpayClearpay, Alipay, Alma, AmazonPay, ApplePay, AuBecsDebit, BacsDebit, Bancontact, Blik, Boleto, Card, CartesBancaires, Cashapp, CreateParams, CustomerBalance, Eps, Fpx, Giropay, GooglePay, Gopay, Grabpay, IdBankTransfer, Ideal, Jcb, Klarna, Konbini, Link, ListParams, Mobilepay, Multibanco, Oxxo, P24, Paynow, Paypal, Payto, Promptpay, Qris, RetrieveParams, RevolutPay, SepaDebit, Shopeepay, Sofort, Swish, Twint, UpdateParams, UsBankAccount, WechatPay, Zip

Constant Summary collapse

OBJECT_NAME =
"payment_method_configuration"

Constants inherited from StripeObject

StripeObject::RESERVED_FIELD_NAMES

Instance Attribute Summary collapse

Attributes inherited from APIResource

#save_with_parent

Attributes inherited from StripeObject

#last_response

Class Method Summary collapse

Methods included from APIOperations::Create

create

Methods included from APIOperations::List

list

Methods included from APIOperations::Save

included, #save

Methods inherited from APIResource

class_name, custom_method, #refresh, #request_stripe_object, resource_url, #resource_url, retrieve, save_nested_resource

Methods included from APIOperations::Request

included

Methods inherited from StripeObject

#==, #[], #[]=, additive_object_param, additive_object_param?, #as_json, construct_from, #deleted?, #dirty!, #each, #eql?, #hash, #initialize, #inspect, #keys, #marshal_dump, #marshal_load, protected_fields, #serialize_params, #to_hash, #to_json, #to_s, #update_attributes, #values

Constructor Details

This class inherits a constructor from Stripe::StripeObject

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Stripe::StripeObject

Instance Attribute Details

#acss_debitObject (readonly)

Attribute for field acss_debit



2765
2766
2767
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2765

def acss_debit
  @acss_debit
end

#activeObject (readonly)

Whether the configuration can be used for new payments.



2767
2768
2769
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2767

def active
  @active
end

#affirmObject (readonly)

Attribute for field affirm



2769
2770
2771
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2769

def affirm
  @affirm
end

#afterpay_clearpayObject (readonly)

Attribute for field afterpay_clearpay



2771
2772
2773
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2771

def afterpay_clearpay
  @afterpay_clearpay
end

#alipayObject (readonly)

Attribute for field alipay



2773
2774
2775
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2773

def alipay
  @alipay
end

#almaObject (readonly)

Attribute for field alma



2775
2776
2777
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2775

def alma
  @alma
end

#amazon_payObject (readonly)

Attribute for field amazon_pay



2777
2778
2779
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2777

def amazon_pay
  @amazon_pay
end

#apple_payObject (readonly)

Attribute for field apple_pay



2779
2780
2781
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2779

def apple_pay
  @apple_pay
end

#applicationObject (readonly)

For child configs, the Connect application associated with the configuration.



2781
2782
2783
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2781

def application
  @application
end

#au_becs_debitObject (readonly)

Attribute for field au_becs_debit



2783
2784
2785
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2783

def au_becs_debit
  @au_becs_debit
end

#bacs_debitObject (readonly)

Attribute for field bacs_debit



2785
2786
2787
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2785

def bacs_debit
  @bacs_debit
end

#bancontactObject (readonly)

Attribute for field bancontact



2787
2788
2789
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2787

def bancontact
  @bancontact
end

#blikObject (readonly)

Attribute for field blik



2789
2790
2791
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2789

def blik
  @blik
end

#boletoObject (readonly)

Attribute for field boleto



2791
2792
2793
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2791

def boleto
  @boleto
end

#cardObject (readonly)

Attribute for field card



2793
2794
2795
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2793

def card
  @card
end

#cartes_bancairesObject (readonly)

Attribute for field cartes_bancaires



2795
2796
2797
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2795

def cartes_bancaires
  @cartes_bancaires
end

#cashappObject (readonly)

Attribute for field cashapp



2797
2798
2799
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2797

def cashapp
  @cashapp
end

#customer_balanceObject (readonly)

Attribute for field customer_balance



2799
2800
2801
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2799

def customer_balance
  @customer_balance
end

#epsObject (readonly)

Attribute for field eps



2801
2802
2803
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2801

def eps
  @eps
end

#fpxObject (readonly)

Attribute for field fpx



2803
2804
2805
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2803

def fpx
  @fpx
end

#giropayObject (readonly)

Attribute for field giropay



2805
2806
2807
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2805

def giropay
  @giropay
end

#google_payObject (readonly)

Attribute for field google_pay



2807
2808
2809
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2807

def google_pay
  @google_pay
end

#gopayObject (readonly)

Attribute for field gopay



2809
2810
2811
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2809

def gopay
  @gopay
end

#grabpayObject (readonly)

Attribute for field grabpay



2811
2812
2813
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2811

def grabpay
  @grabpay
end

#idObject (readonly)

Unique identifier for the object.



2813
2814
2815
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2813

def id
  @id
end

#id_bank_transferObject (readonly)

Attribute for field id_bank_transfer



2815
2816
2817
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2815

def id_bank_transfer
  @id_bank_transfer
end

#idealObject (readonly)

Attribute for field ideal



2817
2818
2819
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2817

def ideal
  @ideal
end

#is_defaultObject (readonly)

The default configuration is used whenever a payment method configuration is not specified.



2819
2820
2821
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2819

def is_default
  @is_default
end

#jcbObject (readonly)

Attribute for field jcb



2821
2822
2823
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2821

def jcb
  @jcb
end

#klarnaObject (readonly)

Attribute for field klarna



2823
2824
2825
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2823

def klarna
  @klarna
end

#konbiniObject (readonly)

Attribute for field konbini



2825
2826
2827
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2825

def konbini
  @konbini
end

Attribute for field link



2827
2828
2829
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2827

def link
  @link
end

#livemodeObject (readonly)

Has the value ‘true` if the object exists in live mode or the value `false` if the object exists in test mode.



2829
2830
2831
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2829

def livemode
  @livemode
end

#mobilepayObject (readonly)

Attribute for field mobilepay



2831
2832
2833
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2831

def mobilepay
  @mobilepay
end

#multibancoObject (readonly)

Attribute for field multibanco



2833
2834
2835
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2833

def multibanco
  @multibanco
end

#nameObject (readonly)

The configuration’s name.



2835
2836
2837
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2835

def name
  @name
end

#objectObject (readonly)

String representing the object’s type. Objects of the same type share the same value.



2837
2838
2839
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2837

def object
  @object
end

#oxxoObject (readonly)

Attribute for field oxxo



2839
2840
2841
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2839

def oxxo
  @oxxo
end

#p24Object (readonly)

Attribute for field p24



2841
2842
2843
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2841

def p24
  @p24
end

#parentObject (readonly)

For child configs, the configuration’s parent configuration.



2843
2844
2845
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2843

def parent
  @parent
end

#paynowObject (readonly)

Attribute for field paynow



2845
2846
2847
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2845

def paynow
  @paynow
end

#paypalObject (readonly)

Attribute for field paypal



2847
2848
2849
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2847

def paypal
  @paypal
end

#paytoObject (readonly)

Attribute for field payto



2849
2850
2851
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2849

def payto
  @payto
end

#promptpayObject (readonly)

Attribute for field promptpay



2851
2852
2853
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2851

def promptpay
  @promptpay
end

#qrisObject (readonly)

Attribute for field qris



2853
2854
2855
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2853

def qris
  @qris
end

#revolut_payObject (readonly)

Attribute for field revolut_pay



2855
2856
2857
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2855

def revolut_pay
  @revolut_pay
end

#sepa_debitObject (readonly)

Attribute for field sepa_debit



2857
2858
2859
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2857

def sepa_debit
  @sepa_debit
end

#shopeepayObject (readonly)

Attribute for field shopeepay



2859
2860
2861
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2859

def shopeepay
  @shopeepay
end

#sofortObject (readonly)

Attribute for field sofort



2861
2862
2863
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2861

def sofort
  @sofort
end

#swishObject (readonly)

Attribute for field swish



2863
2864
2865
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2863

def swish
  @swish
end

#twintObject (readonly)

Attribute for field twint



2865
2866
2867
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2865

def twint
  @twint
end

#us_bank_accountObject (readonly)

Attribute for field us_bank_account



2867
2868
2869
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2867

def 
  @us_bank_account
end

#wechat_payObject (readonly)

Attribute for field wechat_pay



2869
2870
2871
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2869

def wechat_pay
  @wechat_pay
end

#zipObject (readonly)

Attribute for field zip



2871
2872
2873
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2871

def zip
  @zip
end

Class Method Details

.create(params = {}, opts = {}) ⇒ Object

Creates a payment method configuration



2874
2875
2876
2877
2878
2879
2880
2881
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2874

def self.create(params = {}, opts = {})
  request_stripe_object(
    method: :post,
    path: "/v1/payment_method_configurations",
    params: params,
    opts: opts
  )
end

.list(params = {}, opts = {}) ⇒ Object

List payment method configurations



2884
2885
2886
2887
2888
2889
2890
2891
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2884

def self.list(params = {}, opts = {})
  request_stripe_object(
    method: :get,
    path: "/v1/payment_method_configurations",
    params: params,
    opts: opts
  )
end

.object_nameObject



25
26
27
# File 'lib/stripe/resources/payment_method_configuration.rb', line 25

def self.object_name
  "payment_method_configuration"
end

.update(id, params = {}, opts = {}) ⇒ Object

Update payment method configuration



2894
2895
2896
2897
2898
2899
2900
2901
# File 'lib/stripe/resources/payment_method_configuration.rb', line 2894

def self.update(id, params = {}, opts = {})
  request_stripe_object(
    method: :post,
    path: format("/v1/payment_method_configurations/%<id>s", { id: CGI.escape(id) }),
    params: params,
    opts: opts
  )
end