TrialPay PayVault Provider
Setting up your TrialPay account
- Sign up as a Web Developer on https://merchant.trialpay.com/register/
- Create a new Virtual Currency product, and fill out the Basic information as you like.
- On the next setup page, you need to enter the Callback url. This url is specific per game, and you can find it on the Payvault configuration page in the Games Control Panel for your game.
- On the same page, you also need to change the Parameters textfield so it contains exactly this:
oid=%oid%
sid=%sid%
reward_amount=%reward_amount%
revenue=%revenue% - The rest of the setup pages you can fill out as you like, just remember to submit your campaign for approval before going live.
Configuring TrialPay on PlayerIO
- Enable TrialPay in the PayVault Control Panel for your game.
- Enter your notification key in the "TrialPay Notification Key" field. You can find this value under Notification Preferences on the My Account page on TrialPay.
- Enter the integration code into the "TrialPay Integration Code" field. Click on "Get Integration Code" for your campaign in the Product Console and you will come to a page showing some sample code for your offers IFrame. The integration code is the part of the url between 'dispatch/' and '?sid='.
Buying Coins: GetBuyCoinsInfo()
Example of buying coins with TrialPay in ActionScript 3:
GetBuyCoinsInfo() Arguments | |
---|---|
There are no required or optional arguments for this provider. You can customize the look of your offer page by editing your campaign on the Product Console page on TrialPay. | |
Result Values | |
trialpayurl | The URL the user should visit to earn Coins. You can show this in a popup or an IFrame. |
Setting up your TrialPay account for Dealspot item-based rewards
If you have got a product for Dealspot item-based rewards, follow these instruction to set up the Product Delivery page:
- Check "I will take care of activation"
- Choose to be notified by Script
- Enter the Callback url. This url is specific per game, and you can find it on the Payvault configuration page in the Games Control Panel for your game.
- Add piotid as a custom parameter through the drop-down in the Parameters textfield, and then make sure it contains exactly this:
oid=%oid%
sid=%sid%
revenue=%revenue%
piotid=%piotid%
tp_item_name=%tp_item_name% - The rest of the setup pages you can fill out as you like.
Configuring TrialPay on PlayerIO for Dealspot item-based rewards
- Enable TrialPay in the PayVault Control Panel for your game.
- Enter your notification key in the "TrialPay Notification Key" field. You can find this value under Notification Preferences on the My Account page on TrialPay.
- Enter anything into the "TrialPay Integration Code" field.
- Enable the Facebook payment provider, and make sure to enter your Facebook App Id in the correct field there.
- All the PayVault items that you want to be able to reward through Dealspot also needs to be marked as such in the PayVaultItems table.
Simply add a property named DealspotReward with the type Bool and the value true to each item.
Buying Items: GetBuyDirectInfo()
Example of buying an item directly with PayPal in ActionScript 3:
Required GetBuyDirectInfo() Arguments | |
---|---|
sid | The Facebook third-party uid for your user. |
tp_item_name | The description of the purchase as it will be presented to the user |
Optional GetBuyDirectInfo() Arguments | |
secure | If this value is set to "true", the resulting Dealspot URL will be a https URL. |
tp_show_item_interstitial | These arguments can be used to customize the Dealspot overlay. For more info, see the Optional Parameters section in the Trialpay Help Center: http://help.trialpay.com/credits/?p=560. |
tp_item_image_url | |
position_top | |
position_left | |
zIndex | |
tp_item_desc | |
img_url | |
hover_img_url | |
Result Values | |
dealspoturl | The URL to the dealspot.swf overlay, including all the querystring parameters it needs. |
app_id | The following values can be used if you launch the Dealspot overlay through the javascript function. |
sid | |
tp_item_name | |
piotid |