pixcli pix

Commands

`pixcli pix list`

List received Pix transactions (payments you've received).

pixcli pix list --days 7

Output:

📋 Received Pix Transactions (last 7 days)

   E12345678901234567890123456  R$25.00   2026-03-19T10:05:00Z  João Silva
   E98765432109876543210987654  R$50.00   2026-03-18T15:35:00Z  Maria Santos

Flags

Flag	Required	Default	Description
`--days`	No	`7`	Number of days to look back
`--from`	No	—	Start date (ISO 8601, overrides `--days`)
`--to`	No	—	End date (ISO 8601)

JSON output

pixcli pix list --days 30 --output json

[
  {
    "e2eid": "E12345678901234567890123456",
    "amount": "25.00",
    "timestamp": "2026-03-19T10:05:00Z",
    "payer_name": "João Silva",
    "payer_doc": "***678901"
  }
]

Filter by date range

pixcli pix list --from 2026-03-01T00:00:00Z --to 2026-03-31T23:59:59Z

`pixcli pix get`

Get details of a specific Pix transaction by its end-to-end ID.

pixcli pix get E12345678901234567890123456

Output:

📋 Pix Transaction Details
   E2E ID:     E12345678901234567890123456
   Amount:     R$25.00
   Timestamp:  2026-03-19T10:05:00Z
   Payer:      João Silva
   Payer Doc:  ***678901
   TxID:       abc123def456
   Info:       Order #123

An E2E ID (End-to-End ID) is a unique, immutable identifier assigned to every Pix transaction by the Brazilian payment infrastructure (SPI). It's a 32-character string starting with E, followed by the ISPB code (8 digits), date, and a unique sequence.

Format: E{ISPB}{DATE}{SEQUENCE}

Example: E12345678202603191000abc123def456

Unlike a TxID (which identifies a charge), the E2E ID identifies the actual payment transaction and is set by the payer's bank.

Pix Transaction Flow

1. Recipient creates a charge (TxID assigned)
2. Payer scans QR code or enters BR Code
3. Payer's bank creates Pix transaction (E2E ID assigned)
4. Payment settles (usually < 10 seconds)
5. Recipient's PSP notifies via webhook
6. Transaction appears in `pixcli pix list`