BITCOIN

Reais entram por Pix, sai bitcoin

Uma chamada converte reais em bitcoin e entrega na rede que você escolher. Lightning para pagamento imediato, on-chain para liquidação, Liquid para transferência de ativo. Sem saldo interno no meio.

PixPix
BitcoinBitcoin
LightningLightning
LiquidLiquid

Comprar bitcoin com Pix, por API

É converter reais em bitcoin numa chamada e entregar o ativo direto num endereço. O Pix entra, a conversão acontece, e o bitcoin sai na rede que você escolheu para o destino que você indicou.

A diferença em relação a comprar numa exchange é o destino. Aqui não existe saldo interno intermediário esperando saque: a entrega é o próprio passo final da operação.

  • Entrada em reais por Pix, disponível 24 horas por dia.
  • Entrega em Lightning, on-chain ou Liquid.
  • Destino é um endereço que você indica, não um saldo interno.
  • Sem depender de horário bancário.

Do Pix ao bitcoin entregue

Três etapas, e a única decisão sua é a rede de entrega.

  1. 1Escolher a rede. Lightning para pagamento imediato, on-chain para liquidação em bloco, Liquid para transferência de ativo.
  2. 2Disparar a operação. O deposit-asset recebe o valor em reais e o endereço de destino.
  3. 3Entrega e confirmação. O bitcoin chega no endereço indicado, e o webhook assinado com HMAC avisa a mudança de estado.

Três trilhos, uma integração

Cada rede resolve um problema diferente, e a escolha é por operação, não por contrato. Lightning entrega em pagamento instantâneo e de baixo custo. On-chain entrega liquidação na rede base do Bitcoin. Liquid entrega transferência de ativo em sidechain.

Bitcoin on-chainBitcoin on-chain
LightningLightning
LiquidLiquid
PixPix

A chamada de entrada

O mesmo endpoint que converte reais em bitcoin converte em USDT, USDC e USDCE. A rede e o ativo de destino são parâmetro, não integração separada.

  • deposit-asset — converte reais e entrega no endereço indicado.
  • Ativos de destino: Lightning, USDT, USDC e USDCE.
  • Webhook assinado com HMAC em cada mudança de estado.
  • Guia em docs.hodle.com.br/docs/deposit-asset.

KYC faz parte do trilho

A verificação de identidade do usuário final é uma chamada da própria API, não um processo paralelo. Submeter e consultar o estado do KYC são operações documentadas, e a entrada e saída de valores dependem dele.

Isso é escolha de produto. Um trilho que converte reais em ativo digital carrega obrigação de identificação, e resolver isso dentro da API é mais simples do que costurar um fornecedor separado.

  • Submissão e consulta de KYC pela mesma API.
  • Comprovante de endereço e de capacidade financeira documentados.
  • Entrada e saída de valores dependem do KYC do usuário.

Perguntas frequentes

Tire suas dúvidas sobre comprar bitcoin com Pix por API.

Como comprar Bitcoin com Pix por API?

Você dispara a operação de deposit-asset informando o valor em reais e o endereço de destino, e escolhe se a entrega é em Lightning, on-chain ou Liquid. O bitcoin chega no endereço indicado e o webhook assinado avisa a conclusão.

Em qual rede o Bitcoin é entregue?

Na que você escolher: Lightning, on-chain ou Liquid. A rede é parâmetro da operação, então dá para variar por caso de uso sem mudar a integração.

Dá para entregar no endereço do meu usuário final?

Sim, e é o desenho pretendido. A entrega é num endereço que você indica, sem saldo interno intermediário esperando saque. As chaves do endereço de destino não ficam com a Hodle.

Qual a taxa?

A taxa de serviço está publicada na página de preços, que é a única fonte oficial. Qualquer valor citado fora dela deve ser conferido antes de ser considerado válido.

Precisa de KYC?

Sim. A verificação de identidade do usuário final é exigida para operações de entrada e saída, e é feita pela própria API, com submissão e consulta de estado documentadas.

Pronto para começar?

Comece pela documentação ou fale com o time da Hodle.