npm install @reevit/node
# or
yarn add @reevit/node
# or
pnpm add @reevit/node

import { Reevit } from '@reevit/node';

// Initialize the client
const reevit = new Reevit(
  'pfk_live_your_api_key.secret',  // Your API key
  'org_your_org_id'          // Your organization ID
);

// Create a payment
const payment = await reevit.payments.createIntent({
  amount: 5000,      // 50.00 GHS (amount in smallest currency unit)
  currency: 'GHS',
  method: 'mobile_money',
  country: 'GH',
  customer_id: 'cust_123',
  reference: 'ORD-12345'
});

console.log('Payment ID:', payment.id);
console.log('Status:', payment.status);

import { Reevit } from '@reevit/node';

const reevit = new Reevit(
  process.env.REEVIT_API_KEY!,
  process.env.REEVIT_ORG_ID!
);

const payment = await reevit.payments.createIntent({
  amount: 10000,           // 100.00 in smallest currency unit
  currency: 'GHS',         // Currency code (GHS, NGN, KES, USD)
  method: 'mobile_money',          // Payment method
  country: 'GH',           // ISO country code
  customer_id: 'cust_123', // Optional: Your customer reference
  reference: 'order_456',  // Optional: External reference
  metadata: {              // Optional: Custom metadata
    product: 'Premium Plan',
    order_id: 'order_456'
  }
});

const payment = await reevit.payments.get('pay_abc123');

console.log('Payment Details:', {
  id: payment.id,
  status: payment.status,
  amount: payment.amount,
  currency: payment.currency,
  fee: payment.fee_amount,
  provider: payment.provider,
});

// Basic listing (default: 50 payments)
const payments = await reevit.payments.list();

// With pagination
const page1 = await reevit.payments.list(10, 0);   // First 10
const page2 = await reevit.payments.list(10, 10);  // Next 10

// Full refund
const fullRefund = await reevit.payments.refund('pay_abc123');

// Partial refund
const partialRefund = await reevit.payments.refund(
  'pay_abc123',
  2500,                    // Refund 25.00
  'Customer requested'     // Reason (optional)
);

// Paystack Connection
const paystackConnection = await reevit.connections.create({
  provider: 'paystack',
  mode: 'live',
  credentials: {
    secret_key: 'sk_live_xxx'
  },
  labels: ['nigeria', 'primary'],
  routing_hints: {
    country_preference: ['NG'],
    method_bias: { card: 'high', bank_transfer: 'medium' },
    fallback_only: false
  }
});

const connections = await reevit.connections.list();

connections.forEach(conn => {
  console.log(`${conn.provider} (${conn.mode}): ${conn.status}`);
});

const isValid = await reevit.connections.test({
  provider: 'paystack',
  mode: 'live',
  credentials: {
    secret_key: 'sk_live_xxx'
  }
});

// Create subscription
const subscription = await reevit.subscriptions.create({
  customer_id: 'cust_123',
  plan_id: 'plan_premium',
  amount: 9900,           // 99.00 per month
  currency: 'GHS',
  method: 'mobile_money',
  interval: 'monthly',
  metadata: {
    plan_name: 'Premium',
  }
});

// List subscriptions
const subscriptions = await reevit.subscriptions.list();

// Get current policy
const policy = await reevit.fraud.get();

// Update policy
const updatedPolicy = await reevit.fraud.update({
  prefer: ['paystack', 'flutterwave'],
  max_amount: 500000,
  blocked_bins: ['123456'],
  velocity_max_per_minute: 10
});

import crypto from 'crypto';

app.post('/webhooks/reevit', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-reevit-signature'];
  const expected = 'sha256=' + crypto
    .createHmac('sha256', webhookSecret)
    .update(req.body)
    .digest('hex');

  if (!signature || signature.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
    return res.status(401).send('Invalid signature');
  }

  const event = JSON.parse(req.body.toString('utf8'));

  switch (event.type) {
    case 'payment.succeeded':
      // Handle success
      break;
    case 'payment.failed':
      // Handle failure
      break;
  }

  res.status(200).send('OK');
});

import { AxiosError } from 'axios';

try {
  const payment = await reevit.payments.createIntent({
    amount: 5000,
    currency: 'GHS',
    method: 'mobile_money',
    country: 'GH'
  });
} catch (error) {
  if (error instanceof AxiosError) {
    console.error('API Error:', {
      status: error.response?.status,
      message: error.response?.data?.message,
      code: error.response?.data?.code
    });
  }
}

import {
  Payment,
  PaymentSummary,
  PaymentIntentRequest,
  Connection,
  Subscription,
  FraudPolicy,
} from '@reevit/node';

function processPayment(payment: Payment): void {
  console.log(`Processing ${payment.id}`);
}