1
async function createPayinOrder(token, orgId, merchantId) {
2
  const response = await axios.post(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
4
    {
5
      type: 'PAYIN',
6
      originCurrencySymbol: 'COP',
7
      destinationCurrencySymbol: 'COP',
8
      amountIn: 50000,
9
      description: 'Payment for Order #12345',
10
      externalId: `order-${Date.now()}`,
11
      paymentMethods: [
12
        {
13
          method: 'PSE',
14
          extra: 'BANCOLOMBIA'
15
        }
16
      ],
17
      successUrl: 'https://yoursite.com/success',
18
      failedUrl: 'https://yoursite.com/failed'
19
    },
20
    {
21
      headers: { 
22
        'Authorization': `Bearer ${token}`,
23
        'Content-Type': 'application/json'
24
      }
25
    }
26
  );
27
  
28
  return response.data;
29
}
30
31
const order = await createPayinOrder(token, orgId, merchantId);
32
console.log('Payment URL:', order.paymentUrl);
33
// Redirect customer to order.paymentUrl

1
async function createPayoutOrder(token, orgId, merchantId, contactId, bankAccountId) {
2
  // 1. Check balance first
3
  const balances = await getMerchantBalances(token, orgId, merchantId);
4
  const copBalance = balances.find(b => b.currencySymbol === 'COP');
5
  
6
  if (copBalance.availableBalance < 100000) {
7
    throw new Error('Insufficient balance');
8
  }
9
  
10
  // 2. Create payout order
11
  const response = await axios.post(
12
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
13
    {
14
      type: 'PAYOUT',
15
      originCurrencySymbol: 'COP',
16
      destinationCurrencySymbol: 'COP',
17
      amountIn: 100000,
18
      contactId: contactId,
19
      destinationAccountId: bankAccountId,
20
      description: 'Payment for Invoice #456',
21
      externalId: `invoice-456-${Date.now()}`
22
    },
23
    {
24
      headers: { 
25
        'Authorization': `Bearer ${token}`,
26
        'Content-Type': 'application/json'
27
      }
28
    }
29
  );
30
  
31
  return response.data;
32
}
33
34
const payout = await createPayoutOrder(token, orgId, merchantId, 'cnt_provider', 'ba_xyz789');
35
console.log('Payout created:', payout.id);

1
async function transferCurrency(token, orgId, merchantId) {
2
  // 1. Get quote for exchange rate
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('Exchange rate:', quote.data.exchangeRate);
15
  console.log('Will receive:', quote.data.amountOut, 'USD');
16
  
17
  // 2. Create transfer order
18
  const response = 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  // Use quote to lock rate
26
    },
27
    { headers: { 'Authorization': `Bearer ${token}` } }
28
  );
29
  
30
  return response.data;
31
}
32
33
const transfer = await transferCurrency(token, orgId, merchantId);
34
console.log('Transfer completed instantly:', transfer.status); // "COMPLETED"

1
async function buyUSDC(token, orgId, merchantId, walletId) {
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: 'ONRAMP',
7
      originCurrencySymbol: 'COP',
8
      destinationCurrencySymbol: 'USDC',
9
      amountIn: 50000
10
    },
11
    { headers: { 'Authorization': `Bearer ${token}` } }
12
  );
13
  
14
  console.log('Will receive:', quote.data.amountOut, 'USDC');
15
  console.log('Exchange rate:', quote.data.exchangeRate);
16
  console.log('Network fee:', quote.data.networkFee);
17
  
18
  // 2. Create deal (not order!)
19
  const response = await axios.post(
20
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/deals`,
21
    {
22
      type: 'ONRAMP',
23
      destinationAccountId: walletId,
24
      quoteId: quote.data.id
25
    },
26
    { headers: { 'Authorization': `Bearer ${token}` } }
27
  );
28
  
29
  return response.data;
30
}
31
32
const deal = await buyUSDC(token, orgId, merchantId, 'wallet_abc123');
33
console.log('ONRAMP deal created:', deal.id);
34
console.log('Deal can be paid in full or partially');

1
async function sellUSDC(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: 'OFFRAMP',
7
      originCurrencySymbol: 'USDC',
8
      destinationCurrencySymbol: 'COP',
9
      amountIn: 10  // 10 USDC
10
    },
11
    { headers: { 'Authorization': `Bearer ${token}` } }
12
  );
13
  
14
  console.log('Will receive:', quote.data.amountOut, 'COP');
15
  
16
  // 2. Create deal (not order!)
17
  const response = await axios.post(
18
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/deals`,
19
    {
20
      type: 'OFFRAMP',
21
      destinationAccountId: 'va_cop_12345',  // Virtual account for COP
22
      quoteId: quote.data.id
23
    },
24
    { headers: { 'Authorization': `Bearer ${token}` } }
25
  );
26
  
27
  return response.data;
28
}
29
30
const deal = await sellUSDC(token, orgId, merchantId);
31
console.log('OFFRAMP deal created:', deal.id);
32
console.log('Deposit address:', deal.depositAddress);
33
console.log('Send full crypto amount to complete');
34
// Funds will be credited to COP virtual account after crypto received