SIMPLE GUIDE
Payment links, QR & donations
No API knowledge is required to create a hosted payment or donation link, download its QR, or share a receipt after Bitcoin settles. Use BlockAck only for lawful sales. Never put an API key, seed phrase, or private key into your website.
Wallet setup currently offers Bitcoin only. Bitcoin hosted checkout is created from Payment links after you sign in, for a ready store. The URL is shown once. Copy it or save the QR. You can turn the link off later. Each previously issued checkout link is single-use and expires. BlockAck refuses Cuba, Iran, North Korea, and Syria.
MERCHANT CONSOLE
Create a hosted payment or donation link
Sign in and open Payment links. Choose a ready Bitcoin store, a public title, and an amount. A donation can leave the amount open. The page shows the URL once. Copy it or download the QR before you leave. You can turn the link off later, or hide it from the list.
Anyone with the link can start a payment until you turn it off or it reaches a count, date, or donation total you set. Turning it off stops new payments and does not undo one that already started. Hide only removes it from the On list. The list shows how much has settled, and each payment's time, sats, and reference. The payer can type a short reference. It stays on the payment record and is not written into the Bitcoin payment. If you lose the URL, replace the link: the old one turns off and a new URL is shown once. You can offer the payer a receipt after settlement. Do not put the URL on a public page unless you want ongoing payments. Each Pay creates a new invoice. The customer sees a Bitcoin address and QR, and the payment is recorded after confirmation.
PAYMENT LINKS
Turn a payment link into a QR
In Payment links, create a hosted payment link for a ready Bitcoin store. The page shows the URL once and can download a QR. Copy the link or save the QR before you leave. The QR opens that hosted checkout.
Turning the link off stops new payments. It does not undo a payment that already started. Never paste API credentials into your website.
HOSTED DONATION
Create an easy Bitcoin donation link
In Payment links, choose Donation, a public title, and a ready Bitcoin store. Set an amount in sats, or leave it blank for donor choice. Copy the link or download its QR. The link is a hosted checkout.
A customer payment is recorded after confirmation. BlockAck does not hold the bitcoin and cannot reverse a payment that already settled.
You can turn the link off later. That stops new payments and does not erase one that already settled. A donation record is not a tax receipt.
RECORDED SETTLEMENT
Share a receipt—not a payment request
After an invoice has recorded Bitcoin settlement evidence, the receipt API can create an expiring, revocable link. Its page offers Copy link, Share link, and Download QR. A hosted link can also offer its payer a receipt after settlement when the merchant enables that option.
Anyone with the link can view the original invoice amount, currency, receipt reference and recorded settlement time—not customer details or wallet addresses. Default expiry is seven days, with a maximum of 30 days. Replacing or revoking a link disables future access, but cannot erase saved copies.
This is recorded settlement evidence, not a fresh blockchain check or a tax invoice. Direct wallet donation requests do not automatically create these receipts. Read the receipt API instructions.
STEP 2
Choose how the button looks
Choose Solid, Outline, Soft, or Pill. Sizes are Small, Medium, or Large. Full width is available for narrow website columns.
LAWFUL SALES ONLY
What BlockAck will not serve
BlockAck is only for lawful sales. We do not serve illegal drugs, illegal weapons, fraud, money laundering, sanctions evasion, stolen or counterfeit goods, malware, credential theft, trafficking, or sexual content involving anyone under 18.
Signup and new payments are refused from Cuba, Iran, North Korea, and Syria. New accounts must say what they sell and give a public https website. We may fetch that page and record the review. Payments stay off when the page is prohibited, does not describe what they sell, or cannot be opened, until a person reviews it.
STEP 3
Paste the prepared snippet
For a verified existing checkout only, ask your developer to fill in the real link and matching display amount below. This placeholder cannot accept a payment. In your website builder, add a Custom HTML or Embed block and paste it there. If your website builder does not allow custom code, use the hosted payment link as a normal button or link instead.
<script type="module" src="https://www.blockack.com/blockack-checkout.js"></script>
<blockack-checkout
checkout-url="YOUR BLOCKACK CHECKOUT LINK"
mode="buy"
variant="solid"
size="medium"
amount="MATCH YOUR CHECKOUT AMOUNT AND ASSET">
</blockack-checkout>REFERENCE
What you can change
checkout-urlmode:buyorsubscribe.variant:solid,outline,soft, orpill.size:small,medium, orlarge.theme:lightordark.width:fullamount
Place the script line only once per webpage. You may place multiple blockack-checkout buttons below it.
STEP 4
Test before sharing
Open the page in a private browser window. Confirm the amount, asset, store name, and destination shown by the hosted checkout. Do not accept real payments until your selected network and store are verified as payment-ready.
On-chain Bitcoin fees can outweigh a small purchase, and many small received outputs can cost more to spend later. Lightning is better suited to small, frequent payments, but general availability is still planned. Always check the fee in the customer’s wallet.
Current early-launch limits are $50 USD-equivalent per payment creation and 1,000 creations per merchant per UTC month, including paid accounts. Check your effective limits or request an increase in Billing. A request does not automatically grant higher limits. These limits are operational restrictions, not regulatory exemptions.
Never put these on your website
- BlockAck API keys or sign-in tokens
- Wallet seed phrases or private keys
- Payment administrator links
- A checkout link that belongs to another customer