Cobrancas online na sua aplicacao com MoIP

Cobranças online na sua aplicação com MoIP http://labs.moip.com.br/

MoIP?
Intermediador de pagamentos

MoIP?
Intermediador de pagamentos.
Alguém que recebe os pagamentos por você e os repassa no futuro.

MoIP?
Interessante para quem quer evitar burocracia com pagamentos online.

MoIP?
Solução preferida para Startups e pequenos/médios negócios.

MoIP?
Solução preferida para Startups e pequenos/médios negócios.
Outras funcionalidades interessantes (comissionamento, cobrança/débito recorrente, doações, etc)

MoIP?
Principais vantagens sobre outros intermediadores

MoIP?
Principais vantagens sobre outros intermediadores.
API simplificada e funcional.

MoIP?
Amigável ao desenvolvedor.

MoIP?
Flexibilidade nas formas de pagamento.

MoIP?
Flexibilidade nas formas de pagamento.
PagamentoDireto.

MoIPLabs

MoIPLabs
Laboratório criado pela MoIP com o intuito de auxiliar desenvolvedores e incentivar colaboração.

MoIPLabs
Github ( http://github.com/moiplabs/ )

MoIPLabs
Github ( http://github.com/moiplabs/ )
Forum ( http://labs.moip.com.br/forum/ )

Métodos de Integração Ou: como funciona na prática?

Dois ambientes básicos
Sandbox

Sandbox
feito pra testes.

Sandbox
feito pra testes.
sem envolvimento de valores reais.

Sandbox
feito pra testes.
Produção
Envolvimento de valores reais.

Sandbox
feito pra testes.
Produção
Envolvimento de valores reais.
Só deve ser utilizado quando a aplicação for validada no sandbox.

Duas formas básicas
HTML

Duas formas básicas
HTML
API

HTML
É a mais simples das duas.

HTML
Consiste em um formulário HTML que, quando submetido ao MoIP, mostra a página de checkout .

HTML
Sem necessidade de conhecimentos de programação.

HTML
Se o usuário souber copiar/colar HTML dentro do seu blog/site/cms.

HTML
GET e POST

HTML
GET e POST
Pode-se usar formulários ou links com os parâmetros requeridos.

HTML
GET e POST
GET é interessante para emails e assinaturas de fórum.

HTML
GET e POST
GET é interessante para emails e assinaturas de fórum.
POST é interessante para páginas Web comuns.

HTML - Exemplo de form de doação
<form method='post' action='https://desenvolvedor.moip.com.br/sandbox/Process.do'>
<input type='hidden' name='method' value='donation'/>
<input type='hidden' name='donation_id' value='35'/>
<input type='hidden' name='type' value='2'/>
<input type='image' name='submit'
src='https://desenvolvedor.moip.com.br/sandbox/imgs/buttons/bt_doar_c01_e01.png' alt='Ajude a manter o blog!' border='0' />
</form>
Resultado:

HTML - Exemplo de link de doação
<a href="https://desenvolvedor.moip.com.br/sandbox/Process.do?method=donation&donation_id=35&type=2">
<img src=
"https://desenvolvedor.moip.com.br/sandbox/imgs/buttons/bt_doar_c01_e01.png" alt="Ajude a manter o blog!" />
</a>
Resultado:

Mais ferramentas de integração HTML
Carrinho de Compras MoIP.

Pagamento Simples.

Pagamento Simples.
Veja nosso canal no Youtube para mais exemplos: http://www.youtube.com/user/MoIPOficial

HTML
Desvantagens
Usuário pode ver detalhes da transação.

HTML
Desvantagens
Possível modificar parâmetros importantes (como valor do pagamento).

HTML
Desvantagens
Possível modificar parâmetros importantes (como valor do pagamento).
"Never trust user data" - Provérbio Chinês ;)

API
Comunicação Servidor -> Servidor

API
O cliente não "vê" a transação ocorrendo.

API
Mais segura.

API
Mais segura.
Mais funcionalidades.

API
Mais segura.
PagamentoDireto.

API
Mais segura.
PagamentoDireto.
Comissionamento de vendedores.

API
Mais segura.
PagamentoDireto.
Comissionamento de vendedores.
Instruções adicionais (formas múltiplas de pagamento, dados do boleto,parcelamento e juros, URL de notificação, etc).

Instrucao XML
<EnviarInstrucao>
<InstrucaoUnica>
<Razao> COLOQUE A RAZAO DO PAGAMENTO </Razao>
<IdProprio> 12345 </IdProprio>
<Valores>
<Valor moeda = "BRL" > 123.45 </Valor>
</Valores>
</InstrucaoUnica>
</EnviarInstrucao>

URLs de envio das instruções
Cada ambiente (sandbox/producao) tem uma URL de envio de instruções e de redirecionamento de clientes.

Enviando instrução XML com cURL
curl -X POST -u seu_token:sua_key
-d "<EnviarInstrucao><InstrucaoUnica>
<Razao>COLOQUE A RAZAO DO PAGAMENTO</Razao>
<IdProprio>abc-12345</IdProprio><Valores><Valor moeda='BRL'>123.45</Valor>
</Valores></InstrucaoUnica></EnviarInstrucao>"
https://desenvolvedor.moip.com.br/sandbox/ws/alpha/EnviarInstrucao/Unica

<ns1:EnviarInstrucaoUnicaResponse xmlns:ns1="http://www.moip.com.br/ws/alpha/"><Resposta><ID>201102161007584830000000082983</ID><Status>Sucesso</Status><Token>C2L0S161W0X2E196J1H0Y0J7O5K8M408L3Q050N0X0R0F0O0M0F8G2L9J8X3</Token></Resposta></ns1:EnviarInstrucaoUnicaResponse> Resposta do servidor MoIP:

<ns1:EnviarInstrucaoUnicaResponse xmlns:ns1="http://www.moip.com.br/ws/alpha/"><Resposta><ID>201102161007584830000000082983</ID><Status> Sucesso </Status><Token> C2L0S161W0X2E196J1H0Y0J7O5K8M408L3Q050N0X0R0F0O0M0F8G2L9J8X3 </Token></Resposta></ns1:EnviarInstrucaoUnicaResponse> Resposta do servidor MoIP:

<ns1:EnviarInstrucaoUnicaResponse xmlns:ns1="http://www.moip.com.br/ws/alpha/"><Resposta><ID>201102161009171260000000082984</ID><Status> Falha </Status><Erro Codigo="102"> Id Próprio já foi utilizado em outra Instrução </Erro></Resposta></ns1:EnviarInstrucaoUnicaResponse> Resposta do servidor MoIP (falha):

Redirecionando cliente para página de checkout
O cliente deve ser redirecionado para o seguinte endereço:
https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token=token_de_resposta
No nosso caso ficaria assim:
https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token=C2L0S161W0X2E196J1H0Y0J7O5K8M408L3Q050N0X0R0F0O0M0F8G2L9J8X3

Redirecionando cliente para página de checkout
O cliente deve ser redirecionado para o seguinte endereço:
https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token=token_de_resposta
No nosso caso ficaria assim:
https://desenvolvedor.moip.com.br/sandbox/Instrucao.do?token= C2L0S161W0X2E196J1H0Y0J7O5K8M408L3Q050N0X0R0F0O0M0F8G2L9J8X3
Se fosse em produção, seria assim:
https://www.moip.com.br/Instrucao.do?token=C2L0S161W0X2E196J1H0Y0J7O5K8M408L3Q050N0X0R0F0O0M0F8G2L9J8X3

URLs de envio das instruções
Cada ambiente (sandbox/producao) tem uma URL de envio de instruções e de redirecionamento de clientes.
Produção Sandbox Envio de instrução http://www.moip.com.br/ws/alpha/ EnviarInstrucao/Unica http://www.moip.com.br/sandbox/ws/ alpha/EnviarInstrucao/Unica Redirecionamento do cliente https://www.moip.com.br/Instrucao.do? token=token_retornado https://desenvolvedor.moip.com.br/ sandbox/Instrucao.do? token=token_retornado

Paralelo API x HTML *NASP - Notificação de alteração de status de pagamento Integração HTML Integração API Programação server side é opcional. Programação server side é obrigatória. Mais simples. Mais complexa. Em boa parte das vezes, não há necessidade de conhecimentos de programação. Necessita de conhecimentos de programação (a menos que haja um módulo pronto, como o do Magento, Wordpress ou Prestashop) Sempre redireciona o cliente para o site do MoIP Se a modalidade de pagamento for o Pagamento Direto, o cliente não precisa sair do seu site Somente uma URL de retorno do NASP* Várias URLs de retorno do NASP, com possibilidade de uso da mesma conta da MoIP em vários sites.

Colaborando no Github
Criar um repositório e nos mandar o link.

"forkamos" o repo e você ainda ganha um post no MoIPLabs :)

Nos enviar um pull request.

Reportar uma issue .

Reportar uma issue .
Todos os repositórios em https://github.com/moiplabs

Reportando issues

Colaborando com código
Parte 1
Parte 2
Parte 3

Obrigado * http://www.flickr.com/photos/ringoffirehotsauce/5447095375/

Cobrancas online na sua aplicacao com MoIP

by Herberth Amaral

Accessibility

Categories

Upload Details

Usage Rights

1 Embed 27

Statistics

Cobrancas online na sua aplicacao com MoIP Presentation Transcript