Stripe Payment Gateway

Introduction

1. The admin portal does not currently support direct API key mapping. Clients must share their API keys and webhook details externally with our tech team for integration.

2. You must provide your Secret and Publishable Key to integrate your Stripe account with the Artha Job Board. Our tech team will use these keys to complete the integration.

3. If you already have these keys, please share them with us. If not, follow the steps below to generate the API keys and set up the webhook.

1. Sign in to your Stripe account.

2. In the left menu, click on Developers → API keys.

3. Under Standard Keys, you’ll see your Publishable Key.

4. To reveal your Secret Key, click the Reveal live key token button.

If your Secret Key is restricted, you will need to generate a Restricted Key with the necessary permissions. You need to follow these steps:

1. Generate a Restricted Key (If Needed)

2. Go to the Stripe Dashboard and navigate to Developers → API keys. Click Create Restricted Key.

3. Give your key a name (e.g., "Artha Job Board Restricted Key").

4. Select the necessary permissions based on your use case.

5. Common permissions for payment processing: checkout.sessions → Read & Write payment_intents → Read & Write events → Read. Click Create Key and securely store the key.

6. If your restricted key does not have the right permissions, some API calls may fail, so be sure to grant the right level of access.

Step 2: Setup Webhook

1. Log in to your Stripe dashboard.

2. Navigate to Developers → Webhooks in the left sidebar.

3. Click on the Add Endpoint button.

4. Select the following event and enter the respective webhook URL.

   1. Webhook URL for success https://subscriptions-payment.arthajobboard.com/api/v1/webhook/subscription/payment-intent/succeded Event: invoice.payment_succeeded

      
   2. Webhook URL for fail https://subscriptions-payment.arthajobboard.com/api/v1/webhook/subscription/payment-intent/failed Event: invoice.payment_failed

      
   3. Webhook URL for canceled https://subscriptions-payment.arthajobboard.com/api/v1/webhook/subscription/renewal/canceled Event: customer.subscription.deleted

      

Step 3: Retrieve Webhook Secret Key

1. After adding the endpoint, you’ll see it listed in your webhook settings.

2. Click on the newly created webhook endpoint.

3. Under Signing Secret, click Reveal.

1. Copy the Webhook Signing Secret. This will be used to verify events from Stripe.

Step 4: Integrate the Payment Gateway

You need to integrate the payment gateway by following the given steps: