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/ |
| 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.
- Body
- CardBrandResponse
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.
- Body
- BalanceResponse
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.
- Body
- CatalogResponse
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.
- Body
- QuoteResponse
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
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 |