stmpr Knowledge base

Stripe integration

Prerequisites, setup, field mapping, testing, and troubleshooting for the Stripe connection.

Use the Stripe integration to award or reverse purchase-based stamps.

Data flows from the provider into stmpr.

Connecting the account does not activate a workflow by itself. Select the loyalty card, trigger, destination action, and customer matching rule separately.

Stripe · Workbench
https://stmpr.io/dashboard/integrations
stmpr: configure the Stripe connection and workflow
stmpr: configure the Stripe connection and workflow

Why use this?

Replace manual data transfers with a verified and observable workflow.

Idempotency prevents duplicate rewards, while consent gates protect marketing data transfers.

Workflow
  1. 1A verified successful payment or refund
  2. 2Authentication, duplicate protection, and customer matching
  3. 3Award or reverse purchase-based stamps

Step by step

  1. Prepare a restricted Stripe API key and webhook management access.
  2. Create the required API, OAuth, or webhook access in Stripe with the narrowest practical permissions.
  3. In stmpr, open Developers → Integrations and choose Connect.
  4. Select the loyalty card, trigger event, and destination action.
  5. Configure customer matching. Prefer email or phone; use a provider ID only as a stable secondary key.
  6. Run a test with a test customer, then deliver the same event again to verify duplicate protection.
  7. Test failed delivery, revoked access, a missing customer, cancellation or refund, and consent withdrawal.
  8. After activation, monitor the first live events. To disconnect safely, disable the workflow before revoking provider access.

What you select and verify

  • Trigger: a verified successful payment or refund
  • Action: award or reverse purchase-based stamps
  • Loyalty card, business, or location
  • Customer matching and required fields
  • Consent, refund, cancellation, and no-show rules
  • Test data, duplicate protection, and delivery log
Free plan available

Launch your first
digital loyalty card.

Create your first Apple and Google Wallet-based loyalty card and try stmpr free.

Try it free
No credit card required Free plan for small businesses For small businesses and multi-location companies