Skip to main content
POST
/
api
/
v1
/
pix-keys
/
auth-code
curl -X POST 'https://app.plowf.com/api/v1/pix-keys/auth-code' \
  -H 'Authorization: Bearer seu_token_aqui' \
  -H 'Content-Type: application/json' \
  -d '{ "key": "+5511999999999" }'

{
  "message": "Código de autenticação enviado com sucesso.",
  "data": {
    "auth_code_id": "abc123xyz"
  }
}
Envia um código de verificação por SMS ou e-mail. Obrigatório antes de criar chaves do tipo PHONE ou EMAIL. 
curl -X POST 'https://app.plowf.com/api/v1/pix-keys/auth-code' \
  -H 'Authorization: Bearer seu_token_aqui' \
  -H 'Content-Type: application/json' \
  -d '{ "key": "+5511999999999" }'

​
Validações

  • Rate limit: 3 tentativas por 60 segundos por conta

​
Body Parameters

​
key
string
required
Valor da chave que receberá o código de verificação:
  • E-mail: endereço válido (ex: [email protected])
  • Telefone: número com código do país (ex: +5511999999999)
​
provider_uuid
string
UUID do provedor que enviará o código. Apenas provedores do tipo NOMINAL (conta dedicada) suportam chaves PIX — provedores POOL são rejeitados. Liste os UUIDs em GET /providers.Quando omitido, o código é solicitado ao provedor padrão de PIX da conta. Ignorado quando o token está vinculado a um provedor — o provedor do token prevalece.Use o mesmo provider_uuid na chamada subsequente a POST /pix-keys, caso contrário o auth_code_id retornado aqui não será válido.

​
Validações

  • Rate limit: 3 tentativas por 60 segundos por conta

​
Resposta de Sucesso

{
  "message": "Código de autenticação enviado com sucesso.",
  "data": {
    "auth_code_id": "abc123xyz"
  }
}
​
message
string
Mensagem de confirmação do envio
​
data
object

​
Erros Comuns