# Encontrar transações

Retorna uma lista de transações com base nos parâmetros de busca específicos. 
Em resposta, você obtém dados sobre todos os pagamentos feitos no seu jogo, 
mesmo que eles não tenham sido concluídos com sucesso. Você pode especificar 
não só o período de transação como também outros parâmetros. Exemplo: pesquisar 
por transações feitas por um usuário em particular ou com um status de 
pagamento específico. Você pode obter a lista no formato JSON ou CSV.


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/search.{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)
    Início do período.

  - `datetime_to` (string)
    Fim do período.

  - `project_id` (integer)
    ID do projeto.

  - `transaction_id` (integer)
    ID da transação.

  - `type` (string)
    Tipos de transações exibidas nos resultados da pesquisa.
    Enum: "all", "transferred", "canceled", "test"

  - `phone` (string)
    Número de telefone no formato internacional.

  - `user_id` (string)
    ID de usuário único no jogo armazenado do seu lado. Certifique-se de passar o ID de usuário existente. Em caso de erro, consulte às respostas às Perguntas Frequentes (FAQ).

  - `user_name` (string)
    Nome de usuário.

  - `user_custom` (string)
    Parâmetro personalizado para a identificação do usuário.

  - `email` (string)
    E-mail do usuário.

  - `external_id` (string)
    ID de transação no jogo. Precisa ser único para cada pagamento de um usuário.

  - `order_id` (integer)
    ID do Pedido. Você pode usá-lo para chamar o método de API Obter pedido.
    Example: 1234

  - `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 elementos na página.

  - `status` (string)
    Um status de transação.
    Enum: "created", "processing", "review", "error", "done", "awaitingRefund", "refunded", "canceled", "partiallyRefunded"


## Response 200 fields