Transferências

Transferência Interna

Transfira saldo entre contas p1v Wallet instantaneamente, sem taxa e sem limites definidos.

POST/transfer/internalAPI Key

Parâmetros do body

Campo	Tipo	Req.	Descrição
email	string	Required	E-mail da conta p1v de destino
amount	number	Required	Valor em reais a transferir
description	string	Optional	Descrição da transferência

Transferências internas são instantâneas e sem custo. O destinatário deve ser um usuário p1v ativo. Não é possível transferir para si mesmo.

request

curl -X POST https://api.piv.lol/api/v1/transfer/internal \
  -H "X-API-Key: vp_sua_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "parceiro@empresa.com",
    "amount": 500,
    "description": "Comissão mensal"
  }'

response 201

{
  "success": true,
  "message": "Transferência realizada com sucesso",
  "data": {
    "id": "trf_def789",
    "amount": 50000,
    "recipientEmail": "parceiro@empresa.com",
    "status": "COMPLETED",
    "createdAt": "2025-05-14T12:00:00.000Z"
  }
}