Skip to main content

Partner Dashboard

The Partner Dashboard is your central hub for managing your NowRamp integration. Access analytics, manage API keys, configure webhooks, customize your widget, and test your integration.

Getting Started

Accessing the Dashboard

  1. You’ll receive login credentials from the NowRamp team
  2. Navigate to your dashboard URL (provided during onboarding)
  3. Sign in with your email and password
Your session automatically refreshes. If you’re inactive for an extended period, you’ll be prompted to sign in again.

Dashboard Overview

The main dashboard provides at-a-glance metrics for your integration:

Key Metrics

MetricDescription
Total OrdersNumber of orders processed this month
Total VolumeTotal USD value of transactions
CustomersUnique customers who completed orders
Success RatePercentage of successful orders
Each metric shows month-over-month comparison to help you track growth.

Charts

  • Orders Over Time - Daily order volume trend
  • Status Breakdown - Distribution of order statuses (completed, pending, failed)

Recent Orders

Quick view of the latest orders with:
  • Order ID
  • Customer ID
  • Amount and currency
  • Status
  • Timestamp

Order History

View and search your complete order history.

Filtering Orders

FilterOptions
SearchOrder ID, Customer ID, or crypto currency
StatusCompleted, Pending, Processing, Failed
Date RangeCustom date selection

Order Details

Click any order to view:
  • Order Information
    • Order ID (click to copy)
    • Status with timestamp
    • Creation and completion dates
  • Transaction Details
    • Fiat amount and currency
    • Crypto amount and currency
    • Exchange rate at time of order
  • Customer & Wallet
    • Customer ID
    • Destination wallet address
    • Transaction hash (with blockchain explorer link)
Click the transaction hash to view the transaction on the blockchain explorer.

API Key Management

Manage your API keys directly from the dashboard. No API calls required.

Key Types

TypePrefixUse Case
Secret Keysk_Backend server integration
Public Keypk_Frontend/widget initialization
Never expose secret keys in client-side code. Use public keys (pk_) for frontend integrations.

Creating a Key

  1. Navigate to API Keys in the sidebar
  2. Click Create API Key
  3. Enter a name (e.g., “Production Backend”)
  4. Select key type (Secret or Public)
  5. Choose permissions (Read/Write for each resource)
  6. Click Create
The full API key is shown only once at creation. Copy and store it securely.

Managing Keys

ActionDescription
ToggleTemporarily enable/disable a key
RotateGenerate a new key (old key remains valid briefly)
RevokePermanently deactivate a key

Permissions

Configure granular access for each key:
ResourceReadWrite
QuotesGet quotesCreate quotes
OrdersView ordersCreate orders
CustomersView customer dataCreate/update customers
WebhooksView webhook configManage webhooks

Webhook Configuration

Set up callbacks to receive real-time event notifications.

Setting Your Endpoint

  1. Navigate to Webhooks in the sidebar
  2. Enter your webhook endpoint URL
  3. Click Save
https://yourapp.com/webhooks/nowramp

Webhook Signing Key

A signing key is automatically generated for signature verification:
  1. View your signing key in the Webhooks page
  2. Use it to verify incoming webhook requests
  3. Click Rotate to generate a new key if needed
See the Callback URLs Guide for signature verification code examples.

Subscribed Events

Your endpoint receives these events:
EventDescription
order.createdNew order initiated
order.completedOrder successfully completed
order.failedOrder failed
kyc.approvedCustomer KYC approved
kyc.rejectedCustomer KYC rejected
payment.receivedPayment confirmed

Delivery Monitoring

Track webhook deliveries in real-time:
  • Status: Delivered (green), Failed (red), Pending (yellow)
  • Response Code: HTTP status from your server
  • Attempts: Number of delivery attempts
  • Timestamp: When the webhook was sent

Retrying Failed Deliveries

If a webhook fails:
  1. Find the failed delivery in the list
  2. Review the error message
  3. Fix any issues with your endpoint
  4. Click Retry to resend

Widget Theming

Customize the widget to match your brand.

Branding

SettingDescription
Company NameDisplayed in the widget header
LogoYour company logo (light & dark versions)

Colors

Customize the color palette:
  • Primary - Main action buttons
  • Secondary - Secondary elements
  • Accent - Highlights and focus states
  • Background - Widget background
  • Card - Card backgrounds
  • Text - Text colors

Typography

  • Font Family - Choose from Inter, Roboto, Open Sans, and more
  • Button Radius - Rounded corners (0-24px)
  • Card Radius - Card corner radius (0-32px)

Preview

See your changes in real-time with the live preview panel.

Export/Import

  • Export - Download your theme as JSON
  • Import - Load a previously exported theme
  • Reset - Restore default theme settings

Widget Sandbox

Test your widget integration before going live.

Configuration

SettingDescription
Flow TypeBuy or Sell crypto
ThemeLight or Dark mode
Languageen, es, fr, de
AmountPre-fill amount
CurrenciesSource and destination currencies

Wallet Settings

  • Network - Select blockchain network (Sepolia, Amoy, etc.)
  • Address - Destination wallet address

Testing

  1. Configure your widget settings
  2. Click Launch Widget
  3. Walk through the complete flow
  4. Monitor events in the event log

Event Monitoring

The sandbox shows real-time events:
[10:30:15] WIDGET_READY
[10:30:18] STEP_CHANGE: amount → confirm
[10:30:25] ORDER_CREATED: order_abc123
[10:31:02] ORDER_COMPLETED
Use this to verify your event handling before production.

Best Practices

API Keys

  1. Use separate keys for development and production
  2. Rotate keys periodically (every 90 days recommended)
  3. Limit permissions to only what’s needed
  4. Monitor usage for unusual activity

Webhooks

  1. Respond quickly (return 2xx within 30 seconds)
  2. Verify signatures on all incoming webhooks
  3. Handle duplicates using event IDs
  4. Monitor failures and fix issues promptly

Widget Integration

  1. Test thoroughly in sandbox before production
  2. Handle all events including errors
  3. Use public keys only in frontend code
  4. Validate redirect URLs match your allowed list