هذه الصفحة متاحة بالإنجليزية فقط حاليًا.

Stripe Checkout

Stripe for international card payments, and the webhook it needs.

What you need

Stripe Dashboard → Developers → API keys:

  • publishable_key (pk_…)
  • secret_key (sk_…)

Then Developers → Webhooks → Add endpoint:

  • Endpoint URL: https://<your-panel-domain>/payments/stripe_checkout/callback
  • Event to listen for: checkout.session.completed

Enter the resulting Signing secret (whsec_…) as webhook_secret.

In your panel choose Settings → Payments → Add method → Stripe Checkout and save the three values.

Flow

  1. The customer enters an amount and picks Stripe.
  2. They are sent to Stripe's hosted payment page.
  3. After paying they return to the panel; the balance is credited when the webhook arrives. The return page does not complete the payment, without the webhook nothing is credited.
  4. A second notification for the same session is ignored.

Common problems

  • Balance not credited: the webhook endpoint points at the wrong domain or the event is not selected. Check recent deliveries under Stripe Dashboard → Webhooks; they must return 200.
  • Testing with a test card: enter test keys (pk_test / sk_test) and create the webhook in test mode; live and test webhooks are separate.