We are moving from Facebook Credits to local currency pricing, and plan to migrate all game developers on Facebook.com in the third quarter this year. We want to provide ample time for you to review the new documentation. After launch, developers will have a minimum of 90 days to implement the updated payments infrastructure to continue accepting payments. For now, we continue to support Facebook Credits. In the coming weeks, we will provide further updates on when developers can begin integration. Learn more in our local currency FAQs and overview.
Facebook Payments is a payment system that offers a safe, easy and fast way to pay for digital and virtual goods in games and apps across Facebook.
Developers already building on Facebook Platform can use the Graph API and Dialogs to integrate with our payments APIs and get the integration up and running quickly. This enables developers to focus on building their Apps and let us take care of all payments overhead!
You can use Facebook Payments as a payments platform to buy in game virtual currency for your app or game. The user experience looks like below. A user places an order by clicking a button in the application.
In response, the app invokes the Pay dialog along with the order information which provide Facebook the item details. One of the following happens depending on the order and the user's credit balance and credentials on file.
When the user does not have payment credentials on file, the user may get redirected to a new page for entering credentials or may stay within the dialog, depending on the payment type. For example if the user chooses to enter their credit card information then they are redirected to a new page like below, but if they choose to do a mobile payment then it can be processed in the dialog itself.
Once the user confirms their willingness to pay and provides the credentials, Facebook calls the application backend to let the app owner's system settle the order. Once the app responds, Facebook completes the transaction appropriately and shows the result to the user. If the payment was done in the dialog, the user can click continue to close the payment dialog. If the payment was completed on the full page, the user can click continue to go to a destination url set by the app.
The pay dialog can also be rendered in a mobile environment in the same way as it can for Apps on Facebook on desktop. Users have the option to pay with their existing payment credentials, their mobile phone, or our 80+ payment methods. For more information on mobile platform, please see our mobile documentation.
Here is what the payment flow looks like in a mobile browser:
Accepting payments works differently on iOS, since Facebook Payments are not supported within iOS native apps.
On Mobile Web, the only additional step to get up and running with payments is to select the 'Accept Mobile Web Payments' checkbox, as seen below.
On iOS, you can quickly build a native app from your web app by using a tool like PhoneGap.
Using the Facebook Credits API, you can directly link users to Facebook’s Offers flow, in partnership with TrialPay:
Direct Access to Offers: Adding this functionality to your app will give users the chance to earn Facebook Credits by completing offers that matter to them, boosting both engagement and revenue.
DealSpot: DealSpot allows users to access exclusive deals via an in-app icon. From buying flowers for Valentine’s Day to watching trailers for the latest movies, users will be matched to an intelligent rotation of deals, creating an additional revenue stream for credits developers.
Read here for more information.
For integration details and best practices, please refer to the following resources:
NOTE: Per the Facebook Payments Terms, all games on the Facebook Platform (including mobile web apps) must exclusively process payments through Facebook Payments. Games that have not integrated Facebook Payments will be subject to enforcement.