Context
When selling an online service, a common scenario is to encourage the customer to try the solution with just one click (from a CTA in your application). The customer can then try the service for free for a period before potentially subscribing to a paid offer.
To implement this scenario using ProAbono, you need to add a button to your application and perform the actions responsible for creating a customer and subscribing them to the welcome offer.
Prerequisites
To make it work, you need to:
- Create a welcome offer in ProAbono.
- Have an authentication process in your application.
- Add a button to your application allowing users to subscribe to the welcome offer (e.g., Free Trial).
Process
Once your customer clicks on the “Free Trial” button:
1/ Authenticate the user
If the user is already authenticated at the time of the click, proceed directly to step 2.
Otherwise, you should redirect the user to your registration or login form to retrieve their information.
2/ Send information to ProAbono
API Call #1 – Create a Customer
Example request
POST https://api-{IdBusiness}.proabono.com/v1/customer
{
"ReferenceCustomer": "123456",
"Name": "John Doe",
"Email": "john@doe.com",
"ReferenceSegment": "{ReferenceSegment}"
}
ReferenceSegment: It is necessary to create the customer in the appropriate segment based on their profile.
If no error code is returned, a customer has been successfully created in your ProAbono environment.
API Call #2 – (optional) Update Billing Address
If you have your customer’s billing address, you can provide it through the following API call:
Example request
POST https://api-{IdBusiness}.proabono.com/v1/CustomerBillingAddress?ReferenceCustomer=123456
{
"Company": "John DOE SARL",
"FirstName": "John",
"LastName": "Doe",
"AddressLine1": "123 Avenue des Champs Elysées",
"ZipCode": "75008",
"City": "Paris",
"Country": "FR",
"TaxInformation": "FR12345678"
}
If no error code is returned, the billing address update has been successfully performed.
API Call #3 – Create a Subscription
Example request
POST https://api-{IdBusinessProd}.proabono.com/v1/Subscription
{
"ReferenceCustomer": "123456",
"ReferenceOffer": "pro-bienvenue"
}
If no error code is returned, the customer’s subscription has been successfully created.
Going Further
Once your customer clicks on the button triggering the entire workflow presented above, they should be redirected to a page.
From the ProAbono back office settings, you can choose the redirection URL.