Source: https://datafa.st/docs/api/account/integrations
Markdown source: https://datafa.st/docs/api/account/integrations.md
Description: Check, connect, and disconnect payment integrations.

# Integrations

Use these endpoints to check payment-provider status and connect or disconnect providers programmatically.

Use the integration API when an agent or internal tool needs to complete revenue attribution setup. Connect endpoints validate provider credentials, create webhooks when possible, and backfill existing payments where supported.

Base path: `https://datafa.st/api/v1/admin`

| Endpoint | Method | Path | Permission | Purpose |
|---|---|---|---|---|
| [Get integrations](/docs/api/account/integrations/retrieve) | GET | `/websites/{websiteId}/integrations` | `settings:read` | Get provider connection status |
| [Connect Stripe](/docs/api/account/integrations/stripe/connect) | POST | `/websites/{websiteId}/integrations/stripe` | `settings:write` | Connect Stripe with `stripeRak` |
| [Disconnect Stripe](/docs/api/account/integrations/stripe/disconnect) | DELETE | `/websites/{websiteId}/integrations/stripe` | `settings:write` | Disconnect Stripe |
| [Connect Lemon Squeezy](/docs/api/account/integrations/lemonsqueezy/connect) | POST | `/websites/{websiteId}/integrations/lemonsqueezy` | `settings:write` | Connect Lemon Squeezy with `lemonsqueezyApiKey` and `lemonsqueezyStoreId` |
| [Disconnect Lemon Squeezy](/docs/api/account/integrations/lemonsqueezy/disconnect) | DELETE | `/websites/{websiteId}/integrations/lemonsqueezy` | `settings:write` | Disconnect Lemon Squeezy |
| [Connect Polar](/docs/api/account/integrations/polar/connect) | POST | `/websites/{websiteId}/integrations/polar` | `settings:write` | Connect Polar with `polarAccessToken` and `polarOrgId` |
| [Disconnect Polar](/docs/api/account/integrations/polar/disconnect) | DELETE | `/websites/{websiteId}/integrations/polar` | `settings:write` | Disconnect Polar |
| [Connect Paddle](/docs/api/account/integrations/paddle/connect) | POST | `/websites/{websiteId}/integrations/paddle` | `settings:write` | Connect Paddle with `paddleApiKey` |
| [Disconnect Paddle](/docs/api/account/integrations/paddle/disconnect) | DELETE | `/websites/{websiteId}/integrations/paddle` | `settings:write` | Disconnect Paddle |
| [Disconnect Shopify](/docs/api/account/integrations/shopify/disconnect) | DELETE | `/websites/{websiteId}/integrations/shopify` | `settings:write` | Disconnect Shopify |
| [Disconnect WooCommerce](/docs/api/account/integrations/woocommerce/disconnect) | DELETE | `/websites/{websiteId}/integrations/woocommerce` | `settings:write` | Disconnect WooCommerce |

Provider credentials are stored by DataFast and never returned by the status endpoint.

## Connect Stripe

```sh
curl -X POST "https://datafa.st/api/v1/admin/websites/YOUR_WEBSITE_ID/integrations/stripe" \
  -H "Authorization: Bearer dft_xxx" \
  -H "Content-Type: application/json" \
  -d '{"stripeRak":"rk_live_..."}'
```

Use a Stripe restricted API key that starts with `rk_`, not a publishable or secret key.

Related docs: [connect payment provider](/docs/connect-payment-provider), [revenue attribution](/docs/revenue-attribution-guide), [authentication and scopes](/docs/api/authentication).

## Code examples

### Connect Stripe

```bash
curl -X POST "https://datafa.st/api/v1/admin/websites/YOUR_WEBSITE_ID/integrations/stripe" \
  -H "Authorization: Bearer dft_xxx" \
  -H "Content-Type: application/json" \
  -d '{"stripeRak":"rk_live_..."}'
```

### Success response

```json
{
  "status": "success",
  "data": [
    {
      "message": "Stripe connected successfully",
      "currency": "USD"
    }
  ]
}
```