SysRecordTransaction

Records a manual transaction. Useful for stores that are not yet directly supported -- or for apps that doing purchases via other means - but still want to record them in brainCloud for reporting purposes.

Service	Operation
appStore	SYS_RECORD_TRANSACTION

Method Parameters

Parameter	Description
profileId	Profile ID of the user.
storeId	Identifies the store type. See the appendix for Store Ids. Use "_id" (prefix with an underscore) for custom ids.
itemId	Item ID of the product transaction to be recorded.
dataJson	Transaction details from the store's perspective.
receiptData	Receipt information.
promotionId	Optional ID of any promotion that applies.
processAwards	Whether to deliver rewards/items.
transactionId	Unique id identifying this transaction in the store. Uniqueness enforced across the app.
price	Price in hundredths of the app's currency (e.g. cents)
sandbox	Whether purchase is sandbox.
platform	Platform of the store, platform is only used for sending offboard events to downstream systesm. Can be empty string - or use value from platform ids here

Usage

http://localhost:3000

C#

// Cloud Code only. To view example, switch to the Cloud Code tab

C++

// Cloud Code only. To view example, switch to the Cloud Code tab

Objective-C

// Cloud Code only. To view example, switch to the Cloud Code tab

Java

// Cloud Code only. To view example, switch to the Cloud Code tab

JavaScript

// Cloud Code only. To view example, switch to the Cloud Code tab

Dart

// Cloud Code only. To view example, switch to the Cloud Code tab

Cloud Code

var profileId = "user_profile_id";
var storeId = "store_id";
var itemId = "product_item_id";
var dataJson = {'quantity': 1};
var receiptData = {'receipt': 'receipt_String'};
var promotionId = 5;
var processAwards = true;
var transactionId = "transaction_id";
var priceInCents = 999;
var sandbox = False;
var platform = "IOS";

var appStoreProxy = bridge.getAppStoreServiceProxy();

var postResult = appStoreProxy.sysRecordTransaction(profileId, storeId, itemId, dataJson, receiptData, promotionId, processAwards, transactionId, priceInCents, sandbox, platform);

Raw

{
    "service":"appStore",
    "operation":"SYS_RECORD_TRANSACTION",
    "data":{
        "profileId": "user_profile_id",
        "storeId": "store_id",
        "itemId": "product_item_id",
        "dataJson" : {
            "quantity": 1
        },
        "receiptData" : {
            "receipt": "receipt_String"
        },
        "promotionId" : 5,
        "processAwards" : true,
        "transactionId" : "transaction_id",
        "price" : 999,
        "sandbox" : false,
        "platform" : "IOS"
    }
}

JSON Response

{
    "data": {
        "userItemRewards": {
            "sword001": {
                "fac9e483-c958-46b9-a478-06c97a85e74a": {
                    "itemId": "fac9e483-c958-46b9-a478-06c97a85e74a",
                    "quantity": 1
                }
            }
        },
        "extra": {
            "customAttr": "value"
        },
        "rewards": {
            "extra": {
                "customAttr": "value"
            },
            "currency": {
                "bar": 10
            },
            "items": {
                "sword001": {
                    "defId": "sword001",
                    "quantity": 1
                }
            }
        },
        "currencies": {
            "currency": {
                "bar": {
                    "consumed": 0,
                    "balance": 30,
                    "purchased": 10,
                    "awarded": 20,
                    "revoked": 0
                },
                "coins": {
                    "consumed": 0,
                    "balance": 24,
                    "purchased": 0,
                    "awarded": 24,
                    "revoked": 0
                }
            }
        }
    },
    "status": 200
}