Connect RevenueCat and every in-app purchase, renewal and refund on iOS, Android and the web reaches the program, credited to the partner whose link or code brought the customer.
Add a webhook integration
- Open the program, Setup, Billing, RevenueCat. Bolt Claw makes an Authorization header value and shows it once: copy it now. Copy the endpoint URL too.
- In RevenueCat: Project settings, Integrations, Webhooks. Paste the URL, and the header value as the Authorization header.
- Recommended: turn on RevenueCat's webhook signing and paste its signing secret on the card. The header value alone proves who sent a request, but not what it said; with the secret, every delivery's body is checked too, within five minutes.
Lost the header value? Make new ones on the card replaces it; the old one stops working at once, so paste the new one into RevenueCat straight away.
Pass the referral
Set subscriber attributes before the purchase. RevenueCat sends them with every event.
Purchases.shared.attribution.setAttributes([
"boltclaw_ref": ref,
"boltclaw_customer_id": "acme-user-10442",
])
The customer is your own id from the attributes, else RevenueCat's original
app user id. INITIAL_PURCHASE and NON_RENEWING_PURCHASE are sales, RENEWAL
is a renewal, and TEST events are ignored.
Refunds
RevenueCat reports a refund as a CANCELLATION for customer support with a
negative price: it takes back that share of the commission. There is no dispute
event.
Offer codes
An offer code arrives as its text, so a purchase made with a partner's code is credited to them.
Test mode
RevenueCat says whether each event is from the sandbox or production; a sandbox purchase is recorded as test data.
Check it works
On the program's Setup tab, the Billing row of the setup status turns
Connected with the first verified event, and says when a delivery was refused
(nearly always the wrong secret). Then press Send a test sale to see a
click, a signup, a sale and a refund go through your rules with test data, or
make a real test purchase with a sandbox account. See Connect your billing system
for the whole setup status and what test data never does.