Partner Portal

Dashboard, merchant list, and settings available in the partner portal.

Dashboard

The partner portal dashboard gives you an at-a-glance view of your payment activity. It includes three key metrics:

  • USDC volume (all-time) — the total USDC amount across all verified payments for every merchant under this partner.
  • USDC volume (30-day) — verified USDC volume for the last 30 calendar days, useful for spotting trends.
  • Merchant count — the number of merchants currently assigned to your partner, including active and disabled.
  • Conversion rate — the percentage of payment requests that received a verified proof, calculated asverified / total requests.
Use the 30-day volume alongside the conversion rate to identify whether merchants are creating requests that customers are not completing. A low conversion rate may indicate UX friction or incorrect amounts.

Merchants List

The Merchants page shows every merchant assigned to your partner. Each row displays:

  • Display name — the merchant's chosen business name.
  • Status — active or disabled. Disabled merchants cannot create new payment requests.
  • Contact — email and phone (if provided during onboarding).
  • Onboarding status — complete or incomplete. Merchants with incomplete onboarding have not finished their profile.

Click a merchant row to view their details, request history, and wallet address.

Settings

The Settings page lets you manage your partner configuration:

Webhook URL

Set the HTTPS endpoint where JoPay sends payment event notifications. You can also rotate the webhook secret from this page. See Webhooks for payload format and verification.

Brand Colors

Customize the primary and secondary brand colors that appear on the payment page, merchant dashboard, and invite flow. Colors are stored as hex values (e.g. #1a56db).

FX Rate

View and manually refresh the current fiat-per-USDC exchange rate for your partner's currency. The rate is used to convert fiat amounts to USDC on every payment request. See FX Rates for details on sources, caching, and staleness rules.

Changing the webhook URL takes effect immediately. Make sure your new endpoint is live and returning 2xx responses before updating.