All docsAgent access

Integrations

Stripe

Connect Stripe billing events to contacts and journeys.

Stripe is a first-class billing integration. Audryo verifies Stripe-Signature, maps the customer to a contact, records the billing event, and enrolls matching journeys immediately. You do not write a field map — the connector already knows the Stripe event catalog.

In the product: Data → Integrations → Stripe.

Generic inbound and outbound webhooks stay on the same Integrations page, in their own cards. Use those when the source is your app, not Stripe. See Webhooks.

What gets created

Stripe factWhat Audryo does
Customer id (cus_…)Stable externalId for the contact
Customer emailContact address, when Stripe sends one
Event typeProduct event name (customer.subscription.created, …)
Event idIdempotency key — retries do not double-enroll

A customer.subscription.created event enrolls any active journey whose event entry matches that name. Optionally subscribe the contact to a mailing list when a subscription is created or checkout completes.

Nothing is sent to the customer from this step. Journeys still need review and activation.

Handled events

  • customer.subscription.created / updated / deleted
  • customer.subscription.paused / resumed / trial_will_end
  • invoice.paid / invoice.payment_failed / invoice.finalized / invoice.upcoming
  • quote.created / quote.accepted / quote.canceled / quote.finalized
  • checkout.session.completed / checkout.session.expired

Connect Stripe

  1. In Audryo, open Data → Integrations → Stripe.
  2. In the Stripe Dashboard, add an

endpoint. You will paste Audryo’s URL after connect.

  1. Copy the endpoint signing secret (whsec_…) into Audryo and connect.
  2. Copy the Audryo endpoint URL back into the Stripe webhook.
  3. Send a test event from Stripe. Recent deliveries appear on the Stripe page.

The signing secret is never shown again after save. Replacing it keeps the previous secret valid for 24 hours.

Reference: createStripeConnector, getStripeConnector, receiveStripeEvent

The connector secret never appears in audit metadata or later API reads.

Create

curl -X POST "$AUDRYO_API_BASE/projects/$PROJECT_ID/stripe_connector" \
  -H "Authorization: Bearer $AUDRYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signingSecret": "whsec_...",
    "mailingListId": null
  }'

Stripe POSTs to POST /v1/projects/{projectId}/stripe_connector/events with Stripe-Signature. Audryo uses the Stripe event id for idempotency.

PreviousWebhooksNextZapier