---
title: "Create a dispute"
method: POST
path: "/disputes"
tags: ["Disputes"]
---

# Create a dispute

`POST /disputes`

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.

## Headers

- `Accept-Version` string, required — Specifies the API version to use for this request.

## Request body

- object
  - `transactionId` string, required — Reap's charge_id for the transaction
  - `cardId` string, required — Reap's card_id for the card
  - `disputeAmount` number, float, required — Amount to dispute
  - `disputeCurrency` '344' | '840', required — ISO 4217 numeric currency code
  - `cardholderName` string, required — Registered cardholder full name
  - `cardholderEmail` string, email, required — Registered cardholder email
  - `contactEmail` string, 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

## Response `201`

Dispute created successfully

- object
  - `id` string, 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
  - `transactionId` string, required — The transaction ID
  - `disputeAmount` number, float, required — The disputed amount
  - `disputeCurrency` '344' | '840', required — The ISO 4217 numeric currency code
  - `disputeReason` string, required — The dispute reason
  - `cardId` string, required — The card ID associated with the dispute
  - `cardholderName` string, required — The cardholder full name
  - `cardholderEmail` string, email, required — The cardholder email
  - `contactEmail` string, email, required — Email address to be informed of the dispute outcome
  - `createdAt` string, date-time, required — Date the dispute was created

## Other responses

- `400` — Validation error

---

[API](https://skmtc.net/reap-global/apis/reap-api.md) · [All operations](https://skmtc.net/reap-global/apis/reap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reap-global/reap-api/versions/525072733e02/schema)