Skip to main content
POST
/
v1
/
yativo-card
/
customers
/
{yativoCardId}
/
transactions
/
{transactionId}
/
dispute
curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/transactions/txn_abc123/dispute' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "reasonCode": "NOT_AS_DESCRIBED",
    "description": "Item received was significantly different from what was shown"
  }'

{
  "success": true,
  "message": "Dispute filed successfully",
  "data": {
    "dispute_id": "dsp_01HX9ABC123",
    "transaction_id": "txn_abc123",
    "status": "submitted",
    "reason_code": "NOT_AS_DESCRIBED",
    "filed_at": "2026-04-01T14:30:00.000Z"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
yativoCardId
string
required
The customer’s yativo_card_id.
​
transactionId
string
required
The transaction ID to dispute.
​
reasonCode
string
required
Dispute reason code. Retrieve valid codes from Get Dispute Reasons.
​
description
string
Optional additional context for the dispute.
curl -X POST 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/transactions/txn_abc123/dispute' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "reasonCode": "NOT_AS_DESCRIBED",
    "description": "Item received was significantly different from what was shown"
  }'

{
  "success": true,
  "message": "Dispute filed successfully",
  "data": {
    "dispute_id": "dsp_01HX9ABC123",
    "transaction_id": "txn_abc123",
    "status": "submitted",
    "reason_code": "NOT_AS_DESCRIBED",
    "filed_at": "2026-04-01T14:30:00.000Z"
  }
}