NAME
Net::API::Stripe::Issuing::Dispute - A Stripe Issued Card Transaction Dispute Object
SYNOPSIS
my $dispute = $stripe->issuing_dispute({
amount => 2000,
currency => 'jpy',
disputed_transaction => $issuing_transaction_object,
evidence => $dispute_evidence_object,
livemode => $stripe->false,
metadata => { transaction_id => 123 },
reason => 'Something went wrong',
status => 'lost',
});
See documentation in Net::API::Stripe for example to make api calls to Stripe to create those objects.
VERSION
v0.100.0
DESCRIPTION
As a card issuer (https://stripe.com/docs/issuing), you can dispute transactions (https://stripe.com/docs/issuing/disputes) that you do not recognize, suspect to be fraudulent, or have some other issue.
This module looks similar to the Net::API::Stripe::Dispute and has overlapping fields, but the event method points to different modules, so it is by design that there are 2 <*::Dispute::Evidence> modules.
CONSTRUCTOR
new( %ARG )
Creates a new Net::API::Stripe::Issuing::Dispute 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.dispute"
String representing the object’s type. Objects of the same type share the same value.
amount integer
Disputed amount. Usually the amount of the disputed_transaction, but can differ (usually because of currency fluctuation or because only part of the order is disputed).
balance_transactions array
List of balance transactions associated with the dispute.
created timestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
currency currency
The currency the disputed_transaction was made in.
disputed_transaction string (expandable)
The transaction being disputed.
When expanded, this is a Net::API::Stripe::Issuing::Transaction object.
evidence hash
Evidence related to the dispute. This hash will contain exactly one non-null value, containing an evidence object that matches its reason
This is a Net::API::Stripe::Issuing::Dispute::Evidence 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.
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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.
reason string
Reason for this dispute. One of other or fraudulent.
status string
Current status of dispute. One of lost, under_review, unsubmitted, or won.
transaction expandable
The transaction being disputed.
When expanded this is an Net::API::Stripe::Issuing::Transaction object.
API SAMPLE
{
"id": "idp_fake123456789",
"object": "issuing.dispute",
"amount": 100,
"created": 1571480456,
"currency": "usd",
"disputed_transaction": "ipi_fake123456789",
"evidence": {
"fraudulent": {
"dispute_explanation": "Fraud; card reported lost on 10/19/2019",
"uncategorized_file": null
},
"other": null
},
"livemode": false,
"metadata": {},
"reason": "fraudulent",
"status": "under_review"
}
HISTORY
v0.1
Initial version
AUTHOR
Jacques Deguest <jack@deguest.jp>
SEE ALSO
Stripe API documentation:
https://stripe.com/docs/api/issuing/disputes, https://stripe.com/docs/issuing/disputes
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.