Standard Join link

The standard join link may send users to either a one-step or a multi-step join process. Users make the initial membership payment through the standard join link and agrees to be automatically charged periodically for continued membership.

Base URL

https://secure.vend-o.com/v/signup?

🚧

Important

Your site ID is a mandatory parameter and it must be included in the URL. For example https://secure.vend-o.com/v/signup?site=2

👍

SDK for PHP is available

If you're working on a PHP project then you can create the Standard Join links using Vendo's SDK for PHP. It will ease the integration process for you.

Installation instructions are here SDK for PHP

You can find examples in the code repository here
https://github.com/lbadmin/vendo-sdk-php/tree/master/examples

Parameters

General parameters

Parameters

Data type

Mandatory

Description

site

integer

yes

Your site ID, assigned by Vendo.
Example: 2

page

string

no

The page the user should start on.
join for single-page process or prejoin for 2-step process.

country

string

no

Country the user resides in.

Note: Since the country is autodetected by Vendo, you do not need to include this parameter and we strongly recommend against using it.

2-letter ISO country codes.
Example: gb

Default: End user's country as determined from the IP address.

See a list of all ISO country codes

language

string

no

Language the user prefers.

Note: Since the language is autodetected by Vendo, you do not need to include this parameter and we strongly recommend against using it.

2-letter ISO language codes.
Example: en

Default: Preferred language as defined in end user's web browser.

See a list of all ISO language codes

billing_currency

string

no

This parameter allows you to force and block the display and billing currency shown to the end-user.

USD and EUR are the only supported values.

Note:
If the billing_currency param is set the url must be signed (see signature parameter).

3-letter ISO 4217 format

signature

string

no

The URL signature.

For more information, see Signing URLs

User details parameters

Parameter

Data type

Mandatory

Description

email

string

no

Prefill the "Email" field.

Example:
[email protected]

username

string

no

Prefill the "Username" field.

Example: Joe

password

string

no

Prefill the "Password" field.
Note: Please see the password_encrypted parameter and consider encrypting the password before sending it.
Note: If you don't need customers to enter a password before making a payment, send password=ignore and email_hide=1

Example: mypassword

password_encrypted

boolean

no

Use this parameter to indicate that the password parameter is encrypted.
Example: password_encrypted=1&password=encryptedpassword

The password will be decrypted by Vendo to show it to the user in the confirmation page, confirmation email, or the customer portal.

Accepted values:

  • 0 - password is not encrypted (default).
  • 1 - password is encrypted.

email_hide

boolean

no

Hide the "Email" field.

Example: 1
Default: 0

Note:
You must supply the email using the email parameter if you intend to hide the "Email" field!

username_hide

boolean

no

Hide the "Username" field.

Example: 1
Default: 0

Note: If the username field is hidden you must supply the username value.

password_hide

boolean

no

Hide the "Password" field

Example: 1
Default: 0

Note: If the password field is hidden you must supply the password value. If your customers don't need a password to pay, send password=ignore

subscription

integer

no

Unique Vendo subscription ID of the end user to whom the standard join is being advertised.

We will use the user details from the subscription and we will reduce the number of fields on the join form to the minimum.

If the subscription param is set the url must be signed (see signature parameter).

One step join process parameters

One-Step Join Process parameters can be used to automatically fill in your user address information. You can also control whether your site title is displayed on this screen.

Parameter

Data type

Mandatory

Description

firstname

string

no

Prefill the "First Name" field.
Example: John

lastname

string

no

Prefill the "Last Name" field.
Example: Smith

street

string

no

Prefill the "Street" field.
Example: 123 My St
Note: This field is hidden by default. Let us know if you need to display it in your payment process.

city

string

no

Prefill the "City" field.
Example: San Francisco
Note: This field is hidden by default. Let us know if you need to display it in your payment process.

zip

string

no

Prefill the "Zip" field.
Example: 94114

Note: This is for US zip codes, if required by law

state

string

no

Prefill the "State" field.
Example: California

Notes:

  • This is for US states, if required by law.
  • This field is hidden by default. Let us know if you need to display it in your payment process.

Offers parameters

