Google Standard Payments Google Hosted Card FOP API
Stay organized with collections
Save and categorize content based on your preferences.
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
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThis page details the Google Standard Payments API for Card on File Payments (Card FOP) enabling integration with Google's payment services.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers are encouraged to utilize Google-provided client libraries for seamless integration, although using custom libraries is also supported with the provided specifications.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers distinct endpoints for production and sandbox environments to facilitate development and testing.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive range of notification methods is provided, including chargebacks, refunds, fraud alerts, and settlement updates.\u003c/p\u003e\n"],["\u003cp\u003eA machine-readable Discovery Document is available for generating client libraries and tools to interact with Google APIs.\u003c/p\u003e\n"]]],["Google's Card FOP service uses a Discovery Document for API interaction, providing a machine-readable specification. Client libraries are recommended, but custom ones are supported. The service endpoint is `https://vgw.googleapis.com/gsp` (Prod) and `https://vgw.sandbox.google.com/gsp` (Sandbox). The service utilizes POST methods, which include actions like notifying Google about cancel/capture/refund results, chargebacks, fraud disputes, inquiries, and settlement events. Additionally, it can echo back messages and set acquirer reference numbers.\n"],null,["This includes services hosted by Google for Card FOP.\n\n- [REST Resource: gsp.card-fop-v1](#gsp.card-fop-v1)\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\nDiscovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) 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:\n\n- [/pay/card-fop-v1/google-card-fop-api/open-api-spec.json](/static/pay/card-fop-v1/google-card-fop-api/open-api-spec.json)\n\nService endpoint \n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_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:\n\n- Prod: `https://vgw.googleapis.com/gsp`\n- Sandbox: `https://vgw.sandbox.google.com/gsp`\n\n| Methods ||\n|-------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [cancelFundsReservationResultNotification](/pay/card-fop-v1/google-card-fop-api/cancelFundsReservationResultNotification) | `POST /google-card-fop-api/v1/cancelFundsReservationResultNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google of the final result of an [`asynchronousCancelFundsReservation`](/pay/card-fop-v1/payment-integrator-card-fop-api/asynchronousCancelFundsReservation#google.standardpayments.flows.card_fop_reserve_capture.v1.PaymentIntegratorCardReserveCaptureService.AsynchronousCancelFundsReservation) request. |\n| [captureFundsReservationResultNotification](/pay/card-fop-v1/google-card-fop-api/captureFundsReservationResultNotification) | `POST /v1/payment-integrator-card-fop-api/captureFundsReservationResultNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google of the final result of an [`asynchronousCaptureFundsReservation`](/pay/card-fop-v1/payment-integrator-card-fop-api/asynchronousCaptureFundsReservation#google.standardpayments.flows.card_fop_reserve_capture.v1.PaymentIntegratorCardReserveCaptureService.AsynchronousCaptureFundsReservation) request. |\n| [chargebackNotification](/pay/card-fop-v1/google-card-fop-api/chargebackNotification) | `POST /google-card-fop-api/v1/chargebackNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google that a chargeback is being issued for a payment. |\n| [chargebackReversedNotification](/pay/card-fop-v1/google-card-fop-api/chargebackReversedNotification) | `POST /google-card-fop-api/v1/chargebackReversedNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google that a chargeback is being reversed. |\n| [echo](/pay/card-fop-v1/google-card-fop-api/echo) | `POST /v1/echo/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Echos back the `clientMessage` passed in. |\n| [fraudNotification](/pay/card-fop-v1/google-card-fop-api/fraudNotification) | `POST /google-card-fop-api/v1/inquiryNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google of a fraud dispute initiated by a customer. |\n| [inquiryNotification](/pay/card-fop-v1/google-card-fop-api/inquiryNotification) | `POST /google-card-fop-api/v1/inquiryNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google of a request for inquiry into a transaction. |\n| [refundResultNotification](/pay/card-fop-v1/google-card-fop-api/refundResultNotification) | `POST /google-card-fop-api/v1/refundResultNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google of the final result of an [`asynchronousRefund`](/pay/card-fop-v1/payment-integrator-card-fop-api/asynchronousRefund#google.standardpayments.flows.card_fop_async_refund.v1.PaymentIntegratorCardAsyncRefundService.AsynchronousRefund) request. |\n| [reverseRefundNotification](/pay/card-fop-v1/google-card-fop-api/reverseRefundNotification) | `POST /google-card-fop-api/v1/reverseRefundNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google of a refund that is being reversed. |\n| [setAcquirerReferenceNumberForCaptureNotification](/pay/card-fop-v1/google-card-fop-api/setAcquirerReferenceNumberForCaptureNotification) | `POST /google-card-fop-api/v1/setAcquirerReferenceNumberForCaptureNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google of the Acquirer Reference Number (ARN) for a capture. |\n| [setAcquirerReferenceNumberForRefundNotification](/pay/card-fop-v1/google-card-fop-api/setAcquirerReferenceNumberForRefundNotification) | `POST /google-card-fop-api/v1/setAcquirerReferenceNumberForRefundNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Notifies Google of the Acquirer Reference Number (ARN) for a refund. |\n| [settlementNotification](/pay/card-fop-v1/google-card-fop-api/settlementNotification) | `POST /v1/settlementNotification/`[:PIAID](/pay/card-fop-v1/reference/glossary#payment_integrator_account_id) Informs Google that a set of events will be net settled in bulk into a Google bank account. |"]]