How is PayFac Integration Different?

Document created by jordanbarhorst on May 10, 2016Last modified by lsolheim on Nov 12, 2018
Version 5Show Document
  • View in full screen mode

As explained in developing applications for Payment Facilitators, there are a number of business and technical requirements that make payment facilitation different. These include more stringent PCI requirements and increased complexity around underwriting and risk. Companies operating as Payment Facilitators also need to provide sub-merchants with self-service access to statements of their sales, as well as timely funding for their activities.


From a developer perspective, the transactional aspects of processing payments are largely the same as with any other payment integration. Developers will probably want to consider Worldpay’s eCommerce platform to support payment transactions in their application.


PayFac® integrations can be involved, and developers are urged to consult with a Worldpay solution consultant before they get started with their integration.


Developers may need to use additional APIs to facilitate onboarding, managing and funding sub-merchants. While small Payment Facilitators may be able to manually enter and manage information about their sub-merchants using the Vantiv PayFac Portal, as the number of sub-merchants becomes large, developers will want to use the PayFac API to onboard and manage sub-merchants.


1. The PayFac API


The PayFac API is an XML based, RESTful API that is associated with Worldpay’s eCommerce platform. The API can be used by developers to create and update legal entitles and sub-merchants as well as retrieve information about legal entities and sub-merchants in near real time. It can also be used to delete sub-merchants should the need arise.


You can learn more about Worldpay’s PayFac API and review code examples here.


Worldpay ONE members can obtain more information about the Worldpay PayFac API in the following documents:



2. Funding sub-merchants


Paying sub-merchants is a second major area of functionality that will have impact on how the developer builds the payment application. Worldpay supports two distinct payout solutions to address these challenges:


  • Dynamic Payout: Controls the distribution of funds using flexible, customized instructions defined by the Payment Facilitator.
  • Managed Payout: Automatically directs the distribution of funds using pre-configured instructions.


Our payout solutions provide a closed loop transaction lifecycle from payment to payout. Managed Payout is a self-contained service whereas Dynamic Payout is a solution platform.


Managed Payout


In a Managed Payout scenario, fee profiles are established using the Worldpay PayFac portal to allow a Payment Facilitator to create their own fee structures for approved or declined Authorization, Capture or Refund instructions by card type or for eChecks. Payment Facilitators have the flexibility to levy flat rate charges, percentage-based charges or a combination of the two.


Dynamic Payout


In the case of a Dynamic Payout scenario, Payment Facilitators will board sub-merchants and submit transactions normally. Funds from settled transactions accumulate in an FBO account (“for the benefit of”).


In this case, the Payment Facilitator takes the responsibility of distributing funds to sub-merchants (and to themselves) by submitting a batch file containing funds transfer instructions. The developer has a major role in this payment scenario, since they will need to generate the LitleXML formatted funding instructions based transaction histories and the payout agreements that the Payment Facilitator has with sub-merchants (daily, weekly, monthly etc.)


The Dynamic Payout functionality relies on LitleXML batch functionality on Worldpay’s eCommerce platform.


Additional LitleXML instructions documented in the Litle XML Reference Guide facilitate these payout instructions. As examples:


<payFacCredit> - used for a Payment Facilitator to fund themselves from the settlement account

<payFacDebit> - used for a Payment Facilitator to return funds if necessary to the settlement account

<submerchantCredit> - used to provide funding to a sub-merchant

<submerchantDebit> - used to debit a sub-merchant account


Additional details about how developers can use PayFac Dynamic Payout facilities are available to Worldpay ONE members in Appendix D to the LitleXML reference guide.


Learn about how you can get started working with Worldpay to build or integrate your payment facilitation solution.


Learn about PCI requirements for PayFac applications.

3 people found this helpful