Custom Offer link

The custom offer link is used to specify the amount to be charged to the end-user on the fly, in other words, be able to create a custom offer and present it to the end-user when using the Vendo hosted payment page.

URL
The base URL for the custom offer link is:

https://secure.vend-o.com/v/custom-offer?

You can customize the link by adding parameters to it.

Parameter	Type	Mandatory	Description
site	integer	yes	Your site ID, assigned by Vendo. Example: 2
type	string	yes	Types available: normal or oneclick
subscription	integer	no	Vendo Subscription ID. Unique ID of the user’s existing subscription for which the one-click offer is presented. Mandatory if the type is oneclick
billing_schedule_type	string	yes	Types available: trial, membership, lifetime, or token
initial_amount	float	no	USD amount of the initial price point. Mandatory if the billing_schedule_type is trial or lifetime Example: 2.95
initial_duration	integer	no	Duration in days of the initial period. Example: 3 Mandatory if the billing_schedule_type is trial
rebill_amount	float	no	USD amount of the recurring rebills. Example: 29.95 Mandatory if the billing_schedule_type is trial
rebill_duration	integer	no	Duration in days between recurring rebills. Example: 30 Note that 30 days equals one month. Mandatory if the billing_schedule_type is trial
token_amount	float	no	USD amount of the token price. Example: 29.95 Mandatory if the billing_schedule_type is a token
token_quantity	integer	no	Total quantity of tokens. Use 1 to create a one-time payment without any token reference. Example: 30 Mandatory if the billing_schedule_type is a token
billing_currency	string	no	This parameter allows you to force and block the display and billing currency shown to the end-user. USD, EUR, and GBP are the only supported values. 3-letter ISO 4217 format
signature	string	yes	The Query Signature. For more information, see Query signature.

🚧
Important
If you are creating a normal offer you can also use all available params on the Standard join links
If you are creating a oneclick offer you should also use all available params on the One-clicks
Any offer parameter will be replaced with the new one generated.

Example for a normal offer type
To display a 3-day trial for 2.95$ that will rebill a 30$ every 30 days on site 20:

https://secure.vend-o.com/v/custom-offer?site=20&type=normal&billing_schedule_type=trial&initial_amount=2.95&initial_duration=3&rebill_amount=30&rebill_duration=30&signature=yourValidSignature

Example for a oneclick offer type
To create a one-click custom offer for an existing subscription (ID 12345678) with a 3-day trial at $2.95 and a $30 rebill every 30 days on site 20, include the subscription parameter and set type=oneclick:

https://secure.vend-o.com/v/custom-offer?site=20&type=oneclick&subscription=12345678&billing_schedule_type=trial&initial_amount=2.95&initial_duration=3&rebill_amount=30&rebill_duration=30&signature=yourValidSignature

Parameter examples for each billing_schedule_type offer type

billing_schedule_type=token
token_amount=4.95
token_quantity=1
      
Offer disclosure:      
You will pay $4.95 to [SITE].

billing_schedule_type=trial
initial_amount=1.95
initial_duration=2
rebill_amount=19.95
rebill_duration=30

Offer disclosure:
You will gain access to [SITE] for $1.95 for 2 days.
If not cancelled within the trial period you will be charged $19.95 every month until you cancel.

billing_schedule_type=membership
rebill_amount=6.75
rebill_duration=30
      
Offer disclosure:      
You will gain access to [SITE] for $6.75 every 30 days until cancelled.

billing_schedule_type=membership
initial_amount=6.75
initial_duration=30
      
Offer disclosure:      
You will gain access to [SITE] for $6.75 for 30 days.

billing_schedule_type=membership
initial_amount=4.95
initial_duration=30
rebill_amount=9.95
rebill_duration=30
      
Offer disclosure:      
You will gain access to [SITE] for $4.95 for 1 month then $9.95 every month until cancelled.

billing_schedule_type=token
token_amount=4.95
token_quantity=10
      
Offer disclosure:      
You will pay $4.95 to [SITE] for 10 tokens.

billing_schedule_type=lifetime
initial_amount=49.95
      
Offer disclosure:     
You will gain lifetime access to [SITE] for $49.95.