Fintech Startups

// Accept deposits from Fyatu users into their wallet on your platform
const deposit = await fyatu.collections.create({
  amount: 100.00,
  currency: 'USD',
  reference: `DEP-${walletId}-${Date.now()}`,
  description: 'Wallet top-up',
  customer: {
    email: user.email,
    externalId: user.id
  },
  metadata: {
    walletId: walletId,
    type: 'deposit'
  }
});

// Customer withdraws to their Fyatu wallet
const withdrawal = await fyatu.payouts.create({
  amount: 50.00,
  currency: 'USD',
  reference: `WD-${walletId}-${Date.now()}`,
  recipient: {
    accountId: user.fyatuClientId  // User's Fyatu account ID
  }
});

// Issue virtual card for online spending
const card = await fyatu.cards.create({
  cardholderId: user.cardholderId,
  currency: 'USD',
  type: 'virtual'
});

// Disburse approved loan to borrower's Fyatu wallet
async function disburseLoan(loan) {
  const payout = await fyatu.payouts.create({
    amount: loan.principalAmount,
    currency: 'USD',
    reference: `LOAN-${loan.id}`,
    description: `Loan disbursement - ${loan.id}`,
    recipient: {
      accountId: loan.borrower.fyatuClientId  // Borrower's Fyatu account ID
    },
    metadata: {
      loanId: loan.id,
      borrowerId: loan.borrowerId,
      type: 'disbursement'
    }
  });

  loan.status = 'disbursed';
  loan.disbursedAt = new Date();
  loan.payoutId = payout.id;
  await loan.save();
}

// Collect loan repayment
async function createRepaymentRequest(loan, amount) {
  const collection = await fyatu.collections.create({
    amount: amount,
    currency: 'USD',
    reference: `REPAY-${loan.id}-${Date.now()}`,
    description: `Loan repayment - ${loan.id}`,
    customer: {
      email: loan.borrower.email,
      phone: loan.borrower.phone
    },
    metadata: {
      loanId: loan.id,
      repaymentType: 'scheduled'
    }
  });

  return collection.checkoutUrl;
}

// Investment deposit
const investment = await fyatu.collections.create({
  amount: 500.00,
  currency: 'USD',
  reference: `INV-${portfolioId}-${Date.now()}`,
  description: 'Investment contribution',
  customer: { email: user.email },
  metadata: {
    portfolioId: portfolioId,
    investmentType: 'recurring'
  }
});

// Investment withdrawal/redemption
const redemption = await fyatu.payouts.create({
  amount: withdrawAmount,
  currency: 'USD',
  reference: `REDEEM-${portfolioId}-${Date.now()}`,
  description: 'Investment redemption',
  recipient: { accountId: user.fyatuAccountId },
  metadata: {
    portfolioId: portfolioId,
    units: unitsRedeemed
  }
});

// Create employee cardholder
const cardholder = await fyatu.cardholders.create({
  firstName: employee.firstName,
  lastName: employee.lastName,
  email: employee.email,
  phone: employee.phone,
  externalId: employee.id
});

// Issue expense card with limits
const card = await fyatu.cards.create({
  cardholderId: cardholder.id,
  currency: 'USD',
  type: 'virtual',
  spendingLimit: {
    amount: 1000,
    interval: 'monthly'
  },
  metadata: {
    employeeId: employee.id,
    department: employee.department,
    costCenter: employee.costCenter
  }
});

// Fund the card
await fyatu.cards.fund(card.id, {
  amount: 500,
  reference: `FUND-${employee.id}-${Date.now()}`
});

app.post('/webhooks/fyatu', (req, res) => {
  const event = req.body;

  switch (event.type) {
    case 'card.transaction.authorized':
      // Transaction approved, update user balance display
      notifyUser(event.data.cardholderId, {
        type: 'transaction',
        amount: event.data.amount,
        merchant: event.data.merchantName
      });
      break;

    case 'card.transaction.declined':
      // Transaction declined
      notifyUser(event.data.cardholderId, {
        type: 'declined',
        reason: event.data.declineReason
      });
      break;

    case 'card.transaction.settled':
      // Final settlement, update records
      recordTransaction(event.data);
      break;
  }

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

// Verify before payout
const verification = await fyatu.accounts.verify(recipientClientId);

if (verification.exists) {
  console.log(`Account found: ${verification.name}`);

  // Show user for confirmation
  const confirmed = await confirmWithUser({
    name: verification.name,
    accountId: recipientClientId
  });

  if (confirmed) {
    await fyatu.payouts.create({
      amount: 100,
      recipient: { accountId: recipientClientId }
    });
  }
} else {
  throw new Error('Recipient account not found');
}

// Submit KYC documents for card issuance
await fyatu.cardholders.submitKyc(cardholderId, {
  documentType: 'passport',
  documentNumber: 'AB1234567',
  documentFrontUrl: 'https://storage.example.com/passport-front.jpg',
  documentBackUrl: 'https://storage.example.com/passport-back.jpg',
  selfieUrl: 'https://storage.example.com/selfie.jpg'
});

// Listen for KYC result
// Webhook: cardholder.kyc.approved or cardholder.kyc.rejected

// Pre-payout velocity check
async function canProcessPayout(userId, amount) {
  const last24h = await getPayoutsLast24Hours(userId);
  const dailyLimit = await getUserDailyLimit(userId);

  if (last24h.total + amount > dailyLimit) {
    return { allowed: false, reason: 'daily_limit_exceeded' };
  }

  return { allowed: true };
}