NAME

Net::API::Stripe::Issuing::Card - A Stripe Issued Card Object

SYNOPSIS

VERSION

    0.1

DESCRIPTION

You can create physical or virtual cards that are issued to cardholders.

This Module bears some resemblance with Net::API::Stripe::Connect::ExternalAccount::Card, but is quite different, so it stands on its own.

CONSTRUCTOR

new( %ARG )

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

verbose

Toggles verbose mode on/off

debug

Toggles debug mode on/off

METHODS

id string

Unique identifier for the object.

object string, value is "issuing.card"

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

authorization_controls hash

Spending rules that give you some control over how your cards can be used. Refer to our authorizations documentation for more details.

This is a Net::API::Stripe::Issuing::Card::AuthorizationsControl object.

brand string

The brand of the card.

cardholder hash

The Cardholder object to which the card belongs.

This is a Net::API::Stripe::Issuing::Card::Holder object.

created timestamp

Time at which the object was created. Measured in seconds since the Unix epoch.

currency currency

Three-letter ISO currency code, in lowercase. Must be a supported currency.

exp_month integer

The expiration month of the card.

exp_year integer

The expiration year of the card.

last4 string

The last 4 digits of the card number.

livemode boolean

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

metadata hash

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.

name string

The name of the cardholder, printed on the card.

pin hash

Metadata about the PIN on the card.

This is a virtual Net::API::Stripe::Issuing::Card::PinInfo object.

It contains the following property:

status string

The status of the pin. One of blocked or active.

replacement_for string (expandable)

The card this card replaces, if any. When expanded, this is a Net::API::Stripe::Issuing::Card object.

replacement_reason string

Why the card that this card replaces (if any) needed to be replaced. One of damage, expiration, loss, or theft.

shipping hash

Where and how the card will be shipped.

This is a Net::API::Stripe::Shipping object.

status string

One of active, inactive, canceled, lost, or stolen.

type string

One of virtual or physical.

API SAMPLE

        {
          "id": "ic_1FVF3MCeyNCl6fY2xb9oQVgl",
          "object": "issuing.card",
          "authorization_controls": {
                "allowed_categories": null,
                "blocked_categories": null,
                "currency": "usd",
                "max_amount": 10000,
                "max_approvals": 1,
                "spending_limits": [],
                "spending_limits_currency": null
          },
          "brand": "Visa",
          "cardholder": {
                "id": "ich_1DNcRHCeyNCl6fY2Epuwa9n9",
                "object": "issuing.cardholder",
                "authorization_controls": {
                  "allowed_categories": [],
                  "blocked_categories": [],
                  "spending_limits": [],
                  "spending_limits_currency": null
                },
                "billing": {
                  "address": {
                        "city": "Beverly Hills",
                        "country": "US",
                        "line1": "123 Fake St",
                        "line2": "Apt 3",
                        "postal_code": "90210",
                        "state": "CA"
                  },
                  "name": "Jenny Rosen"
                },
                "company": null,
                "created": 1540111055,
                "email": "jenny@example.com",
                "individual": null,
                "is_default": false,
                "livemode": false,
                "metadata": {},
                "name": "Jenny Rosen",
                "phone_number": "+18008675309",
                "requirements": {
                  "disabled_reason": null,
                  "past_due": []
                },
                "status": "active",
                "type": "individual"
          },
          "created": 1571480456,
          "currency": "usd",
          "exp_month": 8,
          "exp_year": 2020,
          "last4": "4242",
          "livemode": false,
          "metadata": {},
          "name": "Jenny Rosen",
          "pin": null,
          "replacement_for": null,
          "replacement_reason": null,
          "shipping": null,
          "status": "active",
          "type": "physical"
        }

HISTORY

v0.1

Initial version

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Stripe API documentation:

https://stripe.com/docs/api/issuing/cards

COPYRIGHT & LICENSE

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

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