' . "\n"; /**/ echo '

' . "\n"; echo '

s2Member® API / Notifications

' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ do_action ("ws_plugin__s2member_during_api_ops_page_before_left_sections", get_defined_vars ()); /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_signup_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_signup_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '' . "\n"; /**/ echo '
' . "\n"; } /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_registration_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_registration_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; echo '

Registration Notification URLs ( optional )

' . "\n"; echo '

If you use affiliate software, or have back-office routines that need to be notified whenever a "new" Member is created, you\'ll want to read this section. This is marked `Registration`, because the URLs that you list below, will be notified each time a "new" Member registers a Username. This is usually triggered right after a `Signup` Notification; at the point in which a "new" Member successfully completes the Registration form, and they are assigned a Username.

' . "\n"; echo '

This Notification is ALSO triggered whenever you create a "new" User inside your WordPress® Dashboard.

' . "\n"; echo '

Please note, this feature is not to be confused with the PayPal® IPN service. PayPal® IPN ( and other service integrations ) are already built into s2Member. They remain active at all times. These Registration Notifications are an added layer of functionality, and they are completely optional.

' . "\n"; do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_during_registration_notifications", get_defined_vars ()); /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo 'You can input multiple Notification URLs by inserting one per line.
' . "\n"; echo '
' . "\n"; echo 'Registration Notifications take place silently behind-the-scene, using an HTTP connection.

' . "\n"; echo 'You can also use these special Replacement Codes if you need them:' . "\n"; echo '
    ' . "\n"; echo '
  • %%role%% = The Role ID ( subscriber, s2member_level[0-9]+, administrator, editor, author, contributor ).
  • ' . "\n"; echo '
  • %%level%% = The Level number ( 0, 1, 2, 3, 4 ). ( deprecated, no longer recommended; use %%role%% )
  • ' . "\n"; echo '
  • %%ccaps%% = Custom Capabilities. Ex: music,videos,free_gift ( in comma-delimited format ).
  • ' . "\n"; echo '
  • %%auto_eot_time%% = Auto-EOT Time ( if applicable ). Ex: 1299925670 ( unix timestamp ).
  • ' . "\n"; echo '
  • %%user_first_name%% = The First Name of the Member who registered their Username.
  • ' . "\n"; echo '
  • %%user_last_name%% = The Last Name of the Member who registered their Username.
  • ' . "\n"; echo '
  • %%user_full_name%% = The Full Name ( First & Last ) of the Member who registered their Username.
  • ' . "\n"; echo '
  • %%user_email%% = The Email Address of the Member who registered their Username.
  • ' . "\n"; echo '
  • %%user_login%% = The Username the Member selected during registration.
  • ' . "\n"; echo '
  • %%user_pass%% = The Password selected or generated during registration.
  • ' . "\n"; echo '
  • %%user_ip%% = The User\'s IP Address, detected via $_SERVER["REMOTE_ADDR"].
  • ' . "\n"; echo '
  • %%user_id%% = A unique WordPress® User ID generated during registration.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Registration/Profile Fields are also supported in this Notification:' . "\n"; echo '
    ' . "\n"; echo '
  • %%date_of_birth%% would be valid; if you have a Custom Registration/Profile Field with the ID date_of_birth.
  • ' . "\n"; echo '
  • %%street_address%% would be valid; if you have a Custom Registration/Profile Field with the ID street_address.
  • ' . "\n"; echo '
  • %%country%% would be valid; if you have a Custom Registration/Profile Field with the ID country.
  • ' . "\n"; echo '
  • %%etc, etc...%% see: s2Member -> General Options -> Registration/Profile Fields.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Replacement Codes can also be inserted using these instructions:' . "\n"; echo '
    ' . "\n"; echo '
  • %%cv0%% = The domain of your site, which is passed through the `custom` attribute in your Shortcode.
  • ' . "\n"; echo '
  • %%cv1%% = If you need to track additional custom variables, you can pipe delimit them into the `custom` attribute; inside your Shortcode, like this: custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|cv1|cv2|cv3". You can have an unlimited number of custom variables. Obviously, this is for advanced webmasters; but the functionality has been made available for those who need it.
  • ' . "\n"; echo '
' . "\n"; echo 'This example uses cv1 to record a special marketing campaign:
' . "\n"; echo '( The campaign ( i.e. christmas-promo ) could be referenced using %%cv1%% )
' . "\n"; echo 'custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|christmas-promo"' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '
' . "\n"; echo 'This is a semicolon ( ; ) delimited list of Recipients. Here is an example:
' . "\n"; echo '"John" <john@example.com>; admin@example.com; "Webmaster" <webmaster@example.com>' . "\n"; echo '
' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_after_registration_notifications", get_defined_vars ()); } /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_payment_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_payment_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; echo '

Payment Notification URLs ( optional )

' . "\n"; echo '

If you use affiliate software, or have back-office routines that need to be notified whenever payment transactions ( including Recurring Payments ) take place, you\'ll want to read this section. This is marked `Payment`, because the URLs that you list below, will be notified each time an actual payment occurs. Depending on your fee structure, this may include a first Initial Payment that establishes a Subscription. But more importantly, this will be triggered on all future payments that are received for the lifetime of the Subscription.

' . "\n"; echo '

