The Dispute object 

Issuing
Disputes
The Dispute object

Attributes

  • idstring

    Unique identifier for the object.

  • amountinteger

    Disputed amount in the card’s currency and in the smallest currency unit. Usually the amount of the transaction, but can differ (usually because of currency fluctuation).

  • balance_transactionsnullable array of objectsExpandable

    List of balance transactions associated with the dispute.

    • balance_transactions.idstring

      Unique identifier for the object.

    • balance_transactions.objectstring

      String representing the object’s type. Objects of the same type share the same value.

    • balance_transactions.amountinteger

      Gross amount of this transaction (in cents). A positive value represents funds charged to another party, and a negative value represents funds sent to another party.

    • balance_transactions.available_ontimestamp

      The date that the transaction’s net funds become available in the Stripe balance.

    • balance_transactions.balance_typeenumPreview feature

      The balance that this transaction impacts.

      Possible enum values
      issuing

      Balance Transactions that affect your Issuing balance

      payments

      Balance Transactions that affect your Payments balance

      refund_and_dispute_prefunding

      Balance Transactions that affect your Refund and Dispute Prefunding balance

    • balance_transactions.createdtimestamp

      Time at which the object was created. Measured in seconds since the Unix epoch.

    • balance_transactions.currencyenum

      Three-letter ISO currency code, in lowercase. Must be a supported currency.

    • balance_transactions.descriptionnullable string

      An arbitrary string attached to the object. Often useful for displaying to users.

    • balance_transactions.exchange_ratenullable float

      If applicable, this transaction uses an exchange rate. If money converts from currency A to currency B, then the amount in currency A, multipled by the exchange_rate, equals the amount in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent’s amount is 1000 and currency is eur. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction’s amount is 1234, its currency is usd, and the exchange_rate is 1.234.

    • balance_transactions.feeinteger

      Fees (in cents) paid for this transaction. Represented as a positive integer when assessed.

    • balance_transactions.fee_detailsarray of objects

      Detailed breakdown of fees (in cents) paid for this transaction.

      • balance_transactions.fee_details.amountinteger

        Amount of the fee, in cents.

      • balance_transactions.fee_details.applicationnullable string

        ID of the Connect application that earned the fee.

      • balance_transactions.fee_details.currencyenum

        Three-letter ISO currency code, in lowercase. Must be a supported currency.

      • balance_transactions.fee_details.descriptionnullable string

        An arbitrary string attached to the object. Often useful for displaying to users.

      • balance_transactions.fee_details.typestring

        Type of the fee, one of: application_fee, payment_method_passthrough_fee, stripe_fee or tax.

    • balance_transactions.netinteger

      Net impact to a Stripe balance (in cents). A positive value represents incrementing a Stripe balance, and a negative value decrementing a Stripe balance. You can calculate the net impact of a transaction on a balance by amount - fee

    • balance_transactions.reporting_categorystring

      Learn more about how reporting categories can help you understand balance transactions from an accounting perspective.

    • balance_transactions.sourcenullable stringExpandable

      This transaction relates to the Stripe object.

    • balance_transactions.statusstring

      The transaction’s net funds status in the Stripe balance, which are either available or pending.

    • balance_transactions.typeenum

      Transaction type: adjustment, advance, advance_funding, anticipation_repayment, application_fee, application_fee_refund, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, contribution, issuing_authorization_hold, issuing_authorization_release, issuing_dispute, issuing_transaction, obligation_outbound, obligation_reversal_inbound, payment, payment_failure_refund, payment_network_reserve_hold, payment_network_reserve_release, payment_refund, payment_reversal, payment_unreconciled, payout, payout_cancel, payout_failure, payout_minimum_balance_hold, payout_minimum_balance_release, refund, refund_failure, reserve_transaction, reserved_funds, stripe_fee, stripe_fx_fee, stripe_balance_payment_debit, stripe_balance_payment_debit_reversal, tax_fee, topup, topup_reversal, transfer, transfer_cancel, transfer_failure, or transfer_refund. Learn more about balance transaction types and what they represent. To classify transactions for accounting purposes, consider reporting_category instead.

      Possible enum values
      adjustment
      advance
      advance_funding
      anticipation_repayment
      application_fee
      application_fee_refund
      charge
      climate_order_purchase
      climate_order_refund
      connect_collection_transfer
      Show 34 more
  • currencyenum

    The currency the transaction was made in.

  • evidenceobject

    Evidence for the dispute. Evidence contains exactly two non-null fields: the reason for the dispute and the associated evidence field for the selected reason.

    • evidence.cancelednullable object

      Evidence provided when reason is ‘canceled’.

      • evidence.canceled.additional_documentationnullable stringExpandable

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

      • evidence.canceled.canceled_atnullable timestamp

        Date when order was canceled.

      • evidence.canceled.cancellation_policy_providednullable boolean

        Whether the cardholder was provided with a cancellation policy.

      • evidence.canceled.cancellation_reasonnullable string

        Reason for canceling the order.

      • evidence.canceled.expected_atnullable timestamp

        Date when the cardholder expected to receive the product.

      • evidence.canceled.explanationnullable string

        Explanation of why the cardholder is disputing this transaction.

      • evidence.canceled.product_descriptionnullable string

        Description of the merchandise or service that was purchased.

      • evidence.canceled.product_typenullable enum

        Whether the product was a merchandise or service.

        Possible enum values
        merchandise

        Tangible goods such as groceries and furniture.

        service

        Intangible goods such as domain name registration, flights and lessons.

      • evidence.canceled.return_statusnullable enum

        Result of cardholder’s attempt to return the product.

        Possible enum values
        merchant_rejected

        The merchant rejected the return.

        successful

        The merchant accepted the return.

      • evidence.canceled.returned_atnullable timestamp

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

    • evidence.duplicatenullable object

      Evidence provided when reason is ‘duplicate’.

      • evidence.duplicate.additional_documentationnullable stringExpandable

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

      • evidence.duplicate.card_statementnullable stringExpandable

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

      • evidence.duplicate.cash_receiptnullable stringExpandable

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

      • evidence.duplicate.check_imagenullable stringExpandable

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

      • evidence.duplicate.explanationnullable string

        Explanation of why the cardholder is disputing this transaction.

      • evidence.duplicate.original_transactionnullable 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.

    • evidence.fraudulentnullable object

      Evidence provided when reason is ‘fraudulent’.

      • evidence.fraudulent.additional_documentationnullable stringExpandable

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

      • evidence.fraudulent.explanationnullable string

        Explanation of why the cardholder is disputing this transaction.

    • evidence.merchandise_not_as_describednullable object

      Evidence provided when reason is ‘merchandise_not_as_described’.

      • evidence.merchandise_not_as_described.additional_documentationnullable stringExpandable

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

      • evidence.merchandise_not_as_described.explanationnullable string

        Explanation of why the cardholder is disputing this transaction.

      • evidence.merchandise_not_as_described.received_atnullable timestamp

        Date when the product was received.

      • evidence.merchandise_not_as_described.return_descriptionnullable string

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

      • evidence.merchandise_not_as_described.return_statusnullable enum

        Result of cardholder’s attempt to return the product.

        Possible enum values
        merchant_rejected

        The merchant rejected the return.

        successful

        The merchant accepted the return.

      • evidence.merchandise_not_as_described.returned_atnullable timestamp

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

    • evidence.no_valid_authorizationnullable object

      Evidence provided when reason is ‘no_valid_authorization’.

      • evidence.no_valid_authorization.additional_documentationnullable stringExpandable

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

      • evidence.no_valid_authorization.explanationnullable string

        Explanation of why the cardholder is disputing this transaction.

    • evidence.not_receivednullable object

      Evidence provided when reason is ‘not_received’.

      • evidence.not_received.additional_documentationnullable stringExpandable

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

      • evidence.not_received.expected_atnullable timestamp

        Date when the cardholder expected to receive the product.

      • evidence.not_received.explanationnullable string

        Explanation of why the cardholder is disputing this transaction.

      • evidence.not_received.product_descriptionnullable string

        Description of the merchandise or service that was purchased.

      • evidence.not_received.product_typenullable enum

        Whether the product was a merchandise or service.

        Possible enum values
        merchandise

        Tangible goods such as groceries and furniture.

        service

        Intangible goods such as domain name registration, flights and lessons.

    • evidence.othernullable object

      Evidence provided when reason is ‘other’.

      • evidence.other.additional_documentationnullable stringExpandable

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

      • evidence.other.explanationnullable string

        Explanation of why the cardholder is disputing this transaction.

      • evidence.other.product_descriptionnullable string

        Description of the merchandise or service that was purchased.

      • evidence.other.product_typenullable enum

        Whether the product was a merchandise or service.

        Possible enum values
        merchandise

        Tangible goods such as groceries and furniture.

        service

        Intangible goods such as domain name registration, flights and lessons.

    • evidence.reasonenum

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

      Possible enum values
      canceled

      Service or merchandise was canceled.

      duplicate

      There were multiple copies of a charge for a single purchase, or the charge was paid by other means.

      fraudulent

      The cardholder’s details were compromised and the cardholder claims to not have participated in the transaction.

      merchandise_not_as_described

      The merchandise was not as described.

      no_valid_authorization

      The merchant processed a transaction without first obtaining a correct and valid authorization approval.

      not_received

      Merchandise or service was not received.

      other

      All other types of disputes.

      service_not_as_described

      The service was not as described.

    • evidence.service_not_as_describednullable object

      Evidence provided when reason is ‘service_not_as_described’.

      • evidence.service_not_as_described.additional_documentationnullable stringExpandable

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

      • evidence.service_not_as_described.canceled_atnullable timestamp

        Date when order was canceled.

      • evidence.service_not_as_described.cancellation_reasonnullable string

        Reason for canceling the order.

      • evidence.service_not_as_described.explanationnullable string

        Explanation of why the cardholder is disputing this transaction.

      • evidence.service_not_as_described.received_atnullable timestamp

        Date when the product was received.

  • metadataobject

    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.

  • statusenum

    Current status of the dispute.

    Possible enum values
    expired

    The dispute has expired.

    lost

    The dispute is lost.

    submitted

    The dispute has been submitted to Stripe.

    unsubmitted

    The dispute is pending submission to Stripe.

    won

    The dispute is won.

  • transactionstringExpandable

    The transaction being disputed.

