easyway
Log inGet started

Accept Onyxcoin (XCN) payments

Onyxcoin (XCN) is the coin of the Onyx ecosystem: the gas coin of its own chain, Onyx Mainnet, and an ERC-20 token on Ethereum. easyway accepts XCN as an ERC-20 on Ethereum with the same checkout and API as ETH and the stablecoins. Below: the one contract that counts, the networks that don't, and what small unit prices mean for invoice amounts.

Token, network and limits

TokenNetworkContractConfirmationsSmallest invoiceFee taken from the payment
XCN (Onyxcoin)Ethereum · ERC-200xA2cd3D43c775978A96BdBf12d733D5A1ED94fb1812150 XCNNone

This is the address Onyx publishes as "Ethereum XCN" in its own contract reference, and the Ethereum address CoinGecko lists for Onyxcoin. It is a plain ERC-20 with 18 decimals and no proxy, and no fee is taken on a transfer, so the amount the customer sends is the amount that arrives. One detail surprises people: the contract's name() still returns Chain, so an explorer may show "Chain (XCN)". It is the same token.

Ethereum yes, other networks no

XCN on…ContractPays an invoice?
Ethereum (ERC-20)0xA2cd3D43c775978A96BdBf12d733D5A1ED94fb18Yes
Onyx Mainnet (native coin)— (native, no contract)No
Base0x9c632e6aaa3ea73f91554f8a3cb2ed2f29605e0cNo
BNB Smart Chain0x7324c7c0d95cebc73eea7e85cbaac0dbdf88a05bNo

Onyx Mainnet is EVM-compatible, so its addresses look exactly like Ethereum ones, and a wallet will happily send native XCN there to the address on the checkout. It still lands on a different chain and the invoice stays open. If an exchange offers XCN on several networks, the customer must pick Ethereum (ERC-20); the guide to paying from an exchange walks through choosing the network.

Amounts and fees

XCN trades at a fraction of a cent, so invoice amounts are large numbers: a $10 order is a few thousand XCN. On a USD invoice the XCN amount is locked from the exchange rate when the customer selects the coin, and the checkout shows the address and the exact amount to send. XCN needs no setup of its own: the Ethereum address of your own that you set on the Wallets page of the dashboard receives it. easyway only watches that address; it never asks for a private key or seed phrase and cannot move what arrives.

Every Ethereum invoice shows the same address, so an invoice is recognised by its exact amount (exact amount per invoice): if another open invoice already asks for the same XCN amount, the new one is raised by 0.1 XCN until it is unique. Transfers under 5 XCN are skipped as dust, and the invoice is paid after 12 confirmations, usually a few minutes. A transfer that cannot be tied to exactly one invoice is parked as an unmatched transaction for you to assign or ignore; the XCN is in your wallet either way. Short or late payments follow the underpaid and late payments guide.

XCN is not a stablecoin: the payment arrives in your wallet as XCN, so later price moves are yours. No fee is taken from a payment: 100,000 XCN sent puts 100,000 XCN in your wallet. easyway earns from subscription plans instead, and the customer pays the gas of their own transfer. Every coin's numbers are on the pricing page; how they compare with other gateways is in crypto payment gateway fees, compared.

Integrating

Nothing is XCN-specific: set your Ethereum address in the dashboard, create an invoice with the API (or a payment link if you don't write code), send the customer to the hosted checkout and deliver when the signed invoice.paid webhook arrives (a payment screen of your own should show the invoice's pay_amount). To price an invoice in XCN itself, pass currency = "XCN_ERC20"; to show only XCN at checkout, pass allowed_assets with "XCN_ERC20". Runnable examples are in the quickstart.

Common questions

Is easyway connected to Onyx? No. easyway is independent and only receives the XCN token as a payment for your own goods or services.

Where is the XCN kept after a payment? In your own wallet: it is paid straight to your Ethereum address. There is no balance at easyway and nothing to withdraw; easyway holds no keys and cannot move or recover coins, and refunds are sent by you from your own wallet. See security. Other low-priced Ethereum tokens on the same address: JasmyCoin (JASMY), ApeCoin (APE) and Shiba Inu and Pepe.

Create free accountRead the API docsAlready have an account? Sign in
Accept Onyxcoin (XCN) payments | easyway