Introduction to Transfer and Transfer UI

Intelligently process transfers between accounts

API Reference

View Transfer requests, responses, and example code

View Transfer API

Quickstart

Learn about Plaid's key concepts and run starter code

Get started

Both Transfer and Transfer UI are currently in closed beta and approval is required to participate. They are only available to senders and recipients based in the United States. If you're interested in learning more about either product and potentially participating in the beta program, please reach out to your Plaid point of contact.

For transfer capabilities with general availability, see Auth.

Transfer and Transfer UI are only supported in Plaid's Sandbox and Production environments.

Overview

Transfer

Transfer (beta) enables developers to seamlessly initiate and manage bank-to-bank payments for loan disbursement or servicing. Transfer makes ACH easy by providing a built-in authorization engine to minimize clawback of funds due to returns. All of this is accomplished with a simple set of APIs so you can get started with ACH quickly and easily.

Transfer is best suited for developers interested in building custom Nacha-compliant user interfaces that require full control of the transfer experience.

Transfer UI

Transfer UI (beta) is an intuitive user interface that enables end users to authorize transfers within your application. It is easy to integrate and fully handles the transfer execution experience for you. It also utilizes the same built-in authorization engine used by Transfer to minimize return risks.

Transfer UI is best suited for developers interested in quickly launching a payments interface that is easy to use.

Transfer process overview

  1. (Optional) Create a Payment Profile using /payment_profile/create and receive a payment_profile_id. While this step is optional, it is recommended to maximize conversion by allowing users to avoid re-entering payment information. We recommend using a Payment Profile if you are not using Transfer UI and do not need to use other Plaid Products with the Item you are creating. Payment Profiles cannot be used with Transfer UI.

  2. Call /link/token/create, specifying transfer in the products parameter. If using a payment profile, provide the payment_profile_id in the transfer.payment_profile_id field and the user's phone number in the user.phone_number field.

  3. Initialize a Link instance using the link_token created in the previous step. For more details for your specific platform, see the Link documentation.

  4. The user will now go through the Link flow. Once they have completed the Link flow, you will receive a public_token from the onSuccess callback. Call /item/public_token/exchange to exchange this public token for an access_token.

  5. Determine the transfer failure risk by calling /transfer/authorization/create and providing the access_token.

  6. Check the authorization.decision. If it is declined, you cannot complete the transfer. If it is approved, check the authorization.decision_rationale field. If authorization.decision_rationale is null, proceed to the next step. If it is non-null, Plaid was unable to collect enough data to make a thorough risk evaluation; decide whether to proceed with creating the transfer based on your own risk assessment protocols.

  7. Create the transfer by calling /transfer/create using the authorization_id received in the previous step. Plaid will execute the transfer and automatically sweep funds into your account once they are available to be swept.

  8. (Optional) To monitor the progress of the sweep, use /transfer/sweep/list and/or /transfer/sweep/get. For more information, see Sweeping funds.

  9. (Optional) To monitor and sync transfer updates, use /transfer/list, /transfer/get, /transfer/event/list, and/or /transfer/event/sync. For more information, see Reconciling transfers.