Integration Guides

This section provides detailed guides on integrating BreezePay into your systems. Follow these step-by-step instructions to ensure a smooth and successful integration.

---

VirtualPay API Integration

Step 1: API Key Configuration

Obtain your API key from the VirtualPay Corporate dashboard.

Configure your API client with the following details:

• API Base URL: https://developer-sandbox.accessbankplc.com/
• API Key: Your unique API key.
• Client Application Code: Unique code assigned to your application.

Step 2: Making API Requests

Use the API key to authenticate your requests.

Include the required headers and parameters as specified in the API documentation.

Step 3: Handling Responses

Parse the JSON responses returned by the API.

Implement error handling for various response codes.

Example: Generate Virtual Account

const axios = require('axios');

const config = {
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
};

const data = {
  customer_name: 'John Doe',
  customer_email: 'john.doe@example.com',
  channel_code: 'YOUR_CHANNEL_CODE',
  merchant_id: 'YOUR_MERCHANT_ID',
  customer_id: 'CUSTOMER_UNIQUE_ID',
  customer_phone: '1234567890',
  request_authorizer: 'System'
};

axios.post('https://developer-sandbox.accessbankplc.com/', data, config)
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });