Português (BR)
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' // ou 'production' }); // SDK lida com autenticação automaticamente await killb.initialize();
// Criar usuário const user = await killb.users.create({ type: 'PERSON', externalId: 'user-12345', data: { firstName: 'João', lastName: 'Silva', email: '[email protected]', phone: '+5511987654321', dateOfBirth: '1990-01-01', address: { street1: 'Rua 123', city: 'São Paulo', state: 'SP', zipCode: '01234-567', countryCode: 'BR' }, document: { type: 'CPF', number: '12345678900', issuedCountryCode: 'BR' } } }); console.log('Usuário criado:', user.id); console.log('Nível KYC:', user.accessLevel);
// Criar conta de carteira const wallet = await killb.accounts.create({ type: 'WALLET', userId: user.id, externalId: 'wallet-polygon-usdc', data: { firstName: 'João', lastName: 'Silva', email: '[email protected]', phone: '+5511987654321', currency: 'USDC', network: 'POLYGON', address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb', countryCode: 'BR', document: { type: 'CPF', number: '12345678900', issuedCountryCode: 'BR' } } }); console.log('Carteira criada:', wallet.id);
// Criar cotação const quote = await killb.quotations.create({ fromCurrency: 'BRL', toCurrency: 'USDC', amount: 1000, amountIsToCurrency: false, cashInMethod: 'PIX', cashOutMethod: 'POLYGON' }); console.log('Taxa:', quote.rate); console.log('Você receberá:', quote.toAmount, 'USDC'); console.log('Expira em:', new Date(quote.expiresAt));
// Criar on-ramp const ramp = await killb.ramps.create({ quotationId: quote.id, userId: user.id, accountId: wallet.id, externalId: 'onramp-123' }); console.log('ID do Ramp:', ramp.id); console.log('Status:', ramp.status); console.log('URL de Pagamento:', ramp.paymentInfo[0].url);
import type { User, CreateUserRequest, Account, CreateAccountRequest, Ramp, CreateRampRequest, Quotation, WebhookEvent } from '@killb/sdk'; // Operações seguras por tipo const createUser = async (data: CreateUserRequest): Promise<User> => { return await killb.users.create(data); };