So, unlike the `Signup` Notification, `Payment` Notifications take place whenever actual payments are received, instead of just once after signup is completed. If a payment is required during signup ( i.e. no Free Trial is being offered ), a Signup Notification will be triggered, and a Payment Notification will ALSO be triggered. In other words, a Payment Notification occurs anytime funds are received, no matter what.

' . "\n"; echo (!is_multisite () || !c_ws_plugin__s2member_utils_conds::is_multisite_farm () || is_main_site ()) ? '

Payment Notifications are also triggered whenever a Buy Now purchase for Independent Custom Capabilities takes place.

' . "\n" : ''; echo '

Please note, this feature is not to be confused with the PayPal® IPN service. PayPal® IPN ( and other service integrations ) are already built into s2Member. They remain active at all times. These Payment Notifications are an added layer of functionality, and they are completely optional.

' . "\n"; do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_during_payment_notifications", get_defined_vars ()); /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo 'You can input multiple Notification URLs by inserting one per line.
' . "\n"; echo '
' . "\n"; echo 'Payment Notifications take place silently behind-the-scene, using an HTTP connection.

' . "\n"; echo 'You can also use these special Replacement Codes if you need them:' . "\n"; echo '
    ' . "\n"; echo '
  • %%subscr_id%% = The Paid Subscription ID, which remains constant throughout any & all future payments. [ ? ]
  • ' . "\n"; echo '
  • %%txn_id%% = The Payment Transaction ID, which is always unique for each payment received.
  • ' . "\n"; echo '
  • %%amount%% = The Amount of the payment. Most affiliate programs calculate commissions from this.
  • ' . "\n"; echo '
  • %%first_name%% = The First Name of the Customer who purchased the Membership Subscription' . ((is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) ? '' : ' or Capabilities.') . '
  • ' . "\n"; echo '
  • %%last_name%% = The Last Name of the Customer who purchased the Membership Subscription' . ((is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) ? '' : ' or Capabilities.') . '
  • ' . "\n"; echo '
  • %%full_name%% = The Full Name ( First & Last ) of the Customer who purchased the Membership Subscription' . ((is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) ? '' : ' or Capabilities.') . '
  • ' . "\n"; echo '
  • %%payer_email%% = The Email Address of the Customer who purchased the Membership Subscription' . ((is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) ? '' : ' or Capabilities.') . '
  • ' . "\n"; echo '
  • %%item_number%% = The Item Number ( colon separated level:custom_capabilities:fixed term ) that the payment is for.' . ((is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) ? '' : ' [ ? ]') . '
  • ' . "\n"; echo '
  • %%item_name%% = The Item Name ( as provided by the desc="" attribute in your Shortcode, which briefly describes the Item Number ).
  • ' . "\n"; echo '
  • %%user_first_name%% = The First Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_last_name%% = The Last Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_full_name%% = The Full Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_email%% = The Email Address associated with their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_login%% = The Username associated with their account. The Customer created this during registration.
  • ' . "\n"; echo '
  • %%user_ip%% = The Customer\'s original IP Address, during checkout/registration via $_SERVER["REMOTE_ADDR"].
  • ' . "\n"; echo '
  • %%user_id%% = A unique WordPress® User ID that references this account in the WordPress® database.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Registration/Profile Fields are also supported in this Notification:' . "\n"; echo '
    ' . "\n"; echo '
  • %%date_of_birth%% would be valid; if you have a Custom Registration/Profile Field with the ID date_of_birth.
  • ' . "\n"; echo '
  • %%street_address%% would be valid; if you have a Custom Registration/Profile Field with the ID street_address.
  • ' . "\n"; echo '
  • %%country%% would be valid; if you have a Custom Registration/Profile Field with the ID country.
  • ' . "\n"; echo '
  • %%etc, etc...%% see: s2Member -> General Options -> Registration/Profile Fields.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Replacement Codes can also be inserted using these instructions:' . "\n"; echo '
    ' . "\n"; echo '
  • %%cv0%% = The domain of your site, which is passed through the `custom` attribute in your Shortcode.
  • ' . "\n"; echo '
  • %%cv1%% = If you need to track additional custom variables, you can pipe delimit them into the `custom` attribute; inside your Shortcode, like this: custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|cv1|cv2|cv3". You can have an unlimited number of custom variables. Obviously, this is for advanced webmasters; but the functionality has been made available for those who need it.
  • ' . "\n"; echo '
' . "\n"; echo 'This example uses cv1 to record a special marketing campaign:
' . "\n"; echo '( The campaign ( i.e. christmas-promo ) could be referenced using %%cv1%% )
' . "\n"; echo 'custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|christmas-promo"' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '
' . "\n"; echo 'This is a semicolon ( ; ) delimited list of Recipients. Here is an example:
' . "\n"; echo '"John" <john@example.com>; admin@example.com; "Webmaster" <webmaster@example.com>' . "\n"; echo '
' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_after_payment_notifications", get_defined_vars ()); } /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_modification_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_modification_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; echo '

Modification Notification URLs ( optional )

' . "\n"; echo '

