Órdenes y Tipos de Orden

[
  { "method": "KHIPU" }
]

[
  { "method": "PSE", "extra": { "bankAccount": { "name": "BANCOLOMBIA" } } }
]

{
  "type": "PAYIN",                              // Tipo de orden
  "originCurrencySymbol": "COP",                // Moneda fiat
  "destinationCurrencySymbol": "COP",           // Misma que origen
  "amountIn": 50000,                            // Monto a cobrar
  "description": "Pago por Orden #12345",       // Descripción visible para cliente
  "paymentMethods": [                                     // Al menos un método de pago
    {
      "method": "PSE",                                    // Código de método de pago
      "extra": { "bankAccount": { "name": "BANCOLOMBIA" } } // Datos adicionales por método
    }
  ],
  "successUrl": "https://tusitio.com/exitoso",  // Redirección después de éxito
  "failedUrl": "https://tusitio.com/fallido"    // Redirección después de fallo
}

{
  "contactId": "cnt_abc123",                    // Vincular a contacto cliente
  "externalId": "order-12345",                  // Tu referencia interna
  "metadata": { "orderId": "12345" },          // Datos personalizados
  "dueDate": "2025-11-14T23:59:59Z"            // Fecha límite de pago
}

async function createPayinOrder(token, orgId, merchantId) {
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
    {
      type: 'PAYIN',
      originCurrencySymbol: 'COP',
      destinationCurrencySymbol: 'COP',
      amountIn: 50000,
      description: 'Pago por Orden #12345',
      externalId: `order-${Date.now()}`,
      paymentMethods: [
        {
          method: 'PSE',
          extra: { bankAccount: { name: 'BANCOLOMBIA' } }
        }
      ],
      successUrl: 'https://tusitio.com/exitoso',
      failedUrl: 'https://tusitio.com/fallido'
    },
    {
      headers: { 
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      }
    }
  );
  
  return response.data;
}
 
const order = await createPayinOrder(token, orgId, merchantId);
console.log('URL de Pago:', order.paymentUrl);
// Redirige al cliente a order.paymentUrl

{
  "type": "PAYOUT",                              // Tipo de orden
  "originCurrencySymbol": "COP",                 // Moneda fiat
  "destinationCurrencySymbol": "COP",            // Misma que origen
  "amountIn": 100000,                            // Monto a enviar
  "destinationAccountId": "ba_xyz789",           // ID cuenta bancaria proveedor
  "description": "Pago por Factura #456"         // Descripción interna
}

{
  "contactId": "cnt_provider123",                // Vincular a contacto proveedor
  "externalId": "invoice-456",                   // Tu referencia interna
  "metadata": { "invoiceId": "456" }            // Datos personalizados
}

async function createPayoutOrder(token, orgId, merchantId, contactId, bankAccountId) {
  // 1. Verificar saldo primero
  const balances = await getMerchantBalances(token, orgId, merchantId);
  const copBalance = balances.find(b => b.currencySymbol === 'COP');
  
  if (copBalance.availableBalance < 100000) {
    throw new Error('Saldo insuficiente');
  }
  
  // 2. Crear orden de payout
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
    {
      type: 'PAYOUT',
      originCurrencySymbol: 'COP',
      destinationCurrencySymbol: 'COP',
      amountIn: 100000,
      contactId: contactId,
      destinationAccountId: bankAccountId,
      description: 'Pago por Factura #456',
      externalId: `invoice-456-${Date.now()}`
    },
    {
      headers: { 
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      }
    }
  );
  
  return response.data;
}
 
const payout = await createPayoutOrder(token, orgId, merchantId, 'cnt_provider', 'ba_xyz789');
console.log('Payout creado:', payout.id);

{
  "type": "BALANCE_TRANSFER",                    // Tipo de orden
  "originCurrencySymbol": "COP",                 // Moneda origen
  "destinationCurrencySymbol": "USD",            // Moneda destino
  "amountIn": 1000000                            // Monto a convertir (1M COP)
}

