List Pix Payments

GET 
/v3/pix/payments

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Retrieve a list of the user's pix payments. Use optional filter parameters to refine your search.

Request

Query Parameters

page number

Default value: 1

Page number.

size number

Possible values: <= 100

Default value: 20

Page size. Max size is 100.

sort string

Possible values: [created_at]

Page sort attribute.

order string

Possible values: [asc, desc]

Default value: asc

Page order.

states string[]

Possible values: [PENDING, SCHEDULED, WAITING, WAITING_DELAYED, CONFIRMED, ERROR, FAILED, CANCELED]

Payment State.

payment_date_period_start date-time

Transaction period date start for any transaction.

payment_date_period_end date-time

Transaction period date end for any transaction.

created_at_period_start date-time

Created at period date start for any transaction.

created_at_period_end date-time

Created at period date end for any transaction.

end_to_end_id string

Payment end to end id

Header Parameters

x-wallet-uuid string

Sender Wallet UUID (if empty, your default Wallet UUID will be settled)

nonce stringrequired

The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

x-lang string

Possible values: [pt-BR, en-US]

Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

x-product-uuid string

The product ID is a UUID (v4) used to identify the Z.ro product configuration.

x-product-target-user-uuid string

The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.

Responses

200

The payments returned successfully.

application/json

Schema

Schema

page numberrequired

Page number.

page_size numberrequired

Page size.

page_total numberrequired

Page total.

total numberrequired

Total of elements.

data object[]required
Payments data.
Array [
id stringrequired
Payment UUID.
operation_id string
Operation UUID. Used to get receipt and track the transaction. This will not be returned if the payment has been scheduled.
type stringrequired
Possible values: [DEVOLUTION_COMPLETED, DEVOLUTION_RECEIVED, DEPOSIT_RECEIVED, PAYMENT_COMPLETED]
Transaction type.
state stringrequired
Possible values: [PENDING, SCHEDULED, WAITING, WAITING_DELAYED, CONFIRMED, ERROR, FAILED, CANCELED]
Payment state.
end_to_end_id stringrequired
End to end id.
txid string
Payment txid identifier.
amount numberrequired
Value in R$ cents.
owner_name string
The payment owner name.
owner_person_type stringrequired
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
The payment owner person type.
owner_document string
The payment owner document.
owner_account_number string
The payment owner account number.
owner_branch string
The payment owner branch.
owner_bank_name stringrequired
The payment owner bank name.
owner_bank_ispb string
The payment owner bank ispb.
beneficiary_name string
The payment beneficiary name.
beneficiary_person_type stringrequired
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
The payment beneficiary person type.
beneficiary_document string
The payment beneficiary document.
beneficiary_bank_name stringrequired
The payment beneficiary bank name.
beneficiary_bank_ispb string
The payment beneficiary bank ispb.
created_at date-timerequired
Date of created payment.
]

Example (from schema)

{
  "page": 1,
  "page_size": 20,
  "page_total": 20,
  "total": 100,
  "data": [
    {
      "id": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "operation_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "type": "DEVOLUTION_COMPLETED",
      "state": "PENDING",
      "end_to_end_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "txid": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "amount": 1299,
      "owner_name": "string",
      "owner_person_type": "NATURAL_PERSON",
      "owner_document": "string",
      "owner_account_number": "string",
      "owner_branch": "string",
      "owner_bank_name": "string",
      "owner_bank_ispb": "string",
      "beneficiary_name": "string",
      "beneficiary_person_type": "NATURAL_PERSON",
      "beneficiary_document": "string",
      "beneficiary_bank_name": "string",
      "beneficiary_bank_ispb": "string",
      "created_at": "2025-05-05T14:28:03.714Z"
    }
  ]
}

400

If any required params are missing or has invalid format or type.

401

User authentication failed.

422

If any required params are missing or has invalid format or type.

Authorization: http

name: bearertype: httpscheme: bearerbearerFormat: JWT

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X GET 'https://docs.zrobank.io/v3/pix/payments' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Request Collapse all

Auth

Bearer Token

Parameters

nonce — headerrequired

page — query

size — query

sort — query

---created_at

order — query

---ascdesc

states — query

PENDINGSCHEDULEDWAITINGWAITING_DELAYEDCONFIRMEDERRORFAILEDCANCELED

payment_date_period_start — query

payment_date_period_end — query

created_at_period_start — query

created_at_period_end — query

end_to_end_id — query

x-wallet-uuid — header

x-lang — header

---pt-BRen-US

x-product-uuid — header

x-product-target-user-uuid — header

ResponseClear

Click the Send API Request button above and see the response here!