INS read receipt response
Overview
Notifications are sent by an HTTP POST request to the message URL that you specified on the INS Notifications tab.
The message parameters are passed as key => value pairs. Your message URLs should route to the script where you will be handling the message. You can listen for messages by simply setting up logic in your application to take action based on the message_type parameter that is passed in each message.
Validate response
Each notification message will include an MD5 hash that is computed using the secret word that you set up under in your Control Panel.
The hash is returned on each message through the md5_hash key.
Example message
Below is an example INS received caused by an event of order creation.
{ auth_exp => bill_city => Columbus bill_country => USA bill_postal_code => 43215 bill_state => OH bill_street_address => 855 Grandview Avenue bill_street_address2 => Suite 11 cust_currency => GBP customer_email => no-reply@2co.com customer_first_name => Testing customer_ip => 192.168.2.250 customer_ip_country => Unknown customer_last_name => Tester customer_name => Testing Tester customer_phone => 6149212450 fraud_status => pass invoice_cust_amount => 2.00 invoice_id => 4632527490 invoice_list_amount => 2.00 invoice_status => approved invoice_usd_amount => 3.04 item_count => 2 item_cust_amount_1 => 2.00 item_cust_amount_2 => 2.00 item_duration_1 => Forever item_duration_2 => Forever item_id_1 => test recurring product item_id_2 => test recurring product item_list_amount_1 => 2.00 item_list_amount_2 => 2.00 item_name_1 => test recurring product item_name_2 => test recurring product item_rec_date_next_1 => 2012-02-18 item_rec_date_next_2 => item_rec_install_billed_1 => 1 item_rec_install_billed_2 => 1 item_rec_list_amount_1 => 1.00 item_rec_list_amount_2 => 1.00 item_rec_status_1 => cancelled item_rec_status_2 => item_recurrence_1 => 1 Week item_recurrence_2 => 1 Week item_type_1 => bill item_type_2 => refund item_usd_amount_1 => 3.04 item_usd_amount_2 => 3.04 key_count => 68 list_currency => GBP md5_hash => 42C25A6BBA17D226C725B92A4A40C34A message_description => Order fraud status changed message_id => 2636 message_type => FRAUD_STATUS_CHANGED payment_type => credit card recurring => 1 sale_date_placed => 2012-02-11 09:11:18 sale_id => 4632527448 ship_city => Columbus ship_country => USA ship_name => Testing Tester ship_postal_code => 43215 ship_state => OH ship_status => shipped ship_street_address => 855 Grandview Avenue ship_street_address2 => Suite 11 ship_tracking_number => timestamp => 2012-02-11 18:47:02 vendor_id => 532001 vendor_order_id => test123 }