SIMPLE GUIDE
Add a BlockAck payment button
No API knowledge is required to use the hosted link or paste a prepared button into a site builder. You will never put an API key, seed phrase, or private key into your website.
Hosted USDT checkout links and Buy/Subscribe button styles are implemented. Each link is single-use and expires. Bitcoin hosted checkout and reusable product links are planned after Bitcoin sync and real settlement testing.
STEP 1
Create the payment link
In BlockAck, choose your store and create a checkout for the exact amount. For a subscription, create the invoice for the current billing cycle. BlockAck gives you a hosted checkout link.
- Share the link in email, chat, a digital invoice, or a social profile.
- Do not reuse the link for another customer or payment.
- Do not edit the session value inside the link.
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.
OPTIONAL
Import a product catalog
Upload a CSV and review every row before applying it. Required columns are sku, name, and price. Optional columns include currency, billing, description, category, image_url, inventory, tags, and active. Add custom properties with columns such as attribute_color or attribute_size.
sku,name,price,currency,billing,category,tags,attribute_color
MUG-01,Ceramic mug,25,USD,one-time,Objects,kitchen|ceramic,BlueDuplicate SKUs are shown as updates. Invalid rows are listed with a reason and are not imported.
STEP 3
Paste the prepared snippet
Use the BlockAck button configurator to generate the snippet. 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="$249.00">
</blockack-checkout>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.
Never put these on your website
- BlockAck API keys or Supabase tokens
- Wallet seed phrases or private keys
- BTCPay API keys or administrator links
- A checkout link that belongs to another customer