ISN (Instant Sale Notification)
The
ISN allows PromoPit merchants to receive an automated notication to any URL immediately after a completed sale. The ISN contains important transaction information and customer contact details to facilitate product delivery and sales system integration. When adding a product in PromoPit, you will have the option to specify your
ISN URL. The following data will be posted to your ISN URL.
ISN Data
| isn_key |
PromoPit ISN key used to validate the notifaction |
| promopit_txn_id |
PromoPit Transaction ID |
| paypal_txn_id |
PayPal Transaction ID |
| txn_date |
Transaction date in the format YYYY-MM-DD HH:MM:SS |
| txn_amount |
Total transaction amount (the purchase price) |
| txn_net |
Merchant net transaction amount (after commissions and fees) |
| txn_currency |
Transaction currency (USD) |
| product_name |
Product name as defined in the product setup |
| my_product_id |
The product ID that you define in the product setup (optional) |
| promopit_product_id |
Product ID as assigned to the product by PromoPit |
| customer_name |
Customer name |
| customer_email |
Customer email |
| customer_user_id |
Customer user_id |
| test_mode |
Will have a value of 1 if ISN sent using the ISN test tool |
Requesting Additional Information
When adding your product, on the
Delivery tab, you will have the option to request additional information from the buyer. This information will be included in the ISN as additional fields in the order specified.
| add_info_1 |
The name or label that you used to request information (example: "Color") |
| add_value_1 |
The value corresponding to add_info_1 (example: "Red") |
| add_info_2 |
The name or label that you used to request information (example: "Name") |
| add_value_2 |
The value corresponding to add_info_2 (example: "Mark") |
| ... |
... |
Custom Fields
When adding your product, on the
Delivery tab, you will have the option to specify up to 6 additional custom fields. This information will be included in the ISN as additional fields in the order specified.
| custom_1 |
The value you specify for the custom_1 field |
| custom_2 |
The value you specify for the custom_2 field |
| custom_3 |
The value you specify for the custom_3 field |
| custom_4 |
The value you specify for the custom_4 field |
| custom_5 |
The value you specify for the custom_5 field |
| custom_6 |
The value you specify for the custom_6 field |
Sample Code
Samples for ISN receiving script (
ISN URL)