Criação de Invoices

POST

/api/v2/invoices

Use este endpoint para criar uma cobrança imediata para uma invoice, permitindo que o cliente pague via PIX ou cartão de crédito.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200Sucesso

application/json

Body

🟠401Auth Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.banconovus.com/api/v2/invoices' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "method": "string",
  "product_fisical": "string",
  "ip_payer": "string",
  "total_price_cents": 0,
  "postback_url": "string",
  "external_id": "external_id",
  "payer": {
    "name": "string",
    "cpf_cnpj": "string",
    "email": "string",
    "phone": "string",
    "address_zip": "string",
    "address_line": "string",
    "address_number": "string",
    "address_complement": "string",
    "address_city": "string",
    "address_state": "string"
  },
  "card": {
    "token": "string",
    "installment": 0,
    "number": "string",
    "first_name": "string",
    "last_name": "string",
    "month": "string",
    "year": "string",
    "security_code": "string",
    "cavv": "string",
    "xid": "string",
    "eci": "string",
    "version": "string",
    "referenceid": "string"
  },
  "items": [
    {
      "name": "string",
      "description": "string",
      "quantity": 0,
      "unit_price": 0
    }
  ]
}'

Response Example

200 - Exemplo - Pix

{
    "data": {
        "external_id": "external_id",
        "invoice_id": "primary_id",
        "order_code": "secundary_id",
        "qr_code_pix": "pix_key",
        "status": "pending",
        "total_cents": 1000
    },
    "message": "Fatura criada com sucesso"
}

Modificado em 2025-11-03 02:54:52