More attributes

  • objectstring

    String representing the object’s type. Objects of the same type share the same value.

  • createdtimestamp

    Time at which the object was created. Measured in seconds since the Unix epoch.

  • livemodeboolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

  • loss_reasonnullable enum

    The enum that describes the dispute loss outcome. If the dispute is not lost, this field will be absent. New enum values may be added in the future, so be sure to handle unknown values.

    Possible enum values
    cardholder_authentication_issuer_liability

    This dispute, created for Card-Not-Present fraud, is invalid because the card network has indicated the cardholder was securely authenticated. This most commonly occurs via 3DS or a secure digital wallet (e.g. Apple Pay). The dispute was automatically rejected by the card network.

    eci5_token_transaction_with_tavv

    DEPRECATED: This dispute, created under Condition 10.4: Other Fraud, is invalid for an ECI 5 Token Transaction where the Token Authentication Verification Value (TAVV) was included in the Authorization Request. The dispute was automatically rejected by Visa.

    excess_disputes_in_timeframe

    This dispute is invalid as more than 35 total disputes have been submitted with 120 calendar days of this dispute. The dispute was automatically rejected by the card network.

    has_not_met_the_minimum_dispute_amount_requirements

    This dispute has not met the minimum amount threshold set by the card network based on the MCC. The dispute was automatically rejected by the card network.

    invalid_duplicate_dispute

    This dispute, created under Condition 12.6: Duplicate Processing/Paid by Other Means, has not met the criteria set by Visa. The dispute was automatically rejected by Visa.

    invalid_incorrect_amount_dispute

    This dispute, created under Condition 12.5: Incorrect Amount, has not met the criteria set by Visa. The dispute must include evidence of the correct amount. The dispute was automatically rejected by Visa.

    invalid_no_authorization

    The dispute, created under Condition 11.3: No Authorization, is invalid due to the transaction being authorized as indicated in the Visa Core Rules and Visa Product and Service Rules. The dispute was automatically rejected by Visa.

    invalid_use_of_disputes

    Stripe has determined that this is an invalid use of the card network dispute process; no dispute conditions apply.

    merchandise_delivered_or_shipped

    The merchant provided evidence indicating that the merchandise was shipped/delivered. Stripe has evaluated this evidence and determined that it is compelling.

    merchandise_or_service_as_described

    The merchant provided information indicating the item/service provided matched the description. Stripe has evaluated this evidence and determined that it is compelling.

    Show 10 more
The Dispute object
{
"id": "idp_1MykdxFtDWhhyHE1BFAV3osZ",
"object": "issuing.dispute",
"amount": 100,
"created": 1681947753,
"currency": "usd",
"evidence": {
"fraudulent": {
"additional_documentation": null,
"dispute_explanation": null,
"explanation": "This transaction is fraudulent.",
"uncategorized_file": null
},
"reason": "fraudulent"
},
"livemode": false,
"metadata": {},
"status": "unsubmitted",
"transaction": "ipi_1MykXhFtDWhhyHE1UjsZZ3xQ"
}