This article contains the data that is pinged by our IPN system when a customer processes a one-time payment order or when a refund is issued. The main difference between sale and refund or partial_refund is the transaction_type variable (see table below), which is for the sale, (refund) for the refund and partial_refund for the partial refund.

In case of a refund or partial refund, the system also sends the transaction_parent_id parameter, which is the original sale's order ID. That will help you identify which original transaction is being refunded.


Sale variables for IPN

Variable name
Description
transaction_idKartra order id
transaction_full_amountThe amount paid by the customer
transaction_base_amountThe base price for the transaction
transaction_discountIf any discount coupon was applied, the amount deducted from the original price
transaction_shippingThe shipping price
transaction_taxThe sales tax or VAT
transaction_dateThe date of the transaction. Format yyyy-mm-dd hh:mm:ss EST
transaction_typeThe transaction type. Possible values: ‘sale’
transaction_parent_id0
transaction_affiliateThe username of the affiliate ('N/A' if no affiliate)
transaction_jvThe username of the jv broker ('N/A' if no jv)
transaction_quantityProduct units
transaction_subscription_id'N/A'
transaction_internal_subscription_id'N/A'
transaction_subscription_pay_number'N/A'
transaction_last_4_card_digitsThe last 4 digits of the used card ('N/A' if PayPal)
original_id0
product_nameThe name of the purchased product
product_idThe ID of the product
product_price_pointThe price point number. This is a number from 1 onwards
trial0
trial_amountN/A
trial_periodN/A
payments_left0
lead_idBuyer's unique identifier id
lead_first_nameBuyer's first name
lead_last_nameBuyer's last name
lead_emailBuyer's email
lead_usernameBuyer’s username
lead_phone_country_codeBuyer's phone country code
lead_phone_numberBuyer's phone number
lead_addressBuyer's billing address
lead_cityBuyer's billing city
lead_zipBuyer's billing ZIP
lead_stateBuyer's billing state
lead_countryBuyer's billing country
lead_country_code_2Buyer's two letter country code
lead_country_code_3Buyer's three letter country code
lead_ipBuyer's IP
shipping_addressBuyer's shipping address
shipping_cityBuyer's shipping city
shipping_zipBuyer's shipping ZIP
shipping_stateBuyer's shipping state
shipping_countryBuyer's shipping country
secret_keyThe secret key you setup when you created the notification
vendor_tracking_id_1Vendor's tracking ID 1 if the sale was generated from a tracking link
vendor_tracking_id_2Vendor's tracking ID 2 if the sale was generated from a tracking link
vendor_tracking_linkVendor's tracking link name
gdpr_lead_statusinteger, possible values:
  • 0 - For GDPR status off - Your account has GDPR deactivated
  • 1 - For GDPR status not subject - The lead's IP is from a country not subject to GDPR
  • 2 - For GDPR status accepted - The lead has accepted the GDPR terms
  • 3 - For GDPR status not accepted - The lead hasn't accepted the GDPR terms
  • 4 - For GDPR status unknown - The lead's location could not be determined
  • 5 - For GDPR status pending
gdpr_lead_status_datestring (DD Mmm YYYY HH:MM:SS)
gdpr_lead_status_ipstring
gdpr_lead_communications
integer, possible values: 0 - Lead hasn't agreed to be contacted 1 - Lead has agreed to be contacted
payment_processor_type"PayPal" "Braintree" "Stripe" " Authorize.net"
kartra_reference_idKartra internal reference id
lead_companyBuyer’s company
lead_sales_tax_idBuyer’s sales tax id

Refund, partial refund, and chargeback variables for IPN

transaction_idKartra order id
transaction_full_amountThe amount paid by the customer
transaction_base_amountThe base price for the transaction
transaction_discountIf any discount coupon was applied, the amount deducted from the original price
transaction_shippingThe shipping price
transaction_taxThe sales tax or VAT
transaction_dateThe date of the transaction. Format yyyy-mm-dd hh:mm:ss EST
transaction_typeThe transaction type. Possible values: 'refund', 'partial_refund', 'chargeback'
transaction_parent_idThe id of the parent transaction
transaction_affiliateThe username of the affiliate ('N/A' if no affiliate)
transaction_jvThe username of the jv broker ('N/A' if no jv)
transaction_quantityProduct units
transaction_subscription_id'N/A'
transaction_internal_subscription_id'N/A'
transaction_subscription_pay_number'N/A'
original_id0
product_nameThe name of the purchased product
product_idThe ID of the product
product_price_pointThe price point number. This is a number from 1 onwards
lead_idBuyer's unique identifier id
lead_first_nameBuyer's first name
lead_last_nameBuyer's last name
lead_emailBuyer's email
lead_usernameBuyer’s username
lead_phone_country_codeBuyer's phone country code
lead_phone_numberBuyer's phone number
lead_addressBuyer's billing address
lead_cityBuyer's billing city
lead_zipBuyer's billing ZIP
lead_stateBuyer's billing state
lead_countryBuyer's billing country
lead_country_code_2Buyer's two letter country code
lead_country_code_3Buyer's three letter country code
shipping_addressBuyer's shipping address
shipping _cityBuyer's shipping city
shipping _zipBuyer's shipping ZIP
shipping _stateBuyer's shipping state
shipping _countryBuyer's shipping country
secret_keyThe secret key you setup when you created the notification
vendor_tracking_id_1Vendor's tracking ID 1 if the sale was generated from a tracking link
vendor_tracking_id_2Vendor's tracking ID 2 if the sale was generated from a tracking link
vendor_tracking_linkVendor's tracking link name
gdpr_lead_statusinteger, possible values:
  • 0 - For GDPR status off - Your account has GDPR deactivated
  • 1 - For GDPR status not subject - The lead's IP is from a country not subject to GDPR
  • 2 - For GDPR status accepted - The lead has accepted the GDPR terms
  • 3 - For GDPR status not accepted - The lead hasn't accepted the GDPR terms
  • 4 - For GDPR status unknown - The lead's location could not be determined
  • 5 - For GDPR status pending
gdpr_lead_status_datestring (DD Mmm YYYY HH:MM:SS)
gdpr_lead_status_ipstring
gdpr_lead_communications
integer, possible values: 0 - Lead hasn't agreed to be contacted 1 - Lead has agreed to be contacted
payment_processor_type"PayPal" "Braintree" "Stripe" " Authorize.net"
lead_companyBuyer’s company
lead_sales_tax_idBuyer’s sales tax id