The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Net::API::Stripe::Payment::Settings - Stripe API

SYNOPSIS

    use Net::API::Stripe::Payment::Settings;
    my $this = Net::API::Stripe::Payment::Settings->new || die( Net::API::Stripe::Payment::Settings->error, "\n" );

VERSION

    v0.1.0

DESCRIPTION

Configuration settings for the PaymentIntent that is generated when the invoice is finalized.

METHODS

payment_method_options

Payment-method-specific configuration to provide to the invoice’s PaymentIntent.

  • acss_debit hash

    If paying by acss_debit, this sub-hash contains details about the Canadian pre-authorized debit payment method options to pass to the invoice’s PaymentIntent.

    • mandate_options hash

      Additional fields for Mandate creation

    • verification_method enum

      Bank account verification method.

      Possible enum values

      • automatic

        Instant verification with fallback to microdeposits.

      • Cinstant>

        Instant verification.

      • Cmicrodeposits>

        Verification using microdeposits.

  • bancontact hash

    If paying by bancontact, this sub-hash contains details about the Bancontact payment method options to pass to the invoice’s PaymentIntent.

    • preferred_language enum

      Preferred language of the Bancontact authorization page that the customer is redirected to.

      Possible enum values

      • en

        English

      • de

        German

      • fr

        French

      • nl

        Dutch

  • card hash

    If paying by card, this sub-hash contains details about the Card payment method options to pass to the invoice’s PaymentIntent.

    • request_three_d_secure enum advanced

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

      Possible enum values

      • automatic

        Triggers 3D Secure authentication only if it is required.

      • any

        Requires 3D Secure authentication if it is available.

  • customer_balance hash

    If paying by customer_balance, this sub-hash contains details about the Bank transfer payment method options to pass to the invoice’s PaymentIntent.

    • bank_transfer hash

      Configuration for the bank transfer funding type, if the funding_type is set to bank_transfer.

      • eu_bank_transfer hash preview feature

        Configuration for eu_bank_transfer funding type.

        • country string

          The desired country code of the bank account information. Permitted values include: DE, ES, FR, IE, or NL.

      • type string

        The bank transfer type that can be used for funding. Permitted values include: eu_bank_transfer, gb_bank_transfer, jp_bank_transfer, or mx_bank_transfer.

    • funding_type string

      The funding method type to be used when there are not enough funds in the customer balance. Permitted values include: bank_transfer.

  • konbini hash

    If paying by konbini, this sub-hash contains details about the Konbini payment method options to pass to the invoice’s PaymentIntent.

  • us_bank_account hash

    If paying by us_bank_account, this sub-hash contains details about the ACH direct debit payment method options to pass to the invoice’s PaymentIntent.

    • financial_connections hash preview feature

      Additional fields for Financial Connections Session creation

      • permissions array of enum values

        The list of permissions to request. The payment_method permission must be included.

        Possible enum values

        • payment_method

          Allows the creation of a payment method from the account.

        • balances

          Allows accessing balance data from the account.

        • transactions

          Allows accessing transactions data from the account.

    • verification_method enum

      Bank account verification method.

      Possible enum values

      • automatic

        Instant verification with fallback to microdeposits.

      • instant

        Instant verification only.

      • microdeposits

        Verification using microdeposits. Cannot be used with Stripe Checkout or Hosted Invoices.

payment_method_types array of enum values

The list of payment method types (e.g. card) to provide to the invoice’s PaymentIntent. If not set, Stripe attempts to automatically determine the types to use by looking at the invoice’s default payment method, the subscription’s default payment method, the customer’s default payment method, and your invoice template settings.

Possible enum values

  • ach_credit_transfer USD only

    ACH bank transfer

    The collection_method must be send_invoice.

  • ach_debit USD only

    ACH

  • acss_debit USD and CAD

    Canadian pre-authorized debit

  • au_becs_debit AUD only

    BECS Direct Debit

  • bacs_debit GBP only

    Bacs Direct Debit

  • bancontact EUR only

    Bancontact

    The collection_method must be send_invoice.

  • boleto BRL only

    Boleto

  • card

    Card

  • customer_balance EUR, GBP, and 3 other currencies

    Bank transfer

    The collection_method must be send_invoice.

  • eps EUR only

    EPS

    The collection_method must be send_invoice.

  • fpx MYR only

    FPX

    The collection_method must be send_invoice.

  • giropay EUR only

    giropay

    The collection_method must be send_invoice.

  • grabpay MYR and SGD

    GrabPay

    The collection_method must be send_invoice.

  • ideal EUR only

    iDEAL

    The collection_method must be send_invoice.

  • konbini JPY only

    Konbini

    The collection_method must be send_invoice.

  • link USD only

    Link

  • p24 EUR and PLN

    Przelewy24

    The collection_method must be send_invoice.

  • paynow SGD only

    PayNow

    The collection_method must be send_invoice.

  • promptpay THB only

    PromptPay

    The collection_method must be send_invoice.

  • sepa_debit EUR only

    SEPA Direct Debit

  • sofort EUR only

    SOFORT

    The collection_method must be send_invoice.

  • us_bank_account USD only

    ACH direct debit

  • wechat_pay USD, EUR, and 11 other currencies

    WeChat Pay

    The collection_method must be send_invoice.

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

https://stripe.com/docs/api/invoices/object

https://stripe.com/docs/api/subscriptions/object

COPYRIGHT & LICENSE

Copyright(c) 2022 DEGUEST Pte. Ltd.

All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.