Developer Docs

Developer Docs

  • Getting Started
  • SubscriptionJS
  • REST API
  • Webhooks
  • Code Samples
  • UseCases
  • Request a Demo

›Methods

SubscriptionJS

  • Overview
  • Initial Setup
  • Signup
  • Portal
  • Payments
  • Coupons
  • Synchronization
  • Going Live

Reference

    Methods

    • Payment
    • Signup
    • Portal
    • General
  • Types
  • Callbacks

Embeddable Elements

  • Available Elements
  • Payment Form IFrame

    • Introduction
    • Configuration
    • Appearance
    • Reference

General

  • SubscriptionJS.finalize(success, error)
  • SubscriptionJS.createElement(embeddableElement, embedInElement, config, style, error)

SubscriptionJS.finalize(success, error)

For interactive PSPs like PayPal this needs to be executed on the return page the PSP redirects to after finishing a payment. It triggers finalizing the order in billwerk. The success and error callback can be used to inform the customer if the order succeeded or not.

Please note that you must never rely on the finalize page is ever called during the order process, e.g. a customer could close the browser after successful payment or something else happens. Always use our webhooks to be notified a subscription was successful.


SubscriptionJS.createElement(embeddableElement, embedInElement, config, style, error)

SubscriptionJS offers createElement to let you use different embeddable elements, like our paymentForm iframe. A separated documentation can be found here.

PropertyTypeDescription
embeddableElementstringDescribes which element will be embedded. Currently we support only paymentForm
embedInElementDOM ElementDescribes in which DOM element the embeddableElement will be embedded.
configobjectConfiguration object, consists of your public API key, payment methods, locale and Return URL, a more detailed description is found here
styleobjectStyle object, which lets you control different properties used in the embeddable element, a more detailed description is found here
Last updated on 10/17/2019 by AxelDuenninger
← PortalTypes →
Docs
Getting StartedAPI Reference
Resource
Help CenterSupportBlogTutorials
Start with billwerk
Test for free
Request a Demo
Already started?
billwerk Sandboxbillwerk Production
billwerk GmbH
© Made with ❤ in Germany for Europe by billwerk GmbH | 2022
Imprint
|
Data Privacy Rules
|
Disclaimer