The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Net::API::Stripe::Issuing::Dispute::Evidence - A Stripe Issued Card Dispute Evidence Object

SYNOPSIS

    my $ev = $stripe->issuing_dispute->evidence({
        fraudulent => 
        {
            dispute_explanation => 'Service not provided',
            uncategorized_file => $file_object,
        },
        other =>
        {
            dispute_explanation => 'Service was not provided',
            uncategorized_file => $file_object,
        },
    });

VERSION

    v0.101.0

DESCRIPTION

Evidence related to the dispute. This hash will contain exactly one non-null value, containing an evidence object that matches its reason

This is instantiated by method evidence in module Net::API::Stripe::Issuing::Dispute

CONSTRUCTOR

new( %ARG )

Creates a new Net::API::Stripe::Issuing::Dispute::Evidence object. It may also take an hash like arguments, that also are method of the same name.

METHODS

canceled hash

Evidence provided when reason is 'canceled'.

It has the following properties:

additional_documentation string expandable

(ID of a file upload) Additional documentation supporting the dispute.

When expanded this is an Net::API::Stripe::File object.

canceled_at timestamp

Date when order was canceled.

cancellation_policy_provided boolean

Whether the cardholder was provided with a cancellation policy.

cancellation_reason string

Reason for canceling the order.

expected_at timestamp

Date when the cardholder expected to receive the product.

explanation string

Explanation of why the cardholder is disputing this transaction.

product_description string

Description of the merchandise or service that was purchased.

product_type string

Whether the product was a merchandise or service.

return_status string

Result of cardholder's attempt to return the product.

returned_at timestamp

Date when the product was returned or attempted to be returned.

duplicate hash

Evidence provided when `reason` is 'duplicate'.'

It has the following properties:

additional_documentation string expandable

(ID of a file upload) Additional documentation supporting the dispute.

When expanded this is an Net::API::Stripe::File object.

card_statement string expandable

(ID of a file upload) Copy of the card statement showing that the product had already been paid for.

When expanded this is an Net::API::Stripe::File object.

cash_receipt string expandable

(ID of a file upload) Copy of the receipt showing that the product had been paid for in cash.

When expanded this is an Net::API::Stripe::File object.

check_image string expandable

(ID of a file upload) Image of the front and back of the check that was used to pay for the product.

When expanded this is an Net::API::Stripe::File object.

explanation string

Explanation of why the cardholder is disputing this transaction.

original_transaction string

Transaction (e.g., ipi_...) that the disputed transaction is a duplicate of. Of the two or more transactions that are copies of each other, this is original undisputed one.

fraudulent hash

Evidence to support a fraudulent dispute. This will only be present if your dispute’s reason is fraudulent.

This is a Net::API::Stripe::Issuing::Dispute::Evidence::Fraudulent object.

merchandise_not_as_described hash

Evidence provided when reason is 'merchandise_not_as_described'.'

It has the following properties:

additional_documentation string expandable

(ID of a file upload) Additional documentation supporting the dispute.

When expanded this is an Net::API::Stripe::File object.

explanation string

Explanation of why the cardholder is disputing this transaction.

received_at timestamp

Date when the product was received.

return_description string

Description of the cardholder's attempt to return the product.

return_status string

Result of cardholder's attempt to return the product.

returned_at timestamp

Date when the product was returned or attempted to be returned.

not_received hash

Evidence provided when reason is 'not_received'.

It has the following properties:

additional_documentation string expandable

(ID of a file upload) Additional documentation supporting the dispute.

When expanded this is an Net::API::Stripe::File object.

expected_at timestamp

Date when the cardholder expected to receive the product.

explanation string

Explanation of why the cardholder is disputing this transaction.

product_description string

Description of the merchandise or service that was purchased.

product_type string

Whether the product was a merchandise or service.

other hash

Evidence to support an uncategorized dispute. This will only be present if your dispute’s reason is other.

This is a Net::API::Stripe::Issuing::Dispute::Evidence::Other object.

reason string

The reason for filing the dispute. Its value will match the field containing the evidence.

service_not_as_described hash

Evidence provided when reason is 'service_not_as_described'.

It has the following properties:

additional_documentation string expandable

(ID of a file upload) Additional documentation supporting the dispute.

When expanded this is an Net::API::Stripe::File object.

canceled_at timestamp

Date when order was canceled.

cancellation_reason string

Reason for canceling the order.

explanation string

Explanation of why the cardholder is disputing this transaction.

received_at timestamp

Date when the product was received.

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.