POST /v1/payments
Do QR code ao saldo em segundos.
Cobranças PIX, cartão e boleto em uma API. Webhook assinado a cada mudança de status, extrato com saldo por lançamento e saque por PIX direto do saldo.
POST /v1/payments
Uma cobrança. Três meios de pagamento.
A mesma chamada cria PIX, cartão ou boleto — no modo headless, com os dados do meio na resposta, ou no checkout hospedado, com a escolha no navegador.
Cobre. POST /v1/payments com chave de idempotência obrigatória. A resposta traz QR code e copia e cola, linha digitável ou o status da autorização.
Concilie. Doze eventos de webhook assinados com HMAC e retentativas exponenciais. Extrato com o saldo após cada lançamento.
Saque. Transferência PIX para chave CPF, CNPJ, e-mail, telefone ou aleatória, com cada status reportado por webhook.
Checkout pronto ou headless — por cobrança.
O campo mode decide: hosted devolve uma URL de pagamento; headless devolve os dados do meio para a sua interface.
Finalizar pagamento
R$ 149,90
Escaneie para pagar
Checkout hospedado. mode: hosted devolve uma URL em checkout.yuvexpay.com. O pagador escolhe o meio, e a cobrança avança por webhook — sem front seu no caminho.
/pl/loja-verao-24
/pl/doacao-aberta
Links de pagamento. Valor fixo ou aberto com mínimo e máximo, meios habilitados por link, expiração e repasse de taxa ao pagador — criados no dashboard, sem código.
Preço por transação. Nada por existir.
Sem mensalidade e sem setup. As taxas abaixo são o padrão da plataforma — cada conta tem a sua tabela, e volume negocia.
PIX
4,99% + R$ 0,20
por recebimento, líquido no saldo em D+0
Cartão de crédito
4,99% + R$ 0,60
à vista, com pré-autorização opcional
Boleto
R$ 2,99
fixo por boleto liquidado
api.yuvexpay.com
Uma API previsível. Idempotência obrigatória em toda escrita, erros com código estável e chaves com escopo por operação.
create-payment.js
const response = await fetch("https://api.yuvexpay.com/v1/payments", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.YUVEX_API_KEY}`,
"Content-Type": "application/json",
"X-Idempotency-Key": "order-1234-attempt-1",
},
body: JSON.stringify({
amount: 49.90,
methods: ["PIX"],
currency: "BRL",
mode: "headless",
description: "Order #1234",
externalId: "order-1234",
expiresInMinutes: 30,
customer: {
name: "Pedro Álvares Cabral",
email: "[email protected]",
},
}),
});
const { payment } = await response.json();resposta
{
"payment": {
"id": "5d0f8b6e-3a02-4f5b-9e1c-7c6a4a1b8c9d",
"txId": "PAY3f2a8b9c4e6d1f5a7b3c8d2e9f4a6b1c",
"amount": 49.90,
"feeAmount": 2.99,
"netAmount": 46.91,
"status": "NEW",
"paymentMethod": "PIX",
"currency": "BRL",
"description": "Order #1234",
"expiresAt": "2026-05-03T15:00:00.000Z",
"createdAt": "2026-05-03T14:30:00.000Z",
"methodData": {
"type": "PIX",
"pixCopyPaste": "00020126...",
"qrCodeBase64": "data:image/png;base64,...",
"qrCodeUrl": null
}
}
}