If you use affiliate software, or have back-office routines that need to be notified each time a new Subscription is created by an "existing" User/Member, or an "existing" Member modifies their paid Subscription terms, you\'ll want to read this section. This is marked `Modification`, because the URLs that you list below, will be notified each time an "existing" User/Member ( even if they are/were a Free Subscriber ) signs up for a paid Subscription ( i.e. a Modification takes place against an existing account within WordPress® ), or an "existing" Member modifies their paid Subscription terms ( again, a Modification takes places against an existing account within WordPress® ). Depending on your fee structure, this may include a first Initial Payment that establishes their Subscription, or it may not.

' . "\n"; echo '

Modification Notifications are sent right after a Member signs up and/or modifies billing terms successfully through your Payment Gateway, regardless of whether any money has actually been transacted initially. In other words, this Notification is triggered, even if you provided them with a 100% Free Trial Period ( e.g. no money is being transacted intially ).

' . "\n"; echo '

This Notification will NOT be processed for Free Subscribers that register without going through your Payment Gateway at all. This Notification will NOT be processed for "new" Users/Members ( see: Signup Notifications for that scenario ).' . ((is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) ? '' : ' And, this Notification will NOT be processed for Independent Custom Capability purchases ( see: Payment Notifications for that scenario ).') . '

' . "\n"; echo '

Please note, this feature is not to be confused with the PayPal® IPN service. PayPal® IPN ( and other service integrations ) are already built into s2Member. They remain active at all times. These Modification Notifications are an added layer of functionality, and they are completely optional.

' . "\n"; do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_during_modification_notifications", get_defined_vars ()); /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo 'You can input multiple Notification URLs by inserting one per line.
' . "\n"; echo '
' . "\n"; echo 'Modification Notifications take place silently behind-the-scene, using an HTTP connection.

' . "\n"; echo 'You can also use these special Replacement Codes if you need them:' . "\n"; echo '
    ' . "\n"; echo '
  • %%subscr_id%% = The Paid Subscription ID, which remains constant throughout any & all future payments. [ ? ]
  • ' . "\n"; echo '
  • %%initial%% = The Initial Fee charged during signup. If you offered a 100% Free Trial, this will be 0. [ ? ]
  • ' . "\n"; echo '
  • %%regular%% = The Regular Amount of the Subscription. This value is always > 0, no matter what. [ ? ]
  • ' . "\n"; echo '
  • %%recurring%% = This is the amount that will be charged on a recurring basis, or 0 if non-recurring. [ ? ]
  • ' . "\n"; echo '
  • %%first_name%% = The First Name of the Customer who purchased the Membership Subscription.
  • ' . "\n"; echo '
  • %%last_name%% = The Last Name of the Customer who purchased the Membership Subscription.
  • ' . "\n"; echo '
  • %%full_name%% = The Full Name ( First & Last ) of the Customer who purchased the Membership Subscription.
  • ' . "\n"; echo '
  • %%payer_email%% = The Email Address of the Customer who purchased the Membership Subscription.
  • ' . "\n"; echo '
  • %%item_number%% = The Item Number ( colon separated level:custom_capabilities:fixed term ) for the Membership Subscription.
  • ' . "\n"; echo '
  • %%item_name%% = The Item Name ( as provided by the desc="" attribute in your Shortcode, which briefly describes the Item Number ).
  • ' . "\n"; echo '
  • %%initial_term%% = This is the term length of the Initial Period. This will be a numeric value, followed by a space, then a single letter. [ ? ]
  • ' . "\n"; echo '
  • %%regular_term%% = This is the term length of the Regular Period. This will be a numeric value, followed by a space, then a single letter. [ ? ]
  • ' . "\n"; echo '
  • %%user_first_name%% = The First Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_last_name%% = The Last Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_full_name%% = The Full Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_email%% = The Email Address associated with their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_login%% = The Username associated with their account. The Customer created this during registration.
  • ' . "\n"; echo '
  • %%user_ip%% = The Customer\'s original IP Address, during checkout/registration via $_SERVER["REMOTE_ADDR"].
  • ' . "\n"; echo '
  • %%user_id%% = A unique WordPress® User ID that references this account in the WordPress® database.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Registration/Profile Fields are also supported in this Notification:' . "\n"; echo '
    ' . "\n"; echo '
  • %%date_of_birth%% would be valid; if you have a Custom Registration/Profile Field with the ID date_of_birth.
  • ' . "\n"; echo '
  • %%street_address%% would be valid; if you have a Custom Registration/Profile Field with the ID street_address.
  • ' . "\n"; echo '
  • %%country%% would be valid; if you have a Custom Registration/Profile Field with the ID country.
  • ' . "\n"; echo '
  • %%etc, etc...%% see: s2Member -> General Options -> Registration/Profile Fields.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Replacement Codes can also be inserted using these instructions:' . "\n"; echo '
    ' . "\n"; echo '
  • %%cv0%% = The domain of your site, which is passed through the `custom` attribute in your Shortcode.
  • ' . "\n"; echo '
  • %%cv1%% = If you need to track additional custom variables, you can pipe delimit them into the `custom` attribute; inside your Shortcode, like this: custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|cv1|cv2|cv3". You can have an unlimited number of custom variables. Obviously, this is for advanced webmasters; but the functionality has been made available for those who need it.
  • ' . "\n"; echo '
