Criar Preferência de Notificação

Atributos e requisição

📘

TUTORIAL

1. Escolha o tipo de evento que deseja receber. Você pode setar mais de um tipo de events;
2. em target coloque a URL destino para onde o Moip deve enviar os webhooks;
3. o valor possível em media deve ser WEBHOOK.

👍

DICA

Caso não tenha uma URL disponível você pode usar o Beeceptor para fazer seus testes e receber os webhooks. Para isso basta acessar o site e gerar uma URL.

1. Entre no site, crie uma URL e clique em "Create Endpoint";
2. copie a URL gerada e use-a no valor do target da requisição de criação de preferência de notificação.

Dessa forma o Moip enviará os webhooks para a URL gerada e nela você poderá ver as notificações que recebeu.

Atenção

O Beeceptor é apenas uma ferramenta que deve ser usada a fim de fazer testes em sua aplicação. A URL gerada é provisória e você deve trocar para uma URL permanente logo que tenha uma.

Recebendo webhooks em URLs diferentes

Você pode receber seus webhooks em URLs diferentes.

1. É possível receber eventos diferentes em URLs diferentes. Por exemplo, você pode receber os webhooks de ORDER.* em uma URL e PAYMENT.* em outra. Para isso você deve fazer uma request para cada evento. Veja o exemplo abaixo:

#Recebendo webhooks de ORDER em uma URL

{ 
   "events":[  
      "ORDER.*"
   ],
   "target":"https://requestb.in/1cm5ayt1",
   "media":"WEBHOOK"
}

#Recebendo webhooks de PAYMENT em outra URL

{  
   "events":[  
      "PAYMENT.*"
   ],
   "target":"https://requestb.in/szr4cvsz",
   "media":"WEBHOOK"
}

2. É possível que um mesmo webhook seja enviado para URLs diferentes. Para isso crie requisições diferentes para cada URL. Observe o exemplo:

Request 1

{  
   "events":[  
      "ORDER.PAID",
      "PAYMENT.SETTLED*"
   ],
   "target":"https://requestb.in/1gvew421",
   "media":"WEBHOOK"
}

Request 2

{  
   "events":[  
      "ORDER.PAID",
      "PAYMENT.SETTLED*"
   ],
   "target":"https://requestb.in/14v2gx31",
   "media":"WEBHOOK"
}
Language