Pruebas en Sandbox

https://api-sandbox.koywe.com

npx @koyweforest/cli policy create --data '{"name":"default"}'
npx @koyweforest/cli policy rules create --data '{
  "name": "allow-balance-transfer",
  "scope": "ORDER",
  "match": { "orderType": ["BALANCE_TRANSFER"] },
  "decision": { "action": "ALLOW" }
}'

{
  "method": "PSE",
  "extra": { "bankAccount": { "name": "BANCOLOMBIA" } }  // Cualquier banco de prueba
}

{
  "method": "NEQUI"
}

{
  "method": "PIX_STATIC"
}

{
  "method": "PIX_DYNAMIC"
}

{
  "method": "SPEI"
}

{
  "method": "CARD"
}

{
  "method": "KHIPU"
}

{
  "method": "KHIPU"  // También funciona para Argentina
}

async function testSuccessfulPayment() {
  // Cualquier monto tendrá éxito en sandbox
  const order = await createPayinOrder(token, orgId, merchantId, {
    amount: 50000,
    currency: 'COP',
    paymentMethod: 'PSE',
    bank: 'BANCOLOMBIA'
  });
  
  console.log('Orden creada:', order.id);
  console.log('Estado:', order.status); // "PENDING"
  console.log('URL de Pago:', order.paymentUrl);
  
  // En sandbox, la orden se completa automáticamente
  // Espera unos segundos y verifica el estado
  await sleep(5000);
  
  const updated = await getOrderStatus(token, orgId, merchantId, order.id);
  console.log('Estado actualizado:', updated.status); // "COMPLETED"
}

PENDING → PROCESSING → PAID → COMPLETED

async function testFailedPayment() {
  const order = await createPayinOrder(token, orgId, merchantId, {
    amount: 666,  // Monto especial de prueba para fallo
    currency: 'COP',
    paymentMethod: 'PSE',
    bank: 'BANCOLOMBIA'
  });
  
  console.log('Orden creada:', order.id);
  
  // Espera el procesamiento
  await sleep(3000);
  
  const updated = await getOrderStatus(token, orgId, merchantId, order.id);
  console.log('Estado:', updated.status); // "FAILED"
  console.log('Error:', updated.errorMessage);
}

PENDING → PROCESSING → FAILED

async function testExpiredPayment() {
  // Establecer dueDate en el pasado
  const pastDate = new Date();
  pastDate.setHours(pastDate.getHours() - 1);
  
  const order = await createPayinOrder(token, orgId, merchantId, {
    amount: 50000,
    currency: 'COP',
    paymentMethod: 'PSE',
    bank: 'BANCOLOMBIA',
    dueDate: pastDate.toISOString()
  });
  
  console.log('Estado:', order.status); // "EXPIRED"
}