async function transferCurrency(token, orgId, merchantId) {
  // 1. Obtener cotización para tasa de cambio
  const quote = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
    {
      type: 'BALANCE_TRANSFER',
      originCurrencySymbol: 'COP',
      destinationCurrencySymbol: 'USD',
      amountIn: 1000000
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  console.log('Tasa de cambio:', quote.data.exchangeRate);
  console.log('Recibirás:', quote.data.amountOut, 'USD');
  
  // 2. Crear orden de transferencia — pasar quoteId fija tasa y montos,
  //    así que omite originCurrencySymbol / destinationCurrencySymbol / amountIn / amountOut
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
    {
      type: 'BALANCE_TRANSFER',
      quoteId: quote.data.id
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  return response.data;
}
 
const transfer = await transferCurrency(token, orgId, merchantId);
console.log('Transferencia completada instantáneamente:', transfer.status); // "COMPLETED"

{
  "type": "ONRAMP",
  "originCurrencySymbol": "COP",                 // Moneda fiat
  "destinationCurrencySymbol": "USDC",           // Moneda cripto
  "amountIn": 50000                              // Monto fiat
}

{
  "type": "ONRAMP",
  "destinationAccountId": "wallet_abc123",       // ID billetera cripto
  "quoteId": "quote_xyz789"                      // ID cotización
}

async function buyUSDC(token, orgId, merchantId, walletId) {
  // 1. Obtener cotización
  const quote = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
    {
      type: 'ONRAMP',
      originCurrencySymbol: 'COP',
      destinationCurrencySymbol: 'USDC',
      amountIn: 50000
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  console.log('Recibirás:', quote.data.amountOut, 'USDC');
  console.log('Tasa de cambio:', quote.data.exchangeRate);
  console.log('Comisión de red:', quote.data.networkFee);
  
  // 2. Crear deal (¡no orden!)
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/deals`,
    {
      type: 'ONRAMP',
      destinationAccountId: walletId,
      quoteId: quote.data.id
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  return response.data;
}
 
const deal = await buyUSDC(token, orgId, merchantId, 'wallet_abc123');
console.log('Deal ONRAMP creado:', deal.id);
console.log('El deal puede pagarse completa o parcialmente');

{
  "type": "OFFRAMP",
  "originCurrencySymbol": "USDC",                // Moneda cripto
  "destinationCurrencySymbol": "COP",            // Moneda fiat
  "amountIn": 10                                 // Monto cripto (10 USDC)
}

{
  "type": "OFFRAMP",
  "destinationAccountId": "va_cop_12345",        // ID cuenta virtual
  "quoteId": "quote_xyz789"                      // ID cotización
}

async function sellUSDC(token, orgId, merchantId) {
  // 1. Obtener cotización
  const quote = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/quotes`,
    {
      type: 'OFFRAMP',
      originCurrencySymbol: 'USDC',
      destinationCurrencySymbol: 'COP',
      amountIn: 10  // 10 USDC
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  console.log('Recibirás:', quote.data.amountOut, 'COP');
  
  // 2. Crear deal (¡no orden!)
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/deals`,
    {
      type: 'OFFRAMP',
      destinationAccountId: 'va_cop_12345',  // Cuenta virtual para COP
      quoteId: quote.data.id
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  return response.data;
}
 
const deal = await sellUSDC(token, orgId, merchantId);
console.log('Deal OFFRAMP creado:', deal.id);
console.log('Dirección de depósito:', deal.cryptoDestinationWallet);
console.log('Envía el monto completo de cripto para completar');
// Los fondos se acreditarán a la cuenta virtual COP después de recibir el cripto.

{
  "type": "PAYMENT_LINK",                        // Tipo de orden
  "originCurrencySymbol": "COP",                 // Moneda
  "destinationCurrencySymbol": "COP",            // Igual que origen
  "amountIn": 75000,                             // Monto a cobrar
  "description": "Factura #789"                  // Muestra al cliente
}

{
  "dueDate": "2025-11-14T23:59:59Z",           // Expiración del enlace
  "externalId": "invoice-789",                  // Tu referencia
  "successUrl": "https://tusite.com/exitoso", // Redireccionar después de pago
  "failedUrl": "https://tusite.com/fallido"    // Redireccionar en fallo
}

// Ejemplo mínimo - ¡solo crear y compartir!
async function createPaymentLink(amount, description) {
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
    {
      type: 'PAYMENT_LINK',
      originCurrencySymbol: 'COP',
      destinationCurrencySymbol: 'COP',
      amountIn: amount,
      description: description
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  return response.data;
}
 
// Uso
const link = await createPaymentLink(75000, 'Factura #789 - Diseño Web');
console.log('Comparte este enlace:', link.paymentUrl);
 
// Enviar vía email, WhatsApp, SMS o generar código QR
await sendEmail(customerEmail, {
  subject: 'Solicitud de Pago - Factura #789',
  body: `Por favor paga aquí: ${link.paymentUrl}`
});

// Ejemplo completo con todas las opciones
async function createPaymentLinkWithOptions(invoiceData) {
  const dueDate = new Date();
  dueDate.setHours(dueDate.getHours() + 24); // Expira en 24h
  
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
    {
      type: 'PAYMENT_LINK',
      originCurrencySymbol: 'COP',
      destinationCurrencySymbol: 'COP',
      amountIn: invoiceData.amount,
      description: invoiceData.description,
      externalId: invoiceData.invoiceNumber,
      dueDate: dueDate.toISOString(),
      successUrl: 'https://tusitio.com/pago/exitoso',
      failedUrl: 'https://tusitio.com/pago/fallido'
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  return response.data;
}
 
// Uso
const link = await createPaymentLinkWithOptions({
  amount: 150000,
  description: 'Suscripción Mensual - Noviembre 2025',
  invoiceNumber: 'INV-2025-11-789'
});
 
console.log('Enlace de pago:', link.paymentUrl);

def create_payment_link(amount, description):
    response = requests.post(
        f'https://api-sandbox.koywe.com/api/v1/organizations/{org_id}/merchants/{merchant_id}/orders',
        json={
            'type': 'PAYMENT_LINK',
            'originCurrencySymbol': 'COP',
            'destinationCurrencySymbol': 'COP',
            'amountIn': amount,
            'description': description
        },
        headers={'Authorization': f'Bearer {token}'}
    )
    
    return response.json()
 
# Uso
link = create_payment_link(75000, 'Factura #789 - Diseño Web')
print(f"Comparte este enlace: {link['paymentUrl']}")

{
  "id": "ord_abc123",
  "type": "PAYMENT_LINK",
  "status": "PENDING",
  "paymentUrl": "https://checkout.koywe.com/pay/ord_abc123",
  "amountIn": 75000,
  "originCurrencySymbol": "COP",
  "description": "Factura #789 - Diseño Web",
  "createdAt": "2025-11-13T15:00:00Z"
}

{
  "externalId": "order-12345-20251113"  // Tu identificador único
}

{
  "metadata": {
    "orderId": "12345",
    "customerId": "cust_67890",
    "source": "mobile_app",
    "campaign": "summer_sale"
  }
}

const response = await axios.post(
  `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${sourceMerchantId}/orders`,
  {
    type: 'INTER_MERCHANT_TRANSFER',
    destinationMerchantId: 'mer_destination_abc',
    originCurrencySymbol: 'USD',
    destinationCurrencySymbol: 'USD',
    amountIn: 1000,
    description: 'Liquidación comisiones julio'
  },
  { headers: { 'Authorization': `Bearer ${token}` } }
);
 
// En sandbox se completa instantáneamente como BALANCE_TRANSFER:
console.log(response.data.status); // "COMPLETED"

{
  "id": "ord_imt_xyz789",
  "type": "INTER_MERCHANT_TRANSFER",
  "status": "COMPLETED",
  "originMerchantId": "mer_source_123",
  "destinationMerchantId": "mer_destination_abc",
  "originCurrencySymbol": "USD",
  "destinationCurrencySymbol": "USD",
  "amountIn": 1000,
  "amountOut": 1000,
  "description": "Liquidación comisiones julio",
  "createdAt": "2026-04-24T12:00:00Z",
  "completedAt": "2026-04-24T12:00:01Z"
}

# Vía CLI (el CLI refleja los 7 tipos correctamente):
npx @koyweforest/cli orders list --type INTER_MERCHANT_TRANSFER --format table
 
# Vía HTTP directo:
curl -H "Authorization: Bearer $TOKEN" \
  "https://api-sandbox.koywe.com/api/v1/organizations/$ORG/merchants/$MERCHANT/orders?type=INTER_MERCHANT_TRANSFER"