Etisalat Integration Guide (Infomedia-Hosted)

Webhooks

Infomedia sends webhooks when various events occur. For full details on webhook parameters, see the Webhook Documentation↗ page.

The table below shows all webhook types supported by this integration. Not all webhook types are mandatory. Please ask your account manager if you would like changes to the enabled webhooks. Examples for each type and an explanation of when to expect them can be found below.

Subscribe

See Acquisition - PIN Entry Page↗ for details on when you will receive this webhook.

Example Subscribe Webhook 
https://www.example.com/?msisdn=971500000000&mcc=424&mnc=2&productid=92000000&etid=1&pt=Your_pass_through_value&success=1

Unsubscribe

See Cancellation - Other Routes↗ for details on when you will receive this webhook.

Example Unsubscribe Webhook 
https://www.example.com/?msisdn=971500000000&mcc=424&mnc=2&productid=92000000&etid=2&pt=Your_pass_through_value&success=1

Reactivation

See Acquisition - PIN Entry Page↗ for details on when you will receive this webhook.

Example Reactivation Webhook 
https://www.example.com/?msisdn=971500000000&mcc=424&mnc=2&productid=92000000&etid=3&pt=Your_pass_through_value&success=1

Charge

Infomedia automatically processes charges for customers when their renewals are due. Note that the exact timing of charge attempts is not consistent due to various optimisation processes that exist within the system to maximise success rates and revenues. A charge may only include a partial payment for the customer. This will be indicated by the amount shown in the webhook.

For full details on each parameter, see the Webhook Documentation↗ page.

Example Charge Webhook 
https://www.example.com/?msisdn=971500000000&mcc=424&mnc=2&productid=92000000&etid=5&pt=Your+pass+through+value&chargeAmount=20&currencyCode=AED&productDescription=Your+product+description&transactionStatus=00&success=1

Suspend

This is an optional webhook. It is sent when a user fails a number of charge attempts that exceeds the grace period. The default grace period is 0, which means customers are suspended immediately on any failed payment and therefore this webhook is often not required, however if you would like a different grace period configured, please speak to your account manager.

Example Suspend Webhook 
https://www.example.com/?msisdn=971500000000&mcc=424&mnc=2&productid=92000000&etid=24&pt=Your_pass_through_value&success=1

Unsuspend

This is an optional webhook. It is sent when a user is successfully charged whilst being suspended (see above). It is recommended to implement this if you have requested Suspend webhooks.

Example Unsuspend Webhook 
https://www.example.com/?msisdn=971500000000&mcc=424&mnc=2&productid=92000000&etid=25&pt=Your_pass_through_value&success=1

Refund

Refunds can be processed for customers under certain conditions. When this occurs, a webhook will be sent to you to confirm which transaction was refunded and the amount.

Example Refund Webhook 
https://www.example.com/?msisdn=971500000000&mcc=424&mnc=2&productid=92000000&etid=31&pt=Your+pass+through+value&chargeAmount=20&currencyCode=AED&productDescription=Your+product+description&transactionStatus=00&success=1