getChargeback

Circle Mint

Core Functionality

Balances

Payouts

Wires

CBIT

PIX

Transfers

Addresses

Deposits

Accounts API

Wallets

Transfers

API Overview

Health

Management

Encryption

Subscriptions

Stablecoins

Channels

Payments API

Payments

Pull Crypto Payments

Crypto Payment Intents

Cards

Payment Tokens

Settlements

Chargebacks

Balances

Checkout Sessions

Payouts API

Payouts

Crypto Address Book

Crypto Exchange Rates

Get a chargeback

GEThttps://api.circle.com/v1/chargebacks/{id}

Path parameters

uuid

Required

Universally unique identifier (UUID v4) of a resource.

Response

200GetChargebackResponse

Response Body

object

data

object

Show 7 properties

string

Required

Unique system generated identifier for the entity.

paymentId

string

Required

Unique system generated identifier for the payment that is associated to the chargeback item.

merchantId

string

Required

Unique system generated identifier for the merchant.

reasonCode

string

Required

Reason code given by the card network for the chargeback item.

status

string

Required

Enumerated status of the chargeback. active means you’ve received a dispute and you need to submit evidence if you want to defend against it. 'resolved' means the disputed payment had been refunded previously. Your account has not been debited. pending means we have acknowledged your evidence and forwarded it to the card issuer. won means you have won the dispute and your account has been credited. lost means the issuing bank has rejected your evidence and you have lost the dispute. There are no further financial implications. canceled means the issuing bank has canceled the dispute and your account has been credited. closed means the time to respond to this dispute has run out. No evidence can be submitted at this point.

category

string

Enumerated category of the chargeback status codes based on the chargeback status code.

history

array of objects

Required

The chargeback item's history list will be sorted by create date descending: more recent chargeback statuses will be at the beginning of the list.

Show 6 properties

type

string

Required

Enumerated type of the chargeback history event. 1st Chargeback represents the first stage of the dispute procedure initiated by the cardholder’s issuing bank. 2nd Chargeback represents the second stage of the dispute procedure initiated by the cardholder’s issuing bank (This stage is MasterCard only). Chargeback Reversal represents when 1st Chargeback or 2nd Chargeback is withdrawn by the issuer. Representment represents the stage when merchants decided to dispute 1st Chargeback or 2nd Chargeback. Chargeback Settlement can imply one of the two: 1) If merchant or marketplace is taking the lost of the chargeback, money will be debit from the wallet during this stage. 2) If merchant of marketplace successfully dispute the chargeback, money will be credit back to the wallet during this stage.

chargebackAmount

object

Required

Show 2 properties

fee

object

Show 2 properties

description

string

Required

The reason the chargeback was created.

settlementId

string

Unique system generated identifier for the settlement related to the chargeback history.

createDate

string

ISO-8601 UTC date/time format.

401NotAuthorized

404NotFound

RequestChoose a language

ResponseChoose an example

1{
2  "data": {
3    "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
4    "paymentId": "fc988ed5-c129-4f70-a064-e5beb7eb8e32",
5    "merchantId": "fc988ed5-c129-4f70-a064-e5beb7eb8e32",
6    "reasonCode": "10.4",
7    "status": "active",
8    "category": "Canceled Recurring Payment",
9    "history": [
10      {
11        "type": "1st Chargeback",
12        "chargebackAmount": {
13          "amount": "3.14",
14          "currency": "USD"
15        },
16        "fee": {
17          "amount": "3.14",
18          "currency": "USD"
19        },
20        "description": "The cardholder claims an unauthorized transaction occurred.",
21        "settlementId": "fc988ed5-c129-4f70-a064-e5beb7eb8e32",
22        "createDate": "2020-04-10T02:13:30.000Z"
23      }
24    ]
25  }
26}

Did this page help you?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy