Configure payment providers

Last updated

Connect and configure payment providers for your platform. BrainsMingle Suite supports Stripe and Paymob — set up credentials, register webhooks, and activate each provider to start accepting payments.

Open the Payment Providers page

  1. Open the Admin Panel.
  2. Click Payment Providers in the left sidebar.

The Payment Providers page displays a configuration card for each supported provider. Secret values are hidden — leave a secret field blank to keep its stored value.

The Payment Providers page showing configuration cards for Stripe and Paymob gateways, each with an Active checkbox, Title field, Webhook URL with copy button, required webhook events, and credential fields for API keys and secrets
The Payment Providers page with Stripe and Paymob gateway configuration cards

Configure Stripe

  1. Check the Active checkbox in the top-right corner of the Stripe card to enable it.

  2. Fill in the credentials:

    • secret_key — your Stripe secret key. This field is hidden once saved.
    • webhook_secret — the signing secret from your Stripe webhook endpoint (starts with whsec_). This field is hidden once saved.
    • publishable_key — your Stripe publishable key.
  3. Copy the Webhook URL shown on the card and register it in your Stripe dashboard. This URL receives payment confirmations back to your platform.

  4. In your Stripe webhook settings, subscribe to the required events listed on the card:

    • invoice.paid
    • invoice.payment_failed
    • customer.subscription.updated
    • customer.subscription.deleted
    • checkout.session.completed
    • checkout.session.async_payment_succeeded
  5. Paste the endpoint's signing secret (whsec_...) into the webhook_secret credential field.

  6. Click Save to apply.

The Stripe configuration card showing the Active checkbox, Title field, Webhook URL with a copy button, list of six required webhook events, and credential fields for secret_key, webhook_secret, and publishable_key
The Stripe provider card with webhook URL, required events, and credential fields

Configure Paymob

  1. Check the Active checkbox in the top-right corner of the Paymob card to enable it.

  2. Fill in the credentials:

    • api_key — your Paymob API key. This field is hidden once saved.
    • public_key — your Paymob public key.
    • secret_key — your Paymob secret key. This field is hidden once saved.
    • hmac — the HMAC secret for verifying webhook signatures. This field is hidden once saved.
    • base_url — the Paymob API base URL.
    • integration_id — your Paymob integration ID for card payments.
    • moto_integration_id — your Paymob MOTO integration ID.
    • iframe_id — the Paymob iframe ID for the payment form.
    • apple_pay_integration_id — your Apple Pay integration ID (if applicable).
    • currency — the payment currency code (e.g. EGP, USD).
  3. Copy the Transaction webhook (callback) URL and register it in your Paymob dashboard as the transaction processed/response callback. The subscription webhook is attached automatically when plans are created.

  4. Click Save to apply.

The Paymob configuration card showing the Active checkbox, Title field, Transaction webhook callback URL, and credential fields for api_key, public_key, secret_key, hmac, base_url, integration_id, moto_integration_id, iframe_id, apple_pay_integration_id, and currency
The Paymob provider card with webhook URL and credential fields

Related articles