---
updatedAt: 2026-04-23T04:17:15.000Z
agentTools:
  projectIndex: https://docs.vopay.com/llms.txt
---

# fednow/withdraw

This endpoint is used to instantly send funds out of your VoPay account and deposit them to the specified recipient's bank account. 

 Either an iq11 Token or ABARoutingNumber/AccountNumber is required.

 If a ClientAccountID is provided, the client account's first/last name and default bank account will be used for the transaction.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "2.0",
    "title": "Payment Rails",
    "description": "The Payment Rails API allows you to manage transactions in your account. You can cancel transactions, refund transactions, and confirm flagged transactions.",
    "contact": {
      "name": "API Support",
      "email": "help@vopay.com"
    }
  },
  "paths": {
    "/fednow/withdraw": {
      "post": {
        "description": "This endpoint is used to instantly send funds out of your VoPay account and deposit them to the specified recipient's bank account. \n\n Either an iq11 Token or ABARoutingNumber/AccountNumber is required.\n\n If a ClientAccountID is provided, the client account's first/last name and default bank account will be used for the transaction.",
        "summary": "fednow/withdraw",
        "tags": [
          "Fednow Endpoints"
        ],
        "operationId": "FednowWithdrawPost",
        "deprecated": false,
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "AccountID": {
                    "description": "Your account ID",
                    "type": "string"
                  },
                  "Key": {
                    "description": "API key for the account",
                    "type": "string"
                  },
                  "Signature": {
                    "description": "Hashed signature for the request",
                    "type": "string"
                  },
                  "ClientAccountID": {
                    "description": "Client Account ID",
                    "type": "string"
                  },
                  "ContactID": {
                    "description": "The ID of the contact to use for this transactions. The contacts payment method associated with this transaction type will be used.",
                    "type": "string"
                  },
                  "RecipientName": {
                    "description": "Recipient's full name",
                    "type": "string"
                  },
                  "AccountNumber": {
                    "description": "Recipient's bank account number. This is the account that funds will be deposited into.",
                    "type": "string"
                  },
                  "ABARoutingNumber": {
                    "description": "The ABA Routing number of the recipient's bank account.",
                    "type": "string"
                  },
                  "Token": {
                    "description": "Your iQ11 Token that has been generated using Custom Iframe. See iQ11 API Endpoints.",
                    "type": "string"
                  },
                  "Amount": {
                    "description": "The amount in the specified currency to deposit into the recipient's bank account.",
                    "type": "number"
                  },
                  "ClientReferenceNumber": {
                    "description": "An optional reference number to associate with the transaction.",
                    "type": "string"
                  },
                  "Notes": {
                    "description": "An optional note to associate with the transaction.",
                    "type": "string"
                  },
                  "IdempotencyKey": {
                    "description": "A unique key which the server can use to recognize and reject subsequent retries of the same request.",
                    "type": "string"
                  },
                  "ParentTransactionID": {
                    "description": "The parent transaction where the withdrawal will be linked to, can become a split payment with multiple withdrawals. When funds of the parent transaction have been released the system will generate the distributions of these funds automatically.",
                    "type": "string"
                  },
                  "GLCode": {
                    "description": "An optional unique identification general ledger code.",
                    "type": "string"
                  },
                  "TransactionTypeCode": {
                    "description": "CPA transaction code. Use the /api/v2/account/transactions/codes endpoint to retrieve a list of valid transaction codes. If not specified, the transaction will be created using code 450 (miscellaneous).",
                    "type": "string"
                  }
                },
                "required": [
                  "AccountID",
                  "Key",
                  "Signature",
                  "RecipientName",
                  "AccountNumber",
                  "ABARoutingNumber",
                  "Amount"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "Success": {
                      "type": "boolean",
                      "description": "True if the request was successful, false if it failed",
                      "example": true
                    },
                    "ErrorMessage": {
                      "type": "string",
                      "description": "Contains a description of the error if the request failed",
                      "example": ""
                    },
                    "TransactionID": {
                      "type": "integer",
                      "description": "The unique ID of the transaction that was just performed. This ID should be saved as it is required in order to look up status information on the transaction.",
                      "example": "112233"
                    },
                    "Flagged": {
                      "type": "string",
                      "description": "Details on why the transaction was flagged, if applicable. Flagged transactions will need to be confirmed by using the /account/transaction/confirm endpoint.",
                      "example": "The transaction has been flagged as a potential duplicate.",
                      "x-absent-when": "transaction not flagged"
                    }
                  },
                  "required": [
                    "Success",
                    "ErrorMessage",
                    "TransactionID"
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://earthnode-dev.vopay.com/api/v2"
    }
  ]
}
```