Transacoes da Conta

Liste as transacoes da conta e consulte os detalhes de uma transacao especifica.

Os parametros event_date_start e event_date_end sao obrigatorios e devem estar no formato ISO 8601 (ex: 2026-04-01T00:00:00Z). O intervalo maximo entre as datas depende da configuracao da sua conta.

Use os parametros page_offset e page_limit para paginar os resultados. O page_limit maximo e 100 registros por pagina.

Listar Transacoes

GET/api/v2/accounts/transactions

Lista as transacoes da conta dentro de um periodo especificado.

Base URL: https://pagamentos.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2

Parametros de Query

Nome	Tipo	Obrigatorio	Descricao
`event_date_start`	string	Obrigatorio	Data/hora de inicio do periodo no formato ISO 8601. Ex: 2026-04-01T00:00:00Z
`event_date_end`	string	Obrigatorio	Data/hora de fim do periodo no formato ISO 8601. Ex: 2026-04-08T23:59:59Z
`page_offset`	integer	Opcional	Numero da pagina (minimo 1). Padrao: 1
`page_limit`	integer	Opcional	Quantidade de registros por pagina (1-100, padrao 10)
`sort_by`	string	Opcional	Campo de ordenacao. Valor aceito: EVENT_DATE
`sort_type`	string	Opcional	Direcao da ordenacao: ASC (crescente) ou DESC (decrescente)

Exemplo de Response

{
  "data": [
    {
      "transactionId": "txn_abc123def456",
      "type": "PIX_PAYMENT",
      "direction": "OUTGOING",
      "amount": 250.50,
      "currency": "BRL",
      "status": "COMPLETED",
      "description": "Pagamento de servico",
      "eventDate": "2026-04-08T10: 30:00Z",
      "endToEnd": "E0000000020260408T1030abc123def45"
    },
    {
      "transactionId": "txn_xyz789ghi012",
      "type": "PIX_RECEIVED",
      "direction": "INCOMING",
      "amount": 500.00,
      "currency": "BRL",
      "status": "COMPLETED",
      "description": "Recebimento Pix",
      "eventDate": "2026-04-07T14: 15:00Z",
      "endToEnd": "E1111111120260407T1415xyz789ghi01"
    }
  ],
  "pagination": {
    "pageOffset": 1,
    "pageLimit": 10,
    "totalRecords": 45,
    "totalPages": 5
  }
}

Exemplos de Codigo

curl -X GET \
  'https://pagamentos.basspago.com.br/api/v2/accounts/transactions?event_date_start=2026-04-01T00:00:00Z&event_date_end=2026-04-08T23:59:59Z&page_offset=1&page_limit=10&sort_by=EVENT_DATE&sort_type=DESC' \
  -H 'Authorization: Bearer {access_token}'

Detalhes da Transacao

GET/api/v2/accounts/transactions/{transactionId}/details

Consulta os detalhes completos de uma transacao especifica.

Base URL: https://pagamentos.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2

Parametros de Rota

Nome	Tipo	Descricao
`transactionId`	string	Identificador unico da transacao

Exemplo de Response

{
  "transactionId": "txn_abc123def456",
  "type": "PIX_PAYMENT",
  "direction": "OUTGOING",
  "amount": 250.50,
  "currency": "BRL",
  "status": "COMPLETED",
  "description": "Pagamento de servico",
  "eventDate": "2026-04-08T10: 30:00Z",
  "endToEnd": "E0000000020260408T1030abc123def45",
  "creditorAccount": {
    "ispb": "00000000",
    "document": "12345678900",
    "branch": "0001",
    "accountNumber": "1234567-8",
    "accountType": "CACC",
    "name": "Joao da Silva"
  },
  "idempotencyKey": "unique-key-123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-04-08T10: 30:00Z",
  "completedAt": "2026-04-08T10: 30:02Z"
}

Exemplos de Codigo

curl -X GET \
  https://pagamentos.basspago.com.br/api/v2/accounts/transactions/txn_abc123def456/details \
  -H 'Authorization: Bearer {access_token}'