Onfinga Store Setup (One Page)

Add a buyer approval step before payment and keep a tamper-resistant record tied to the checkout. This guide covers Shopify, WooCommerce, and custom stores.

You’ll need

  • • Your Onfinga Merchant ID
  • • The page/button customers click to pay
  • • 10 minutes to test end-to-end

Goal

  • • Load the Onfinga widget script
  • • Mark your checkout/pay CTA with data-onfinga-verify
  • • Customers continue to checkout as normal

Need help?

Email support@onfinga.net with your store URL and which platform you’re on.

1) Universal install pattern (works anywhere)

Add the script once per page (usually site-wide), then add data-onfinga-verify to the element customers click to continue to payment. 

<!-- 1) Onfinga script (paste once per page) -->
<script src="https://onfinga.net/verify/widget.js"
        data-merchant-id="YOUR_MERCHANT_ID"></script>

<!-- 2) Mark your pay/checkout CTA -->
<a href="/checkout" data-onfinga-verify>Proceed to checkout</a>

Tip: place the script just before </body> so it doesn’t slow down page load.

2) Shopify (Online Store)

Shopify limits what can be changed inside checkout for most plans. The most common setup is to trigger Onfinga from your cart page (the “Checkout” button) before Shopify’s checkout loads.

If you’re on Shopify Plus, you can usually place this closer to checkout using Checkout Extensibility.

  1. Get your Merchant ID from Dashboard.
  2. In Shopify Admin: Online Store → Themes → Edit code.
  3. Open layout/theme.liquid and paste the script just before </body>.
  4. Find your cart checkout button (often in sections/main-cart-footer.liquid or similar) and add data-onfinga-verify to the checkout link/button.
  5. Save, then test: add a product → go to cart → click Checkout → complete the Onfinga step → confirm you land in Shopify checkout.

3) WooCommerce (WordPress)

The simplest install is to add the script site-wide and tag the “Proceed to checkout” button on the cart page.

  1. Add the Onfinga script site-wide (via your theme footer, or a safe “insert headers/footers” plugin).
  2. Add data-onfinga-verify to your cart checkout button (usually an a.checkout-button link).
  3. Test: cart → proceed to checkout → complete Onfinga → confirm you land on the WooCommerce checkout page.

If you can’t easily edit the cart template, your developer can add a tiny JS snippet to attach the attribute automatically.

4) Custom checkout

  1. Add the Onfinga script to your site template (or SPA shell) so it loads on the page where users click “Pay” / “Checkout”.
  2. Add data-onfinga-verify to the element that triggers payment, and keep its href / click behavior the same as today.
  3. Test on mobile and desktop, and confirm the verify record shows up in your Onfinga dashboard.

5) Quick test checklist

  • • Confirm the Onfinga step happens before payment is completed.
  • • Confirm the customer continues to the normal checkout/payment page after approval.
  • • Confirm the verify shows up in Dashboard (status + evidence PDF).
  • • Test on at least 1 mobile device (most real checkouts happen on mobile).

Troubleshooting

  • • Nothing happens when clicking checkout: confirm the script is present and the CTA has data-onfinga-verify.
  • • Works on one page but not another: ensure the script is loaded site-wide (or on every relevant template).
  • • Shopify checkout can’t be modified: put Onfinga on the cart page (or use Shopify Plus checkout extensibility).

Still stuck? Email support@onfinga.net.