Connectors

RevenueCat connector

Let Limenia revoke promotional entitlements and end web subscriptions of banned users, and detect ban evasion through purchase transfers.

Like every connector, it works in addition to the webhook and never replaces it. An admin sets it up in the dashboard (tab Connectors).

What it does

On ban_user Limenia revokes promotional entitlements you configured and cancels RevenueCat Web Billing subscriptions at period end (optionally refunds Web Billing and Google Play after explicit moderator confirmation); on suspend_user it revokes promotional entitlements; on restore (account) and at the end of a suspension it grants them back. App Store and Amazon subscriptions cannot be ended by developers; the statement of reasons tells the user how to cancel.

Requirements

The externalUserId is the RevenueCat App User ID (otherwise revenuecat_customer_not_found). Do not use e-mail addresses as App User IDs.

Setup

RevenueCat API v2 secret key with customer_information:customers:read_write and customer_information:subscriptions:read (or read_write if bans cancel or refund), project ID (proj…), entitlement IDs of API v2; Check connection.

Ban evasion through purchases

Set RevenueCat’s restore behavior to “Keep with original App User ID”. Optionally set up the RevenueCat webhook to Limenia (RevenueCat webhook receiver) with all events or at least TRANSFER and CANCELLATION, environment Production, and HMAC signing.

The receiver is described in RevenueCat webhook receiver.

What your backend sees

decision.created contains nothing about RevenueCat; the statement of reasons contains a generic “Purchases” sentence.

Errors in the delivery log

Code Meaning Retried?
revenuecat_customer_not_found No customer with this App User ID: the externalUserId is not the RevenueCat App User ID no
revenuecat_unauthorized The secret key is wrong or lacks a permission no
revenuecat_project_not_found Wrong project ID no
revenuecat_rejected RevenueCat rejected the request no
not_configured The connector was switched off or is incomplete no
revenuecat_unavailable RevenueCat did not answer in time or is unavailable yes