Español
SDK oficial JavaScript/TypeScript para KillB
npm install @killb/sdk
import { KillB } from '@killb/sdk'; const killb = new KillB({ email: process.env.KILLB_EMAIL, password: process.env.KILLB_PASSWORD, environment: 'sandbox' // o 'production' }); // SDK maneja autenticación automáticamente await killb.initialize();
// Crear usuario const user = await killb.users.create({ type: 'PERSON', externalId: 'user-12345', data: { firstName: 'Juan', lastName: 'García', email: '[email protected]', phone: '+573001234567', dateOfBirth: '1990-01-01', address: { street1: 'Calle 123', city: 'Bogotá', state: 'Cundinamarca', zipCode: '110111', countryCode: 'CO' }, document: { type: 'NUIP', number: '1234567890', issuedCountryCode: 'CO' } } }); console.log('Usuario creado:', user.id); console.log('Nivel KYC:', user.accessLevel);
// Crear cuenta de billetera const wallet = await killb.accounts.create({ type: 'WALLET', userId: user.id, externalId: 'wallet-polygon-usdc', data: { firstName: 'Juan', lastName: 'García', email: '[email protected]', phone: '+573001234567', currency: 'USDC', network: 'POLYGON', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb', countryCode: 'CO', document: { type: 'NUIP', number: '1234567890', issuedCountryCode: 'CO' } } }); console.log('Billetera creada:', wallet.id);
// Crear cotización const quote = await killb.quotations.create({ fromCurrency: 'COP', toCurrency: 'USDC', amount: 100000, amountIsToCurrency: false, cashInMethod: 'PSE', cashOutMethod: 'POLYGON' }); console.log('Tasa:', quote.rate); console.log('Recibirás:', quote.toAmount, 'USDC'); console.log('Expira en:', new Date(quote.expiresAt));
// Crear on-ramp const ramp = await killb.ramps.create({ quotationId: quote.id, userId: user.id, accountId: wallet.id, externalId: 'onramp-123' }); console.log('ID del Ramp:', ramp.id); console.log('Estado:', ramp.status); console.log('URL de Pago:', ramp.paymentInfo[0].url);
import type { User, CreateUserRequest, Account, CreateAccountRequest, Ramp, CreateRampRequest, Quotation, WebhookEvent } from '@killb/sdk'; // Operaciones seguras por tipo const createUser = async (data: CreateUserRequest): Promise<User> => { return await killb.users.create(data); };