Comunidade

Olá, pessoal.

Estou realizando uma iniciação de pagamento via API utilizando o endpoint:

POST /{companyId}/banking/payments

Documentação oficial:
https://developers.empresas.btgpactual.com/reference/post_companyid-banking-payments

A documentação informa que, para envio de apenas um item, o campo agreementId deve ser preenchido com o valor:

"agreementId": "INDIVIDUAL_APPROVE"

Seguindo essa orientação, a iniciação é criada com sucesso. Porém, ao acessar o aplicativo de aprovação (web ou mobile), o pagamento aparece como se fosse um lote de pagamentos, e não uma transação única. Especialmente no aplicativo mobile, o campo internalDescription não é exibido, dificultando a validação e aprovação pelo usuário.

Segue um exemplo do payload utilizado:

{
  "items": [
    {
      "type": "PIX_KEY",
      "internalDescription": "Descrição Interna",
      "detail": {
        "creditParty": {
          "name": "Nome da Parte",
          "taxId": "11111111111"
        },
        "key": {
          "value": "+5511111111111"
        }
      },
      "debitParty": {
        "branchCode": "50",
        "number": "11111111"
      },
      "agreementId": "INDIVIDUAL_APPROVE",
      "amount": 1,
      "paymentDate": "2026-02-07"
    }
  ]
}

Minhas dúvidas são:

Mesmo utilizando agreementId = INDIVIDUAL_APPROVE, existe algum motivo para o pagamento ainda ser tratado como lote no fluxo de aprovação?

Existe algum parâmetro adicional necessário para que a transação seja exibida como pagamento individual e apresente o internalDescription corretamente no app?

A documentação menciona que esse endpoint aceita apenas 1 item, porém a API está aceitando múltiplos itens normalmente. Isso é esperado?