Sweeping Accounts - Execução de Pagamento Pix

Visão Geral

Com o consentimento no status AUTHORISED, a ITP pode executar pagamentos Pix sem nova autenticação do usuário, desde que respeite os limites definidos no consentimento (por transação, por período e o total acumulado).

Cada chamada a este endpoint representa uma transferência Pix individual. O histórico de pagamentos fica vinculado ao paymentInitiationId.

Executar Pagamento Pix

POST /baas/v1/open/itp/sweeping-accounts/payment-initiation/:paymentInitiationId/payments

Autenticação: Bearer Token (application_token)

Path Parameters

Request

POST /baas/v1/open/itp/sweeping-accounts/payment-initiation/{{payment_initiation_id}}/payments
Authorization: Bearer {{application_token}}
Content-Type: application/json

{
  "data": {
    "date": "2026-02-18",
    "localInstrument": "MANU",
    "remittanceInformation": "Transferência inteligente - saldo",
    "document": {
      "identification": "12345678909",
      "rel": "CPF"
    },
    "cnpjInitiator": "13935893000109",
    "payment": {
      "amount": "0.01",
      "currency": "BRL"
    },
    "endToEndId": "E13935893202602180000AbCdEfGhIjK",
    "creditorAccount": {
      "ispb": "12345678",
      "issuer": "1774",
      "number": "1234567890",
      "accountType": "CACC"
    },
    "riskSignals": {
      "automatic": {
        "lastLoginDateTime": "2026-02-13T00:00:00Z"
      }
    }
  }
}

Campos do Request

data

data.document

data.payment

data.creditorAccount

data.riskSignals.automatic

Formato do endToEndId

O endToEndId identifica unicamente a transação Pix e deve seguir o padrão:

E{ISPB_iniciadora}{YYYYMMDD}{HHMM}{11_chars_aleatorios}

Exemplo: E13935893202602180000AbCdEfGhIjK

Total: 32 caracteres.

Modalidades de Iniciação (localInstrument)

Response

{
  "data": {
    "paymentId": "pmt-abc123def456",
    "endToEndId": "E13935893202602180000AbCdEfGhIjK",
    "status": "PDNG",
    "amount": "0.01",
    "currency": "BRL",
    "date": "2026-02-18",
    "createdAt": "2026-02-18T10:00:00Z"
  }
}

Códigos de Retorno

Pontos de Atenção

⚠️

amount vs. limites do consentimento: O valor informado em data.payment.amount deve ser menor ou igual ao transactionLimit definido no consentimento. Valores acima causam 422 PAGAMENTO_DIVERGENTE_CONSENTIMENTO.

⚠️

Acumulação de limites periódicos: O sistema acumula o total de pagamentos realizados no dia/semana/mês/ano e rejeita pagamentos que ultrapassem os limites periódicos definidos no consentimento.

⚠️

totalAllowedAmount: Quando a soma de todos os pagamentos executados atingir o totalAllowedAmount do consentimento, o consentimento é automaticamente marcado como CONSUMED e nenhum pagamento adicional será aceito.

⚠️

endToEndId único: Cada transação Pix deve ter um endToEndId único. Reutilizar o mesmo ID em chamadas distintas causará erro de duplicidade.

⚠️

lastLoginDateTime: Este campo é obrigatório para pagamentos automáticos como sinal de risco. Deve refletir o último login real do usuário na plataforma da ITP. Não utilize datas fixas ou estáticas em produção.

⚠️

date e endToEndId sincronizados: A data no endToEndId deve corresponder à date do pagamento. Divergências podem causar rejeição pelo arranjo Pix.

⚠️

Liquidação assíncrona: O pagamento é processado de forma assíncrona. O status inicial PDNG indica que o pagamento foi aceito para processamento, mas a liquidação efetiva ocorre em seguida. Utilize polling ou webhooks para acompanhar o status final (ACSC, RJCT).

⚠️

Sandbox: Em ambiente sandbox Bricks Demo, é esperado receber 422 PAGAMENTO_DIVERGENTE_CONSENTIMENTO. Isso é uma limitação do ambiente de testes e não representa erro de implementação.