Documentation

Quickstart

Create keys, run a test checkout, and prep for launch.

Requirements

  • Node.js 18+ and npm are required for local tooling.
  • Generate sandbox API keys from your Stafiel dashboard.
  • Choose a public HTTPS URL for webhook testing.

Configure your environment

Store API keys and webhook secrets in your local environment.

STAFIEL_API_KEY=sk_test_123
STAFIEL_WEBHOOK_SECRET=whsec_123
STAFIEL_ENV=sandbox

Run your first checkout

  1. Create a hosted checkout session.
  2. Open the session URL in a browser to complete a test payment.
  3. Confirm the session status in the dashboard.

Use the Hosted Checkout guide for the request payload and redirect flow.

Connect webhooks

Register your webhook endpoint and verify signatures before processing events.

Follow the Webhooks guide to validate signatures and handle retries.

Go-live checklist

  • Rotate API keys and webhook secrets.
  • Review the Security model.
  • Confirm support escalation paths in Support.
Previous Overview Next Hosted Checkout