API de emissão de cartões
2328 é uma API de emissão de cartões virtuais para equipas que desejam disponibilizar um cartão de pagamento aos seus utilizadores sem se tornarem um emissor licenciado. Regista titulares de cartões, emite cartões sob um BIN patrocinado, financia-os a partir da sua carteira USDT e controla todo o ciclo de vida — congelar, descarregar, fechar — através de uma interface REST.
Construir um programa de cartões da forma tradicional significa uma licença de esquema, um BIN, um processador, um banco patrocinador e dezoito meses de trabalho de certificação antes da primeira autorização ser efetuada. Esse trabalho já está feito aqui. O que resta do seu lado é a parte que é realmente o seu produto: quem recebe um cartão, o que pode gastar e como é a experiência.
A API é apenas JSON, todos os campos são camelCase, e cada pedido, exceto a verificação de saúde pública, é autorizado com uma chave Bearer. O dinheiro é sempre um número inteiro em unidades menores com uma moeda e escala explícitas — a carteira é USDT na escala 6, os cartões são USD na escala 2 — para que nunca haja um valor flutuante ambíguo num livro-razão.
Titulares de cartões
Registe os titulares de cartões com os dados de identidade exigidos pelo programa e, em seguida, emita um ou vários cartões para cada um deles. O onboarding, os limites e o ciclo de vida são totalmente geridos do seu lado.
Emissão instantânea de cartões virtuais
Os cartões são criados por uma única chamada de API e são utilizáveis imediatamente — sem plástico, sem envio, sem etapa de ativação. Emita um por utilizador, por subscrição, por campanha ou por fornecedor.
Financiamento a partir de uma carteira USDT
Os cartões são financiados a partir do seu saldo de stablecoin. O USDT entra na escala 6, o saldo do cartão é USD na escala 2, e a API é explícita sobre ambos para que os livros-razão nunca se desviem.
Controlo total do ciclo de vida
Congele, descongele, descarregue e feche cartões programaticamente. Um cartão comprometido é desativado numa única solicitação; uma subscrição terminada não tem custos para ser encerrada.
Saldos e transações
Leia os saldos de cartões em tempo real e o histórico de transações em todo o programa, incluindo autorizações, liquidações, recusas e taxas.
Pedidos e webhooks
As operações monetárias são assíncronas: envia uma operação, recebe um pedido e trata o webhook como a fonte de verdade, em vez de assumir o sucesso com um 200.
Patrocínio BIN, sem o desvio de dois anos
Cada cartão está ancorado a um BIN — o número que indica às redes de cartões qual a instituição licenciada que o suporta. Obter o seu próprio significa tornar-se um membro principal da Visa ou Mastercard: licença regulamentar, garantia do esquema, requisitos de capital e anos de certificação.
Os cartões emitidos através da 2328 funcionam com um BIN patrocinado existente. A instituição patrocinadora detém a adesão ao esquema e liquida com a rede; você mantém o produto, a marca, o relacionamento com o titular do cartão e a economia. Na prática, isso transforma um projeto de licenciamento num projeto de integração.
O onboarding ainda exige diligência real — ser-lhe-á perguntado quem são os seus titulares de cartão, de onde vem o dinheiro e como são os seus processos de KYC e monitorização. Quanto mais claras forem essas respostas, mais rápido o programa começa.
Como decorre uma integração
- 1.Acorde o programa: perfil do titular do cartão, fluxo de financiamento, geografias e limites.
- 2.Obtenha as chaves da API e verifique a conectividade com o endpoint público GET /ping.
- 3.Registe o seu primeiro titular de cartão e emita um cartão no ambiente de produção.
- 4.Financie o cartão a partir da sua carteira USDT e confirme o pedido resultante via webhook.
- 5.Integre saldos, transações e operações de ciclo de vida no seu produto.
- 6.Entre em produção e escale — a emissão é uma única chamada, portanto, o volume não é um problema de engenharia.
Perguntas frequentes
Preciso da minha própria licença ou BIN para emitir cartões?
Não. Os cartões são emitidos sob um BIN patrocinado existente, pelo que não precisa de se tornar um membro principal da Visa ou Mastercard. Descreve os seus titulares de cartão e o fluxo de financiamento durante o onboarding; o licenciamento e a liquidação do esquema ficam com a instituição patrocinadora.
Que autenticação a API de emissão de cartões utiliza?
Autenticação Bearer. Cada solicitação, exceto a verificação de saúde pública, inclui Authorization: Bearer ck_{keyId}_{secret}. A chave identifica a sua conta, pelo que não são passados IDs de comerciante ou de conta no payload. Mantenha a chave apenas no seu backend.
Como são financiados os cartões?
A partir da sua carteira USDT dentro da 2328. O financiamento converte stablecoin num saldo de cartão USD. A carteira é USDT com escala 6 e os cartões são USD com escala 2 — os valores são sempre inteiros em unidades menores com uma moeda e escala explícitas.
As operações de cartão são síncronas?
As operações monetárias são assíncronas. Uma solicitação de financiamento ou descarregamento retorna um pedido que você acompanha até à conclusão, e um webhook confirma o estado final. Operações de leitura, como saldos e transações, são síncronas.
Existe um ambiente de sandbox?
Existe um único ambiente de produção — sem chaves de sandbox separadas. Um endpoint público GET /ping está disponível sem autenticação para verificações de liveness.
Para que podem ser usados os cartões?
Os programas típicos abrangem subscrições online, gastos com publicidade, despesas de funcionários e contratados, pagamentos de marketplace e gastos gerais de consumo financiados com cripto. Os casos de uso permitidos são acordados durante o onboarding do programa.