RevenueCat

Nutzungsanweisungen

Integrate RevenueCat into the workflow. Manage subscribers, entitlements, offerings, and Google Play subscriptions. Retrieve customer subscription status, grant or revoke promotional entitlements, record purchases, update subscriber attributes, and manage Google Play subscription billing.

Tools

`revenuecat_get_customer`

Retrieve subscriber information by app user ID

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat secret API key (sk_...)
`appUserId`	string	Ja	The app user ID of the subscriber

Ausgabe

Parameter	Typ	Beschreibung
`subscriber`	object	The subscriber object with subscriptions and entitlements
↳ `first_seen`	string	ISO 8601 date when subscriber was first seen
↳ `original_app_user_id`	string	Original app user ID
↳ `original_purchase_date`	string	ISO 8601 date of original purchase
↳ `management_url`	string	URL for managing the subscriber subscriptions
↳ `subscriptions`	object	Map of product identifiers to subscription objects
↳ `store_transaction_id`	string	Store transaction identifier
↳ `original_transaction_id`	string	Original transaction identifier
↳ `purchase_date`	string	ISO 8601 purchase date
↳ `original_purchase_date`	string	ISO 8601 date of the original purchase
↳ `expires_date`	string	ISO 8601 expiration date
↳ `is_sandbox`	boolean	Whether this is a sandbox purchase
↳ `unsubscribe_detected_at`	string	ISO 8601 date when unsubscribe was detected
↳ `billing_issues_detected_at`	string	ISO 8601 date when billing issues were detected
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `ownership_type`	string	Ownership type (purchased, family_shared)
↳ `period_type`	string	Period type (normal, trial, intro, promotional, prepaid)
↳ `store`	string	Store the subscription was purchased from (app_store, play_store, stripe, etc.)
↳ `refunded_at`	string	ISO 8601 date when subscription was refunded
↳ `auto_resume_date`	string	ISO 8601 date when a paused subscription will auto-resume
↳ `product_plan_identifier`	string	Google Play base plan identifier (for products set up after Feb 2023)
↳ `entitlements`	object	Map of entitlement identifiers to entitlement objects
↳ `grant_date`	string	ISO 8601 grant date
↳ `expires_date`	string	ISO 8601 expiration date
↳ `product_identifier`	string	Product identifier
↳ `is_active`	boolean	Whether the entitlement is active
↳ `will_renew`	boolean	Whether the entitlement will renew
↳ `period_type`	string	Period type (normal, trial, intro, promotional)
↳ `purchase_date`	string	ISO 8601 date of the latest purchase or renewal
↳ `store`	string	Store the entitlement was granted from
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `non_subscriptions`	object	Map of non-subscription product identifiers to arrays of purchase objects
`metadata`	object	Subscriber summary metadata
↳ `app_user_id`	string	The app user ID
↳ `first_seen`	string	ISO 8601 date when the subscriber was first seen
↳ `active_entitlements`	number	Number of active entitlements
↳ `active_subscriptions`	number	Number of active subscriptions

`revenuecat_delete_customer`

Permanently delete a subscriber and all associated data

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat secret API key (sk_...)
`appUserId`	string	Ja	The app user ID of the subscriber to delete

Ausgabe

Parameter	Typ	Beschreibung
`deleted`	boolean	Whether the subscriber was deleted
`app_user_id`	string	The deleted app user ID

`revenuecat_create_purchase`

Record a purchase (receipt) for a subscriber via the REST API

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat API key (public or secret)
`appUserId`	string	Ja	The app user ID of the subscriber
`fetchToken`	string	Ja	The receipt token or purchase token from the store (App Store receipt, Google Play purchase token, or Stripe subscription ID)
`productId`	string	Ja	The product identifier for the purchase
`price`	number	Nein	The price of the product in the currency specified
`currency`	string	Nein	ISO 4217 currency code (e.g., USD, EUR)
`isRestore`	boolean	Nein	Whether this is a restore of a previous purchase
`platform`	string	Nein	Platform of the purchase (ios, android, amazon, macos, stripe). Required for Stripe and Paddle purchases.

Ausgabe

