Referência da API
Página de statusDashboardAgende uma demonstração
Comece a digitar para pesquisar...

Campos de relatórios

Nesta seção, você pode encontrar todos os tipos de relatórios e campos relacionados disponíveis ao gerar seus relatórios. Leve em consideração a descrição dos campos, onde você pode encontrar a origem dos dados e sua disponibilidade.

O Yuno oferece vários tipos de relatórios:

Abaixo, você encontrará detalhes de cada tipo de relatório.

📘

Atualizações

Os campos do relatório estão sujeitos a modificações, e novos campos podem ser adicionados ao final da estrutura atual.

Relatório de pagamento

Detalhes do campo do relatório de pagamento
Parâmetro Tipo Descrição Exemplo
account_id string O identificador exclusivo da conta (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120002
airline_leg_arrival_airport string Código do aeroporto de destino para o trecho do voo. JFK
airline_leg_base_fare número Tarifa básica do trecho do voo antes de impostos e taxas. 250
airline_leg_base_fare_currency enum Moeda em que a tarifa básica é cobrada(ISO 4217). USD
airline_leg_carrier_code string Código da companhia aérea para o trecho do voo. AA
airline_leg_departure_airport string Código do aeroporto de partida para o trecho do voo. LAX
airline_leg_departure_datetime data e hora Data e hora da partida do voo. 2024-09-12 15:30
airline_leg_fare_basis_code string Código que define as regras de tarifa para o bilhete. Y26HNR
airline_leg_fare_class_code string Código da classe da passagem (por exemplo, econômica, executiva). Y
airline_leg_flight_number string Número do voo para o trecho específico. 100
airline_leg_stopover_code enum Indica se o voo tem uma escala (S/N). N
airline_passenger_country string País de residência do passageiro. EUA
airline_passenger_date_of_birth data Data de nascimento do passageiro. 1990-05-14
airline_passenger_document_number string Número do documento de identificação do passageiro. A12345678
airline_passenger_document_type enum Tipo de documento de identificação (por exemplo, passaporte, carteira de identidade). PASSAPORTE
airline_passenger_email string Endereço Email do passageiro. email protected]
airline_passenger_first_name string Primeiro nome do passageiro. João
airline_passenger_last_name string Sobrenome do passageiro. Doe
airline_passenger_loyalty_number string Número do programa de fidelidade do passageiro. 123456789
airline_passenger_loyalty_tier enum Nível do programa de fidelidade do passageiro (por exemplo, Gold, Platinum). Ouro
airline_passenger_middle_name string Nome do meio do passageiro (se aplicável). Andrew
airline_passenger_nationality string Nacionalidade do passageiro. EUA
airline_passenger_phone_country_code string Código do país para o número de telefone do passageiro. 1
airline_passenger_phone_number string Número de telefone do passageiro. 555-1234
airline_passenger_type enum Tipo de passageiro (por exemplo, adulto, criança, bebê). Adulto
airline_ticket_e_ticket booleano Indica se o tíquete é eletrônico (verdadeiro/falso). VERDADEIRO
airline_ticket_issue_address string Endereço onde a multa foi emitida. 123 Main St
airline_ticket_issue_carrier_prefix_code string Código do prefixo da companhia aérea emissora. 1
airline_ticket_issue_city string Cidade onde a multa foi emitida. Nova York
airline_ticket_issue_country string País onde o bilhete foi emitido. EUA
airline_ticket_issue_date data Data em que o bilhete foi emitido. 2024-09-10
airline_ticket_issue_travel_agent_code string Código do agente de viagens que emitiu o bilhete. TA123
airline_ticket_issue_travel_agent_name string Nome do agente de viagens que emitiu a passagem. Viagem de John Doe
airline_ticket_issue_zip_code string Código postal de onde o bilhete foi emitido. 10001
airline_ticket_restricted booleano Indica se o tíquete tem restrições (verdadeiro/falso). FALSO
airline_ticket_ticket_number string Número exclusivo atribuído ao tíquete. 1234567890123
airline_ticket_total_fare_amount número Valor total pago pelo bilhete. 300
airline_ticket_total_fee_amount número Total de taxas adicionais aplicadas ao bilhete. 50
airline_ticket_total_tax_amount número Total de impostos aplicados ao bilhete. 25
amount_value número O valor payment (múltiplo de 0,0001). 111111
bank_name string Nome do banco associado à transação. Wells Fargo
beneficiary_name string Nome do beneficiário da transação ou do pagamento. Jane Doe
bnpl_installments string As parcelas do empréstimo (MAX 50; MIN 1). 12
browser_info_accept_header string O cabeçalho "accept" enviado pelo navegador. text/html
browser_info_color_depth número Profundidade de cor suportada pela tela do navegador (em bits). 24
browser_info_javascript_enabled booleano Indica se o JavaScript está ativado no navegador. VERDADEIRO
browser_info_language string Idioma padrão definido no navegador. en-US
browser_info_screen_height número Altura da tela do navegador em pixels. 1080
browser_info_screen_width número Largura da tela do navegador em pixels. 1920
browser_info_user_agent string Cadeia de caracteres do agente do usuário que representa o navegador e o sistema operacional. Mozilla/5.0
captured número Indica o valor total capturado para pagamento. 1000.00
card_brand string Marca do cartão usado na transação (por exemplo, Visa, MasterCard). Visto
card_category string Categoria do cartão (por exemplo, crédito, débito). Crédito
card_holder_name string Nome do titular do cartão. John Doe
card_iin string Número de identificação do emissor (IIN) do cartão (6 primeiros dígitos). 123456
card_issuer_code string Código que identifica o emissor do cartão. CITI123
card_issuer_name string Nome do banco ou instituição que está emitindo o cartão. Banco Citi
card_lfd número Os últimos quatro dígitos do número do cartão. 7890
card_type enum Tipo de cartão (por exemplo, crédito, débito). Crédito
checkout_session string Identificador exclusivo para a sessão de checkout. ch_sess_12345
country enum O país em que a transação deve ser processada (MAX 2; MIN 2; ISO 3166-1). EUA
created_at carimbo de data/hora A data de criação do pagamento (MAX 27; MIN 27; ISO 8601). 2022-05-09T20:46:54.786342Z
currency enum A moeda usada para fazer o pagamento (MAX 3; MIN 3; ISO 4217). COP
customer_first_name string O primeiro nome do cliente (MAX 255; MIN 1). João
customer_id string O identificador exclusivo do cliente (MAX 255; MIN 3). 23456
customer_last_name string O sobrenome do cliente (MAX 255; MIN 1). Doe
customer_payer_phone_country_code número O código do país do cliente (MAX 3; MIN 2). 52
customer_payer_phone_number número O número de telefone do cliente (MAX 255; MIN 1). 3313873320
date_of_birth data Data de nascimento do indivíduo. 1985-07-28
description string A descrição do payment (MAX 255; MIN 3). Pedido1234
device_fingerprint string Identificador exclusivo do dispositivo usado na transação. df_987654321
document_number string Número do documento do indivíduo. A98765432
document_type enum Tipo de documento (por exemplo, carteira de identidade, passaporte). ID
email string O e-mail do cliente (MAX 255; MIN 3). email protected]
gender enum Gênero do indivíduo. Masculino
installments número Número de parcelas para o pagamento. 6
ip_address string O endereço IP do cliente (MAX 255; MIN 3). 2806:103e:2a:414
merchant_customer_id enum Um identificador exclusivo atribuído por um comerciante para representar um cliente específico (MAX 255; MIN 3). 9440127422
merchant_order_id string A identificação do pedido (MAX 255; MIN 3). 123456789
nationality string Nacionalidade do indivíduo. EUA
network_token string Número Token sem separadores (MÁX. 19; MÍN. 8) disponível apenas para comerciantes certificados pela PCI. 1234567890123456
network_transaction_id string Identificador único atribuído a uma transação pela rede do cartão. É utilizado para rastrear e referenciar transações específicas, particularmente em cenários de pagamentos recorrentes, garantindo consistência e rastreabilidade ao longo do ciclo de vida do pagamento. (MÁX. 255; MÍN. 3) NTX123456789
order_fee_amount número Total de taxas aplicadas ao pedido. 10
order_item_brand string Marca do item no pedido. Nike
order_item_category string Categoria do item no pedido. Calçados
order_item_id string Identificador exclusivo do item no pedido. item_12345
order_item_manufacture_part_number string Número de peça do fabricante para o item. MP56789
order_item_name string Nome do item no pedido. Air Max 2024
order_item_quantity número Quantidade do item no pedido. 2
order_item_sku_code string Código SKU do item no pedido. SKU98765
order_item_unit_amount número Preço unitário do item. 150
order_shipping_amount número Custo de envio do pedido. 20
payment_callback_url string Um endpoint de URL fornecido pelo comerciante. https://www.domain.com
payment_id string Um identificador exclusivo atribuído a uma transação de pagamento específica. 69ad0a39-b769-423c-b223-d7b8bf
payment_seller_details_address_city string Cidade do endereço do vendedor. Miami
payment_seller_details_address_country string País do endereço do vendedor. EUA
payment_seller_details_address_line_1 string Primeira linha do endereço do vendedor. 456 Market St
payment_seller_details_address_line_2 string Segunda linha do endereço do vendedor. Apto 202
payment_seller_details_address_state string Estado ou província do endereço do vendedor. FL
payment_seller_details_address_zip_code string Código postal do endereço do vendedor. 33101
payment_seller_details_country string País onde o vendedor está sediado. EUA
payment_seller_details_document_number string Número do documento do vendedor. 98765432
payment_seller_details_document_type enum Tipo de documento do vendedor (por exemplo, identidade, passaporte). ID
payment_seller_details_email string Endereço email do vendedor. email protected]
payment_seller_details_industry string O setor ao qual o vendedor pertence. Varejo
payment_seller_details_name string Nome do vendedor. Melhor loja
payment_seller_details_phone_code string Código do país para o número de telefone do vendedor. 1
payment_seller_details_phone_number string Número de telefone do vendedor. 123-456-7890
payment_seller_details_reference string Referência interna para o vendedor. ref_789456
payment_seller_details_web_site string URL do site do vendedor. www.domain.com
payment_tax_base número Valor base usado para calcular o imposto. 100
payment_tax_percentage número Porcentagem do imposto aplicado à transação. 10
payment_tax_type string Tipo de imposto aplicado (por exemplo, IVA, GST). IVA
payment_tax_value número O valor do imposto calculado. 10
payment_workflow string Fluxo de trabalho usado para o processo de pagamento. padrão
pnr string Referência do registro de nome de passageiro (PNR). 1P-2UUGJW
provider_number inteiro O número do bilhete. 13141
refunded número O valor do pagamento que foi reembolsado. 10000
sdk_action_required booleano Um campo booleano que indica se é necessária uma ação adicional do cliente ou do comerciante. VERDADEIRO
status enum O status do pagamento (MAX 255; MIN 3). SUCCEEDED
sub_status enum O status do pagamento (MAX 255; MIN 3). APROVADO
subscription_id string Um identificador exclusivo atribuído a uma assinatura recorrente ou contrato de faturamento. 111aaa222
updated_at carimbo de data/hora A data e a hora da última atualização do pagamento. 2022-05-15T20:46:54.786342Z

