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

# Configuration

> Configure the Bridge Payment Gateway settings for WooCommerce

# Configuration Guide

## Basic Settings

### Required Settings

1. **Enable/Disable**
   * Enable or disable the payment gateway
   * Default: Disabled

2. **Service ID**
   * Your unique Bridge Service ID
   * Found in your Bridge merchant dashboard
   * Format: `bridge_xxxxxxxxxxxxx`

3. **Client Key**
   * Your Bridge Client Key for API authentication
   * Keep this secure
   * Format: `client_xxxxxxxxxxxxx`

4. **Secret Key**
   * Your Bridge Secret Key for API authentication
   * Keep this secure and never share
   * Format: `secret_xxxxxxxxxxxxx`

5. **Business Name**
   * Your business name as shown on payment screen
   * Maximum 50 characters

6. **Title**
   * Payment method title shown at checkout
   * Default: "Pay with Bridge"

7. **Payment Mode**
   * Choose available payment methods
   * Options: All, Card Only, Mobile Money Only

8. **Currency**
   * Select display currency
   * Options: GHS, USD, EUR, GBP

9. **Conversion Rate**
   * Set currency conversion rate
   * Required if using multiple currencies

10. **Transaction Reference**
    * Customize transaction reference prefix
    * Format: `[prefix]-[orderID]`

### Optional Settings

1. **Description**
   * Payment method description at checkout
   * Supports HTML
   * Default: "Secure payment via Bridge"

2. **Debug Log**
   * Enable/disable transaction logging
   * Logs stored in WooCommerce > Status > Logs
   * Recommended for troubleshooting

## Advanced Configuration

### Test Mode

During development or testing:

1. Enable Test Mode in settings
2. Use test API credentials
3. Test transactions won't be charged

### Webhook Setup

The plugin automatically configures webhooks:

```
https://your-domain.com/wc-api/bridge-payment-gateway/
```

Add this URL to your Bridge merchant dashboard under Webhooks.

### Currency Settings

For multi-currency support:

1. Enable multiple currencies
2. Set conversion rates
3. Configure display options
4. Test transactions in different currencies

### Security Recommendations

* Keep API credentials secure
* Regular update plugin
* Monitor transaction logs
* Use HTTPS
* Set strong admin passwords

## Saving Changes

Remember to click **Save Changes** after modifying any settings.

For technical support, contact [support@thebridgesolutions.com](mailto:support@thebridgesolutions.com)