Parameter	Typ	Beschreibung
`subscriber`	object	The updated subscriber object after recording the purchase
↳ `first_seen`	string	ISO 8601 date when subscriber was first seen
↳ `original_app_user_id`	string	Original app user ID
↳ `original_purchase_date`	string	ISO 8601 date of original purchase
↳ `management_url`	string	URL for managing the subscriber subscriptions
↳ `subscriptions`	object	Map of product identifiers to subscription objects
↳ `store_transaction_id`	string	Store transaction identifier
↳ `original_transaction_id`	string	Original transaction identifier
↳ `purchase_date`	string	ISO 8601 purchase date
↳ `original_purchase_date`	string	ISO 8601 date of the original purchase
↳ `expires_date`	string	ISO 8601 expiration date
↳ `is_sandbox`	boolean	Whether this is a sandbox purchase
↳ `unsubscribe_detected_at`	string	ISO 8601 date when unsubscribe was detected
↳ `billing_issues_detected_at`	string	ISO 8601 date when billing issues were detected
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `ownership_type`	string	Ownership type (purchased, family_shared)
↳ `period_type`	string	Period type (normal, trial, intro, promotional, prepaid)
↳ `store`	string	Store the subscription was purchased from (app_store, play_store, stripe, etc.)
↳ `refunded_at`	string	ISO 8601 date when subscription was refunded
↳ `auto_resume_date`	string	ISO 8601 date when a paused subscription will auto-resume
↳ `product_plan_identifier`	string	Google Play base plan identifier (for products set up after Feb 2023)
↳ `entitlements`	object	Map of entitlement identifiers to entitlement objects
↳ `grant_date`	string	ISO 8601 grant date
↳ `expires_date`	string	ISO 8601 expiration date
↳ `product_identifier`	string	Product identifier
↳ `is_active`	boolean	Whether the entitlement is active
↳ `will_renew`	boolean	Whether the entitlement will renew
↳ `period_type`	string	Period type (normal, trial, intro, promotional)
↳ `purchase_date`	string	ISO 8601 date of the latest purchase or renewal
↳ `store`	string	Store the entitlement was granted from
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `non_subscriptions`	object	Map of non-subscription product identifiers to arrays of purchase objects

`revenuecat_grant_entitlement`

Grant a promotional entitlement to a subscriber

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat secret API key (sk_...)
`appUserId`	string	Ja	The app user ID of the subscriber
`entitlementIdentifier`	string	Ja	The entitlement identifier to grant
`duration`	string	Ja	Duration of the entitlement (daily, three_day, weekly, monthly, two_month, three_month, six_month, yearly, lifetime)
`startTimeMs`	number	Nein	Optional start time in milliseconds since Unix epoch. Set to a past time to achieve custom durations shorter than daily.

Ausgabe

Parameter	Typ	Beschreibung
`subscriber`	object	The updated subscriber object after granting the entitlement
↳ `first_seen`	string	ISO 8601 date when subscriber was first seen
↳ `original_app_user_id`	string	Original app user ID
↳ `original_purchase_date`	string	ISO 8601 date of original purchase
↳ `management_url`	string	URL for managing the subscriber subscriptions
↳ `subscriptions`	object	Map of product identifiers to subscription objects
↳ `store_transaction_id`	string	Store transaction identifier
↳ `original_transaction_id`	string	Original transaction identifier
↳ `purchase_date`	string	ISO 8601 purchase date
↳ `original_purchase_date`	string	ISO 8601 date of the original purchase
↳ `expires_date`	string	ISO 8601 expiration date
↳ `is_sandbox`	boolean	Whether this is a sandbox purchase
↳ `unsubscribe_detected_at`	string	ISO 8601 date when unsubscribe was detected
↳ `billing_issues_detected_at`	string	ISO 8601 date when billing issues were detected
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `ownership_type`	string	Ownership type (purchased, family_shared)
↳ `period_type`	string	Period type (normal, trial, intro, promotional, prepaid)
↳ `store`	string	Store the subscription was purchased from (app_store, play_store, stripe, etc.)
↳ `refunded_at`	string	ISO 8601 date when subscription was refunded
↳ `auto_resume_date`	string	ISO 8601 date when a paused subscription will auto-resume
↳ `product_plan_identifier`	string	Google Play base plan identifier (for products set up after Feb 2023)
↳ `entitlements`	object	Map of entitlement identifiers to entitlement objects
↳ `grant_date`	string	ISO 8601 grant date
↳ `expires_date`	string	ISO 8601 expiration date
↳ `product_identifier`	string	Product identifier
↳ `is_active`	boolean	Whether the entitlement is active
↳ `will_renew`	boolean	Whether the entitlement will renew
↳ `period_type`	string	Period type (normal, trial, intro, promotional)
↳ `purchase_date`	string	ISO 8601 date of the latest purchase or renewal
↳ `store`	string	Store the entitlement was granted from
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `non_subscriptions`	object	Map of non-subscription product identifiers to arrays of purchase objects

