# Obter transações Retorna a lista de informações detalhadas sobre todas as transações bem- sucedidas e canceladas em um período específico. Em resposta, você obtém informações sobre pagamentos, incluindo dados sobre as taxas, tarifas, bem como pedido e usuário. Você pode obter a lista nos formatos JSON e CSV. Você pode usar essa chamada API para realizar a reconciliação financeira. AvisoEsta chamada de API não contém o trajeto-parâmetro project_id, então é preciso usar a chave API que for válida em todos os projetos da empresa para configurar a autorização. Endpoint: GET /merchants/{merchant_id}/reports/transactions/registry.{format} Version: 2.0 Security: basicAuth ## Path parameters: - `merchant_id` (integer, required) ID de comerciante. - `format` (string, required) Formato da data. Enum: "json", "csv", "xls" ## Query parameters: - `datetime_from` (string, required) O início do período no formato AAAA-MM-DD. Não é obrigatório se ao menos um dos seguintes parâmetros for passado:transfer_idreport_id Example: "2023-02-08" - `datetime_to` (string, required) O fim do período no formato AAAA-MM-DD. Não é obrigatório se ao menos um dos seguintes parâmetros for passado: transfer_idreport_id A diferença entre datetime_from e datetime_to não pode ser maior do que 92 dias. Example: "2023-03-08" - `in_transfer_currency` (integer, required) Converte todos os dados financeiros à moeda do pagamento (a moeda de pagamento é usada por padrão). Não é obrigatório se ao menos um dos seguintes parâmetros for passado:transfer_idreport_id - `show_total` (boolean) Se a quantia total das transações deve ser incluída ou não no relatório. Disponível para exportar apenas no formato CSV. true por padrão. - `merchant_of_records` (string,null) Comerciante do Registro. Pode ser xsolla, merchant, ou não especificado. Se for merchant, retorna as transações feitas através dos portais do parceiro. Se for xsolla, retorna as transações que não foram feitas pelos portais do parceiro. Se não for especificado, retorna todas as transações. Enum: "xsolla", "merchant" - `project_id` (integer) ID do projeto. - `show_dry_run` (boolean) Se transações de teste devem ser incluídas ou não. - `transfer_id` (integer) ID de pagamento. - `report_id` (integer) ID de relatório financeiro. - `offset` (integer) Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0). - `limit` (integer) Limite da quantidade de transações exibidas na página. Se esse parâmetro for passado, você não precisará passar os parâmetros datetime_from e datetime_to. - `status` (string) Status da transação. Enum: "done", "canceled", "error", "refunded" ## Response 200 fields (application/json): - `payment_details` (object) Dados de pagamento. - `payment_details.chargebackPenalty` (object) - `payment_details.chargebackPenalty.amount` (number) - `payment_details.commission_agent` (object) - `payment_details.commission_agent.percent` (number) - `payment_details.commission_agent_fixed` (integer) - `payment_details.commission_ps` (object) - `payment_details.commission_ps.fixed_amount` (integer) - `payment_details.commission_ps_from_vat` (object) - `payment_details.commission_user` (object) - `payment_details.commission_xsolla` (object) - `payment_details.cpa_network_commission` (object) - `payment_details.direct_wht` (object) - `payment_details.payment` (object) - `payment_details.payment.amount_from_ps` (integer) - `payment_details.payment.currency` (string) - `payment_details.payout` (object) - `payment_details.payout.fx_rate` (number) - `payment_details.refundPenalty` (object) - `payment_details.repatriation_costs` (object) - `payment_details.sales_tax` (object) - `payment_details.vat` (object) - `payment_details.vat.user_amount` (integer) - `payment_details.vat.user_percent` (integer) - `purchase` (object) Dados da compra. - `purchase.friend` (object) - `purchase.friend.email` (string,null) - `purchase.friend.user_id` (string,null) - `purchase.items_amount` (integer) - `purchase.pin_codes` (object) - `purchase.pin_codes.content` (string,null) - `purchase.purchase_amount` (number) - `purchase.simple_checkout` (object) - `purchase.subscription` (object) - `purchase.subscription.name` (string,null) - `purchase.subscription.plan_id` (integer,null) - `purchase.subscription.product_id` (string,null) - `purchase.subscription.product_name` (string,null) - `purchase.subscription.subscription_id` (integer,null) - `purchase.virtual_currency` (object) - `purchase.virtual_currency_amount` (integer) - `purchase.virtual_items` (object) - `transaction` (object) Dados da transação. - `transaction.custom_parameters` (object,null) - `transaction.direct_account` (integer) - `transaction.dry_run` (integer) - `transaction.external_id` (string,null) - `transaction.id` (integer) - `transaction.payment_method` (object) - `transaction.payment_method.class` (string) - `transaction.project` (object) - `transaction.refund_reason` (string,null) - `transaction.refund_reason_comment` (string,null) - `transaction.status` (string) Enum: "created", "processing", "done", "canceled", "error", "refunded", "partiallyRefunded", "awaitingRefund", "disputeFee" - `transaction.transfer_date` (string) - `user` (object) Dados do usuário. - `user.country` (string) Código do país de duas letras maiúsculas, de acordo com o [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). - `user.custom` (string,null) - `user.email` (string) E-mail do usuário. - `user.id` (string) ID de usuário. - `user.ip` (string) - `user.marketplace` (string) - `user.name` (string) Nome de exibição do usuário. - `user.phone` (string,null) Número de telefone do usuário. - `user_balance` (object) Saldo do usuário. - `user_balance.payment_currency` (object) Moeda de pagamento preferida. - `user_balance.payment_currency.deduction_amount` (number) - `user_balance.payment_currency.payout_amount_from_balance` (number) - `user_balance.payment_currency.purchase_amount_from_balance` (number)