{"id":501,"date":"2011-08-27T10:32:36","date_gmt":"2011-08-27T10:32:36","guid":{"rendered":"http:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/?p=501"},"modified":"2015-12-03T02:56:23","modified_gmt":"2015-12-03T02:56:23","slug":"api-awarding-commission-via-wordpress-hook","status":"publish","type":"post","link":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501","title":{"rendered":"API &#8211; Awarding Commission Via WordPress Hook"},"content":{"rendered":"<p>If you are a plugin developer and want to integrate your plugin with the WP Affiliate platform plugin then you can use the action hook mentioned in this documentation to do so.<\/p>\n<p><em><strong><span style=\"color: #ff0000;\">This documentation is only for WordPress plugin developers. If you are not a WordPress plugin developer then you have no need to read this.<\/span><\/strong><\/em><\/p>\n<h3>Awarding Commission From Another WordPress Plugin or Theme Using a Hook<\/h3>\n<p>When you want to award the commission from your plugin (for example: after a payment is confirmed or after a user submits the contact form) you can simply use the following code block (and pass in the required details). The affiliate plugin will credit the appropriate affiliate account:<\/p>\n<pre>$sale_amt = \"19.95\"; \/\/TODO - The commission is calculated based on this amount\r\n$unique_transaction_id = \"Txn-ID\"; \/\/TODO -\u00a0The unique transaction ID for reference\r\n$email = \"Buyer-email-goes-here\"; \/\/TODO -\u00a0Customer email for record\r\n$referrer = $_COOKIE['ap_id'];\/\/Cookie value is read from the customer's browser\r\ndo_action('wp_affiliate_process_cart_commission', array(\"referrer\" =&gt; $referrer, \"sale_amt\" =&gt;$sale_amt, \"txn_id\"=&gt;$unique_transaction_id, \"buyer_email\"=&gt;$email));\r\n<\/pre>\n<p>You only need to adjust the values in the first 3 lines of the above example code (marked with &#8220;TODO&#8221; comments)<\/p>\n<h3>How To Get Referrer ID (Affiliate ID)<\/h3>\n<p>There are two ways to get the referrer ID value (use one of the following options):<\/p>\n<p><strong>Option 1:<\/strong> The referrer value is stored in the browser&#8217;s cookie by the affiliate plugin and you can access it like the following:<\/p>\n<pre> $referrer = $_COOKIE['ap_id'];\r\n<\/pre>\n<p>If you need to pass the referrer value to a back-end post payment processing script (example: a payment notification handling script) then you can add this cookie value to the custom field.<\/p>\n<p><strong>Option 2:<\/strong> If you know the IP address of the user then you can call the following function and pass in the IP address. This function will return the referrer ID for that user (if any):<\/p>\n<pre>$referrer = wp_aff_get_referrer_id_from_ip_address($ip_address)\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>If you are a plugin developer and want to integrate your plugin with the WP Affiliate platform plugin then you can use the action hook mentioned in this documentation to do so. This documentation is only for WordPress plugin developers. If you are not a WordPress plugin developer then you have no need to read [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_genesis_hide_title":false,"_genesis_hide_breadcrumbs":false,"_genesis_hide_singular_image":false,"_genesis_hide_footer_widgets":false,"_genesis_custom_body_class":"","_genesis_custom_post_class":"","_genesis_layout":"","footnotes":""},"categories":[12],"tags":[],"class_list":{"0":"post-501","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-3rd-party-cart-integration","7":"entry"},"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.2 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>API - Awarding Commission Via WordPress Hook<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"admin\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501\"},\"author\":{\"name\":\"admin\",\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#\/schema\/person\/b3a690506213824832751de546a340fb\"},\"headline\":\"API &#8211; Awarding Commission Via WordPress Hook\",\"datePublished\":\"2011-08-27T10:32:36+00:00\",\"dateModified\":\"2015-12-03T02:56:23+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501\"},\"wordCount\":254,\"commentCount\":1,\"articleSection\":[\"3rd Party Cart Integration\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501\",\"url\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501\",\"name\":\"API - Awarding Commission Via WordPress Hook\",\"isPartOf\":{\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#website\"},\"datePublished\":\"2011-08-27T10:32:36+00:00\",\"dateModified\":\"2015-12-03T02:56:23+00:00\",\"author\":{\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#\/schema\/person\/b3a690506213824832751de546a340fb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501\"]}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#website\",\"url\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/\",\"name\":\"WordPress Affiliate Platform\",\"description\":\"Take control of your affiliates and drive more sales\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#\/schema\/person\/b3a690506213824832751de546a340fb\",\"name\":\"admin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/3a21ab4072e533cf470d80fc2f0fd3639872824ade4e23709397e109b24f8857?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/3a21ab4072e533cf470d80fc2f0fd3639872824ade4e23709397e109b24f8857?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/3a21ab4072e533cf470d80fc2f0fd3639872824ade4e23709397e109b24f8857?s=96&d=mm&r=g\",\"caption\":\"admin\"},\"url\":\"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/author\/admin\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"API - Awarding Commission Via WordPress Hook","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501","twitter_misc":{"Written by":"admin","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501#article","isPartOf":{"@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501"},"author":{"name":"admin","@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#\/schema\/person\/b3a690506213824832751de546a340fb"},"headline":"API &#8211; Awarding Commission Via WordPress Hook","datePublished":"2011-08-27T10:32:36+00:00","dateModified":"2015-12-03T02:56:23+00:00","mainEntityOfPage":{"@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501"},"wordCount":254,"commentCount":1,"articleSection":["3rd Party Cart Integration"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501","url":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501","name":"API - Awarding Commission Via WordPress Hook","isPartOf":{"@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#website"},"datePublished":"2011-08-27T10:32:36+00:00","dateModified":"2015-12-03T02:56:23+00:00","author":{"@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#\/schema\/person\/b3a690506213824832751de546a340fb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/api-awarding-commission-via-wordpress-hook-501"]}]},{"@type":"WebSite","@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#website","url":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/","name":"WordPress Affiliate Platform","description":"Take control of your affiliates and drive more sales","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/#\/schema\/person\/b3a690506213824832751de546a340fb","name":"admin","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/3a21ab4072e533cf470d80fc2f0fd3639872824ade4e23709397e109b24f8857?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/3a21ab4072e533cf470d80fc2f0fd3639872824ade4e23709397e109b24f8857?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/3a21ab4072e533cf470d80fc2f0fd3639872824ade4e23709397e109b24f8857?s=96&d=mm&r=g","caption":"admin"},"url":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/author\/admin"}]}},"_links":{"self":[{"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/posts\/501","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/comments?post=501"}],"version-history":[{"count":0,"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/posts\/501\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/media?parent=501"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/categories?post=501"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tipsandtricks-hq.com\/wordpress-affiliate\/wp-json\/wp\/v2\/tags?post=501"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}