Documentação do Webhooks:

• Moip Assinaturas - Documentação online

Conforme descrição do Moip:

"O Moip Assinaturas utiliza webhooks para notificar a sua aplicação em tempo real sobre os eventos que afetam os recursos da sua conta, como clientes, assinaturas, faturas e pagamentos."

Com esse plugin, ele torna sua vida mais fácil para receber as notificações do Moip (NASP).

A primeira coisa a fazer é configurar o "tokenNasp" e o "activeWebhook" para habilitar seu funcionamento.

Exemplo:

Configure::write('MoipAssinaturas', array(
    'token' => 'Insira-seu-token-aqui',
    'key' => 'Insira-sua-chave-de-acesso-aqui',
    'isProd' => false,
    'tokenNasp' => 'Seu-token-aqui',
    'activeWebhook' => true,
));

Você também precisa configurar a URL de notificação para receber os webhooks no painel do Moip ou através do componente MoipAssinaturas::Preferences. A URL que deve ser informada é:

• http://seu-dominio/diretorio-seu-projeto/moip_assinaturas/webhooks

Todas as notificações que chegarem nesse endereço passarão por 3 verificações:

1. Se o Webhook está ativado nas configurações do plugin;
2. Se o Token do Nasp foi informado nas configurações do plugin;
3. Se o Token do Nasp informado na configuração é o mesmo do Header da Notificação.

Se algum desse falhar, a notificação não será processada e retornará uma mensagem de erro de acordo com o erro.

Para utilizar os dados da notificação, será necessário criar um Controller onde você poderá customizar ou tomar ações baseados nessas notificações. Como por exemplo, disparar um e-mail para o cliente ou gravar os dados no banco, baseado nos tipos das notificações. Veja aqui os tipos.

* Nota importante: o Controller, você deverá criar no diretório app/Controller da sua aplicação e deverá ter o nome "NaspController", e possuir pelo menos um método que deverá se chamar "process".

Exemplo para NaspController onde o método process grava as informações recebidas no banco de dados em formato JSON:

<?php

App::uses('AppController', 'Controller');

class NaspController extends AppController {

public $uses = array('Log');

public $components = array();

public function process($data){
    $this->request->data['Log']['log'] = json_encode($data);

    if ($this->Log->save($this->request->data)) {
        echo 'Dados salvos com sucesso';
    } else {
        echo 'Ocorreu um erro ao salvar os dados';
    }
}
}

?>

Considerações finais

Em caso de bugs, abra uma issue no Git Hub:

• Sign in · GitHub

Como contribuir via Git Hub:

1. Fork it
2. Crie um novo branch ("git checkout -b my-new-feature")
3. Commit suas features ("git commit -am 'Add some feature'")
4. Push ("git push origin my-new-feature")
5. Crie um novo Pull Request

Contribuições são bem-vindas.

Repositório do projeto no Git Hub:

• fabiowlima/moip-assinaturas-cakephp - GitHub

Documentação oficial:

• Moip Assinaturas - Documentação online

Qualquer dúvida em utilizar, é só mandar um e-mail que tento ajudar como posso:

Fábio Lima [fabio@bendit.com.br]
Bendit - Web & Mobile