' . "\n"; echo 'This example uses cv1 to record a special marketing campaign:
' . "\n"; echo '( The campaign ( i.e. christmas-promo ) could be referenced using %%cv1%% )
' . "\n"; echo 'custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|christmas-promo"' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '
' . "\n"; echo 'This is a semicolon ( ; ) delimited list of Recipients. Here is an example:
' . "\n"; echo '"John" <john@example.com>; admin@example.com; "Webmaster" <webmaster@example.com>' . "\n"; echo '
' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; } /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_cancellation_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_cancellation_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; echo '

Cancellation Notification URLs ( optional )

' . "\n"; echo '

If you use affiliate software, or have back-office routines that need to be notified whenever Subscriptions are cancelled through your Payment Gateway, you\'ll want to read this section. This is marked `Cancellation`, because the URLs that you list below, will be notified each time a Subscription is cancelled. A Cancellation is triggered when you cancel a Customer\'s Subscription through your Payment Gateway, or when a Customer cancels their own Subscription.

' . "\n"; echo '

Please note, this feature is not to be confused with the PayPal® IPN service. PayPal® IPN ( and other service integrations ) are already built into s2Member. They remain active at all times. These Cancellation Notifications are an added layer of functionality, and they are completely optional.

' . "\n"; echo '

*Understanding Cancellations* It\'s important to realize that a Cancellation is not an EOT ( End Of Term ). All that happens during a Cancellation event, is that billing is stopped, and it\'s understood that the Customer is going to lose access, at some point in the future. This does NOT mean, that access will be revoked immediately. A separate EOT event will automatically handle a (demotion or deletion) later, at the appropriate time; which could be several days, or even a year after the Cancellation took place.

' . "\n"; echo '

*Some Hairy Details* There might be times whenever you notice that a Member\'s Subscription has been cancelled through your Payment Gateway... but, s2Member continues allowing the User access to your site as a paid Member. Please don\'t be confused by this... in 99.9% of these cases, the reason for this is legitimate. s2Member will only remove the User\'s Membership privileges when an EOT ( End Of Term ) is processed, a refund occurs, a chargeback occurs, or when a cancellation occurs - which would later result in a delayed Auto-EOT by s2Member.

' . "\n"; echo '

s2Member will not process an EOT ( End Of Term ) until the User has completely used up the time they paid for. In other words, if a User signs up for a monthly Subscription on Jan 1st, and then cancels their Subscription on Jan 15th; technically, they should still be allowed to access the site for another 15 days, and then on Feb 1st, the time they paid for has completely elapsed. At that time, s2Member will remove their Membership privileges; by either demoting them to a Free Subscriber, or deleting their account from the system ( based on your configuration ). s2Member also calculates one extra day ( 24 hours ) into its equation, just to make sure access is not removed sooner than a Customer might expect.

' . "\n"; do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_during_cancellation_notifications", get_defined_vars ()); /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo 'You can input multiple Notification URLs by inserting one per line.
' . "\n"; echo '
' . "\n"; echo 'Cancellation Notifications take place silently behind-the-scene, using an HTTP connection.

' . "\n"; echo 'You can also use these special Replacement Codes if you need them:' . "\n"; echo '
    ' . "\n"; echo '
  • %%subscr_id%% = The Paid Subscription ID, which remained constant throughout the lifetime of the Membership. [ ? ]
  • ' . "\n"; echo '
  • %%item_number%% = The Item Number ( colon separated level:custom_capabilities:fixed term ) that the Subscription was for.
  • ' . "\n"; echo '
  • %%item_name%% = The Item Name ( as provided by the desc="" attribute in your Shortcode, which briefly describes the Item Number ).
  • ' . "\n"; echo '
  • %%user_first_name%% = The First Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_last_name%% = The Last Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_full_name%% = The Full Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_email%% = The Email Address associated with their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_login%% = The Username associated with their account. The Customer created this during registration.
  • ' . "\n"; echo '
  • %%user_ip%% = The Customer\'s original IP Address, during checkout/registration via $_SERVER["REMOTE_ADDR"].
  • ' . "\n"; echo '
  • %%user_id%% = A unique WordPress® User ID that references this account in the WordPress® database.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Registration/Profile Fields are also supported in this Notification:' . "\n"; echo '
    ' . "\n"; echo '
  • %%date_of_birth%% would be valid; if you have a Custom Registration/Profile Field with the ID date_of_birth.
  • ' . "\n"; echo '
  • %%street_address%% would be valid; if you have a Custom Registration/Profile Field with the ID street_address.
  • ' . "\n"; echo '
  • %%country%% would be valid; if you have a Custom Registration/Profile Field with the ID country.
  • ' . "\n"; echo '
  • %%etc, etc...%% see: s2Member -> General Options -> Registration/Profile Fields.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Replacement Codes can also be inserted using these instructions:' . "\n"; echo '
    ' . "\n"; echo '
  • %%cv0%% = The domain of your site, which is passed through the `custom` attribute in your Shortcode.
  • ' . "\n"; echo '
  • %%cv1%% = If you need to track additional custom variables, you can pipe delimit them into the `custom` attribute; inside your Shortcode, like this: custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|cv1|cv2|cv3". You can have an unlimited number of custom variables. Obviously, this is for advanced webmasters; but the functionality has been made available for those who need it.
  • ' . "\n"; echo '
