Funding Instruction Example

Document created by jordanbarhorst on May 10, 2016Last modified by gjsissons on May 18, 2016
Version 5Show Document
  • View in full screen mode

Vantiv performs a front-end check on each Funding Instruction Batch, verifying the account balances are adequate to cover the net money movement from each account. If there are insufficient funds in any account impacted by the funding instructions, the entire Batch is rejected. The returned error message provides information about the account lacking funds.

 

For example, you submit a Batch of funding instructions that include a number of reserveCredit and reserveDebit transactions, such that the net funds movement (credits - debits) results in $200,000 being moved from the PayFac Reserve Account to the PayFac Settlement Account. However, the current balance in the Reserve account is only $175,000. The front-end checks detect this situation and reject the entire Batch with a reject message similar to:

 

<litleResponse version="9.0" xmlns="http://www.litle.com/schema" id="691"
response="1" message="Over Balance (Litle ID: 819812345678357001, session
sequence: 2, unique ID: null) not processed - The specified Funding Instructions
would result in a negative balance in your Reserve Account"
litleSessionId="810123456789357102">
</litleResponse>

 

Instruction-Based Funding example

To use Instruction-Based Funding, you must code to LitleXML V9.0 or above. The example below shows a Batch containing the various funding instruction you can use. Do not mix other transaction types in a Batch containing funding instructions.

 

<litleRequest version="10.0" xmlns="http://www.litle.com/schema" numBatchRequests="1">
     <authentication>
          <user>username</user>
          <password>password</password>
     </authentication>
     <batchRequest merchantId="01601" numPayFacCredit="1" payFacCreditAmount="1000" numPayFacDebit="1" payFacDebitAmount="2000" numSubmerchantCredit="1" submerchantCreditAmount="3000" numSubmerchantDebit="1" submerchantDebitAmount="4000" numReserveCredit="1" reserveCreditAmount="5000" numReserveDebit="1" reserveDebitAmount="6000" numVendorCredit="1" vendorCreditAmount="7000" numVendorDebit="1" vendorDebitAmount="8000" numPhysicalCheckCredit="1" physicalCheckCreditAmount="9000" numPhysicalCheckDebit="1" physicalCheckDebitAmount="10000">

<!-- Example of PayFac funding themselves. Funds move from the PayFac Settlement Account to the PayFac Operating Account. -->

<payFacCredit reportGroup="CollectedFees">
     <!-- ID of Submerchant associated with fee - NOT Payfac ID -->
     <fundingSubmerchantId>SomeSubMerchant</fundingSubmerchantId>
     <!-- Your internal tracking number for fund transfer -->
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440000</fundsTransferId>
     <amount>1000</amount>
</payFacCredit>

<!-- Example of PayFac returning money to the settlement account. Funds move from the PayFac Operating Account to the PayFac Settlement Account. -->

<payFacDebit reportGroup="MiscRefunds">
     <fundingSubmerchantId>SomeSubMerchant</fundingSubmerchantId>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440001</fundsTransferId>
     <amount>2000</amount>
</payFacDebit>

<!-- Example of PayFac funding the Submerchant. Funds move from the PayFac Settlement Account to the Submerchant Account. -->

<submerchantCredit reportGroup="SubMerchantPayment">
     <fundingSubmerchantId>SomeSubMerchant</fundingSubmerchantId>
     <submerchantName>Some Merchant Inc.</submerchantName>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440002</fundsTransferId>
     <amount>3000</amount>
     <accountInfo>
          <accType>Checking</accType>
          <accNum>123456789012</accNum>
          <routingNum>114567895</routingNum>
     </accountInfo>
</submerchantCredit>

<!-- Example of PayFac debiting the Submerchant. Funds move from the Submerchant Account to the PayFac Settlement Account. -->

<submerchantDebit reportGroup="SubMerchantRefund">
     <fundingSubmerchantId>SomeSubMerchant</fundingSubmerchantId>
     <submerchantName>Some Merchant Inc.</submerchantName>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440003</fundsTransferId>
     <amount>4000</amount>
     <accountInfo>
          <accType>Checking</accType>
          <accNum>123456789012</accNum>
          <routingNum>114567895</routingNum>
     </accountInfo>
</submerchantDebit>

<!-- Example of PayFac adding money into reserves. Funds move from the PayFac Settlement Account to the Reserve Account. -->

<reserveCredit reportGroup="Reserve">
     <fundingSubmerchantId>SomeSubMerchant</fundingSubmerchantId>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440004</fundsTransferId>
     <amount>5000</amount>
</reserveCredit>

<!-- Example of PayFac getting money from Reserves. Funds move from the Reserve Account to the PayFac Settlement Account. -->

<reserveDebit reportGroup="SubMerchantRefund">
     <fundingSubmerchantId>SomeSubMerchant</fundingSubmerchantId>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440005</fundsTransferId>
     <amount>6000</amount>
</reserveDebit>

<!-- Example of PayFac funding the vendor. Funds move from the PayFac Settlement Account to the Vendor Account. -->

<vendorCredit reportGroup="vendorPayment">
     <fundingSubmerchantId>SomeVendor</fundingSubmerchantId>
     <vendorName>Some Vendor Inc.</vendorName>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440006</fundsTransferId>
     <amount>7000</amount>
     <accountInfo>
          <accType>Checking</accType>
          <accNum>123456789012</accNum>
          <routingNum>114567895</routingNum>
     </accountInfo>
</vendorCredit>

<!-- Example of PayFac debiting the vendor account. Funds move from the Vendor Account to the Payfac Settlement Account. -->

<vendorDebit reportGroup="vendorReturn">
     <fundingSubmerchantId>SomeVendor</fundingSubmerchantId>
     <vendorName>Some Vendor Inc.</vendorName>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440007</fundsTransferId>
     <amount>8000</amount>
     <accountInfo>
          <accType>Checking</accType>
          <accNum>123456789014</accNum>
          <routingNum>114567895</routingNum>
     </accountInfo>
</vendorDebit>

<!-- Example of PayFac funding the Physical Check Account. Funds move from the PayFac Settlement Account to the Physical Check Account -->

<physicalCheckCredit reportGroup="physicalCheck">
     <fundingSubmerchantId>SomeSubMerchant</fundingSubmerchantId>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440008</fundsTransferId>
     <amount>9000</amount>
</physicalCheckCredit>

<!-- Example of PayFac debiting the Physical Check account. Funds move from the Physical Check Account to the PayFac Settlement Account-->

<physicalCheckDebit reportGroup="physicalCheckDebit">
     <fundingSubmerchantId>SomeSubMerchant</fundingSubmerchantId>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440009</fundsTransferId>
     <amount>10000</amount>
</physicalCheckDebit>
</batchRequest>
</litleRequest>

 

Funding Instruction Response

 

<payFacCreditResponse reportGroup="CollectedFees">
     <litleTnxId>82823972759879805</litleTxnId>
     <fundsTransferId>123e4567-e89b-12d3-a456-426655440000</fundsTransferId>
     <response>000</response>
     <responseTime>2014-01-09T20:28:32</responseTime>
     <message>Approved</message>
</payFacCreditResponse>

 

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

 

Next: Void a funding instruction

1 person found this helpful

Attachments

    Outcomes