---
title: "sepa/withdraw"
method: POST
path: "/sepa/withdraw"
tags: ["SEPA Endpoints"]
---

# sepa/withdraw

`POST /sepa/withdraw`

## Request

- Base URL: `https://earthnode-dev.vopay.com/api/v2`
- URL: `https://earthnode-dev.vopay.com/api/v2/sepa/withdraw`
- Auth: none declared

This endpoint debits your account by sending a SEPA Instant payment to a creditor's IBAN. Only EUR currency is supported. Requires SEPAInstantWithdrawEnabled permission and an active EUR virtual account.

## Request body `application/x-www-form-urlencoded`

- object
  - `AccountID` string, required: Your account ID
  - `Key` string, required: API key for the account
  - `Signature` string, required: Hashed signature for the request
  - `Amount` number, required: The amount to send via SEPA Instant payment
  - `RecipientName` string, required: The full name of the recipient (creditor)
  - `IBAN` string, required: The recipient's International Bank Account Number (IBAN)
  - `Currency` string: The currency for the transaction. Must be EUR
  - `ClientAccountID` string: The ID of the client account to associate with this transaction
  - `ClientReferenceNumber` string: An optional reference number for your own records
  - `IdempotencyKey` string: A unique key to ensure idempotent request processing
  - `Notes` string: Optional notes to attach to the transaction
  - `ParentTransactionID` string: The ID of a parent transaction to link this transaction to
  - `GLCode` string: General ledger code for accounting purposes
  - `TransactionTypeCode` string: A custom transaction type code for categorization

## Response `200`

- object
  - `Success` boolean, required: True if the request was successful, false if it failed
  - `ErrorMessage` string, required: Contains a description of the error if the request failed
  - `TransactionID` integer, required: The unique ID for the SEPA withdrawal transaction
  - `TransactionStatus` string, required: The current status of the transaction
  - `Flagged` string: Present if the transaction was flagged. Contains flag status messages
  - `Notice` string: Present if the account has insufficient funds at the time of the transaction

---

[API](https://skmtc.dev/vopay/apis/payment-rails.md) - [All operations](https://skmtc.dev/vopay/apis/payment-rails/llms.txt) - [OpenAPI document](https://skmtc.dev/vopay/apis/payment-rails/revisions/d6fe8969ddcf?raw)