Chargeback
A chargeback is a transaction disputed by the cardholder or the issuer. The chargeback amount is credited back to the cardholder account, and an acquirer often charges an additional chargeback fee from the merchant.
There are many reasons for chargebacks, but the most common are returned goods, terminated services, disputes, errors or fraud. However, merchants can minimize the risk of chargebacks at the time of sale by working to achieve maximum customer satisfaction and transaction accuracy.
You as a merchant can be notified about a chargeback either by locating the transaction in Overpay back office or catching a notification request sent to a notification URL set in Overpay back office.
Request
The request is posted to the notification URL every time when a chargeback is received in Overpay system.
Example of the chargeback notification
{
"transaction": {
"uid": "3d3951d1-8928-4287-9561-701566ccfd30",
"status": "successful",
"amount": 600,
"currency": "EUR",
"reason": "return",
"type": "chargeback",
"message": "Successfully processed",
"test": true,
"created_at": "2024-04-03T08:11:35.656Z",
"updated_at": "2024-04-03T08:11:35.856Z",
"paid_at": "2024-04-03T08:11:35.819Z",
"parent_uid": "ed0bb067-0c05-403b-8616-4e8f5bf14927",
"manually_corrected_at": null,
"parent_transaction": {
"uid": "ed0bb067-0c05-403b-8616-4e8f5bf14927",
"status": "successful",
"amount": 600,
"currency": "EUR",
"description": "Test transaction",
"type": "payment",
"payment_method_type": "credit_card",
"tracking_id": "345",
"message": "Successfully processed",
"test": true,
"created_at": "2024-04-03T08:10:37.112Z",
"updated_at": "2024-04-03T08:10:46.757Z",
"paid_at": "2024-04-03T08:10:46.655Z",
"expired_at": null,
"recurring_type": "initial",
"closed_at": null,
"settled_at": null,
"manually_corrected_at": null,
"language": "en",
"credit_card": {
"holder": "John Doe",
"stamp": "bb58cad9c1204ca2287b3e1006cc1a2c0fb8f062dde9e5232c8be5498bd0e62a",
"brand": "visa",
"last_4": "1097",
"first_1": "4",
"bin": "401200",
"bin_8": "40120000",
"issuer_country": null,
"issuer_name": null,
"product": null,
"exp_month": 7,
"exp_year": 2026,
"token_provider": null,
"token": "9b482cf5-c1ae-40f7-8cc3-7613ccf551ff"
},
"receipt_url": "https://backoffice.overpay.io/customer/transactions/ed0bb067-0c05-403b-8616-4e8f5bf14927/9912e29c6e89541706e9cf152ca2c7c4f2963d0f0f680833cb5f2104983c89ad?language=en",
"status_code": null,
"gateway": {
"iframe": true
},
"mute_notifications": null,
"id": "ed0bb067-0c05-403b-8616-4e8f5bf14927",
"additional_data": {
"contract": [
"recurring"
]
},
"redirect_url": "https://gateway.overpay.io/process/ed0bb067-0c05-403b-8616-4e8f5bf14927",
"code": "S.0000",
"friendly_message": "The operation is successful.",
"smart_routing_verification": {
"status": "successful"
},
"payment": {
"auth_code": "654321",
"bank_code": "05",
"rrn": "999",
"ref_id": "777888",
"message": "Payment was approved",
"amount": 600,
"currency": "EUR",
"billing_descriptor": "test descriptor",
"gateway_id": 3483,
"status": "successful"
},
"customer": {
"ip": null,
"email": null,
"device_id": null,
"birth_date": null
},
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"address": "1st Street",
"country": "US",
"city": "Denver",
"zip": "96002",
"state": "CO",
"phone": null
}
},
"receipt_url": "https://backoffice.overpay.io/customer/transactions/3d3951d1-8928-4287-9561-701566ccfd30/e3e31f8b090c097bd071696a95bcdca0f76e9caaa7049a499cd960bf36ba2cc0?language=en",
"status_code": null,
"id": "3d3951d1-8928-4287-9561-701566ccfd30",
"code": "S.0000",
"friendly_message": "The operation is successful.",
"chargeback": {
"message": "Chargeback was created",
"gateway_id": 3483,
"status": "successful"
}
}
}