Sign in

v1

latestOpenAPI 3.0.02026-08-04620256.0 KB
Disputes

Create a dispute

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

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 required

Reap's card_id for the card

disputeAmountnumber float required

Amount to dispute

disputeCurrency'344' | '840' required

ISO 4217 numeric currency code

cardholderNamestring required

Registered cardholder full name

cardholderEmailstring email required

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 required

The cardholder full name

cardholderEmailstring email required

The cardholder email

contactEmailstring email required

Email address to be informed of the dispute outcome

createdAtstring date-time required

Date the dispute was created