---
title: "Create a bank account payment"
method: POST
path: "/v1/Payments/bankaccount"
tags: ["Payments"]
---

# Create a bank account payment

`POST /v1/Payments/bankaccount`

## Request

- Base URL: `https://restapi.rev.io`
- URL: `https://restapi.rev.io/v1/Payments/bankaccount`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/rev-io/apis/rev-io-api/docs/v1/Payments/bankaccount/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a payment using a bank account.

## Request body

- RevAppPostModelsPaymentsBankAccountPayment
  - `bank_account` RevAppPostModelsPaymentsBankAccount, required
    - `account_name` string, required: The name on the bank account.
    - `account_number` string, required: Bank account number.
    - `email` string: Email address associated with the bank account.
    - `phone` string: Phone number associated with the bank account.
    - `routing_number` string: Bank routing number.
    - `institution_number` string: Canadian bank institution number.
    - `transit_number` string: Canadian transit number.
    - `account_type` 'CHECKING' | 'SAVINGS', required: Indicates the type of bank account.
    - `bank_name` string: Bank name.
    - `check_number` string: Check number.
    - `address_id` integer: Foreign identifier indicating the address associated with this payment method If no address is supplied, the billing address on the customer is used
  - `save_payment_information` boolean: Save the bank account information on the customer profile for future transactions
  - `customer_id` integer, required: Primary identifier of customer to create this payment for.
  - `amount` number, double, required: Amount to create this payment for.
  - `reference_number` string: The reference number of this payment. This will be overwritten by the payment vendor if processed digitally through a payment gateway.
  - `received_date` string, date-time: Specify the date this payment was received.
  - `payment_method_id` integer: Optionally specify the payment_method_id to choose a payment method type.
  - `note` string: Optional note associated with this payment.

## Response `201`

Created

- RevWebAPIModelsCreate
  - `ok` boolean
  - `id` integer

## Other responses

- `400`: BadRequest
- `500`: InternalServerError

## Changes

- **2026-11-03** `f175f5a3b11d`: 1 breaking, 24 info
  - request body became required
  - added the new optional request property `bank_account/email` (media type: application/json)
  - added the new optional request property `bank_account/email` (media type: text/json)
  - added the new optional request property `bank_account/email` (media type: text/html)
  - …21 more

[Operation history](https://skmtc.dev/rev-io/apis/rev-io-api/changes/v1/Payments/bankaccount/post.md)

---

[API](https://skmtc.dev/rev-io/apis/rev-io-api.md) - [All operations](https://skmtc.dev/rev-io/apis/rev-io-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rev-io/apis/rev-io-api/revisions/f175f5a3b11d?raw)