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

1
const balances = await axios.get(
2
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/bank-accounts/balances`,
3
  { headers: { 'Authorization': `Bearer ${token}` } }
4
);
5
6
const copBalance = balances.data.find(b => b.currencySymbol === 'COP');
7
8
if (copBalance.availableBalance < 1000000) {
9
  throw new Error('Insufficient COP balance');
10
}

1
const quote = await axios.post(
2
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
3
  {
4
    type: 'BALANCE_TRANSFER',
5
    originCurrencySymbol: 'COP',
6
    destinationCurrencySymbol: 'USD',
7
    amountIn: 1000000
8
  },
9
  { headers: { 'Authorization': `Bearer ${token}` } }
10
);
11
12
// Show rate to user
13
console.log(`Rate: 1 USD = ${quote.data.exchangeRate} COP`);
14
console.log(`You'll receive: ${quote.data.amountOut} USD`);
15
console.log(`Fee: ${quote.data.koyweFee} COP`);
16
console.log(`Quote expires in: ${quote.data.validFor} seconds`);

1
const order = await axios.post(
2
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
3
  {
4
    type: 'BALANCE_TRANSFER',
5
    originCurrencySymbol: 'COP',
6
    destinationCurrencySymbol: 'USD',
7
    amountIn: 1000000,
8
    quoteId: quote.data.id,  // Use quote to lock rate
9
    externalId: `transfer-${Date.now()}`,
10
    description: 'COP to USD conversion'
11
  },
12
  { headers: { 'Authorization': `Bearer ${token}` } }
13
);
14
15
console.log('Status:', order.data.status); // "COMPLETED" (instant)

1
const newBalances = await axios.get(
2
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/bank-accounts/balances`,
3
  { headers: { 'Authorization': `Bearer ${token}` } }
4
);
5
6
const copBalance = newBalances.data.find(b => b.currencySymbol === 'COP');
7
const usdBalance = newBalances.data.find(b => b.currencySymbol === 'USD');
8
9
console.log('COP balance:', copBalance.availableBalance); // Decreased
10
console.log('USD balance:', usdBalance.availableBalance); // Increased

1
async function transferCurrency(fromCurrency, toCurrency, amount) {
2
  try {
3
    // 1. Authenticate
4
    const authResponse = await axios.post(
5
      'https://api-sandbox.koywe.com/api/v1/auth/sign-in',
6
      { apiKey: process.env.KOYWE_API_KEY, secret: process.env.KOYWE_SECRET }
7
    );
8
    const token = authResponse.data.token;
9
    
10
    // 2. Check source balance
11
    const balances = await axios.get(
12
      `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/bank-accounts/balances`,
13
      { headers: { 'Authorization': `Bearer ${token}` } }
14
    );
15
    
16
    const sourceBalance = balances.data.find(b => b.currencySymbol === fromCurrency);
17
    
18
    if (!sourceBalance || sourceBalance.availableBalance < amount) {
19
      throw new Error(`Insufficient ${fromCurrency} balance`);
20
    }
21
    
22
    console.log(`✓ Sufficient balance: ${sourceBalance.availableBalance} ${fromCurrency}`);
23
    
24
    // 3. Get quote
25
    const quoteResponse = await axios.post(
26
      `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
27
      {
28
        type: 'BALANCE_TRANSFER',
29
        originCurrencySymbol: fromCurrency,
30
        destinationCurrencySymbol: toCurrency,
31
        amountIn: amount
32
      },
33
      { headers: { 'Authorization': `Bearer ${token}` } }
34
    );
35
    
36
    const quote = quoteResponse.data;
37
    console.log(`✓ Quote received`);
38
    console.log(`  Rate: 1 ${toCurrency} = ${quote.exchangeRate} ${fromCurrency}`);
39
    console.log(`  Amount out: ${quote.amountOut} ${toCurrency}`);
40
    console.log(`  Fee: ${quote.koyweFee} ${fromCurrency}`);
41
    
42
    // 4. Create transfer
43
    const orderResponse = await axios.post(
44
      `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
45
      {
46
        type: 'BALANCE_TRANSFER',
47
        originCurrencySymbol: fromCurrency,
48
        destinationCurrencySymbol: toCurrency,
49
        amountIn: amount,
50
        quoteId: quote.id
51
      },
52
      { headers: { 'Authorization': `Bearer ${token}` } }
53
    );
54
    
55
    const order = orderResponse.data;
56
    console.log(`✓ Transfer completed instantly`);
57
    console.log(`  Order ID: ${order.id}`);
58
    console.log(`  Status: ${order.status}`);
59
    
60
    return {
61
      success: true,
62
      orderId: order.id,
63
      amountOut: quote.amountOut,
64
      currency: toCurrency
65
    };
66
    
67
  } catch (error) {
68
    console.error('Transfer failed:', error.response?.data || error.message);
69
    throw error;
70
  }
71
}
72
73
// Usage
74
await transferCurrency('COP', 'USD', 1000000);