API de emisión de tarjetas
2328 es una API de emisión de tarjetas virtuales para equipos que desean ofrecer una tarjeta de pago a sus usuarios sin convertirse en un emisor con licencia. Usted registra a los titulares de las tarjetas, emite tarjetas bajo un BIN patrocinado, las financia desde su monedero USDT y controla todo el ciclo de vida —congelar, descargar, cerrar— a través de una única interfaz REST.
Construir un programa de tarjetas de la manera tradicional significa una licencia de esquema, un BIN, un procesador, un banco patrocinador y dieciocho meses de trabajo de certificación antes de que se apruebe la primera autorización. Ese trabajo ya está hecho aquí. Lo que queda de su lado es la parte que es realmente su producto: quién obtiene una tarjeta, qué puede gastar y cómo es la experiencia.
La API es solo JSON, todos los campos están en camelCase, y cada solicitud, excepto la comprobación de estado pública, está autorizada con una clave Bearer. El dinero es siempre un número entero en unidades menores con una moneda y escala explícitas —el monedero es USDT a escala 6, las tarjetas son USD a escala 2—, por lo que nunca hay un flotante ambiguo en un libro de contabilidad.
Titulares de tarjetas
Registre a los titulares de las tarjetas con los datos de identidad que requiera el programa y luego emita una o varias tarjetas para cada uno de ellos. La incorporación, los límites y el ciclo de vida se gestionan completamente desde su lado.
Emisión instantánea de tarjetas virtuales
Las tarjetas se crean con una única llamada a la API y son utilizables inmediatamente —sin plástico, sin envío, sin paso de activación—. Emita una por usuario, por suscripción, por campaña o por proveedor.
Financiación desde un monedero USDT
Las tarjetas se financian desde su saldo de stablecoin. USDT entra a escala 6, el saldo de la tarjeta es USD a escala 2, y la API es explícita sobre ambos para que los libros de contabilidad nunca se desvíen.
Control total del ciclo de vida
Congela, descongela, descarga y cierra tarjetas programáticamente. Una tarjeta comprometida queda inoperativa con una sola solicitud; una suscripción finalizada no cuesta nada cerrarla.
Saldos y transacciones
Lee los saldos de tarjetas en tiempo real y el historial de transacciones de todo el programa, incluyendo autorizaciones, liquidaciones, denegaciones y comisiones.
Pedidos y webhooks
Las operaciones de dinero son asíncronas: envías una operación, recibes un pedido y tratas el webhook como la fuente de verdad en lugar de asumir el éxito con un 200.
Patrocinio de BIN, sin el desvío de dos años
Cada tarjeta está anclada a un BIN —el número que indica a las redes de tarjetas qué institución licenciada la respalda. Obtener el tuyo propio significa convertirse en miembro principal de Visa o Mastercard: licencia regulatoria, garantía del esquema, requisitos de capital y años de certificación.
Las tarjetas emitidas a través de 2328 funcionan con un BIN patrocinado existente. La institución patrocinadora posee la membresía del esquema y liquida con la red; tú conservas el producto, la marca, la relación con el titular de la tarjeta y la economía. En la práctica, esto convierte un proyecto de licenciamiento en un proyecto de integración.
La incorporación sigue siendo una diligencia real: se te preguntará quiénes son tus titulares de tarjetas, de dónde proviene el dinero y cómo son tu KYC y tu monitoreo. Cuanto más claras sean esas respuestas, más rápido comenzará el programa.
Cómo se desarrolla una integración
- 1.Acuerda el programa: perfil del titular de la tarjeta, flujo de financiación, geografías y límites.
- 2.Obtén las API_KEY y verifica la conectividad con el endpoint público GET /ping.
- 3.Registra a tu primer titular de tarjeta y emite una tarjeta en el entorno real.
- 4.Financia la tarjeta desde tu monedero USDT y confirma el pedido resultante a través de webhook.
- 5.Integra saldos, transacciones y operaciones de ciclo de vida en tu producto.
- 6.Lanza y escala: la emisión es una sola llamada, por lo que el volumen no es un problema de ingeniería.
Preguntas frecuentes
¿Necesito mi propia licencia o BIN para emitir tarjetas?
No. Las tarjetas se emiten bajo un BIN patrocinado existente, por lo que no necesitas convertirte en miembro principal de Visa o Mastercard. Describes a tus titulares de tarjetas y el flujo de financiación durante la incorporación; la licencia y la liquidación del esquema recaen en la institución patrocinadora.
¿Qué autenticación utiliza la API de emisión de tarjetas?
Autenticación Bearer. Cada solicitud, excepto la verificación de estado pública, lleva Authorization: Bearer ck_{keyId}_{secret}. La clave identifica tu cuenta, por lo que no se pasan IDs de comerciante o cuenta en el payload. Mantén la clave solo en tu backend.
¿Cómo se financian las tarjetas?
Desde tu monedero USDT dentro de 2328. La financiación convierte stablecoin en un saldo de tarjeta USD. El monedero es USDT a escala 6 y las tarjetas son USD a escala 2; los importes son siempre enteros en unidades menores con una moneda y escala explícitas.
¿Las operaciones con tarjetas son síncronas?
Las operaciones de dinero son asíncronas. Una solicitud de financiación o descarga devuelve un pedido que sigues hasta su finalización, y un webhook confirma el estado final. Las operaciones de lectura, como saldos y transacciones, son síncronas.
¿Existe un entorno sandbox?
Existe un único entorno real, sin claves de sandbox separadas. Un endpoint público GET /ping está disponible sin autenticación para verificaciones de actividad.
¿Para qué se pueden usar las tarjetas?
Los programas típicos cubren suscripciones en línea, gasto publicitario, gastos de empleados y contratistas, pagos a marketplaces y gastos generales de consumo financiados con criptomonedas. Los casos de uso permitidos se acuerdan durante la incorporación al programa.