(Alpha) The Bidco UWP SDK makes it easy to add purchasing, engagement, user authentication and other Bidco features to UWP apps.

Topics


The UWP SDK is currently a alpha release; its content and functionality are likely to change significantly and without warning. Note that by using Bidco developer tools, you accept our Developer Terms of Use.

About the UWP SDK

The Bidco SDK for UWP is the easiest way to integrate your UWP app with Bidco to enable:

  • Easily Paying for items while shopping in-store, online and on a mobile.
  • Securely storing payment details to enable one-tap purchases.
  • Scan, touch or listen to Bidco tags to enter competitions, receive offers, browse store catalogues and much more.
  • Multi item baskets that can easily be managed by user of the app.
  • Discover offers and promotions which are relevant and interesting to you based upon location and previous purchases.

Registering Your Application

When registering your application you will recieve the credentials (API key and secret) needed to initialise the SDK and start using Bidco features.

You can register here

Downloading the SDK

The UWP SDK is available for download from its home on GitHub:


Installing The SDK

Requirements

PowaTag SDK for Windows Phone runs on devices with Windows Phone 8.0 or higher.


Install the SDK with Nuget

To use PowaTag SDK in a project, add it as a build dependency and import it.

  1. Select the 'Tool' tab in Visual Studio and find NuGet Package Manager, then select Manage NuGet Packages for Solution:

start nuget


  1. In a Manage NuGet Packages window, click the 'Online' tab, choose 'All' and Search Online Ctrl+E for "PowaTag".

  1. Install the PowaTag SDK. Now you can import PowaTag.WindowsPhone.Sdk.PowaTagKit into your project.

Install the SDK Manually

  1. Extract the SDK Zip into a folder.

  1. In Solution Explorer, find 'References' of your project and click right mouse button on it and choose 'Add reference...'

start manual


  1. Open Assemblies and click 'Browse...'

  1. Select "PowaTagKit.dll" from the Library folder of the ZIP you extracted earlier and click 'Add'

  1. Build your project. Now you can import PowaTag.WindowsPhone.Sdk.PowaTagKit into your app.

Initialize the SDK

You need to initialize PowaTag SDK before you can use it. Please use the API key and secret that was provided to you during registration.

Add a call to PowaTagKit.InitializeSdk from the constructor of your Application subclass:

public App()
{
	string endpoint = getAlternateEndpoint();
	PowaTagKit.InitializeSdk(App.API_KEY, App.SECRET, PowaTagEndpoint.DefaultEndpointPorts(new Uri(endpoint)));
}

During development you need to use a non-production endpoint and for this a second initialization method is available:

?????


Importing The Sample App

The HelloPowaTagSample app is included with the SDK to provide you with examples of the main PowaTag SDK features.

You can experiment with the SDK features by importing the app into into Visual Studio.

The sample has a project dependency rather than a central repository dependency via NuGet. This is so that when a local copy of the SDK gets updates, the samples reflect the changes.


API Documentation

The download package includes comprehensive documentation of all API classes. Because UWP libraries cannot include Javadoc files, HTML documentation is shipped within the download zipfile. You can also read the documentation online.


Next Steps

After you install Bidco SDK for UWP, you can see review the following sections:

  • Authentication - securely authenticate users to access their Bidco profile.
  • User Profiles - manage all the personal, address and payment details of the user.
  • Triggers - enable the detection of Bidco tags to trigger workflows
  • Workflows - enable the different workflows
  • Products - retrieve and manage products and product variants that merchants are selling.
  • Coupons - manage coupons the user's coupons and redeem them during purchases.
  • Baskets - manage baskets for different merchants.
  • Catalogs - retrieve merchant catalogs in app and select products for purchase.
  • Payments - easily process payments for the user's orders.
  • Acts - enable users to enter competitions, request information or respond to a 'call to action'.

Terms of Use

The UWP SDK is currently a beta release; its content and functionality are likely to change significantly and without warning. Note that by using Spotify developer tools, you accept our Developer Terms of Use.