---
title: "POST /v2/singleSale/add"
method: POST
path: "/v2/singleSale/add"
---

# POST /v2/singleSale/add

`POST /v2/singleSale/add`

## Request

- Base URL: `https://services.safe2pay.com.br`
- URL: `https://services.safe2pay.com.br/v2/singleSale/add`
- Auth: API key in header `X-API-KEY`

## Request body

- object
  - `PaymentMethods` object[], required: Grupo de dados com as informações de formas de pagamento permitidas.
    - `CodePaymentMethod` string, required: Código da forma de pagamento que deve ser habilitada para o link.
  - `Customer` object, required
    - `Name` string, required: Nome do comprador.
    - `Identity` string, required: Documento do comprador.
    - `Email` string: E-mail do comprador.
    - `Phone` string, required: Telefone do comprador.
    - `Address` object, required
      - `ZipCode` string, required: CEP do endereço do comprador.
      - `Street` string, required: Logradouro do endereço do comprador.
      - `Number` string, required: Número do endereço do comprador.
      - `Complement` string: Complemento do endereço do comprador.
      - `District` string, required: Bairro do endereço do comprador.
      - `StateInitials` string, required: UF do endereço do comprador.
      - `CityName` string, required: Cidade do endereço do comprador.
      - `CountryName` string, required: PaÍs do endereço do comprador.
  - `Produtos` object[], required: Lista dos produtos nessa transação.
    - `Description` string, required: Descrição do produto nessa transação.
    - `UnitPrice` number, double, required: Valor unitário do produto nessa transação.
    - `Quantity` integer, required: Quantidade do produto nessa transação.
  - `Reference` string: Referência da cobrança.
  - `ExpirationDate` string, required: Data de expiração da cobrança.
  - `DiscountType` integer: Tipo de desconto a ser aplicado. 1 = Percentual. 2 = Valor.
  - `DiscountDue` string, date: Data de limite para o desconto. Se não for preenchido, é utilizado o ExpirationDate para crédito e pix e o DueDate para boleto.
  - `DiscountAmount` number, double: Valor do desconto aplicado a venda.
  - `Splits` object[]: Lista dos splits nessa transação.
    - `CodeTaxType` integer, required: Tipo da taxa, informar 1 para Percentual ou 2 para Valor
    - `IdReceiver` integer, required: Identificador da empresa no Safe2Pay.
    - `Name` string: Nome da empresa recebedora.
    - `IsPayTax` boolean: Informar se a taxa de custo será paga pelo recebedor.
    - `Amount` number, double, required: Informar o valor do repasse, em percentual ou valor.
  - `DueDate` string: Data de vencimento para boleto. (válido somente para vendas com boleto)
  - `Instruction` string: Instruções que serão impressas no Boleto. (válido somente para vendas com boleto)
  - `Messages` string[]: Mensagens que serão impressas no Boleto. Informar uma lista de até 9 Strings. (válido somente para vendas com boleto)
  - `PenaltyAmount` number, double: Multa em percentual cobrada após o vencimento. (válido somente para vendas com boleto)
  - `InterestAmount` number, double: Taxa de juros em percentual por mês cobrada após o vencimento. (válido somente para vendas com boleto)
  - `InstallmentQuantity` integer: Número de parcelas permitidas para o link de cobrança. Caso não seja enviado, o padrão será o que estiver definido para a conta. (válido somente para vendas com cartão de crédito)
  - `CallbackUrl` string: URL de notificação de mudança de status.
  - `Emails` string[], required: Emails que receberão uma cópia da cobrança. Informe diversos os separando por ';'.

## Response `200`

---

[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)