Manage Agreements

Before you can work with agreements, a partnership must exist between you and the Reseller (Service Provider). The Reseller must create the agreement and send it to you for approval. An agreement is a contract between a Reseller (Service Provider) and a Merchant. In the Platform-managed product lifecycle, an agreement represents the Merchant’s authorization for the Reseller to market and resell their products. The Reseller sets up their products and offers on the storefront based on the approved agreement. In the Merchant-managed product lifecycle, an agreement represents the Reseller’s authorization for the Merchant to use their billing as a payment method for customers. What You Can Do in the Agreements Space You can perform the following actions:

Receive and view agreements
Approve an agreement
Reject an agreement
Cancel an agreement if it doesn’t have any active subscriptions

Agreement Setup Options

Go to the Agreements space. To view an agreement, filter for the relevant agreement by typing keywords and by selecting a Status from the dropdown list. As you provide the filter details, a list of the relevant results appears dynamically. Select the specific agreement from the results list. The Agreement page appears. Select what you’d like to do from the following options:
- To approve or reject an agreement, select Approve or Reject. The page refreshes. If you approved the agreement, it is now active. If you rejected the agreement, it is now inactive.
- To cancel the agreement, click the three dot menu next to the agreement status. The option menu appears. Select Cancel Agreement. A pop-up appears to confirm the cancellation. Select Cancel Agreement. Note: An agreement can only be canceled if the agreement doesn’t have any active subscriptions. Any active subscriptions must be canceled first. The page refreshes. The agreement has been canceled.

Parent topic:Agreements

Agreement Field Details

General Information

Field Name	Guidance	Required or Optional
Name	Enter a name for the agreement. The name can contain any of the following characters:- a-z, A-Z - 0-9 - !@#$%^&*-()/ - spaces The name length is limited to 255 characters.	Required
Description	Enter a description of the agreement. The description can contain any of the following characters:- a-z, A-Z - 0-9 - !@#$%^&*-()/ - spaces	Optional
Agreement Code	Enter a code to associate with the agreement. The code can contain any of the following characters:- a-z, A-Z - 0-9 Note: The code can’t contain spaces. The code can be up to 15 characters in length. The code cannot be changed after a Merchant approves the agreement.
Merchant	Select a Merchant from the dropdown list. The dropdown list shows Merchants with whom your organization has active partnerships.	Required
Product Lifecycle	Select a product lifecycle from the list. The product lifecycle can be one of the following:- Platform Managed - Merchant Managed Selecting a product lifecycle filters the products that you can see in the Product list.	Required
Entitlement Type	An entitlement type designates the subscription(s) the customer can purchase. The Merchant selects an entitlement type for each product group. The entitlement type can be one of the following:- Standard: customers are buying a single entitlement to the Merchant’s product. - Quantity (Platform-managed only): this type enables purchasing a number (quantity) for the product subscription entitlement. During product provisioning for the customer, you must provide a quantity (for example, license seats).	Required
Target Market	A target market is the industry in which you’d like to sell your products and services. Select a target market from the list to filter the Merchant’s products:- Business: this is a business selling to other businesses, such as a small-to-medium business (SMB) or an enterprise (large business). This is also known as B2B. - Consumer: this is a business selling to individual end customers. This is also known as B2C.	Required
Select Product	Select the product or service to which the agreement applies. The dropdown lists shows a list of available products.	Required
Customer Attributes Allowlist	The Customer Attributes Allowlist link appears if the Merchant has defined any required or optional customer attributes for you to provide the values during activation. Select the attributes you’d like to store during the provisioning process and then select Save.	Optional

Settlement Model (Optional)

Model	Guidance	Required or Optional
Enable Settlement Model	Turn the toggle on to enable a settlement model. A settlement model calculates settlements for the agreement based on the Settlement Type.	Optional
Entitlement Type	An entitlement type designates the subscription(s) the customer can purchase. The entitlement type can be one of the following:- Standard: customers are buying a single entitlement to the Merchant’s product. - Quantity (Platform-managed only): this type enables purchasing a number (quantity) for the product subscription entitlement. For this type, you can specify the amount per active subscription in the Amount field.	Required
Settlement Type	Select the type of settlement to apply to the agreement, which can be one of the following:- Revenue share: The revenue share is a percentage the Merchant receives from settlements. The percentage comes from splitting the charge amount between the Merchant and Reseller (Service Provider). The charge amount is how much the customer pays for the product, which is sent to Partner Ecosystem Management. A charge file needs to be uploaded to process revenue share settlements for Platform-managed products. Note: You can also set a minimum price for a Merchant’s product. This value will be used to calculate revenue share settlements when no charge amount is available for the entitlement or the actual price is lower than the minimum price. - Flat fee: The fixed amount owed to the Merchant. For Platform-managed subscriptions, the amount is for each active subscription entitlement. For Merchant-managed subscriptions, the amount is for each transaction received.	Required
Merchant Share (only applies to revenue share settlements)	The revenue share is based on the charge amount provided to Partner Ecosystem Management. Enter the percentage of the revenue share the Merchant should receive from settlements. Resellers (Service Providers) will receive the remainder. The value you enter can contain any of the following characters: - 0-9	Required
Minimum Price (only applies to revenue share settlements)	Set a minimum price for a Merchant’s product. This value will be used to calculate revenue share settlements when no product price is available or the actual price is lower than the minimum price. Enter a value with up to two decimal places. For example: 9.20. The currency symbol isn’t supported. Currency is determined between the Merchant and Reseller (Service Provider) outside the platform and depends on how the product is intended to be sold.	Optional
Amount (only applies to flat fee settlements)	Enter the amount of the flat fee. The flat fee is a fixed amount charged for each active subscription. The flat fee you enter can contain any of the following characters:- 0-9 - . (a decimal - for example, 10.90)	Required
Parent topic:Manage Agreements

Home

Introduction

For Merchants

For Resellers

Partner Ecosystem Management

Commerce Engine

Storefront Experience

APIs

Agreement Field Details

General Information

Settlement Model (Optional)

​Agreement Field Details

​General Information

​Settlement Model (Optional)

Agreement Field Details

General Information

Settlement Model (Optional)