Ropo
Target Audience: Administrators, Integration Managers, Superusers
Payment Provider Ropo¶
This section describes the various fields and properties of the Ropo payment provider in more detail. The configuration is created under Security → Payment provider configurations. For the full setup procedure, see Getting started with Ropo.
Info and credentials¶
| Name | Description |
|---|---|
| Payment configuration name | A name for the configuration, e.g. "Ropo configuration" |
| Titles | The titles that may use this configuration |
| Ropo CID | The customer id provided by Ropo |
| Ropo API code | The API code provided by Ropo |
Settings for Ropo¶
| Name | Description |
|---|---|
| Ropo One integration | Embed or Unify — which Ropo One integration the configuration uses |
| Payment terms for new purchase (days) | Days the customer has to pay the first invoice, counted from the purchase. 1–365. Recommended value: 30 |
| Invoice sent before due/renewal date (days) | Days before the renewal date that the renewal invoice is sent. 0–365, where 0 sends it on the renewal date. Recommended value: 45 |
| Credit period on renewal (days) | Days the customer has to pay the renewal invoice, counted from the day it is sent. 1–365. Leave it empty to use the advance notice above, which puts the due date on the renewal date. Required when the advance notice is 0 |
| Payment terms for monthly invoice on new purchase (days) | Days the customer has to pay a monthly subscription's first invoice. 1–14. Recommended value: 14 |
| Monthly invoice sent before due/renewal date (days) | Days before the renewal date that a monthly invoice is sent. 0–14. Recommended value: 14 |
| Credit period on renewal, monthly (days) | The same as the credit period above, for a monthly subscription. 1–14 |
| Grace period for unpaid delivery (days) | Days the subscription keeps being delivered past the due date before it is stopped. 0–365 |
| Enable invoice write-off after number of days | Turns invoice write-off on or off |
| Invoice will be closed and credited after (days) | Days until the invoice is written off and credited. Must be longer than the grace period |
| Information text on the invoice | Free text added to the invoice |
How the renewal dates are calculated¶
invoice date = renewal date − invoice sent before due/renewal date
due date = invoice date + credit period on renewal
period start = renewal date
The advance notice and the credit period are separate settings, because how far ahead a publisher invoices and how long it then gives the customer to pay are two different decisions. Leaving the credit period empty makes it equal to the advance notice, which is how renewals behaved before the field existed: the invoice falls due exactly on the renewal date.
Warning
Check the write-off period against the grace period. Write-off is measured from the due date, grace from the later of the period start and the due date. A credit period shorter than the advance notice puts the due date before the period start and the two drift apart, so an invoice can be written off and credited while the customer is formally still within grace. Keep the write-off period longer than (advance notice − credit period) + grace period.
Package-specific payment terms¶
The day fields above apply to every package on the titles this configuration covers. A single package can be given different terms — for example business customers invoiced on other terms than private ones — with a payment terms configuration. A package then takes all of its day fields from those terms rather than from this configuration.
Paper invoice billing fee¶
| Name | Description |
|---|---|
| Cost center for postal billing fee | Cost center the paper invoice billing fee is booked on |
| Postal billing fee amount | The amount charged for a paper invoice |
Ropo invoice settings¶
| Name | Description |
|---|---|
| Send title integration code with invoice | Includes the title's integration code on the invoice |
| Product row information text | Adds additional information to the product row on the invoice (title name, period length, purchase type) |
Payment methods¶
Choose the payment methods that will be available as payment periods for packages and campaigns. For Ropo, select Invoice — Ropo determines the appropriate delivery method, and the delivery method is chosen per subscription or payment profile.