跳到主要内容

交易查询

Request​

ENDPOINT
/account/ACCOUNT_KEY/transaction
MÉTODO
GET

Request Path Params​

字段类型描述
account_key *stringQI 账户唯一识别密钥

Query Params​

字段类型描述
date_fromstring开始日期。格式 "YYYY-MM-DD"
date_tostring结束日期。格式 "YYYY-MM-DD"
order_bystring"asc" 升序或 "desc" 降序。默认为 "desc"
pageinteger请求的页码。默认为 1
page_sizeinteger查询中请求的每页大小。默认为 4000

Response​

成功响应​

STATUS
200
关于 Transaction Details 字段

此字段是一个对象，包含所执行交易类型的具体信息（Boleto 支付、TED 或 Pix）。

Response Body: Pix 交易
{
    "data": [
        {
            "account_balance": 22403.11,
            "agent_person_key": null,
            "created_at": "2023-11-24 19:10:54",
            "description": "329 0001 000002-5 32.402.502/0001-35 QI SOCIEDADE DE CRÉDITO DIRETO S.A.",
            "origin_key": "4983e0ad-2212-44f9-8ab9-c243f72f90a8",
            "source_subtype": {
                "enumerator": "internal_pix_transfer",
                "translation_ptbr": "Transferência de PIX"
            },
            "transacted_at": "2023-11-24 19:10:54",
            "transaction_amount": 1,
            "transaction_details": {
                "payer_account_branch": "0001",
                "payer_account_digit": "7",
                "payer_account_number": "5267641",
                "payer_document_number": "98765432100",
                "payer_ispb": "32402502",
                "payer_name": "Eduardo Spada",
                "receiver_account_branch": "0001",
                "receiver_account_digit": "5",
                "receiver_account_number": "000002",
                "receiver_conciliation_id": null,
                "receiver_document_number": "32402502000135",
                "receiver_ispb": "32402502",
                "receiver_name": "QI SCD S.A."
            },
            "transaction_key": "b71ea9a3-e012-4761-bea6-e65c6bfc228f"
        }
    ],
    "pagination": {
        "current_page": 1,
        "next_page": null,
        "rows_per_page": 30,
        "total_pages": "unavailable",
        "total_rows": null
    }
}
Response Body: TED 交易
{
    "data": [
        {
            "account_balance": 22403.11,
            "agent_person_key": null,
            "created_at": "2023-11-24 19:10:54",
            "description": "329 0001 000002-5 32.402.502/0001-35 QI SOCIEDADE DE CRÉDITO DIRETO S.A.",
            "origin_key": "4983e0ad-2212-44f9-8ab9-c243f72f90a8",
            "source_subtype": {
                "enumerator": "incoming_funds_transfer",
                "translation_ptbr": "Transferência de Entrada"
            },
            "transacted_at": "2023-11-24 19:10:54",
            "transaction_amount": 1,
            "transaction_details": {
                "receiver_account_number": "7212399",
                "payer_account_branch": "120",
                "payer_account_number": "84598",
                "receiver_name": "QI SCD S.A.",
                "receiver_account_branch": "2",
                "payer_document_number": "23846749289329",
                "payer_account_digit": "4",
                "payer_ispb": "61231190",
                "receiver_ispb": "32402502",
                "receiver_document_number": "02983510938761",
                "payer_name": "ASICS BRASIL DISTRIBUICAO E CO",
                "receiver_account_digit": "3"
            },
            "transaction_key": "b71ea9a3-e012-4761-bea6-e65c6bfc228f"
        }
    ],
    "pagination": {
        "current_page": 1,
        "next_page": null,
        "rows_per_page": 30,
        "total_pages": "unavailable",
        "total_rows": null
    }
}
Response Body: Boleto 支付交易
{
    "data": [
        {
            "account_balance": 22403.11,
            "agent_person_key": null,
            "created_at": "2023-11-24 19:10:54",
            "description": "329 0001 000002-5 32.402.502/0001-35 QI SOCIEDADE DE CRÉDITO DIRETO S.A.",
            "origin_key": "4983e0ad-2212-44f9-8ab9-c243f72f90a8",
            "source_subtype": {
                "enumerator": "bank_slip_payment",
                "translation_ptbr": "Pagamento de Boleto"
            },
            "transacted_at": "2023-11-24 19:10:54",
            "transaction_amount": 1,
            "transaction_details": {
                "beneficiary_legal_name": "COATIOSUERRA LTDA",
                "barcode": "34191954500001165778979877821520910001098000",
                "digitable_line": "34312123124532455091500010980001195450000116579",
                "beneficiary_document_number": "61148052000102"
            },
            "transaction_key": "b71ea9a3-e012-4761-bea6-e65c6bfc228f"
        }
    ],
    "pagination": {
        "current_page": 1,
        "next_page": null,
        "rows_per_page": 30,
        "total_pages": "unavailable",
        "total_rows": null
    }
}
Response Body: 银行卡清算交易
{
    "data": [
        {
            "account_balance": 22403.11,
            "agent_person_key": null,
            "created_at": "2023-11-24 19:10:54",
            "description": "Nome da Credenciadora 12345678000195 - Elo Débito - Liquidação",
            "origin_key": "4983e0ad-2212-44f9-8ab9-c243f72f90a8",
            "source_subtype": {
                "enumerator": "incoming_debit_card_settlement",
                "translation_ptbr": "Liquidação de cartão de débito"
            },
            "transacted_at": "2023-11-24 19:10:54",
            "transaction_amount": 1,
            "transaction_details": {
                "merchant_name": "Nome do Merchant",
                "merchant_document_number": "87654321000198",
                "acquirer_name": "Nome da Credenciadora",
                "acquirer_document_number": "12345678000195",
                "product_type": "ECD",
                "product_description": "Elo Débito"
            },
            "transaction_key": "b71ea9a3-e012-4761-bea6-e65c6bfc228f"
        }
    ],
    "pagination": {
        "current_page": 1,
        "next_page": null,
        "rows_per_page": 30,
        "total_pages": "unavailable",
        "total_rows": null
    }
}
Response Body: 银行卡消费交易
{
    "data": [
        {
            "account_balance": 20003.01,
            "agent_person_key": null,
            "created_at": "2023-11-24 19:10:54",
            "description": "Cartão físico | Nome do Estabelecimento | SAO PAULO - BR | U3UUUU",
            "origin_key": "c9f31beb-dafa-42c2-9a16-0854c523eabd",
            "source_subtype": {
                "enumerator": "card_purchase",
                "translation_ptbr": "Compra com Cartão"
            },
            "transacted_at": "2023-11-24 19:10:54",
            "transaction_amount": 17,
            "transaction_details": {
                "acquirer_code": "000000",
                "merchant_mcc": "0000",
                "merchant_name": "Nome do Estabelecimento",
                "authorization_code": "U3UUUU",
                "merchant_address": {
                    "postal_code": "00000123",
                    "city": "SAO PAULO",
                    "country": "BR"
                },
                "merchant_currency": "BRL",
                "merchant_amount": "17.00",
                "card_transaction_type": "purchase",
                "card_type": "plastic"
            },
            "transaction_key": "b71ea9a3-e012-4761-bea6-e65c6bfc228f"
        }
    ],
    "pagination": {
        "current_page": 1,
        "next_page": null,
        "rows_per_page": 30,
        "total_pages": "unavailable",
        "total_rows": null
    }
}
关于 next_page 字段

