Priem
Entrar Começar

Aceitação de pagamentos — cripto e cartão

Seu cliente paga como quiser. Você recebe exatamente o que pediu.

No checkout o comprador escolhe qualquer moeda e rede — bitcoin, ether, USDT, USDC — ou paga com um cartão comum. Você é creditado na moeda que definiu. O link de pagamento entra no seu site sem uma linha de código; a API só é necessária quando o valor vem do carrinho.

Começar Documentação

1,5% por pagamento. O painel abre na hora; a aceitação começa depois da análise.

  1. 01CompradorPaga com moeda ou cartão no seu checkout
  2. 02RedeA transferência aparece e junta confirmações
  3. 03CâmbioO recebido é trocado pela sua moeda
  4. 04Seu saldoEstado settled: pode despachar

01 / Conexão

Dois caminhos, e eles não se excluem

Um botão com link resolve a maioria dos casos. A API é para quando o preço é calculado do seu lado.

Sem código

Etiqueta de preço

Você cria no painel, copia o link e coloca como botão no site. O preço é fixo ou digitado pelo próprio comprador.

A etiqueta pode ser reutilizável — para um item do catálogo, ou de uso único — para a cobrança de uma pessoa específica. A de uso único se fecha no instante em que o primeiro comprador segue para o pagamento: dois que abriram o link ao mesmo tempo não pagarão duas vezes pelo mesmo item.

<a href="https://api.priem.io/pay/SUA-ETIQUETA">
  Pagar com criptomoedas
</a>

Quando o valor vem do carrinho

API

Seu servidor cria o pagamento no valor necessário e leva o comprador ao link recebido. O projeto é identificado pela chave, então não é preciso nomeá-lo no corpo.

POST https://api.priem.io/v1/payments
Authorization: Bearer priem_…

{
  "amount": "49.00",
  "currency": "USD",
  "idempotencyKey": "order-12345"
}

Tire a chave de idempotência do número do pedido, não do relógio nem do acaso. Repetir a requisição com a mesma chave devolve o mesmo pagamento em vez de emitir uma segunda cobrança. Uma chave feita com Date.now() não protege de nada.

O pagamento no cartão funciona no mesmo checkout e não exige configuração sua. O comprador compra bitcoin do provedor, ele cai direto no endereço da cobrança e o pagamento corre como qualquer outro.

O mínimo no cartão é 10 dólares. Abaixo disso o botão nem aparece, e o comprador é informado do motivo.

02 / Dinheiro

Quanto custa — por inteiro

São três taxas e só uma é nossa. As outras duas quem cobra é a rede, e nós as mostramos aqui, não depois que você se cadastra.

Para nós, por pagamento

1,5%

Retida no crédito e visível no callback como campo próprio.

Para a rede, no saque

~1 USDT

Fixa na TRON, paga por você. Acumular e sacar de uma vez sai mais barato que pagamento a pagamento.

Para a rede, no pagamento

Paga o comprador

Acima do seu preço. Não acompanha o valor, então num pedido pequeno ela aparece.

O acréscimo de rede que o comprador vê antes de confirmar
Paga comPedido $5Pedido $30Pedido $100
USDT na BSC+1,3%+0,5%+0,3%
USDT na TON+9,3%+1,8%+0,8%
USDT na TRON+16,3%+3,0%+1,1%
USDT na Ethereum+19,5%+3,5%+1,3%

Ressalva Vender por menos de 10 dólares em cripto é difícil. Num pedido de três dólares até uma rede barata come uma fatia visível, e TRON ou Ethereum somam um quarto do preço. Se seus planos são pequenos, venda em pacotes. Dizemos isso antes de você conectar, não depois dos primeiros pedidos abandonados.

03 / Desenvolvedores

Uma integração de uma noite

Criar o pagamento, esperar o callback, conferir a assinatura, despachar no settled. Nada além disso.

Manipulador do callback · Node
// corpo bruto, antes de parsear o JSON:
// a assinatura é calculada sobre os bytes
const expected = createHmac('sha256', secret)
  .update(`${timestamp}.${rawBody}`)
  .digest('hex');

if (!timingSafeEqual(a, b)) return res.sendStatus(401);

markOrderPaid(event.paymentId, event.creditedAmount);
res.sendStatus(200);
  • Assinatura — HMAC-SHA256 de {timestamp}.{corpo}, cabeçalhos X-Priem-Timestamp e X-Priem-Signature.
  • Reenvios — sete tentativas em um dia e meio: após um minuto, 5 minutos, 30 minutos, 2 horas, 6 horas e um dia.
  • Consulta — GET /v1/payments/{id} devolve sempre o estado atual. Não convém depender só do callback.

Estados do pagamento

  • createdCriado, moeda ainda não escolhida
  • awaiting_paymentMoeda escolhida, aguardando a transferência
  • onramp_pendingPaga no cartão, compramos cripto
  • detectedTransferência visível na rede
  • confirmingJuntando confirmações
  • convertingTrocando pela sua moeda
  • settledO dinheiro está no seu saldo
  • underpaidChegou menos que o devido
  • expiredA cobrança venceu
  • refundedDevolvido ao comprador

Despache o pedido pelo settled e por mais nada.

04 / Confiabilidade

O que acontece enquanto você vende

O trabalho que não se vê do painel, e cuja ausência é o que faz perder dinheiro.

Conciliação noturna

Toda noite fechamos tudo o que devemos aos lojistas contra o que de fato está no provedor. Uma falta interrompe os saques automaticamente — até ser esclarecida, não até de manhã.

Um dia para endereços de saque

Um endereço novo de carteira fica disponível um dia depois de adicionado. É a única coisa entre um painel roubado e um saldo zerado. Incomoda exatamente uma vez.

Pagamento a menor por nossa conta

A cotação mexeu, a carteira reteve o dela — chegou um pouco menos. Dentro da tolerância (1% por padrão) o pagamento fecha assim mesmo e você recebe o valor cheio da etiqueta. A diferença é nossa.

Registro e bloqueio

Entradas, chaves, endereços, saques e etiquetas vão para um registro ordenado por número corrido. Cinco tentativas de login malsucedidas bloqueiam a conta por quinze minutos.

05 / Antes de decidir

Vale saber de antemão

A aceitação não liga na hora
O painel abre no momento do cadastro, mas receber pagamentos começa depois de uma análise do negócio — ela leva de algumas horas para cima. Não é burocracia: o dinheiro dos seus clientes passa pela nossa conta no provedor, e responder por quem vende através de nós cabe a nós. Projeto, chaves, callback e etiquetas você já pode configurar; a aceitação liga sozinha, sem nada da sua parte.
A rede do endereço de saque é obrigatória
USDT na TRON e USDT na BSC são endereços diferentes. Enviar para a rede errada perde o dinheiro em definitivo, e ninguém consegue trazê-lo de volta.
Faça o primeiro pagamento real de $20–30
Não de dois dólares: nesse valor a taxa de rede acrescenta uns quarenta por cento e você vai concluir que algo quebrou. Não quebrou — uma taxa fixa num pedido minúsculo simplesmente parece absurda.
A chave de API é mostrada uma vez
Não há de onde recuperá-la — só emitir uma nova e revogar a antiga. Guarde no servidor: no navegador ela cria pagamentos em seu nome.
O painel e a documentação estão em russo
Esta página é traduzida; o painel, o checkout e a documentação seguem só em russo. Se isso atrapalha, avise no cadastro — a fila de tradução é ordenada por quem ela está segurando.

Priem.
Na escuta?

O cadastro leva um minuto e a configuração meia hora, e quase todo esse tempo vai para o manipulador do callback.

Começar Ler a documentação