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

# Squarespace

> Fyatu payment integration for Squarespace Commerce — process payments from African customers.

<Warning>
  This integration is coming soon. Join our [waitlist](mailto:developers@fyatu.com?subject=Squarespace%20Integration%20Waitlist) to be notified when it's released.
</Warning>

Accept payments from customers across Africa on your Squarespace store with the official Fyatu payment integration.

## Requirements

* Squarespace Commerce (Basic or Advanced)
* Custom domain connected

## Installation

### Connect Fyatu to Squarespace

1. Login to your [FYATU Dashboard](https://web.fyatu.com)
2. Go to **Business Console > Select Your App**
3. Navigate to **Integrations > Squarespace**
4. Click **Connect Squarespace**
5. Authorize access to your Squarespace site

### Alternative: API Key Connection

1. In Squarespace, go to **Settings > Advanced > API Keys**
2. Generate a new API key with Commerce permissions
3. Copy the key to your Fyatu Dashboard integration settings

## Configuration

| Setting      | Description                            |
| ------------ | -------------------------------------- |
| Display Name | Payment method name at checkout        |
| Description  | Help text shown to customers           |
| Test Mode    | Enable for sandbox testing             |
| Auto-Fulfill | Automatically mark orders as fulfilled |

## Features

* **Native Checkout** - Appears as payment option in Squarespace checkout
* **Order Sync** - Automatic order status synchronization
* **Refunds** - Process refunds from Squarespace
* **Email Notifications** - Works with Squarespace email receipts
* **Inventory Updates** - Stock adjusted on payment
* **Member Areas** - Supports gated content payments

## Checkout Flow

```
Customer adds items to cart
           ↓
Customer proceeds to checkout
           ↓
Customer enters shipping/billing info
           ↓
Customer selects "Fyatu" payment
           ↓
Customer clicks "Submit Order"
           ↓
Customer redirected to Fyatu checkout
           ↓
Customer completes payment
           ↓
Customer redirected to confirmation
           ↓
Order marked as "Fulfilled" or "Pending"
```

## Supported Squarespace Features

| Feature           | Support |
| ----------------- | ------- |
| Physical Products | ✅       |
| Digital Products  | ✅       |
| Services          | ✅       |
| Subscriptions     | ✅       |
| Gift Cards        | ✅       |
| Member Areas      | ✅       |
| Donations         | ✅       |

## Code Injection (Advanced)

For custom checkout behavior, use Squarespace Code Injection:

**Settings > Advanced > Code Injection > Footer**

```html theme={null}
<script>
  // Listen for Fyatu payment events
  window.addEventListener('fyatu:payment:success', function(event) {
    // Custom tracking
    gtag('event', 'purchase', {
      transaction_id: event.detail.reference,
      value: event.detail.amount
    });
  });

  window.addEventListener('fyatu:payment:failed', function(event) {
    console.error('Payment failed:', event.detail.error);
  });
</script>
```

## Custom CSS

Style the Fyatu payment option:

**Design > Custom CSS**

```css theme={null}
/* Style the Fyatu payment option */
.payment-method-fyatu {
  border: 2px solid #721D5D;
  border-radius: 8px;
}

.payment-method-fyatu .payment-method-name {
  font-weight: 600;
}

.payment-method-fyatu .payment-method-icon {
  width: 40px;
  height: auto;
}
```

## Order Management

### View Orders

1. Go to **Commerce > Orders**
2. Filter by "Fyatu" payment method
3. Click an order to view details

### Order Statuses

| Payment Event    | Squarespace Status          |
| ---------------- | --------------------------- |
| Payment pending  | Pending                     |
| Payment received | Fulfilled (if auto-fulfill) |
| Payment failed   | Cancelled                   |
| Refund processed | Refunded                    |

## Refunds

To process a refund:

1. Go to **Commerce > Orders**
2. Click the order to refund
3. Click **Refund Order**
4. Select full or partial refund
5. Click **Refund**

<Note>
  Refunds are processed through Fyatu and returned to the original payment method.
</Note>

## Subscriptions

Fyatu supports Squarespace recurring payments:

1. Create a subscription product
2. Fyatu handles recurring billing
3. Customers can manage subscriptions via Fyatu portal

## Digital Products

For digital product delivery:

1. Upload your digital files in Squarespace
2. When payment completes via Fyatu
3. Download links sent automatically

## Member Areas

Accept payments for gated content:

1. Set up a Member Area in Squarespace
2. Configure Fyatu as payment method
3. Members pay via Fyatu to access content

## Donations

Accept donations with Fyatu:

1. Create a donation block or product
2. Enable "Pay what you want" pricing
3. Customers donate via Fyatu checkout

## Analytics

Track Fyatu payments in Squarespace Analytics:

1. Go to **Analytics > Sales**
2. Filter by payment method
3. View revenue, conversion rates, and trends

## Test Mode

Test your integration:

1. Enable Test Mode in Fyatu settings
2. Make test purchases
3. Verify orders appear in Squarespace
4. Disable test mode before launch

## Troubleshooting

### Payment option not showing

1. Verify Fyatu integration is connected
2. Check Squarespace plan supports additional payments
3. Ensure store is not in trial mode

### Orders not syncing

1. Check Fyatu Dashboard for webhook status
2. Verify API key permissions
3. Reconnect the integration if needed

### Checkout redirect issues

1. Ensure custom domain is properly configured
2. Check for conflicting scripts in Code Injection
3. Clear browser cache and retry

## SEO Considerations

For checkout pages:

* Squarespace handles SEO automatically
* Fyatu checkout has minimal impact on SEO
* Return URL includes proper canonical tags

## Resources

* [Squarespace Help Center](https://support.squarespace.com/)
* [Squarespace Commerce Guide](https://support.squarespace.com/hc/en-us/categories/206544547-Commerce)
* [Fyatu API Reference](/v3/api-reference/introduction)