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::Authorization::RequestHistory - A Stripe Authorization History Request Object

SYNOPSIS

    my $req_history = $stripe->authorization->req_history({
        approved => $stripe->true,
        authorized_amount => 2000,
        authorized_currency => 'jpy',
        created => '2020-04-12',
        held_amount => 1000,
        held_currency => 'jpy',
        reason => 'webhook_declined',
    });

VERSION

    0.2

DESCRIPTION

This is instantiated by method request_history in module Net::API::Stripe::Issuing::Authorization

CONSTRUCTOR

new( %ARG )

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

METHODS

approved boolean

Whether this request was approved.

authorized_amount integer

The amount that was authorized at the time of this request

authorized_currency string

The currency that was presented to the cardholder for the authorization. Three-letter ISO currency code, in lowercase. Must be a supported currency.

created timestamp

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

held_amount integer

The amount Stripe held from your account to fund the authorization, if the request was approved

held_currency string

The currency of the held amount

reason string

One of authentication_failed, authorization_controls, card_active, card_inactive, insufficient_funds, account_compliance_disabled, account_inactive, suspected_fraud, webhook_approved, webhook_declined, or webhook_timeout.

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

v0.2

Change helper method for approved from _set_get_scalar to _set_get_boolean

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.