Cancel Dispute

Cancels an active dispute (DISPUTE) on a payment. Used when the merchant decides to close the dispute without confirmation.

Endpoint

POST /v1/payments/{id}/dispute/cancel

Request Parameters

No request body required.

Request Example

curl -X POST https://api.bopay.io/v1/payments/550e8400-e29b-41d4/dispute/cancel \
  -H "Content-Type: application/json" \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: your-signature"

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "ext_id": "order_12345",
  "status": "cancelled_appeal"
}

Restrictions

• Only a dispute in DISPUTE status can be cancelled
• After cancellation the payment moves to CANCELLED_APPEAL status
• Re-opening the dispute is possible via POST /payments/{id}/dispute (from CANCELLED_APPEAL status)

Errors

Code	HTTP	Description
PAY_006	404	Payment not found
DIS_003	400	Can only cancel from DISPUTE status
SYS_001	500	Internal error