Send Request for Payment

To send FedNow and Real-Time Payments (RTP) Request for Payments (RfP) from the payee to multiple payers as a batch file, you need to create a batch file that adheres to the ISO 20022 format (or another format your payment processor or bank supports). Below is a guide to creating, structuring, and sending a batch Request for Payment file.

1. Batch File Structure Overview

In a batch Request for Payment, you include multiple transactions (or payment requests) in one file. The ISO 20022 message type used for batch processing is typically Pain.013 for Request for Payment (RfP).

For example, a batch file contains multiple payment instructions, each corresponding to a different payer. Each transaction includes:

• Payee details (your business).
• Payer details (customer or debtor).
• Transaction amount.
• Remittance information (e.g., invoice numbers).

2. Example of ISO 20022 Batch Request for Payment (Pain.013)

Here’s an example of how to structure a batch Pain.013 file in ISO 20022 format:

xml

<Document>

  <CstmrCdtTrfInitn>

    <GrpHdr>

      <MsgId>BatchRequest001</MsgId>

      <CreDtTm>2024-09-15T12:00:00</CreDtTm>

      <NbOfTxs>3</NbOfTxs>

      <CtrlSum>4500.00</CtrlSum> <!-- Total sum of all transactions -->

    </GrpHdr>

 

    <!-- First Payment Request -->

    <PmtInf>

      <PmtInfId>PmtInf001</PmtInfId>

      <PmtMtd>TRF</PmtMtd>

      <ReqdExctnDt>2024-09-15</ReqdExctnDt>

 

      <Dbtr>

        <Nm>Customer One</Nm>

        <PstlAdr>

          <Ctry>US</Ctry>

          <AdrLine>123 Main St</AdrLine>

        </PstlAdr>

      </Dbtr>

      <DbtrAcct>

        <Id>

          <IBAN>US1234567890</IBAN>

        </Id>

      </DbtrAcct>

 

      <Cdtr>

        <Nm>Your Business Name</Nm>

        <PstlAdr>

          <Ctry>US</Ctry>

          <AdrLine>789 Business Ave</AdrLine>

        </PstlAdr>

      </Cdtr>

      <CdtrAcct>

        <Id>

          <IBAN>US9876543210</IBAN>

        </Id>

      </CdtrAcct>

 

      <Amt>

        <InstdAmt Ccy="USD">1500.00</InstdAmt>

      </Amt>

 

      <RmtInf>

        <Ustrd>Invoice #001</Ustrd>

      </RmtInf>

    </PmtInf>

 

    <!-- Second Payment Request -->

    <PmtInf>

      <PmtInfId>PmtInf002</PmtInfId>

      <PmtMtd>TRF</PmtMtd>

      <ReqdExctnDt>2024-09-15</ReqdExctnDt>

 

      <Dbtr>

        <Nm>Customer Two</Nm>

        <PstlAdr>

          <Ctry>US</Ctry>

          <AdrLine>456 Secondary St</AdrLine>

        </PstlAdr>

      </Dbtr>

      <DbtrAcct>

        <Id>

          <IBAN>US2234567890</IBAN>

        </Id>

      </DbtrAcct>

 

      <Cdtr>

        <Nm>Your Business Name</Nm>

        <PstlAdr>

          <Ctry>US</Ctry>

          <AdrLine>789 Business Ave</AdrLine>

        </PstlAdr>

      </Cdtr>

      <CdtrAcct>

        <Id>

          <IBAN>US9876543210</IBAN>

        </Id>

      </CdtrAcct>

 

      <Amt>

        <InstdAmt Ccy="USD">2000.00</InstdAmt>

      </Amt>

 

      <RmtInf>

        <Ustrd>Invoice #002</Ustrd>

      </RmtInf>

    </PmtInf>

 

    <!-- Third Payment Request -->

    <PmtInf>

      <PmtInfId>PmtInf003</PmtInfId>

      <PmtMtd>TRF</PmtMtd>

      <ReqdExctnDt>2024-09-15</ReqdExctnDt>

 

      <Dbtr>

        <Nm>Customer Three</Nm>

        <PstlAdr>

          <Ctry>US</Ctry>

          <AdrLine>789 Tertiary St</AdrLine>

        </PstlAdr>

      </Dbtr>

      <DbtrAcct>

        <Id>

          <IBAN>US3234567890</IBAN>

        </Id>

      </DbtrAcct>

 

      <Cdtr>

        <Nm>Your Business Name</Nm>

        <PstlAdr>

          <Ctry>US</Ctry>

          <AdrLine>789 Business Ave</AdrLine>

        </PstlAdr>

      </Cdtr>

      <CdtrAcct>

        <Id>

          <IBAN>US9876543210</IBAN>

        </Id>

      </CdtrAcct>

 

      <Amt>

        <InstdAmt Ccy="USD">1000.00</InstdAmt>

      </Amt>

 

      <RmtInf>

        <Ustrd>Invoice #003</Ustrd>

      </RmtInf>

    </PmtInf>

 

  </CstmrCdtTrfInitn>

