# LovinPay > Infraestrutura de pagamentos Pix para o Brasil. A LovinPay permite criar > cobranças Pix (cash-in), enviar saques Pix (cash-out), consultar saldo e > receber confirmações por webhook assinado — tudo por uma API REST, com > valores em reais e idempotência de ponta a ponta. Site: https://lovinpay.com.br Painel: https://app.lovinpay.com.br Documentação: https://docs.lovinpay.com.br API (base URL): https://api.lovinpay.com.br ## Como integrar (resumo) 1. Crie uma chave de API no painel e defina os escopos. 2. Autentique cada requisição com o cabeçalho `X-API-Key: ` (ou `Authorization: Bearer `). 3. Valores monetários são números em reais (ex.: 25.94 = R$ 25,94). Moeda: BRL. 4. Use o cabeçalho `Idempotency-Key` ao criar pagamentos e saques para evitar duplicidade em retries. 5. Limite de uso: 60 requisições por minuto por chave (429 RATE_LIMITED). 6. Erros têm o formato: {"error":{"code","message","requestId"}}. ## Endpoints Pagamentos (Pix de entrada): - POST /v1/payments — cria cobrança. Corpo: {amount (reais), identification, validityMinutes, payer:{name, document}}. Retorna pixCode e qrCodeImage. - GET /v1/payments/{id} — consulta. - GET /v1/payments?status=&limit=&offset= — lista. Saques (Pix de saída): - POST /v1/payouts — cria saque. Corpo: {amount, pixKey, pixKeyType (cpf|cnpj|email|phone|random), beneficiaryName}. A taxa é somada: debita amount+fee do saldo. Sem saldo: 409 INSUFFICIENT_BALANCE. - GET /v1/payouts/{id} — consulta. - GET /v1/payouts — lista. - GET /v1/payouts/{id}/receipt — comprovante (endToEndId). Conta: - GET /v1/balance — availableBalance, reservedBalance, currency. - GET /v1/account — dados da conta e saldos. - GET /v1/account/fees-limits — taxas de depósito/saque e limites. - GET /v1/status — estado operacional. Transações: - GET /v1/transactions?type=deposit|withdrawal&status=&limit=&offset= — lista. - GET /v1/transactions/{id} — consulta. ## Webhooks A LovinPay envia POST para a URL cadastrada quando uma transação muda de estado (ex.: payment.paid). Cabeçalhos: - X-Kyvopay-Signature: HMAC-SHA256 (hex) de "timestamp.corpo". - X-Kyvopay-Timestamp: unix time do envio. - X-Kyvopay-Delivery: id único da entrega (use para deduplicar). Corpo: {"event":"payment.paid","data":{...},"sentAt":"..."}. Valide a assinatura recomputando o HMAC com o seu segredo sobre `timestamp + "." + corpo_bruto` e comparando em tempo constante. ## Escopos de chave payments:create, payments:read, payouts:create, payouts:read, balance:read, account:read, transactions:read. ## Observações - Ambientes: homologação (testes, sem dinheiro real) e produção. - Compatível com o padrão de mercado de gateways Pix: quem já integra um gateway nesse padrão troca apenas a base URL e a chave.