Skip to main content
This guide walks you through setting up your Gnosis Ramp integration from scratch.

​
Prerequisites

​
Step 1: Create a Project

  1. Log in to the Gnosis Ramp Dashboard
  2. Click Create Project in the top navigation
  3. Enter a project name (e.g., “My App - Production”)
Create separate projects for different environments. For sandbox testing, create a project and configure providers with their sandbox credentials.

​
Step 2: Connect a Ramp Provider

  1. Go to Ramp Providers in the sidebar
  2. Browse available providers (Banxa, Bridge, Noah, etc.)
  3. Click Connect on your chosen provider
  4. Configure the provider:
FieldDescription
EnvironmentSelect Sandbox or Production from the dropdown
API KeyYour API key from the provider
Signing KeyYour signing private key in PEM format (for webhook verification)
  1. Click Save to complete the connection
Sandbox Testing: To test in sandbox mode, select “Sandbox” in the Environment dropdown and enter your provider’s sandbox credentials. There’s no separate sandbox URL — the same API endpoint handles both environments based on your provider configuration.

​
Step 3: Get API Keys

  1. Navigate to API & Webhooks in the sidebar
  2. Click Generate New Key
  3. Copy and securely store your:
    • Client ID — Used for Basic authentication
    • Client Secret — Keep this secret, never expose in client-side code
Your Client Secret is only shown once. Store it securely in your environment variables or secrets manager.

​
Step 4: Configure Webhooks

  1. In the API & Webhooks tab, scroll to the Webhooks section
  2. Enter your webhook endpoint URL
  3. Copy the generated signing secret for signature verification

​
Next Steps

Authentication

Learn how to authenticate your API requests.

Create a Customer

Set up your first customer for ramp operations.