Skip to main content
Para mais detalhes sobre o endpoint e a descrição completa de todos os campos do body, consulte a referência do endpoint.

​
Visão Geral

Esta receita mostra como criar uma transferência PIX e receber a confirmação de liquidação automaticamente via webhook, sem precisar consultar a API repetidamente. O fluxo completo:
  1. Criar a transferência PIX
  2. Receber e processar o evento TRANSFER (ver página dedicada)

​
Pré-requisitos

  • Token de autenticação da API (ver autenticação)
  • Chave PIX do destinatário: CPF (52998224725), CNPJ (12345678000100), e-mail ([email protected]), telefone (+5511999999999) ou chave aleatória (UUID)
  • Webhook configurado para receber eventos TRANSFER (ver Webhooks)

​
1. Criar a transferência PIX

Envie o valor e a chave PIX do destinatário. Use external_ref para rastrear a transferência no seu sistema: 
curl -X POST 'https://app.plowf.com/api/v1/transfers' \
  -H 'Authorization: Bearer seu_token_aqui' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": 250.00,
    "pix_key": "[email protected]",
    "external_ref": "SAQUE-98765"
  }'
A resposta retorna a transferência com status PROCESSING: 
{
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "value": 250.00,
    "fees": 0.50,
    "status": "PROCESSING",
    "type": "PIX",
    "external_ref": "SAQUE-98765",
    "transfer": {
      "initiation": {
        "receiver": {
          "name": "Maria Santos",
          "bank": { "name": "BANCO INTER S.A." }
        },
        "pix_key": "[email protected]"
      }
    }
  }
}
Armazene o uuid retornado para correlacionar com os eventos de webhook.
A transferência vai para PROCESSING imediatamente, mas só é liquidada quando o sistema PIX confirmar o crédito na conta destino. Aguarde o webhook para garantir a liquidação.

​
Próximos passos

Com a transferência criada, configure seu endpoint para processar a confirmação:

​
Referências