Skip to main content
knowledgecenter.2checkout.com

INS parameters

Note to user NOTE:  Instant Notification Service (INS) is available only to merchants migrated from 2Checkout 1.0 platform.

Overview

Depending on your INS settings, notifications contain all or a subset of the available parameters. 2Checkout sends INS parameters in the exact order listed in this article.

For each trigger enabled, you are able to select which URL endpoint receives the notification, as well as customize the list of parameters included in the notification. Read more about INS parameters here.

Note: 2Checkout continues to add new INS parameters on an ongoing basis. To include additional information in the notifications, enable new parameters in the INS settings page.

Parameter Description Type
message_type Indicates type of message String
message_description Human readable description of message_type String
timestamp Timestamp of event; format YYYY-MM-DD HH:MM:SS ZZZ Timestamp
md5_hash Hash calculated for the notification. String
message_id This number is incremented for each message sent to a given seller Integer
key_count Indicates the number of parameters sent in message Integer
vendor_id Merchant account number Integer
sale_id 2Checkout sale number Integer
sale_date_placed Date of sale; format YYYY-MM-DD Date
vendor_order_id Custom order id provided by seller, if available. (“merchant_order_id” can be passed into the checkout with the sale parameters) String
invoice_id 2Checkout invoice number; Each sale can have several invoices, most commonly one per installment billed on a recurring order. Integer
recurring recurring=1 if any item on the invoice is a recurring item, 0 otherwise Integer
payment_type Customer’s payment method. String
list_currency 3-Letter ISO code for seller currency String
cust_currency 3-Letter ISO code for customer currency String
auth_exp The date credit authorization will expire; format YYYY-MM-DD Date
invoice_status Status of a transaction (approved, pending, deposited, or declined) String
fraud_status Status of 2Checkout fraud review (pass, fail, or wait); Can be NULL. String
invoice_list_amount Total in seller pricing currency; format as appropriate to currency (2 decimal places for most, integer for JPY) Integer
invoice_usd_amount Total in US Dollars; format with 2 decimal places Integer
invoice_cust_amount Total in customer currency; format as appropriate to currency (2 decimal places for most, integer for JPY) Integer
customer_first_name Customer’s first name (may not be available on older sales) String
customer_last_name Customer’s last name (may not be available on older sales) String
customer_name Customer’s full name (name as it appears on credit card) String
customer_email Customer’s email address String
customer_phone Customer’s phone number; all but digits stripped out Integer
customer_ip Customer’s IP address at time of sale String
customer_ip_country Country of record for customer’s IP address at time of sale; Please note in some cases what is returned is not a country, Ex. Satellite Provider String
bill_street_address Billing street address String
bill_street_address2 Billing street address line 2 String
bill_city Billing address city String
bill_state Billing address state or province String
bill_postal_code Billing address postal code String
bill_country 3-Letter ISO country code of billing address String
ship_status Value will be not_shipped, shipped, or empty (if intangible / does not need shipped) String
ship_tracking_number Tracking Number as entered in Seller Admin String
ship_name Shipping Recipient’s name (as it should appears on shipping label) String
ship_street_address Shipping street address String
ship_street_address2 Shipping street address line 2 String
ship_city Shipping address city String
ship_state Shipping address state or province String
ship_postal_code Shipping address postal code String
ship_country 3-Letter ISO country code of shipping address String
item_count Indicates how many numbered sets of item parameters to expect Integer
item_name_# Product name String
item_id_# Seller product id String
item_list_amount_# Total in seller pricing currency; format as appropriate to currency (2 decimal places for most, integer for JPY) Integer
item_usd_amount_# Total in US Dollars; format with 2 decimal places Integer
item_cust_amount_# Total in customer currency; format as appropriate to currency (2 decimal places for most, integer for JPY) Integer
item_type_# Indicates if item is a bill or refund; Value will be bill or refund String
item_duration_# Product duration, how long it re-bills for Ex. 1 Year String
item_recurrence_# Product recurrence, how often it re-bills Ex. 1 Month String
item_rec_list_amount_# Product price; format as appropriate to currency (2 decimal places for most, integer for JPY) Integer
item_rec_status_# Indicates status of recurring subscription. Ex: canceled, completed String
item_rec_date_next_# Date of next recurring installment; Date
item_rec_install_billed_# The number of successful recurring installments successfully billed Integer

 

  • Was this article helpful?