BigCommerce

​

Requirements

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

​

Installation

​

From BigCommerce App Marketplace

1. Visit the BigCommerce App Marketplace
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

1. You’ll be redirected to connect your Fyatu account
2. Login to your FYATU Dashboard if prompted
3. Select the Collection App to use
4. Authorize the connection

​

Step 2: Configure Payment Settings

​

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

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

​

Create Payment Access Token

POST /stores/{store_hash}/v3/payments/access_tokens
{
    "order": {
        "id": 12345
    }
}

​

Process Payment

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

​

Order Statuses

​

Refunds

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

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

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

​

Channel Integration

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

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

​

Resources

• BigCommerce Dev Center
• Checkout SDK Documentation
• Fyatu API Reference
• BigCommerce App Marketplace (Coming soon)