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.