For the complete documentation index, see llms.txt. This page is also available as Markdown.

Overview

Bring Your Own Wallet lets you accept cryptocurrency directly into an external wallet you already control. Paymento provides the checkout, receiving information, blockchain monitoring, confirmation tracking, and payment notifications, but it does not possess the private keys needed to move your funds.

Because payments arrive directly in your wallet, there is no settlement step.

How it works

The wallet information Paymento needs depends on the blockchain architecture:

  • For supported UTXO-based networks, such as Bitcoin, Litecoin, Dogecoin, and Bitcoin Cash, you provide an extended public key, or xPub. Paymento uses it to derive receiving addresses for individual payments.

  • For supported account-based networks, such as Ethereum, Solana, and Tron, you provide a public wallet address or connect a compatible wallet during store configuration.

An xPub or public address can be used to view or derive public receiving information. It cannot be used to sign transactions or spend funds.

Paymento never asks for your external wallet's:

  • Private key

  • Recovery or seed phrase

  • Wallet password

  • Hardware-wallet PIN

  • Signing credential

Two ways to configure your wallet

Use an existing wallet

Choose this option when your current wallet exposes the compatible xPub or public address required by Paymento.

This is the preferred Bring Your Own Wallet setup when you already use a wallet that you trust and have backed up.

See Use an Existing Wallet.

Generate a Dedicated Payment Wallet

Some mobile wallets do not display xPubs. If you want to continue using a compatible mobile wallet, Paymento can generate a new recovery phrase locally on your device and derive the public information required for your store, so you won't need to import public keys and addresses into Paymento anymore!

Just import the recovery phrase into a compatible wallet and keep the phrase as your private backup. Paymento stores the required public wallet information, not the recovery phrase.

This creates a separate wallet dedicated to business payments, rather than connecting your personal wallet.

See Generate a Dedicated Payment Wallet.

Where payments arrive

Payments arrive directly at addresses associated with the external wallet you configured. Paymento does not receive the payment into a Paymento-controlled wallet and does not forward it afterward.

This means:

  • No Paymento settlement is required.

  • You can access received funds using your external wallet.

  • You are responsible for sending refunds.

  • You are responsible for wallet security, backup, and recovery.

Customer checkout experience

The checkout experience varies by network.

UTXO-based networks

For supported UTXO-based assets, Paymento displays a receiving address, amount, and QR code. Customers can pay from a compatible wallet and, where supported by the sender, from an exchange account.

Account-based networks

Bring Your Own Wallet stores generally require customers to connect a compatible wallet when paying on supported account-based networks. This allows Paymento to associate the transaction with the correct payment request.

Customers paying from an exchange account, custodial application, or wallet that cannot connect may be unable to complete these payments.

If address-and-QR checkout on supported account-based networks is important to your business, consider Paymento Embedded Wallet

Merchant responsibilities

With Bring Your Own Wallet, you are responsible for:

  • Choosing a compatible wallet

  • Protecting private keys and recovery phrases

  • Maintaining a tested wallet backup

  • Providing the correct xPub or public address

  • Confirming that derived addresses are discoverable by your wallet

  • Verifying network and token compatibility

  • Sending refunds from your wallet

  • Completing a test payment before accepting live funds

Paymento cannot recover your external wallet because it never receives its private keys or recovery credentials.

When to choose Bring Your Own Wallet

Bring Your Own Wallet is a good fit when:

  • You already manage a wallet you trust.

  • You want funds to arrive directly in that wallet.

  • You do not want a settlement step.

  • Your customers can use connected-wallet checkout when required.

  • You need an asset not currently supported by Embedded Wallet.

  • You prefer the lower standard Paymento fee for this wallet method.

Use Embedded Wallet instead when you want Paymento to handle more of the wallet infrastructure or want address-and-QR checkout on supported account-based networks.

Before accepting live payments

Complete these checks for every configured asset:

  1. Confirm that the network and address type are correct.

  2. Verify that your wallet recognizes the configured account.

  3. Complete a testnet or small-value payment.

  4. Confirm that the payment appears in your external wallet.

  5. Confirm that you can spend from the receiving address.

  6. Verify that your backup and recovery process works.

  7. Enable the asset for live payments only after testing succeeds.

Last updated