Originations

Overview

For full API reference on RTP originations click here.

Credit Transfers

A credit transfer is method of transferring money between banks in real time via The RTP Network. The minimum information required to send a credit transfer is the COS account number funding the transfer, amount, and creditor information at the receiving bank.

POST /v1/payments

{
  "accountNumber": "1234567890",
  "amount": 100,
  "creditor": {
    "routingNumber": "021000021",
    "accountNumber": "789456123",
    "name": "John Smith"
  }
}

The outbound credit transfer can result in one of the following:

  • The receiving FI rejects the transfer
  • The receiving FI accepts the transfer
  • The receiving FI does not respond

Requests for Payment (RFPs)

The Request for Payment (RFP) message is sent by the Creditor (party requesting funds) to the Debtor (party sending funds if approved) through their respective FIs. This message is used to request the initiation of a Credit Transfer message (a credit payment) from the party that receives the message.

POST /v1/payments/payment-request
{
  "accountNumber": "2686062254",
  "amount": 17500,
  "discount": 0,
  "debtor": {
    "routingNumber": "011000138",
    "accountNumber": "456789000",
    "name": "Peter Griffin",
    "addressStreetName": "Spooner St",
    "addressBuildingNumber": "33",
    "addressCity": "Quahog",
    "addressState": "RI",
    "addressPostalCode": "10025",
    "addressCountry": "US"
  },
  "requestedExecutionDate": "2021-08-17",
  "expiryDate": "2021-08-19"    
}

The outbound RFP can result in one of the following:

  • The receiving FI sends a credit transfer
  • The receiving FI sends an RFP response indicating that the request has been rejected by the debtor
  • The receiving FI sends an RFP response indicating that a credit transfer will be sent
  • The receiving FI ignores the RFP

Did this page help you?