Usuário

Registrar usuário

Cria uma nova conta na p1v Wallet e retorna a API Key gerada. Guarde-a com segurança — não é possível recuperá-la.

POST/user/register

Parâmetros do body

Campo	Tipo	Req.	Descrição
name	string	Required	Nome completo do titular
email	string	Required	E-mail único da conta
pixKey	string	Required	Chave PIX para saques automáticos
pixKeyType	string	Required	`CPF`, `CNPJ`, `EMAIL`, `PHONE` ou `RANDOM`
taxID	string	Optional	CPF ou CNPJ sem pontuação
phone	string	Optional	Telefone com DDD
webhookUrl	string	Optional	URL HTTPS para receber eventos

request

curl -X POST https://api.piv.lol/api/v1/user/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "João Silva",
    "email": "joao@empresa.com",
    "pixKey": "joao@empresa.com",
    "pixKeyType": "EMAIL",
    "taxID": "12345678901",
    "webhookUrl": "https://meusite.com/webhook"
  }'

response 201

{
  "success": true,
  "message": "Usuário registrado com sucesso",
  "data": {
    "id": "reg_abc123",
    "apiKey": "vp_xxxxxxxxxxxxxxxxxxx",
    "name": "João Silva",
    "email": "joao@empresa.com",
    "pixKey": "joao@empresa.com",
    "pixKeyType": "EMAIL",
    "balance": 0,
    "paymentFee": 50,
    "message": "Guarde sua API Key em local seguro!"
  }
}