NAME

Net::API::Stripe::Connect::CountrySpec - A Stripe Country Spec Object

SYNOPSIS

my $spec = $stripe->country_spec({
    default_currency => 'jpy',
    supported_bank_account_currencies => 
    {
    eur => [qw( be fr de it lu nl dk ie gr pt es at fi sw cy cz ee hu lv lt mt pl sk si bg ro hr va )],
    jpy => [qw( jp )],
    twd => [qw( tw )],
    },
});

VERSION

v0.100.0

DESCRIPTION

Stripe needs to collect certain pieces of information about each account created. These requirements can differ depending on the account's country. The Country Specs API makes these rules available to your integration.

CONSTRUCTOR

new( %ARG )

Creates a new Net::API::Stripe::Connect::CountrySpec object. It may also take an hash like arguments, that also are method of the same name.

METHODS

id string

Unique identifier for the object. Represented as the ISO country code for this country.

object string, value is "country_spec"

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

default_currency string

The default currency for this country. This applies to both payment methods and bank accounts.

supported_bank_account_currencies hash

Currencies that can be accepted in the specific country (for transfers).

supported_payment_currencies array containing strings

Currencies that can be accepted in the specified country (for payments).

supported_payment_methods array containing strings

Payment methods available in the specified country. You may need to enable some payment methods (e.g., ACH) on your account before they appear in this list. The stripe payment method refers to charging through your platform.

supported_transfer_countries array containing strings

Countries that can accept transfers from the specified country.

verification_fields hash

Lists the types of verification data needed to keep an account open.

This is a Net::API::Stripe::Connect::CountrySpec::VerificationFields object.

API SAMPLE

{
  "id": "US",
  "object": "country_spec",
  "default_currency": "usd",
  "supported_bank_account_currencies": {
    "usd": [
      "US"
    ]
  },
  "supported_payment_currencies": [
    "usd",
    "aed",
    "afn",
    "..."
  ],
  "supported_payment_methods": [
    "ach",
    "card",
    "stripe"
  ],
  "supported_transfer_countries": [
    "US"
  ],
  "verification_fields": {
    "company": {
      "additional": [
        "relationship.representative"
      ],
      "minimum": [
        "business_profile.mcc",
        "business_profile.url",
        "business_type",
        "company.address.city",
        "company.address.line1",
        "company.address.postal_code",
        "company.address.state",
        "company.name",
        "company.phone",
        "company.tax_id",
        "external_account",
        "relationship.owner",
        "relationship.representative",
        "tos_acceptance.date",
        "tos_acceptance.ip"
      ]
    },
    "individual": {
      "additional": [
        "individual.id_number"
      ],
      "minimum": [
        "business_profile.mcc",
        "business_profile.url",
        "business_type",
        "external_account",
        "individual.address.city",
        "individual.address.line1",
        "individual.address.postal_code",
        "individual.address.state",
        "individual.dob.day",
        "individual.dob.month",
        "individual.dob.year",
        "individual.email",
        "individual.first_name",
        "individual.last_name",
        "individual.phone",
        "individual.ssn_last_4",
        "tos_acceptance.date",
        "tos_acceptance.ip"
      ]
    }
  }
}

HISTORY

v0.1

Initial version

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Stripe API documentation:

https://stripe.com/docs/api/country_specs, https://stripe.com/docs/connect/required-verification-information

COPYRIGHT & LICENSE

Copyright (c) 2019-2020 DEGUEST Pte. Ltd.

You can use, copy, modify and redistribute this package and associated files under the same terms as Perl itself.

cpanm Net::API::Stripe

perl -MCPAN -e shell
install Net::API::Stripe