Visión General Las cuentas bancarias se usan como destinos para transacciones off-ramp (cripto → fiat). KillB soporta múltiples sistemas bancarios en América Latina y Estados Unidos.
Tipos de Cuenta Bancaria Soportados
PSE (Colombia) Cuentas bancarias colombianas vía sistema PSE
SPEI (México) Cuentas basadas en CLABE mexicanas
ACH (EE.UU.) Cuentas bancarias de EE.UU. vía ACH
Wire (Internacional) Cuentas de transferencia wire
Colombia - Cuentas 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 Cuenta:
savings - Cuenta de ahorros (Cuenta de Ahorros)checking - Cuenta corriente (Cuenta Corriente)
Obtener 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 - Cuentas 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 Estándar
Tarjeta de Débito
Número de Teléfono
Número de cuenta bancaria de 18 dígitos { "clabe" : "012345678901234567" , "clabeType" : "CLABE" } Formato más común para transferencias bancarias. Número de tarjeta de 16 dígitos { "clabe" : "1234567890123456" , "clabeType" : "DEBIT_CARD" , "bankCode" : "012" } Requiere campo bankCode. Teléfono de 10 dígitos para banca móvil { "clabe" : "5512345678" , "clabeType" : "PHONE_NUMBER" , "bankCode" : "014" } Requiere campo bankCode. Obtener Bancos Mexicanos GET /api/v2/banks?countryCode=MX Estados Unidos - Cuentas 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 Cuenta:
checking - Cuenta corrientesavings - Cuenta de ahorros
Número de Routing: Número de routing ABA de 9 dígitosValidación Valida detalles de cuenta antes de crear:
const validatePSEAccount = ( data ) => { const errors = []; // Número de cuenta (10-20 dígitos) if ( ! / ^ \d {10,20} $ / . test ( data . accountNumber )) { errors . push ( 'Formato de número de cuenta inválido' ); } // Código del banco (4 dígitos) if ( ! / ^ \d {4} $ / . test ( data . bankCode )) { errors . push ( 'Código de banco inválido' ); } // Tipo de cuenta if ( ! [ 'savings' , 'checking' ]. includes ( data . type )) { errors . push ( 'Tipo de cuenta debe ser savings o checking' ); } return errors ; };
Probando Cuentas Bancarias En sandbox, usa estos códigos de banco de prueba:
Colombia:
0001 - Bancolombia0002 - Banco de Bogotá0003 - Davivienda
México:
012 - BBVA014 - Santander072 - Banorte
Cualquier formato de número de cuenta funcionará en sandbox. Usa formatos realistas para mejores pruebas.
Próximos Pasos 
