Facebook Developers
DocsToolsSupportNewsApps
Log In
  • Social Plugins
  • Facebook Login
  • Open Graph
  • Facebook APIs
  • Games
  • Media
  • Payments
  • App Center
  • Promote Your App
  • iOS
  • Android
  • Web
  • Technology Partners
  • Getting Started
    • Local Currency Payments
    • Payments Best Practices
    • Local Currency Payments FAQ
  • Tutorial
    • How-to: Local Currency Payments
    • 1. Company Registration
    • 2. Defining Products
    • 3. User Payment Flow
    • 4. Order Fulfillment
    • 5. Handling Disputes and Refunds
    • 6. Testing Payments
  • Reference
    • Product Object
    • Pay Dialog
    • Mobile Price Points and Shortcutting
    • Payments Reports
    • Supported Currencies
    • Error Codes
    • Payment Methods
    • Payments payout FAQ
  • Subscriptions
    • Subscriptions Overview
    • Subscriptions Tutorial
  • Credits (deprecated)
    • Payments Tutorial
    • Pay Dialog
    • Payments Callback
    • Order API
    • Error Codes
    • Display prices in user's currency
    • Pay with Mobile APIs
    • In-App Currency Orders
    • Offers with Payments
    • Payer Promotions
    • Disputes & Chargebacks
You are viewing an older version of this page.


We are transitioning all canvas game developers away from Facebook Credits to local currency payments by September 12, 2013, 90 days after breaking change announcement. The new payments system simplifies the purchase experience for users, improves the performance of the payment flow, and makes it easier for developers to price virtual goods for a global audience. For more information, please see our local currency payments overview.

Error Codes

The following section covers the respective errors with the Frontend API and Backend API.

Front End Error Codes

Error_codeError_messageNote
1383001UnknownFacebook system issue.
1383002InvalidParametersDeveloper called with the incorrect parameters.
1383003PaymentFailureProcessor decline.
1383004InvalidOperationDeveloper attempted an operation Facebook does not allow.
1383005PermissionDeniedFacebook system issue.
1383006DatabaseErrorFacebook system issue.
1383007InvalidAppApp is not whitelisted. Or while in test mode, Developer attempted to debit a user that was not whitelisted.
1383008AppNoResponseApp is not responding; perhaps a server timeout issue.
1383009AppErrorResponseApp responded to Facebook with an error code.
1383010UserCanceledUser explicitly cancelled out of flow.
1383011DisabledFacebook system issue.
1383013OrderFailureAfterPurchaseCreditFacebook system issue.
1383014DisputeFlowFacebook system issue.
1383015AccountNotChargedYour application cancelled the order.
1383017ExceedCreditBalanceLimitReached maximum number of credits the user is allowed to keep as a stored balance. This is a Facebook controlled limit and can vary from user to user.
1383018ExceedCreditDailyPurchaseLimitOccurs when a user has reached a predefined daily maximum
1383019ExceedCreditDailySpendLimitOccurs when the credit amount user spends in a single day exceeds a pre-defined threshold.
1383040UserThrottledApplication Temporarily Unavailable
1383041BuyerPaymentFailureUser's financial instrument could not be charged.
1383042LoggedOutUserLogin Required
1383043AppInfoFetchFailureFacebook system error.
1383044InvalidAppInfoApplication needs to have a valid callback url.
1383045AppInvalidEncodedResponseThe application didn't return a valid json encoded response..
1383046AppInvalidDecodedResponseThe application return value was invalid after json_decoding the return value.
1383047AppInvalidMethodResponseThe application response contains a 'method' parameter that didn't match the request.
1383048AppMissingContentResponse The application response didn't contain the 'content' field.
1383049AppUnknownResponseErrorThe application returned an unknown response.
1383050AppUserValidationFailedResponseFailure to verify the user when sending application callback.
1383051AppInvalidItemParamThe application is sending invalid item parameters (For example, price or quantity of the items is invalid).
1383052EmptyAppIdEmpty App ID.

Back End Error Codes

The following errors can be returned in addition to the regular API exceptions:

Error CodeError NameNote
1150API_EC_PAYMENTS_UNKNOWNUnknown error
1151API_EC_PAYMENTS_APP_INVALIDApplication is not enabled for using Facebook Credits.
1152API_EC_PAYMENTS_DATABASEA database error occurred.
1153API_EC_PAYMENTS_PERMISSION_DENIEDPermission denied to check order details.
1154API_EC_PAYMENTS_APP_NO_RESPONSEPayments callback to the application failed.
1155API_EC_PAYMENTS_APP_ERROR_RESPONSEPayments callback to the application received error response.
1156API_EC_PAYMENTS_INVALID_ORDERThe supplied order ID is invalid.
1157API_EC_PAYMENTS_INVALID_PARAMOne of the Payments parameters is invalid.
1158API_EC_PAYMENTS_INVALID_OPERATIONThe operation is invalid.
1159API_EC_PAYMENTS_PAYMENT_FAILEDFailed in processing the payment.
1160API_EC_PAYMENTS_DISABLEDFacebook Credits system is disabled.
1161API_EC_PAYMENTS_INSUFFICIENT_BALANCEInsufficient balance.
1162API_EC_PAYMENTS_EXCEED_CREDIT_BALANCE_LIMITExceed credit balance limit.
1163API_EC_PAYMENTS_EXCEED_CREDIT_DAILY_PURCHASE_LIMITExceed daily credit purchase limit.
1164API_EC_PAYMENTS_EXCEED_CREDIT_DAILY_SPEND_LIMITExceed daily credit spend limit.
1166API_EC_PAYMENTS_INVALID_FUNDING_AMOUNTCredits purchased from funding source do not match the spend order amount.
1167API_EC_PAYMENTS_NON_REFUNDABLE_PAYMENT_METHODThe funding source is a non-refundable payment method.
1168API_EC_PAYMENTS_USER_THROTTLEDApplication is configured to throttle some users.
1169API_EC_PAYMENTS_LOGIN_REQUIREDUser is not logged in.
1170API_EC_APP_INFO_FETCH_FAILUREError retrieving application information.
1171API_EC_INVALID_APP_INFOInvalid application information returned.
1172API_EC_PAYMENTS_APP_INSUFFICIENT_BALANCEApplication has insufficient balance (app2user).
Updated about a week ago
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy