Participantes de uma transação Drip
- O recebedor, cliente da Malga que deve possuir uma conta ativa da Drip.
- O pagador, um comprador que é um cliente pessoa física.
Fluxo de Pagamento Drip utilizando a API de cobranças com integração direta
- Para criar uma transação com Drip basta informar o meio de pagamento
DRIP
na criação de uma cobrança e adicionar as informações dos itens presentes no checkout; - Uma cobrança é registrada diretamente no sistema da Drip e é retornada uma URL de redirecionamento para o fluxo de cadastro e pagamento dentro da plataforma da Drip;
- O pagador deve realizar a confirmação da cobrança diretamente na plataforma da Drip;
- Após confirmação do pagamento, a Drip enviará uma notificação para a Malga informando que o pagamento foi realizado;
- Posteriormente o Cliente recebedor será notificado de que o pagamento foi efetuado e a cobrança finalizada com sucesso.


As cobranças Drip são assíncronas por natureza, ou seja, ao criar uma nova
cobrança você terá a confirmação apenas da criação da cobrança e não de sua
conclusão. A autorização ou reprovação de uma cobrança é notificada através
dos webhooks.
Notificação de alteração de status
objeto | evento | descrição |
---|---|---|
transaction | pending | Evento enviado quando a cobrança é registrada e o link de pagamento na Drip está disponível |
transaction | authorized | Evento enviado quando é reconhecida a confirmação do pagamento da cobrança na Drip |
transaction | failed | Evento enviado quando a cobrança não pôde ser registrada por motivo de falha durante a criação |
transaction | voided | Evento enviado quando a cobrança é cancelada após ter sido autorizada, produzindo um estorno financeiro |
Testando recebimento de notificação de cobrança Drip paga
Para testar sua integração com os webhooks da Malga você pode desenvolver direto seu sistema ou utilizar algum serviço como request.bin ou pipedream.com para validar inicialmente os eventos enviados. Basta gerar um novo endpoint nestes serviços e cadastrar um webhook na Malga com o endpoint gerado que todos os eventos enviados ficarão registrados nestes serviços para consulta e debug. Permitimos no ambiente de sandboxsandbox-api.malga.io
a atualização manual de transações criadas para os status de authorized
e voided
, dessa forma você consegue criar uma transação e simular o evento desejado.
Requisição para atualizar manualmente uma cobrança Drip como paga em sandbox
Exemplo de cobrança
Realize uma cobrança Drip a partir dos dados do comprador usando o Serviço de Charges.Caso deseje informar a quantidade máxima de parcelas para determinada
transação, basta informar o atributo “maxInstallments” no objeto de
paymentMethod.
Para criação de transações Drip é obrigatório o envio de paymentSource com
customer ou identificador de um customer que contenha endereço completo e
válido.
Estorno Drip
Requisições de estorno para cobranças Drip são tratadas de formas síncrona, ou seja, ocorrem no momento da requisição feita para a API da Malga. Em caso de estornos parciais do valor da compra, a transação permanecerá com statusauthorized
caso ainda haja valor na cobrança a ser estornado. Quando o valor restante em uma cobrança é 0 seu status é atualizado para voided
.
Exemplo de solicitação de estorno Drip
Quando uma requisição de estorno é feita, a API retorna uma transação com o statusvoided
e uma transactionRequest
do tipo void
com o status success
. Quando a requisição de estorno falha por algum motivo, a transação continua com o status authorized
contendo uma transactionRequest
do tipo void
com o status failed
.