Real Currencies

The Real Currencies plugin is specifically designed to manage purchases, subscriptions, claims and receipt validations with legal tender currencies through the PlayFab service, for games built using Construct 3 and Construct 2.


Interconnected with major platforms including Google Play, Game Center, Apple Login, Instant Games, Facebook, Facebook Instant Games, Steam, Xbox Live, Nintendo Switch, PS4 and of course PlayFab's own account system allows you to validate your user's purchases, subscriptions and claims using their receipts, and reflect them in the user's inventory through the PlayFab Economy feature.


The Real Currencies plugin currently supports server-side receipt validation for both Android and iOS.

PlayFab API v2.png

Introduction

Step 1.png

The Construct Master Collection supports the full and easy integration of the PlayFab service for both Construct 3 and Construct 2.


Please click here to learn more about PlayFab.

Features


Here are some of the features of the PlayFab service:

  • Server-side receipt validation for Android.

  • Server-side receipt validation for iOS.

  • Automatically reflect new items in receipt validation.

  • Purchases

  • Subscriptions

  • Advanced purchases

  • Advanced subscriptions

  • Redeem Codes

  • Automatically reflect new items in receipt validation with support all product types.

  • Bundles

  • Containers

  • Drop Tables

  • Stores

  • United States Dollar currency

  • Local currency

  • User's real legal tender currency transactions.


For more information about all the integrated PlayFab service features, please click here to learn the introductory lessons to PlayFab.


Network Services


Here are some of the platform services that can be linked:

  • PlayFab

  • Google Play

  • Game Center

  • Facebook

  • Facebook Instant Games

  • Steam

  • Xbox Live

  • Instant Games (Android Studio port)

  • Nintendo Switch (3rd party porting services)

  • PS4 (3rd party porting services)

  • Nintendo Switch (3rd party porting services)


Editor Features


Here are some of the features in the Construct editor:

  • Android

  • iOS

  • Web (Coming soon with the incoming PlayFab Payments plugin.)

  • Desktop (Coming soon with the incoming Steam Master Collection.)

  • Construct 3

  • Construct 2

 
 

How to use?

It is easy to use the Real Currencies plugin, you will only need to follow the steps below.

  1. Set up the PlayFab API plugin, please click to visit the documentation. This includes creating a PlayFab account, studio and title.

  2. Set up the Authentication plugin, please click to visit the documentation.

  3. Finally, you can now use the Real Currencies object, and include more PlayFab addons for more features.


 
 

Documentation

There is currently nothing to show, we will add more in the future.



Server Configuration


To enable mobile real currencies, there is a few server configuration requirements. It is easy to setup from the PlayFab side, but there are a few technicalities for each mobile platform.


  1. Create a PlayFab Account.

  2. Create a studio, then a title (game) in the studio.

  3. From the sidebar, click on the side-tab labeled Addons, it will show an item group of platform services.

  4. If you want to support Android services then install Google. If you want to support iOS services then install Apple. You can also install both. Each platform has their counterpart services for purchases, subscriptions and receipt validation. There are also unique features and services of each platform you might want to register with.

  5. Fill up each platform's requirements. This is the technical part, which can be a bit complicated without experience for each platform. However, rest assured, there are documentations for this provided by each platform. Google Search will be a great tool for this. Overtime, requirements change and Google, Apple and other services frequently change their documentation. Therefore, it is best to use a search engine to know how to retrieve the credential values they require instead since it becomes available immediately on their own documentations.

  6. After filling up the credential requirements for each platform, you then have completed the server configuration. You can now use the Real Currencies plugin in your project.



Related Plugins


  • Virtual Currencies - is a plugin specifically designed to manage the application's virtual store, currency and user's side of economy and inventory through the PlayFab service. You can use this plugin to make payments using virtual currencies for products and subscriptions, and even redeem coupons generated in PlayFab either through the economy console or automation.

  • Web Pay - is an in-development plugin for web payments in the Web Master Collection.

  • Steam Pay - is an in-development plugin for Steam payments in the upcoming Steam Master Collection.

 

Actions, Conditions & Expressions

Actions

press to zoom

press to zoom
1/1

The following action groups:

  • Google Play

  • iOS Store

Google Play

  • Validate Google Purchase - Validates a Google Play purchase and gives the corresponding item to the player.

  • Currency Code - Currency used for the purchase.

  • Purchase Price - Amount of the stated currency paid for the object.

  • Receipt JSON - Original JSON string returned by the Google Play IAB API.

  • Signature - Signature returned by the Google Play IAB API.

  • Tag - A string to differentiate requests.

  • ​CustomData - Additional data to include in the request.



IOS Store

  • Validate IOS Receipt - Validates with the Apple store that the receipt for an iOS in-app purchase is valid and that it matches the purchased catalog item.

  • Currency Code - Currency used for the purchase.

  • Purchase Price - Amount of the stated currency paid for the object.

  • Receipt Data - Base64 encoded receipt data, passed back by the App Store as a result of a successful purchase.

  • ​Tag - A string to differentiate requests.

  • CustomData - Additional data to include in the request.

Conditions

The following condition groups:

  • Google Play

  • iOS Store

press to zoom

press to zoom
1/1

Real Currency : Google Play

  • On Validate Store Purchase - Triggers when the On Validate Google Play Purchase Succeeded.


  • On Validate Store Purchase Error - Triggers when the On Validate Google Play Purchase Failed.

Real Currency : IOS Store

  • On Validate IOS Receipt - Triggers when the On Validate IOS Receipt Succeeded.


  • On Validate IOS Receipt Error - Triggers when the On Validate IOS Receipt Failed.

Expressions

press to zoom

press to zoom
1/1

The following expression groups:

  • Server Response

  • Request

Request

  • Tag - Return the "Tag" of the latest request.


Server Response

  • ServerResponse - Return the "Server Response" from every request from the PlayFab Server. The server response can also be shown in the "Chrome Developer Tools : Console", if in "debug mode".


  • CustomData - Return the "Custom Data" of the latest request.

Object   Properties

Plugin Properties

1/0
 
 

Showcase

There is currently nothing to show, we will add more in the future.

 

Game Projects 

Instructions Kit

Construct 3 Project
Construct 3 Project

press to zoom
Construct 2 Project
Construct 2 Project

press to zoom
Construct 3 Project
Construct 3 Project

press to zoom
1/2

Specifications

  • Instructions - The game project contains instructions and steps on how to use the addon and its features.

  • Action, Conditions and Expressions - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks on the recommended ways of using the addon.

Supporters

Only