merchant_guide:notifications_list_callbackurl
no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
Previous revision | |||
— | merchant_guide:notifications_list_callbackurl [2012/06/07 00:51] (current) – [1. Thank You] matt | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Notifications: | ||
+ | ===== Overview ===== | ||
+ | |||
+ | This is a list of events that are posted to the **Callback URL** defined in the [[merchant_guide: | ||
+ | |||
+ | |||
+ | ===== Using Events ===== | ||
+ | |||
+ | Events are posted in a universal XML standard formatting. | ||
+ | |||
+ | ===== Event Messages ===== | ||
+ | |||
+ | All event messages contain the same basic information: | ||
+ | |||
+ | * GUID: This is the unique subscription identifier returned in the [[: | ||
+ | * Event_Code: This is a string that tells the application what event has just occurred. | ||
+ | |||
+ | A typical event message will appear as follows: | ||
+ | |||
+ | * Sample XML: < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Events/ Event Codes ===== | ||
+ | |||
+ | ==== 1. Thank You ==== | ||
+ | |||
+ | * Scenario: customer signs up for new product/ | ||
+ | * Event Codes: | ||
+ | * **sb_n_1a** - Sent to Customer: Trial Exists Message ([[http:// | ||
+ | * **sb_n_1b** - Sent to Customer: No Trial Message | ||
+ | * **sb_n_1c** - Sent to Merchant: Notification of new subscription created | ||
+ | * **sb_n_1d** - Sent to Merchant: Notification of new subscription created, in which first payment is a Trial or different from regular amount. | ||
+ | |||
+ | |||
+ | ==== 2. Trial To Expire ==== | ||
+ | |||
+ | * Scenario: new subscription included a trial period, which is about to expire. The trial may or may not have been free (could have been just a reduced rate), but in any case there is a change in the subscription amount or in the terms of the subscription. | ||
+ | * Event Codes: | ||
+ | * **sb_n_2a** - Sent to Customer: alert message: "N days to go" | ||
+ | * **sb_n_2b** - Sent to Customer: final alert message: "M days to go" ([[http:// | ||
+ | |||
+ | ... where the number of days (" | ||
+ | ==== 3. Subscription Status Switched ==== | ||
+ | |||
+ | * Scenario: new subscription included a trial period, and the trial is stopped before it was scheduled to end. The trial may be stopped directly by the customer (e.g. via the SubscriptionBridge Customer Center) or by the merchant (e.g. customer calls in or sends an email asking for the subscription to be switched to full mode). | ||
+ | * Event Codes: | ||
+ | * **sb_n_3a** - Sent to Customer: confirmation of subscription updated from " | ||
+ | * **sb_n_3b** - Sent to Merchant: notification of change in subscription status | ||
+ | |||
+ | ==== 4. Transaction Successful ==== | ||
+ | |||
+ | * Scenario: Regular subscription payment, charged successfully. This is not a payment receipt, since SubscriptionBridge is not the payment processor. A separate payment receipt might be sent directly by the payment gateway. This notification is instead a " | ||
+ | * Event Codes: | ||
+ | * **sb_n_4a** - Sent to Customer: subscription statement following successful payment | ||
+ | * **sb_n_4b** - Sent to Customer: final subscription statement following last payment occurrence (limited time subscription) | ||
+ | * **sb_n_4c** - Sent to Merchant: notification of successful payment | ||
+ | |||
+ | ==== 5. Transaction NOT Successful ==== | ||
+ | |||
+ | * Scenario: Regular subscription payment that does not go through successfully. A separate " | ||
+ | * Event Codes: | ||
+ | * **sb_n_5a** - Sent to Customer: Payment NOT OK -> Action to take | ||
+ | * **sb_n_5b** - Sent to Merchant: notification of unsuccessful payment | ||
+ | |||
+ | ==== 6. Subscription Balance Paid ==== | ||
+ | |||
+ | * Scenario: one or more subscription payments did not go through successfully. Therefore, there was an outstanding balance on the account, which the customer has now paid (e.g. through the SubscriptionBridge Customer Center). There is no notification for unsuccessful payment because the notification is in real time, on the payment page, since this is not an automatic payment. | ||
+ | * Event Codes: | ||
+ | * **sb_n_6a** - Sent to Customer: "Thank You" message for Balance Paid. Subscription Account Statement. | ||
+ | * **sb_n_6b** - Send to Merchant: notification of successful customer payment against outstanding balance | ||
+ | |||
+ | ==== 7. Subscription Balance Unpaid ==== | ||
+ | |||
+ | * Scenario: one or more subscription payments did not go through successfully. Therefore, there is an outstanding balance on the account. The customer has not paid the balance and a certain number of days have passed (where " | ||
+ | * Event Codes: | ||
+ | * **sb_n_7a** - Sent to Customer: P days have passed since unsuccessful payment | ||
+ | * **sb_n_7b** - Sent to Customer: Q days have passed since unsuccessful payment, final notice | ||
+ | * **sb_n_7c** - Sent to Merchant: notification of the 7a | ||
+ | * **sb_n_7d** - Sent to Merchant: notification of the 7b | ||
+ | * **sb_n_7e** - Sent to Customer: R days have passed since unsuccessful payment, action taken | ||
+ | * **sb_n_7f** - Sent to Merchant: notification of action taken in 7.e | ||
+ | |||
+ | ==== 8. Subscription Canceled ==== | ||
+ | |||
+ | * Scenario: the subscription has been canceled. There are different reasons for it, which lead to different notifications. | ||
+ | * Event Codes: | ||
+ | * **sb_n_8a** - Sent to Customer: confirmation of subscription cancellation (customer canceled the subscription) | ||
+ | * **sb_n_8b** - Sent to Customer: subscription canceled for non-payment: | ||
+ | * **sb_n_8c** - Sent to Customer: confirmation of subscription cancellation (merchant canceled the subscription: | ||
+ | * **sb_n_8d** - Sent to Merchant: notification of subscription cancellation (sent in scenario 8.a & 8.b, not needed for 8.c since the cancellation was triggered by the merchant) | ||
+ | |||
+ | ==== 9. Subscription Changed ==== | ||
+ | |||
+ | * Scenario: the customer upgraded (different Packages sharing the same Plan), downgraded, added Feature(s), removed Feature(s). | ||
+ | * Event Codes: | ||
+ | * **sb_n_9a** - Sent to Customer: confirmation of change of Package | ||
+ | * **sb_n_9b** - Sent to Customer: confirmation of change of Features | ||
+ | * **sb_n_9c** - Sent to Merchant: notification of change of Package | ||
+ | * **sb_n_9d** - Sent to Merchant: notification of change of Features | ||
+ | |||
+ | |||
+ | |||
+ | ==== 10. New Balance ==== | ||
+ | |||
+ | * Scenario: Merchant **adds a feature** on behalf of the customer, and there is a balance due for the current billing period (pro-rated amount), or makes a **Custom Subscription Change** that is associated with a balance due for the current billing period. | ||
+ | * Event Codes: | ||
+ | * **sb_n_10a** - Sent to Customer: Notification of New Balance | ||
+ | |||
+ | ==== 11. Credit Card Expiring ==== | ||
+ | |||
+ | * Scenario: The system detects that the credit card expiration date is before the next payment date. | ||
+ | * Event Codes: | ||
+ | * **sb_n_11a** - Sent to Customer: Notification of expiring credit card | ||
+ | * **sb_n_11b** - Sent to Customer: Notification credit card has expired | ||
+ | |||
+ | ===== Related articles ===== | ||
+ | * [[merchant_guide: | ||
+ | * [[merchant_guide: | ||
+ | * [[developer_guide: |
merchant_guide/notifications_list_callbackurl.txt · Last modified: 2012/06/07 00:51 by matt