Merchant Partner Guide · 2026

Show shoppers their best card at checkout.

The Card-Recommendation Widget is 100% free for merchants — forever. No fees, no rev share, no contract. One <script> tag adds a smart card recommendation to your checkout that tells shoppers exactly which card earns them the most on this purchase.

SuperPay sits in the decision layer between the cart and the card. When shoppers see real reward amounts at checkout — "$12.90 cash back with Chase Sapphire" — they buy with more confidence, reach for higher-value carts, and come back more often.

v2026.1 · ~12 min read · Questions? hello@superpayrewards.com
01 · Company & product

SuperPay in one paragraph

SuperPay is the AI-powered payment intelligence layer for the modern wallet. On the consumer side we tell shoppers which card to use at every merchant, surface unused perks, and forecast their best path to maximum rewards. On the merchant side, our Checkout API adds a smart card-recommendation widget to your checkout — showing shoppers exactly which card maximizes their rewards on this purchase. No integration with your payment processor required.

$66K
Avg US household card spend / yr
$2,400+
Rewards left on the table / yr
15 min
Median time to first integration

What you get as a partner

02 · The thesis

Reward visibility drives purchase confidence.

Shoppers with multiple credit cards face decision fatigue at checkout. Which card should I use? Am I missing rewards? That hesitation costs you conversions. SuperPay removes the question entirely.

WITHOUT SUPERPAY

Checkout uncertainty

Shopper hesitates, second-guesses their card choice, maybe abandons the cart to "think about it." You lose the sale — not because of price, but because of friction.

WITH SUPERPAY

Confident checkout

Shopper sees "Use your Chase Sapphire — earn $12.90 back on this purchase." They feel smart, buy with confidence, and come back knowing your checkout works for them.

One-line pitch: SuperPay shows your shoppers exactly how much they'll earn by using the right card — turning checkout hesitation into purchase confidence.
03 · Who it's for

You're a great fit if…

Probably not a fit (yet)

04 · How it works

Three calls. That's the integration.

  1. Mint a reward from your server with the amount, expiry, and any targeting.
  2. Attach it to a checkout session by passing the reward token to the SuperPay widget on your checkout page.
  3. Verify redemption server-side via webhook or polling once the shopper completes purchase.

Lifecycle of a single reward

StageWhoWhat happens
MintYour server → SuperPayCreate a reward (server-only API key, idempotent).
RenderSuperPay widget on your checkoutShopper sees "Earn $X back via SuperPay" on the cart.
PayShopperCompletes purchase on your existing checkout (Shopify, Stripe, custom — we don't care).
ConfirmYour server → SuperPayPOST the order ID and amount to confirm the reward as earned.
RedeemSuperPay → ShopperReward lands in the shopper's SuperPay wallet, applied to their next statement or eligible card.
Important: SuperPay never moves money inside your checkout. We attach a reward; your existing payment processor (Stripe, Adyen, Shopify Payments, etc.) processes the actual transaction unchanged.
05 · Integration walkthrough

Get to a working sandbox in under 15 minutes

Step 1 — Get your sandbox key

Visit /for-merchants, fill in your business name, contact email, and store origins (the domains where the widget will be embedded). You'll receive a verification email — click it and your sandbox key is provisioned immediately.

Step 2 — Mint your first reward

From your server, call POST /v1/rewards with the SuperPay sandbox secret key. Use idempotency keys to make this safe to retry.

curl -X POST https://superpayrewards.com/v1/rewards \
  -H "Authorization: Bearer sk_sandbox_..." \
  -H "Idempotency-Key: order_98123" \
  -H "Content-Type: application/json" \
  -d '{
    "amountCents": 750,
    "currency": "USD",
    "expiresInSeconds": 1800,
    "metadata": { "orderRef": "order_98123" }
  }'

Response:

{
  "rewardToken": "rwd_live_8e3...d2",
  "amountCents": 750,
  "expiresAt": "2026-05-03T22:14:00Z"
}

Step 3 — Embed the widget on your checkout

Drop the script tag near the bottom of your cart or checkout page and pass the reward token via data-reward.

<script
  src="https://superpayrewards.com/v1/widget.js"
  data-key="pk_sandbox_..."
  data-reward="rwd_live_8e3...d2"
  async></script>

Step 4 — Confirm redemption after purchase

When your order webhook fires, confirm the reward server-to-server. SuperPay only credits the shopper after this call.

POST /v1/rewards/rwd_live_8e3...d2/confirm
Authorization: Bearer sk_sandbox_...

{
  "orderId": "order_98123",
  "amountChargedCents": 12900
}

Step 5 — Promote to production

Email hello@superpayrewards.com with your sandbox merchant ID and the production domain(s). We'll issue a pk_live_ + sk_live_ pair and walk through your first 100 live transactions together.

06 · Widget

One script tag. Your branding. Our reward affordance.

The SuperPay widget renders as a non-intrusive badge or button on your checkout. It's framework-agnostic — works inside Shopify themes, custom React/Vue checkouts, BigCommerce, WooCommerce, and bare HTML.

