1. Overview
2. Money movement

All transfers facilitated with Moov involve money moving in, out, through, or within the Moov platform. Since all funds flow through Moov, a single transfer can take advantage of multiple payment rails which allows you to tailor the cost, speed, and risk of each payment to your particular use case.

Source

Bank account Same-day ACH

Bank accounts

Same-day ACH Faster ACH*

Debit / credit cards

Card payment

Wallets

Moov Wallet

Destination

Bank account Same-day ACH

Bank accounts

Same-day ACH Standard ACH

Wallets

Moov Wallet

Get transfer options

When initiating a transfer, you’ll need to know what payment methods are available to use since not all payment method combinations are valid. Some payment methods can only be used as the source, and some can only be used as the destination. Available payment methods also depend on the enabled capabilities of the source and destination accounts.

You can use our API to request valid transfer source and destination combinations between accounts. The transfer options POST endpoint takes valid payment method combinations and network-specific restrictions such as maximum payment amounts into account. In practice, transfer options can be used to present a menu of different options for how and where you want money to move.

If you provide an accountID, this endpoint will return you a list of valid payment methods for the source or destination. If you submit an accountID along with paymentmethodID, we will return you a list of valid payment methods based on what you provided. For example, if you’re looking to make a transfer with a specific account and you know the source is a card, you can learn what destination options are available using this endpoint.

In the example below, the information provided will list payment methods filtered on the capabilities of the transfer participants.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

curl -X POST "https://api.moov.io/transfer-options" \
  -H "Authorization: Bearer {token}" \
  --data-raw '{
    "amount": {
      "value": 100,
      "currency": "USD"
    }
    "destination": {
      "accountID": "UUID"
    },
    "source": {
      "accountID": "UUID"
    }
  }'\

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

mc.TransferOptions(ctx, moov.CreateTransferOptions{
  Amount: moov.Amount{
    Currency: "USD",
    Value:    100,
  },
  Source: moov.CreateTransferOptionsTarget{
    AccountID: "UUID",
  },
  Destination: moov.CreateTransferOptionsTarget{
    AccountID: "UUID",
  },
})

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

const moov = new Moov(credentialsObject);

const transferOptions = {
  amount: {
    value: 100, 
    currency: "USD"
  },
  destination: {
    accountID: UUID
  },
  source: {
    accountID: UUID
  }
}

const options = await moov.transfers.getTransferOptions(transferOptions);

See the payment methods guide for detailed information on what payment method combinations are valid.

Idempotency

To prevent duplicate transfers, every POST /transfers request requires an X-Idempotency-Key header. You are responsible for generating a version 4 UUID idempotency key. If you try to create a transfer with the same idempotency key twice, your second attempt will result in a 409 error response indicating that a transfer was previously created with that idempotency key.

Bank holidays

Bank holidays can cause delays in transfers. If you’re creating a transfer on a bank holiday, it will be processed on the next business day. Settlement from the prior day’s card sales will be delayed when the settlement day is a bank holiday. The Moov Dashboard will show a notice if a bank holiday is coming up. You can also check the Federal Reserve website for a full list of bank holidays.

Holidays observed by the Federal Reserve System include:

• New Year’s Day
• Martin Luther King Jr. Day
• Presidents’ Day
• Memorial Day
• Juneteenth
• Independence Day
• Labor Day
• Columbus Day
• Veterans Day
• Thanksgiving Day
• Christmas Day

FAQ