Go to fastlink.themobilitybox.com and click on Sign-up / Login.

Click on Create NEW Link.

We recommend creating a Test link for implementation first.

With the Test link, you can pay and test the integration without any real cost

Select the products that should be available for your customers.

And click the "Update Products" Button to save your selection.

Go to Referrer Site

Click on "Create New APP"

1. First you should give your APP a Name

2. Afterwards maybe you want to set a Description for it

3. The next step is to set a URL. This should be the full URL of your ticket app, where users can import a Mobilitybox coupon into your app. For example: https://mobilitywallet.themobilitybox.com/mobility_wallet/add_coupons
4. We add the coupon IDs to this address in the `mobilitybox_coupon_ids` parameter. Looks then like this: https://mobilitywallet.themobilitybox.com/mobility_wallet/add_coupons?mobilitybox_coupon_ids=mobilitybox-coupon-1234567 Multiple coupon IDs will separate with a URI-encoded comma.

5. Finally, you can select a screenshot of your app to be displayed after the payment confirmation. And click "Submit".

Go to the referrer and click "Options"

Choose your created APP and click "Update Referrer"

Go to fastlink.themobilitybox.com/referrers and select your Referrer

Click on "Options" and check the checkbox for "Disable Email Notifications".

Finally, click "Update Referrer" to save your changes.

You can redirect the Customer directly to your Checkout Page or Product Page.

Checkout Page

You can redirect the customer directly to your checkout or product page.

There are the following URL Parameters.

• mobilitybox_product_ids[] - It's a URL array where you can set multiple Mobilitybox Product IDs
• view - Set it to "fullscreen" if you don't want the header
• order_reference - Your individual order reference, which is also present in your custom app URL. Maximum of 256 characters
• skip_successor_selection - Set this to "true" to skip the successor page, such as for Deutschlandticket price changes.

Example: https://fastlink.themobilitybox.com/TEST-123456/checkout?mobilitybox_product_ids[]=mobilitybox-product-uuid&mobilitybox_product_ids[]=mobilitybox-product-uuid2&order_reference=test1234&view=fullscreen&skip_successor_selection=true

Product Page

Redirect to your product page with your Referrer Code.

Example: https://fastlink.themobilitybox.com/TEST-123456

Once the payment has been successfully processed, your customer will be automatically redirected to your website or application.

The redirect URL has the following parameters that you need to save:

• mobilitybox_coupon_ids - multiple Mobilitybox Coupon IDs from the customer order
• mobilitybox_order_id - the Mobilitybox Order ID
• order_reference - your order reference if you set one before
• mobilitybox_restore_secret - the restore secret if you want to restore the tickets

On this page, customers can cancel their subscriptions or change their payment method.

Redirect to the subscription Manage Page with the Mobilitybox Subscription ID.

You can get this ID by making a GET request on the Coupon API.

There are the following URL Parameters:

• mobilitybox_subscription_ids[] - It's a URL array where you can set multiple Mobilitybox Subscription IDs
• view - Set it to "fullscreen" if you don't want the Header

Example: https://fastlink.themobilitybox.com/subscriptions/manage?mobilitybox_subscription_ids[]=mobilitybox-subscription-uuid&mobilitybox_subscription_ids[]=mobilitybox-subscription-uuid2&view=fullscreen

On this page, customers can restore their coupons or tickets.

Redirect to the restore Page with the Mobilitybox Restore Secret.

There are the following URL Parameters:

• mobilitybox_restore_secrets[] - It's a URL array where you can set multiple Mobilitybox Restore Secret IDs
• view - Set it to "fullscreen" if you don't want the Header

Example: https://fastlink.themobilitybox.com/restore?mobilitybox_restore_secrets[]=mobilitybox-restore-secret-uuid&mobilitybox_restore_secrets[]=mobilitybox-restore-secret-uuid2&view=fullscreen