> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Configure Stripe and Wix Payments, read payment analytics, and recognize inbound payment webhook traffic

> [!NOTE]
>
> The Apps API is in beta. Its endpoints and responses may change.

These endpoints cover the app's payment setup:

* Connecting and configuring Stripe or Wix Payments
* Managing a Stripe product and price catalog
* Reading payment analytics
* Recognizing the webhook traffic the providers send back to Base44

## Prerequisites

* A personal access token. See [Authentication](https://docs.base44.com/developers/references/apps-api/get-started/authentication.md) to get one.
* An app you can edit. Most operations here require write access, not just read access.

## App ID

Endpoints that act on a specific app include the app's ID in the URL path as `app_id`.

**To get your app ID:**

1. Go to [app.base44.com](https://app.base44.com/).
2. Open your app in the app editor.
3. Copy the app ID from the editor URL: `"https://app.base44.com/apps/<app_id>/editor"`.

## Two independent providers

An app connects to [Stripe](https://docs.base44.com/developers/references/apps-api/sections/payments-stripe.md), [Wix Payments](https://docs.base44.com/developers/references/apps-api/sections/payments-wix.md), or the legacy Payments by Wix integration. These are separate setups with separate credentials, so connecting one does not affect the others' stored state, except for [Install Stripe integration](https://docs.base44.com/api-reference/install-stripe-integration.md). The analytics and dashboard-link endpoints take a provider-specific path rather than a shared one.

## Inbound payment webhooks

> [!NOTE]
>
> Base44 registers the webhook endpoints under **Webhooks** with the payment provider for you, and the provider is the only caller. You can't invoke them for your own app or repoint them. They're documented so you can recognize the traffic and read the acknowledgements they return.

Every webhook responds with the same acknowledgement shape, with `status` coming back as `processed`, `acknowledged`, `ignored`, or (Stripe only) `logged`, plus an optional `reason` or `action` explaining it. These endpoints authenticate the provider's signature instead of a Base44 personal access token, so they carry no `Authorization` header requirement.

A verified event that fails processing returns an error so the provider retries it. An event Base44 can't attribute to an app, such as one missing the app ID it expects back, is acknowledged as `ignored` rather than failed.

## Payment analytics

These three endpoints read the same payment activity from different angles:

* [Get payment analytics](https://docs.base44.com/api-reference/get-payment-analytics.md): totals and a daily trend
* [Get recent payment transactions](https://docs.base44.com/api-reference/get-recent-payment-transactions.md): the latest individual payments, refunds, and disputes
* [Get top payment customers](https://docs.base44.com/api-reference/get-top-payment-customers.md): who's paid the most

## Transactions

These four endpoints work with individual transactions rather than aggregated summaries, and need write access to the app:

* [List payment transactions](https://docs.base44.com/api-reference/list-payment-transactions.md): every payment, refund, and lost dispute, paged, across the app's whole history
* [Export payment transactions](https://docs.base44.com/api-reference/export-payment-transactions.md): the same history as a CSV file
* [Get payment transaction](https://docs.base44.com/api-reference/get-payment-transaction.md): one payment in full, read live from its provider
* [Refund payment transaction](https://docs.base44.com/api-reference/refund-payment-transaction.md): refund all or part of a payment

## Rate limits

[Provision live Stripe keys](https://docs.base44.com/api-reference/provision-live-stripe-keys.md) has its own base limit, scoped to your account rather than the workspace, documented on its own rate-limit response. See [Rate limits](https://docs.base44.com/developers/references/apps-api/get-started/rate-limits.md) for the base limit that applies to every other operation here, and for the multiplier your plan gets on both.

## Endpoints

Setup and catalog endpoints are on the page for each provider:

* [Stripe](https://docs.base44.com/developers/references/apps-api/sections/payments-stripe.md): Set up Stripe, move from sandbox to live, and manage products and prices.
* [Wix Payments](https://docs.base44.com/developers/references/apps-api/sections/payments-wix.md): Connect Wix Payments, switch test mode, and open its dashboard.

### Analytics

* [Get recent payment transactions](https://docs.base44.com/api-reference/get-recent-payment-transactions.md): Read the app's most recent payments, refunds, and disputes.
* [Get top payment customers](https://docs.base44.com/api-reference/get-top-payment-customers.md): Rank customers by live payment amount or count.

### Transactions

* [List payment transactions](https://docs.base44.com/api-reference/list-payment-transactions.md): Read one page of payments, refunds, and lost disputes for one provider.
* [Export payment transactions](https://docs.base44.com/api-reference/export-payment-transactions.md): Download transactions for one provider as a CSV file.
* [Get payment transaction](https://docs.base44.com/api-reference/get-payment-transaction.md): Read one payment in full from its provider.
* [Refund payment transaction](https://docs.base44.com/api-reference/refund-payment-transaction.md): Refund all or part of a payment.

### Webhooks

* [Receive Stripe sandbox event](https://docs.base44.com/api-reference/receive-stripe-sandbox-event.md): The endpoint Base44 registers with Stripe for sandbox events.
* [Receive Stripe live event](https://docs.base44.com/api-reference/receive-stripe-live-event.md): The endpoint Base44 registers with Stripe for live events.
* [Receive Wix Payments event](https://docs.base44.com/api-reference/receive-wix-payments-event.md): The endpoint Base44 registers with Wix Payments.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.