NAME

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

SYNOPSIS

my $trans = $stripe->issuing_transaction({
    amount => 2000,
    authorization => $authorization_object,
    balance_transaction => $balance_transaction,
    card => $card_object,
    currency => 'jpy',
    merchant_amount => 2000,
    merchant_currency => 'jpy',
    metadata => { transaction_id => 123, customer_id > 456 },
});

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

VERSION

v0.100.0

DESCRIPTION

Any use of an issued card (https://stripe.com/docs/issuing) that results in funds entering or leaving your Stripe account, such as a completed purchase or refund, is represented by an Issuing Transaction object.

CONSTRUCTOR

new( %ARG )

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

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::Payment::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

merchant_currency currency

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": "ipi_fake123456789",
  "object": "issuing.transaction",
  "amount": -100,
  "authorization": "iauth_fake123456789",
  "balance_transaction": null,
  "card": "ic_fake123456789",
  "cardholder": null,
  "created": 1571480456,
  "currency": "usd",
  "dispute": null,
  "livemode": false,
  "merchant_amount": -100,
  "merchant_currency": "usd",
  "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"
}

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/issuing/transactions

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.