Endpoints em resumo
| Endpoint | Autenticação | Para que serve |
|---|---|---|
POST /v1/payments | chave secreta | Criar um pagamento com cartão ou carteira |
POST /v1/pay | — | Criar um pagamento sem conta (com uma carteira de recebimento) |
POST /v1/crypto/payments | chave secreta | Criar um pagamento em cripto |
POST /v1/crypto/pay | — | Pagamento em cripto sem conta |
GET /v1/payments/:id | chave secreta | Status do pagamento |
GET /v1/payments | chave secreta | Lista de pagamentos |
GET /v1/providers | — | Métodos de pagamento disponíveis para um valor e uma moeda |
GET /v1/crypto/coins | — | Moedas, redes e mínimos do gateway cripto |
GET /v1/currencies | — | Moedas fiduciárias aceitas |
A referência completa, com todos os campos, erros e exemplos, está na documentação da API.
Criar um pagamento
Envie o valor e a moeda; opcionalmente fixe um método com provider (por exemplo stripe para cartões e Apple Pay, paypal, revolut ou transak para UPI). Redirecione o comprador para checkout_url.
curl -X POST https://api.utopay.app/v1/payments \
-H "Authorization: Bearer utopay_sk_live_..." \
-H "content-type: application/json" \
-d '{ "amount": 49.90, "currency": "EUR", "description": "Order #1042",
"success_url": "https://shop.example/thanks" }'
# → { "id": "ord_…", "status": "pending",
# "checkout_url": "https://api.utopay.app/pay/ord_…" }
Confirmar com webhooks
Registre um endpoint no painel. A UTOPAY envia payment.succeeded, payment.underpaid, payment.expired e payment.failed com o cabeçalho x-utopay-signature (HMAC-SHA256 sobre o timestamp e o corpo original). As novas tentativas duram cerca de sete horas. Há exemplos de verificação em Node.js, PHP e Python na documentação de webhooks.
Opções sem código e com pouco código
- Links de pagamento: crie um link no painel e compartilhe, sem nenhum código. Veja os links de pagamento.
- Plugins para CMS: WooCommerce, WHMCS, OpenCart, PrestaShop, MODX, Easy Digital Downloads, Paid Memberships Pro e Tilda. Veja os plugins.
- Modo de teste: chaves de teste criam pedidos sem dinheiro real, e você pode simular status pelo painel.
Atualizado · Equipe UTOPAY