> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/payment-details-v1/introduction.md

## Article Content:

# About the Payment Details API

The Payment Details API retrieves the current and upcoming billing details for a site's Google Ads account, including ad spend for the active billing period and any scheduled future payments. The data is calculated from subscription information rather than queried live from Google Ads.

## With the Payment Details API, you can:

- Retrieve the current and upcoming billing periods for the site's Google Ads account, including ad spend for each.
- Retrieve the account's remaining credit balance and scheduled upcoming payment amounts.

## Before you begin

It's important to note the following points before starting to code:

- A Google Ads account must exist for the site before calling this service. Use the [Account API](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-account-v1/introduction.md) to create one.
- The response contains the current and, where available, the next upcoming billing period. It is not a historical ledger of past months.
- The data is calculated from subscription information, not queried live from Google Ads.
- `creditBalance` is a single account-level value, not scoped to a billing period. It can be negative, indicating outstanding debt before the charge has been applied. It's only populated for accounts on a weekly billing cycle.
- Use `upcomingPayments` to retrieve future billing amounts. The `monthlyPayments` field is deprecated and currently returns the same data as `upcomingPayments`.
- Amounts are expressed as decimal strings in the account's billing currency (for example, `"123.45"`).
- If the site's billing setup for the Google Ads account isn't complete, this call may fail.

## Use cases

- [Retrieve payment details](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/sample-flows.md#retrieve-payment-details).

## Terminology

- **Payment Record**: An entry showing the total ad spend and billing details for the current or an upcoming billing period of a site's Google Ads account.
- **creditBalance**: The remaining promotional or prepaid credit on the account. A negative value indicates outstanding debt before the charge is applied.
- **upcomingPayments**: The list of future scheduled billing amounts, replacing the deprecated `monthlyPayments` field.

@sdk_package_setup