Webhooks and Recurring Payments

The specified URL will be called from the e-payment platform via a POST request with the following POST parameters (x-www-form-urlencoded):

• epp_transaction_id (except for subscription_canceled_webhook)
• amount
• payment_method
• stored_customer_email
• interval (it is important to note here that the interval starts with a leading 01 00, e.g. 01 00 L * *, which means that it will be executed 1 minute after midnight)
• currency
• language
• subscription_token
• masked_cc
• charges_count (only for subscription_charged_webhook)

All stored_customer_* parameters are also returned (e.g. stored_customer_lastname, stored_customer_firstname) In order to create a customer subscription overview page which allows a customer to cancel or update a recurring payment subscription, you have to retrieve the subscription information via the e-payment service https://api.raisenow.com/epayment/api/subscription/info/{merchantConfig}/{subscriptionToken}/ or use the function getRecurrentPaymentSubscriptionInfo from the EPIK tool. As identifier you have to use the subscription_token. Both returns a JSON object containing the following information:

• masked_cc
• interval (note that the interval starts with a leading 01 00, e.g. 01 00 L * *)
• customer_token
• status (active|inactive)
• success_url
• cancel_url
• error_url
• payment_method (e.g. vis for Visa)
• test_mode
• currency
• amount
• language
• mobile_mode
• stored_country (deprecated: should be part of customer object)
• payment_provider
• expm; expiry month
• expy; expiry year (2-digit number, e.g. 13)
• customer, which contains a JSON string (is deprecated: use JSON object with key customer_obj)
• customer_obj, which is a JSON object containing all information about the subscriber.

On the subscription overview page you also have to offer services to cancel and renew a subscription for a user: To cancel a subscription you can either call the web service https://api.raisenow.com/epayment/api/subscription/cancel/{merchantConfig}/{subscriptionToken}/ or use the function cancelRecurrentPaymentSubscription. To renew a subscription you have to add the subscription token to your donation form as hidden input field with attribute name subscription_token. The following figure shows an example of a subscription overview page