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

Find All

GET
/api/user/transactions
Este endpoint permite recuperar os detalhes de um webhook específico, a partir do seu identificador único (id).

✅ Requisitos da Requisição#

Método HTTP: GET
Endpoint: /api/user/transactions
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 opicionais#

ParâmetroTipoDescrição
idstringID específico da transação
paymentMethodsstringMétodo de pagamento (credit_card, boleto, etc.)
statusstringStatus da transação (PROCESSING, AUTHORIZED, PAID, REFUNDED, WAITING_PAYMENT, REFUSED, CHARGEDBACK, CANCELED, IN_PROTEST)
deliveryStatusstringStatus da entrega, se aplicável
installmentsintegerNúmero de parcelas
namestringNome do comprador
emailstringEmail do comprador
phonestringTelefone do comprador
traceablebooleanSe a transação é rastreável (true ou false)

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?id=uuid&paymentMethods=PIX, BOLETO&status=PROCESSING, AUTHORIZED, PAID, REFUNDED, WAITING_PAYMENT, REFUSED, CHARGEDBACK, CANCELED, IN_PROTEST&deliveryStatus=WAITING, IN_TRANSIT&installments=1, 2, 3&name=Customer Name&email= johndoe@email.com&documentNumber=000.000.000-00&phone=(99) 98765-4321&traceable=true' \
--header 'x-api-key: api_token' \
--header 'User-Agent: AtivoB2B/1.0'
Response Response Example
200 - Success
{
    "status": 200,
    "message": "Transações encontradas com sucesso.",
    "data": [
        {
            "id": "00000000-0000-0000-0000-0000000000000",
            "amount": 10,
            "refundedAmount": 0,
            "companyId": "00000000-0000-0000-0000-0000000000000",
            "installments": null,
            "paymentMethod": "PIX",
            "status": "REFUSED",
            "postbackUrl": null,
            "metadata": "{\"linkId\":\"00000000-0000-0000-0000-0000000000000\",\"sellerId\":\"00000000-0000-0000-0000-0000000000000\",\"orderId\":\"00000000-0000-0000-0000-0000000000000\",\"gatewayId\":\"00000000-0000-0000-0000-0000000000000\"}",
            "traceable": false,
            "secureId": null,
            "secureUrl": null,
            "createdAt": "2025-03-28T21:30:42.929Z",
            "updatedAt": "2025-03-28T21:30:42.974Z",
            "paidAt": null,
            "ip": "::ffff:127.0.0.1",
            "externalRef": "undefined",
            "customer": {
                "document": {
                    "id": "00000000-0000-0000-0000-0000000000000",
                    "number": "0000000000",
                    "type": "CNPJ",
                    "customerId": "00000000-0000-0000-0000-0000000000000"
                },
                "address": {
                    "id": "00000000-0000-0000-0000-0000000000000",
                    "street": "AVENIDA PAULA FERREIRA",
                    "streetNumber": "3",
                    "complement": "",
                    "zipCode": "02915000",
                    "neighborhood": "FREGUESIA DO Ó",
                    "city": "SÃO PAULO",
                    "state": "SP",
                    "country": "br"
                }
            },
            "card": null,
            "boleto": null,
            "pix": null,
            "shipping": {
                "id": "00000000-0000-0000-0000-0000000000000",
                "fee": 0,
                "addressId": "00000000-0000-0000-0000-0000000000000",
                "transactionId": "00000000-0000-0000-0000-0000000000000"
            },
            "refusedReason": "{\"code\":\"ERR_INVALID_ARG_TYPE\"}",
            "items": [
                {
                    "id": "00000000-0000-0000-0000-0000000000000",
                    "externalRef": "00000000-0000-0000-0000-0000000000000",
                    "title": "Pepsi gelada",
                    "unitPrice": 123,
                    "quantity": 1,
                    "tangible": false,
                    "transactionId": "00000000-0000-0000-0000-0000000000000"
                }
            ],
            "refunds": [],
            "delivery": null,
            "fee": {
                "id": "00000000-0000-0000-0000-0000000000000",
                "fixedAmount": 199,
                "spreadPercentage": 3.49,
                "estimatedFee": 199.349,
                "netAmount": -190,
                "transactionId": "00000000-0000-0000-0000-0000000000000",
                "gatewayId": "00000000-0000-0000-0000-0000000000000"
            }
        },
                {
            "id": "00000000-0000-0000-0000-0000000000000",
            "amount": 10,
            "refundedAmount": 0,
            "companyId": "00000000-0000-0000-0000-0000000000000",
            "installments": null,
            "paymentMethod": "PIX",
            "status": "REFUSED",
            "postbackUrl": null,
            "metadata": "{\"linkId\":\"00000000-0000-0000-0000-0000000000000\",\"sellerId\":\"00000000-0000-0000-0000-0000000000000\",\"orderId\":\"00000000-0000-0000-0000-0000000000000\",\"gatewayId\":\"00000000-0000-0000-0000-0000000000000\"}",
            "traceable": false,
            "secureId": null,
            "secureUrl": null,
            "createdAt": "2025-03-28T21:30:42.929Z",
            "updatedAt": "2025-03-28T21:30:42.974Z",
            "paidAt": null,
            "ip": "::ffff:127.0.0.1",
            "externalRef": "undefined",
            "customer": {
                "document": {
                    "id": "00000000-0000-0000-0000-0000000000000",
                    "number": "0000000000",
                    "type": "CNPJ",
                    "customerId": "00000000-0000-0000-0000-0000000000000"
                },
                "address": {
                    "id": "00000000-0000-0000-0000-0000000000000",
                    "street": "AVENIDA PAULA FERREIRA",
                    "streetNumber": "3",
                    "complement": "",
                    "zipCode": "02915000",
                    "neighborhood": "FREGUESIA DO Ó",
                    "city": "SÃO PAULO",
                    "state": "SP",
                    "country": "br"
                }
            },
            "card": null,
            "boleto": null,
            "pix": null,
            "shipping": {
                "id": "00000000-0000-0000-0000-0000000000000",
                "fee": 0,
                "addressId": "00000000-0000-0000-0000-0000000000000",
                "transactionId": "00000000-0000-0000-0000-0000000000000"
            },
            "refusedReason": "{\"code\":\"ERR_INVALID_ARG_TYPE\"}",
            "items": [
                {
                    "id": "00000000-0000-0000-0000-0000000000000",
                    "externalRef": "00000000-0000-0000-0000-0000000000000",
                    "title": "Pepsi gelada",
                    "unitPrice": 123,
                    "quantity": 1,
                    "tangible": false,
                    "transactionId": "00000000-0000-0000-0000-0000000000000"
                }
            ],
            "refunds": [],
            "delivery": null,
            "fee": {
                "id": "00000000-0000-0000-0000-0000000000000",
                "fixedAmount": 199,
                "spreadPercentage": 3.49,
                "estimatedFee": 199.349,
                "netAmount": -190,
                "transactionId": "00000000-0000-0000-0000-0000000000000",
                "gatewayId": "00000000-0000-0000-0000-0000000000000"
            }
        }
        ],
    "error": null
}
Modified at 2025-07-23 19:02:40
Previous
Find pre bank
Next
Create
Built with