/ /

Bring your own (BYO) swag provider to the Reward store

Updated 55 minutes ago

Overview

Simpplr Rewards and Recognition lets your organization connect a third-party swag store provider directly to the Simpplr Reward store.

If your organization already has a company store, merchandise partner, or preferred swag fulfillment vendor, you don't have to choose between that partner and Simpplr's native rewards catalog. When Simpplr connects your provider's API, your custom-branded apparel, drinkware, accessories, and gifts appear alongside digital gift cards, physical products, and charitable donations in one storefront.

Employees spend their recognition points on company-branded gear with a single wallet and checkout flow, while your vendor handles fulfillment.

Key benefits

  • Keep your trusted vendor. Retain your existing vendor contracts, negotiated item pricing, and fulfillment relationships without moving to a new merchandise partner.

  • One place to redeem. Employees earn points through peer-to-peer and spot recognition in Simpplr and redeem them in the same Reward store. They don't need another website, a separate sign-in, or voucher codes.

  • Reinforce company culture. Company gear shows your brand in the recognition experience and turns everyday appreciation into something employees can hold.

  • Less manual work. Orders placed in Simpplr go to your vendor through the API. Your HR and People teams don't manage order spreadsheets, reconcile email requests, or coordinate one-off shipments.

  • Audience and country controls. Employees see only the swag items that fit their team and that your vendor can deliver to their country.

Applies to: App managers, Recognition managers, and All users

How it works

An order moves from the Reward store, through Simpplr, to your swag provider, and tracking updates come back the same way.

[embed: node/b8720882-6edb]

  1. Catalog sync. Simpplr connects to your provider's API and imports your approved product catalog, including item titles, descriptions, images, variants such as sizes and colors, and inventory levels.

  2. Points pricing. Simpplr converts each item's cost to recognition points using your organization's exchange rate.

  3. Storefront discovery. Swag items appear in the Reward store under their own category, such as Company swag.

  4. Order placement. When an employee redeems an item, Simpplr checks the points balance, captures the shipping address, deducts the points, and sends the order to your provider.

  5. Fulfillment and delivery. Your provider picks, packs, and ships the item, then sends the tracking number back to Simpplr so the employee can follow the delivery.

Technical and vendor prerequisites

Before Simpplr connects your swag provider, make sure the following requirements are met:

  1. Rewards and Recognition is active. Your organization has Rewards turned on, with points gifting and budgets set up.

  2. Your provider has the right API. Your merchandise vendor must offer an external e-commerce or fulfillment REST API that supports:

    • Catalog retrieval: product details, SKUs, and variant structures such as sizes and colors

    • Inventory checks: live or cached Available-to-Sell (A2S) stock levels

    • Order creation: recipient shipping details, the selected SKU or variant, and order identifiers

    • Shipment tracking: webhook or polling support for order updates and tracking numbers

  3. You hold the commercial contract. Your company keeps its Master Services Agreement (MSA), inventory purchase orders, and fulfillment billing directly with your swag vendor.

Note: To check whether Rewards is turned on, app managers can go to Manage > Recognition > General settings and look at the Rewards card.

Administrator setup (App managers)

Simpplr builds and connects the vendor integration for you. App managers share the vendor details and then confirm how points convert to currency.

Step 1: Share your vendor details with Simpplr

  1. Contact your Simpplr Customer Success Manager (CSM).

  2. Share the details your vendor provides:

    • API base URL or endpoint host

    • Client ID and client secret, or an API token or key

    • Tenant or inventory account identifier, if your vendor uses one to separate your company's inventory

  3. Simpplr tests the connection and turns on the integration.

Alert: You can't connect a swag provider yourself from Application settings > Application > Integrations. Simpplr sets up the connection.

After Simpplr turns on the integration, your provider's items arrive in Manage > Recognition > Reward catalogs for review.

Step 2: Confirm your exchange rate and currencies

  1. Go to Manage > Recognition > General settings.

  2. On the Exchange rate and currencies card, check your Exchange rate, for example 10 points = 1 USD, and your Redemption currencies. To change them, select the edit icon on the card.
    image.png

General settings with the Exchange rate and currencies card

  1. To set a different points value for employees paid in another currency, select Currency conversion in the left menu.

  2. Turn on Customize value for a payroll currency, enter the USD value of 10 points, and then select Save. To add a payroll currency, select Add currency.
    image.png

Currency conversions page with payroll currencies and their 10 points value

Simpplr converts points from USD to the reward currency at the time of redemption, using global exchange rates.

Tip: The Users column shows how many employees use each payroll currency. Check it before you customize a value so you know who the change affects.

Catalog management and governance (Recognition managers)

Once the integration is active, Recognition managers control which swag items appear in the Reward store and who can see them.

Open the Reward catalog

  1. Go to Manage > Recognition > Reward catalogs.

  2. In Choose country, select the country catalog you want to manage, and then select Continue. To switch countries later, use the country field at the top of the page.

  3. On the Products tab, select Available to see the items employees can redeem.
    image.png

Reward catalogs page with the Products tab and the Available and Pending views

Simpplr regularly checks your vendor's catalog for changes to prices, product descriptions, and stock levels, so you don't need to sync it by hand.

Review pending items

When your vendor adds new merchandise, the items arrive as pending so you can approve them before they appear in the Reward store. This review is controlled by the Approve new catalog items setting.

  1. Go to Manage > Recognition > General settings.

  2. On the Approve new catalog items card, select the edit icon.

  3. Select Enable to review new items before they're published, or Disable to publish them right away, and then select Save.
    image.png

Approve new catalog items setting

