DOCUMENTAÇÃO

Construa com a rostopay

Um único SDK para checkout facial e Pix instantâneo, links de pagamento hospedados para quem não quer código, e uma API REST simples por baixo. Rostos de sandbox e bancos de teste inclusos.

$ npm i @rostopay/checkout

Comece agora →

COMECE AGORA

Crie uma sessão, monte o botão

Uma sessão define o valor, o modo de liquidação e o nível de verificação. Monte o botão em qualquer lugar; nós abrimos a câmera, rodamos a prova de vida e o reconhecimento, movimentamos o dinheiro e depois redirecionamos para seu return_url com o id da transação.

✓

          
          
          
        
// 1 · servidor: cria a sessão
const session = await rostopay.sessions.create({
amount: 4690, currency: 'brl',
settlement: 'instant', verify: 'face+liveness',
return_url: 'https://yourstore.com/thanks'
});
// 2 · cliente: monta o botão oficial
rostopay.mount('#pay', { session: session.id });
// 3 · webhook
payment.settled → { tx_hash, sieve_id, amount, reg }

SEM CÓDIGO · LINKS DE PAGAMENTO

Todo QR e link é apenas uma URL

Cobranças dinâmicas, QRs fixos, telas de drive-thru e links por SMS levam todos à mesma página de pagamento hospedada — com checkout facial incluído, sem precisar de integração.

{{ l.url }}

{{ l.title }} — {{ l.body }}

Parâmetros: amt valor em centavos · tip gorjeta opcional em centavos · reg id do caixa · ref referência livre (ex.: ticket de manobrista).

REFERÊNCIA DA API

REST, versionada e previsível

URL base api.rostopay.com/v1. Autentique com sua chave secreta; use chaves de sandbox para simular rostos, bancos e todos os estados de pagamento — saldo insuficiente, recusado, retenção por risco, resfriamento para valores altos.

Webhooks: payment.settled · payment.pending · payment.failed · claim.opened · payout.reconciled — assinados com o segredo do seu endpoint.

Todo pagamento é comprovável por hash

sieve_id + tx_hash → verify.rostopay.com

Obter chaves de API Para lojistas

Explore a rostopay

Pix instantâneo, checkout biométrico e recursos de pagamento facial.