Uma cobrança charge representa um pagamento realizado através da Malga, que pode englobar diversas transações em provedores de cobrança e de antifraude, contendo as informações sobre o seu processamento.

No grupo Charges disponibilizamos as seguintes consultas:

allCharges

Retorna todas as cobranças

charge

Retorna informações de uma cobrança pelo seu identificador único

chargesByDeclinedCode

Retorna as cobranças com status failed pelo declined code (motivos de perda)

totalCharges

Retorna o número de cobranças e o total financeiro de um período

totalChargesByInterval

Retorna o número de cobranças e o total financeiro por um intervalo selecionado

totalChargesByPaymentMethod

Retorna o número de cobranças e o total financeiro processados por método de pagamento

totalChargesByProviderType

Retorna o número de cobranças e o total financeiro processados por provedor de pagamento


allCharges

Retorna todas as cobranças

QUERY : OBJETO DE RETORNOallCharges: ChargeConnection
ARGUMENTO : TIPODESCRIÇÃO
first: IntRetorna os primeiros n elementos da lista. O padrão é 100
after: StringRetorna os elementos da lista que vêm após o ID global especificado.
startDate: DatetimestartDate (intervalo de datas, iniciando o range no formato yyyy-MM-dd HH:mm:ss.SSSS)
endDate: DatetimeendDate (intervalo de datas, finalizando o range no formato yyyy-MM-dd HH:mm:ss.SSSS)
status: [String!]Status da transação
providerType: [String!]Nome do provedor
paymentMethod: [String!]Método de pagamento
merchantId: [String!]ID da Subconta
orderId: [String!]Identificador único do cliente para conciliação futura
amount: IntValor da transação
originalAmount: IntValor original da transação enviada ao provedor

charge

Retorna informações de uma cobrança pelo seu identificador único

QUERY : OBJETO DE RETORNO | charge: ChargeConnection
ARGUMENTO : OBJETO | DESCRIÇÃO
id: StringID da cobrança
authorizationCode: StringCódigo de autorização retornado pelo provedor
authorizationNsu: StringNúmero de autorização retornado pelo provedor
idempotencyKey: StringChave única de referência gerada pela Malga para cada requisição

chargesByDeclinedCode

Retorna as cobranças com status failed pelo declined code (motivos de perda)

QUERY : OBJETO DE RETORNO | chargesByDeclinedCode: DeclinedCode
ARGUMENTO : OBJETO | DESCRIÇÃO
startDate: Datetime!startDate (intervalo de datas, iniciando o range no formato yyyy-MM-dd)
endDate: Datetime!endDate (intervalo de datas, finalizando o range no formato yyyy-MM-dd)
currency: String!Moeda da transação
merchantId: [String!]Lista de subcontas (merchantId’s) das transações

totalCharges

Retorna o número de cobranças e o total financeiro de um período

QUERY : OBJETO DE RETORNO | totalCharges: TotalCharges
ARGUMENTO : OBJETO | DESCRIÇÃO
startDate: Datetime!startDate (intervalo de datas, iniciando o range no formato yyyy-MM-dd)
endDate: Datetime!endDate (intervalo de datas, finalizando o range no formato yyyy-MM-dd)
currency: String!Moeda da transação
status: [String!]Status da transação
merchantId: [String!]Lista de subcontas (merchantId’s) das transações

totalChargesByInterval

Retorna o número de cobranças e o total financeiro por um intervalo selecionado

QUERY : OBJETO DE RETORNO | totalChargesByInterval: TotalCharges
ARGUMENTO : OBJETO | DESCRIÇÃO
startDate: Datetime!startDate (intervalo de datas, iniciando o range no formato yyyy-MM-dd)
endDate: Datetime!endDate (intervalo de datas, finalizando o range no formato yyyy-MM-dd)
interval: String!Intervalo de agrupamento [DAY, WEEK, MONTH, YEAR]
currency: String!Moeda da transação
status: [String!]Status da transação
merchantId: [String!]Lista de subcontas (merchantId’s) das transações

totalChargesByPaymentMethod

Retorna o número de cobranças e o total financeiro processados por método de pagamento

QUERY : OBJETO DE RETORNO | totalChargesByPaymentMethod: TotalCharges
ARGUMENTO : OBJETO | DESCRIÇÃO
startDate: Datetime!startDate (intervalo de datas, iniciando o range no formato yyyy-MM-dd)
endDate: Datetime!endDate (intervalo de datas, finalizando o range no formato yyyy-MM-dd)
currency: String!Moeda da transação
status: [String!]Status da transação
merchantId: [String!]Lista de subcontas (merchantId’s) das transações

totalChargesByProviderType

Retorna o número de cobranças e o total financeiro processados por provedor de pagamento

QUERY : OBJETO DE RETORNO | totalChargesByProviderType: TotalCharges
ARGUMENTO : OBJETO | DESCRIÇÃO
startDate: Datetime!startDate (intervalo de datas, iniciando o range no formato yyyy-MM-dd)
endDate: Datetime!endDate (intervalo de datas, finalizando o range no formato yyyy-MM-dd)
currency: String!Moeda da transação
status: [String!]Status da transação
merchantId: [String!]Lista de subcontas (merchantId’s) das transações