' . "\n"; echo 'This example uses cv1 to record a special marketing campaign:
' . "\n"; echo '( The campaign ( i.e. christmas-promo ) could be referenced using %%cv1%% )
' . "\n"; echo 'custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|christmas-promo"' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '
' . "\n"; echo 'This is a semicolon ( ; ) delimited list of Recipients. Here is an example:
' . "\n"; echo '"John" <john@example.com>; admin@example.com; "Webmaster" <webmaster@example.com>' . "\n"; echo '
' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_after_cancellation_notifications", get_defined_vars ()); } /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_eot_deletion_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_eot_deletion_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; echo '

EOT/Deletion Notification URLs ( optional )

' . "\n"; echo '

If you use affiliate software, or have back-office routines that need to be notified whenever Subscriptions have ended ( and a Member is demoted to a Free Subscriber ), or when an account is deleted from the system, you\'ll want to read this section. This is marked `EOT/Deletion`, because the URLs that you list below, will be notified in both cases.

' . "\n"; echo '

EOT = End Of Term. An EOT is triggered immediately when you refund a Customer, when a Customer forces a chargeback to occur, or when a paid Subscription ends naturally ( i.e. expires ), and your Payment Gateway sends s2Member an EOT ( End Of Term ) response. Delayed EOTs occur after a Cancellation, either as a result of you cancelling a Customer\'s Subscription, or a Customer cancelling their own Subscription. A Cancellation usually results in a delayed EOT, because a Cancellation does NOT always warrant an immediate action; there could still be time left on their Subscription.

' . "\n"; echo '

Manual Deletions will trigger this Notification too. If you delete an account manually from within your WordPress® Dashboard, your URLs can be notified automatically through this API Notification, and this scenario can be detected through the Replacement Code %%eot_del_type%%, which is documented below. So the two events are an EOT ( of any kind ) and/or a Manual Deletion.

' . "\n"; echo '

Please note, this feature is not to be confused with the PayPal® IPN service. PayPal® IPN ( and other service integrations ) are already built into s2Member. They remain active at all times. These EOT/Deletion Notifications are an added layer of functionality, and they are completely optional.

' . "\n"; echo '

*Some Hairy Details* There might be times whenever you notice that a Member\'s Subscription has been cancelled through your Payment Gateway... but, s2Member continues allowing the User access to your site as a paid Member. Please don\'t be confused by this... in 99.9% of these cases, the reason for this is legitimate. s2Member will only remove the User\'s Membership privileges when an EOT ( End Of Term ) is processed, a refund occurs, a chargeback occurs, or when a cancellation occurs - which would later result in a delayed Auto-EOT by s2Member.

' . "\n"; echo '

s2Member will not process an EOT ( End Of Term ) until the User has completely used up the time they paid for. In other words, if a User signs up for a monthly Subscription on Jan 1st, and then cancels their Subscription on Jan 15th; technically, they should still be allowed to access the site for another 15 days, and then on Feb 1st, the time they paid for has completely elapsed. At that time, s2Member will remove their Membership privileges; by either demoting them to a Free Subscriber, or deleting their account from the system ( based on your configuration ). s2Member also calculates one extra day ( 24 hours ) into its equation, just to make sure access is not removed sooner than a Customer might expect.

' . "\n"; do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_during_eot_deletion_notifications", get_defined_vars ()); /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo 'You can input multiple Notification URLs by inserting one per line.
' . "\n"; echo '
' . "\n"; echo 'EOT/Deletion Notifications take place silently behind-the-scene, using an HTTP connection.

' . "\n"; echo 'You can also use these special Replacement Codes if you need them:' . "\n"; echo '
    ' . "\n"; echo '
  • %%eot_del_type%% = The type of event that triggered this Notification. [ list of possible values ]
  • ' . "\n"; echo '
  • %%subscr_id%% = The Paid Subscription ID, which remained constant throughout the lifetime of the Membership. [ ? ]
  • ' . "\n"; echo '
  • %%user_first_name%% = The First Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_last_name%% = The Last Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_full_name%% = The Full Name listed on their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_email%% = The Email Address associated with their User account. This might be different than what is on file with your Payment Gateway.
  • ' . "\n"; echo '
  • %%user_login%% = The Username associated with their account. The Customer created this during registration.
  • ' . "\n"; echo '
  • %%user_ip%% = The Customer\'s original IP Address, during checkout/registration via $_SERVER["REMOTE_ADDR"].
  • ' . "\n"; echo '
  • %%user_id%% = A unique WordPress® User ID that references this account in the WordPress® database.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Registration/Profile Fields are also supported in this Notification:' . "\n"; echo '
    ' . "\n"; echo '
  • %%date_of_birth%% would be valid; if you have a Custom Registration/Profile Field with the ID date_of_birth.
  • ' . "\n"; echo '
  • %%street_address%% would be valid; if you have a Custom Registration/Profile Field with the ID street_address.
  • ' . "\n"; echo '
  • %%country%% would be valid; if you have a Custom Registration/Profile Field with the ID country.
  • ' . "\n"; echo '
  • %%etc, etc...%% see: s2Member -> General Options -> Registration/Profile Fields.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Replacement Codes can also be inserted using these instructions:' . "\n"; echo '
    ' . "\n"; echo '
  • %%cv0%% = The domain of your site, which is passed through the `custom` attribute in your Shortcode.
  • ' . "\n"; echo '
  • %%cv1%% = If you need to track additional custom variables, you can pipe delimit them into the `custom` attribute; inside your Shortcode, like this: custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|cv1|cv2|cv3". You can have an unlimited number of custom variables. Obviously, this is for advanced webmasters; but the functionality has been made available for those who need it.
  • ' . "\n"; echo '
