Connect your Paystack account

Paste your Paystack secret key (and optional public key), activate it, and point Paystack's webhook at ValidBridge.

Admins

Before you start

A Paystack business account (create one at dashboard.paystack.com), activated for live payments when you are ready to charge real money.
The Admin role in your ValidBridge organization.

1. Copy your keys from Paystack

In the Paystack Dashboard, open Settings → API Keys & Webhooks. Copy the secret key (starts with sk_live_ or sk_test_) and, optionally, the public key (pk_live_ / pk_test_).

2. Paste them into ValidBridge

In the dashboard, go to Payments → Configuration.
On the Paystack card, click Connect.
Paste the Secret key and, if you like, the Public key.
Click Save & Activate. The card shows Connected.

3. Set the webhook URL in Paystack

This step is essential: ValidBridge unlocks a course when Paystack tells it a payment succeeded. In the same Paystack settings page, set the Webhook URL to your ValidBridge API address followed by /api/v1/payments/paystack/webhook — the Configuration page shows the path. Paystack signs each notification with your secret key and ValidBridge rejects anything it cannot verify.

No webhook, no access

If the webhook is missing or wrong, learners are charged but their course stays locked. If you are not sure of your API address, contact support before going live.

Test first

Use your sk_test_ key to try the whole flow with Paystack's test cards, then click Update keys and switch to your live key (and the live webhook URL) when you are ready.

Updating or removing keys

Update keys replaces the stored keys, for example after rotating them in Paystack.
Remove disconnects Paystack and disables payments for the organization.

Your keys are protected

The secret key is encrypted before it is stored, is only used by the ValidBridge server to talk to Paystack, and is never shown to learners.

Was this article helpful?