---
title: "Create a bank payment"
method: POST
path: "/companies/{companyId}/bank-payments"
tags: ["bank-payments"]
---

# Create a bank payment

`POST /companies/{companyId}/bank-payments`

Creates a new bank payment for the company. Payment will be created in the Bokio system.
In order to submit the transaction to the bank, the signatory for the account needs to login to the Bokio application and sign the payment with their BankID.
This is different from the transactions imported through a connected bank in Bokio.

**Scope:** `bank-payments:write`

## Request body

- BankPayment
  - `id` string, uuid — Unique identifier of the payment
  - `status` 'readyToSign' | 'onTheWay' | 'scheduled' | 'paid' | 'rejected' | 'cancelled' | 'error' — Current status of the payment
  - `createdDateTime` string, date-time — Date and time when the payment was created
  - `amount` number, double, required — Amount of the payment
  - `paymentDate` string, date, required — Date of the payment
  - `ownNote` string — Own note for the payment
  - `recipientRef` union, required — Payment recipient information
    - BankgiroRecipient
      - `kind` 'bankgiro', required
      - `recipientName` string, required — Name of the payment recipient
      - `bankgiroNumber` string, required — Bankgiro number (required for Bankgiro payments)
      - `ocr` string — OCR reference for the payment. Either `ocr` or `message` must be provided, but not both.
      - `message` string — Message for the payment. Either `message` or `ocr` must be provided, but not both.
    - TransferRecipient
      - `kind` 'transfer', required
      - `recipientName` string, required — Name of the payment recipient
      - `recipientReference` string — Reference for the payment recipient
      - `clearingNumber` string, required — Clearing number (required for Transfer payments)
      - `accountNumber` string, required — Account number (required for Transfer payments)

## Response `200`

Payment created

- BankPayment
  - `id` string, uuid — Unique identifier of the payment
  - `status` 'readyToSign' | 'onTheWay' | 'scheduled' | 'paid' | 'rejected' | 'cancelled' | 'error' — Current status of the payment
  - `createdDateTime` string, date-time — Date and time when the payment was created
  - `amount` number, double, required — Amount of the payment
  - `paymentDate` string, date, required — Date of the payment
  - `ownNote` string — Own note for the payment
  - `recipientRef` union, required — Payment recipient information
    - BankgiroRecipient
      - `kind` 'bankgiro', required
      - `recipientName` string, required — Name of the payment recipient
      - `bankgiroNumber` string, required — Bankgiro number (required for Bankgiro payments)
      - `ocr` string — OCR reference for the payment. Either `ocr` or `message` must be provided, but not both.
      - `message` string — Message for the payment. Either `message` or `ocr` must be provided, but not both.
    - TransferRecipient
      - `kind` 'transfer', required
      - `recipientName` string, required — Name of the payment recipient
      - `recipientReference` string — Reference for the payment recipient
      - `clearingNumber` string, required — Clearing number (required for Transfer payments)
      - `accountNumber` string, required — Account number (required for Transfer payments)

## Other responses

- `400` — Missing required information

---

[API](https://skmtc.net/bokio/apis/company-api.md) · [All operations](https://skmtc.net/bokio/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bokio/company-api/revisions/1bb5d09ce15e/schema)