' . "\n"; echo 'This example uses cv1 to record a special marketing campaign:
' . "\n"; echo '( The campaign ( i.e. christmas-promo ) could be referenced using %%cv1%% )
' . "\n"; echo 'custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|christmas-promo"' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '
' . "\n"; echo 'This is a semicolon ( ; ) delimited list of Recipients. Here is an example:
' . "\n"; echo '"John" <john@example.com>; admin@example.com; "Webmaster" <webmaster@example.com>' . "\n"; echo '
' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_after_eot_deletion_notifications", get_defined_vars ()); } /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_refund_reversal_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_refund_reversal_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; echo '

Refund/Reversal Notification URLs ( optional )

' . "\n"; echo '

If you use affiliate software, or have back-office routines that need to be notified whenever Subscriptions have been refunded or reversed ( i.e. charged back to you ), you\'ll want to read this section. This is marked `Refund/Reversal`, because the URLs that you list below, will ONLY be notified in those specific cases, as opposed to EOT/Deletion Notifications, which are all-inclusive.

' . "\n"; echo '

This is very similar to the EOT/Deletion Notification described above. However, there is an important distinction. The all-inclusive EOT/Deletion Notification includes cancellations, expirations, failed payments, refunds, chargebacks, and even manual deletions by the Administrator from within the Dashboard. In other words, EOT/Deletion Notifications are processed ANY time a deletion or End Of Term action takes place. This API Notification, that is, Refund/Reversal Notifications, do NOT include all of those scenarios.

' . "\n"; echo '

So the distinction is that Refund/Reversal Notifications are ONLY sent under two specific circumstances: 1. You log into your Payment Gateway and refund a payment that is associated with a Subscription. 2. The Customer complains to your Payment Gateway and a chargeback occurs, forcing a Reversal. In both of these cases, an EOT/Deletion Notification will be sent ( as described in the previous section ), but since EOT/Deletion is a broader Notification, these Refund/Reversal Notifications are here so you can nail down specific back-office operations in these two specific scenarios.

' . "\n"; echo '

Please note, this feature is not to be confused with the PayPal® IPN service. PayPal® IPN ( and other service integrations ) are already built into s2Member. They remain active at all times. These Refund/Reversal Notifications are an added layer of functionality, and they are completely optional.

' . "\n"; do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_during_refund_reversal_notifications", get_defined_vars ()); /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo 'You can input multiple Notification URLs by inserting one per line.
' . "\n"; echo '
' . "\n"; echo 'Refund/Reversal Notifications take place silently behind-the-scene, using an HTTP connection.

' . "\n"; echo 'You can also use these special Replacement Codes if you need them:' . "\n"; echo '
    ' . "\n"; echo '
  • %%subscr_id%% = The Paid Subscription ID, which remained constant throughout the lifetime of the Membership. [ ? ]
  • ' . "\n"; echo '
  • %%parent_txn_id%% = The Parent Transaction ID, associated with the original payment being refunded/reversed.
  • ' . "\n"; echo '
  • %%-amount%% = The Negative Amount of the payment, that was refunded or reversed back to the Customer.
  • ' . "\n"; echo '
  • %%-fee%% = The Negative Payment Gateway fee, that was refunded back to you as the Merchant/Seller.
  • ' . "\n"; echo '
  • %%first_name%% = The First Name of the Customer who purchased the Membership Subscription.
  • ' . "\n"; echo '
  • %%last_name%% = The Last Name of the Customer who purchased the Membership Subscription.
  • ' . "\n"; echo '
  • %%full_name%% = The Full Name ( First & Last ) of the Customer who purchased the Membership Subscription.
  • ' . "\n"; echo '
  • %%payer_email%% = The Email Address of the Customer who purchased the Membership Subscription.
  • ' . "\n"; echo '
  • %%item_number%% = The Item Number ( colon separated level:custom_capabilities:fixed term ) that the payment was for.
  • ' . "\n"; echo '
  • %%item_name%% = The Item Name ( as provided by the desc="" attribute in your Shortcode, which briefly describes the Item Number ).
  • ' . "\n"; echo '
  • %%user_ip%% = The Customer\'s original IP Address, during checkout/registration via $_SERVER["REMOTE_ADDR"].
  • ' . "\n"; echo '
  • %%user_id%% = A unique WordPress® User ID that references this account in the WordPress® database.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Registration/Profile Fields are also supported in this Notification:' . "\n"; echo '
    ' . "\n"; echo '
  • %%date_of_birth%% would be valid; if you have a Custom Registration/Profile Field with the ID date_of_birth.
  • ' . "\n"; echo '
  • %%street_address%% would be valid; if you have a Custom Registration/Profile Field with the ID street_address.
  • ' . "\n"; echo '
  • %%country%% would be valid; if you have a Custom Registration/Profile Field with the ID country.
  • ' . "\n"; echo '
  • %%etc, etc...%% see: s2Member -> General Options -> Registration/Profile Fields.
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Replacement Codes can also be inserted using these instructions:' . "\n"; echo '
    ' . "\n"; echo '
  • %%cv0%% = The domain of your site, which is passed through the `custom` attribute in your Shortcode.
  • ' . "\n"; echo '
  • %%cv1%% = If you need to track additional custom variables, you can pipe delimit them into the `custom` attribute; inside your Shortcode, like this: custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|cv1|cv2|cv3". You can have an unlimited number of custom variables. Obviously, this is for advanced webmasters; but the functionality has been made available for those who need it.
  • ' . "\n"; echo '
