Skip to main content
The fastest way to implement Halliday Payments is by utilizing the widget user interface.

​
Try the Halliday Payments SDK Widget

Following this guide, or the Widget Documentation guide will result in an onramp expeirence like the following. Try out onramping to an external wallet with this button:

​
Integrate Halliday Payments

Follow these steps to integrate Halliday Payments in just a few minutes.
1

Obtain API Keys

To get set up with API access for Halliday Payments, please reach out to [email protected].
2

Integrate

First, install the Halliday Payments SDK into a web project.
  • npm
  • yarn
  • HTML
copy
npm install @halliday-sdk/payments
Next, integrate Halliday Payments into an existing application with a few lines of code. This example is in a React.js project.
  • React
  • HTML
copy
import { openHallidayPayments } from "@halliday-sdk/payments";

// openHallidayPayments will open a popup that begins the payments flow.
// Customize the button to match a DApp's existing styles.

<button
    onClick={() => {
        openHallidayPayments({
            apiKey: HALLIDAY_PUBLIC_API_KEY,
            // USDC on Base
            outputs: ["base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"],
            // windowType can also be "POPUP" or "EMBED"
            windowType: "MODAL",
        });
    }}
>
    Pay with Halliday
</button>
Run the app page and try onramping or swapping tokens with the newly implemented Halliday Payments Payments Widget. Try it now using the button above.