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