Relatório de transação

Detalhes do campo do relatório de transação
Parâmetro Tipo Descrição Exemplo
account_id string Identificador exclusivo da conta (MAX 64; MIN 36). 2c05976d-f696-497f-a309-6421883de48d
account_integration_id string Identificador exclusivo da integração da conta (MAX 64; MIN 36). 6a0f939c-0cd1-4350-acbc-b0cbdbee9739
amount número Valor da transação (MAX 10000; MIN 0). 887
authorization_code string Código de autorização da transação (MAX 6; MIN 6). 161058
bank_name string Nome do banco envolvido na transação (MAX 100; MIN 3). Banco ABC
bank_transfer_account string Detalhes da conta de transferência bancária (MAX 255; MIN 3). 12345678901234567
bank_transfer_account_2 string Detalhes da conta de transferência bancária secundária (MAX 255; MIN 3). 76543210987654321
bank_transfer_account_type enum Tipo da conta de transferência bancária (MAX 20; MIN 3). Verificação
bank_transfer_payment_instruction string Instruções para pagamentos por transferência bancária (MAX 255; MIN 3). O pagamento deve ser concluído em até 48 horas.
beneficiary_document string Identificador de documento do beneficiário (MAX 20; MIN 5). 123456789
beneficiary_document_type enum Tipo de documento do beneficiário (MAX 10; MIN 3). Passaporte
beneficiary_name string Nome completo do beneficiário (MAX 255; MIN 3). John Doe
capture booleano Indica se a transação foi capturada. VERDADEIRO
card_brand string Marca do cartão usado (MAX 50; MIN 2). VISA
card_category string Categoria do cartão usado (MAX 50; MIN 2). CLÁSSICO
card_holder_name string Nome do titular do cartão (MAX 255; MIN 3). Jane Doe
card_iin string Número de identificação do emissor (IIN) do cartão (MAX 8; MIN 6). 49296404
card_issuer_code string Código do emissor do cartão (MAX 50; MIN 2). BCO001
card_issuer_name string Nome do emissor do cartão (MAX 100; MIN 3). Banco ABC
card_lfd string Os últimos quatro dígitos do número do cartão (MAX 4; MIN 4). 1228
card_number_length número Comprimento do número do cartão (MAX 19; MIN 12). 16
card_security_code_length número Comprimento do código de segurança do cartão (MAX 4; MIN 3). 3
card_type enum Tipo de cartão utilizado (CRÉDITO ou DÉBITO). CRÉDITO
card_expiration_month número Mês de vencimento do cartão (MAX 2; MIN 1). 10
card_expiration_year número Ano de validade do cartão (MAX 2; MIN 2). 10
country enum País onde a transação ocorreu (MAX 2; MIN 2). UY
created_at carimbo de data/hora Registro de data e hora em que a transação foi criada(ISO 8601). 2024-09-11T23:16:06.602Z
currency enum Código da moeda para a transação (MAX 3; MIN 3). UYU
customer_first_name string Primeiro nome do cliente (MAX 255; MIN 3). Jane
customer_id string Identificador exclusivo do cliente (MAX 64; MIN 36). f4c53557-a832-44e9 -94e4-0344f91e9d4f
customer_last_name string Sobrenome do cliente (MAX 255; MIN 3). Doe
description string Descrição da transação (MAX 255; MIN 3). Comércio eletrônico do comerciante
document_number string Número do documento do cliente (MAX 20; MIN 5). 48054205
document_type string Tipo de documento do cliente (MAX 10; MIN 2). CI
email string Endereço Email do cliente (MAX 255; MIN 3). email protected]
first_installments_deferral string Detalhes do diferimento da primeira parcela (MAX 255; MIN 3). Sem adiamento
fraud_screening_provider_score número Pontuação de triagem de fraude fornecida pelo sistema de detecção de fraude (MAX 100; MIN 0). 85
installments número Número de parcelas da transação (MAX 24; MIN 1). 1
installments_amount número Valor total das parcelas (MAX 10000; MIN 0). 887
installments_type string Tipo de plano de parcelas (MAX 50; MIN 3). Pagamento único
merchant_order_id string Identificador de pedido do comerciante (MAX 64; MIN 36). NC2- 66e224a53fb722eaa0507579
merchant_transaction_id string Identificador de transação do comerciante (MAX 64; MIN 36). NC2- 66e224a53fb722eaa0507579
merchant_advice_code string Código de aviso ao comerciante normalizado para transações recusadas; use-o para orientar o comportamento de nova tentativa e o roteamento. 01
merchant_advice_code_message string Mensagem legível que explica o aviso retornado em merchant_advice_code. Repetir após 24 horas
merchant_customer_id string O identificador exclusivo do cliente no comerciante externo (MAX 255; MIN 3). 9440127422
nationality string Nacionalidade do cliente (MAX 3; MIN 2). UY
network_token string Número Token sem separadores (MÁX. 19; MÍN. 8) disponível apenas para comerciantes certificados pela PCI. 1234567890123456
network_transaction_id string Identificador único atribuído a uma transação pela rede do cartão. É utilizado para rastrear e referenciar transações específicas, particularmente em cenários de pagamentos recorrentes, garantindo consistência e rastreabilidade ao longo do ciclo de vida do pagamento. (MÁX. 255; MÍN. 3) NTX123456789
payment_id string Identificador exclusivo para o pagamento (MAX 64; MIN 36). 49b08cf9-c577-4451- a673-2dc1ae930200
payment_link_fee_details string Detalhes de quaisquer taxas associadas ao link de pagamento (MAX 255; MIN 3). Sem taxas adicionais
payment_link_money_release_date carimbo de data/hora Data em que o dinheiro do link de pagamento será liberado(ISO 8601). 2024-09-15
payment_link_payment_method_detail string Detalhes do método de pagamento usado no link de pagamento (MAX 255; MIN 3). Cartão VISA que termina em 1228
payment_link_payment_method_id string Identificador exclusivo do método de pagamento no link de pagamento (MAX 64; MIN 36). PLPMID123456
payment_link_sponsor_id string Identificador exclusivo do patrocinador do link de pagamento (MAX 64; MIN 36). PLS123456
payment_method_category enum Categoria do método de pagamento (CARD, BANK_TRANSFER, etc.). CARTÃO
payment_method_type enum Tipo de método de pagamento (CARD, BANK_TRANSFER, etc.). CARTÃO
pnr string Registro do nome do passageiro, se aplicável (MAX 64; MIN 36). 987654321
provider_account_id string Identificador de conta do provedor (MAX 64; MIN 36). 699ec8d444
provider_expiration_date carimbo de data/hora Data de validade fornecida pelo provedor(ISO 8601). 2024-12-31
provider_id string Identificador exclusivo do provedor (MAX 64; MIN 36). ID DO FORNECEDOR
provider_merchant_advice_code string Raw Merchant Advice Code retornado pelo provedor para transações recusadas. R1
provider_merchant_advice_code_message string Mensagem do provedor que explica o significado do Merchant Advice Code bruto. Emissor indisponível
provider_image string URL da imagem ou do logotipo do provedor (MAX 255; MIN 3). https://example.com/logo.png
provider_number string Número do provedor (MAX 64; MIN 36). 12345
provider_response_code string Código de resposta do provedor (MAX 255; MIN 3). 200
provider_response_message string Mensagem de resposta do provedor (MAX 255; MIN 3). O pagamento foi efetuado.
provider_status string Status do pagamento no provedor (MAX 255; MIN 3). PAGO
provider_status_detail string Status detalhado do provedor (MAX 255; MIN 3). Transação concluída com êxito.
provider_third_party_account_id string ID da conta de terceiros associada ao provedor (MAX 64; MIN 36). ACC123456
provider_third_party_transaction_id string ID de transação de terceiros associada ao provedor (MAX 64; MIN 36). TID123456
provider_transaction_id string Identificador de transação exclusivo do provedor (MAX 64; MIN 36). T-51056-1e10f992-e5cf- 40bf-9eb6-8edc881de30b
reason string Motivo da transação (MAX 255; MIN 3). Pagamento do pedido do comerciante
redirect_url string URL para onde o usuário será redirecionado após o pagamento (MAX 255; MIN 3). https://example.com/redirect-url
refund_execution_origin string Origem da execução do reembolso (MAX 255; MIN 3). Solicitação do cliente
refund_execution_user string Usuário que executou o reembolso (MAX 255; MIN 3). RefundServiceAgent
response_code string Código de resposta do sistema (MAX 255; MIN 3). 200
response_message string Mensagem de resposta do sistema (MAX 255; MIN 3). Pagamento bem-sucedido.
retrieval_reference_number string Número de referência para recuperar detalhes da transação (MAX 255; MIN 3). 1234567890
soft_descriptor string O descritor de software exibido no extrato bancário do cliente (MAX 22; MIN 3). COMÉRCIO ELETRÔNICO COMERCIAL
status enum Status da transação (MAX 50; MIN 2). PAGO
subscription_id string Identificador exclusivo de uma assinatura associada à transação (MAX 64; MIN 36). SUB123456
three_d_secure_cryptogram string Dados do criptograma usados na autenticação do 3D Secure (MAX 255; MIN 3). ABCDEFG12345
three_d_secure_directory_server_transaction_id string ID de transação do servidor de diretório para autenticação 3D Secure (MAX 255; MIN 3). 3DSTID123456
three_d_secure_electronic_commerce_indicator string Indicador de comércio eletrônico para autenticação 3D Secure (MAX 255; MIN 3). ECI05
three_d_secure_setup_id string ID de configuração para autenticação 3D Secure (MAX 255; MIN 3). SETUP123456
three_d_secure_transaction_id string ID da transação para autenticação 3D Secure (MAX 255; MIN 3). 3DSTXID123456
three_d_secure_version string Versão do protocolo 3D Secure usado (MAX 255; MIN 3). 2.1.0
has_challenge booleano Indica se a transação tem uma etapa de desafio (3D Secure). FALSO
ticket_provider_barcode string Código de barras fornecido pelo fornecedor do tíquete (MAX 255; MIN 3). 123456789
ticket_provider_format string Formato do tíquete fornecido pelo provedor (MAX 255; MIN 3). PDF
ticket_provider_logo string Logotipo do fornecedor do ingresso (MAX 255; MIN 3). https://example.com/logo.png
token string Token gerado para a transação (MAX 255; MIN 3). fa476a40-854c-4e66 -9a98-55a68a6b88f4
transaction_id string Identificador exclusivo da transação (MAX 64; MIN 36). b04db1c6-b2c7-4765-a77e-953d284d080b
type string Tipo de transação (MAX 50; MIN 2). COMPRAR
updated_at carimbo de data/hora Carimbo de data e hora da última atualização da transação(ISO 8601). 2024-09-11T23:17:07.602Z
vault_on_success booleano Indica se o armazenamento deve ocorrer após o sucesso da transação. FALSO
vaulted_token string Token gerado para um cartão abobadado (MAX 255; MIN 3). fa476a40-854c-4e66- 9a98-55a68a6b88f4
verify booleano Indica se a verificação foi realizada. FALSO
wallet string Carteira associada à transação (MAX 255; MIN 3). Carteira ABC
wallet_transaction_card_bin string O número de identificação do emissor (IIN) refere-se aos primeiros dígitos do número do cartão de pagamento emitido por uma instituição financeira (MÁX. 8; MÍN. 6). 492964
wallet_transaction_card_last_4_digits string Os últimos quatro dígitos do cartão (MAX 4; MIN 4). 1228

