---
title: "Create operations"
method: POST
path: "/v1/operations/create"
---

# Create operations

`POST /v1/operations/create`

Ендпоінт приймає масив платежів. Якщо хоча б один платіж у масиві неуспішний — неуспішними вважаються всі. Поля document_number та document_series проходять перевірку залежно від типу документа:  для біометричного паспорта передається тільки номер (серія відсутня);  для звичайного паспорта необхідні і номер, і серія.

## Request body

- object
  - `RAW_BODY` object[]
    - `guid` string, required — Унікальний ID операції у Вашій системі. Приклад заповнення поля: 16ed25de-7559-f011-a301-005056b2d968
    - `amount` string, required — Сума. Приклад заповнення поля: 100.00
    - `purpose` string — Призначення платежу. Необов'язковий параметр. Якщо значення передається, воно має містити щонайменше 1 символ. Приклад заповнення поля: Призначення
    - `payout_pan` string — Номер картки (для видачі переказу на картку). Приклад заповнення поля: 4111111111111111
    - `recipient` object — Дані про отримувача.
      - `last_name` string, required — Прізвище отримувача. Приклад заповнення поля: Іванов
      - `first_name` string, required — Ім'я отримувача. Приклад заповнення поля: Іван
      - `patronymic` string — По батькові отримувача. Параметр є обов'язковим для передачі в запиті. Якщо дані відсутні, допускається значення null. Приклад заповнення поля: Іванович
      - `phone` string, required — Номер телефону отримувача. Приклад заповнення поля: +380631111111
      - `document_type` string — Тип документа особи, що посвідчує особу. Приклад заповнення поля: passport
      - `document_number` string — Номер документа. Приклад заповнення поля: 111111
      - `document_series` string — Серія документа (якщо є). Приклад заповнення поля: АА
      - `document_issued_country` string — Країна, що видала документ. Приклад заповнення поля: UA
    - `refund_on_failed_payout` boolean — Параметр автоматичного повернення при неуспішній виплаті на картку

## Response `200`

200

- object[]
  - `guid` string
  - `public_id` string

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/novapay/apis/external-api.md) · [All operations](https://skmtc.dev/novapay/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/novapay/external-api/revisions/00fa2da7ff21/schema)