1
async function createOrderWithQuote(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
10
    },
11
    { headers: { 'Authorization': `Bearer ${token}` } }
12
  );
13
  
14
  console.log('Rate locked at:', quote.data.exchangeRate);
15
  console.log('Valid for:', quote.data.validFor, 'seconds');
16
  
17
  // 2. Create order with quote (must be within validFor period)
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  // Lock the rate from quote
26
    },
27
    { headers: { 'Authorization': `Bearer ${token}` } }
28
  );
29
  
30
  console.log('Order created with locked rate');
31
  return order.data;
32
}

1
async function displayQuoteToUser(token, orgId, merchantId, amount) {
2
  const quote = await getQuote(token, orgId, merchantId, {
3
    type: 'BALANCE_TRANSFER',
4
    from: 'COP',
5
    to: 'USD',
6
    amount: amount
7
  });
8
  
9
  // Format for user display
10
  const display = {
11
    amountToSend: `${amount.toLocaleString()} COP`,
12
    willReceive: `${quote.amountOut.toFixed(2)} USD`,
13
    exchangeRate: `1 USD = ${quote.exchangeRate.toLocaleString()} COP`,
14
    totalFees: `${quote.koyweFee.toLocaleString()} COP`,
15
    expiresIn: `${Math.floor(quote.validFor / 60)} minutes`,
16
    effectiveRate: (amount / quote.amountOut).toFixed(2) + ' COP/USD'
17
  };
18
  
19
  console.log('You send:', display.amountToSend);
20
  console.log('They receive:', display.willReceive);
21
  console.log('Exchange rate:', display.exchangeRate);
22
  console.log('Total fees:', display.totalFees);
23
  console.log('Rate expires in:', display.expiresIn);
24
  console.log('Effective rate:', display.effectiveRate);
25
  
26
  return quote;
27
}
28
29
// Usage
30
await displayQuoteToUser(token, orgId, merchantId, 1000000);

1
async function getQuoteById(token, orgId, merchantId, quoteId) {
2
  const response = await axios.get(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes/${quoteId}`,
4
    {
5
      headers: { 'Authorization': `Bearer ${token}` }
6
    }
7
  );
8
  
9
  return response.data;
10
}
11
12
// Usage
13
const quote = await getQuoteById(token, orgId, merchantId, 'qte_abc123');
14
console.log('Quote status:', quote);

1
async function createOrderWithAutoRetry(token, orgId, merchantId, orderData) {
2
  let quote = await getQuote(token, orgId, merchantId, {
3
    type: orderData.type,
4
    from: orderData.from,
5
    to: orderData.to,
6
    amount: orderData.amount
7
  });
8
  
9
  try {
10
    // Try to create order with quote
11
    return await createOrderWithQuote(token, orgId, merchantId, quote.id);
12
  } catch (error) {
13
    if (error.message.includes('expired') || error.message.includes('invalid quote')) {
14
      // Quote expired, get new quote and retry
15
      console.log('Quote expired, getting new quote...');
16
      quote = await getQuote(token, orgId, merchantId, {
17
        type: orderData.type,
18
        from: orderData.from,
19
        to: orderData.to,
20
        amount: orderData.amount
21
      });
22
      
23
      return await createOrderWithQuote(token, orgId, merchantId, quote.id);
24
    }
25
    throw error;
26
  }
27
}