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"
}
}
Card Customer — Card Operations
File Customer Card Dispute
File a dispute for a customer’s card transaction
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"
}
}
string
required
Bearer token:
Bearer YOUR_ACCESS_TOKENstring
required
The customer’s
yativo_card_id.string
required
The transaction ID to dispute.
string
required
Dispute reason code. Retrieve valid codes from
Get Dispute Reasons.
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"
}
}