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

# Criar

`POST /pos/v1/payment-order`

## Request

- Base URL: `https://services.safe2pay.com.br`
- URL: `https://services.safe2pay.com.br/pos/v1/payment-order`
- Auth: API key in header `X-API-KEY`

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.dev/safe2pay/apis/services.md) - [All operations](https://skmtc.dev/safe2pay/apis/services/llms.txt) - [OpenAPI document](https://skmtc.dev/safe2pay/apis/services/revisions/133a27b98247?raw)