Payment Integration

Payment integration enables secure online payment processing by connecting Conga with Stripe. It supports configuring API keys, webhooks, allowed payment methods, and storing secrets, allowing both logged-in and guest users to initiate and complete payments seamlessly.

Configuring Stripe Payment Integration

Stripe is a third-party payment processing platform that enables businesses to accept and manage online payments securely. It supports multiple payment methods, handles payment authorization and status events, and provides APIs and webhooks for seamless system integration.

You can configure Stripe and integrate it with Conga to enable secure payment processing. This task guides you through setting up Stripe API keys, webhooks, allowed payment methods, and storing required secrets using the Conga integration framework.

Prerequisite:

Access to the Stripe Dashboard.
A tenant-specific Stripe account is available.
An Integration User is created for each tenant in Conga.
Access to the Conga Secret Management API.

Create a Tenant-Specific Stripe Account.
1. Navigate to the Stripe sign-up page.
2. Create a new Stripe account for your tenant.
3. Complete the self registration process.
Retrieve Stripe API Keys.
1. Log in to the Stripe Dashboard.
2. Navigate to the API keys section.
3. Copy the Publishable Key and Secret Key.
Configure the Stripe Webhook.
1. Navigate to the Stripe Webhooks configuration page.
2. Click Add Destination.
3. On the destination setup page, select Your account and API version.
4. Scroll to the Payment Intent section to select Payment Intent Events.
5. Select the following events:
  - payment_intent.succeeded
  - payment_intent.payment_failed
  - payment_intent.canceled
6. Click Continue.
7. To configure Webhook Endpoint, click Webhook Endpoint and then click Continue.
8. Configure the destination details as follows:
  - Destination Name: Enter a name of your choice (for example, ABC Webhook).
  - Endpoint URL: api/integrations/v1/stripewebhook/stripe-response?key={{integrationUser-user-id}},{{integrationUser-org-friendly-id}},{{integrationUser-org-id}}
  Note:
  You must create one integration user per tenant
  You must replace the placeholders with actual integration user values:
  integrationUser-user-id Integration User User ID
  integrationUser-org-friendly-id Integration User Organization Friendly ID
  integrationUser-org-id Integration User Organization ID
Click Create Destination.
Note: After you create the webhook, the system displays the Webhook Landing Page. On the right side, note the Signing Secret (Webhook Secret Key). Without this key, communication with the Conga webhook endpoint fails.
Configure Allowed Payment Methods.
1. Navigate to Settings > Payment.
2. Enable the payment methods required for your business, such as Cards, Amazon Pay, ACH Direct Debit.
Configure Integration Connectors in Conga. During Conga customer on boarding, configure Stripe secrets using the Secret Management API.
Note: The UI for managing secrets is not currently available. Use the API as a temporary workaround.
Store Stripe Secrets Using the API.
1. Open the Secret Management API Swagger.
2. Under the Secret Store category, use the POST /api/secret-management/v1/secret.
  Sample Payload
```
{
  "SecretName": "StripeSettings",
  "SecretValue": "{\"PublishableKey\":\"pk_test_PublishableKey\",\"SecretKey\":\"sk_test_SecretKey\",\"WebhookSecret\":\"whsec_WebhookSecret\",\"ABC\":\"XYZ\"}",
  "Description": "Stripe payment webhook dev settings",
  "Category": "External"
}
```
3. Replace placeholders.
  - pk_test_PublishableKey - Stripe account Publishable Key
  - sk_test_SecretKey - Stripe account Secret Key
  - whsec_WebhookSecret - Stripe Webhook Signing Secret
Click Execute to save the Stripe configuration

The Stripe integration is configured and ready for use with Conga.

Guest User Payment Integration

Guest users can initiate and complete payments without logging in. Administrators must configure allowed routes via the Get a configuration API.

Category - guestuser

Name - allowedroutes

Endpoint:

{\"Route\":\"/api/integrations/v1/payment/initialize\",\"Method\":\"POST\"},{\"Route\":\"/api/integrations/v1/stripewebhook/stripe-response\",\"Method\":\"POST\"},{\"Route\":\"/api/integrations/v1/payment/metadata\",\"Method\":\"GET\"}

Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

Payment Integration

Configuring Stripe Payment Integration

Guest User Payment Integration

Footer Section

Explore