1
async function listContacts(token, orgId, merchantId, options = {}) {
2
  const response = await axios.get(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/contacts`,
4
    {
5
      params: {
6
        search: options.search,        // Opcional: buscar por nombre o email
7
        limit: options.limit || 50,
8
        page: options.page || 1
9
      },
10
      headers: { 'Authorization': `Bearer ${token}` }
11
    }
12
  );
13
  
14
  return response.data;
15
}
16
17
// Uso
18
const contacts = await listContacts(token, orgId, merchantId, {
19
  search: 'juan',
20
  limit: 20
21
});
22
23
console.log(`Se encontraron ${contacts.length} contactos`);

1
async function getContact(token, orgId, merchantId, contactId) {
2
  const response = await axios.get(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/contacts/${contactId}`,
4
    {
5
      headers: { 'Authorization': `Bearer ${token}` }
6
    }
7
  );
8
  
9
  return response.data;
10
}
11
12
// Uso
13
const contact = await getContact(token, orgId, merchantId, 'cnt_abc123');
14
console.log('Contacto:', contact);

1
async function getContactBankAccounts(token, orgId, merchantId, contactId) {
2
  const response = await axios.get(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/contacts/${contactId}/bank-accounts`,
4
    {
5
      headers: { 'Authorization': `Bearer ${token}` }
6
    }
7
  );
8
  
9
  return response.data;
10
}
11
12
// Uso
13
const bankAccounts = await getContactBankAccounts(token, orgId, merchantId, 'cnt_abc123');
14
console.log('Cuentas bancarias:', bankAccounts);

1
async function updateContact(token, orgId, merchantId, contactId, updates) {
2
  const response = await axios.put(
3
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/contacts/${contactId}`,
4
    updates,
5
    {
6
      headers: { 
7
        'Authorization': `Bearer ${token}`,
8
        'Content-Type': 'application/json'
9
      }
10
    }
11
  );
12
  
13
  return response.data;
14
}
15
16
// Uso - Actualizar teléfono o dirección
17
const updated = await updateContact(token, orgId, merchantId, 'cnt_abc123', {
18
  phone: '+573009876543',
19
  address: {
20
    street: 'Calle 456',
21
    city: 'Medellín'
22
  }
23
});

1
// Verificar si el contacto existe antes de crear
2
async function getOrCreateContact(token, orgId, merchantId, email) {
3
  // Intentar encontrar existente
4
  const contacts = await listContacts(token, orgId, merchantId, { search: email });
5
  
6
  if (contacts.length > 0) {
7
    return contacts[0];  // Devolver existente
8
  }
9
  
10
  // Crear nuevo si no se encuentra
11
  return await createContact(token, orgId, merchantId, {
12
    email: email,
13
    // ... otros campos
14
  });
15
}