Payway Articles¶

Target Audience: Administrators

Introduction¶

Payway Articles is a newly introduced method of selling your products. Rather than selling a recurring subscription, you can now sell individual articles instead. This will allow your customers to gain infinite access to a specific article, rather than to the entire contents of a package or campaign.

Prerequisites¶

Only Packages can be sold as Articles. The period type will not be available when setting up payment periods for a Campaign.
Packages must be digital-only. A Package cannot contain both Article payment periods as well as print/paper products.
Articles currently only support the Adyen and Klarna Payments payment options.

This feature must be enabled by Adeprimo prior to use. Please contact our support for more information.

Configuring Article purchases¶

Implementation required

Note that while Payway Articles can be sold both via your own implementation and via Tulo Shop, your own implementation is currently required for access control. Contact our support for more information regarding this!

Article purchases, once enabled, are very easy to configure. Simply navigate to the Payment Period overview of the Package that you would like to offer Article purchases from, then, simply set up a new payment period with the correct subscription type. And that's it! You can now begin selling articles.

Selling your first Article¶

Via Tulo Paywall¶

Once you have configured an Article payment period, and you have your own implementation setup to be able to handle the access control of Payway Articles, you can begin selling!

Simply navigate to the template of the Tulo Paywall where you would like to offer article purchases, and paste in the following HTML snippet in the "Advanced settings" section, at the very bottom.

<div id="tulo-article">
    <h3>Interested in this article only?</h3>
    <p>
        Click the button below to unlock access to this article.
        <a href="[LOGIN_URL]">Login</a> if you have already unlocked this article previously.
    </p>

    <a href="[ARTICLE_PURCHASE_URL]?aid=[TULO_ARTICLE_ID]&url=[TULO_ARTICLE_URL]&asb=[TULO_ARTICLE_SUBJECT]">
        <button type="button">Unlock article</button>
    </a>
</div>

Now, the Tulo Paywall will almost take care of the rest for you. However, in the customVariables attribute available when initialising the Tulo Paywall, the following parameters must be set in order for the link to become correct:

Key	Description
TULO_ARTICLE_ID	ID of the Article, later used to identify whether the customer has access or not
TULO_ARTICLE_URL	Absolute URI to the specific article that the customer will buy
TULO_ARTICLE_SUBJECT	Subject/title of the specific article that the customer will buy

Via other sales surfaces¶

Once you have configured an Article payment period, and you have your own implementation setup to be able to handle the access control of Payway Articles, you can begin selling!

Simply navigate to the Package in the PAP that you would like to sell, and click "Sales links". You will notice that a new type of link has appeared, allowing the Package to be sold as an Article. This is the "root" of the URL that will be used.

Example: https://adeprimo.marketplace/news/subscribe/adeprimo_digital/article

In order for the access control and communication to work as intended, you will have to append the following parameters to the URL:

aid: A free-text string that is later used on your site to verify the access of the user
asb: A free-text string containing the subject/name of the specific article
url: Absolute URI pointing to the exact page of the article

This means, that once everything is setup correctly, the link should be looking something like this:

Example: https://adeprimo.marketplace/news/subscribe/adeprimo_digital/article?aid=foobar&asb=My+example+subject&url=http%3A%2F%2Fadeprimo.se%2F

Once you have established your link, you can use this link from wherever you wish to sell this article, and voilà, that's it!

Validating customer access¶

When the customer has performed their purchase via Tulo Shop, or logged in to the PCP in order to find their way back to a previously purchased article, the refresh_entitlements URL parameter will always be appended to the previously given article URL. This will allow you to easier decide when customer access should be refreshed, instead of having to ping for customer access constantly, which would only result in slowing down your website unnecessarily.

Example: https://adeprimo.se/newspaper/article-1?refresh_entitlements=true