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!
For detailed implementation instructions including HTML snippets and configuration parameters, see Implementing Payway Articles in Tulo Paywall.
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