' . "\n"; echo 'This example uses cv1 to record a special marketing campaign:
' . "\n"; echo '( The campaign ( i.e. christmas-promo ) could be referenced using %%cv1%% )
' . "\n"; echo 'custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|christmas-promo"' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '
' . "\n"; echo 'This is a semicolon ( ; ) delimited list of Recipients. Here is an example:
' . "\n"; echo '"John" <john@example.com>; admin@example.com; "Webmaster" <webmaster@example.com>' . "\n"; echo '
' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_after_refund_reversal_notifications", get_defined_vars ()); } /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_sp_sale_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_sp_sale_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; echo '

Specific Post/Page ~ Sale Notification URLs ( optional )

' . "\n"; echo '

If you use affiliate software, or have back-office routines that need to be notified whenever Specific Post/Page sales take place, you\'ll want to read this section. This is marked `Specific Post/Page`, because the URLs that you list below, will be notified each time a payment occurs, on a sale providing access to a Specific Post/Page.

' . "\n"; echo '

This is one of only two API Notifications that are sent for Specific Post/Page Access ( i.e. this one, and another below, for Refunds/Reversals ). All of the other API Notifications are designed for Membership Level Access' . ((is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) ? '' : ' and Independent Custom Capabilities') . '. None of the other API Notifications will ever be processed for Specific Post/Page Access. If you intend to respond to events related to Specific Post/Page Access, you MUST use one of the two API Notifications specifically geared to Post/Page Access.

' . "\n"; echo '

Please note, this feature is not to be confused with the PayPal® IPN service. PayPal® IPN ( and other service integrations ) are already built into s2Member. They remain active at all times. These Sale Notifications are an added layer of functionality, and they are completely optional.

' . "\n"; do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_during_sp_sale_notifications", get_defined_vars ()); /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo 'You can input multiple Notification URLs by inserting one per line.
' . "\n"; echo '
' . "\n"; echo 'Specific Post/Page ~ Sale Notifications take place silently behind-the-scene, using an HTTP connection.

' . "\n"; echo 'You can also use these special Replacement Codes if you need them:' . "\n"; echo '
    ' . "\n"; echo '
  • %%sp_access_url%% = The full URL ( generated by s2Member ) where the Customer can gain access.
  • ' . "\n"; echo '
  • %%sp_access_exp%% = Human readable expiration for %%sp_access_url%%. Ex: ( link expires in %%sp_access_exp%% ).
  • ' . "\n"; echo '
  • %%txn_id%% = The Paid Transaction ID. Payment Gateways assign a unique identifier for every purchase.
  • ' . "\n"; echo '
  • %%amount%% = The full Amount of the sale. Most affiliate programs calculate commissions from this.
  • ' . "\n"; echo '
  • %%first_name%% = The First Name of the Customer who purchased Specific Post/Page Access.
  • ' . "\n"; echo '
  • %%last_name%% = The Last Name of the Customer who purchased Specific Post/Page Access.
  • ' . "\n"; echo '
  • %%full_name%% = The Full Name ( First & Last ) of the Customer who purchased Specific Post/Page Access.
  • ' . "\n"; echo '
  • %%payer_email%% = The Email Address of the Customer who purchased Specific Post/Page Access.
  • ' . "\n"; echo '
  • %%user_ip%% = The Customers\'s IP Address, during checkout via $_SERVER["REMOTE_ADDR"].
  • ' . "\n"; echo '
  • %%item_number%% = The Item Number. Ex: sp:13,24,36:72 ( translates to: sp:comma-delimited IDs:expiration hours ).
  • ' . "\n"; echo '
  • %%item_name%% = The Item Name ( as provided by the desc="" attribute in your Shortcode, which briefly describes the Item Number ).
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Replacement Codes can also be inserted using these instructions:' . "\n"; echo '
    ' . "\n"; echo '
  • %%cv0%% = The domain of your site, which is passed through the `custom` attribute in your Shortcode.
  • ' . "\n"; echo '
  • %%cv1%% = If you need to track additional custom variables, you can pipe delimit them into the `custom` attribute; inside your Shortcode, like this: custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|cv1|cv2|cv3". You can have an unlimited number of custom variables. Obviously, this is for advanced webmasters; but the functionality has been made available for those who need it.
  • ' . "\n"; echo '
' . "\n"; echo 'This example uses cv1 to record a special marketing campaign:
' . "\n"; echo '( The campaign ( i.e. christmas-promo ) could be referenced using %%cv1%% )
' . "\n"; echo 'custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|christmas-promo"' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '
' . "\n"; echo 'This is a semicolon ( ; ) delimited list of Recipients. Here is an example:
' . "\n"; echo '"John" <john@example.com>; admin@example.com; "Webmaster" <webmaster@example.com>' . "\n"; echo '
' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_after_sp_sale_notifications", get_defined_vars ()); } /**/ if (apply_filters ("ws_plugin__s2member_during_api_ops_page_during_left_sections_display_sp_refund_reversal_notifications", true, get_defined_vars ())) { do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_before_sp_refund_reversal_notifications", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; echo '