</Document>

Key Fields:

• GrpHdr (Group Header): Contains overall batch details like the total number of transactions (NbOfTxs) and total amount (CtrlSum).
• PmtInf (Payment Information): Contains individual payment requests.
  • Dbtr (Debtor): The payer (customer).
  • Cdtr (Creditor): The payee (your business).
  • Amt: The amount of the payment request.
  • RmtInf (Remittance Information): Unstructured data such as invoice numbers.

3. Creating Batch Files in Other Formats

CSV Example:

csv

MsgId,DebtorName,DebtorIBAN,CreditorName,CreditorIBAN,Amount,Currency,InvoiceNumber

BatchRequest001,Customer One,US1234567890,Your Business Name,US9876543210,1500.00,USD,INV001

BatchRequest001,Customer Two,US2234567890,Your Business Name,US9876543210,2000.00,USD,INV002

BatchRequest001,Customer Three,US3234567890,Your Business Name,US9876543210,1000.00,USD,INV003

JSON Example:

json

{

  "BatchRequest": {

    "MsgId": "BatchRequest001",

    "CreationDateTime": "2024-09-15T12:00:00",

    "NumberOfTransactions": 3,

    "Transactions": [

      {

        "PaymentInfoId": "PmtInf001",

        "Debtor": {

          "Name": "Customer One",

          "IBAN": "US1234567890"

        },

        "Creditor": {

          "Name": "Your Business Name",

          "IBAN": "US9876543210"

        },

        "Amount": {

          "Currency": "USD",

          "Value": 1500.00

        },

        "RemittanceInformation": {

          "Unstructured": "Invoice INV001"

        }

      },

      {

        "PaymentInfoId": "PmtInf002",

        "Debtor": {

          "Name": "Customer Two",

          "IBAN": "US2234567890"

        },

        "Creditor": {

          "Name": "Your Business Name",

          "IBAN": "US9876543210"

        },

        "Amount": {

          "Currency": "USD",

          "Value": 2000.00

        },

        "RemittanceInformation": {

          "Unstructured": "Invoice INV002"

        }

      },

      {

        "PaymentInfoId": "PmtInf003",

        "Debtor": {

          "Name": "Customer Three",

          "IBAN": "US3234567890"

        },

        "Creditor": {

          "Name": "Your Business Name",

          "IBAN": "US9876543210"

        },

        "Amount": {

          "Currency": "USD",

          "Value": 1000.00

        },

        "RemittanceInformation": {

          "Unstructured": "Invoice INV003"

        }

      }

    ]

  }

}

4. Sending the Batch File to Payers

Once you have created your batch Request for Payment (RfP) file in the desired format (ISO 20022 XML, CSV, or JSON), you can follow these steps to send it to your payers via your bank or payment processor.

Steps:

1. Upload the File to Your Bank or Payment Processor:
   • Log in to your bank’s FedNow or RTP portal.
   • Upload the batch file (XML, CSV, or JSON) that contains the payment requests for each customer.
   • Review and confirm the details before sending the requests.

Some banks or payment providers also offer APIs to automate this process, where you can programmatically submit batch files.

2. Send Request for Payment Notifications:
   • After uploading, your bank will typically notify the payers (debtors) of the payment requests. They will receive a real-time notification or email depending on how the bank or RTP system is set up.
   • Customers will have the opportunity to accept the request and initiate payment through the instant payment network (FedNow or RTP).
3. Monitor the Status of Payments:
   • Use your bank’s platform or an integrated payment monitoring tool to track the status of each request.
   • Once the payment is completed, you will receive confirmations from the RTP or FedNow system, which can also be imported back into your accounting system, such as QuickBooks Online, for reconciliation.

Final Thoughts

By structuring your Request for Payments (RfP) in a batch file format like ISO 20022, CSV, or JSON, and sending it through FedNow or RTP-supported banks, you can streamline payment requests for multiple customers. Ensure that your batch file adheres to the necessary standards to avoid processing issues.

If you need help generating batch files or setting up an automated process, feel free to ask!