As cobranças podem ser feitas através de diferentes meios de pagamento, devendo ser informado o meio desejado no objeto paymentSource da cobrança. Cada meio de pagamento utiliza um conjunto específico de parâmetros condicionais que são descritos a seguir:

Um paymentMethod representa o meio de cobrança escolhido para processar a transação, os métodos suportados são:

PaymentMethodDescrição
creditCobrança feita a partir de um cartão de crédito, suporta como sourceType: card, token ou customer
pixCobrança feita a partir de QRCode Dinâmico no formato PIX, suporta como sourceType: customer
boletoCobrança feita a partir de Boleto registrado, suporta como sourceType: customer
nupayCobrança feita a partir de Fluxo Transparente da Nupay for Business API, suporta como sourceType: customer
dripCobrança feita a partir de PIX parcelando utilizando a Drip como provedor de processamento. Suporta como sourceType: customer
picpayCobrança feita a partir de Wallet da Picpay Negócios API, suporta como sourceType: customer

Um sourceType representa os dados do pagador que serão utilizados para processar a transação, podendo ser um cartão, um token de cartão temporário, ou dados de um comprador:

SourceTypeDescrição
cardCobrança feita a partir de um cartão tokenizado usando o cardId ou com os dados abertos do cartão (cardNumber, cardHolderName, cardCvv, cardExpirationDate)
tokenCobrança feita a partir de um token de cartão para cobrança sem recorrência usando tokenId
customerCobrança feita a partir de comprador cadastrado usando o customerId

Status da Transação

Os status possíveis para uma transação na Malga são:

StatusDescrição
pendingTransação criada porém não concluiu processamento
pre_authorizedTransação pré autorizada com sucesso pendente a captura
authorizedTransação autorizada e capturada com sucesso
failedTransação não autorizada, verifique o erro para identificar o motivo
canceledTransação estornada após aprovada porém não capturada
voidedTransação estornada após aprovada e capturada
charged_backTransação foi contestada por fraude, não reconhecimento da compra ou devolução da mercadoria

Rastreabilidade de cobranças

O atributo appInfo, representa informações referentes a rastreabilidade sobre cobrança, tais como transações do produto, do dispositivo e sobre o sistema operacional, auxiliando na identificação, mapeamento e rastreabilidade dos recursos gerados nas transações.

A passagem desse atributo é opcional. Saiba mais no serviço de Charges.

AtributoDescrição
PlatformInformações sobre produto das transações (checkout-sdk, vtex, magento, etc..)
DeviceInformações sobre o dispositivo (ios, android, windows, linux)
SystemInformações sobre o sistema proprietário de captura do merchant