Customization options

AttributeDefaultPurpose
data-keyYour publishable merchant key (pk_*).
data-rewardThe reward token returned from /v1/rewards.
data-variantbadgebadge · button · inline
data-themeautolight · dark · auto
data-anchor#superpayCSS selector for the mount point.
CSP friendly: the widget loads from superpayrewards.com, no inline scripts, no third-party trackers. Add the host to script-src and connect-src.
07 · Code samples

Reference snippets

Node.js (Express)

import express from "express";
const app = express();

app.post("/cart/checkout", async (req, res) => {
  const reward = await fetch("https://superpayrewards.com/v1/rewards", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.SUPERPAY_SECRET}`,
      "Content-Type": "application/json",
      "Idempotency-Key": req.body.cartId,
    },
    body: JSON.stringify({
      amountCents: Math.round(req.body.subtotal * 0.05),
      currency: "USD",
      expiresInSeconds: 1800,
      metadata: { cartId: req.body.cartId },
    }),
  }).then(r => r.json());

  res.render("checkout", { rewardToken: reward.rewardToken });
});

Python (Django/Flask)

import os, requests

def create_reward(cart_id, subtotal_cents):
    r = requests.post(
        "https://superpayrewards.com/v1/rewards",
        headers={
            "Authorization": f"Bearer {os.environ['SUPERPAY_SECRET']}",
            "Idempotency-Key": cart_id,
        },
        json={
            "amountCents": subtotal_cents // 20,  # 5% reward
            "currency": "USD",
            "expiresInSeconds": 1800,
            "metadata": {"cartId": cart_id},
        },
        timeout=5,
    )
    r.raise_for_status()
    return r.json()["rewardToken"]

Shopify (Liquid theme)

<!-- in your cart.liquid or checkout.liquid -->
<div id="superpay"></div>
<script
  src="https://superpayrewards.com/v1/widget.js"
  data-key="{{ settings.superpay_publishable_key }}"
  data-reward="{{ checkout.attributes.superpay_token }}"
  data-variant="inline"
  async></script>
08 · Pricing

Free, forever.

The Card-Recommendation Widget is 100% free for merchants. No fees, no rev share, no contract minimums. SuperPay treats the widget as a value-add at checkout and a shopper-acquisition channel.

INSTALL

$0

One script tag, one div. No SDK, no build step, no processor change. Works on Shopify, Magento, and custom carts.

MONTHLY

$0

No monthly fees, no per-call charges, no usage caps. Unlimited recommendation calls (60/min per key).

CONTRACT

None

No contract, no rev share, no commitments. Use the widget as long as it's helping your checkout — cancel any time.

Questions about the API or want to discuss a custom integration? Email hello@superpayrewards.com.

09 · Security & compliance

What we do, what we don't

What we do

  • Issue scoped, revocable API keys (publishable + secret) per merchant.
  • Enforce origin allowlists on the publishable key — the widget refuses to load on unlisted hosts.
  • Sign all server callbacks (HMAC-SHA256) so you can verify webhooks.
  • TLS 1.2+ everywhere. PCI scope is limited to your existing processor.
  • Rate-limit and idempotency-key every reward mint.
  • Log every key issuance, revocation, and admin action with audit trail.

What we don't

  • Touch your shopper's PAN, CVV, or any cardholder data.
  • Sit in your payment flow — your processor still handles the actual charge.
  • Resell shopper data. Ever.
  • Ship customer email or order details to third parties without an explicit data-processing agreement.

Need our security policy or to start a vendor review? View our security policy or email security@superpayrewards.com.

10 · FAQ

Common questions

Does this replace my loyalty program?

No. SuperPay sits alongside it. Many partners use SuperPay rewards for top-of-funnel acquisition and reactivation, and reserve their loyalty program for deeper LTV mechanics.

Can shoppers use SuperPay rewards stacked with promo codes?

By default, yes. You control eligibility per reward via the metadata.eligibility field — gate by SKU, customer segment, or order minimum.

What happens if a reward expires before redemption?

Nothing. You're not billed for unredeemed rewards. Expired rewards are flagged in your dashboard so you can tune your default expiry window.

Is this a credit card? Do shoppers need to apply for anything?

No. SuperPay credits the shopper's existing card via statement credit or wallet balance. There's no new card, no credit pull, no application.

How long until I'm in production?

Sandbox in 15 minutes. Production keys typically issued within 1 business day after a quick review of your domain and use case.

Do you offer co-marketing?

Yes — once you're live, ask about featured placement in the SuperPay consumer app, push notification slots, and category sponsorships.

Can I revoke a key?

Instantly, from your merchant dashboard or by emailing us. New keys are provisioned in seconds.

11 · Launch checklist & contact

Ready to ship?

Pre-launch checklist

Need help? Talk to a human.
Email hello@superpayrewards.com with your sandbox merchant ID, the URL of your checkout, and a one-liner about what you're trying to test. We typically reply same business day.

Useful links