Ask Moov Beta
Generative AI is experimental and can make mistakes.
Guides Use cases API Changelog
  1. Guides
  2. Money movement
  3. Send payments

Instant payments with RTP

Instantly send funds from a Moov wallet to a bank account with RTP.

Instant payments, enabled by The Clearing House, are real time payments (RTP) between bank accounts. With instant payments, transfers are processed instantly, 24/7/365.

With Moov, supported bank accounts can receive instant transfers from a Moov wallet.

Standard instant funds flow diagram
In the near future, instant-bank-credit will support FedNow, The Federal Reserve's instant payment method.

Bank account eligibility

When a bank account is linked, Moov checks its eligibility to receive payments on the RTP network and creates the instant-bank-credit payment method.

To send instant payments, accounts must have the send-funds.instant-bank and wallet.balance capabilities enabled.

Money out

Funds leave the Moov platform with instant credits when using the instant-bank-credit payment method. Once funds are sent, the transfer is final and cannot be reversed. Moov has a platform transaction limit of $100,000.00 for instant bank credit.

Wallet to bank instant bank flow diagram

The benefits of sending funds with instant bank credit:

  • Transfers can be sent instantly, anytime - even on weekends and bank holidays
  • Funds are available to the recipient in moments
  • Moov wallet balances are immediately decreased

Processing and status details

The transfers response offers a variety of useful information about instant transfers and status details. If the destination uses the instant-bank-credit payment method, the response will contain instantBankDetails, indicating which network was used as well as the following useful information:

  • status - Rail-specific status details
  • failureCode - Moov designated failure explanation
{
  "instantBankDetails": {
    "network": "rtp",
    "status": "completed",
    "initiatedOn": "2025-08-08T19:45:12Z",
    "completedOn": "2025-08-08T19:45:45Z",
    "failedOn": null, 
    "acceptedWithoutPostingOn": null,
    "failureCode": null, 
    "networkResponseCode": "ACTC", 
    "endToEndID": "E2E123456789",
  }
}

Additionally, you can obtain details about a transfer through the transfers GET endpoint.

Statuses

Find rail-specific transfer status information within instantBankDetails:

Transfer status Description
initiated The payment has reached the rail, but Moov has not yet received a response
accepted-without-posting Moov has received an accepted without posting message from the receiving bank, as they need more time to process the payment. The funds are moved but are not yet available to the recipient.
completed Moov has received an accepted message from the receiving bank, and funds are available to the recipient
failed Moov has received a rejected message from the receiving bank. The failure code, reason, and description is provided in the transfer response.

Failure codes

If there is an issue with a bank account, Moov automatically adjusts the status. If you receive an errored bank account status, you will need to take the following action before you can continue processing with Moov:

Below you'll find the details on failure codes and the action you'll need to take.

Failure code Description Status: action
account-blocked Account is blocked. Transactions cannot be posted against it. errored: Add new account
account-closed Account is closed. errored: Add new account
customer-deceased Customer is deceased. errored: Add new account
invalid-account Account number is invalid or missing. errored: Add new account
invalid-amount Amount entered is invalid. No action needed
invalid-field A field entry could not be validated. No action needed
limit-exceeded Amount entered exceeds approved amount. No action needed
processing-error Transaction could not be processed due to processing error. No action needed
transaction-not-supported Transaction is not supported. No action needed

Refer to the The Clearing House's Message Status Report appendix for the latest ISO RTP error codes (networkReasonCode).

RTP credit

The rtp-credit payment method is still currently supported, though Moov strongly suggests using instant-bank-credit instead. The rtp-credit payment method will be deprecated in the future.

Creating transfers with the instant-bank-credit payment method is supported for API versions 2026.04.00 and higher.

Instant payments on the RTP rail are enabled by The Clearing House and processed almost immediately, 24/7/365. The rtp-credit payment method is added to qualifying bank accounts.

Wallet to bank RTP flow diagram

Once funds are sent, the transfer is final and cannot be reversed. Moov has a platform transaction limit of $10,000,000.00 for RTP credit. If a transfer uses the rtp-credit payment method, the response will include rtpDetails:

{
  "rtpDetails": {
    "status": "completed",
    "initiatedOn": "2025-08-08T19:45:12Z",
    "completedOn": "2025-08-08T19:45:45Z",
    "failedOn": null, 
    "acceptedWithoutPostingOn": null,
    "failureCode": null, 
    "networkResponseCode": "ACTC"
  }
}

Additionally, you can obtain details about a transfer through the transfers GET endpoint.

Summary Beta