Setup your account

Everything in the Wajub API requires an API key. This page walks you through creating your account and finding your keys so you can start making API calls right away.

1. Create your account

Go to dashboard.wajub.com and sign up with your email address. No credit card required — your account starts in sandbox mode, where you can test freely with no real money involved.

2. Find your API keys

Once logged in:

1. Click Developers in the left sidebar.
2. Select API Keys.

You will see two sets of keys:

3. Copy your keys into your environment

Create a .env file in your project root:

# Wajub sandbox keys
WAJUB_PUBLIC_KEY=pk_test.xxxxxxxxxxxxxxxx
WAJUB_SECRET_KEY=sk_test.xxxxxxxxxxxxxxxx

# Webhook signing secret (found in Konsole → Webhooks → Endpoints)
WAJUB_WEBHOOK_SECRET=whsec_test_xxxxxxxxxxxxxxxx

Load them in your application:

import { Wajub } from '@wajub/node';

const wajub = new Wajub({ privateKey: process.env.WAJUB_SECRET_KEY! });

4. Get your webhook signing secret

The webhook secret is separate from the API keys. To find it:

1. Open Developers → Webhooks (or Konsole → Webhooks).
2. Click Add Endpoint and enter your endpoint URL (e.g. https://yourapp.com/webhooks/wajub).
3. After saving, click the endpoint row and copy the Signing Secret (whsec_…).

Add it to your .env as WAJUB_WEBHOOK_SECRET. You will need it to verify webhook signatures.

5. Switch to production when ready

When you are ready to accept real payments:

1. Complete identity verification in Dashboard → Compliance (see Account activation & KYC).
2. Once approved, your live keys (pk.… and sk.…) become available in Developers → API Keys.
3. Replace the _test keys in your environment variables and update your webhook endpoints.

See the full Going Live checklist.