pagination 对象中的 next_page 字段表示下一个可查询的页面。若无更多页面，返回值将为 null。

注意！

信用卡清算交易的 transaction_details 对象中的 product_type 字段由卡清算系统提供，可能返回 null。对于此类情况，应读取 product_description 字段以识别清算的 product_type。

product_type 枚举值​

枚举值描述
ACCAmerican Express 信用卡
BCCBanescard 信用卡
BCDBanescard 借记卡
BVVBen Visa Vale 预付卡
CACCielo Amex 信用卡
CBCCabal 信用卡
CBDCabal 借记卡
CBPCabal 预付卡
CC3信用让渡中心
CDCCielo Diners 信用卡
CECCielo Elo 信用卡
CEDCielo Elo 借记卡
CHCCielo Hipercard 信用卡
CMCCielo Mastercard 信用卡
CMDCielo Mastercard 借记卡
COPCOPASA - 米纳斯吉拉斯州卫生公司
CUPCup 信用卡
CZCCredz 信用卡
DCCDiners 跨境清算信用卡
ECBElo PAT - 福利卡
ECCElo 信用卡
ECDElo 借记卡
GCCGoodcard 信用卡
GDCGlobal Payments Diners 信用卡
GMCGlobal Payments MasterCard 信用卡
GMDGlobal Payments MasterCard 借记卡
GVCGlobal Payments VISA 信用卡
GVDGlobal Payments VISA 借记卡
HCCHipercard 信用卡
HCDHiper 借记卡
JCCJCB 信用卡
MACMais 信用卡
MCAMasterCard ATM 卡
MCCMastercard 信用卡
MCDMaestro 借记卡
MCPMastercard 预付卡
NBANeoenergia - 巴伊亚州电力公司
NBRNeoenergia - 巴西利亚配电公司
NEKNeoenergia - Elektro Redes S/A
NPENeoenergia - 伯南布哥州能源公司
NRNNeoenergia - 北里奥格朗德州能源公司
OCDOurocard 借记卡
OT其他转账清算产品
PCA集中征收平台
SCCSorocred 信用卡
SCDSorocred 借记卡
SLC集中清算服务
STCSELTEC
TCBTecban
TEDTED 清算产品
VCAVisa ATM 卡
VCCVisa 信用卡
VCDVisa Electron 借记卡
VCPVisa 预付卡
VDCVerdecard 信用卡
VDPVerdecard 预付卡
VIAVisa 国际 ATM 取款
VICVisa 国际信用购物
VIDVisa 国际借记购物
Alelo 预付卡
Agiplan 信用卡
Aura 信用卡
Calcard 信用卡
Credsystem 信用卡
Redesplan 信用卡
Sicred 信用卡
Avista 信用卡
Discover 信用卡
Sicredi 借记卡
Hiper 信用卡
Ticket 预付卡
Sodexo 预付卡
VR 预付卡
Policard 预付卡
Valecard 预付卡
Greencard 预付卡
Coopercard 预付卡
Verocheque 预付卡
Nutricash 预付卡
Banricard 预付卡
Socored 预付卡
Cielo 封闭安排信用卡
Cielo 封闭安排借记卡

