Documentation

Information for Fovea.Billing Users

Fovea's billing service is gradually being replaced by Iaptic. It's a new better version of the same service, backward compatible, but distributed with different conditions.

What is the relation between Fovea and Iaptic?

In August 2020, iaptic SAS acquired the rights to distribute Fovea's Billing service. Being a company incorporated in France, it made it easier to access a number of services and build trust with our customers.

Fovea will continue to handle every technical aspects, while Iaptic handles the commercial side of the project. That is why we're rebranding our service as iaptic, a better name that also matches what you see on your invoices.

What has changed (or will)?

I you have already been using Fovea.Billing, here's a summary of what changed with the introduction of iaptic.com and what didn't.

New domain

  • validator.fovea.cc is now validator.iaptic.com.
  • billing.fovea.cc is now iaptic.com.

API v3

Iaptic introduces a version 3 of the REST API. It features some major changes:

v2 and v1 API endpoints are still available through a compatibility layer.

Teams

Administrators can add other member to their Team, those users can access the data for your application.

Google Subscription V2

Our server now validates google receipts for subscriptions using their newly introduced subscriptionv2 API. It's compatible with the new subscription model introduced in May 2022, which gives more options for the pricing of subscription products.

It also changes the way subscription is identified. Google now recommends using the purchase token as a primary identifier. The orderId is now omitted from free trials so it cannot be used as a primary identifier anymore.

If you're using the purchaseId field from our API, beware that the update can break this part of the code.

Apple Server-to-Server Notifications V2

Version 2 of Apple server-to-server notifications is supported. This new version includes additional data and more purchase events types.

Braintree

The backend logic required to perform payments using Braintree (from PayPal) is now supported. Check this tutorial for an example use case.

Webhook Notifications

Many have asked for a simpler way to build purchase analytics and react to various events in the subscription lifecycle. Iaptic now includes a notification field that provides the reason for the webhook call. Check the Webhook documentation for more details.

Pricing

Plans now have 2 distinct limits: a maximum number of transactions and number of requests per month. Some free apps are making lot of receipt validation requests (counted in millions) but haven't got many that subscribers (if any), those despite the cost to our infrastructure were still eligible for our free plan. This should encourage those users to optimize their usage of our API.

For our loyal users that are already subscribed to Fovea's silver plan:

  • You can wait to upgrade to iaptic plans until January 1st, 2024.
  • A 50% discount is available on request.

Some features like "Teams" will also only be available to PRO and BUSINESS subscribers.

Check out our Pricing page for details.