YooBank — documentação pública
YooBank (YooCheckout) é infraestrutura de pagamento cripto / payment gateway.
Documentação oficial: https://docs.yoobank.net
Produção:
- API:
https://api.yoobank.net - Hosted Checkout e área do merchant:
https://pay.yoobank.net - Login merchant:
https://pay.yoobank.net/merchant/login
Este conjunto descreve o produto já operacional. Não documenta PIX, settlement, payout, banking, BAAS, subadquirência, split, assinaturas, marketplace nem FX automático.
Preços comerciais ainda não estão publicados.
Modelos de uso
YooBank suporta três modelos. Escolha um; não misture requisitos.
Modelo A — Zero-code Hosted Checkout
O merchant faz login, cria um checkout/link, partilha o URL pay.yoobank.net e acompanha o estado. O pagador usa a experiência hospedada pela YooBank.
Não precisa de:
- integração API
- webhook
- credencial de máquina
- migração de base de dados
- plugin
- programador
Ainda precisa de conta merchant pronta a receber (activo + perfil + política PAY-IN + carteira/allocator + pelo menos um par asset/rail Ready).
Modelo B — API + Yoo Hosted Checkout
O sistema do merchant cria ou gere fluxos pela API quando necessário, e usa a experiência de pagamento hospedada pela YooBank quando isso fizer sentido para o pagador.
Webhook é opcional.
Modelo C — Integração API completa
O merchant constrói o próprio checkout/UI e consome a API YooBank directamente (criar / ler / listar PAY-IN).
Webhook é opcional, mas recomendado se o merchant precisa de notificação push. A verdade financeira continua a ser o PAY-IN canónico na API.
Índice
| Documento | Conteúdo |
|---|---|
| QUICKSTART.md | Arranque em 5 minutos (zero-code) |
| HOSTED-CHECKOUT.md | Guia YooCheckout |
| API.md | Referência da API pública merchant |
| AUTHENTICATION.md | Credencial de máquina |
| PAYIN.md | Ciclo de vida PAY-IN |
| ASSETS.md | Activos e redes suportados |
| WEBHOOKS.md | Integração webhook |
| ERRORS.md | Erros HTTP |
| SECURITY.md | Checklist de segurança |
| PHP-EXAMPLES.md | Exemplos cURL / PHP |
Contrato OpenAPI (plataforma + PAY-IN): referência interactiva (https://docs.yoobank.net/openapi/). A API de produção é https://api.yoobank.net.
Arquitectura financeira (visão merchant)
A YooBank coordena a infraestrutura de pagamento e a observação on-chain. O merchant retém o controlo das chaves da carteira (modelo não-custodial de PAY-IN). A YooBank não detém os fundos do merchant nem liquida saldos fiat.
O Hosted Checkout não é um segundo motor de pagamento. A verdade financeira é sempre o PAY-IN canónico.
GET de um checkout não cria PAY-IN. O PAY-IN materializa-se só quando o pagador inicia o pagamento (POST /c/{token}/start) ou quando a API cria um intent (Modelo C).