1
Notificação Instantânea de Transação
1.1
Integração
Para receber as notificações, você deve preparar seus sistema na Internet para processar as
notificações enviadas pelo MoIP. Depois de criado esse serviço para recebimento da
notificação, você deve cadastrar o URL no site do MoIP. Para isso, vá em Meus Dados >>
Preferências >> Notificação das Transações. Marque a opção Receber notificação instantânea de venda
e digite o endereço completo do serviço que você criou no campo URL de notificação.
Após o processamento de qualquer transação, o MoIP irá enviar um POST para esse URL
com os parâmetros abaixo:
ATENÇÃO: recomendamos que você confira o campo valor e veja se ele está de acordo
com o esperado. Se o frete for calculado no MoIP, ele será adicionado ao valor enviado
pelo seu sistema e o valor total do pagamento será retornado.
Parâmetro enviado
Descrição
Tipo
Tamanho
Exemplo
id_transacao
Identificador da transação A
informado por você para
controle em seu site
Max 32
abcd1234
valor
Valor do pagamento, sem N
vírgulas,
com
casas
decimais.
2000 (para R$20,00)
status_pagamento
Ver anexo A
3
cod_moip
Código da transação no N
ambiente MoIP. Valor
único gerado pelo MoIP.
forma_pagamento
Ver anexo B
N
tipo_pagamento
Ver anexo C
A
email_consumidor
E-mail informado
pagador, no MoIP.
N
pelo A
Max 20
12341234
1
Max 32
CartaoDeCredito
[email protected]
Tipo: N (numérico) ou A (alfanumérico).
1.2
Resposta
Depois que o MoIP envia a notificação para o URL de notificação previamente cadastrado e
você processa os dados do pagamento, você deve responder com um código HTTP de
acordo com o resultado do seu processamento.
•
Caso o processamento e atualização tenham ocorrido perfeitamente, envie o código
HTTP 200 como resposta.
•
Caso algum erro tenha ocorrido, você deve retornar um código HTML 4XX ou 5XX
para o MoIP.
Para o caso de seu sistema retornar um erro, o MoIP continuará a enviar as notificação, de 30
em 30 minutos, durante 7 dias para o seu servidor. Mesmo que você saiba que continuará a
ter erros no processamento, não envie o código HTTP 200 em caso de erro. Depois de 7
dias, o MoIP não mais enviará as notificações para o seu site, enviando, todavia, um e-mail
contendo informações sobre a transação.
2
Anexos
2.1
A – Status das transações no MoIP
Status
Código
Descrição
autorizado
1
Pagamento já foi realizado porém ainda não foi creditado na
Carteira MoIP recebedora (devido ao floating da forma de
pagamento)
iniciado
2
Pagamento está sendo realizado ou janela do navegador foi
fechada (pagamento abandonado)
boleto impresso
3
Boleto foi impresso e ainda não foi pago
concluido
4
Pagamento já foi realizado e dinheiro já foi creditado na Carteira
MoIP recebedora
cancelado
5
Pagamento foi cancelado pelo pagador, instituição de pagamento,
MoIP ou recebedor antes de ser concluído
em análise
6
Pagamento foi realizado com cartão de crédito e autorizado,
porém está em análise pela Equipe MoIP. Não existe garantia de
que será concluído
2.2
B – Formas de Pagamento do MoIP
Atenção: recomendamos que você utilize o Anexo C para tratar o tipo de pagamento
escolhido pelo pagador, pois novas formas de pagamentos podem ser constante adicionadas ao
MoIP.
Caso você tenha a necessidade de saber especificamente qual cartão de crédito foi utilizado
no pagamento (Visa ou Amex, por exemplo), envie um e-mail para [email protected], pedindo
os dados desse anexo.
2.3
C – Tipo de Pagamento
Status
Descrição
DebitoBancario
Débito em conta no domicilio bancário do pagador
FinanciamentoBancario Financiamento obtido junto ao domicílio bancário do pagador e o montante
total debitado diretamente da conta e creditado na Carteira MoIP do
recebedor
BoletoBancario
Boleto bancário impresso
CartaoDeCredito
Cartão de crédito
CartaoDeDebito
Cartão de débito Visa Electron (apenas para correntistas do Bradesco)
CarteiraMoIP
Diretamente da Carteira MoIP do pagador