Multimeios

Pagamentos combinando múltiplos cartões ou cartão + boleto num único pedido.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da Pagar.me v5 (versão clássica). Para projetos novos, explore o API Catalog.

Com multimeios é possível que seus clientes realizem pagamentos com N cartões de crédito ou combinando mais de um meio, como cartão de crédito e boleto.

Desenvolvemos essa funcionalidade, pois muitos consumidores não conseguem concluir as compras online por possuir o limite do cartão de crédito menor que o valor do pedido. Comprando com mais de um cartão ou com cartão e boleto o cliente consegue dividir o valor da compra de forma que o limite não seja ultrapassado.

Para realizar um pedido (order) com multimeios de pagamento você deve enviar pelo menos os seguintes campos:

  • Itens — itens do pedido
  • Customer — dados do comprador
  • Payments — meios de pagamento

Exemplo: Ana quer comprar uma nova TV no valor de R$1.000,00, mas como seu cartão só possui um limite de R$900,00, ela pode solicitar a geração de um boleto para conseguir pagar os R$100,00 restantes.

Comportamento dos pedidos

O pedido só será considerado pago somente se todas as suas cobranças forem aprovadas nas adquirentes, ou após a aprovação na adquirente e a identificação do pagamento do boleto.

Logo o status do pedido se comporta da seguinte forma:

  • Se todas as cobranças estiverem com status failed, o pedido irá para o status failed;
  • Se todas as cobranças estiverem com status paid, o pedido irá para o status paid;
  • Se as cobranças estiverem com status divergentes, não haverá alteração no status do pedido.

Caso uma cobrança não seja aprovada, você deve decidir como prefere seguir: cancelar o pedido completo ou fazer uma recuperação ativa do pedido, entrando em contato com o cliente para obter uma nova forma de pagamento, ou utilizando a funcionalidade de envio de checkout por email.

Atenção

Atualmente possuímos no Checkout Pagar.me as opções de multimeios com "2 cartões" ou "1 cartão + boleto". No primeiro cenário, caso uma das transações não seja aprovada, realizamos o cancelamento ou não processamos a outra transação. Já no segundo, caso a transação de cartão de crédito não seja aprovada, o boleto também não é emitido.


Jornada: Cobrar um cliente
Etapa 3 de 22