Introdução
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:
PaymentMethod | Descrição |
---|---|
credit | Cobrança feita a partir de um cartão de crédito, suporta como sourceType: card , token ou customer |
pix | Cobrança feita a partir de QRCode Dinâmico no formato PIX, suporta como sourceType: customer |
boleto | Cobrança feita a partir de Boleto registrado, suporta como sourceType: customer |
nupay | Cobrança feita a partir de Fluxo Transparente da Nupay for Business 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:
SourceType | Descrição |
---|---|
card | Cobrança feita a partir de um cartão tokenizado usando o cardId ou com os dados abertos do cartão (cardNumber, cardHolderName, cardCvv, cardExpirationDate) |
token | Cobrança feita a partir de um token de cartão para cobrança sem recorrência usando tokenId |
customer | Cobranç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:
Status | Descrição |
---|---|
pending | Transação criada porém não concluiu processamento |
pre_authorized | Transação pré autorizada com sucesso pendente a captura |
authorized | Transação autorizada e capturada com sucesso |
failed | Transação não autorizada, verifique o erro para identificar o motivo |
canceled | Transação estornada após aprovada porém não capturada |
voided | Transação estornada após aprovada e capturada |
charged_back | Transação foi contestada por fraude, não reconhecimento da compra ou devolução da mercadoria |