---
updatedAt: 2026-07-27T21:13:59.000Z
agentTools:
  projectIndex: https://docs.vopay.com/llms.txt
---

# iq11/tokenize

This endpoint allows you to submit payment method details (bank account, email address), and will return a token which can be used to perform transactions.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "2.0",
    "title": "IQ11",
    "description": "The iQ11 API allows you to generate a unique URL to embed into your application using an iFrame. End users will use this to log in to their online banking and select a bank account to make a payment from.",
    "contact": {
      "name": "API Support",
      "email": "help@vopay.com"
    }
  },
  "paths": {
    "/iq11/tokenize": {
      "post": {
        "description": "This endpoint allows you to submit payment method details (bank account, email address), and will return a token which can be used to perform transactions.",
        "summary": "iq11/tokenize",
        "tags": [
          "IQ11 Endpoints"
        ],
        "operationId": "Iq11TokenizePost",
        "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"
                  },
                  "AccountHolderName": {
                    "description": "String that defines the account holder name. Used for all payment methods.",
                    "type": "string"
                  },
                  "AccountNumber": {
                    "description": "Customer's bank account number.",
                    "type": "string"
                  },
                  "FinancialInstitutionNumber": {
                    "description": "Three digit institution number for a Canadian bank account.",
                    "type": "string"
                  },
                  "BranchTransitNumber": {
                    "description": "Five digit branch transit number for a Canadian bank account.",
                    "type": "string"
                  },
                  "ABARoutingNumber": {
                    "description": "Nine digit ABA Routing number of a US bank account.",
                    "type": "string"
                  },
                  "IBAN": {
                    "description": "International Bank Account Number (IBAN) of a UK or European bank account. Can be used instead of the Canadian or US bank account details.",
                    "type": "string"
                  },
                  "SortCode": {
                    "description": "Sort code of a UK bank account. Digits only, maximum 6 characters.",
                    "type": "string"
                  },
                  "FlinksAccountID": {
                    "description": "Flinks Account ID. Must be accompanied by a FlinksLoginID. VoPay will fetch the associated bank account details from Flinks.",
                    "type": "string"
                  },
                  "FlinksLoginID": {
                    "description": "Flinks Login ID. Must be accompanied by a FlinksAccountID. VoPay will fetch the associated bank account details from Flinks.",
                    "type": "string"
                  },
                  "PlaidProcessorToken": {
                    "description": "Plaid Processor Token. VoPay will fetch the associated bank account details from Plaid.",
                    "type": "string"
                  },
                  "MxProcessorToken": {
                    "description": "Mx Processor Token. VoPay will fetch the associated bank account details from Mx.",
                    "type": "string"
                  },
                  "Currency": {
                    "description": "Three letter currency code.",
                    "type": "string"
                  },
                  "Address1": {
                    "description": "First line of the address. Ex: 123 Main St.",
                    "type": "string"
                  },
                  "City": {
                    "description": "City",
                    "type": "string"
                  },
                  "State": {
                    "description": "State",
                    "type": "string"
                  },
                  "ZipCode": {
                    "description": "Zip code",
                    "type": "string"
                  },
                  "Province": {
                    "description": "Province",
                    "type": "string"
                  },
                  "PostalCode": {
                    "description": "Postal code",
                    "type": "string"
                  },
                  "Country": {
                    "description": "Two letter country code.",
                    "type": "string"
                  },
                  "VerifyAccount": {
                    "description": "When set to true, the connected bank account will be verified. Default is false. Only applicable when Flinks or Plaid credentials are provided.",
                    "type": "boolean"
                  },
                  "EmailAddress": {
                    "description": "Email address",
                    "type": "string",
                    "format": "email"
                  },
                  "PhoneNumber": {
                    "description": "Phone number",
                    "type": "string"
                  },
                  "Question": {
                    "description": "Security question (used for Interac transactions)",
                    "type": "string"
                  },
                  "Answer": {
                    "description": "Security answer (used for Interac transactions)",
                    "type": "string"
                  },
                  "Language": {
                    "description": "Language - en (English) or fr (French). Default value is en (English)",
                    "type": "string"
                  },
                  "Message": {
                    "description": "Message sent to recipient (used for Interac)",
                    "type": "string"
                  },
                  "ClientControlled": {
                    "description": "When set to true, the connected bank account will be linked to your VoPay account. Default is false.",
                    "type": "boolean"
                  },
                  "ClientReferenceNumber": {
                    "description": "An optional reference number to associate with the bank account.",
                    "type": "string"
                  },
                  "Type": {
                    "description": "The type of payment method you are tokenizing. Valid values are: 'bank', 'email'. Default is 'bank'.",
                    "type": "string"
                  }
                },
                "required": [
                  "AccountID",
                  "Key",
                  "Signature"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "headers": {},
            "content": {
              "application/x-yaml": {
                "schema": {
                  "type": "object",
                  "required": [
                    "Success",
                    "ErrorMessage",
                    "Token"
                  ],
                  "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": ""
                    },
                    "Token": {
                      "type": "string",
                      "description": "A codify variable that contains the bank account",
                      "example": "{Token}"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://earthnode-dev.vopay.com/api/v2"
    }
  ]
}
```