Skip to main content
knowledgecenter.avangate.com

INS read receipt response

Note to user NOTE:  Instant Notification Service (INS) is available only to 2Checkout upgraded merchants.

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
    }