Method: fraudNotification

Notifies Google of a fraud dispute initiated by a customer.

It is recommended that Google is notified of all potential fraud that has occurred. A call to this method might be accompanied by a chargebackNofication or inquiryNotification. Fraud can occur without a chargeback and a chargeback can occur without fraud. The information provided to this method does not initiate any money movement. It is used only to update Google's internal risk engine to reduce overall fraud. Google does not respond to this request with any information about the transaction.

An example request looks like:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "f3b6cffe-6fa0-4c33-84b5-7ff8d1ac9ecc",
    "requestTimestamp": 1483532962000
  },
  "paymentIntegratorAccountId": "SpeedyPaymentsIndia_INR",
  "captureRequestId": "G112YZH4XPDV88J",
  "fraudType": "FRAUDULENT_USE",
  "rawResult": {
    "scope": "VISA",
    "rawCode": "06"
  }
}

An example response looks like:


{
  "responseHeader": {
    "responseTimestamp": 1483532962349
  },
  "result": "SUCCESS"
}

HTTP request

POST https://billpaynotification.googleapis.com/secure-serving/gsp/google-authenticated-card-fop-api/v1/fraudNotification

Request body

The request body contains data with the following structure:

JSON representation
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "captureRequestId": string,
  "fraudType": enum (FraudType),
  "rawResult": {
    object (RawResult)
  }
}
Fields
requestHeader

object (RequestHeader)

REQUIRED: Common header for all requests.

paymentIntegratorAccountId

string

REQUIRED: This is the payment integrator account identifier that identifies contractual constraints around this transaction.

captureRequestId

string

REQUIRED: A unique identifier for the capture the potential fraud is associated with. This is the requestId generated by Google during the captureFundsReservation or capture for the original request.

fraudType

enum (FraudType)

REQUIRED: This is the type of fraud that may have occurred.

rawResult

object (RawResult)

REQUIRED: Raw result of the fraud notification from the issuer. Used to help inform Google's risk engine and analytics. In fraud code–mapping situations, data is sometimes lost. The integrator can choose to give Google a raw code. For example, a credit card gateway (the integrator) may use this field to communicate to Google the exact fraud code that was received from the VISA network. In that case, the scope would be "visa" and the rawCode would be whatever the VISA network returned.

Response body

If successful, the response body contains data with the following structure:

JSON representation
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (FraudNotificationResultCode)
}
Fields
responseHeader

object (ResponseHeader)

REQUIRED: Common header for all responses.

result

enum (FraudNotificationResultCode)

REQUIRED: Result of this call.

FraudType

Fraud type for the FraudNotificationRequest method.

Enums
UNKNOWN_TYPE Do not ever set this default value!
FRAUDULENT_USE Use was not authorized.
COUNTERFEIT Account owner did not knowingly participate in a transaction.
LOST The instrument was reported as lost by the account holder at the time of the transaction.
STOLEN The instrument was reported as comprimised by the account holder at the time of the transaction.
ACCOUNT_TAKEOVER The transaction was not authorized by the account holder.
FRAUDULENT_APPLICATION The user did not apply for this account or provided false details.
CARD_NOT_RECEIVED A card was reported as not received by the cardholder at the time of the transaction.
OTHER Unrecognized or unmapped type.

FraudNotificationResultCode

Result codes for the fraudNotification method.

Enums
UNKNOWN_RESULT Do not ever set this default value!
SUCCESS Fraud notification was successfully processed.