Skip to main content
Welcome to the Nomad Pay Developer Documentation. This guide provides everything you need to integrate our multi-chain, multi-currency payment solutions into your platform.

​
Platform Overview

Nomad Pay provides merchants with a global cryptocurrency payment service, supporting direct wallet payments, automatic token conversion, and a seamless checkout experience. We offer three primary ways to integrate, from no-code to full developer control:

​
Integration Methods

This is the easiest way to start. You create a product and its settings directly in the Nomad Pay merchant dashboard and generate a shareable URL.
  1. Create Product: Add a product and set its price in your merchant dashboard.
  2. Generate Link: Generate a payment link for that product.
  3. Customer Pays: Your customer clicks the link, is taken to a Nomad Pay hosted checkout page, and completes the payment.
  4. Get Notified: The platform listens for the on-chain transaction and automatically sends a notification to your configured Webhook.

​
Method 2: Low-Code Widget

This method provides a seamless on-site experience, allowing you to embed our secure checkout component directly into your website.
  1. Embed Script: Add the Nomad Pay JavaScript snippet to your checkout page.
  2. Configure: Use simple HTML attributes or a JS object to configure the widget (e.g., setting the price, currency).
  3. Customer Pays: Your customer interacts with the widget on your site to select a token and pay.
  4. Get Notified: The platform handles the on-chain logic and sends a callback to your Webhook.

​
Method 3: Pro-Code API

This method provides maximum flexibility and is designed for developers to integrate directly with their backend systems.
  1. Get Keys: Create your API Key Pair (Public Key & Secret Key) in the merchant dashboard.
  2. Configure Webhook: Configure your Webhook URL in the merchant dashboard to receive notifications.
  3. Call API: Your server calls the POST /v1/payments endpoint to create a transaction. This request must be signed.
  4. Redirect Customer: You receive a payment_url in the response and redirect your customer to this URL.
  5. Get Notified: The platform listens for the on-chain transaction and sends a detailed callback to your Webhook URL. You must verify the signature of this callback.