Facebook Payments Implementation Guide

Overview

Facebook's Local Currency Payments system gives you complete flexibility to price goods in any region specific local currency, at arbitrary price-points. This system provides a straightforward purchase experience for people using your app, maximizes the performance of the payment flow, and makes it easy for you to price virtual goods for a global audience.
This guide, divided in to seven sections, walks you through all the technical implementation details required to add local currency payments to your app. Follow each step of the guide in turn: They follow a logical progression of implementation, from basic getting started steps to advanced topics like handling bank charge backs.

1. Company Registration

Before you can accept payments within your app, you need to register your company information with Facebook.

2. Defining Products

Define products for sale within your app, including different product types and pricing mechanisms.

3. Payment Flow

Enable the purchase flow within your app, letting people make purchases through the Pay dialog using their payment mechanism of choice.

4. Optimizing for Mobile Payments

Learn how to optimize the payment flow for people who pay with mobile.

5. Order Fulfillment

After an order has completed, you need to fulfill the order if the transaction was successful, or handle any error case which may have occurred.

6. Handling Disputes and Refunds

Occasionally, you may need to handle a payment dispute with people using an app. Learn the details of how refunds and charge backs are handled within the local currency payment system.

7. Testing Payments

Once you have your system in place, follow these steps to thoroughly test your implementation before taking it live.

Additional Resources

Reports API

To get daily reports of transaction activity using the new Local Currency Payments system, use thePayments Reports API. It provides reliable, flexible and secure reports at both the summary and per-transaction level. Note that our deprecated email reports system does not cover Local Currency Payments; you must integrate with the Payments Reports API to receive this data.

Trial Pay Offers API

You can enable users to earn virtual currency by directly integrating with TrialPay for offers. A direct integration with TrialPay will allow for quicker load times, more specific reporting, and easier troubleshooting than before. For more information about offering reward based advertising, please visit TrialPay's Facebook Developer Center.

Payer Promotions

The Payer promotions feature lets people input a financial instrument in exchange for free items.

Currency Formatting

All currencies are formatted using the US standard without commas. Examples: "1.20", "10.50", "1000"
Was this document helpful?