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).
- 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.
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.