---
title: "Add a bank transfer to a batch."
method: POST
path: "/v1/batches/{batchUuid}/banktransfers"
tags: ["Batch Payments"]
---

# Add a bank transfer to a batch.

`POST /v1/batches/{batchUuid}/banktransfers`

This endpoint will add a new bank transfer payment to a batch. There are two ways to process bank transfers - by Payee ID (**Mode 1**) or by Payee Account Details (**Mode 2**).

**Mode 1:** Use the payee IDs of existing approved payees set up against your account. These batches can be approved in the normal manner.

**Mode 2:** Use the account details of the payee. In the event that these details correspond to an existing approved payee, the batch can be approved as normal. If the account details are new, a batch of New Payees will automatically be created. This batch will need to be approved before the Payment batch can be approved. These payees will then exist as approved payees for future batches.
You will need to enable PERM_BUSINESS_POST_BATCH_BANKTRANSFERS to use this endpoint.

## Path parameters

- `batchUuid` string, required — The uuid of the batch.

## Request body

- union
  - BatchItemBankTransferMode1
    - `icanFrom` integer — The Fire account ID for the fire.com account the funds are taken from.
    - `payeeId` integer — The ID of the existing or automatically created payee
    - `payeeType` 'PAYEE_ID' — Use PAYEE_ID if you are paying existing approved payees (Mode 1).
    - `amount` integer — The amount of funds to be transferred. Note the last two digits represent pennies/cents, (e.g., £1.00 = 100).
    - `myRef` string — The reference on the transaction for your records - not shown to the beneficiary.
    - `yourRef` string — The reference on the transaction - displayed on the beneficiary bank statement.
  - BatchItemBankTransferMode2
    - `icanFrom` integer — The Fire account ID for the fire.com account the funds are taken from.
    - `payeeType` 'ACCOUNT_DETAILS' — Use ACCOUNT_DETAILS if you are providing account numbers/sort codes/IBANs (Mode 2). Specify the account details in the destIban, destAccountHolderName, destNsc or destAccountNumber fields as appropriate.
    - `destIban` string — The destination IBAN if a Euro Bank transfer
    - `destNsc` string — The destination Nsc if a GBP bank transfer
    - `destAccountNumber` string — The destination Account Number if a GBP bank transfer
    - `destAccountHolderName` string — The destination account holder name
    - `amount` integer — The amount of funds to be transferred. Note the last two digits represent pennies/cents, (e.g., £1.00 = 100).
    - `myRef` string — The reference on the transaction for your records - not shown to the beneficiary.
    - `yourRef` string — The reference on the transaction - displayed on the beneficiary bank statement.

## Response `200`

Batch payment added successfully. **Note*** Please use batchUuid when submitting a batch, not batchItemUuid.

- NewBatchItemResponse
  - `batchItemUuid` string — A Batch Item UUID for this item. Note* Do not confuse this for BatchUuid when submitting a batch.

## Other responses

- `400` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `401` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `403` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.

---

[API](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api.md) · [All operations](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefinancialservices/fire-financial-services-business-api/revisions/1d19896d095c/schema)