Pagamentos PIX

Criar cobrança PIX

Gera um QR Code PIX para receber pagamento. A taxa de serviço é deduzida automaticamente do valor recebido. Limite de R$ 1.000,00 por transação.

POST/payment/createAPI Key

Parâmetros do body

Campo	Tipo	Req.	Descrição
value	number	Required	Valor em reais. Ex: `100` = R$ 100,00. Mínimo: R$ 1,00
description	string	Optional	Descrição interna da cobrança
coverFee	boolean	Optional	Se `true`, o valor informado é o líquido desejado e a taxa é adicionada ao QR Code
splitUser	string	Optional	E-mail de outro usuário para dividir o pagamento
splitTax	number	Optional	Porcentagem (0.01–100) enviada ao `splitUser`

coverFee: por padrão, o value é o total do QR Code (taxa é descontada na chegada). Com coverFee: true, o value é o que você recebe líquido e a taxa é somada ao QR Code.

request

curl -X POST https://api.piv.lol/api/v1/payment/create \
  -H "X-API-Key: vp_sua_key" \
  -H "Content-Type: application/json" \
  -d '{
    "value": 100,
    "description": "Pedido #1234",
    "coverFee": false
  }'

response 201

{
  "success": true,
  "message": "Transação criada com sucesso",
  "data": {
    "id": "pay_xyz789",
    "transactionId": "txn_mistic_123",
    "value": 10000,
    "netValue": 9950,
    "fee": 50,
    "status": "PENDING",
    "qrcodeUrl": "data:image/png;base64,...",
    "copyPaste": "00020126...",
    "createdAt": "2025-05-14T10:00:00.000Z"
  }
}