Accepting supported crypto payments

Accept supported Solana token payments by setting up Crypto in Cedros Pay. You will choose a payment token, confirm where payments arrive, and test checkout with a compatible wallet.

For the wider payment setup, start with Getting started with payments in Cedros.

Before you begin

You need Cedros Pay installed and active, permission to manage payment settings, and a product customers can buy. Have your site administrator confirm the Solana network, payment token, and receiving wallet before you start.

Prepare a separate test site and a buyer wallet for that network. Solana's development and main networks are separate: test funds cannot pay for a purchase on the main network. See Solana networks.

The buyer needs the accepted token. The wallet paying network fees also needs SOL, even when the purchase itself is paid in another token. Your site can cover those fees if its wallet is set up and funded for this. See Solana transaction fees.

Confirm the network and receiving wallet

Ask your administrator to check the site's blockchain connection under Settings → Providers → Blockchain. The Crypto tab does not have its own network selector, so confirm the network before choosing a token or funding a test wallet.

In Pay hub → Crypto, review Payout wallet. This is a public Solana address; never enter a private key or recovery phrase.

If your site uses a managed treasury, payments go to the treasury's receiving address. The site's operational wallet handles transaction signing and fees. Ask your administrator to confirm the receiving address, then compare it with the destination in your test payment. Changing the Payout wallet field alone does not redirect a managed treasury's payments.

Turn on Crypto and choose a token

1. Open Extension Settings → Pay hub → Crypto.
2. Turn on Crypto to reveal its settings.
3. Review Payout wallet against the receiving address you confirmed with your administrator.
4. Under Payment token, select the token agreed for your site and network. If you need a custom token, follow the instructions below.
5. Wait for autosave to finish. Resolve any save error, then reopen the tab to confirm your settings.

A token's mint address identifies the token. Its name, symbol, and icon are not enough to establish that it is the token you intend to accept. Check the mint against the token issuer's information for the selected network. See Solana token basics.

For Custom, enter the verified Token mint address, Token symbol, Token icon URL, and Token decimals. Use the decimal count recorded for that mint; an incorrect value can change the amount requested from the buyer. A preset fills in its decimal count for you, but you should still confirm that its mint belongs to your intended network.

An accepted address format does not confirm that a token exists on that network. If you cannot verify the mint and decimals, ask your administrator before accepting payments.

Check amounts and network fees

Review the product's price under Monetization → Catalog → Products, then check the token amount displayed in checkout. Choosing a custom token does not add a live exchange rate. Use a token and pricing setup your site supports, and confirm the quoted amount before opening checkout to customers.

Cover network fees requests site-paid transaction fees. Before offering this, have your administrator confirm that the site's operational wallet is ready and has enough SOL. Check the fee payer and any fees shown during the test purchase.

The receiving wallet also needs a token account for the accepted token. A token account holds one particular token for its owner. Ask your administrator to confirm it is ready if checkout reports a missing receiving account.

Check setup and make checkout available

Choose Check setup in the Crypto tab. Address any errors or warnings before continuing. Setup looks ready means the settings passed the available checks; complete a test purchase to confirm that the wallet and network connection work together.

Return to Pay hub → Overview. Confirm that a payment method is ready and that you have an active product with a checkout price. If Activate checkout appears, follow the confirmation when you are ready to enable checkout on that site.

If you use country-specific payment options, review Pay hub → Availability and make sure Crypto is offered to your intended customers. Save any changes with Save availability. The payments introduction explains checkout activation and availability.

Open the actual product page as a buyer and confirm that Crypto appears among its payment options.

Complete a test purchase

Use your separate test site, matching network, and funded test wallet. Test the exact product or paid-content page customers will use.

1. Open the public buyer page and select Crypto at checkout.
2. Connect a compatible Solana wallet on the intended network. Review the item, token, amount, receiving address, and fees before approving anything.
3. Approve the checkout's payment request in the wallet and wait for its result. Use this checkout flow rather than manually sending tokens to the receiving address.
4. In Monetization → Transactions, find the resulting payment and any associated order. Confirm the amount and successful status match the purchase.
5. Return as the buyer and verify the promised result, such as an order or unlocked content. Then test cancelling the wallet request: cancellation must not create a completed purchase or grant paid access.

A manual transfer does not complete the checkout steps that identify the purchase. If someone sends funds manually, collect the transaction reference and ask for help matching it to the intended order.

Repeat the test for each distinct flow you plan to offer. A product purchase does not confirm that paid appointments, subscriptions, tipping, or gated media are ready. Tipping uses the Crypto payout and token settings, so review it again when those settings change.

Handle a payment that is still pending

If the wallet reports a submitted payment but Cedros is still pending, keep the transaction reference and check its status on the correct Solana network. A timeout can occur while the payment is still being confirmed.

Do not ask the buyer to pay again until you know what happened to the first payment. Compare the wallet result with Monetization → Transactions. If the payment is confirmed but the order or access is missing, ask your administrator to investigate that existing purchase.

Resolve common setup problems

• Crypto is missing from checkout: check that it is enabled and saved, checkout is active, the product supports it, and Availability allows it for that buyer.
• The wallet cannot connect or shows the wrong token: confirm wallet compatibility, the selected network, and the exact token mint.
• The amount looks wrong: check the product price, token mint, and decimal count before approving payment. Do not assume a custom token uses a live exchange rate.
• There are not enough funds: check the buyer's accepted-token balance and the fee payer's SOL balance on the same network.
• The destination is unexpected: stop the purchase and ask your administrator to confirm the payout or managed treasury address.
• A receiving-account or site-wallet error appears: ask your administrator to check the token account, wallet readiness, and blockchain connection.
• Payment succeeded but access is missing: preserve the payment reference and compare the purchased item with the access it should provide.

When testing is complete, have your administrator confirm the production network, token, receiving address, and fee funding. Review the production product and checkout before making it available to customers.

For help, provide the public page URL, time, network, token mint, transaction reference, and visible error. Keep private keys and recovery phrases private. See Getting help and reporting a problem.