The Plug - Swish Docs

The Plug is a drop-in widget that lets your users pay you privately in USDC or SOL — without you building any wallet, routing, or privacy logic. Add a button, get paid privately.

Non-custodial — Swish never holds funds. The payer pays from their own wallet.
No fees from Swish — the payer covers only the underlying privacy-protocol fee (see Fees).
No web3 to bundle — the package ships no Solana or wallet dependencies.

Try it live

Configure a Plug, click the real button, and copy the snippet in the interactive playground.

Install

Use the React component, or drop in the vanilla script — no build step needed.

npm i @swishdotcash/plug

<script src="https://plug.swish.cash/plug.js"></script>

Quickstart

import { Plug } from "@swishdotcash/plug";

<Plug
  recipient="RECIPIENT_SOLANA_ADDRESS"
  amount={25}
  reference="order_1234"
  onSuccess={(sig, ref) => markOrderPaid(ref)}
/>

<script src="https://plug.swish.cash/plug.js"></script>

<button onclick="Plug.open({
    recipient: 'RECIPIENT_SOLANA_ADDRESS',
    amount: 25,
    reference: 'order_1234',
    onSuccess: function (sig, ref) { markOrderPaid(ref); },
})">
  Deposit Privately
</button>

Both render a button that opens the Swish widget in a modal, where the payer connects a wallet and pays. When the payment confirms, onSuccess fires with the transaction signature and your reference.

The React <Plug /> ships its own branded button. With the script tag, call Plug.open(opts) from any button’s click handler (as above), or use Plug.mount("#selector", opts) to inject the branded button into an element.

Options

Every option is optional — open the Plug with none of them and the payer enters the recipient and amount themselves. In practice you’ll usually set recipient (so funds come to you), and most integrations also set amount, reference, and onSuccess.

Option	Type	Required	Description
`recipient`	`string`	Optional	Destination Solana address. Omit to let the payer enter it. (v1 takes a raw address only.)
`amount`	`number`	Optional	Amount in `token` units. If set, the amount field is locked; omit to let the payer type it.
`token`	`"USDC" \| "SOL"`	Optional	Token to pay in. Set `"USDC"` or `"SOL"` to lock the asset; omit to let the payer pick between them in the widget (defaults to USDC).
`reference`	`string`	Optional	Your order/correlation id. Never read or stored — echoed back untouched in `onSuccess` so you can match the payment to your order.
`label`	`string`	Optional	Override the button text. Defaults to “Deposit Privately”.
`compact`	`boolean`	Optional	Force the compact “Deposit” label. Auto-shrinks when the button is cramped.
`onSuccess`	`(txSignature, reference?) => void`	Optional	Fires when a payment confirms.
`onError`	`(message) => void`	Optional	Fires when a payment fails (the widget stays open for retry).
`onClose`	`() => void`	Optional	Fires when the payer dismisses the widget.

React-only extras: children (a custom trigger element that replaces the default button), plus className and style for the wrapper.

Custom trigger (React)

Pass children to use your own button instead of the default:

<Plug recipient="RECIPIENT_SOLANA_ADDRESS" amount={25} onSuccess={(sig, ref) => markOrderPaid(ref)}>
  <button className="my-button">Pay $25 privately</button>
</Plug>

How routing works

The Plug routes each payment through the best available privacy protocol automatically (Auto), choosing between MagicBlock and Privacy Cash. The payer doesn’t pick a protocol. See Privacy Protocols for how each works.

The Plug is Pay-only and routes across MagicBlock and Privacy Cash. Umbra is not included. SOL payments route through Privacy Cash (MagicBlock is USDC-only), so a SOL payment is always a private Privacy Cash send.

What the payer needs

The payer brings their own funds — the amount in the chosen token (USDC or SOL) plus a small amount of SOL for gas. They connect a wallet inside the widget; nothing is required of them ahead of time.

Privacy Cash charges a fixed base fee (~

0.71-equivalent) plus 0.35%. On small **SOL** payments that fixed base is a large share of the total, so SOL suits larger amounts better than sub-

5 tips.

Try it live

​Install

​Quickstart

​Options

​Custom trigger (React)

​How routing works

​What the payer needs

Install

Quickstart

Options

Custom trigger (React)

How routing works

What the payer needs