Google Standard Payments Google Hosted Card FOP API

  • This page details the Google Standard Payments API for Card on File Payments (Card FOP) enabling integration with Google's payment services.

  • Developers are encouraged to utilize Google-provided client libraries for seamless integration, although using custom libraries is also supported with the provided specifications.

  • The API offers distinct endpoints for production and sandbox environments to facilitate development and testing.

  • A comprehensive range of notification methods is provided, including chargebacks, refunds, fraud alerts, and settlement updates.

  • A machine-readable Discovery Document is available for generating client libraries and tools to interact with Google APIs.

This includes services hosted by Google for Card FOP.

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming Google Standard Payments APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • Prod: https://vgw.googleapis.com/secure-serving/gsp
  • Sandbox: https://vgw.sandbox.google.com/secure-serving/gsp
Methods
cancelFundsReservationResultNotification POST /google-card-fop-api/v1/cancelFundsReservationResultNotification/:PIAID
Notifies Google of the final result of an asynchronousCancelFundsReservation request.
captureFundsReservationResultNotification POST /v1/payment-integrator-card-fop-api/captureFundsReservationResultNotification/:PIAID
Notifies Google of the final result of an asynchronousCaptureFundsReservation request.
chargebackNotification POST /google-card-fop-api/v1/chargebackNotification/:PIAID
Notifies Google that a chargeback is being issued for a payment.
chargebackReversedNotification POST /google-card-fop-api/v1/chargebackReversedNotification/:PIAID
Notifies Google that a chargeback is being reversed.
echo POST /v1/echo/:PIAID
Echos back the clientMessage passed in.
fraudNotification POST /google-card-fop-api/v1/inquiryNotification/:PIAID
Notifies Google of a fraud dispute initiated by a customer.
inquiryNotification POST /google-card-fop-api/v1/inquiryNotification/:PIAID
Notifies Google of a request for inquiry into a transaction.
refundResultNotification POST /google-card-fop-api/v1/refundResultNotification/:PIAID
Notifies Google of the final result of an asynchronousRefund request.
reverseRefundNotification POST /google-card-fop-api/v1/reverseRefundNotification/:PIAID
Notifies Google of a refund that is being reversed.
setAcquirerReferenceNumberForCaptureNotification POST /google-card-fop-api/v1/setAcquirerReferenceNumberForCaptureNotification/:PIAID
Notifies Google of the Acquirer Reference Number (ARN) for a capture.
setAcquirerReferenceNumberForRefundNotification POST /google-card-fop-api/v1/setAcquirerReferenceNumberForRefundNotification/:PIAID
Notifies Google of the Acquirer Reference Number (ARN) for a refund.
settlementNotification POST /v1/settlementNotification/:PIAID
Informs Google that a set of events will be net settled in bulk into a Google bank account.