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,

  // Webhook configuration
  webhookUrl: 'https://api.myapp.com/webhooks/honeycoin',
  webhookSecret: process.env.HONEYCOIN_WEBHOOK_SECRET,

  // 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);
  }
}

const honeycoin = new HoneyCoin({
  apiKey: process.env.HONEYCOIN_API_KEY!,
  publicKey: process.env.HONEYCOIN_PUBLIC_KEY!,
  webhookUrl: 'https://api.myapp.com/webhooks/honeycoin',
  webhookSecret: process.env.HONEYCOIN_WEBHOOK_SECRET,
});

import crypto from 'crypto';
import express from 'express';

const app = express();
app.use(express.raw({ type: 'application/json' }));

app.post('/webhooks/honeycoin', (req, res) => {
  const signature = req.headers['x-honeycoin-signature'];
  const payload = req.body;

  // Verify webhook signature
  const expectedSignature = crypto
    .createHmac('sha256', process.env.HONEYCOIN_WEBHOOK_SECRET!)
    .update(payload)
    .digest('hex');

  if (signature !== `sha256=${expectedSignature}`) {
    return res.status(400).json({ error: 'Invalid signature' });
  }

  const event = JSON.parse(payload.toString());

  // Handle different event types
  switch (event.type) {
    case 'transaction.completed':
      handleTransactionCompleted(event.data);
      break;

    case 'transaction.failed':
      handleTransactionFailed(event.data);
      break;

    case 'transaction.pending':
      handleTransactionPending(event.data);
      break;

    case 'payout.completed':
      handlePayoutCompleted(event.data);
      break;

    default:
      console.log('Unknown event type:', event.type);
  }

  res.status(200).json({ received: true });
});

function handleTransactionCompleted(transaction) {
  console.log('Transaction completed:', transaction.externalId);

  // Update your database
  updateTransactionStatus(transaction.externalId, 'completed');

  // Send confirmation to customer
  sendConfirmationEmail(transaction.customerEmail, transaction);

  // Fulfill the order
  fulfillOrder(transaction.externalId);
}

// 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',
};