Tingg Provider

npm install @fundkit/tingg

import { Tingg } from '@fundkit/tingg';

const tingg = new Tingg({
  apiKey: process.env.TINGG_API_KEY!,
  publicKey: process.env.TINGG_PUBLIC_KEY!,
  serviceCode: process.env.TINGG_SERVICE_CODE!,
  paymentOptionCode: process.env.TINGG_PAYMENT_OPTION_CODE!,
});

const tingg = new Tingg({
  apiKey: process.env.TINGG_API_KEY!,
  publicKey: process.env.TINGG_PUBLIC_KEY!,
  serviceCode: process.env.TINGG_SERVICE_CODE!,
  paymentOptionCode: process.env.TINGG_PAYMENT_OPTION_CODE!,

  // 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 { Tingg } from '@fundkit/tingg';

const tingg = new Tingg({
  apiKey: process.env.TINGG_API_KEY!,
  publicKey: process.env.TINGG_PUBLIC_KEY!,
  serviceCode: process.env.TINGG_SERVICE_CODE!,
  paymentOptionCode: process.env.TINGG_PAYMENT_OPTION_CODE!,
});

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

// Process payment
const transaction = {
  amount: 10000, // 100.00 KES
  currency: 'KES',
  operator: 'safaricom',
  accountNumber: '254701234567',
  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',
};

// Uganda payment
const ugandaPayment = {
  amount: 20000, // 200.00 UGX
  currency: 'UGX',
  operator: 'mtn',
  accountNumber: '256779280949',
  externalId: 'uganda_order_456',
  reason: 'Product delivery',
};

// Tanzania payment
const tanzaniaPayment = {
  amount: 50000, // 500.00 TZS
  currency: 'TZS',
  operator: 'vodacom',
  accountNumber: '255754123456',
  externalId: 'tz_order_789',
  reason: 'Subscription payment',
};

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

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

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

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

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

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

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

    case 'TINGG_SERVICE_CODE_REQUIRED':
      showMessage('Service code is required. Please configure your Tingg service code.');
      break;

    case 'TINGG_PAYMENT_OPTION_REQUIRED':
      showMessage('Payment option code is required. Please specify the mobile money operator.');
      break;

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