Context
The Offer Presentation Grid is a hosted page that allows you to display to the customer the list of available offers for subscription. The goal is to enable them to compare different options related to your service and choose the one that suits them best.
If they click on a “Subscribe” button, they will be redirected directly to the subscription tunnel.
Procedure
To include this page on your website, you need to retrieve the link associated with your customer.
The page is linked to a customer because the page and the resulting processes will be displayed based on their context.
1/ Retrieve the link during customer creation
Request:
POST https://api-2.proabono.com/v1/Customer
{
"ReferenceCustomer": "123456",
"Name": "John Doe",
"Email": "john@doe.com",
"Language": "en"
}
Response:
{
"Id": 72461,
"IdSegment": 3,
"ReferenceCustomer": "123456",
"ReferenceSegment": "sandbox-eur",
"Name": "John Doe",
"Email": "john@doe.com",
"Language": "en",
"Links": [
{
"rel": "hosted-collection-offers",
"href": "https://sandbox-eur.proabono.com/pricing/{Unique-Encrypted-URL1}"
},
{
"rel": "hosted-home",
"href": "https://sandbox-eur.proabono.com/portal/{Unique-Encrypted-URL2}"
},
{
"rel": "hosted-register",
"href": "https://sandbox-eur.proabono.com/register/{Unique-Encrypted-URL3}"
}
]
}
With this call, you will create or update the correct customer and dynamically retrieve the link to the offer presentation page.
Copy the href link corresponding to the key “hosted-collection-offers” (https://sandbox-eur.proabono.com/pricing/xxxxx in our example).
Note:
– If the customer does not exist in ProAbono yet, it will be automatically created.
– If the customer already exists, the call will simply update the customer’s data (the POST will be interpreted as a PATCH).
– If the customer does not exist in ProAbono yet, it will be automatically created.
– If the customer already exists, the call will simply update the customer’s data (the POST will be interpreted as a PATCH).
2/ Redirect the customer to the offer presentation page
Once you have retrieved the correct link, you should use it as the source of an Iframe.
Note: The Hosted-Collection-Offers link is present in the response of an API call to the Customer resource. Therefore, it is possible to retrieve it through a GET Customer if it already exists in the ProAbono database.