获取账户交易记录

---

Request

ENDPOINT

/cash_account/account/ACCOUNT_KEY/transactions

MÉTODO

GET

Response

STATUS

200

Response Body

{
    "data": [
        {
            "transaction_key": "ed585534-8c05-431d-b829-0dc7883b24ba",
            "transaction_type": "outgoing_wire_transfer",
            "transaction_status": "pending_conciliation",
            "transaction_description": "Descrição do pagamento",
            "amount": -70000,
            "transaction_datetime": "2025-01-01T14:00:00Z",
            "account_balance": 500000,
            "transaction_data": {
               "counter_part_account": {
                  "owner": {
                        "name": "Nome da Contraparte",
                        "document_number": "***.805.49*-**"
                  },
                  "account_digit": "8",
                  "account_branch": "1",
                  "account_number": "1234567",
                  "financial_institution": {
                        "code": "329",
                        "ispb": "32402502"
                  }
               },
            },
            "account": {
                "account_key": "9c1d0c18-01ea-4c32-a878-1c6391f9aa44",
                "account_type": "checking_account",
                "financial_institution": {
                    "ispb": "32402502",
                    "code": "329",
                    "name": "QI Sociedade de Crédito Direto"
                },
                "account_status": "open",
                "account_number": "3289018",
                "account_digit": "7",
                "account_branch": "0001",
                "accounting_identification": 1,
                "balance": 500000,
                "owner": {
                    "name": "FUNDO TESTE",
                    "document_number": "93.625.214/0001-34"
                },
                "owner_document_number": "93.625.214/0001-34",
                "account_configuration": {
                    "pix": true,
                    "wire_transfer": true
                },
                "billings": []
            }
        },
        {
            "transaction_key": "16c9c463-266e-4e73-b87d-efc32aa6727a",
            "transaction_type": "incoming_wire_transfer",
            "transaction_status": "reconciled",
            "transaction_description": "Descrição",
            "amount": 300000,
            "transaction_datetime": "2025-06-04T13:00:00Z",
            "account_balance": 570000,
            "transaction_data": {
               "counter_part_account": {
                  "owner": {
                     "name": "FUNDO TESTE",
                     "document_number": "93.625.214/0001-34"
                  },
                  "account_digit": "8",
                  "account_branch": "73",
                  "account_number": "567567",
                  "financial_institution": {
                     "code": "341",
                     "ispb": "60701190",
                  }
               },
            },
            "account": {
                "account_key": "9c1d0c18-01ea-4c32-a878-1c6391f9aa44",
                "account_type": "checking_account",
                "financial_institution": {
                    "ispb": "32402502",
                    "code": "329",
                    "name": "QI Sociedade de Crédito Direto"
                },
                "account_status": "open",
                "account_number": "3289018",
                "account_digit": "7",
                "account_branch": "0001",
                "accounting_identification": 1,
                "balance": 500000,
                "owner": {
                    "name": "FUNDO TESTE",
                    "document_number": "93.625.214/0001-34"
                },
                "owner_document_number": "93.625.214/0001-34",
                "account_configuration": {
                    "pix": true,
                    "wire_transfer": true
                },
                "billings": []
            },
            "conciliation_group": {
                "description": "TRANSFERÊNCIA: CONTA COBRANÇA -> CONTA PRINCIPAL",
                "conciliation_group_key": "1ac2921c-6c81-481b-8472-6c4126bba4bf",
                "conciliation_group_datetime": "2025-01-01T13:28:58Z"
            }
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

Query Params

字段	类型	描述
status	string	交易状态
start_date	string	查询起始日期
end_date	string	查询结束日期
page	string	已返回页码

Response Fields

字段	类型	描述
data	array	Transaction 对象列表
limit	int	每页返回对象数量上限
page	int	已返回页码
is_last_page	boolean	表示已返回页面是否为最后一页

Transaction

字段	类型	描述	字符数
transaction_key	string	交易唯一标识键	36
transaction_type	string	交易类型	最多50
transaction_status	string	交易状态	最多50
transaction_description	string	银行提供的交易描述	最多255
amount	bigint	交易金额乘以100（例如：R$1,00 == 100）	-
transaction_datetime	string	交易日期和时间	ISO 8601
account_balance	bigint	交易后账户余额	-
transaction_data	JSON	含交易附加信息的对象	-
account	JSON	包含交易的账户对象	-

Account

字段	类型	描述	字符数
account_key	string	账户唯一标识键	36
account_type	string	账户类型	最多50
financial_institution	JSON	金融机构对象	-
account_status	string	账户状态	最多50
account_number	string	账户号码	最多50
account_digit	string	账户校验位	1
account_branch	string	支行编号	最多50
accounting_identification	int	账户序列标识符	-
balance	int	当前账户余额	-
owner	JSON	持有人对象	-
owner_document_number	string	持有人证件号	14或18

注意

余额通过将元和分拼接提供，例如：1234 = R$ 12,34

Financial institution

字段	类型	描述	字符数
ispb	string	巴西支付系统标识符	8
code	string	金融机构代码	3
name	string	金融机构名称	最多255

Owner

字段	类型	描述	字符数
name	string	持有人姓名	最多255
document_number	string	持有人证件号	14或18

Conciliation Group

字段	类型	描述	字符数
description	string	交易对账描述	最多255
conciliation_group_key	string	对账唯一标识键	36
conciliation_group_datetime	string	对账日期和时间	ISO 8601