---
title: "Initiate Pay by Bank"
method: POST
path: "/v2/moneyins/paybybank/transfer/init"
tags: ["MoneyIns | Pay by Bank"]
---

# Initiate Pay by Bank

`POST /v2/moneyins/paybybank/transfer/init`

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Request body

- MoneyInTransferInitInput
  - `returnUrl` string — returnUrl in case of success
  - `cancelUrl` string — cancelUrl in case of cancellation
  - `errorUrl` string — errorUrl in case of error
  - `countryCode` string, required — The country code associated with the payment bank. ISO Alpha-2 codes accepted: (FR) France, (ES) Spain, (IT) Italy, (DE) Germany, and (PT) Portugal
  - `bankId` string — If you use the bankId in the call, the end-user will be redirected to their bank. They will not have to select a bank from a list provided. To get a comprehensive list of `bankIds` call the `GET v2/moneyins/paybybank/transfer/banks` specifying the ISO Alpha-2 Country Code for example FR for France.
  - `transferType` 0 | 1 | 2 — The type of bank transfer, this field is optional. If not provided, the default value is 'Classic'. The 'TransferType' can be set to two different values: - 'Classic': Represents a classic bank transfer with a processing time.<br/>0 = Undefined.<br/>1 = Instant.<br/>2 = Classic.<br/>
  - `reference` string — Unique ID of the call, generated by your server. This ID can be used as a search field when looking for operation details
  - `accountId` string, required — Payment Account ID to Credit
  - `totalAmount` integer, required — Amount to Debit Amounts are given as integer numbers in cents
  - `commissionAmount` integer — Your Fee Amounts are given as integer numbers in cents
  - `comment` string — Comment Regarding the Transaction
  - `autoCommission` boolean — If true: 1. [amountCom] will be ignored and will be replaced with Lemonway's fee 2. You will not receive any fee

## Response `200`

OK

- MoneyInTransferInitOutput
  - `redirectUrl` string
  - `id` integer
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string — Get the Error Message from PSP

## Other responses

- `401` — Unauthorized
- `500` — InternalServerError

---

[API](https://skmtc.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/revisions/73309fe68e2d/schema)