`revenuecat_revoke_entitlement`

Revoke all promotional entitlements for a specific entitlement identifier

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat secret API key (sk_...)
`appUserId`	string	Ja	The app user ID of the subscriber
`entitlementIdentifier`	string	Ja	The entitlement identifier to revoke

Ausgabe

Parameter	Typ	Beschreibung
`subscriber`	object	The updated subscriber object after revoking the entitlement
↳ `first_seen`	string	ISO 8601 date when subscriber was first seen
↳ `original_app_user_id`	string	Original app user ID
↳ `original_purchase_date`	string	ISO 8601 date of original purchase
↳ `management_url`	string	URL for managing the subscriber subscriptions
↳ `subscriptions`	object	Map of product identifiers to subscription objects
↳ `store_transaction_id`	string	Store transaction identifier
↳ `original_transaction_id`	string	Original transaction identifier
↳ `purchase_date`	string	ISO 8601 purchase date
↳ `original_purchase_date`	string	ISO 8601 date of the original purchase
↳ `expires_date`	string	ISO 8601 expiration date
↳ `is_sandbox`	boolean	Whether this is a sandbox purchase
↳ `unsubscribe_detected_at`	string	ISO 8601 date when unsubscribe was detected
↳ `billing_issues_detected_at`	string	ISO 8601 date when billing issues were detected
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `ownership_type`	string	Ownership type (purchased, family_shared)
↳ `period_type`	string	Period type (normal, trial, intro, promotional, prepaid)
↳ `store`	string	Store the subscription was purchased from (app_store, play_store, stripe, etc.)
↳ `refunded_at`	string	ISO 8601 date when subscription was refunded
↳ `auto_resume_date`	string	ISO 8601 date when a paused subscription will auto-resume
↳ `product_plan_identifier`	string	Google Play base plan identifier (for products set up after Feb 2023)
↳ `entitlements`	object	Map of entitlement identifiers to entitlement objects
↳ `grant_date`	string	ISO 8601 grant date
↳ `expires_date`	string	ISO 8601 expiration date
↳ `product_identifier`	string	Product identifier
↳ `is_active`	boolean	Whether the entitlement is active
↳ `will_renew`	boolean	Whether the entitlement will renew
↳ `period_type`	string	Period type (normal, trial, intro, promotional)
↳ `purchase_date`	string	ISO 8601 date of the latest purchase or renewal
↳ `store`	string	Store the entitlement was granted from
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `non_subscriptions`	object	Map of non-subscription product identifiers to arrays of purchase objects

`revenuecat_list_offerings`

List all offerings configured for the project

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat API key
`appUserId`	string	Ja	An app user ID to retrieve offerings for
`platform`	string	Nein	Platform to filter offerings (ios, android, stripe, etc.)

Ausgabe

Parameter	Typ	Beschreibung
`current_offering_id`	string	The identifier of the current offering
`offerings`	array	List of offerings
↳ `identifier`	string	Offering identifier
↳ `description`	string	Offering description
↳ `packages`	array	List of packages in the offering
↳ `identifier`	string	Package identifier
↳ `platform_product_identifier`	string	Platform-specific product identifier
`metadata`	object	Offerings metadata
↳ `count`	number	Number of offerings returned
↳ `current_offering_id`	string	Current offering identifier

`revenuecat_update_subscriber_attributes`

