1
// Sell 10 USDC for COP
2
3
// 1. Get quote (network required!)
4
const quote = await axios.post(
5
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
6
  {
7
    type: 'OFFRAMP',
8
    originCurrencySymbol: 'USDC',
9
    destinationCurrencySymbol: 'COP',
10
    amountIn: 10,  // 10 USDC
11
    network: 'ETHEREUM'  // Required for crypto quotes
12
  },
13
  { headers: { 'Authorization': `Bearer ${token}` } }
14
);
15
16
console.log('Will receive:', quote.data.amountOut, 'COP'); // e.g., 39,500 COP
17
console.log('Quote valid for:', quote.data.validFor || '10-15', 'seconds');
18
19
// 2. Create deal (not order!)
20
const deal = await axios.post(
21
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/deals`,
22
  {
23
    destinationAccountId: 'va_cop_12345',  // Your COP virtual account
24
    quoteId: quote.data.id
25
  },
26
  { headers: { 'Authorization': `Bearer ${token}` } }
27
);
28
29
console.log('Deal created:', deal.data.id);
30
console.log('Deal must be paid completely');
31
// Funds will be credited to COP virtual account after confirmation

1
const quote = await axios.post(
2
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
3
  {
4
    type: 'OFFRAMP',
5
    originCurrencySymbol: 'USDC',
6
    destinationCurrencySymbol: 'COP',
7
    amountIn: 10,
8
    network: 'ETHEREUM'  // Required for crypto quotes
9
  },
10
  { headers: { 'Authorization': `Bearer ${token}` } }
11
);
12
13
// Display to user
14
console.log('Selling:', quote.data.amountIn, 'USDC');
15
console.log('Will receive:', quote.data.amountOut, 'COP');
16
console.log('Exchange rate:', quote.data.exchangeRate);
17
console.log('Fee:', quote.data.koyweFee, 'COP');
18
console.log('Quote expires in:', quote.data.validFor || '10-15', 'seconds');

1
const deal = await axios.post(
2
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/deals`,
3
  {
4
    type: 'OFFRAMP',
5
    destinationAccountId: 'va_cop_12345',  // Only need destination virtual account
6
    quoteId: quote.data.id,
7
    externalId: `offramp-${Date.now()}`
8
  },
9
  { headers: { 'Authorization': `Bearer ${token}` } }
10
);
11
12
console.log('Deal created:', deal.data.id);
13
console.log('Status:', deal.data.status); // "PENDING"
14
console.log('Deposit address:', deal.data.depositAddress); // Where to send crypto

1
const dealDetails = await axios.get(
2
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/deals/${deal.data.id}`,
3
  { headers: { 'Authorization': `Bearer ${token}` } }
4
);
5
6
console.log('Send crypto to:', dealDetails.data.depositAddress);
7
console.log('Amount to send:', dealDetails.data.amountIn, dealDetails.data.originCurrencySymbol);
8
console.log('Network:', dealDetails.data.network);
9
console.log('Must send complete amount - partial payments not allowed');

1
app.post('/webhooks/koywe', (req, res) => {
2
  const event = JSON.parse(req.body);
3
  
4
  if (event.type === 'order.paid' && event.data.type === 'OFFRAMP') {
5
    console.log('Crypto received and confirmed!');
6
  }
7
  
8
  if (event.type === 'order.completed' && event.data.type === 'OFFRAMP') {
9
    console.log('Fiat credited to virtual account!');
10
    console.log('Amount:', event.data.amountOut, event.data.destinationCurrencySymbol);
11
  }
12
  
13
  res.status(200).send('OK');
14
});

1
async function sellUSDC(amount) {
2
  try {
3
    const token = await authenticate();
4
    
5
    // 1. Get quote
6
    const quote = await axios.post(
7
      `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
8
      {
9
        type: 'OFFRAMP',
10
        originCurrencySymbol: 'USDC',
11
        destinationCurrencySymbol: 'COP',
12
        amountIn: amount
13
      },
14
      { headers: { 'Authorization': `Bearer ${token}` } }
15
    );
16
    
17
    console.log(`Selling ${amount} USDC for ${quote.data.amountOut} COP`);
18
    console.log(`Rate: 1 USDC = ${quote.data.exchangeRate} COP`);
19
    
20
    // 2. Create offramp order
21
    const order = await axios.post(
22
      `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
23
      {
24
        type: 'OFFRAMP',
25
        originCurrencySymbol: 'USDC',
26
        destinationCurrencySymbol: 'COP',
27
        amountIn: amount,
28
        quoteId: quote.data.id
29
      },
30
      { headers: { 'Authorization': `Bearer ${token}` } }
31
    );
32
    
33
    console.log('✓ Offramp order created:', order.data.id);
34
    console.log('📍 Send USDC to:', order.data.depositAddress);
35
    console.log('💰 Amount:', order.data.amountIn, 'USDC');
36
    console.log('🌐 Network:', order.data.network || 'Ethereum');
37
    
38
    return {
39
      orderId: order.data.id,
40
      depositAddress: order.data.depositAddress,
41
      amount: order.data.amountIn,
42
      currency: order.data.originCurrencySymbol
43
    };
44
    
45
  } catch (error) {
46
    console.error('Error:', error.response?.data || error.message);
47
    throw error;
48
  }
49
}
50
51
// Usage
52
const offramp = await sellUSDC(10);
53
console.log('Send your USDC to the deposit address above');