get
https://api-sandbox.asaas.com/v3/financialTransactions
Lista, de forma paginada, as movimentações financeiras registradas no extrato da conta Asaas.
Use esta operação para consultas históricas, conciliação e auditoria das movimentações que impactaram o saldo. Cada item representa um lançamento financeiro, e uma mesma operação pode gerar mais de um lançamento relacionado, como o recebimento de uma cobrança e a respectiva tarifa.
O extrato apresenta a movimentação financeira, mas não substitui os dados completos do recurso que a originou. Quando disponíveis, identificadores como paymentId, transferId, anticipationId, billId e outros permitem relacionar o lançamento ao recurso correspondente.
Interpretação de type
typeO campo type identifica a natureza da movimentação retornada no extrato.
Alguns tipos utilizados internamente são normalizados antes da resposta da API:
- débitos de transferências Pix são retornados como
TRANSFER; - tarifas desses débitos Pix são retornadas como
TRANSFER_FEE; - liquidações de parceiro de antecipação são retornadas como
RECEIVABLE_ANTICIPATION_DEBIT.
Por isso, PIX_TRANSACTION_DEBIT, PIX_TRANSACTION_DEBIT_FEE e RECEIVABLE_ANTICIPATION_PARTNER_SETTLEMENT não são retornados como valor de type por este endpoint.
Compatibilidade com novos tiposNovos valores de
typepodem ser adicionados conforme novos produtos e movimentações financeiras forem disponibilizados.Evite implementar validações que interrompam o processamento quando um tipo ainda não conhecido pela integração for recebido.
Tipos disponíveis
ASAAS_CARD_RECHARGE- Recarga de cartão AsaasASAAS_CARD_RECHARGE_REVERSAL- Estorno da recarga de cartãoASAAS_CARD_TRANSACTION- Transação efetuada com o cartão AsaasASAAS_CARD_CASHBACK- Cashback recebido com o cartão AsaasASAAS_CARD_TRANSACTION_FEE- Taxa para transação efetuada com o cartão AsaasASAAS_CARD_TRANSACTION_FEE_REFUND- Estorno de taxa para transação efetuada com o cartão AsaasASAAS_CARD_TRANSACTION_PARTIAL_REFUND- Estorno parcial de transação efetuada com o cartão AsaasASAAS_CARD_TRANSACTION_PARTIAL_REFUND_CANCELLATION- Cancelamento do estorno parcial de transação efetuada com o cartão AsaasASAAS_CARD_TRANSACTION_REFUND- Estorno de transação efetuada com o cartão AsaasASAAS_CARD_TRANSACTION_REFUND_CANCELLATION- Cancelamento do estorno de transação efetuada com o cartão AsaasASAAS_MONEY_PAYMENT_ANTICIPATION_FEE_REFUND- Estorno da taxa de parcelamento Asaas MoneyASAAS_MONEY_PAYMENT_COMPROMISED_BALANCE_REFUND- Cancelamento do bloqueio de saldo comprometido com pagamento Asaas MoneyASAAS_MONEY_PAYMENT_FINANCING_FEE_REFUND- Estorno da taxa de financiamento Asaas MoneyASAAS_MONEY_TRANSACTION_CASHBACK_REFUND- Estorno de cashback Asaas MoneyASAAS_MONEY_TRANSACTION_CHARGEBACK- Chargeback de transação Asaas MoneyASAAS_MONEY_TRANSACTION_CHARGEBACK_REVERSAL- Estorno de chargeback de transação Asaas MoneyBILL_PAYMENT- Pagamento de contaBILL_PAYMENT_CANCELLED- Cancelamento de pagamento de contaBILL_PAYMENT_REFUNDED- Estorno de pagamento de contaBILL_PAYMENT_FEE- Taxa de pagamento de contaBILL_PAYMENT_FEE_CANCELLED- Cancelamento da taxa de pagamento de contaCHARGEBACK- Bloqueio de saldo devido ao chargeback de cobrançaCHARGEBACK_REVERSAL- Cancelamento do bloqueio de saldo devido ao chargebackCHARGED_FEE_REFUND- Estorno da taxa para negativação da cobrança ou PixCONTRACTUAL_EFFECT_SETTLEMENT- Valor em recebíveis reservadoCONTRACTUAL_EFFECT_SETTLEMENT_REVERSAL- Estorno do valor em recebíveis reservadoCREDIT- CréditoCREDIT_BUREAU_REPORT- Taxa de consulta SerasaCUSTOMER_COMMISSION_SETTLEMENT_CREDIT- Crédito de liquidação de comissão de parceirosCUSTOMER_COMMISSION_SETTLEMENT_DEBIT- Débito de liquidação de comissão de parceirosDEBIT- DébitoDEBIT_REVERSAL- Estorno de débitoDEBT_RECOVERY_NEGOTIATION_FINANCIAL_CHARGES- Encargos sobre renegociaçãoFREE_PAYMENT_USE- Estorno por campanha promocional na tarifaINTERNAL_TRANSFER_CREDIT- Transferência da conta AsaasINTERNAL_TRANSFER_DEBIT- Transferência para a conta AsaasINTERNAL_TRANSFER_REVERSAL- Estorno de transferência para a conta AsaasINVOICE_FEE- Taxa de emissão da nota fiscal de serviçoPAYMENT_DUNNING_CANCELLATION_FEE- Taxa para cancelamento de negativação de cobrançaPAYMENT_DUNNING_RECEIVED_FEE- Taxa para negativação de cobrançaPAYMENT_DUNNING_RECEIVED_IN_CASH_FEE- Taxa para negativação em dinheiro de cobrançaPAYMENT_DUNNING_REQUEST_FEE- Taxa para negativação de cobrançaPAYMENT_FEE- Taxa de boleto, cartão ou PixPAYMENT_FEE_REVERSAL- Estorno da taxa de boleto, cartão ou PixPAYMENT_MESSAGING_NOTIFICATION_FEE- Taxa de mensageria de faturaPAYMENT_RECEIVED- Cobrança recebidaPAYMENT_CUSTODY_BLOCK- Bloqueio de saldo por custódiaPAYMENT_CUSTODY_BLOCK_REVERSAL- Desbloqueio de saldo por custódiaPAYMENT_REFUND_CANCELLED- Cancelamento do estorno de faturaPAYMENT_REVERSAL- Estorno de faturaPAYMENT_SMS_NOTIFICATION_FEE- Taxa de notificação por SMS de cobrançaPHONE_CALL_NOTIFICATION_FEE- Taxa de notificação por vozPIX_TRANSACTION_CREDIT- Transferência via Pix recebidaPIX_TRANSACTION_CREDIT_FEE- Taxa de transferência Pix recebidaPIX_TRANSACTION_CREDIT_REFUND- Estorno de recebimento via PixPIX_TRANSACTION_CREDIT_REFUND_CANCELLATION- Cancelamento de estorno de recebimento via PixPIX_TRANSACTION_DEBIT_REFUND- Estorno de transação via PixPOSTAL_SERVICE_FEE- Taxa de envio de boletos via CorreiosPRODUCT_INVOICE_FEE- Taxa de emissão da nota fiscal de produto emitida via Base ERPCONSUMER_INVOICE_FEE- Taxa de emissão da nota fiscal de consumidor emitida via Base ERPPROMOTIONAL_CODE_CREDIT- Desconto na taxaPROMOTIONAL_CODE_DEBIT- Estorno do desconto na taxaRECEIVABLE_ANTICIPATION_GROSS_CREDIT- Antecipação de parcelamento ou cobrançaRECEIVABLE_ANTICIPATION_DEBIT- Baixa da parcela ou antecipaçãoRECEIVABLE_ANTICIPATION_FEE- Taxa de antecipação de parcelamento ou cobrançaREFUND_REQUEST_CANCELLED- Cancelamento do estorno de faturaREFUND_REQUEST_FEE- Taxa de realização de estorno de faturaREFUND_REQUEST_FEE_REVERSAL- Cancelamento da taxa de realização de estorno de faturaREVERSAL- EstornoTRANSFER- Transferência para conta bancária, incluindo débitos Pix normalizados na respostaTRANSFER_FEE- Taxa de transferência, incluindo tarifas de débito Pix normalizadas na respostaMOBILE_PHONE_RECHARGE- Recarga de celularREFUND_MOBILE_PHONE_RECHARGE- Estorno de recarga de celularCANCEL_MOBILE_PHONE_RECHARGE- Cancelamento de recarga de celularINSTANT_TEXT_MESSAGE_FEE- Taxa de notificação por WhatsAppASAAS_CARD_BALANCE_REFUND- Estorno de cartão AsaasBACEN_JUDICIAL_LOCK- Bloqueio judicialBACEN_JUDICIAL_UNLOCK- Desbloqueio judicialBACEN_JUDICIAL_TRANSFER- Transferência judicialASAAS_DEBIT_CARD_REQUEST_FEE- Taxa de adesão do cartão Elo débitoASAAS_PREPAID_CARD_REQUEST_FEE- Taxa de adesão do cartão Elo pré-pagoEXTERNAL_SETTLEMENT_CONTRACTUAL_EFFECT_BATCH_CREDIT- Crédito de valores para liquidação de efeitos de contratoEXTERNAL_SETTLEMENT_CONTRACTUAL_EFFECT_BATCH_REVERSAL- Estorno de valores referentes à liquidação de efeitos de contratoASAAS_CARD_BILL_PAYMENT- Pagamento de fatura do cartão AsaasCHILD_ACCOUNT_KNOWN_YOUR_CUSTOMER_BATCH_FEE- Taxa de criação de contas filhasCONTRACTED_CUSTOMER_PLAN_FEE- Taxa da mensalidade do plano AsaasACCOUNT_INACTIVITY_FEE- Taxa de conta inativa
Tipos legados
Os tipos abaixo não são mais gerados para novas movimentações, mas podem aparecer na consulta de registros históricos:
ASAAS_MONEY_PAYMENT_ANTICIPATION_FEEASAAS_MONEY_PAYMENT_COMPROMISED_BALANCEASAAS_MONEY_PAYMENT_FINANCING_FEEASAAS_MONEY_TRANSACTION_CASHBACKPARTIAL_PAYMENT
Conteúdos relacionados
Guides
Biblioteca de Erros
Forbidden. Ocorre quando o body da requisição está preenchido, chamadas de método GET precisam ter um body vazio.