Skip to main content

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.

This app is coming soon. Join our waitlist to be notified when it’s released.
Accept payments from customers across Africa on your Shopify store with the official Fyatu payment app.

​
Requirements

  • Shopify Basic plan or higher
  • Shopify Payments or third-party payment provider enabled

​
Installation

​
From Shopify App Store

  1. Visit the Fyatu app on the Shopify App Store
  2. Click Add app
  3. Review permissions and click Install app
  4. Follow the setup wizard

​
Manual Installation (Development)

For partners and developers testing the app: 
https://yourstore.myshopify.com/admin/oauth/authorize?client_id=YOUR_CLIENT_ID&scope=write_payment_gateways,read_orders&redirect_uri=YOUR_REDIRECT_URI

​
Configuration

​
Step 1: Connect Your Fyatu Account

  1. After installation, you’ll be prompted to connect your Fyatu account
  2. Login to your FYATU Dashboard if needed
  3. Select the Collection App you want to use
  4. Authorize the connection

​
Step 2: Configure Payment Settings

SettingDescription
Display NameName shown at checkout (default: “Fyatu”)
Payment CaptureAutomatic or manual capture
Test ModeEnable for testing without real payments
Supported CurrenciesSelect currencies to accept

​
Step 3: Activate the Payment Method

  1. Go to Settings > Payments in your Shopify admin
  2. Find Fyatu under “Additional payment methods”
  3. Click Activate to enable

​
Features

  • Native Checkout - Fyatu appears as a payment option in Shopify Checkout
  • Automatic Order Updates - Orders marked as paid automatically
  • Refund Support - Process refunds from Shopify order page
  • Multi-Currency - Accept payments in multiple currencies
  • Shopify Flow - Trigger workflows on payment events
  • Analytics - View payment analytics in Fyatu Dashboard

​
Checkout Experience

Customers see Fyatu as a payment option during checkout: 
┌─────────────────────────────────────┐
│ Payment                             │
├─────────────────────────────────────┤
│ ○ Credit card                       │
│ ○ PayPal                            │
│ ● Fyatu                             │
│   Pay with your Fyatu wallet        │
│                                     │
│ [Complete order]                    │
└─────────────────────────────────────┘
After selecting Fyatu and completing the order, customers are redirected to the Fyatu checkout page to complete payment.

​
Checkout Flow

Customer adds items to cart
           ↓
Customer proceeds to checkout
           ↓
Customer selects "Fyatu" payment
           ↓
Customer clicks "Complete order"
           ↓
Customer redirected to Fyatu checkout
           ↓
Customer completes payment
           ↓
Customer redirected to order confirmation
           ↓
Order marked as "Paid"

​
Shopify Flow Integration

Automate your workflow with Shopify Flow triggers:
TriggerDescription
Fyatu payment receivedWhen a customer completes payment
Fyatu payment failedWhen a payment attempt fails
Fyatu refund processedWhen a refund is completed
Example Flow: Send a custom email when a Fyatu payment is received.

​
Refunds

To process a refund:
  1. Go to Orders in your Shopify admin
  2. Open the order you want to refund
  3. Click Refund
  4. Enter the refund amount
  5. Select “Refund through Fyatu”
  6. Click Refund
Partial refunds are supported. Refunds are processed back to the customer’s Fyatu wallet.

​
Test Mode

Test your integration without processing real payments:
  1. Go to Apps > Fyatu in your Shopify admin
  2. Enable Test Mode
  3. Use test cards and accounts to simulate payments
  4. Disable test mode before going live

​
Test Credentials

Use test mode in the Fyatu Dashboard to simulate payments. When testing, customers will be redirected to a test checkout where they can simulate payment from a Fyatu wallet.

​
Webhooks

The app automatically configures webhooks. Events supported:
EventDescription
orders/paidOrder payment confirmed
orders/cancelledOrder cancelled
refunds/createRefund initiated

​
Multi-Currency

Accept payments in:
  • USD (US Dollar)
  • EUR (Euro)
  • CDF (Congolese Franc)
  • KES (Kenyan Shilling)
  • NGN (Nigerian Naira)
  • And more…
Currency conversion is handled automatically based on your Shopify store settings.

​
Troubleshooting

​
Payment method not appearing

  1. Ensure the app is installed and activated
  2. Check that your store’s currency is supported
  3. Verify Fyatu is enabled in Settings > Payments

​
Orders not updating

  1. Check your Fyatu Dashboard for webhook delivery status
  2. Ensure your store is not in password-protected mode
  3. Contact support if issues persist

​
Test mode transactions appearing in live

  1. Double-check that Test Mode is disabled in app settings
  2. Ensure you’re using your live App credentials

​
Resources