Drip é uma solução de pagamento online que permite o pagamento de cobranças parceladas utilizando Pix e com cashback para os seus clientes. Para pagar com a Drip, o consumidor precisa abrir uma conta no sistema da Drip durante o processo de compra.
A Malga realiza o papel de intermediador de pagamentos, portanto não realiza a liquidação financeira, sendo necessária conta ativa da Drip para utilizar este método de pagamento.
DRIP
na criação de uma cobrança e adicionar as informações dos itens presentes no checkout;Este processo está descrito nos diagramas a seguir:
Você pode consultar mais informações sobre a integração com checkout neste link.
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.
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 |
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 sandbox sandbox-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
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.
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 status authorized
caso ainda haja valor na cobrança a ser estornado. Quando o valor restante em uma cobrança é 0 seu status é atualizado para voided
.
Quando uma requisição de estorno é feita, a API retorna uma transação com o status voided
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
.
Para testar uma atualização de estorno no sandbox da Malga você deve atualizar manualmente a transação com uma requisição, conforme descrito na sessão de recebimento de notificações.
Requisição para atualizar manualmente uma cobrança Drip como estornada em sandbox