Pagamentos PIX

Enviar PIX

Envia um PIX para qualquer chave PIX usando o saldo disponível na conta. Exclusivo para API Key — não funciona com JWT.

POST/payment/sendAPI Key

Operação irreversível. O saldo é debitado imediatamente antes do envio. Se a transferência falhar, o saldo é estornado automaticamente.

Parâmetros do body

Campo	Tipo	Req.	Descrição
amount	number	Required	Valor em reais a enviar. Taxa é descontada do total.
pixKey	string	Required	Chave PIX do destinatário
pixKeyType	string	Required	`CPF`, `CNPJ`, `EMAIL`, `PHONE`, `RANDOM`
description	string	Optional	Descrição interna do envio

request

curl -X POST https://api.piv.lol/api/v1/payment/send \
  -H "X-API-Key: vp_sua_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50,
    "pixKey": "cliente@email.com",
    "pixKeyType": "EMAIL",
    "description": "Reembolso pedido #99"
  }'

response 200

{
  "success": true,
  "message": "Envio processado com sucesso",
  "data": {
    "amount": 5000,
    "fee": 50,
    "sent": 4950,
    "destination": "cliente@email.com"
  }
}