Facebook Payments

The most effective way for developers to generate revenue in games and apps on Facebook

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.

• Facebook users trust the Facebook brand and feel comfortable storing their payment information with Facebook and buying with their Facebook credentials.
• Facebook Payments is available internationally and supports 80+ payment methods in 50+ countries around the world and we continue to actively expand our footprint.

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!

Facebook Payment Flows

Facebook offers a payments platform that enables developers to leverage our payments services to charge their users on Apps on Facebook as well as their Mobile web Applications.

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.

• If the user has sufficient credits balance then the user sees a confirmation dialog where they need to confirm the transaction before the order will get fulfilled.

• If the user does not have sufficient balance then the user is asked to pick the payment method to pay for the required number of credits. There are several payment methods available to users depending on their location, and rendering may differ depending on a user's currency setting, so this screen will vary for users based on their locale and currency preferences.

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.

Facebook Payments on Mobile

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 the mobile web (including mobile web apps linked from Android), you must use Facebook Payments.
• On iOS, you must build a native app and use iTunes payments.

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.

---

Earning in-app currency via Offers

Using the Facebook Credits API, you can directly link users to Facebook’s Offers flow, in partnership with TrialPay:

1. 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.

2. 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.

Get Started

For integration details and best practices, please refer to the following resources:

Facebook Payments Getting started Tutorial

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.