Skip to main content
POST
/
api
/
yativo-card
/
{yativoCardId}
/
transactions
/
{transactionId}
/
dispute
curl -X POST 'https://crypto-api.yativo.com/api/yativo-card/yvc_01HX9KZMB3F7VNQP8R2WDGT4EI/transactions/ctxn_01HX9KZMB3F7VNQP8R2WDGT4EL/dispute' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason_code": "unauthorized",
    "description": "I did not make this purchase. My card details may have been compromised."
  }'

{
  "status": "success",
  "message": "Dispute filed successfully",
  "data": {
    "dispute_id": "dsp_01HX9KZMB3F7VNQP8R2WDGT4EM",
    "transaction_id": "ctxn_01HX9KZMB3F7VNQP8R2WDGT4EL",
    "reason_code": "unauthorized",
    "status": "open",
    "created_at": "2026-03-26T12:00:00Z"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
yativoCardId
string
required
The Yativo Card account ID.
​
transactionId
string
required
The ID of the transaction to dispute.
​
reason_code
string
required
The reason code for the dispute. Retrieve valid codes from the Get Dispute Reasons endpoint.
​
description
string
Optional additional description providing more context about the dispute.
curl -X POST 'https://crypto-api.yativo.com/api/yativo-card/yvc_01HX9KZMB3F7VNQP8R2WDGT4EI/transactions/ctxn_01HX9KZMB3F7VNQP8R2WDGT4EL/dispute' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason_code": "unauthorized",
    "description": "I did not make this purchase. My card details may have been compromised."
  }'

{
  "status": "success",
  "message": "Dispute filed successfully",
  "data": {
    "dispute_id": "dsp_01HX9KZMB3F7VNQP8R2WDGT4EM",
    "transaction_id": "ctxn_01HX9KZMB3F7VNQP8R2WDGT4EL",
    "reason_code": "unauthorized",
    "status": "open",
    "created_at": "2026-03-26T12:00:00Z"
  }
}