URL: POST https://seu-dominio.com/v2/pix/payment Autenticação: Authorization: Bearer {access_token}

Corpo (JSON)

CampoTipoObrigatórioDescrição
amountnumbersimValor do PIX (> 0)
creditPartyobjectsimDestino
creditParty.namestringsimNome do recebedor
creditParty.keyTypestringsimEx.: EMAIL, CPF, CNPJ, PHONE, EVP
creditParty.keystringsimChave PIX
creditParty.taxIdstringsimCPF/CNPJ
external_idstringnãoReferência (senão gerado)
descriptionstringnãoDescrição
postbackUrlstring (URL)nãoWebhook do envio

Regras NavePay

  • Exige saldo interno suficiente para valor + taxa de saque.
  • Pode haver limite diário de saque configurado na plataforma.

Erros comuns (422)

  • Saldo insuficiente (detalhes de available_balance, required_debit, fee_amount).
  • Limite diário excedido.

Exemplo

curl -s -X POST "https://seu-dominio.com/v2/pix/payment" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25.00,
    "creditParty": {
      "name": "Fulano",
      "keyType": "EMAIL",
      "key": "fulano@email.com",
      "taxId": "00000000191"
    }
  }'