Note: With Enable selected, new items don't appear in the Reward store until you review them.

To review new items, go to Reward catalogs and select Pending. The number next to Pending shows how many items are waiting.

image.pngPending view in the Reward catalog

Audience availability

You can hide a swag item from specific audiences, such as departments, business units, or office locations, or from your whole organization.

  1. On the Products tab, find the item. Use Search by product name or Filters to narrow the list.

  2. In the Actions column, select the three-dot menu for the item.

  3. Select one of the following:

    • Manage visibility to hide the item from specific audiences

    • Hide product for all org to hide the item from everyone
      image.png

Actions menu with Manage visibility and Hide product for all org

Warning: Hide product for all org removes the item from the Reward store for every employee. To hide it from only some employees, use Manage visibility.

In Manage visibility, select Browse under Hidden from audience, choose the audiences that shouldn't see the item, and then select Save changes. To make the item visible again, remove the audiences.

image.pngManage visibility dialog with the Hidden from audience setting

To find hidden items, turn on Show hidden only. To narrow the list, select Filters and filter by Visibility, Brand, Category, or Hidden from audience, and then select View results. To clear your choices, select Reset all filters.

image.pngFilters panel in the Reward catalog

Country availability

Each country has its own Reward catalog. Employees see only the items in the catalog for the country they shop from, so they see merchandise your vendor can ship to them.

Tip: Review each country catalog you support after your provider goes live. An item that your vendor can't ship to a country shouldn't appear in that country's catalog.

Employee experience: Browsing and redeeming swag

Swag uses the same Reward store, points wallet, and checkout as your other rewards.

1. Check your points

In the Reward store, select the wallet icon at the top right. My wallet shows your available Points.

image.pngMy wallet with your points balance

2. Browse company swag

  1. In the left navigation, select Reward store. Your organization may use its own name for it, such as Homebase Reward store.

  2. Select Shop by, and then select the swag category under Categories, such as Company swag. You can also type a keyword in Search rewards, such as hoodie, backpack, or tumbler.
    image.png

Shop by menu with reward categories. The swag category appears in this list after your provider goes live.

Product cards show the item image, name, and points cost.

Note: Prices, availability, and shipping depend on the country you shop from. To check or change it, go to My account > Reward store location, and then select Change location.

image.pngReward store location tab in My account

3. Choose options

  1. Select a swag item to open its product page.

  2. Choose your options, such as Size (S, M, L, XL), Color, or Style.

  3. Check the points cost. The page shows the number of points the item is redeemable for.
    image.png

Product page with the points cost and Redeem and checkout

Tip: If you don't have enough points, Redeem and checkout isn't available and the page shows the points the item needs.

4. Check out and confirm shipping

  1. Select Redeem and checkout.

  2. Enter or confirm your shipping address. The address form asks for:

    • Country/Region, First name, Last name, and Email

    • Address line, Apartment / Suite (optional), City, State/Province, and Zipcode

    • Special Instructions, Company, and Phone number (all optional)
      image.png

Add address form for shipping details

  1. Review the points summary, including your current balance, the points the order needs, and your balance after redemption.

  2. Select Confirm order. Simpplr deducts the points from your wallet and shows an order confirmation.

Tip: To save time at checkout, add your address ahead of time in My account > Addresses and select Set as default address.

5. Track your order

  • Confirmation email: You receive an email with your order details right after you place the order.

  • Order status: Go to Orders in the Reward store to see your orders, delivery addresses, and status updates.

  • Shipment tracking: When your vendor ships the package, the carrier tracking number appears in the order details.
    image.png

Orders page in the Reward store

Fulfillment, inventory, and financial reconciliation

  • Inventory: Your vendor manages inventory levels. When an item runs out, Simpplr marks the variant as unavailable or out of stock so checkout can't fail.

  • Billing and settlement:

    • Points that employees redeem are recognition currency managed in Simpplr.

    • Your organization and your swag vendor settle merchandise purchases, warehousing fees, and shipping costs directly, under your commercial agreement.

  • Cancellations and refunds: If your vendor cancels a swag order before fulfillment, or the order comes back because delivery failed, Simpplr returns the points to the employee's wallet.

To see every redemption, go to Manage > Recognition > Reward activity and select Points redeemed. Each row shows the date, the redeemer, the reward details, and the value in points and USD. To download the list, select the download icon.

image.pngPoints redeemed in Reward activity

Tip: Select Period to limit the list to a date range before you download it for reconciliation with your vendor's invoice.

Frequently asked questions (FAQ)

Q: Can we connect multiple swag vendors at the same time?

Ans: Yes. You can have more than one provider connection if your organization uses regional vendors, for example one merchandise partner for North America and another for EMEA and APAC. Country catalogs make sure employees see only the items for their region.

Q: What happens if an employee doesn't have enough points for an item?

Ans: Employees can redeem an item only if their redeemable points balance covers its full points cost. Paying the difference with a credit card isn't supported.

Q: Can employees order multiple swag items in a single cart?

Ans: No. Employees redeem swag one item at a time, so Simpplr can reserve inventory and validate shipping for each item.

Q: How is employee shipping data protected?

Ans: Simpplr collects shipping details, such as name, address, and phone number, at checkout only for fulfillment and carrier delivery. Your organization's contract and Data Processing Agreement (DPA) with your vendor govern the data Simpplr sends to that vendor.

Q: What happens if an item is out of stock when an employee tries to redeem it?

Simpplr checks Available-to-Sell (A2S) stock when the employee selects the item and again at checkout. If the item is out of stock, checkout is turned off so the order can't fail.

Was this article helpful?
Subscribe to receive updates on this article