async function testPaymentLink() {
  // Crear enlace de pago - ¡sin contacto o método de pago necesario!
  const order = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/orders`,
    {
      type: 'PAYMENT_LINK',
      originCurrencySymbol: 'COP',
      destinationCurrencySymbol: 'COP',
      amountIn: 50000,
      description: 'Factura de Prueba #123 - Diseño Web',
      externalId: `test-invoice-${Date.now()}`
    },
    { headers: { 'Authorization': `Bearer ${token}` } }
  );
  
  console.log('✓ Enlace de pago creado:', order.data.id);
  console.log('📧 Comparte este enlace:', order.data.paymentUrl);
  console.log('');
  console.log('El cliente:');
  console.log('  1. Abre el enlace');
  console.log('  2. Ve checkout de marca Koywe');
  console.log('  3. Ingresa su información personal');
  console.log('  4. Selecciona método de pago (PSE, PIX, Nequi, etc.)');
  console.log('  5. Completa el pago');
  
  // Simular compartir vía email, WhatsApp o código QR
  return order.data;
}
 
// Uso
const link = await testPaymentLink();
 
// Abre la URL de pago en un navegador para probar el flujo completo de checkout
console.log('\n🌐 Abre esta URL para probar:', link.paymentUrl);

def test_payment_link():
    # Crear enlace de pago - ¡campos mínimos!
    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': 50000,
            'description': 'Factura de Prueba #123 - Diseño Web'
        },
        headers={'Authorization': f'Bearer {token}'}
    )
    
    order = response.json()
    print(f"✓ Enlace de pago creado: {order['id']}")
    print(f"📧 Comparte este enlace: {order['paymentUrl']}")
    
    return order
 
# Uso
link = test_payment_link()
print(f"\n🌐 Abre esta URL para probar: {link['paymentUrl']}")

{
  "id": "evt_abc123",
  "type": "order.completed",
  "version": "v1",
  "occurred_at": "2025-11-13T15:30:00Z",
  "source": "koywe.api",
  "environment": "sandbox",
  "organization_id": "org_xyz",
  "merchant_id": "mrc_abc",
  "data": {
    "orderId": "ord_123456",
    "type": "PAYIN",
    "status": "COMPLETED",
    "amountIn": 50000,
    "currencySymbol": "COP"
  }
}

{
  "documentType": "CC",
  "documentNumber": "1234567890",
  "fullName": "Juan Pérez Prueba"
}

{
  "documentType": "CPF",
  "documentNumber": "12345678900",
  "fullName": "Maria Silva Prueba"
}

{
  "documentType": "RFC",
  "documentNumber": "XAXX010101000",
  "fullName": "Pedro García Prueba"
}

{
  "documentType": "RUT",
  "documentNumber": "11111111-1",
  "fullName": "Ana López Prueba"
}

{
  "bankCode": "BANCOLOMBIA",
  "accountNumber": "1234567890",
  "accountType": "savings",
  "currencySymbol": "COP"
}

{
  "bankCode": "BANCO_DO_BRASIL",
  "accountNumber": "12345678",
  "accountType": "checking",
  "currencySymbol": "BRL"
}

{
  "bankCode": "BBVA_MEXICO",
  "accountNumber": "012345678901234567",
  "accountType": "checking",
  "currencySymbol": "MXN"
}

{
  "bankCode": "BANCO_CHILE",
  "accountNumber": "12345678",
  "accountType": "checking",
  "currencySymbol": "CLP"
}

0x0000000000000000000000000000000000000000

async function testOnramp() {
  // Crear billetera cripto (o usar existente)
  const wallet = await createCryptoWallet(token, orgId, merchantId, {
    address: '0x0000000000000000000000000000000000000000',
    network: 'ETHEREUM'  // Usa Sepolia automáticamente en sandbox
  });
  
  // Comprar USDC con COP
  const order = await createOrder(token, orgId, merchantId, {
    type: 'ONRAMP',
    originCurrencySymbol: 'COP',
    destinationCurrencySymbol: 'USDC',
    amountIn: 50000,
    destinationAccountId: wallet.id
  });
  
  console.log('Orden ONRAMP:', order.id);
  // En sandbox, cripto es "enviado" a dirección de prueba
}

async function testOfframp() {
  // Vender USDC por COP
  const order = await createOrder(token, orgId, merchantId, {
    type: 'OFFRAMP',
    originCurrencySymbol: 'USDC',
    destinationCurrencySymbol: 'COP',
    amountIn: 10  // 10 USDC
  });
  
  console.log('Orden OFFRAMP:', order.id);
  // En sandbox, orden se completa automáticamente
  // Fiat se acredita a cuenta virtual
}

async function testIdempotency() {
  const externalId = `test-order-${Date.now()}`;
  
  // Crear orden
  const order1 = await createPayinOrder(token, orgId, merchantId, {
    amount: 50000,
    externalId: externalId
  });
  
  // Intentar crear la misma orden nuevamente
  const order2 = await createPayinOrder(token, orgId, merchantId, {
    amount: 50000,
    externalId: externalId  // Mismo externalId
  });
  
  // Debería devolver la misma orden
  console.log(order1.id === order2.id); // true
}

async function testCheckoutFlow() {
  console.log('1. Cliente agrega items al carrito...');
  const cartTotal = 50000; // 50,000 COP
  
  console.log('2. Cliente procede al checkout...');
  const contact = await createContact(token, orgId, merchantId, {
    email: 'prueba@ejemplo.com',
    fullName: 'Cliente Prueba',
    country: 'CO',
    documentType: 'CC',
    documentNumber: '1234567890'
  });
  
  console.log('3. Obtener métodos de pago...');
  const methods = await getPaymentMethods('CO', 'COP');
  
  console.log('4. Crear orden de pago...');
  const order = await createPayinOrder(token, orgId, merchantId, {
    amount: cartTotal,
    currency: 'COP',
    contactId: contact.id,
    paymentMethod: 'PSE',
    bank: 'BANCOLOMBIA',
    externalId: `cart-${Date.now()}`
  });
  
  console.log('5. Redirigir cliente al pago...');
  console.log('URL de Pago:', order.paymentUrl);
  
  console.log('6. Esperar confirmación por webhook...');
  // En producción, el manejador de webhook procesa esto
  await sleep(5000);
  
  console.log('7. Verificar orden completada...');
  const completed = await getOrderStatus(token, orgId, merchantId, order.id);
  console.log('Estado final:', completed.status); // "COMPLETED"
  
  console.log('8. Cumplir orden...');
  console.log('✅ Flujo de checkout de prueba completo!');
}

POST /api/v1/organizations/{organizationId}/merchants/{merchantId}/sandbox/bank-income/simulate

{
  "currency": "ARS",
  "amount": 500000,
  "documentType": "CUIT",
  "documentNumber": "30712345678",
  "customerReference": "customer-test-001"
}

{
  "referenceId": "bm_1234567890",
  "virtualAccount": { /* PayInVirtualBankAccount */ },
  "virtualAccountProvisioned": true
}

async function simularDepositoSandbox() {
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/sandbox/bank-income/simulate`,
    {
      currency: 'ARS',
      amount: 500000,
      documentType: 'CUIT',
      documentNumber: '30712345678',
      customerReference: `test-${Date.now()}`
    },
    { headers: { Authorization: `Bearer ${token}` } }
  );
 
  console.log('Depósito simulado:', response.data.referenceId);
  console.log('Acreditado en VA:', response.data.virtualAccount.accountNumber);
}