§ 03 / Docs

Payment settings

Connect payment credentials so customers can checkout on your storefront. This project integrates with Paymob — you supply API keys and related IDs from your Paymob dashboard so the platform can create payment sessions and record paid orders.

Why this matters

Without valid payment settings, checkout may fail or orders stay pending forever. Configure this page before marketing your store publicly. Use test keys in sandbox mode before switching to live credentials.

Layout

Shopper checkout
----------------
Storefront cart --> Paymob session --> Payment
                         ^
                         |
              Keys from this settings page

Required credentials

Fields map to your Paymob merchant account — typically API key, integration IDs, and iframe or wallet identifiers depending on enabled methods. Copy values exactly from the Paymob dashboard; trailing spaces cause authentication errors.

Steps

Log into Paymob and open API / integration settings.
Copy each value into the matching field on this page.
Save settings.
Place a small test order on your storefront to verify paid status flows into Orders.

Security practices

Never share secret keys in chat or email. Rotate keys if exposed. Use environment-appropriate keys — test keys for staging, live keys only on production stores. After rotation, update this page immediately to avoid downtime.

Troubleshooting

If checkout loads but payment never completes, verify integration ID matches the payment method enabled in Paymob. If orders stay pending, confirm webhooks or return URLs are configured per platform documentation. Include shop ID when requesting support.

Back to all docs