These parameters are optional. If you don't use them, the default parameters you specified when you registered your site in Vendo will be used. You can specify which offers are displayed to your end-users using the offers parameter, then you can use the selected_offer parameter to specify which one should be pre-selected. Keep in mind that if you send the wrong or invalid parameter values then the default configured offers will be displayed.

You can configure Offers in Vendo's back office. Follow this guide to configure offers.

Parameter

Data type

Mandatory

Description

offers

integer

no

Limits the list of offer the customer can choose from.

Can be a single offer ID or a list of offer IDs separated by comma.

If this parameter is not passed in then the default offers configured for a site will be displayed.

Example: offers=1001,1002,1003

selected_offer

integer

no

Choose which offer should be preselected.

Example: selected_offer=1002

Cross sales parameters

If you have cross sales partners then you can,

  1. Configure cross sales offers in Vendo's back office.
  2. Use the following parameters to specify which cross sales to display.
    If you don't use the parameters that are specified in the table below then the cross offers that were configured in the back office (if any) will be displayed.

For more information see also Adding Cross-sales.

📘

Getting cross sales partners

Vendo can help you getting cross sales partners. Please contact us at [email protected] for more details.

Parameter

Data type

Mandatory

Description

xsales_max

integer

no

Number of cross-sale offers to be displayed on the payment page.

Accepted values
0 - Do not display any cross-sales
1 - Display only 1 cross sale
2 - Display 2 cross sales.

Default value: 2

xsales

integer

no

List of cross-sale IDs to be displayed on the payment page.

Example:
xsales=1102,1104

Default: If not specified, the first two cross-saless configured in Vendo's back office will be displayed.

xsale_ref

string

no

Your transaction reference values for any xsale transactions processed.

Comma separate the values if you have different reference values for each cross sale.

Vendo's platform will post these references in the transaction postbacks.

Example:
xsale_ref=MYCSREF1,REF2

Redirection parameters

Redirection parameters are used to redirect end users back to your site. There are two parameters, one for successful transactions and one for failed transactions. Additionally, you can use placeholders which will be replaced with actual transaction data. Check the next section to get the list of available placeholders.

Parameter

Data type

Mandatory

Description

decline_url

string

no

Redirects the end-user to this URL if the transaction failed (i.e. payment was not successful)

Note: Make sure this parameter value (like all url parameters values) is url-encoded.

Example:
https://mysite.com/decline_page?user_email={EMAIL}&passthru_reference={REF}

then url-encode it, this is how that example looks like after url-encoding it,

https%3A%2F%2Fmysite.com%2Fdecline_page%3Fuser_email%3D%7BEMAIL%7D%26passthru_reference%3D%7BREF%7D

success_url

string

no

Redirects the end-user to this URL if the transaction was successfully processed. (i.e. the payment was accepted)

Note: Make sure this parameter value (like all url parameters values) is url-encoded.

Example:
https://mysite.com/success?user_email={EMAIL}&vendo_subscription_id={SUBSCRIPTION_ID}&passthru_reference={REF}&selected_offer_id={SELECTED_OFFER}&vendo_transaction_id={TRANSACTION_ID}

then url-encode it, this is how that example looks like after url-encoding it,

https%3A%2F%2Fmysite.com%2Fsuccess%3Fuser_email%3D%7BEMAIL%7D%26vendo_subscription_id%3D%7BSUBSCRIPTION_ID%7D%26passthru_reference%3D%7BREF%7D%26selected_offer_id%3D%7BSELECTED_OFFER%7D%26vendo_transaction_id%3D%7BTRANSACTION_ID%7D

Placeholders

You can use the placeholders listed in the table below in your success and decline URLs, Vendo's platform will replace them with actual transaction and subscription data.

For example, if you set the success_url to:
http://www.example.com/success_page?user_email={EMAIL}

and then end-user enters "[email protected]" in Vendo's payment form and the transaction gets accepted then the user will be redirected to the following URL.

http://www.example.com/success_page?user_email=joecustomer%40hotmail.com

Available placeholders

Placeholder

Description

{EMAIL}

The end-user's email address.

{USERNAME}

