Skip to content

Chargeback

Chargeback is a dispute process initiated by a cardholder through the issuing bank to recover funds from a transaction that is believed to be incorrect, unauthorized, or problematic.

When a chargeback occurs, we will notify you asynchronously via notification/callback.

Notification / Callback

Content-Type: application/json
{
    "eventType": "CHARGE_CHARGED_BACK",
    "data":  {
        "chargeDetails": {
              "transferStatusCode": 200,
              "transferErrorMsg": null,
              "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
              "referenceId": "1ec983fa-1a37-679b-809b-067861d87ab0",
              "paymentMethod": "CARD",
              "amount": 100,
              "currency": "BRL",
              "country": "BR",
              "finalAmount": 100,
              "finalCurrency": "BRL",
              "createTime": "2022-03-01 17:53:18 GMT-08:00",
              "scheduledTime": "2022-03-01 17:53:18 GMT-08:00",
              "finalStatusTime": "2022-03-01 17:59:59 GMT-08:00",
              "payer": {
                "name": "username",
                "email": "username@liquido.com",
                "document": {
                  "documentId": "53033315550",
                  "type": "CPF"
                },
                "phone": "+5581987654321"
              },  
              "transferDetails": {
                "card": {
                     "cardInfo": {
                          "cardHolderName": "card_holder_name",
                          "expirationMonth": 9,
                          "expirationYear": 2028,
                          "brand": "VISA",
                          "bin": "458124",
                          "last4": "0000"
                      },
                      "chargebackInfo": {
                        "category": "OTHER",
                        "reasonCode": "1999",
                        "reasonMessage": "Not Classified"
                      },
                      "cardId": "8736453a-dad0-4f26-85f0-95e8787d0237"
                 }
              },
              "transferStatus": "CHARGED_BACK",
              "description": "this is a test pay",
              "callbackUrl": "https://api.client.com/callback/",
              "subMerchantId": "UUID"
        }
    }
}

Parameters

Parameter Type Description
transferStatus String CHARGED_BACK
transferStatusCode Integer Transfer status code, 200 transaction SETTLED, IN_PROGRESS or AUTHORIZED, other FAILED
transferErrorMsg String Provide detailed error messages if payments fail. Please refer to the descriptions of the relevant status codes for 2xxx.
referenceId String Unique key to payment ticket, generated by Liquido.
idempotencyKey String Unique key to ensure idempotent requests. given by the merchant in their system
amount Long The transfer amount
country String country code
currency String The currency code of the transferred fund
finalAmount Long The final amount that is used for creating the charge order. EX: for charge orders with FX conversion, this field represents the converted amount from the original requested amount.
finalCurrency String The currency code of the finalAmount.
paymentMethod String payment method, enum value as CARD
payer JSON payer info
transferDetails JSON transaction details info
description String description of payment
callbackUrl String URL where Liquido will send notifications associated to changes to this payment. will receive a post request.
createdTime String Payment ticket created time
scheduledTime String Payment ticket scheduled time
finalStatusTime String Transfer final status update time, final status include SETTLED, FAILED
subMerchantId String The sub merchant ID.

Object Parameters

Payer Object Parameters
Parameter Type Description
name String fullname(Input specification: Only a combination of uppercase and lowercase letters, numbers and spaces is allowed. Spanish and Portuguese letters, and other special characters are not allowed).
email String email.
phone String Mobile phone number. Should include “+55” as a prefix.
document JSON Wallet holder identity proof, such as CPF for Brazil.
document Object Parameters
Parameter Type Description
documentId String identity number
type String enum of CPF or CNPJ
transferDetails Object Parameters
Parameter Type Description
card JSON card detail info
card Object in transferDetails Parameters
Parameter Type Description
cardInfo JSON card detail info
cardId String card id. Returned when paid with card ID, not returned when paid with card info
chargebackInfo JSON chargeback detail info
CardInfo Object in response Parameters
Parameter Type Description
cardHolderName String Cardholder's full name.
bin String first 6 digit number of the card
last4 String last 4 digit number of the card
brand String Credit card brand. such as VISA, MASTERCARD
expirationMonth Integer 1 or 2 digit number(s) representing the card's expiration month.
expirationYear Integer 4 digit numbers representing the card's expiration year.
Chargeback Info
Parameter Type Description
category String The category of the chargeback.
reasonCode String The code for chargeback reason.
reasonMessage String The explanation for the chargeback reason.
Category
Parameter Description
FRAUD The payment was suspected to be fraudulent.
AUTHORIZATION The payment has an authorization issue.
CUSTOMER_DISPUTE The payment was disputed by the customer.
PROCESSING_ERROR The payment was identified as incorrect during subsequent processing.
OTHER The payment needs to be charged back due to an unclassified reason.

Reason Code

Error code Error message
1001 Fraud - chip liability shift
1002 Fraud - card not present
1003 Fraud - no authorization
1101 No authorization
1201 Credit not processed
1202 Products or services not received
1203 Products or services not as described or defective
1204 Products or services cancelled
1301 Invalid card number
1302 Incorrect amount
1303 Incorrect currency
1304 Duplicate processing
1305 Paid by other means
1399 Processing error
1999 Not classified
Back to top