Stripe
Troubleshooting
Limits of the connector, common symptoms, and short answers.
Limits#
| Limit | Value |
|---|---|
| Connections per tenant | 1 |
| History available | About 30 days, set by Stripe's Events API |
| Signature tolerance | 5 minutes |
| Polling interval | About 5 minutes, stretching to 1 hour when quiet |
| Page size when polling | 100 events |
Values can change
These are the defaults today. They live in configuration, not in your contract, so treat them as guidance.
Symptoms#
| You see | Likely cause | What to do |
|---|---|---|
| No events at all | The connection is not ACTIVE, or the account id does not match | Check the state, then confirm the acct_ id |
| Polled events arrive but webhook events do not | No webhook endpoint exists yet, or it is disabled | Wait for the next endpoint check, about 30 minutes, or ask Verlix to look |
Deliveries answered 202 | Bad signature, unknown connection, or an event from another account | Verify the signing secret is current. A rotated secret must be passed to Verlix |
Deliveries answered 429 | Verlix is limiting this tenant or source | Nothing. Stripe retries using Retry-After |
| Events older than about a month are missing | Stripe no longer serves them through its Events API | These cannot be recovered through this connector |
| The same event appears twice | A webhook retry or a polling overlap | Deduplicate on the Stripe event id |
| Events out of order | Delivery order is not guaranteed | Order by the event's created time, not by arrival |
| Nothing after an outage | Polling was suspended after repeated failures | It resumes on its own after 10, 30, then 60 minutes |
Short answers#
Does Verlix change my Stripe data? No. It reads events, and it manages one thing on your account: its own webhook endpoint.
Can I link two Stripe accounts to one tenant? No. One tenant holds one Stripe connection.
Does Verlix collect payments through Stripe? No. This connector receives events. It does not charge anyone.
Are amounts altered on the way in?
No. The body is stored exactly as Stripe sent it, so a value such as 1.10 is kept as written.
Can I replay old events? Not from this connector. Deliveries that could not be placed are kept unaltered for review, but there is no self-service replay.
Something looks wrong and none of this helps. Contact the Verlix team with your tenant name, the approximate time, and the Stripe event id. Do not send the delivery URL or any secret.