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::Issuing::MerchantData - A Stripe Merchant Data Object

SYNOPSIS

    my $data = $stripe->authorization->merchant_data({
        # https://stripe.com/docs/issuing/categories
        category => '8111',
        city => 'Tokyo',
        country => 'jp',
        name => 'Big Corp, Inc',
        network_id => $some_id,
        postal_code => '123-4567',
        state => undef,
        url => 'https://store.example.com/12/service/advisory',
    });

VERSION

    0.1

DESCRIPTION

This is used in Net::API::Stripe::Issuing::Authorization object.

This is instantiated by method merchant_data in module Net::API::Stripe::Issuing::Authorization, Net::API::Stripe::Issuing::Authorization::Transaction and Net::API::Stripe::Issuing::Transaction

CONSTRUCTOR

new( %ARG )

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

METHODS

category string

A categorization of the seller’s type of business. See Stripe merchant categories guide (https://stripe.com/docs/issuing/categories) for a list of possible values.

city string

City where the seller is located

country string

Country where the seller is located

name string

Name of the seller

network_id string

Identifier assigned to the seller by the card brand

postal_code string

Postal code where the seller is located

state string

State where the seller is located

url string

The url an online purchase was made from

API SAMPLE

        {
          "id": "iauth_fake123456789",
          "object": "issuing.authorization",
          "approved": true,
          "authorization_method": "online",
          "authorized_amount": 500,
          "authorized_currency": "usd",
          "balance_transactions": [],
          "card": null,
          "cardholder": null,
          "created": 1540642827,
          "held_amount": 0,
          "held_currency": "usd",
          "is_held_amount_controllable": false,
          "livemode": false,
          "merchant_data": {
                "category": "taxicabs_limousines",
                "city": "San Francisco",
                "country": "US",
                "name": "Rocket Rides",
                "network_id": "1234567890",
                "postal_code": "94107",
                "state": "CA",
                "url": null
          },
          "metadata": {},
          "pending_authorized_amount": 0,
          "pending_held_amount": 0,
          "request_history": [],
          "status": "reversed",
          "transactions": [
                {
                  "id": "ipi_fake123456789",
                  "object": "issuing.transaction",
                  "amount": -100,
                  "authorization": "iauth_fake123456789",
                  "balance_transaction": null,
                  "card": "ic_fake123456789",
                  "cardholder": null,
                  "created": 1540642827,
                  "currency": "usd",
                  "dispute": null,
                  "livemode": false,
                  "merchant_amount": null,
                  "merchant_currency": null,
                  "merchant_data": {
                        "category": "taxicabs_limousines",
                        "city": "San Francisco",
                        "country": "US",
                        "name": "Rocket Rides",
                        "network_id": "1234567890",
                        "postal_code": "94107",
                        "state": "CA",
                        "url": null
                  },
                  "metadata": {},
                  "type": "capture"
                },
                {
                  "id": "ipi_fake123456789",
                  "object": "issuing.transaction",
                  "amount": -100,
                  "authorization": "iauth_fake123456789",
                  "balance_transaction": null,
                  "card": "ic_fake123456789",
                  "cardholder": null,
                  "created": 1540642827,
                  "currency": "usd",
                  "dispute": null,
                  "livemode": false,
                  "merchant_amount": null,
                  "merchant_currency": null,
                  "merchant_data": {
                        "category": "taxicabs_limousines",
                        "city": "San Francisco",
                        "country": "US",
                        "name": "Rocket Rides",
                        "network_id": "1234567890",
                        "postal_code": "94107",
                        "state": "CA",
                        "url": null
                  },
                  "metadata": {},
                  "type": "capture"
                }
          ],
          "verification_data": {
                "address_line1_check": "not_provided",
                "address_zip_check": "match",
                "authentication": "none",
                "cvc_check": "match"
          },
          "wallet_provider": null
        }

HISTORY

v0.1

Initial version

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Stripe API documentation:

https://stripe.com/docs/api

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.