Cash-out
Envie PIX do seu saldo para qualquer chave, com proteção contra envio duplicado.
POST /api/v1/gateway/pix-payment debita o valor e a tarifa do seu saldo e envia um PIX para a chave informada. A resposta é imediata (status: "processing"); o resultado chega no callbackUrl.
Antes do primeiro saque, ligue Saque pela API em Desenvolvedores no painel. Sem liberação da WeetPay, o destino precisa ser a chave CPF/CNPJ do próprio titular. Veja Limites e regras.
Tipos de chave
typeKey | key | document |
|---|---|---|
CPF | 11 dígitos | o mesmo CPF da chave |
CNPJ | 14 dígitos | o mesmo CNPJ da chave |
EMAIL | CPF/CNPJ do titular da chave | |
PHONE | celular com DDD (ex.: 11999998888 ou +5511999998888) | CPF/CNPJ do titular da chave |
EVP | chave aleatória (UUID) | CPF/CNPJ do titular da chave |
Fluxo
- Gere e guarde uma
Idempotency-Keypara o pagamento (Idempotência). - Chame Enviar PIX. Em erro de rede ou
5xx, repita com a mesma chave. - O saque fica
PROCESSING(análise da operação, quando aplicável, e envio ao banco). - O
callbackUrlrecebestatus: "sucess"com oendToEnd, oustatus: "not paid"com o motivo emmessage— nesse caso valor e tarifa voltam ao saldo.
Status do saque
processingStatus (consulta) | Callback status | Significado |
|---|---|---|
PROCESSING | — | em análise ou enviado ao banco |
PAID_OUT | sucess | pago |
NOT_PAID | not paid | recusado ou falhou; estornado |