$
curl -X POST 'https://api-sandbox.koywe.com/api/v1/auth/sign-in' \
>
  -H 'Content-Type: application/json' \
>
  -d '{
>
    "apiKey": "your_api_key",
>
    "secret": "your_secret"
>
  }'

1
async function createContact(token, orgId, merchantId) {
2
  const response = await axios.post(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/contacts`,
4
    {
5
      email: 'cliente@ejemplo.com',
6
      phone: '+573001234567',
7
      fullName: 'Juan Pérez',
8
      countrySymbol: 'CO',
9
      documentType: 'CC',
10
      documentNumber: '1234567890',
11
      businessType: 'PERSON'
12
    },
13
    {
14
      headers: { 
15
        'Authorization': `Bearer ${token}`,
16
        'Content-Type': 'application/json'
17
      }
18
    }
19
  );
20
  
21
  return response.data;
22
}
23
24
// Uso
25
const contact = await createContact(token, 'tu_org_id', 'tu_merchant_id');
26
console.log('ID de Contacto:', contact.id);

1
async function getQuote(token, orgId, merchantId) {
2
  const response = await axios.post(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
4
    {
5
      originCurrencySymbol: 'COP',
6
      destinationCurrencySymbol: 'COP',
7
      amountIn: 50000, // 50,000 COP
8
      type: 'PAYIN'
9
    },
10
    {
11
      headers: { 
12
        'Authorization': `Bearer ${token}`,
13
        'Content-Type': 'application/json'
14
      }
15
    }
16
  );
17
  
18
  return response.data;
19
}
20
21
// Uso
22
const quote = await getQuote(token, 'tu_org_id', 'tu_merchant_id');
23
console.log('Cotización:', quote);

1
async function createPayinOrder(token, orgId, merchantId, contactId) {
2
  const response = await axios.post(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
4
    {
5
      type: 'PAYIN',                              // Tipo de orden: recibir pago
6
      originCurrencySymbol: 'COP',                // Moneda: Pesos Colombianos
7
      destinationCurrencySymbol: 'COP',           // Misma moneda (sin conversión)
8
      amountIn: 50000,                            // Monto: 50,000 COP
9
      description: 'Pago por Orden #12345',       // Descripción para el cliente
10
      externalId: `order-${Date.now()}`,          // Tu referencia interna
11
      contactId: contactId,                       // Cliente que está pagando
12
      paymentMethods: [
13
        {
14
          method: 'PSE',                          // Método de pago: PSE (transferencia bancaria colombiana)
15
          extra: 'BANCOLOMBIA'                    // Banco específico
16
        }
17
      ],
18
      successUrl: 'https://tusitio.com/pago/exitoso',  // Redirección después de éxito
19
      failedUrl: 'https://tusitio.com/pago/fallido'    // Redirección después de fallo
20
    },
21
    {
22
      headers: { 
23
        'Authorization': `Bearer ${token}`,
24
        'Content-Type': 'application/json'
25
      }
26
    }
27
  );
28
  
29
  return response.data;
30
}
31
32
// Uso
33
const order = await createPayinOrder(token, 'tu_org_id', 'tu_merchant_id', contact.id);
34
console.log('Orden creada:', order.id);
35
console.log('URL de pago:', order.paymentUrl);

1
async function getOrderStatus(token, orgId, merchantId, orderId) {
2
  const response = await axios.get(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders/${orderId}`,
4
    {
5
      headers: { 
6
        'Authorization': `Bearer ${token}`
7
      }
8
    }
9
  );
10
  
11
  return response.data;
12
}
13
14
// Uso
15
const orderStatus = await getOrderStatus(token, 'tu_org_id', 'tu_merchant_id', order.id);
16
console.log('Estado de la orden:', orderStatus.status);
17
// Estados posibles: PENDING, PROCESSING, PAID, COMPLETED, FAILED, CANCELLED, EXPIRED

1
const axios = require('axios');
2
3
const BASE_URL = 'https://api-sandbox.koywe.com/api/v1';
4
const ORG_ID = process.env.KOYWE_ORG_ID;
5
const MERCHANT_ID = process.env.KOYWE_MERCHANT_ID;
6
const API_KEY = process.env.KOYWE_API_KEY;
7
const SECRET = process.env.KOYWE_SECRET;
8
9
async function main() {
10
  try {
11
    // 1. Autenticar
12
    console.log('1. Autenticando...');
13
    const authResponse = await axios.post(`${BASE_URL}/auth/sign-in`, {
14
      apiKey: API_KEY,
15
      secret: SECRET
16
    });
17
    const token = authResponse.data.token;
18
    console.log('✓ Autenticado');
19
20
    // 2. Crear contacto
21
    console.log('\n2. Creando contacto...');
22
    const contactResponse = await axios.post(
23
      `${BASE_URL}/organizations/${ORG_ID}/merchants/${MERCHANT_ID}/contacts`,
24
      {
25
        email: 'cliente@ejemplo.com',
26
        phone: '+573001234567',
27
        fullName: 'Juan Pérez',
28
        countrySymbol: 'CO',
29
        documentType: 'CC',
30
        documentNumber: '1234567890',
31
        businessType: 'PERSON'
32
      },
33
      { headers: { Authorization: `Bearer ${token}` } }
34
    );
35
    const contactId = contactResponse.data.id;
36
    console.log('✓ Contacto creado:', contactId);
37
38
    // 3. Crear orden PAYIN
39
    console.log('\n3. Creando orden de pago...');
40
    const orderResponse = await axios.post(
41
      `${BASE_URL}/organizations/${ORG_ID}/merchants/${MERCHANT_ID}/orders`,
42
      {
43
        type: 'PAYIN',
44
        originCurrencySymbol: 'COP',
45
        destinationCurrencySymbol: 'COP',
46
        amountIn: 50000,
47
        description: 'Pago por Orden #12345',
48
        externalId: `order-${Date.now()}`,
49
        contactId: contactId,
50
        paymentMethods: [{ method: 'PSE', extra: 'BANCOLOMBIA' }],
51
        successUrl: 'https://tusitio.com/exitoso',
52
        failedUrl: 'https://tusitio.com/fallido'
53
      },
54
      { headers: { Authorization: `Bearer ${token}` } }
55
    );
56
    const order = orderResponse.data;
57
    console.log('✓ Orden creada:', order.id);
58
    console.log('✓ URL de pago:', order.paymentUrl);
59
60
    // 4. Verificar estado de la orden
61
    console.log('\n4. Verificando estado de la orden...');
62
    const statusResponse = await axios.get(
63
      `${BASE_URL}/organizations/${ORG_ID}/merchants/${MERCHANT_ID}/orders/${order.id}`,
64
      { headers: { Authorization: `Bearer ${token}` } }
65
    );
66
    console.log('✓ Estado actual:', statusResponse.data.status);
67
68
    console.log('\n✅ ¡Éxito! Orden de pago creada.');
69
    console.log('👉 Redirige a tu cliente a:', order.paymentUrl);
70
71
  } catch (error) {
72
    console.error('❌ Error:', error.response?.data || error.message);
73
  }
74
}
75
76
main();