Initial Setup

SubscriptionJS Hosting

SubscriptionJS is hosted separately from the billwerk application. You can access it at the following locations:

For all your integration development, make use of the Sandbox. If you don't have an account yet, please get in touch with our support team for a free sandbox account or create it here. Once you've signed up and are ready for testing, you can begin the integration by loading SubscriptionJS as shown below:

<script type="text/javascript" src="https://selfservice.sandbox.billwerk.com/subscription.js"></script> 

For payment processes, you'll also need to pass a public API key:

paymentService = new SubscriptionJS.Payment({ publicApiKey : "527cc4c951f45909c493c820" }...

You can find this key within the self-service settings of your billwerk Admin UI.

🚧

Important! The billwerk Sandbox closely mirrors the Live System. This means you should exercise caution with your test data. Emails will be sent out, and real payments can be initiated for some PSPs. Ensure you use email addresses you control and configure your PSPs to simulate payments only.