⚙️(ROTA) - Criar Cobrança - PIX - Split

Criar Cobrança

POST https://quacpay.com/api/create-charge/pix

Esta rota permite a criação de uma cobrança de PIX para um cliente na plataforma QuacPay. Ela recebe os dados necessários para gerar uma cobrança, valida os campos obrigatórios e, em seguida, realiza uma requisição para a plataforma para criar a cobrança.

Headers

Name	Value
Content-Type	application/json
x-access-token	apiKey
User-Agent	appName

Body

Parâmetro	Tipo	Descrição	Obrigatório
customer	String	Identificador do cliente para o qual a cobrança será gerada.	Sim

dueDate	String	Data de vencimento da cobrança no formato YYYY-MM-DD.	Sim

value	Float	Valor da cobrança.	Sim

description	String	Descrição da cobrança (opcional).	Não

externalReference	String	Referência externa para a cobrança (opcional).	Não

discount	Float	Valor do desconto, se aplicável (opcional).	Não

interest	Float	Valor de juros, se aplicável (opcional).	Não

fine	Float	Valor de multa, se aplicável (opcional).	Não

postalService	Boolean	Indica se a cobrança deve ser enviada pelo correio (opcional).	Não

Response

Os dados abaixo são fictícios e não possuem valor real. Eles são fornecidos apenas como exemplo para ilustrar uma possível resposta da nossa plataforma QuacPay.

201

{
    "customer": "cus_0932983123",
    "dueDate": "2025-03-01",
    "value": 150.00,
    "description": "Cobrança de serviço de consultoria",
    "externalReference": "ABC123456789",
    "postalService": "false",
    "split": [
      {
        "walletId": "b29c920b-3d5e-47a9-a0f1-e4f37a775f97",
        "percentualValue": 15,
        "externalReference": "split-ABC123456789",
        "description": "Taxa de 15% sobre a cobrança de 150.00"
      }
    ]
}

400

500