Update custom subscriber attributes (e.g., $email, $displayName, or custom key-value pairs)

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat secret API key (sk_...)
`appUserId`	string	Ja	The app user ID of the subscriber
`attributes`	json	Ja	JSON object of attributes to set. Each key maps to an object with a "value" field. Example: {"$email": {"value": "user@example.com"}, "$displayName": {"value": "John"}}

Ausgabe

Parameter	Typ	Beschreibung
`updated`	boolean	Whether the subscriber attributes were successfully updated
`app_user_id`	string	The app user ID of the updated subscriber

`revenuecat_defer_google_subscription`

Defer a Google Play subscription by extending its billing date by a number of days (Google Play only)

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat secret API key (sk_...)
`appUserId`	string	Ja	The app user ID of the subscriber
`productId`	string	Ja	The Google Play product identifier of the subscription to defer (use the part before the colon for products set up after Feb 2023)
`extendByDays`	number	Ja	Number of days to extend the subscription by (1-365)

Ausgabe

Parameter	Typ	Beschreibung
`subscriber`	object	The updated subscriber object after deferring the Google subscription
↳ `first_seen`	string	ISO 8601 date when subscriber was first seen
↳ `original_app_user_id`	string	Original app user ID
↳ `original_purchase_date`	string	ISO 8601 date of original purchase
↳ `management_url`	string	URL for managing the subscriber subscriptions
↳ `subscriptions`	object	Map of product identifiers to subscription objects
↳ `store_transaction_id`	string	Store transaction identifier
↳ `original_transaction_id`	string	Original transaction identifier
↳ `purchase_date`	string	ISO 8601 purchase date
↳ `original_purchase_date`	string	ISO 8601 date of the original purchase
↳ `expires_date`	string	ISO 8601 expiration date
↳ `is_sandbox`	boolean	Whether this is a sandbox purchase
↳ `unsubscribe_detected_at`	string	ISO 8601 date when unsubscribe was detected
↳ `billing_issues_detected_at`	string	ISO 8601 date when billing issues were detected
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `ownership_type`	string	Ownership type (purchased, family_shared)
↳ `period_type`	string	Period type (normal, trial, intro, promotional, prepaid)
↳ `store`	string	Store the subscription was purchased from (app_store, play_store, stripe, etc.)
↳ `refunded_at`	string	ISO 8601 date when subscription was refunded
↳ `auto_resume_date`	string	ISO 8601 date when a paused subscription will auto-resume
↳ `product_plan_identifier`	string	Google Play base plan identifier (for products set up after Feb 2023)
↳ `entitlements`	object	Map of entitlement identifiers to entitlement objects
↳ `grant_date`	string	ISO 8601 grant date
↳ `expires_date`	string	ISO 8601 expiration date
↳ `product_identifier`	string	Product identifier
↳ `is_active`	boolean	Whether the entitlement is active
↳ `will_renew`	boolean	Whether the entitlement will renew
↳ `period_type`	string	Period type (normal, trial, intro, promotional)
↳ `purchase_date`	string	ISO 8601 date of the latest purchase or renewal
↳ `store`	string	Store the entitlement was granted from
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `non_subscriptions`	object	Map of non-subscription product identifiers to arrays of purchase objects

`revenuecat_refund_google_subscription`

Refund and optionally revoke a Google Play subscription (Google Play only)

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat secret API key (sk_...)
`appUserId`	string	Ja	The app user ID of the subscriber
`productId`	string	Ja	The Google Play product identifier of the subscription to refund

Ausgabe

