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

# BigCommerce

> Fyatu payment integration for BigCommerce — accept payments from customers across Africa.

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

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

## Requirements

* BigCommerce Standard plan or higher
* HTTPS enabled on your store

## Installation

### From BigCommerce App Marketplace

1. Visit the [BigCommerce App Marketplace](https://www.bigcommerce.com/apps/)
2. Search for "Fyatu"
3. Click **Get This App**
4. Follow the installation prompts
5. Complete the setup wizard

## Configuration

### Step 1: Connect Your Fyatu Account

After installation:

1. You'll be redirected to connect your Fyatu account
2. Login to your [FYATU Dashboard](https://web.fyatu.com) if prompted
3. Select the Collection App to use
4. Authorize the connection

### Step 2: Configure Payment Settings

In the Fyatu app settings:

| Setting             | Description                 |
| ------------------- | --------------------------- |
| Display Name        | Name shown at checkout      |
| Payment Capture     | Automatic or manual         |
| Test Mode           | Enable sandbox testing      |
| Accepted Currencies | Select supported currencies |

### Step 3: Enable Payment Method

1. Go to **Store Setup > Payments**
2. Find Fyatu under "Online Payment Methods"
3. Toggle to enable

## Features

* **BigCommerce Checkout** - Native checkout integration
* **Automatic Order Updates** - Orders marked paid automatically
* **Multi-Currency** - Accept various currencies
* **Refunds** - Process refunds from order details
* **Storefront API** - Works with headless implementations
* **Channel Integration** - Support for multi-channel selling

## Checkout Flow

```
Customer adds items to cart
           ↓
Customer proceeds to checkout
           ↓
Customer selects "Fyatu" payment
           ↓
Customer clicks "Pay Now"
           ↓
Customer redirected to Fyatu checkout
           ↓
Customer completes payment
           ↓
Customer redirected to confirmation
           ↓
Order marked as "Awaiting Fulfillment"
```

## Checkout SDK Integration

For custom storefronts using BigCommerce Checkout SDK:

```javascript theme={null}
import { createCheckoutService } from '@bigcommerce/checkout-sdk';

const service = createCheckoutService();

// Initialize checkout
await service.loadCheckout();

// Select Fyatu payment method
await service.initializePayment({
    methodId: 'fyatu',
    fyatu: {
        onComplete: (result) => {
            if (result.status === 'success') {
                window.location.href = '/order-confirmation';
            }
        },
        onError: (error) => {
            console.error('Payment failed:', error);
        }
    }
});

// Submit payment
await service.submitOrder();
```

## Storefront API

For headless implementations:

### Create Payment Access Token

```bash theme={null}
POST /stores/{store_hash}/v3/payments/access_tokens
{
    "order": {
        "id": 12345
    }
}
```

### Process Payment

```bash theme={null}
POST https://payments.bigcommerce.com/stores/{store_hash}/payments
Authorization: PAT {access_token}
Content-Type: application/json

{
    "payment": {
        "instrument": {
            "type": "fyatu_redirect"
        },
        "payment_method_id": "fyatu.card"
    }
}
```

## Webhooks

The app automatically handles BigCommerce webhooks:

| Event                        | Description          |
| ---------------------------- | -------------------- |
| `store/order/created`        | New order placed     |
| `store/order/statusUpdated`  | Order status changed |
| `store/order/refund/created` | Refund processed     |

## Order Statuses

| Payment Event    | BigCommerce Status   |
| ---------------- | -------------------- |
| Payment pending  | Pending              |
| Payment received | Awaiting Fulfillment |
| Payment failed   | Cancelled            |
| Refund complete  | Refunded             |

## Refunds

To process a refund:

1. Go to **Orders > View**
2. Open the order to refund
3. Click **Refund**
4. Select items or enter custom amount
5. Choose "Refund to Fyatu"
6. Click **Submit Refund**

## Multi-Currency

Fyatu supports BigCommerce multi-currency:

1. Go to **Store Setup > Currencies**
2. Add supported currencies
3. Fyatu automatically accepts enabled currencies

Supported currencies:

* USD, EUR, GBP
* CDF, KES, NGN, UGX, TZS, RWF

## Channel Integration

For multi-storefront setups:

1. Each channel can have separate Fyatu configuration
2. Go to **Channel Manager**
3. Select the channel
4. Configure Fyatu under Payments

## Troubleshooting

### Payment method not showing

1. Verify Fyatu is enabled in **Store Setup > Payments**
2. Check that cart currency is supported
3. Ensure app connection is active

### Orders not updating

1. Check webhook status in the Fyatu app
2. Verify your store isn't in maintenance mode
3. Review BigCommerce webhook logs

### Test mode transactions appearing

1. Ensure test mode is disabled in app settings
2. Verify you're using live credentials

## API Rate Limits

BigCommerce API limits apply:

* 150 requests per 30 seconds
* The app handles rate limiting automatically

## Resources

* [BigCommerce Dev Center](https://developer.bigcommerce.com/)
* [Checkout SDK Documentation](https://developer.bigcommerce.com/docs/storefront/checkout)
* [Fyatu API Reference](/v3/api-reference/introduction)
* [BigCommerce App Marketplace](https://www.bigcommerce.com/apps/) *(Coming soon)*