HoneyCoin Provider

npm install @fundkit/honeycoin

import { HoneyCoin } from '@fundkit/honeycoin';

const honeycoin = new HoneyCoin({
  apiKey: process.env.HONEYCOIN_API_KEY!,
  publicKey: process.env.HONEYCOIN_PUBLIC_KEY!,
  environment: 'sandbox', // or 'production'
});

const honeycoin = new HoneyCoin({
  apiKey: process.env.HONEYCOIN_API_KEY!,
  publicKey: process.env.HONEYCOIN_PUBLIC_KEY!,
  environment: 'production',

  // Advanced options
  timeout: 45000,
  retries: 5,
  retryDelay: 2000,

  // Rate limiting
  rateLimit: {
    requests: 100,
    window: 60000, // Per minute
  },

  // Custom headers
  headers: {
    'User-Agent': 'MyApp/1.0',
    'X-Source': 'mobile-app',
  },

  // Logging
  logger: customLogger,
  logLevel: 'info', // 'debug', 'info', 'warn', 'error'
});

import { PaymentClient } from '@fundkit/core';
import { HoneyCoin } from '@fundkit/honeycoin';

const honeycoin = new HoneyCoin({
  apiKey: process.env.HONEYCOIN_API_KEY!,
  publicKey: process.env.HONEYCOIN_PUBLIC_KEY!,
  environment: 'sandbox',
});

const client = new PaymentClient({
  apiKey: process.env.FUNDKIT_API_KEY!,
  providers: [honeycoin],
  environment: 'sandbox',
});

// Process payment
const transaction = {
  amount: 10000, // 100.00 UGX
  currency: 'UGX',
  operator: 'mtn',
  accountNumber: '256779280949',
  externalId: 'order_12345',
  reason: 'Product purchase',
};

try {
  const result = await client.collection(transaction);
  console.log('Payment initiated:', result);
} catch (error) {
  console.error('Payment failed:', error.message);
}

// Kenya payment
const kenyaPayment = {
  amount: 5000, // 50.00 KES
  currency: 'KES',
  operator: 'safaricom',
  accountNumber: '254701234567',
  externalId: 'kenya_order_123',
  reason: 'Service payment',
};

// Tanzania payment
const tanzaniaPayment = {
  amount: 20000, // 200.00 TZS
  currency: 'TZS',
  operator: 'vodacom',
  accountNumber: '255754123456',
  externalId: 'tz_order_456',
  reason: 'Product delivery',
};

// Process payments
const [kenyaResult, tanzaniaResult] = await Promise.allSettled([
  client.collection(kenyaPayment),
  client.collection(tanzaniaPayment),
]);

// Send money to a recipient
const payout = {
  amount: 25000, // 250.00 UGX
  currency: 'UGX',
  operator: 'airtel',
  accountNumber: '256701234567',
  externalId: 'payout_789',
  reason: 'Commission payment',

  // Additional payout fields
  recipientName: 'John Doe',
  reference: 'COMM_2024_001',
};

try {
  const result = await honeycoin.payout(payout);
  console.log('Payout sent:', result);
} catch (error) {
  console.error('Payout failed:', error.message);
}

try {
  const result = await client.collection(transaction);
} catch (error) {
  switch (error.code) {
    case 'HC_INSUFFICIENT_FUNDS':
      showMessage('Customer has insufficient balance');
      break;

    case 'HC_INVALID_PHONE':
      showMessage('Invalid phone number format');
      break;

    case 'HC_NETWORK_UNAVAILABLE':
      showMessage('Mobile network is currently unavailable');
      break;

    case 'HC_CUSTOMER_CANCELLED':
      showMessage('Customer cancelled the payment');
      break;

    case 'HC_DUPLICATE_TRANSACTION':
      showMessage('Duplicate transaction detected');
      break;

    case 'HC_ACCOUNT_BLOCKED':
      showMessage('Customer account is temporarily blocked');
      break;

    default:
      showMessage('Payment failed. Please try again.');
      logError(error);
  }
}

// Test numbers for different outcomes
const testNumbers = {
  // Uganda
  success: '256779000001', // Always succeeds
  insufficientFunds: '256779000002', // Always fails with insufficient funds
  timeout: '256779000003', // Always times out
  cancelled: '256779000004', // Customer cancels

  // Kenya
  successKenya: '254701000001', // Always succeeds
  failKenya: '254701000002', // Always fails

  // Tanzania
  successTanzania: '255754000001', // Always succeeds
  failTanzania: '255754000002', // Always fails
};

// Test transaction
const testTransaction = {
  amount: 5000,
  currency: 'UGX',
  operator: 'mtn',
  accountNumber: testNumbers.success,
  externalId: 'test_' + Date.now(),
  reason: 'Test payment',
};