Skip to main content

Search

Admoji Help Center

Browse guides, FAQs, and tutorials — or search for something specific

How to Mark a Single Payment as a Chargeback

A customer can have several payments: the sale, upsells and rebills. When a chargeback or a chargeback alert comes in for one of them, you can mark that exact payment, so your reports count the payment that was disputed and its amount. You can do it from the order in Admoji or with the API.

Step 1: Find the Payment

  1. Go to For Customers > Search and open the customer.

  2. In the Orders section, click the order to open Order Details.

  3. Open the Transactions tab. Each row is a payment, and the Transaction ID column shows the ID the gateway gave it, the same one that appears on the dispute notice.

Order Details Transactions tab with the Chargeback button of an approved sale highlighted

Step 2: Mark the Payment

  1. In the Actions column of the payment, click Chargeback. The button only shows on approved sales and captures.

  2. In the Mark transaction window, choose the Type: Chargeback or Chargeback Alert.

  3. Optionally, add a Note, for example the dispute reason or the date of the notice.

  4. Tick I understand and confirm this action and click Confirm marking. The message Transaction marked successfully confirms it.

Mark transaction window with Type set to Chargeback, a note and the confirmation box ticked
Important: Marking a payment cannot be undone. It marks only that payment, but it also cancels all of the customer's recurrings and blacklists the customer. It does not refund the payment or contact the payment gateway: to give the money back, use Refund on the same row. If you blacklisted a customer by mistake, see How to Remove a Customer from the Blacklist.

Step 3: Check the Result

  • The Status column of the payment shows a Chargeback badge (ChargebackAlert for an alert), and its Chargeback button is disabled.

  • The Alert Type column stays empty. It shows the alert service (RDR, Ethoca…) only for alerts marked with the API with an alert type, see How to Record the Type of a Chargeback Alert.

  • The customer is flagged as a chargeback (or chargeback alert) in their profile.

  • The customer's Logs > History shows the entry Transaction … marked as chargeback, with your note and your user.

Transactions tab with a Chargeback badge in the Status column and the Chargeback button disabled

Step 4: Mark the Payment with the API

If your dispute or chargeback alert tool is connected to Admoji, it can mark the payment with the mark-chargeback endpoint. Send the payment's Transaction ID in GatewayTransactionID:

$ curl -X POST 'https://openapi.admoji.com/api/v2/open/customers/mark-chargeback' \
  -H "content-type: application/json" \
  -H "Authorization: ApiKey secret_492796e421a34666a5695d53cd311111" \
  -H "Idempotency-Key: 3a2ebd06-e52f-47d2-92c4-66a107022f8e" \
  -d '{
    "CustomerID": 12148089,
    "Option": "cb",
    "GatewayTransactionID": "8f2c14a0-3b77-4e21-9c55-1d0e6a4b7f31",
    "Note": "Chargeback received from Visa on 2026-10-20"
}'

  • CustomerID — required. The customer the payment belongs to.

  • Option — required. cb for a chargeback or cbalert for a chargeback alert.

  • GatewayTransactionID — required. The Transaction ID of the payment. It has to belong to that customer, otherwise the call returns Transaction not found.

  • AlertType — optional, only with cbalert: RDR, Ethoca, CDRN, VerifiCDRN or Other. See How to Record the Type of a Chargeback Alert.

  • Note — optional. Added to the customer log entry.

Use an API key of type Chargeback Defence or Full Access, and send a new Idempotency-Key on every call. Like the button, the call cancels the customer's recurrings and blacklists the customer.

Tip: To find the GatewayTransactionID without opening the order, list the customer's transactions with the API. All the chargeback endpoints are described in How to Mark a Chargeback with the API.

Related articles