> ## 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.

# Wix

> Fyatu payment provider for Wix eCommerce — accept payments from African markets on your Wix store.

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

Accept payments from customers across Africa on your Wix store with the official Fyatu payment provider.

## Requirements

* Wix eCommerce or Wix Stores
* Wix Premium plan (for accepting payments)

## Installation

### From Wix App Market

1. Go to the [Wix App Market](https://www.wix.com/app-market)
2. Search for "Fyatu"
3. Click **Add to Site**
4. Select your site and click **Add**
5. Complete the setup wizard

## Configuration

### Step 1: Connect Your Fyatu Account

1. After installation, click **Set Up** in the app
2. Login to your Fyatu account or create one
3. Select your Collection App
4. Authorize the connection

### Step 2: Configure Settings

| Setting             | Description                 |
| ------------------- | --------------------------- |
| Display Name        | Name shown at checkout      |
| Payment Description | Description for customers   |
| Test Mode           | Enable for testing          |
| Accepted Countries  | Limit to specific countries |

### Step 3: Enable Payment Method

1. Go to **Settings > Accept Payments**
2. Find Fyatu under payment providers
3. Toggle to enable

## Features

* **Wix Checkout Integration** - Native checkout experience
* **Automatic Order Updates** - Syncs payment status automatically
* **Mobile Optimized** - Works on Wix mobile sites
* **Refunds** - Process refunds from order management
* **Wix Ascend** - Compatible with Wix CRM features
* **Automations** - Trigger Wix Automations on payment

## Checkout Flow

```
Customer adds items to cart
           ↓
Customer proceeds to checkout
           ↓
Customer selects "Fyatu" payment
           ↓
Customer clicks "Place Order"
           ↓
Customer redirected to Fyatu checkout
           ↓
Customer completes payment
           ↓
Customer redirected to thank you page
           ↓
Order marked as "Paid"
```

## Wix Editor Integration

Add a custom "Pay with Fyatu" button anywhere on your site:

1. Add a **Button** element
2. Set the link to: `wix-pay://fyatu`
3. Or use Velo to create custom payment flows

### Velo Code Example

```javascript theme={null}
import wixPay from 'wix-pay';

$w.onReady(function () {
    $w('#payButton').onClick(async () => {
        try {
            const payment = await wixPay.startPayment('fyatu', {
                amount: 50.00,
                currency: 'USD',
                items: [{
                    name: 'Product Name',
                    quantity: 1,
                    price: 50.00
                }]
            });

            if (payment.status === 'Successful') {
                wixLocation.to('/thank-you');
            }
        } catch (error) {
            console.error('Payment failed:', error);
        }
    });
});
```

## Wix Stores Integration

For Wix Stores product pages:

```javascript theme={null}
import wixStores from 'wix-stores';
import wixPay from 'wix-pay';

export async function buyNowButton_click(event) {
    const product = await $w('#productPage').getProduct();

    const payment = await wixPay.startPayment('fyatu', {
        amount: product.price,
        currency: product.currency,
        items: [{
            name: product.name,
            quantity: 1,
            price: product.price
        }]
    });
}
```

## Wix Automations

Trigger automations when payments are received:

1. Go to **Automations**
2. Click **New Automation**
3. Select trigger: "Fyatu Payment Received"
4. Add actions:
   * Send email confirmation
   * Add to contact list
   * Update CRM
   * Send chat message

## Order Management

View Fyatu orders in Wix:

1. Go to **Store Orders** or **Orders**
2. Filter by payment method: "Fyatu"
3. Click an order to view details

### Order Statuses

| Payment Status | Wix Order Status |
| -------------- | ---------------- |
| Pending        | Not Paid         |
| Completed      | Paid             |
| Failed         | Payment Failed   |
| Refunded       | Refunded         |

## Refunds

To process a refund:

1. Go to **Store Orders**
2. Open the order to refund
3. Click **More Actions > Refund**
4. Select full or partial refund
5. Click **Refund**

## Multi-Language

Fyatu checkout supports multiple languages:

1. Go to **Settings > Multilingual**
2. Add languages to your site
3. Fyatu checkout displays in visitor's language

Supported languages: English, French, Spanish, Portuguese

## Test Mode

Test your integration:

1. Go to Fyatu app settings
2. Enable **Test Mode**
3. Use test payment details
4. Orders marked as "Test" in dashboard
5. Disable test mode before going live

## Troubleshooting

### Payment option not appearing

1. Verify Fyatu is enabled in Accept Payments
2. Check that your site has a Premium plan
3. Ensure Fyatu app is properly connected

### Orders not syncing

1. Check Fyatu app connection status
2. Refresh the app authorization
3. Contact support if issue persists

### Checkout page issues

1. Clear browser cache
2. Try incognito/private browsing
3. Check for conflicting apps

## Wix Studio

For Wix Studio (formerly Editor X) sites:

1. Fyatu works the same way
2. Use responsive payment buttons
3. Velo code is fully supported

## Resources

* [Wix Developer Center](https://dev.wix.com/)
* [Wix Pay API](https://www.wix.com/velo/reference/wix-pay)
* [Fyatu API Reference](/v3/api-reference/introduction)
* [Wix App Market](https://www.wix.com/app-market) *(Coming soon)*