Relatório de reconciliação de transações

📘

As colunas a seguir são mapeadas mediante solicitação; você pode solicitá-las ao ativar o módulo de reconciliações. Entre em contato com o suporte para obter mais detalhes.

  • description
  • provider_card_brand
  • card_issuer_name
  • card_issuer_country
  • reconciliation_settlement_date
  • local_amount
  • local_retention
  • local_tax
  • provider_fees
  • provider_fee_taxes
  • net_amount
  • card_expiration_month
  • card_expiration_year
  • estimated_settlement_date
  • retrieval_reference_number
Detalhes do campo do relatório de reconciliação de transações
Parâmetro Tipo Descrição Exemplo
account_id string O identificador exclusivo da conta (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120002
country enum O país em que a transação deve ser processada (MAX 2; MIN 2; ISO 3166-1). EUA
type enum O tipo de transação (MAX 255; MIN 3). COMPRAR
payment_method_category enum Categoria da transação (MAX 255; MIN 3). BANK_TRANSFER
payment_method_type enum O tipo de método de pagamento selecionado pelo cliente (MAX 255; MIN 3). BANKABC_TRANSFER
provider_id enum A ID do provedor que processou a transação. ID DO FORNECEDOR
customer_id string O identificador exclusivo do cliente (MAX 255; MIN 3). 23456
payment_id string O identificador exclusivo do pagamento (MAX 64; MIN 36). 5104911d-5df9-229e-8468-bd41abea1
merchant_order_id string Identificação do pedido atribuído por sua empresa (MAX 255; MIN 3). 123456789
merchant_transaction_id string Identificação da transação atribuída por sua empresa (MAX 255; MIN 3). 987654321
transaction_id string O identificador exclusivo da transação atribuído pela Yuno (MAX 64; MIN 36). 9104911d-5df9-429e-8488-ad41abea1a4b
provider_transaction_id string O identificador exclusivo da transação do provedor (MAX 255; MIN 3). 53443e9c-dd17-11ec-9d64-0242ac120002
third_party_transaction_id string O identificador exclusivo de uma transação de terceiros (MAX 255; MIN 3). 69ad0a39-b769-423c-b223-d7b8bf9a1c2d
status string O status da transação (MAX 255; MIN 3). SUCCEEDED
response_code string O código que representa a resposta ao resultado da transação. SUCCEEDED
provider_status string O status da transação do provedor (MAX 255; MIN 3). Autorizado
amount número O valor da transação. 100
currency enum A moeda usada para fazer o pagamento (MAX 3; MIN 3; ISO 4217). COP
card_type string O tipo do emissor do cartão (MAX 255; MIN 3). CRÉDITO
card_expiration_month número Mês de vencimento do cartão (MAX 2; MIN 1). 10
card_expiration_year número Ano de validade do cartão (MAX 2; MIN 2). 10
card_brand string As informações de marca do cartão (MAX 255; MIN 3). VISA
provider_card_brand string O método de pagamento ou a marca do cartão (MAX 255; MIN 3). ABC
retrieval_reference_number string Número de referência exclusivo para recuperação de transações (MAX 255; MIN 3). CAQMCAQRisS2iL
card_category enum Categoria do cartão usado na transação (MAX 255; MIN 3). CLÁSSICO
card_iin número O número de identificação do emissor (IIN) refere-se aos primeiros dígitos de um número de cartão de pagamento emitido por uma instituição financeira (MAX 8; MIN 8). 123456
card_lfd número Os últimos quatro dígitos do cartão (MAX 4; MIN 4). 7890
card_issuer_name enum Banco ao qual o cartão corresponde. Banco ABC
card_issuer_country enum País em que a liquidação foi feita (MAX 2; MIN 2). UY
authorization_code string O código de resposta do adquirente. 742A64
installments número No caso de uma transação com cartão, o número de parcelas em que o pagamento foi solicitado (MAX 2; MIN 1). 1
pnr string O registro do nome do passageiro (MAX 255; MIN 3). 1P-2UUGJW
created_at carimbo de data/hora Data de criação da transação (MAX 27; MIN 27; ISO 8601). 2022-05-09T20:46:54.786342Z
updated_at carimbo de data/hora A data e a hora da última vez em que a transação foi atualizada. 2022-05-15T20:46:54.786342Z
reconciliation_status enum O status de reconciliação de uma transação (MAX 255; MIN 3). RECONCILIADO
reconciliation_sub_status enum O status de reconciliação de uma transação (MAX 255; MIN 3). AUTOMATICAMENTE
reconciliation_date string A data em que a transação foi reconciliada (MAX 27; MIN 27; ISO 8601). 2022-05-09T20:46:54.786342Z
reconciliation_id enum O identificador exclusivo atribuído a uma transação quando ela é reconciliada (MAX 255; MIN 3). 2478d494-4a20-45b1-8a12-1c2604cf2d1d
reconciliation_settlement_date carimbo de data/hora Data em que os fundos serão depositados na conta bancária do comerciante pelo adquirente. 2022-05-09 0:00

Relatório de liquidação

📘

O relatório de liquidações agora suporta a seleção de fuso horário para transaction_datesemelhante ao relatório Transações. O formato da data agora é ISO 8601 (por exemplo, 2023-12-11T01:14:38.000Z para UTC, 2023-02-23T17:39:36.065+01:00 para UTC+1). Atualize todas as automações que dependem desse formato de campo.

O relatório de liquidação tem dois tipos de relatórios:

  • Cabeçalho: Mostra o resumo da liquidação.
  • Corpo: mostra os dados de cada cabeçalho.
Detalhes do campo do relatório de liquidação - Cabeçalho
Parâmetro Tipo Descrição Exemplo
type string Tipo de linha. Valor: HEADER (MÁXIMO 255; MÍNIMO 3). CABEÇALHO
acquirer enum Nome do adquirente que processou o pagamento original. Nos modelos de agregador, o provedor é o mesmo que o adquirente. Em outros modelos, eles podem ser entidades diferentes (MAX 255; MIN 3). Adquirente ABC
number_of_transactions número Total de transações contidas no relatório para o adquirente (MAX 255; MIN 1). 15
gross_currency enum Código da moeda em que as transações foram feitas (MAX 3; MIN 3; ISO 4217). USD
gross_credit decimal Para transações de crédito, o valor bruto correspondente (múltiplo de 0,0001). 1000.0
gross_debit decimal Para transações de débito, o valor bruto correspondente (múltiplo de 0,0001). 1000.0
settlement_currency enum Código da moeda em que a liquidação foi feita (MAX 3; MIN 3; ISO 4217). USD
settlement_gross_amount decimal O valor bruto correspondente a todas as transações na moeda de liquidação (múltiplo de 0,0001). 100.0
settlement_credit_fees decimal Taxa de comissão que foi retida pelo adquirente em transações de crédito na moeda de liquidação. Esse valor deve ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 15.0
settlement_debit_fees decimal Taxa de comissão que foi retida pelo adquirente em transações de débito na moeda de liquidação. Esse valor deve ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 5.0
settlement_fee_taxes decimal Imposto sobre a taxa de comissão que foi retido pelo adquirente na moeda de liquidação. Esse valor deve ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 0.10
settlement_taxes decimal Valor dos impostos aplicados às transações na moeda de liquidação. Essa deve ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 1.0
settlement_net_credit decimal Valor enviado nas solicitações de transação de crédito menos as taxas do adquirente na moeda de liquidação (múltiplo de 0,0001). 970.0
settlement_net_debit decimal Valor enviado nas solicitações de transação de débito menos as taxas do adquirente na moeda de liquidação (múltiplo de 0,0001). 970.0
settlement_net_balance decimal Valor líquido de crédito/débito na moeda de liquidação (múltiplo de 0,0001). 1000.0
settlement_batch_id(A) string Esse campo contém o número exclusivo do lote de liquidação do adquirente que pode ser encontrado em seu extrato bancário para o depósito correspondente (MAX 255; MIN 3). SETT-111450235000
settlement_date(A) data Data estimada pelo adquirente em que os fundos serão depositados na conta bancária do comerciante. 2022-05-09
country(A) enum País da conta do comerciante (ISO 3166-1). EUA
Detalhes do campo do relatório de liquidação - Corpo
Parâmetro Tipo Descrição Exemplo
account_id(A) string O ID da conta do comerciante (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120002
provider_merchant_id(A) string ID do comerciante no sistema PSP (MAX 255; MIN 3). 15a8c304-d334-4da7-bccb-09cf85a1d7a6
country(A) enum País da conta do comerciante(ISO 3166-1). EUA
settlement_batch_id(A) string Esse campo contém o número exclusivo do lote de liquidação do adquirente que pode ser encontrado em seu extrato bancário para o depósito correspondente (MAX 255; MIN 3). SETT-111450235000
settlement_date(A) data Data estimada pelo adquirente em que os fundos serão depositados na conta bancária do comerciante. 2022-05-09
payment_method_category enum Categoria da transação (MAX 255; MIN 3). BANK_TRANSFER
payment_method_type enum O tipo de método de pagamento selecionado pelo cliente (MAX 255; MIN 3). BANKABC_TRANSFER
provider_id enum Identificação do provedor (MAX 255; MIN 3). ID DO FORNECEDOR
acquirer enum Nome do adquirente que processou o pagamento original. Nos modelos de agregador, o provedor é o mesmo que o adquirente. Em outros modelos, eles podem ser entidades diferentes (MAX 255; MIN 3). Adquirente ABC
payment_id string O identificador exclusivo do pagamento (MAX 64; MIN 36). 5104911d-5df9-229e-8468-bd41abea1
merchant_order_id(A) string Identificação do pedido (MAX 255; MIN 3). abc123456789
merchant_transaction_id string Identificação da transação atribuída pelo comerciante (MAX 255; MIN 3). 987654321
transaction_id(A) string O identificador exclusivo da transação atribuído pela Yuno (MAX 64; MIN 36). 9104911d-5df9-429e-8488-ad41abea1a4b
provider_transaction_id(A) string O identificador exclusivo da transação atribuído pelo gateway. Esse campo estará vazio se o gateway não fornecer informações sobre a transação (MAX 255; MIN 3). 53443e9c-dd17-11ec-9d64-0242ac120002
third_party_transaction_id string O identificador exclusivo de uma transação de terceiros (MAX 255; MIN 3). 69ad0a39-b769-423c-b223-d7b8bf9a1c2d
transaction_date carimbo de data/hora Data de criação da transação (MAX 27; MIN 27) 2022-05-09 20:46:54.000
type string O tipo de transação. Exibimos os tipos enviados pelo provedor (MAX 255; MIN 3). COMPRAR
gross_currency enum Código da moeda em que a transação foi feita (MAX 3; MIN 3; ISO 4217). USD
gross_credit decimal Para transações de crédito, o valor bruto correspondente (múltiplo de 0,0001). 1000.0
gross_debit decimal Para transações de débito, o valor bruto correspondente (múltiplo de 0,0001). 1000.0
fee_rate(A) decimal Valor percentual da taxa retida pelo adquirente. Esse campo estará vazio se o adquirente não fornecer informações sobre a transação. 15
settlement_currency enum Código da moeda em que a liquidação foi feita (MAX 3; MIN 3; ISO 4217). USD
fx_rate decimal A taxa de câmbio aplicada à transação no momento da liquidação (múltiplo de 0,0001). 10
settlement_gross_amount decimal O valor bruto correspondente a todas as transações na moeda de liquidação (múltiplo de 0,0001). 100.0
settlement_fees decimal A taxa de comissão que foi retida pelo adquirente em transações na moeda de liquidação. Esse valor deve ser ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 15.0
settlement_fee_taxes decimal O imposto sobre a taxa de comissão que foi retido pelo adquirente na moeda de liquidação. Esse valor deve ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 0.10
settlement_taxes decimal O valor dos impostos aplicados às transações na moeda de liquidação. Essa deve ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 1.0
settlement_cost_of_installments decimal A taxa de comissão que foi retida pelo adquirente para parcelas antecipadas na moeda de liquidação (múltiplo de 0,0001). Essa deve ser a diferença entre os valores bruto e líquido. 15.0
settlement_net_credit decimal O valor enviado nas solicitações de transação de crédito menos as taxas do adquirente na moeda de liquidação (múltiplo de 0,0001). 970.0
settlement_net_debit decimal O valor enviado nas solicitações de transação de débito menos as taxas do adquirente na moeda de liquidação (múltiplo de 0,0001). 970.0
settlement_net_amount decimal O valor líquido correspondente a todas as transações na moeda de liquidação (múltiplo de 0,0001). 100.0
card_type enum Tipo de cartão usado na transação (MAX 7; MIN 5). CRÉDITO
card_brand enum Marca do cartão usado na transação (MAX 255; MIN 3). VISA
card_category enum Categoria do cartão usado na transação (MAX 255; MIN 3). prêmio
card_iin(A) número O número de identificação do emissor (IIN) refere-se aos primeiros dígitos de um número de cartão de pagamento emitido por uma instituição financeira (MAX 8; MIN 8). 123456
card_lfd(A) número Os últimos quatro dígitos do cartão (MAX 4; MIN 4). 7890
authorization_code(A) string No caso de uma transação com cartão, o código atribuído pelo banco emissor à transação quando ela é autorizada. Esse campo estará vazio se o gateway não fornecer informações sobre a transação (MAX 255; MIN 3). 123456
customer_id(A) string O identificador exclusivo do cliente (MAX 255; MIN 3). 23456
voucher(A) string No caso de uma transação com cartão, o identificador exclusivo do recibo de pagamento atribuído pelo banco emissor. banco emissor. Esse campo estará vazio se o gateway não fornecer informações sobre a transação (MAX 255; MIN 3). 43564
installments número No caso de uma transação com cartão, o número de parcelas em que o pagamento foi solicitado (MAX 2; MIN 1). 1
installment_number(A) string No caso de uma transação de cartão em parcelas, o número da parcela que está sendo liquidada nesse lote. Se o pagamento da parcela for feito em um único lote, o campo estará vazio (MAX 6; MIN 3). 1/3
pnr string O registro do nome do passageiro (MAX 255; MIN 3). 1P-2UUGJW
reconciliation estrutura Estrutura de informações de reconciliação que contém detalhes de status, data e ID. {"status": "RECONCILED", "date": "2022-05-09"}
reconciliation_status enum O status de reconciliação de uma transação (MAX 255; MIN 3). RECONCILIADO
reconciliation_sub_status enum O status de reconciliação de uma transação (MAX 255; MIN 3). AUTOMATICAMENTE
reconciliation_date data A data em que a transação foi reconciliada (MAX 27; MIN 27). 2022-05-09 20:46:54.000
reconciliation_id string O identificador exclusivo atribuído a uma transação quando ela é reconciliada (MAX 255; MIN 3). 2478d494-4a20-45b1-8a12-1c2604cf2d1d
legal_entity string A entidade legal do comerciante (MAX 255; MIN 3). Entidade Jurídica ABC
provider_merchant_account_name string Nome da conta do comerciante atribuída pelo provedor de pagamento. Conta de comerciante ABC
description(A) enum Descrição do comerciante. Comércio eletrônico do comerciante
event_type string Tipo de movimento 1- Liquidação 1
adjustment_type string Código de ajuste informado pelo provedor. 12
bank_account string Dados bancários da instituição onde o comerciante recebeu o valor da liquidação. 12345-6
bank_agency string Dados bancários da instituição onde o comerciante recebeu o valor da liquidação. 012
bank string Dados bancários da instituição onde o comerciante recebeu o valor da liquidação. 123

(A) A disponibilidade desse campo de dados depende do fato de o processador ou adquirente fornecer as informações. Se o Yuno puder identificar a transação, ele exibirá os dados; caso contrário, o campo poderá estar vazio.

Relatório de comunicações

O relatório de comunicações fornece informações detalhadas sobre todas as comunicações (chamadas, mensagens) entre os clientes e o comerciante por meio dos canais de comunicação da Yuno. Esse relatório inclui dados sobre a duração das chamadas, o conteúdo das mensagens, o status da comunicação e outras métricas relevantes.

Detalhes do campo do relatório de comunicações
Parâmetro Tipo Descrição Exemplo
communication_id string Identificador exclusivo para a comunicação (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120002
order_id string Identificador do pedido associado à comunicação (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120003
payment_id string Identificador do pagamento associado à comunicação (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120004
communication_status enum Status atual da comunicação (MAX 255; MIN 3). CONCLUÍDO
destination_phone string Número de telefone para o qual a comunicação foi enviada (MAX 255; MIN 3). +1234567890
created_at data e hora Data e hora em que a comunicação foi iniciada (ISO 8601). 2024-03-15 14:30:00
country string Código do país para o qual a comunicação foi enviada (ISO 3166-1 alfa-2; MAX 2; MIN 2). EUA
transcription string Transcrição de texto do conteúdo da comunicação (MAX 1000; MIN 3). O cliente confirmou os detalhes do pagamento...
call_duration número Duração da chamada em segundos (MAX 3600; MIN 0). 180
messages matriz Conjunto de mensagens trocadas durante a comunicação. [{"content": "Hello", "timestamp": "2024-03-15 14:30:00"}]
summary string Resumo do conteúdo da comunicação (MAX 500; MIN 3). Chamada de verificação de pagamento concluída com êxito
channel enum Canal de comunicação usado (por exemplo, VOZ, SMS, WHATSAPP; MAX 50; MIN 3). VOZ
focus string Tópico principal ou foco da comunicação (MAX 255; MIN 3). Verificação de pagamento

Relatório de transações de fraude

O relatório de transações fraudulentas fornece informações detalhadas sobre transações que foram sinalizadas como possíveis fraudes pelos sistemas de detecção de fraudes da Yuno. Esse relatório inclui pontuações de fraude, respostas do provedor e detalhes da transação para análise de risco.

Detalhes do campo do relatório Transações de fraude
Parâmetro Tipo Descrição Exemplo
account_id string Identificador exclusivo da conta (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120002
country enum País onde a transação ocorreu (MAX 2; MIN 2; ISO 3166-1). EUA
payment_id string Identificador exclusivo para o pagamento (MAX 64; MIN 36). 69ad0a39-b769-423c-b223-d7b8bf
transaction_id string Identificador exclusivo da transação (MAX 64; MIN 36). b04db1c6-b2c7-4765-a77e-953d284d080b
transaction_type enum Tipo de transação (por exemplo, COMPRA, REEMBOLSO). COMPRAR
status enum Status da transação (MAX 255; MIN 3). SUCCEEDED
provider_transaction_id string Identificador de transação do provedor (MAX 255; MIN 3). T-51056-1e10f992-e5cf-40bf-9eb6-8edc881de30b
response_code string Código de resposta do sistema (MAX 255; MIN 3). 200
provider_id string Identificador exclusivo do provedor (MAX 64; MIN 36). ID DO FORNECEDOR
provider_score número Pontuação de risco de fraude fornecida pelo sistema de detecção de fraude (MAX 100; MIN 0). 85
provider_third_party_account_id string ID da conta de terceiros associada ao provedor (MAX 64; MIN 36). ACC123456
provider_account_id string Identificador de conta do provedor (MAX 64; MIN 36). 699ec8d444
provider_status string Status do pagamento no provedor (MAX 255; MIN 3). PAGO
provider_status_detail string Status detalhado do provedor (MAX 255; MIN 3). Transação concluída com êxito
provider_response_message string Mensagem de resposta do provedor (MAX 255; MIN 3). O pagamento foi efetuado
created_at carimbo de data/hora Registro de data e hora em que a transação foi criada (ISO 8601). 2024-09-11T23:16:06.602Z
updated_at carimbo de data/hora Carimbo de data e hora da última atualização da transação (ISO 8601). 2024-09-11T23:17:07.602Z
account_integration_id string Identificador exclusivo da integração da conta (MAX 64; MIN 36). 6a0f939c-0cd1-4350-acbc-b0cbdbee9739
provider_response_code string Código de resposta do provedor (MAX 255; MIN 3). 200

Relatório de pagamentos

O relatório de pagamentos fornece informações detalhadas sobre todas as transações de pagamento processadas por meio do Yuno. Esse relatório inclui detalhes do beneficiário, métodos de saque, status do pagamento e informações financeiras para fins de rastreamento e reconciliação.

Detalhes do campo do relatório de pagamentos
Parâmetro Tipo Descrição Exemplo
beneficiary_national_entity string Entidade ou organização nacional do beneficiário. Banco ABC
payout_id string Identificador exclusivo para o pagamento (MAX 64; MIN 36). 69ad0a39-b769-423c-b223-d7b8bf
beneficiary_legal_name string Nome legal do beneficiário (MAX 255; MIN 3). Corporação John Doe
account_id string Identificador exclusivo da conta (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120002
status enum Status do pagamento (MAX 255; MIN 3). SUCCEEDED
merchant_reference string Número de referência atribuído pelo comerciante (MAX 255; MIN 3). REF123456
description string Descrição do pagamento (MAX 255; MIN 3). Pagamento de comissão
purpose string Objetivo da transação de pagamento. Comissão
country enum País onde o pagamento é processado (MAX 2; MIN 2; ISO 3166-1). EUA
amount_value número O valor do pagamento (múltiplo de 0,0001). 100000
currency enum A moeda usada para o pagamento (MAX 3; MIN 3; ISO 4217). USD
merchant_beneficiary_id string Identificador do beneficiário atribuído pelo comerciante (MAX 255; MIN 3). BEN123456
provider_id string Identificador exclusivo do provedor (MAX 64; MIN 36). ID DO FORNECEDOR
created_at carimbo de data/hora Registro de data e hora em que o pagamento foi criado (ISO 8601). 2024-09-11T23:16:06.602Z
updated_at carimbo de data/hora Carimbo de data/hora da última atualização do pagamento (ISO 8601). 2024-09-11T23:17:07.602Z
beneficiary_first_name string Primeiro nome do beneficiário (MAX 255; MIN 3). João
beneficiary_last_name string Sobrenome do beneficiário (MAX 255; MIN 3). Doe
beneficiary_email string Endereço Email do beneficiário (MAX 255; MIN 3). email protected]
beneficiary_country enum País de residência do beneficiário (MAX 2; MIN 2; ISO 3166-1). EUA
beneficiary_date_of_birth data Data de nascimento do beneficiário. 1985-07-28
beneficiary_document_number string Número do documento do beneficiário (MAX 20; MIN 5). 123456789
beneficiary_document_type enum Tipo de documento do beneficiário (MAX 10; MIN 3). PASSAPORTE
beneficiary_phone_country_code string Código do país para o número de telefone do beneficiário. 1
beneficiary_phone_number string Número de telefone do beneficiário (MAX 255; MIN 3). 555-1234
beneficiary_address_line_1 string Primeira linha do endereço do beneficiário (MAX 255; MIN 3). 123 Main St
beneficiary_address_line_2 string Segunda linha do endereço do beneficiário (MAX 255; MIN 3). Apto 202
beneficiary_city string Cidade do endereço do beneficiário (MAX 255; MIN 3). Nova York
beneficiary_state string Estado ou província do endereço do beneficiário (MAX 255; MIN 3). NOVA YORK
beneficiary_zip_code string Código postal do endereço do beneficiário (MAX 255; MIN 3). 10001
withdrawal_method_branch string Agência bancária para o método de saque. Filial principal
withdrawal_method_branch_digit string Dígito da agência para o método de saque. 1
withdrawal_method_account_number string Número da conta para o método de saque (MAX 255; MIN 3). 123456789
withdrawal_method_account_digit string Dígito da conta para o método de saque. 1
withdrawal_method_account_type enum Tipo de conta para o método de saque (MAX 20; MIN 3). VERIFICAÇÃO
withdrawal_method_address_line_1 string Primeira linha do endereço do método de saque (MAX 255; MIN 3). 456 Bank St
withdrawal_method_address_line_2 string Segunda linha do endereço do método de saque (MAX 255; MIN 3). Suíte 100
withdrawal_method_address_city string Cidade do endereço do método de retirada (MAX 255; MIN 3). Miami
withdrawal_method_state string Estado do endereço do método de retirada (MAX 255; MIN 3). FL
withdrawal_method_zip_code string Código postal do endereço do método de saque (MAX 255; MIN 3). 33101
withdrawal_method_email string Endereço Email para o método de retirada (MAX 255; MIN 3). email protected]
withdrawal_method_document_number string Número do documento para o método de retirada (MAX 20; MIN 5). 98765432
withdrawal_method_document_type enum Tipo de documento para o método de retirada (MAX 10; MIN 3). ID
withdrawal_method_phone_country_code string Código do país para o número de telefone do método de saque. 1
withdrawal_method_phone_number string Número de telefone para o método de saque (MAX 255; MIN 3). 123-456-7890
withdrawal_method_type enum Tipo de método de saque (MAX 50; MIN 3). BANK_TRANSFER
withdrawal_method_code string Código do método de saque (MAX 50; MIN 3). BANKABC_TRANSFER
withdrawal_method_country enum País para o método de retirada (MAX 2; MIN 2; ISO 3166-1). EUA

Relatório de taxas

O relatório de taxas fornece informações detalhadas sobre todas as taxas e encargos aplicados às transações processadas por meio do Yuno. Esse relatório inclui taxas do adquirente, impostos, custos calculados e informações sobre o status da taxa para análise e reconciliação financeira.

Detalhes do campo do relatório de taxas
Parâmetro Tipo Descrição Exemplo
transaction_id string O identificador exclusivo da transação atribuído pela Yuno (MAX 64; MIN 36). 2c5fdb3a-15e5-4f7b-93a7-c229e1688d91
provider_transaction_id string O identificador exclusivo da transação atribuído pelo gateway. Esse campo estará vazio se o gateway não fornecer informações sobre a transação (MAX 255; MIN 3). EDR3848FF094TY
acquirer_type string Nome do adquirente que processou o pagamento original. Nos modelos de agregador, o provedor é o mesmo que o adquirente. Em outros modelos, eles podem ser entidades diferentes (MAX 255; MIN 3). Venda
acquirer_gross_amount string O valor bruto correspondente a todas as transações na moeda de liquidação (múltiplo de 0,0001). 1000
acquirer_fees string A taxa de comissão que foi retida pelo adquirente em transações na moeda de liquidação. Essa deve ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 15
acquirer_taxes string O valor dos impostos aplicados às transações na moeda de liquidação. Essa deve ser a diferença entre os valores bruto e líquido (múltiplo de 0,0001). 5
country enum País onde a transação ocorreu (MAX 2; MIN 2; ISO 3166-1). EUA
type string O tipo de transação. Exibimos os tipos enviados pelo provedor (MAX 255; MIN 3). COMPRAR
gross_field string Coluna de liquidação considerada como o valor bruto gross_amount
fix_cost decimal Custo fixo sobre o valor bruto de cada transação 0
percentage_cost decimal Custo percentual do valor bruto de cada transação 0.02
calculated_fix_costed_fee decimal Custo fixo calculado a partir do valor bruto de cada transação 15
calculated_percentage_cost decimal Custo percentual calculado a partir do valor bruto 5
acquirer_net_amount decimal O valor enviado nas solicitações de transação de crédito menos as taxas do adquirente na moeda de liquidação (múltiplo de 0,0001). 980
calculated_net_amount decimal Valor líquido calculado com base nas informações do comerciante 980
fee_taxes_diff decimal Diferença entre o net_amount do adquirente e o valor calculado -5
fee_status enum Status de validação de taxas OK, ERROR
fee_sub_status enum Validação esperada, erro excessivo ou erro insuficiente EXPECTED, ABOVE_EXPECTED, BELOW_EXPECTED
acquirer enum Nome do adquirente que processou o pagamento original. Nos modelos de agregador, o provedor é o mesmo que o adquirente. Em outros modelos, eles podem ser entidades diferentes (MAX 255; MIN 3). ADQUIRENTE
settlement_date data Data estimada pelo adquirente em que os fundos serão depositados na conta bancária do comerciante. 2025-06-01
currency enum Código da moeda em que a transação foi feita (MAX 3; MIN 3; ISO 4217). USD
card_iin número O número de identificação do emissor (IIN) refere-se aos primeiros dígitos de um número de cartão de pagamento emitido por uma instituição financeira (MAX 8; MIN 8). 123456
card_lfd número Os últimos quatro dígitos do cartão (MAX 4; MIN 4). 1234
authorization_code número No caso de uma transação com cartão, o código atribuído pelo banco emissor à transação quando ela é autorizada. Esse campo estará vazio se o gateway não fornecer informações sobre a transação (MAX 255; MIN 3). 123456

Relatório da agenda

O relatório de agenda fornece informações detalhadas sobre transações programadas e planejadas, incluindo pagamentos parcelados, detalhes de adiantamento e cronogramas de reconciliação. Esse relatório ajuda a acompanhar o ciclo de vida da transação e o planejamento da liquidação.

Detalhes do campo do relatório da agenda
Parâmetro Tipo Descrição Exemplo
ur_key string Uma combinação de campos que identifica de forma exclusiva cada pagamento em todos os estágios do fluxo de pagamento. 01027058000191128882410001062025-09-01001720022892819614128882410001060000000000000000000
country enum País da conta do comerciante (ISO 3166-1). EUA
type_transaction enum O tipo de transação. Os valores podem ser: VENTA, DEVOLUCION, CONTRACARGO, DISPUTA, COMISION, IMPUESTO, LIQUIDACION. COMPRAR
payment_method_category enum Categoria da transação (MAX 255; MIN 3). BANK_TRANSFER
payment_method_type enum O tipo de método de pagamento selecionado pelo cliente (MAX 255; MIN 3). BANKABC_TRANSFER
provider_id enum Identificação do provedor (MAX 255; MIN 3) - - Opções: WOMPI, SPINPAY, ADDI, MERCADO_PAGO ID DO FORNECEDOR
customer_id string O identificador exclusivo do cliente (MAX 255; MIN 3). 23456
payment_id string O identificador exclusivo do pagamento (MAX 64; MIN 36). 5104911d-5df9-229e-8468-bd41abea1
merchant_order_id string Identificação da ordem (MAX 255; MIN 3). 123456789
merchant_transaction_id string Identificação da transação atribuída por sua empresa (MAX 255; MIN 3). 987654321
transaction_id string O identificador exclusivo da transação atribuído pela Yuno (MAX 64; MIN 36). 9104911d-5df9-429e-8488-ad41abea1a4b
provider_transaction_id string Identificador de transação do provedor (MAX 255; MIN 3). T-51056-1e10f992-e5cf-40bf-9eb6-8edc881de30b
third_party_transaction_id string Identificador de transação de terceiros (MAX 255; MIN 3). TP123456789
status_payment enum Status do pagamento (MAX 255; MIN 3). SUCCEEDED
response_code string Código de resposta do sistema (MAX 255; MIN 3). 200
provider_status string Status do pagamento no provedor (MAX 255; MIN 3). PAGO
transaction_amount número Valor da transação (MAX 10000; MIN 0). 887
currency enum Código da moeda para a transação (MAX 3; MIN 3; ISO 4217). USD
card_type enum Tipo de cartão utilizado (CRÉDITO ou DÉBITO). CRÉDITO
card_brand string Marca do cartão usado (MAX 50; MIN 2). VISA
card_iin string Número de identificação do emissor (IIN) do cartão (MAX 8; MIN 6). 49296404
card_lfd string Os últimos quatro dígitos do número do cartão (MAX 4; MIN 4). 1228
authorization_code string Código de autorização da transação (MAX 6; MIN 6). 161058
installments número Número de parcelas da transação (MAX 24; MIN 1). 6
installment_number string Número da parcela atual (MAX 6; MIN 3). 1/6
installment_amount número Valor da parcela atual (MAX 10000; MIN 0). 147.83
pnr string Registro do nome do passageiro, se aplicável (MAX 64; MIN 36). 987654321
created_at carimbo de data/hora Registro de data e hora em que a transação foi criada (ISO 8601). 2024-09-11T23:16:06.602Z
updated_at carimbo de data/hora Carimbo de data e hora da última atualização da transação (ISO 8601). 2024-09-11T23:17:07.602Z
agenda_status enum Status do item da agenda (MAX 255; MIN 3). AGENDADO
agenda_sub_status enum Substatus do item da agenda (MAX 255; MIN 3). PENDING
sales_reconciliation_date data Data em que a reconciliação de vendas está programada. 2024-09-15
provider_intended_settlement_date data Data de liquidação pretendida pelo provedor. 2024-09-16
provider_confirmation_date data Data em que o provedor confirmou a transação. 2024-09-12
bank_account string Detalhes da conta bancária para a transação. 12345-6
bank_agency string Detalhes da agência bancária para a transação. 012
bank string Dados bancários da transação. 123
advancement_amount decimal Valor adiantado para a transação (múltiplo de 0,0001). 800.00
provider_fees decimal Taxas cobradas pelo provedor (múltiplo de 0,0001). 15.00
provider_taxes decimal Impostos aplicados pelo provedor (múltiplo de 0,0001). 2.50
pending_amount decimal Valor ainda pendente para a transação (múltiplo de 0,0001). 69.50
acquirer string Nome do adquirente que processou a transação (MAX 255; MIN 3). Adquirente ABC

Relatório de conciliação de vendas

O relatório de conciliação de vendas fornece informações detalhadas sobre as transações de vendas e seu status de reconciliação. Esse relatório inclui detalhes da transação, status de confirmação e informações do fornecedor para fins de rastreamento e reconciliação de vendas.

Detalhes do campo do relatório de conciliação de vendas
Parâmetro Tipo Descrição Exemplo
transaction_id string O identificador exclusivo da transação atribuído pela Yuno (MAX 64; MIN 36). 9104911d-5df9-429e-8488-ad41abea1a4b
payment_method_category enum Categoria da transação (MAX 255; MIN 3). BANK_TRANSFER
type enum O tipo de transação. Os valores podem ser: VENTA, DEVOLUCION, CONTRACARGO, DISPUTA, COMISION, IMPUESTO, LIQUIDACION. COMPRAR
payment_method_type enum O tipo de método de pagamento selecionado pelo cliente (MAX 255; MIN 3). BANKABC_TRANSFER
provider_id enum Identificação do provedor (MAX 255; MIN 3) - - Opções: WOMPI, SPINPAY, ADDI, MERCADO_PAGO ID DO FORNECEDOR
status string O status da transação (MAX 255; MIN 3). SUCCEEDED
response_code string O código que representa a resposta ao resultado da transação. SUCCEEDED
amount número O valor da transação. 100
created_at carimbo de data/hora Data de criação da transação (MAX 27; MIN 27; ISO 8601). 2022-05-09T20:46:54.786342Z
updated_at carimbo de data/hora A data e a hora da última vez em que a transação foi atualizada. 2022-05-15T20:46:54.786342Z
provider_status string O status da transação do provedor (MAX 255; MIN 3). Autorizado
merchant_transaction_id string Identificação da transação atribuída por sua empresa (MAX 255; MIN 3). 987654321
provider_transaction_id string O identificador exclusivo da transação atribuído pelo gateway. Esse campo estará vazio se o gateway não fornecer informações sobre a transação (MAX 255; MIN 3). 53443e9c-dd17-11ec-9d64-0242ac120002
country enum País da conta do comerciante (ISO 3166-1). EUA
customer_id string O identificador exclusivo do cliente (MAX 255; MIN 3). 23456
description string Descrição da transação (MAX 255; MIN 3). Comércio eletrônico do comerciante
merchant_order_id string Identificação da ordem (MAX 255; MIN 3). 123456789
payment_id string O identificador exclusivo do pagamento (MAX 64; MIN 36). 5104911d-5df9-229e-8468-bd41abea1
currency enum A moeda usada para fazer o payment (MAX 3; MIN 3; ISO 4217). COP
card_issuer_name enum Banco ao qual o cartão corresponde. Banco ABC
card_issuer_country enum País em que a liquidação foi feita (MAX 2; MIN 2). UY
card_category enum Categoria do cartão usado na transação (MAX 255; MIN 3). CLÁSSICO
card_expiration_month número Mês de vencimento do cartão (MAX 2; MIN 1). 10
card_expiration_year número Ano de validade do cartão (MAX 2; MIN 2). 10
pnr string O registro do nome do passageiro (MAX 255; MIN 3). 1P-2UUGJW
retrieval_reference_number string Número de referência exclusivo para recuperação de transações (MAX 255; MIN 3). CAQMCAQRisS2iL
card_iin número O número de identificação do emissor (IIN) refere-se aos primeiros dígitos de um número de cartão de pagamento emitido por uma instituição financeira (MAX 8; MIN 8). 123456
card_lfd número Os últimos quatro dígitos do cartão (MAX 4; MIN 4). 7890
authorization_code string No caso de uma transação com cartão, o código atribuído pelo banco emissor à transação quando ela é autorizada. Esse campo estará vazio se o gateway não fornecer informações sobre a transação (MAX 255; MIN 3). 742A64
installments número Em caso de transação com cartão, o número de parcelas em que o pagamento foi solicitado (MAX 2; MIN 1). 1
card_type string Tipo de cartão usado na transação (MAX 7; MIN 5). CRÉDITO
card_brand string Marca do cartão usado na transação (MAX 255; MIN 3). VISA
provider_card_brand string O método de pagamento ou a marca do cartão (MAX 255; MIN 3). ABC
confirmation_status enum Sinalizador que indica se a transação também está registrada no Yuno ou não CONFIRMADO
provider_confirmation_date string Data em que confirmamos a presença da transação na Yuno 2025-05-10
acquirer string Nome do adquirente que processou o pagamento original. Nos modelos de agregador, o provedor é o mesmo que o adquirente; em outros modelos, eles podem ser entidades diferentes (MAX 255; MIN 3). Adquirente ABC

Relatório de avanços

O relatório de avanços fornece informações detalhadas sobre todas as operações de avanço processadas por meio do Yuno. Esse relatório inclui detalhes de negociação, operações de UR, informações bancárias e dados financeiros para rastrear transações de adiantamento.

Detalhes do campo do relatório de avanços
Parâmetro Tipo Descrição Exemplo
operation_id string Identificador exclusivo da operação de avanço (MAX 64; MIN 36). 69ad0a39-b769-423c-b223-d7b8bf
merchant_id string Identificador exclusivo do comerciante (MAX 64; MIN 36). 64143128-dd12-11ec-9d64-0242ac120002
product_id string Identificador exclusivo do produto (MAX 64; MIN 36). f4c53557-a832-44e9-94e4-0344f91e9d4f
ur_key string Chave de referência exclusiva para a operação de avanço (MAX 255; MIN 3). UR123456789
operation_type enum Tipo de operação de avanço (por exemplo, AVANÇO, REEMBOLSO). AVANÇO
movement_type enum Tipo de movimento para o avanço (por exemplo, CRÉDITO, DÉBITO). CRÉDITO
operation_date data Data em que a operação de avanço foi processada. 2024-09-15
operation_settlement_date data Data em que a operação de avanço foi liquidada. 2024-09-16
ur_operation_date data Data da operação de UR. 2024-09-15
ur_original_settlement_date data Data de liquidação original para a operação de UR. 2024-09-20
negotiation_gross_amount decimal Valor bruto negociado para o adiantamento (múltiplo de 0,0001). 1000.00
negotiation_fees decimal Taxas cobradas pela negociação (múltiplo de 0,0001). 15.00
negotiation_net_amount decimal Valor líquido após as taxas de negociação (múltiplo de 0,0001). 985.00
ur_gross_amount decimal Valor bruto da operação de UR (múltiplo de 0,0001). 1000.00
ur_fees decimal Taxas cobradas pela operação de UR (múltiplo de 0,0001). 10.00
ur_net_amount decimal Valor líquido da operação de UR (múltiplo de 0,0001). 990.00
bank string Dados bancários para a operação de avanço (MAX 255; MIN 3). 123
bank_agency string Detalhes da agência bancária para a operação de avanço (MAX 255; MIN 3). 012
bank_account string Detalhes da conta bancária para a operação de avanço (MAX 255; MIN 3). 12345-6
country enum País onde ocorreu a operação de avanço (MAX 2; MIN 2; ISO 3166-1). EUA
ur_currency enum Moeda usada para a operação de UR (MAX 3; MIN 3; ISO 4217). USD
acquirer string Nome do adquirente que processou o avanço (MAX 255; MIN 3). Adquirente ABC