Specific Post/Page ~ Refund/Reversal Notification URLs ( optional )

' . "\n"; echo '

If you use affiliate software, or have back-office routines that need to be notified whenever sales have been refunded or reversed ( i.e. charged back to you ), you\'ll want to read this section. This is marked `Specific Post/Page`, because the URLs that you list below, will be notified each time a Refund or Reversal occurs, on a sale that provided access to a Specific Post/Page.

' . "\n"; echo '

This is one of only two Notifications that are sent for Specific Post/Page Access ( i.e. this one, and another above, for Sales ). All of the other API Notifications are designed for Membership Level Access' . ((is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) ? '' : ' and Independent Custom Capabilities') . '. None of the other API Notifications will ever be processed for Specific Post/Page Access. If you intend to respond to events related to Specific Post/Page Access, you MUST use one of the two API Notifications specifically geared to Post/Page Access.

' . "\n"; echo '

Please note, this feature is not to be confused with the PayPal® IPN service. PayPal® IPN ( and other service integrations ) are already built into s2Member. They remain active at all times. These Refund/Reversal Notifications are an added layer of functionality, and they are completely optional.

' . "\n"; do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_during_sp_refund_reversal_notifications", get_defined_vars ()); /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo 'You can input multiple Notification URLs by inserting one per line.
' . "\n"; echo '
' . "\n"; echo 'Specific Post/Page ~ Refund/Reversal Notifications take place silently behind-the-scene, using an HTTP connection.

' . "\n"; echo 'You can also use these special Replacement Codes if you need them:' . "\n"; echo '
    ' . "\n"; echo '
  • %%parent_txn_id%% = The Parent Transaction ID, associated with the original payment being refunded/reversed.
  • ' . "\n"; echo '
  • %%-amount%% = The Negative Amount of the payment, that was refunded or reversed back to the Customer.
  • ' . "\n"; echo '
  • %%-fee%% = The Negative Payment Gateway fee, that was refunded back to you as the Merchant/Seller.
  • ' . "\n"; echo '
  • %%first_name%% = The First Name of the Customer who purchased access to a Specific Post/Page.
  • ' . "\n"; echo '
  • %%last_name%% = The Last Name of the Customer who purchased access to a Specific Post/Page.
  • ' . "\n"; echo '
  • %%full_name%% = The Full Name ( First & Last ) of the Customer who purchased access to a Specific Post/Page.
  • ' . "\n"; echo '
  • %%payer_email%% = The Email Address of the Customer who purchased access to a Specific Post/Page.
  • ' . "\n"; echo '
  • %%user_ip%% = The Customer\'s original IP Address, during checkout via $_SERVER["REMOTE_ADDR"].
  • ' . "\n"; echo '
  • %%item_number%% = The Item Number. Ex: sp:13,24,36:72 ( translates to: sp:comma-delimited IDs:expiration hours ).
  • ' . "\n"; echo '
  • %%item_name%% = The Item Name ( as provided by the desc="" attribute in your Shortcode, which briefly describes the Item Number ).
  • ' . "\n"; echo '
' . "\n"; /**/ echo 'Custom Replacement Codes can also be inserted using these instructions:' . "\n"; echo '
    ' . "\n"; echo '
  • %%cv0%% = The domain of your site, which is passed through the `custom` attribute in your Shortcode.
  • ' . "\n"; echo '
  • %%cv1%% = If you need to track additional custom variables, you can pipe delimit them into the `custom` attribute; inside your Shortcode, like this: custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|cv1|cv2|cv3". You can have an unlimited number of custom variables. Obviously, this is for advanced webmasters; but the functionality has been made available for those who need it.
  • ' . "\n"; echo '
' . "\n"; echo 'This example uses cv1 to record a special marketing campaign:
' . "\n"; echo '( The campaign ( i.e. christmas-promo ) could be referenced using %%cv1%% )
' . "\n"; echo 'custom="' . esc_html ($_SERVER["HTTP_HOST"]) . '|christmas-promo"' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; /**/ echo '' . "\n"; /**/ echo '' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '' . "\n"; echo '
' . "\n"; echo '
' . "\n"; echo 'This is a semicolon ( ; ) delimited list of Recipients. Here is an example:
' . "\n"; echo '"John" <john@example.com>; admin@example.com; "Webmaster" <webmaster@example.com>' . "\n"; echo '
' . "\n"; echo '
' . "\n"; /**/ echo '
' . "\n"; /**/ do_action ("ws_plugin__s2member_during_api_ops_page_during_left_sections_after_sp_refund_reversal_notifications", get_defined_vars ()); } /**/ do_action ("ws_plugin__s2member_during_api_ops_page_after_left_sections", get_defined_vars ()); /**/ echo '
' . "\n"; /**/ echo '

' . "\n"; /**/ echo '
' . "\n"; /**/ echo '
' . "\n"; c_ws_plugin__s2member_menu_pages_rs::display (); echo '
' . "\n"; /**/ echo '' . "\n"; } } } /**/ new c_ws_plugin__s2member_menu_page_api_ops (); ?>