ChargebackEvent

  • The chargeback object represents a customer disputing a payment, leading to a return of funds.

  • It's linked to a chargebackNotification and is triggered by disputes on captured or asynchronously captured funds reservations.

  • The JSON structure includes details like the original capture request ID, the payment integrator's notification request ID, and various monetary values (charge, fees, and VAT).

  • Amounts can be positive or negative, indicating the direction of fund flow between Google and the payment integrator.

  • Optional fields provide further details like currency conversions and fee breakdowns for reporting.

This represents a chargeback. It is associated with a chargebackNotification and is used when a customer disputes a payment made in a capture or asynchronousCaptureFundsReservation. This is used to return funds to the customer.

JSON representation 
{
  "captureRequestId": string,
  "paymentIntegratorChargebackNotificationRequestId": string,
  "eventCharge": {
    object (Amount)
  },
  "eventPresentmentDetails": {
    object (EventPresentmentDetails)
  },
  "eventFee": {
    object (Amount)
  },
  "eventFeeBreakdown": {
    object (EventFeeBreakdown)
  },
  "eventVat": {
    object (Amount)
  }
}
Fields
captureRequestId

string

REQUIRED: requestId that was sent by Google for the capture request that this settlementEvent pertains to.
paymentIntegratorChargebackNotificationRequestId

string

REQUIRED: This is the requestId generated by the payment integrator in the chargebackNotification request.
eventCharge

object (Amount)

REQUIRED: If this amount is negative then it represents monetary value moving from Google to the payment integrator. If this is positive it is money from the payment integrator due to Google.
eventPresentmentDetails

object (EventPresentmentDetails)

OPTIONAL: If the settlement currency is different than the purchase currency then this field should be used to specify details about the event in the original purchase currency and the conversion to the settlement amount.
eventFee

object (Amount)

REQUIRED: If this amount is negative then it represents monetary value moving from Google to the payment integrator. If this is positive it is money from the payment integrator due to Google. If the fee is broken down into several parts, this value is the sum of them and the amount settled. A breakdown of the fee can be specified in the eventFeeBreakdown.

For example, if an agreement says that Google will pay 1% of the eventCharge to the payment integrator, and will reverse that 1% upon refund of that transaction, then the capture fee will be negative and upon refund the refund fee will be positive.
eventFeeBreakdown

object (EventFeeBreakdown)

OPTIONAL: This is a breakdown of the eventFee. It is used for reporting purposes and is not factored into the settlementAmount. It is used to understand what parts of the eventFee are attributable to what sources.
eventVat

object (Amount)

REQUIRED: If this amount is negative then it represents monetary value moving from Google to the payment integrator. If this is positive it is money from the payment integrator due to Google.

This is the value-added-tax (VAT) for the eventFee. This amount is in addition to the fee. e.g. If the eventCharge is $2.00, the eventFee is -$0.20 and the eventVat is -$0.05 the total settlement value for this event would be $1.75.