Snaplii (Preview)

Browse Snaplii gift card brands, check your Snaplii Cash balance, and get a price quote before buying. Spending comes only from your prepaid Snaplii Cash.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Snaplii Inc.
URL https://www.snaplii.com/help-center/
Email customerservice@snaplii.com
Connector Metadata
Publisher Snaplii
Website https://www.snaplii.com/a2m/
Privacy policy https://www.snaplii.com/privacy-policy/
Categories Finance;Commerce

Snaplii

This connector lets Copilot Studio agents browse Snaplii gift card brands, check the user's Snaplii Cash balance and get a price quote before buying. Spending comes only from the user's prepaid Snaplii Cash; a quote charges nothing.

Prerequisites

A Snaplii account in Canada or the United States and an API key created in the Snaplii app (More, Payment Methods, AI Payment Management, New API Key).

How to get credentials

Create the API key in the Snaplii app, choose its scope and spending limit, and enter it when you create the connection. The key can be revoked in the app at any time.

Get started with your connector

List the categories and brands, open a brand's details to pick a card and amount, then quote that card.

Known issues and limitations

  • Available for Snaplii accounts in Canada and the United States only.
  • The connector reads the catalog, the balance and quotes; it does not buy gift cards, pay bills or send money.
  • The catalog lists the brands shown on the Snaplii app home page.
  • Spending comes only from prepaid Snaplii Cash.
  • The card ID in a quote must be copied exactly from the brand details.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Snaplii API key securestring The Snaplii API key for this api True

Actions

Get gift card brand details and denominations

Returns the brand's cards and their denominations. FIXED requires the exact priceStart; VARIABLE requires an amount between priceStart and priceEnd.

Get Snaplii Cash balance

The balance is in the account currency (CA=CAD, US=USD), the country returned with the access token.

List gift card categories and brands

Catalog is scoped to the authenticated account country. No locationProv parameter is sent.

Quote a gift card purchase

Quote a gift card purchase. Before quoting, read the brand details and confirm the card ID and amount match one of its denominations. A positive primaryPayAmount means Snaplii Cash does not fully cover the order. Nothing is charged by a quote.

Get gift card brand details and denominations

Returns the brand's cards and their denominations. FIXED requires the exact priceStart; VARIABLE requires an amount between priceStart and priceEnd.

Parameters

Name Key Required Type Description
Card brand ID
card_brand_id True string

Card brand identifier.

Returns

The brand, returned directly or under data.

Get Snaplii Cash balance

The balance is in the account currency (CA=CAD, US=USD), the country returned with the access token.

Returns

The balance, returned directly or under data, in the account currency.

List gift card categories and brands

Catalog is scoped to the authenticated account country. No locationProv parameter is sent.

Returns

The categories shown on the Snaplii app home page.

Quote a gift card purchase

Quote a gift card purchase. Before quoting, read the brand details and confirm the card ID and amount match one of its denominations. A positive primaryPayAmount means Snaplii Cash does not fully cover the order. Nothing is charged by a quote.

Parameters

Name Key Required Type Description
itemId
itemId True string

The gift card ID, exactly {cardBrandId}-{cardTemplateId}: the brand's cardBrandId, one hyphen, and the chosen card's cardTemplateId, both copied verbatim from the brand details. Never send one ID alone, a card from another brand, or a guessed ID.

price
price True string

Decimal amount sent as a JSON string in the account currency.

voucherOption
voucherOption True string
cashbackOption
cashbackOption True string
specifiedVoucher
specifiedVoucher string

Specific voucher ID. Set voucherOption to USE when selecting a voucher.

Returns

Quote amounts. primaryPayAmount is the remainder after applied funds/discounts; zero does not mean the order is free.

Definitions

GatewayObject

A gateway object.

Name Path Type Description
object

A gateway object.

CatalogResponse

The categories shown on the Snaplii app home page.

Name Path Type Description
categories
categories array of GatewayObject

Categories with their brands.

AmountValue

An amount or rate, as a string or a number.

An amount or rate, as a string or a number.

FaceValueRules

FIXED uses priceStart as the exact denomination. VARIABLE uses priceStart and priceEnd as inclusive bounds.

Name Path Type Description
type
type string
priceStart
priceStart AmountValue

An amount or rate, as a string or a number.

priceEnd
priceEnd AmountValue

An amount or rate, as a string or a number.

CardTemplate

A card template; discount values are cashback percentages.

Name Path Type Description
cardTemplateId
cardTemplateId string
faceValueRules
faceValueRules FaceValueRules

FIXED uses priceStart as the exact denomination. VARIABLE uses priceStart and priceEnd as inclusive bounds.

discount
discount AmountValue

An amount or rate, as a string or a number.

regularDiscount
regularDiscount AmountValue

An amount or rate, as a string or a number.

CardBrand

Name Path Type Description
cardBrandId
cardBrandId string
cards
cards array of CardTemplate

CardBrandResponse

The brand, returned directly or under data.

Name Path Type Description
cardBrandId
cardBrandId string
cards
cards array of CardTemplate
data
data CardBrand

BalanceResponse

The balance, returned directly or under data, in the account currency.

Name Path Type Description
balance
balance AmountValue

An amount or rate, as a string or a number.

balance
data.balance AmountValue

An amount or rate, as a string or a number.

QuoteResponse

Quote amounts. primaryPayAmount is the remainder after applied funds/discounts; zero does not mean the order is free.

Name Path Type Description
orderAmount
orderAmount AmountValue

An amount or rate, as a string or a number.

primaryPayAmount
primaryPayAmount AmountValue

An amount or rate, as a string or a number.

voucherAmount
voucherAmount AmountValue

An amount or rate, as a string or a number.

cashbackUseAmount
cashbackUseAmount AmountValue

An amount or rate, as a string or a number.

voucherName
voucherName string