Create Dispute

Creates a new dispute for a payment, initiating the chargeback or dispute resolution process.

POST /v1/payments/{payment_id}/disputes

Create dispute

cURL

curl --request POST \
  --url https://api-sandbox.y.uno/v1/payments/{payment_id}/disputes \
  --header 'Content-Type: application/json' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "reason": "Customer claims item not received",
  "amount": {
    "currency": "BRL",
    "value": 150
  }
}
'

201

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "payment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": {
    "currency": "BRL",
    "value": 100
  },
  "reason": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

public-api-key · string · header · required

Your public API key from the Yuno Dashboard

private-secret-key · string · header · required

Your private secret key (server-side only)

Path Parameters

payment_id · string<uuid> · required

The unique identifier of the payment

Body

application/json

reason · string · required

Reason for the dispute

Example:

"Customer claims item not received"

amount · object · required

Show child attributes

Example:

{ "currency": "BRL", "value": 100 }

evidence · object

Show child attributes

Response

201

application/json

Dispute created successfully

id · string<uuid>

payment_id · string<uuid>

status · enum<string>

Available options: OPEN, EVIDENCE_SUBMITTED, WON, LOST, ACCEPTED

amount · object

Show child attributes

Example:

{ "currency": "BRL", "value": 100 }

reason · string

created_at · string<date-time>

updated_at · string<date-time>