1
// Convertir 1,000,000 COP a USD
2
3
// 1. Obtener cotización
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('Tasa de cambio:', quote.data.exchangeRate); // ej., 4000 COP por USD
16
console.log('Recibirás:', quote.data.amountOut, 'USD'); // ej., 248.75 USD
17
console.log('Comisión:', quote.data.koyweFee, 'COP'); // ej., 5000 COP
18
19
// 2. Crear orden de transferencia
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  // Bloquear la tasa
28
  },
29
  { headers: { 'Authorization': `Bearer ${token}` } }
30
);
31
32
console.log('Transferencia completada:', 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('Saldo COP insuficiente');
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
// Mostrar tasa al usuario
13
console.log(`Tasa: 1 USD = ${quote.data.exchangeRate} COP`);
14
console.log(`Recibirás: ${quote.data.amountOut} USD`);
15
console.log(`Comisión: ${quote.data.koyweFee} COP`);
16
console.log(`Cotización expira en: ${quote.data.validFor} segundos`);

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,  // Usar cotización para bloquear tasa
9
    externalId: `transfer-${Date.now()}`,
10
    description: 'Conversión COP a USD'
11
  },
12
  { headers: { 'Authorization': `Bearer ${token}` } }
13
);
14
15
console.log('Estado:', order.data.status); // "COMPLETED" (instantáneo)

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('Saldo COP:', copBalance.availableBalance); // Disminuyó
10
console.log('Saldo USD:', usdBalance.availableBalance); // Aumentó

1
async function transferCurrency(fromCurrency, toCurrency, amount) {
2
  try {
3
    // 1. Autenticar
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. Verificar saldo origen
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(`Saldo ${fromCurrency} insuficiente`);
20
    }
21
    
22
    console.log(`✓ Saldo suficiente: ${sourceBalance.availableBalance} ${fromCurrency}`);
23
    
24
    // 3. Obtener cotización
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(`✓ Cotización recibida`);
38
    console.log(`  Tasa: 1 ${toCurrency} = ${quote.exchangeRate} ${fromCurrency}`);
39
    console.log(`  Monto salida: ${quote.amountOut} ${toCurrency}`);
40
    console.log(`  Comisión: ${quote.koyweFee} ${fromCurrency}`);
41
    
42
    // 4. Crear transferencia
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(`✓ Transferencia completada instantáneamente`);
57
    console.log(`  ID de Orden: ${order.id}`);
58
    console.log(`  Estado: ${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('Transferencia fallida:', error.response?.data || error.message);
69
    throw error;
70
  }
71
}
72
73
// Uso
74
await transferCurrency('COP', 'USD', 1000000);