---
title: "Criar"
method: POST
path: "/pos/v1/payment-order"
---

# Criar

`POST /pos/v1/payment-order`

Cria uma solicitação de venda para máquina <<glossary:POS>>. Para mais informações [clique aqui](https://docs.safe2pay.dev/docs/criar-ordem-de-pagamento)

## Headers

- `X-API-KEY` string, required

## Request body

- object
  - `TerminalId` string, required
  - `Application` string, required — Nome da aplicação de automação comercial
  - `Reference` string, required — Código de referência do sistema integrado
  - `CallbackUrl` string — URL para receber os eventos relacionados ao processamento da transação ordem de pagamento
  - `PaymentMethod` integer — Código para o forma de pagamento. Para mais informações [clique aqui](https://docs.safe2pay.dev/docs/c%C3%B3digos-de-status)
  - `Amount` number, float — Valor de venda em R$
  - `InstallmentQuantity` integer — Número de parcelas. Case seja informado 1, será considerado crédito à vista.
  - `Splits` object[] — Lista dos splits dessa transação.
    - `CodeTaxType` integer, required — Tipo da taxa, informar 1 para Percentual ou 2 para Valor
    - `IdReceiver` integer, required — ID da conta recebedora do split
    - `Name` string — Nome da conta recebedora
    - `IsPayTax` boolean, required — Conta recebedora paga a taxa da S2P e recebe NFS-e
    - `Amount` number, float, required — Valor do Split
  - `CallbackPaymentOrderStatusUrl` string — URL para receber os eventos relacionados ao processamento da ordem de pagamento

## Response `201`

201

- object
  - `data` object
    - `reference` string
    - `paymentOrderId` integer

## Other responses

- `403` — 403
- `404` — 404
- `422` — 422

---

[API](https://skmtc.net/safe2pay/apis/payment.md) · [All operations](https://skmtc.net/safe2pay/apis/payment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safe2pay/payment/versions/8efee77775ac/schema)