1
async function getBalanceForCurrency(token, orgId, merchantId, currencySymbol) {
2
  const balances = await getMerchantBalances(token, orgId, merchantId);
3
  return balances.find(b => b.currencySymbol === currencySymbol);
4
}
5
6
// Usage
7
const copBalance = await getBalanceForCurrency(token, orgId, merchantId, 'COP');
8
console.log('COP available:', copBalance.availableBalance);

1
async function safeCreatePayout(token, orgId, merchantId, payoutAmount, currency) {
2
  // 1. Get current balance
3
  const balance = await getBalanceForCurrency(token, orgId, merchantId, currency);
4
  
5
  // 2. Validate sufficient funds
6
  if (balance.availableBalance < payoutAmount) {
7
    throw new Error(
8
      `Insufficient balance: ${balance.availableBalance} ${currency} available, ` +
9
      `${payoutAmount} ${currency} required`
10
    );
11
  }
12
  
13
  // 3. Create payout order
14
  const order = await createPayoutOrder(token, orgId, merchantId, {
15
    amount: payoutAmount,
16
    currency: currency,
17
    // ... other fields
18
  });
19
  
20
  return order;
21
}
22
23
// Usage
24
try {
25
  const payout = await safeCreatePayout(token, orgId, merchantId, 100000, 'COP');
26
  console.log('Payout created:', payout.id);
27
} catch (error) {
28
  console.error('Error:', error.message);
29
}

1
async function convertUSDCToFiat(token, orgId, merchantId, usdcAmount, targetCurrency) {
2
  // 1. Get quote for OFFRAMP (crypto to fiat)
3
  const quote = await axios.post(
4
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
5
    {
6
      type: 'OFFRAMP',
7
      originCurrencySymbol: 'USDC',
8
      destinationCurrencySymbol: targetCurrency,
9
      amountIn: usdcAmount
10
    },
11
    { headers: { 'Authorization': `Bearer ${token}` } }
12
  );
13
  
14
  // 2. Create deal (must be paid completely)
15
  const deal = await axios.post(
16
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/deals`,
17
    {
18
      type: 'OFFRAMP',
19
      destinationAccountId: 'va_cop_12345',  // Target virtual account
20
      quoteId: quote.data.id
21
    },
22
    { headers: { 'Authorization': `Bearer ${token}` } }
23
  );
24
  
25
  return deal.data;
26
}
27
28
// Usage: Convert USDC back to COP
29
const copDeal = await convertUSDCToFiat(token, orgId, merchantId, 250, 'COP');
30
console.log('Deal created:', copDeal.id);
31
console.log('USDC will be converted to COP in virtual account');

1
async function transferBetweenCurrencies(token, orgId, merchantId) {
2
  // 1. Get quote
3
  const quote = await axios.post(
4
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
5
    {
6
      type: 'BALANCE_TRANSFER',
7
      originCurrencySymbol: 'COP',
8
      destinationCurrencySymbol: 'USD',
9
      amountIn: 1000000  // 1,000,000 COP
10
    },
11
    { headers: { 'Authorization': `Bearer ${token}` } }
12
  );
13
  
14
  console.log('Exchange rate:', quote.data.exchangeRate);
15
  console.log('Will receive:', quote.data.amountOut, 'USD');
16
  
17
  // 2. Create transfer order
18
  const order = await axios.post(
19
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
20
    {
21
      type: 'BALANCE_TRANSFER',
22
      originCurrencySymbol: 'COP',
23
      destinationCurrencySymbol: 'USD',
24
      amountIn: 1000000,
25
      quoteId: quote.data.id
26
    },
27
    { headers: { 'Authorization': `Bearer ${token}` } }
28
  );
29
  
30
  return order.data;
31
}

1
async function getBalanceHistory(token, orgId, merchantId, startDate, endDate) {
2
  const response = await axios.get(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
4
    {
5
      params: {
6
        startDate: startDate,
7
        endDate: endDate,
8
        limit: 100
9
      },
10
      headers: { 'Authorization': `Bearer ${token}` }
11
    }
12
  );
13
  
14
  // Filter orders that affect balance
15
  return response.data.filter(order => 
16
    ['PAYIN', 'PAYOUT', 'BALANCE_TRANSFER', 'ONRAMP', 'OFFRAMP'].includes(order.type) &&
17
    order.status === 'COMPLETED'
18
  );
19
}
20
21
// Usage
22
const history = await getBalanceHistory(
23
  token,
24
  orgId,
25
  merchantId,
26
  '2025-01-01',
27
  '2025-01-31'
28
);
29
30
let totalIn = 0;
31
let totalOut = 0;
32
33
history.forEach(order => {
34
  if (['PAYIN', 'OFFRAMP'].includes(order.type)) {
35
    totalIn += order.amountOut;
36
  } else if (['PAYOUT', 'BALANCE_TRANSFER', 'ONRAMP'].includes(order.type)) {
37
    totalOut += order.amountIn;
38
  }
39
});
40
41
console.log('Total IN:', totalIn);
42
console.log('Total OUT:', totalOut);
43
console.log('Net:', totalIn - totalOut);