Bynet
  1. Transactions
Bynet
  • 🚀 Introdução à API
  • 📦 Criar Pedido
  • My company
    • Get all data
      GET
    • Update
      PUT
    • Update documents
      PUT
    • Get by ID
      GET
    • Update other info
      PUT
  • Products
    • Create
      POST
    • Find All
      GET
    • Find by ID
      GET
    • Update
      PUT
    • Delete
      DELETE
    • Update Status
      PUT
  • Bank
    • Create
      POST
    • Find all
      GET
    • Find by ID
      GET
    • Find pre bank
      GET
  • Transactions
    • Find All
      GET
    • Create
      POST
    • Find by ID
      GET
    • Update delivery status
      PUT
    • Export Excel
      POST
    • Summary all
      GET
    • Fee
      POST
    • Summary by ID
      GET
  • Checkout
    • Layouts
      • Create Layout
      • Find
      • Update settings
      • Update status
      • Find by ID
    • Find info
    • Create Order
    • Find info order
    • Find payment methods by ID
    • Create payment
    • Find payment methods
  • Transfers
    • Create
    • Update
    • Find all
    • Find by ID
    • summary
  • Cashout
    • Create
    • Find all
    • Find by ID
  • Customers
    • Find all
    • Find by ID
  • Balance
    • Find
    • Summary
    • Find finalcial reserve
  • Webhook
    • ⚙️ Webhook: Formato de Postback
    • Create
    • Find all
    • Find by ID
    • Update
    • Delete
  1. Transactions

Summary all

GET
/api/user/transactions/summary
Este endpoint retorna um resumo estatístico das transações do usuário autenticado. Permite aplicar diversos filtros para análise de comportamento, volume financeiro, taxas e status das transações em determinado período ou conjunto de critérios.

✅ Requisitos da Requisição#

Método HTTP: GET
Endpoint: /api/user/transactions/summary
Content-Type: application/json
Autenticação: api_token

🧠 Header da requisição#

CampoTipoObrigatórioDescrição
x-api-keystringSimToken de autenticação API Key
User-AgentAtivoB2B/1.0Sim

📥 Parâmetros obrigatórios#

Query params:
ParâmetroTipoDescrição
limitstringQuantidade de registros por página
pagestringPágina atual
orderBystringCampo a ser ordenado
orderDirectionstringDireção da ordenação (asc ou desc)
idstringID da transação
externalRefstringReferência externa
pixEnd2EndIdstringID Pix end-to-end
createStartDatestring (date-time)Data de criação inicial
createEndDatestring (date-time)Data de criação final
refundStartDatestring (date-time)Data inicial do reembolso
refundEndDatestring (date-time)Data final do reembolso
updateStartDatestring (date-time)Data de atualização inicial
updateEndDatestring (date-time)Data de atualização final
expirationDateStartstring (date-time)Data de expiração inicial
expirationDateEndstring (date-time)Data de expiração final
firstSixDigitsstringPrimeiros seis dígitos do cartão
lastFourDigitsstringÚltimos quatro dígitos do cartão
brandstringBandeira do cartão
fingerprintstringIdentificador do cartão
idAtAcquirerstringID no adquirente
acquirersarray[string]Lista de adquirentes
namestringNome do comprador
emailstringEmail do comprador
documentNumberstringDocumento (CPF/CNPJ) do comprador
phonestringTelefone do comprador
paymentMethodsarray[string]Métodos de pagamento (ex: PIX, BOLETO, etc.)
statusstringStatus da transação (PROCESSING, AUTHORIZED, PAID, REFUNDED, WAITING_PAYMENT, REFUSED, CHARGEDBACK, CANCELED, IN_PROTEST)
installmentsarray[string]Número de parcelas
deliveryStatusarray[string]Status da entrega (ex: WAITING, IN_TRANSIT)

Request

Query Params

Header Params

Responses

🟢200Success
application/json
Body

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/user/transactions/summary?limit=10&page=1&orderBy=jf3ls3dkru92i4903ivf290b5um24350&orderDirection=desc&id=uuid&externalRef=externalRef&pixEnd2EndId=pixEnd2EndId&createStartDate=2025-04-11T12:47:35.884Z&createEndDate=2025-04-11T12:47:35.884Z&refundStartDate=2025-04-11T12:47:35.884Z&refundEndDate=2025-04-11T12:47:35.884Z&updateStartDate=2025-04-11T12:47:35.884Z&updateEndDate=2025-04-11T12:47:35.884Z&firstSixDigits=123456&lastFourDigits=4321&brand=brand&fingerprint&idAtAcquirer=acquirerId&acquirers=uuid, uuid&name=Customer Name&email=johndoe@email.com&documentNumber= 000.000.000-00&phone=(99) 98765-4321&paymentMethods=PIX, BOLETO&status=PROCESSING, PAID&installments=1, 2, 3&deliveryStatus=WAITING, IN_TRANSIT&expirationDateStart=2025-04-11T12:47:35.885Z&expirationDateEnd=2025-04-11T12:47:35.885Z' \
--header 'x-api-key: {Token}' \
--header 'User-Agent: AtivoB2B/1.0'
Response Response Example
200 - Success
{
  "status": 200,
  "message": "Transações encontradas com sucesso.",
  "data": {
    "data": [
      {
        "id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "amount": 1000,
        "status": "PAID",
        "paymentMethod": "BOLETO",
        "installments": "X",
        "card": "X",
        "pix": "X",
        "boleto": {
          "id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "url": "https://XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "barcode": "X",
          "digitableLine": "X",
          "expirationDate": "2025-04-23T00:00:00.000Z",
          "instructions": "X",
          "createdAt": "2025-04-16T12:56:01.605Z",
          "transactionId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        },
        "customer": {
          "name": "XXXXXXXXXXXXX",
          "email": "XXXXXXXXXXXXXXXXXXXX"
        },
        "items": [
          {
            "title": "XXXXXXXXXXXX",
            "unitPrice": 10,
            "quantity": 1
          }
        ],
        "createdAt": "2025-04-16T12:55:55.557Z",
        "updatedAt": "2025-04-16T12:56:01.325Z",
        "paidAt": "X",
        "externalRef": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "provider": "XXXXXXXX"
      },
      {
        "id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "amount": 100000,
        "status": "PAID",
        "paymentMethod": "CREDIT_CARD",
        "installments": 3,
        "card": {
          "id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "holderName": "XXXXXXXX",
          "expirationMonth": 12,
          "expirationYear": 2030,
          "brand": "X",
          "lastDigits": "XXXXXXXXXXXXXXXX",
          "reusable": false,
          "createdAt": "2025-04-16T12:53:37.539Z",
          "gatewayId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        },
        "pix": "X",
        "boleto": "X",
        "customer": {
          "name": "XXXXXXXXXXXXX",
          "email": "XXXXXXXXXXXXXXXXXXXX"
        },
        "items": [
          {
            "title": "XXXXXXXXXXXX",
            "unitPrice": 10,
            "quantity": 1
          }
        ],
        "createdAt": "2025-04-16T12:53:37.539Z",
        "updatedAt": "2025-04-16T14:35:32.679Z",
        "paidAt": "2025-04-16T12:53:49.238Z",
        "externalRef": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "provider": "XXXXXXXX"
      }
    ],
    "pages": 44,
    "page": 1,
    "limit": 10,
    "total": 439
  },
  "error": "X"
}
Modified at 2025-07-23 19:02:40
Previous
Export Excel
Next
Fee
Built with