---
title: "Process an ACH withdraw."
method: PUT
path: "/ach/withdraw"
tags: ["ACH Payment"]
---

# Process an ACH withdraw.

`PUT /ach/withdraw`

## Headers

- `idempotency-key` string, uuid, required

## Request body

- Req3
  - `bankAccountId` integer, required — The bank account ID to withdraw from.
  - `customerId` integer, required — The customer ID associated with the bank account.
  - `orderId` integer — An optional invoice ID to process the withdrawal with. If provided, the withdrawal action will perform invoice and inventory management.
  - `amount` number, float, required — The amount to withdraw.
  - `currencyId` 1 | 2, required — The currency of the transaction: * `1` - CAD * `2` - USD

## Response `200`

An ACH withdrawal was successfully processed. This does not guarantee that all necessary sub-objects were updated, only a guarantee that the payments action was successful.

- Res4
  - `transaction` TransactionEft
    - `id` integer
    - `merchantId` integer
    - `dateCreated` string, date-time
    - `statusAuth` integer
    - `statusClearing` integer
    - `userId` integer
    - `batchId` integer
    - `bankAccountId` integer
    - `bankAccountL4l4` integer
    - `transactionType` integer
    - `amount` number, float
    - `currency` integer
    - `approvalCode` string
    - `test` integer
    - `acquirerTransactionId` string
    - `responseMessage` string
    - `payFacTransactionId` integer
    - `originalTransactionId` integer
    - `statusBatch` integer
    - `dateClosed` string, date-time
    - `customerCode` string
    - `invoiceNumber` string
    - `orderId` integer

## Other responses

- `400` — Invalid request. Likely caused by malformed content in request payload.
- `403` — User does not have valid permissions.
- `500` — Unexpected internal error.

---

[API](https://skmtc.net/helcim/apis/the-helcim-api.md) · [All operations](https://skmtc.net/helcim/apis/the-helcim-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/helcim/the-helcim-api/versions/345052ca6578/schema)