The end-user's username.

{PASSWORD_ENCRYPTED}

The end-user's encrypted password.
Uses AES-128 encryption with your personal shared secret, you can use our PHP SDK to encrypt the password.

{PASSWORD}

The end-user's password.
Deprecated - use {PASSWORD_ENCRYPTED} instead.

{FIRSTNAME}

The end-user's first name.

{LASTNAME}

The end-user's last name.

{STREET}

The end-user's billing address street.

{CITY}

The end-user's billing address city.

{ZIP}

The end-user's billing address zip code.

{COUNTRY}

The end-user's billing country.

{REF}

Your transaction reference.

{SUBSCRIPTION_ID}

Vendo Subscription ID. This is only available for the success_url.

{TRANSACTION_ID}

Vendo Transaction ID

{OFFER_IDENTIFIER}

Your offer reference.

{SELECTED_OFFER}

Offer ID for the selected offer.

Confirmation page parameters

This parameter allows you to control whether to show or not the user's credentials in Vendo's confirmation page.

Parameter

Data type

Mandatory

Description

logindata_hide

boolean

no

Hides the username and password credentials on the confirmation page.

Examples:
1 - Hide the information
0 - Show the information (default)

Pass-through parameter

The ref parameter is a "pass-through" parameter. On a successful transaction, this will value will be posted back to you in postbacks in the merchant_reference parameter.

Parameter

Data type

Mandatory

Description

ref

string

no

The data that will be reported for the transaction event.

Maximum 1024 characters.
Example:
123456

Will be reported back to you in the postbacks in the merchant_reference parameter.

Affiliate tracking parameters

Affiliate-generated visits can be tracked by including these parameters in the join link URL. These parameters will also be posted back to you in the transaction postback.

Parameter

Data type

Mandatory

affiliate_id

string

no

Affiliate identifier.
Please provide this parameter so Vendo can provide you reporting on your affiliates performance.

Example:
XMjc4MzUxOjM

Important
Please use 0 (zero) for organic and search engine traffic.

campaign_id

string

no

Campaign identifier.

Example:
159

program_id

string

no

Program Identifier.

Example:
277

Payment method parameters

Parameter

Data type

Mandatory

Description

pm

string

no

Pre-selects a payment method.

The checkout page will have the specified payment method pre-selected from the dropdown if it's valid for the selected country and offer.

Values:
CC = Credit Card (default)
DD = Direct Debit
PAYPAL = PayPal
SEPA = Sepa
PG = PayGarden
IN = Interac
PIX = PIX

Example:
pm=PG

- Note that some payment methods may not be supported by Vendo in a given scenario. Only options that appear the the payment method dropdown can be preselected.

Parameters for white-labelled sites

If you offer a white-label site (for example a white label dating solution) then you can pass the following extra parameters in the join link:

Parameter

Data type

Mandatory

Description

site_name

string

no

This is the name of the site using your whitelabel solution.

We'll render this name in the payment page.

site_url

string

no

This is the URL of the site using your whitelabel solution.

We'll use this URL together with the site_name in the confirmation page and any future communication that our platform will send via email, for example in the payment confirmation email.

Note:
The site URL must be url -encoded.

Examples

  • site=5000 (The Vendo Site ID)
  • ref=XYZ-123-ABC (The pass through data that will be posted back to your platform)
  • offers=123 (Vendo will only display the Vendo Offer ID '123').
  • affiliate_id=0 (Zero means that the user came from organic or search engine traffic).

Example 1: Send the end-user to the payment process using all of the default options:

https://secure.vend-o.com/v/signup?site=5000&affiliate_id=0

Example 2: Send the end-user to the payment process with all the default options plus the ref parameter for tracking user and transaction:

https://secure.vend-o.com/v/signup?site=5000&affiliate_id=0&ref=XYZ-123-ABC

Example 3: Send the end-user to the payment process and specify the Vendo Offer IDs from which the user can choose and also specify your Affiliate ID so Vendo can track it for reporting purposes:

https://secure.vend-o.com/v/signup?site=5000&affiliate_id=999&offers=123,432,456

Did this page help you?