Visão Geral Contas bancárias são usadas como destinos para transações off-ramp (cripto → fiat). A KillB suporta múltiplos sistemas bancários na América Latina e nos Estados Unidos.
Tipos de Conta Bancária Suportados
PSE (Colômbia) Contas bancárias colombianas via sistema PSE
SPEI (México) Contas baseadas em CLABE mexicanas
ACH (EUA) Contas bancárias dos EUA via ACH
Wire (Internacional) Contas de transferência wire
Colômbia - Contas PSE { "type" : "PSE" , "userId" : "user-id" , "externalId" : "pse-account-1" , "data" : { "firstName" : "Juan" , "lastName" : "García" , "email" : "[email protected] " , "phone" : "+573001234567" , "accountNumber" : "1234567890" , "bankCode" : "0001" , "type" : "savings" , "countryCode" : "CO" , "document" : { "type" : "NUIP" , "number" : "1234567890" , "issuedCountryCode" : "CO" } } } Tipos de Conta:
savings - Conta poupança (Cuenta de Ahorros)checking - Conta corrente (Cuenta Corriente)
Obter Bancos Colombianos GET /api/v2/banks?countryCode=CO [ { "code" : "0001" , "companyName" : "Bancolombia" , "accountTypes" : [ "savings" , "checking" ] }, { "code" : "0002" , "companyName" : "Banco de Bogotá" , "accountTypes" : [ "savings" , "checking" ] } ] México - Contas SPEI { "type" : "SPEI" , "userId" : "user-id" , "externalId" : "spei-account-1" , "data" : { "firstName" : "María" , "lastName" : "López" , "email" : "[email protected] " , "phone" : "+525512345678" , "clabe" : "012345678901234567" , "clabeType" : "CLABE" , "countryCode" : "MX" , "document" : { "type" : "RFC" , "number" : "LOMM920310ABC" , "issuedCountryCode" : "MX" } } } Tipos de CLABE CLABE Padrão
Cartão de Débito
Número de Telefone
Número de conta bancária de 18 dígitos { "clabe" : "012345678901234567" , "clabeType" : "CLABE" } Formato mais comum para transferências bancárias. Número de cartão de 16 dígitos { "clabe" : "1234567890123456" , "clabeType" : "DEBIT_CARD" , "bankCode" : "012" } Requer campo bankCode. Telefone de 10 dígitos para banking móvel { "clabe" : "5512345678" , "clabeType" : "PHONE_NUMBER" , "bankCode" : "014" } Requer campo bankCode. Obter Bancos Mexicanos GET /api/v2/banks?countryCode=MX Estados Unidos - Contas ACH { "type" : "ACH" , "userId" : "user-id" , "externalId" : "ach-account-1" , "data" : { "firstName" : "John" , "lastName" : "Smith" , "email" : "[email protected] " , "phone" : "+12125551234" , "bankName" : "Chase Bank" , "routingNumber" : "021000021" , "accountNumber" : "123456789" , "type" : "checking" , "countryCode" : "US" , "document" : { "type" : "SSN" , "number" : "123-45-6789" , "issuedCountryCode" : "US" } } } Tipos de Conta:
checking - Conta correntesavings - Conta poupança
Número de Roteamento: Número de roteamento ABA de 9 dígitosValidação Valide detalhes da conta antes de criar:
const validatePSEAccount = ( data ) => { const errors = []; // Número da conta (10-20 dígitos) if ( ! / ^ \d {10,20} $ / . test ( data . accountNumber )) { errors . push ( 'Formato de número de conta inválido' ); } // Código do banco (4 dígitos) if ( ! / ^ \d {4} $ / . test ( data . bankCode )) { errors . push ( 'Código de banco inválido' ); } // Tipo de conta if ( ! [ 'savings' , 'checking' ]. includes ( data . type )) { errors . push ( 'Tipo de conta deve ser savings ou checking' ); } return errors ; };
Testando Contas Bancárias No sandbox, use estes códigos de banco de teste:
Colômbia:
0001 - Bancolombia0002 - Banco de Bogotá0003 - Davivienda
México:
012 - BBVA014 - Santander072 - Banorte
Qualquer formato de número de conta funcionará no sandbox. Use formatos realistas para melhores testes.
Próximos Passos 
