Resources
Store guide
Everything a store needs to know about publishing discount options, approving sponsor proposals, accepting coupons at checkout, and getting paid.
Overview
What your store does on SponsorPay
As a store, you control what discount terms you're willing to offer. You publish those terms as Discount Options, and sponsors use them to propose partnerships with your store.
When a sponsor's campaign goes live, customers can bring coupons or gift cards to your checkout. Your POS handles everything automatically at the register — no manual steps needed during the sale. After every redemption, the sponsor's portion of the discount is credited to your store wallet, and admin pays it out to you on a regular schedule.
You never have to chase sponsors for payment or track redemptions in a spreadsheet. SponsorPay keeps the reconciliation clean on both sides.
What you control
Your settings and permissions
Discount Options
The discount templates you publish to sponsors. Each option sets the minimum discount percentage you're willing to offer, an expiry date, and the ID of the promotion already configured in your POS system.
Approvals
You decide which sponsor proposals to accept or reject. You also set your own contribution percentage when approving — the total customer discount is your amount plus the sponsor's amount.
Store Profile
Your store name, address, POS type, and whether your store accepts gift cards. Gift card acceptance is opt-in.
API Keys
Generate and manage the API keys your POS uses to talk to SponsorPay at checkout. Each key is tied to your store. The raw key is shown only once — store it securely.
What you don't control
You cannot edit a sponsor's contribution percentage — that's set by the sponsor. You also can't control when admin issues a payout, or which sponsors send you proposals (though you can reject any proposal you don't want).
Step by step
From setup to first payout
Create a Discount Option
Go to Discount Options in your portal and create a template. Set the minimum discount percentage you'll offer, an expiry date, and link it to the promotion ID already configured in your POS (Clover Promotion, Square Discount, Toast Applied Discount, etc.). Save it as a draft.
Publish the option
Publishing makes the option visible to sponsors browsing the platform. Sponsors can then send you proposals referencing that option. You can unpublish at any time to stop new proposals.
Review incoming proposals
When a sponsor selects your store for their campaign, you'll see the proposal in your portal. It shows the sponsor's name, their contribution percentage, and which of your options they selected. You can approve, reject, or ask for changes.
Set your contribution
When you approve a proposal, you optionally set the store's own contribution percentage. Your contribution increases the total discount the customer sees (sponsor % + store % = total %). It's tracked in reports as foregone revenue — not a cash deduction.
Accept coupons at checkout
Once the discount is activated, customers can bring coupons to your store. Your POS scans the barcode, calls SponsorPay to verify it, applies the promotion, and records the redemption automatically. No manual steps in the portal during checkout.
Review your reports
Your portal shows every redemption — what was discounted, who paid what portion, and your running wallet balance. Reports update in real time as coupons are used.
Discount options
Setting your terms
A Discount Option is the template you publish to let sponsors know what kind of arrangement you're willing to offer. You're not committing to anything by publishing one — you still approve or reject every individual proposal.
The most important field is the POS Discount ID (posDiscountId). This is the ID of a promotion or discount you've already set up inside your POS system — for example, a Clover Promotion, a Square Discount, or a Toast Applied Discount. When a customer scans their coupon, SponsorPay sends this ID back to your POS so it can auto-apply the right discount rules automatically.
Your POS promotion controls which items and categories are eligible for the discount. SponsorPay only sees the final dollar amounts that result — it doesn't manage item-level eligibility.
Minimum discount %
The lowest total discount you'll offer. Sponsors can accept this or offer their own portion on top of yours.
Expiry date
When this option stops accepting new proposals. Existing approved store discounts continue until the sponsor's campaign expires.
POS Discount ID
The promotion ID in your POS system. SponsorPay returns this at scan time so your POS can auto-apply it.
Payment flow
Whether payment for the discount runs through SponsorPay (wallet-based) or you handle it directly with the sponsor.
Your contribution
Store discount vs. sponsor discount
When you approve a proposal, you may choose to contribute your own percentage to the total customer discount on top of the sponsor's portion. For example:
Sponsor pays
Charged to sponsor's wallet on each redemption
Store contributes
Your cost — tracked in reports, not a cash transfer
Customer sees
Total discount applied at checkout
Your own contribution is recorded in your reports as foregone revenue — it's the discount you absorbed. It is not a cash deduction from your store wallet. Only the sponsor's portion flows as actual money between wallets.
Contributing your own percentage increases the total discount the customer sees, which can drive more foot traffic and higher basket sizes. You set the exact percentage when you approve the proposal and can negotiate with the sponsor until both sides are satisfied.
Contribution is optional
You can set your store contribution to 0% and let the sponsor fund the full discount. The terms are locked once the campaign goes live — neither side can change them after activation.
Getting paid
How your store wallet works
Redemption happens
A customer uses a sponsor's coupon or gift card at your checkout. Your POS records the redemption with SponsorPay.
Wallet credited
The sponsor's portion of the discount is credited to your store wallet with PENDING status. It becomes available after a short holding period — typically 24 hours.
Balance accumulates
Credits build up in your wallet as more customers redeem. You can see your full balance, every pending credit, and every posted transaction in the store portal at any time.
Admin issues a payout
Periodically, admin transfers your available balance to your store — minus your payout fee percentage. You can view your full payout history in the portal.
Wallet status
Credit just recorded; holding period not yet passed.
Available for payout. Included in your next payout.
Transferred to your store. Payout fee has been deducted.
Payout fee
Admin deducts your store's payout fee percentage when issuing a payout. The fee rate is set at account setup. You can see it in your store profile and it is shown on every payout record.
POS integration
Connecting your point-of-sale system
Your POS system connects to SponsorPay using an API key generated in your store portal. See the full technical guide for endpoint details, error codes, and the checkout flow.
View Developer Docs