Introdução

Se você deseja criar uma plataforma para que lojistas realizem vendas através dela, é necessário que tanto a sua plataforma quanto seus lojistas possuam contas Moip. Isso te possibilitará criar pedidos e realizar as vendas em nome dos lojistas e, se desejar, poderá inclusive receber um valor sobre cada venda.

O Moip permite que um pagamento realizado seja dividido (split) entre Contas Moip diferentes em tempo real. Este esquema viabiliza o uso do Moip como solução para Marketplaces/Plataformas por facilitar o pagamento da cadeia de envolvidos, permitindo o funcionamento de diversos modelos de negócios.

Estrutura de pagamentos divididos

A transação mais simples que pode ser gerada com as APIs do Moip possui um Pagador e um único Recebedor. Este é o padrão utilizado para as transações tradicionais no e-commerce.

O Moip permite que um pagamento realizado seja dividido (split) entre Contas Moip diferentes em tempo real. Este esquema viabiliza o uso do Moip como solução para Marketplaces/Plataformas por facilitar o pagamento da cadeia de envolvidos, permitindo o funcionamento de diversos modelos de negócios.

Os recebedores secundários (SECONDARY) não possuem relação com os compradores. Isto é, um comprador que realiza um pagamento, neste esquema, não “enxerga” o recebedor secundário na transação, nem a forma com que os pagamentos foram divididos entre as partes. Pode haver mais de um recebedor secundário por transação, mas apenas um recebedor primário (PRIMARY).

Abaixo um quadro comparativo com as características de cada papel assumido em uma transação dividida.

Funcionalidade

Recebedor PRIMARY

Recebedor SECONDARY

Obrigatoriedade na transação

Sim

Não

Obrigatoriedade de Conta Moip

Sim, conta de vendedor

Sim, conta de vendedor

Relacionamento comercial entre comprador e pagador

Sim

Não

Recebimento de e-mails

Não

Não

Reembolsos

Pode realizar

Não realiza, mas tem saldo correspondente limitado.

(Se o marketplace optar por ser o recebedor secundário ele pode usar o OAuth da conta primária pra fazer reembolsos em nome do primário.)

Reclamações e disputas

Responde

Não responde, mas tem o saldo correspondente bloqueado/debitado

Contestações (chargebacks)

Responde

Não responde, mas tem o saldo correspondente bloqueado/debitado

Relatórios transacionais

Visualiza pagador e recebedores secundários

Visualiza pagador e recebedor primário

Tarifa Moip

Paga por padrão

Paga se configurado

NF-e de serviços do Moip

Recebe por padrão

Recebe caso pague a tarifa Moip

Visualização de pedidos

Visualização de todos os valores e recebedores envolvidos nos pedidos e pagamento e todos os dados dos compradores.

Visualização apenas de seus recebíveis e do total de outros recebedores, não podendo acessar detalhes dos mesmos.
Não pode visualizar email do comprador.

Conectando com a Conta Moip de seus usuários

Para realizar vendas em nome dos sellers de sua plataforma, você precisa ter acesso às contas Moip deles. Esse acesso é concedido por um App criado a partir da sua própria conta Moip. O conceito de App nada mais é do que uma autorização (um token) que te permitirá solicitar acesso para realizar algumas operações nas contas Moip de seus usuários.

Esse guia contém os passos básicos que um marketplace ou plataforma deverão seguir para aproveitar os recursos das APIs do Moip e apresentar a melhor experiência para seus usuários!

  • On-boarding para Contas Transparentes;
  • On-boarding para Contas Clássicas;
  • Criação do App (OAuth token);
  • Configurando as preferências de notificação;
  • Fluxo OAuth;
  • Solicitando permissões OAuth;
  • Pagamentos com Split;
  • Pagamentos com Split e recebedor secundário;
  • Recebedor Secundário pagando as taxas Moip;
  • Custódia (escrow);
  • Consulta de Saldo;
  • Transferência Bancária