/ 
Net-API-Stripe-v2.0.5
River stage one • 1 direct dependent • 1 total dependent
/ Net::API::Stripe::Issuing::Authorization::Transaction

NAME

Net::API::Stripe::Issuing::Authorization::Transaction - A Stripe Authorization Transaction Object

SYNOPSIS

my $tr = $stripe->issuing_transaction({
    amount => 2000,
    authorization => $authorization_object,
    card => $card_object,
    cardholder => $cardholder_object,
    currency => 'jpy',
    merchant_amount => 2000,
    merchant_currency => 'jpy',
    merchant_data => $merchant_data_object,
    metadata => { transaction_id => 123 },
    type => 'capture',
});

See documentation in Net::API::Stripe for example to make api calls to Stripe to create those objects.

VERSION

v0.100.0

DESCRIPTION

No documentation on Stripe.com.

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

CONSTRUCTOR

new( %ARG )

Creates a new Net::API::Stripe::Issuing::Authorization::Transaction 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.

object string, value is "issuing.transaction"

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

amount integer

The transaction amount, which will be reflected in your balance. This amount is in your currency and in the smallest currency unit.

authorization string (expandable)

The Authorization object that led to this transaction.

When expanded, this is a Net::API::Stripe::Issuing::Authorization object.

balance_transaction string (expandable)

When expanded, this is a Net::API::Stripe::Balance::Transaction object.

card string (expandable)

The card used to make this transaction.

When expanded, this is a Net::API::Stripe::Issuing::Card object.

cardholder string (expandable)

The cardholder to whom this transaction belongs.

When expanded, 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.

dispute string (expandable)

When expanded, this is a Net::API::Stripe::Issuing::Dispute object.

livemode boolean

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

merchant_amount integer

The amount that the merchant will receive, denominated in "merchant_currency" and in the smallest currency unit. It will be different from "amount" if the merchant is taking payment in a different currency.

merchant_currency currency

The currency with which the merchant is taking payment.

merchant_data hash

More information about the user involved in the transaction.

This is a Net::API::Stripe::Issuing::MerchantData object.

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.

type string

One of capture, refund, cash_withdrawal, refund_reversal, dispute, or dispute_loss.

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/issuing/transactions, https://stripe.com/docs/api/issuing/authorizations/object

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.