Preliminary Remarks
A Cross-Client-Connection between clients in different contracting companies makes it possible to market offers to a broader range of clients. The following requirements and settings must generally be made for this function:
The Cross-Client-Connection contract module must be activated in both contracting companies.
The source client must create a connection to the target client.
The source client must set a callback in order to be informed about the purchase of their offer and to be able to link the corresponding customer and the subscription in their Merchant Backend.
The source client must create a cross-client offer.
The target client must create a shopping cart with a) its own offer and b) the cross-client offer of the source client.
Create a connection
To create a connection, open the menu item Applications > Cross-Client-Connections in the corresponding client of the source company and proceed as follows:
Click on +Add Client Connection.
Enter Target company ID*. This is the part of the Frisbii Media URL.
The checkbox Access to offers must be activated so that the target company has access to the cross-client offer.
Callback Settings must be made (at least store the URL of the web service) so that the source company is informed when an offer has been purchased and can assign the offer to the customer in the Merchant Backend accordingly.
After the saving process, an invitation e-mail is automatically sent to the specified target client. As soon as the target client has accepted the invitation, the connection is established.
The source client must now create a cross-client offer. >> Create and use cross-client offer The target client can now create a shopping cart with their own offer and the cross-client offer. >> Shopping cart for cross-client
Callbacks
Since the clients in the connected contracting companies do not share the same customer base as is the case with a Cross-Client-Connection between two clients within a contracting company, the contracting companies must communicate with each other so that the source client can link the customer and the purchased offer. The procedure using the callback is as follows:
The customer purchases the cross-client offer (source client) within the shopping cart.
As soon as the purchase has been completed, a callback is triggered which is sent to the stored URL. The callback transmits the customer number (customer data) and a "voucher code".
Via the API endpoint subscriptions/useCrossClientVoucher the "voucher code" must now be redeemed in order to link the customer to the subscription.
After successful linking, the customer and the subscription can be viewed in the Merchant Backend in the menu item Customers in the corresponding customer account.
The callback can also be viewed in the Callback Log.
Example of a cross-client callback:
{
"entityType": "CROSS_CLIENT_ORDER",
"callbackType": "CREATION",
"entityId": "1235029",
"entity": {
"accessBlocked": false,
"accountingPeriod": 1,
"accountingPeriodTimeSpan": "MONTH",
"activePartners": null,
"analogInvoice": false,
"cancellationDate": null,
"cancellationPeriod": 1,
"cancellationPeriodTimeSpan": "WEEK",
"cancellationReasonUniqueId": "",
"cancellationType": "TIME_BASED",
"chainId": 1238141,
"changedBy": "2410081407088",
"changedByType": "CUSTOMER",
"changedDate": "2025-03-26T08:21:06.632241Z",
"chargeableDeliveries": 0,
"connectedOffer": true,
"connectedOfferInfo": {
"companyId": "2JAUMG2VE074VI9PL4L2",
"contractCompanyId": "T_AXTWKEYGRM6QIUWXIV",
"Frisbii MediaOfferId": "O_06Q8VJGJK2RGABECU4"
},
"createdBy": "2410081407088",
"createdByType": "CUSTOMER",
"createdDate": "2025-03-26T08:21:06.632241Z",
"currency": "EUR",
"customerCancellationBlocked": false,
"customerCancellationReasonId": 0,
"deliveries": 0,
"deliveryAddressId": 1233699,
"deliveryCustomerId": "2410081407088",
"deliveryPaused": null,
"durationPeriod": 0,
"durationPeriodTimeSpan": "MONTH",
"email": "test.user@frisbii.com",
"endDate": null,
"externalBilling": false,
"externalSystemId": "",
"finishedDeliveries": 0,
"firstBookingDate": "2025-03-26T08:21:06.468579Z",
"invoiceAddressId": 0,
"invoiceCustomerId": "2410081407088",
"items": [
{
"accessRightUniqueId": "pur",
"chainItemId": 1240830,
"changedBy": "2410081407088",
"changedByType": "CUSTOMER",
"changedDate": "2025-03-26T08:21:06.632241Z",
"connectedOfferInfo": {
"companyId": "2JAUMG2VE074VI9PL4L2",
"contractCompanyId": "T_AXTWKEYGRM6QIUWXIV",
"Frisbii MediaProductId": "P_1N2FWAEJ8TU1AIK0XA",
"Frisbii MediaStepId": "S_WNZ1FFKAUC4IS0UTIF",
"priceIssueId": 100005,
"productId": "P_1N2FWAEJ8TU1AIK0XA"
},
"corporateAccountId": 0,
"costCenter": "",
"createdBy": "2410081407088",
"createdByType": "CUSTOMER",
"createdDate": "2025-03-26T08:21:06.632241Z",
"creditCount": 0,
"creditWalletUniqueId": "",
"discountPercentage": 0,
"internalTitle": "product 1",
"multiuserSettings": null,
"packageCancellationLocked": false,
"packageId": "",
"packageTitle": "",
"Frisbii MediaProductId": "C_1N2FWAEJ8TU1AIK0XA",
"Frisbii MediaStepId": "C_WNZ1FFKAUC4IS0UTIF",
"price": 6.99,
"priceIssueId": 0,
"productId": "C_1N2FWAEJ8TU1AIK0XA",
"purchaseNumber": "",
"quantity": 1,
"status": "ACTIVE",
"subscriptionItemId": 1240830,
"taxType": "DIGITALPRODUCT",
"title": "Time Based Subscription (single step - one product)"
}
],
"lastBookingDate": "2025-03-26T08:21:06.468579Z",
"managedBy": "Frisbii Media",
"managedExternal": false,
"multiuserSettings": null,
"nextBookingDate": "2025-04-26T00:00:00Z",
"openDeliveries": 0,
"paused": null,
"paymentMethod": "PAYPAL",
"paymentMethodId": 1230032,
"paymentPaused": null,
"paymentTriesDone": 0,
"Frisbii MediaOfferId": "C_06Q8VJGJK2RGABECU4",
"precursorId": 0,
"precursorReason": "",
"precursorReasonDetail": "",
"purchaseOrderIndicator": "",
"recurringDeliveries": false,
"referenceStartDate": "2025-03-26T00:00:00Z",
"startDate": "2025-03-26T08:21:06.468556Z",
"status": "ACTIVE",
"subscriptionId": 1238141,
"subscriptionType": "CROSS_COMPANY_TIME_BASED",
"successorId": 0,
"successorReason": "",
"successorReasonDetail": "",
"suppressInvoiceSending": false,
"term": 1,
"termTimeSpan": "MONTH",
"voucherCode": "IG7W-SWSS-FXNQ"
}
}