source_sub_types 枚举值:​

枚举值描述
operation_disbursement操作放款
protest_expense抗议费用
automatic_integrated_payment自动集成支付
tax税款
electronic_funds_feeTED 手续费
credit_operation_fee信贷开户手续费
internal_funds_transfer内部转账
incoming_funds_transfer入账转账
outgoing_funds_transferTED
deposit存款
withdrawal转账
withdrawal_reversal转账冲销
trade_funds_transfer让渡支付转账
settlement_funds_transfer清算转账
bank_slip_feeBoleto 手续费
bank_slip_settlementBoleto 清算
outgoing_funds_transfer_reversalTED 冲销
incoming_funds_transfer_refusal转账被拒
electronic_funds_fee_reversalTED 手续费冲销
monthly_account_fee_reversal账户维护费冲销
bank_slip_fee_reversalBoleto 手续费冲销
correspondent_bank_transfer银行代理转账
credit_analysis_fee信贷分析手续费
credit_operation_fee_reversal信贷开户手续费冲销
financial_investments_income金融投资收益
bank_slip_settlement_reversalBoleto 清算冲销
bank_slip_settlement_expense_reversalBoleto 清算手续费冲销
bank_slip_settlement_incoming_reversalBoleto 清算收款冲销
correspondent_bank_transfer_reversal银行代理转账冲销
credit_analysis_fee_reversal信贷分析手续费冲销
doc_expense_reversalDOC 手续费冲销
incoming_doc_reversalDOC 入账冲销
operation_disbursement_reversal操作放款冲销
operation_settling_reversal操作付款冲销
outgoing_doc_reversalDOC 出账冲销
rebate_reversal返点冲销
settlement_funds_transfer_reversal清算转账冲销
tax_reversal税款冲销
trade_funds_transfer_reversal让渡支付转账冲销
bank_slip_permanency_fee票据保留手续费
bank_slip_cancel_protest_fee票据保留手续费
bank_slip_protest_fee申请抗议手续费
bank_slip_notary_office_fee公证处抗议费用
bank_slip_registration_fee登记手续费
bank_slip_extension_fee延期手续费
bank_slip_rebate_fee折扣手续费
bank_slip_discount_fee折扣手续费
bank_slip_settlement_fee清算手续费
bank_slip_write_off_term_fee到期注销手续费
bank_slip_write_off_fee注销手续费
bank_slip_cancel_protest_write_off_fee中止抗议并注销手续费
bank_slip_notary_office_settlement_fee公证处清算手续费
rebate_tax_free代收转付
rebate_tax_free_reversal代收转付冲销
incoming_funds_transfer_reversal内部转账冲销
bank_slip_paymentBoleto 支付
bank_slip_payment_reversalBoleto 支付冲销
warranty_analysis_fee担保分析手续费
bank_slip_settlement_depositBoleto 清算
bank_slip_payment_withdrawalBoleto 支付
account_setup_fee开户手续费
account_setup_fee_reversal开户手续费冲销
bank_slip_payment_withdrawal_reversalBoleto 支付冲销
incoming_anticipation_of_receivable-
incoming_credit_card_settlement信用卡清算
incoming_debit_card_settlement借记卡清算
assignment_automatic_transfer自动让渡扣款
assignment_automatic_transfer_reversal自动让渡扣款冲销
pix_feePIX 手续费
incoming_pix_transferPIX 入账
outgoing_pix_transferPIX 出账
pix_fee_reversalPIX 手续费冲销
incoming_pix_transfer_reversalPIX 入账冲销
outgoing_pix_transfer_reversalPIX 出账冲销
pix_depositPIX 存款
pix_withdrawalPIX 转账
pix_withdrawal_reversalPIX 转账冲销
pix_chargeback_withdrawal发送 PIX 退款
outgoing_pix_chargebackPIX 退款出账
incoming_pix_chargeback收到 PIX 退款
pix_chargeback_depositPIX 退款入账
pix_chargeback_withdrawal_reversal发送 PIX 退款冲销
outgoing_pix_chargeback_reversalPIX 退款出账冲销
incoming_pix_chargeback_reversal收到 PIX 退款冲销
operation_pix_disbursement操作 PIX 放款
operation_pix_disbursement_reversal操作 PIX 放款冲销
receivables_inquiry_fee应收账款查询手续费
pix_deposit_reversalPIX 存款冲销
internal_pix_transferPIX 转账
automatic_integrated_payment_reversal自动集成支付冲销
operation_dibursement_reversal操作放款冲销
available_yield流动性投资存款
bank_slip_convenant_payment协议 Boleto 支付

prepaid_card_transaction_type 枚举值:​

枚举值描述
purchase刷卡消费
international_purchase国际刷卡消费
withdrawalATM 取款

card_type 枚举值:​

枚举值描述
plastic实体卡
virtual虚拟卡