Parameter	Typ	Beschreibung
`subscriber`	object	The updated subscriber object after refunding the Google subscription
↳ `first_seen`	string	ISO 8601 date when subscriber was first seen
↳ `original_app_user_id`	string	Original app user ID
↳ `original_purchase_date`	string	ISO 8601 date of original purchase
↳ `management_url`	string	URL for managing the subscriber subscriptions
↳ `subscriptions`	object	Map of product identifiers to subscription objects
↳ `store_transaction_id`	string	Store transaction identifier
↳ `original_transaction_id`	string	Original transaction identifier
↳ `purchase_date`	string	ISO 8601 purchase date
↳ `original_purchase_date`	string	ISO 8601 date of the original purchase
↳ `expires_date`	string	ISO 8601 expiration date
↳ `is_sandbox`	boolean	Whether this is a sandbox purchase
↳ `unsubscribe_detected_at`	string	ISO 8601 date when unsubscribe was detected
↳ `billing_issues_detected_at`	string	ISO 8601 date when billing issues were detected
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `ownership_type`	string	Ownership type (purchased, family_shared)
↳ `period_type`	string	Period type (normal, trial, intro, promotional, prepaid)
↳ `store`	string	Store the subscription was purchased from (app_store, play_store, stripe, etc.)
↳ `refunded_at`	string	ISO 8601 date when subscription was refunded
↳ `auto_resume_date`	string	ISO 8601 date when a paused subscription will auto-resume
↳ `product_plan_identifier`	string	Google Play base plan identifier (for products set up after Feb 2023)
↳ `entitlements`	object	Map of entitlement identifiers to entitlement objects
↳ `grant_date`	string	ISO 8601 grant date
↳ `expires_date`	string	ISO 8601 expiration date
↳ `product_identifier`	string	Product identifier
↳ `is_active`	boolean	Whether the entitlement is active
↳ `will_renew`	boolean	Whether the entitlement will renew
↳ `period_type`	string	Period type (normal, trial, intro, promotional)
↳ `purchase_date`	string	ISO 8601 date of the latest purchase or renewal
↳ `store`	string	Store the entitlement was granted from
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `non_subscriptions`	object	Map of non-subscription product identifiers to arrays of purchase objects

`revenuecat_revoke_google_subscription`

Immediately revoke access to a Google Play subscription and issue a refund (Google Play only)

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	RevenueCat secret API key (sk_...)
`appUserId`	string	Ja	The app user ID of the subscriber
`productId`	string	Ja	The Google Play product identifier of the subscription to revoke

Ausgabe

Parameter	Typ	Beschreibung
`subscriber`	object	The updated subscriber object after revoking the Google subscription
↳ `first_seen`	string	ISO 8601 date when subscriber was first seen
↳ `original_app_user_id`	string	Original app user ID
↳ `original_purchase_date`	string	ISO 8601 date of original purchase
↳ `management_url`	string	URL for managing the subscriber subscriptions
↳ `subscriptions`	object	Map of product identifiers to subscription objects
↳ `store_transaction_id`	string	Store transaction identifier
↳ `original_transaction_id`	string	Original transaction identifier
↳ `purchase_date`	string	ISO 8601 purchase date
↳ `original_purchase_date`	string	ISO 8601 date of the original purchase
↳ `expires_date`	string	ISO 8601 expiration date
↳ `is_sandbox`	boolean	Whether this is a sandbox purchase
↳ `unsubscribe_detected_at`	string	ISO 8601 date when unsubscribe was detected
↳ `billing_issues_detected_at`	string	ISO 8601 date when billing issues were detected
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `ownership_type`	string	Ownership type (purchased, family_shared)
↳ `period_type`	string	Period type (normal, trial, intro, promotional, prepaid)
↳ `store`	string	Store the subscription was purchased from (app_store, play_store, stripe, etc.)
↳ `refunded_at`	string	ISO 8601 date when subscription was refunded
↳ `auto_resume_date`	string	ISO 8601 date when a paused subscription will auto-resume
↳ `product_plan_identifier`	string	Google Play base plan identifier (for products set up after Feb 2023)
↳ `entitlements`	object	Map of entitlement identifiers to entitlement objects
↳ `grant_date`	string	ISO 8601 grant date
↳ `expires_date`	string	ISO 8601 expiration date
↳ `product_identifier`	string	Product identifier
↳ `is_active`	boolean	Whether the entitlement is active
↳ `will_renew`	boolean	Whether the entitlement will renew
↳ `period_type`	string	Period type (normal, trial, intro, promotional)
↳ `purchase_date`	string	ISO 8601 date of the latest purchase or renewal
↳ `store`	string	Store the entitlement was granted from
↳ `grace_period_expires_date`	string	ISO 8601 grace period expiration date
↳ `non_subscriptions`	object	Map of non-subscription product identifiers to arrays of purchase objects

RevenueCat

On this page