Dispute

Dispute: Search

Returns a collection of Dispute response objects.

availability

Managing disputes via the API is only available to merchants who can access disputes in the Braintree Control Panel.

For operators available on search fields, see the search fields page.

  1. Python
search_results = gateway.dispute.search([
  braintree.DisputeSearch.id == "dispute_id"
])

for dispute in search_results.disputes.items:
  print dispute.id
Parameters
The decimal value representing the disputed amount.
The decimal value representing the reserved amount.
The case number of the dispute.

The chargeback protection level of the dispute. Possible values:

  • EFFORTLESS
  • STANDARD
  • NOT_PROTECTED
The unique customer identifier associated with the disputed transaction.
The disbursement date of the dispute history event.
The effective date of the dispute history event.
'id'text
The unique dispute identifier.
'kind'multiple
The kind of dispute.
The ID of the merchant account this dispute is for.

A fragment of the merchant account ID to search for.

A part of the merchant account ID to search for.
A postfix for the merchant account ID to search for.
'is'text
An exact merchant account ID to search for.
A merchant account ID to be excluded from the search.
A prefix for the merchant account ID to search for.

The pre-dispute program of the dispute. Possible values:

  • VISA_RDR
  • NONE
'reason'multiple

The reason for the dispute. See reasons on the dispute response object for possible values.

The raw reason code provided by the processor (e.g. 83).
The date the dispute was received by the merchant.
The reference number of the dispute.
The merchant Reply By date that is referenced in the gateway.
'status'multiple

The status of the dispute. Possible values:

  • ACCEPTED
  • AUTO_ACCEPTED
  • DISPUTED
  • EXPIRED
  • OPEN
  • LOST
  • WON

See dispute statuses for more details.

The unique identifier for the disputed transaction.

How a transaction was created. Possible values:

  • API
  • CONTROL_PANEL
  • RECURRING
  • OAuth application client ID of the transaction facilitator

Examplesanchor

Multiple kindsanchor

This example shows searches on the kind parameter:

  1. Python
search_results = gateway.dispute.search([
  braintree.DisputeSearch.kind.in_list([
    braintree.Dispute.Kind.Chargeback,
    braintree.Dispute.Kind.Retrieval
  ])
])

Amount disputed rangeanchor

This example shows searches on the amount_disputed parameter:

  1. Python
search_results = gateway.dispute.search([
  braintree.DisputeSearch.amount_disputed.between("100.00", "200.00")
])