REreap-global
Disputes

Create a dispute

Changed on

Submit a single dispute for a transaction. If the dispute reason requires cardholder signature, the dispute will be created with status REQUIRE_ACTION. Use the POST /disputes/{id}/sign endpoint to obtain the DocuSign WebForm URL.

post/disputes

Request

Headers

Accept-Versionstring required

Specifies the API version to use for this request.

Request body

transactionIdstring required

Reap's charge_id for the transaction

cardIdstring

Reap's card_id for the card. Derived from transactionId when omitted.

disputeAmountnumber float

Amount to dispute for a partial-amount dispute. Defaults to the full transaction amount when omitted.

disputeCurrency'344' | '840'

ISO 4217 numeric currency code. Defaults to the transaction currency when omitted.

cardholderNamestring

Registered cardholder full name

cardholderEmailstring email

Registered cardholder email

contactEmailstring email required

Email address to be informed of the dispute outcome

disputeReason'FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT' | 'FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT' | 'FRAUD_OTHER_CARD_PRESENT' | 'FRAUD_OTHER_CARD_ABSENT' | 'FRAUD_VISA_MONITORING_PROGRAM' | 'AUTHORIZATION_CARD_RECOVERY_BULLETIN' | 'AUTHORIZATION_DECLINED' | 'AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT' | 'PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE' | 'PROCESSING_ERROR_INCORRECT_CURRENCY' | 'PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER' | 'PROCESSING_ERROR_INCORRECT_AMOUNT' | 'PROCESSING_ERROR_DUPLICATE_PROCESSING' | 'PROCESSING_ERROR_INVALID_DATA' | 'CONSUMER_MERCHANDISE_NOT_RECEIVED' | 'CONSUMER_CANCELLED_RECURRING' | 'CONSUMER_NOT_AS_DESCRIBED' | 'CONSUMER_COUNTERFEIT_MERCHANDISE' | 'CONSUMER_MISREPRESENTATION' | 'CONSUMER_CREDIT_NOT_PROCESSED' | 'CONSUMER_CANCELLED_MERCHANDISE' | 'CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED' | 'CONSUMER_NON_RECEIPT_CASH_ATM' required

VisaDisputeType enum value

Example request

{
  "transactionId": "ch_abc123",
  "cardId": "card_xyz789",
  "disputeAmount": 100.5,
  "disputeCurrency": "840",
  "cardholderName": "John Doe",
  "cardholderEmail": "john.doe@example.com",
  "contactEmail": "finance@example.com",
  "disputeReason": "FRAUD_OTHER_CARD_ABSENT"
}

Response

Dispute created successfully

idstring uuid required

The unique identifier of the dispute

status'PENDING' | 'RECEIVED' | 'REVIEWING' | 'SUBMITTED' | 'REQUIRE_ACTION' | 'WON' | 'REFUNDED' | 'LOST' | 'DECLINED' | 'CANCELED' required

Current status of the dispute

transactionIdstring required

The transaction ID

disputeAmountnumber float required

The disputed amount

disputeCurrency'344' | '840' required

The ISO 4217 numeric currency code

disputeReasonstring required

The dispute reason

cardIdstring required

The card ID associated with the dispute

cardholderNamestring nullable

The cardholder full name. Always present in the response; null when not provided or derivable.

cardholderEmailstring email nullable

The cardholder email. Always present in the response; null when not provided or derivable.

contactEmailstring email required

Email address to be informed of the dispute outcome

createdAtstring date-time required

Date the dispute was created

Changes

  • beb4b8d4eb01Revision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional