Payments update
by Abhishek Doshi - February 10, 2012 at 4:05pm

We have a few updates for developers using Payments on Facebook Platform, including updates to the Pay Dialog, payout reports as well as payer promotions.

Payer Promotions

Facebook has begun sponsoring promotions to help developers convert game players into paying users. We are currently running an offer to encourage game players to make a first-time purchase using their credit card or PayPal account. This offers allows the user to earn $4 of value for free by purchasing 10 Facebook Credits at the regular price of $1. Users outside the US will see the same offer expressed in their local currency.

There are two versions of this offer currently running on the platform. The first version is available to users through TrialPay's Offerwall and DealSpot products. In this version, the $4 free value is redeemed by the user in in-app currency if the developer has implemented in-app currency offers in their application. We highly encourage developers to implement in-app currency offers to get maximum value from such promotions. To learn how to get started please start here. If the developer has not implemented in-app currency offers in their application, the user will redeem the $4 free value in Facebook Credits.

The second version of this offer will be displayed to select users onsite through Facebook's promotional units. In this version, the user always redeems the $4 free value in Facebook Credits.

Please note that these promotions are being sponsored by Facebook. Developers will be paid out their full revenue share for purchases made by the user. If you want to maximize your user conversion and revenue uplift, please implement in-app currency offers. In addition, please keep in mind that this current offer is only available to select users who may not have previously purchased on Facebook and requires the user to make their $1 purchase using their credit card or PayPal account. Finally, we will evolve these promotions over time to better grow our ecosystem.

Updates to the Pay Dialog

We're doing some housekeeping to make it easier for developers to invoke the Pay Dialog. Specifically, we're introducing a new Pay Dialog property called action. This new property more simply allows developers to specify the Pay Dialog's purpose. For example, the action value buy_item is for invoking a Pay Dialog for the purpose of buying a developer's item. An alternative example is the action value buy_credits which invokes a Pay Dialog for the purpose of buying credits.

The following table summarizes the usage, previous invocation, and new invocation using the action property. Please note that this is not a breaking change. If you are already using the Pay Dialog, everything will continue to work as before. Also the Pay Dialog property dev_purchase_params continues to be supported. For more details please refer to the Pay Dialog usage notes.

Usage New Old
Buy item priced in local currency (e.g. USD) function buy() {
  var obj = {
   method: 'pay',
   action: 'buy_item',
   order_info:
    SOME_DEV_JS_OBJECT_ORDER_INFO
   dev_purchase_params:
    {'oscif': true}
  };
  FB.ui(obj, js_callback);
}
function buy() {
  var obj = {
   method: 'pay',
   purchase_type: 'item',
   order_info:
    SOME_DEV_JS_OBJECT_ORDER_INFO
   dev_purchase_params:
    {'oscif': true}
  };
  FB.ui(obj, callback);
}
Buy item priced in credits as a currency function buy() {
  var obj = {
   method: 'pay',
   action: 'buy_item',
   order_info:
    SOME_DEV_JS_OBJECT_ORDER_INFO
  };
  FB.ui(obj, js_callback);
}
function buy() {
  var obj = {
   method: 'pay',
   purchase_type: 'item',
   order_info:
    SOME_DEV_JS_OBJECT_ORDER_INFO
  };
  FB.ui(obj, callback);
}
Buy credits priced in local currency (e.g. USD) function buy() {
  var obj = {
   method: 'pay',
   action: 'buy_credits'
  };
  FB.ui(obj, js_callback);
}
function buy(){
  var obj = {
   method: 'pay',
   credits_purchase: true
  };
  FB.ui(obj, callback);
}
Earn credits by completing advertiser offers function buy() {
  var obj = {
   method: 'pay',
   action: 'earn_credits'
  };
  FB.ui(obj, js_callback);
}
function buy(){
  var obj = {
   method: 'pay',
   credits_purchase: true,
   dev_purchase_params:
    {'shortcut': 'offer'}
  };
  FB.ui(obj, callback);
}
Earn in-app currency by completing advertiser offers function buy() {
  var obj = {
   method: 'pay',
   action: 'earn_currency',
   product:
    'URL_TO_APP_CURR_WEBPAGE'
  };
  FB.ui(obj, js_callback);
}
Not applicable.

Updates to payout reports

We have added a new transaction type to our payments detailed payout reports. The new 'K' transaction type represents a chargeback reversal. Currently when you see a chargeback or 'C' transaction type, the amount of the transaction is deducted from your net payout. When a chargeback is reversed, you will now see a new 'K' which designated the chargeback has been reversed and you should add the amount associated with that order back to your net payout during reconciliation. Please see our reporting documentation for more details.

Please provide your thoughts and feedback in the comments below.