---
title: "Emissão de Pix PAGHIPER"
method: POST
path: "/invoice/create/"
---

# Emissão de Pix PAGHIPER

`POST /invoice/create/`

## Request

- Base URL: `https://pix.paghiper.com`
- URL: `https://pix.paghiper.com/invoice/create/`
- Auth: none required

## Request body

- object
  - `apiKey` string, required: Campo composto de números, letras, traços e hífen.<br>Sempre começa por <strong>apk_</strong><br><br> Exemplo: apk_48040241-OqCWOKczcjutZaFRSfTlVBDpHFXpkdzz<br> <br> Utilizado para identificar o vendedor
  - `order_id` string, required: <strong>Código de referencia da venda</strong><br><br>Define um código para referenciar o pagamento.<br>Útil para vincular o pagamento a um pedido criado pelo sistema do lojista.<br><br>Recomendamos que seja um código único para cada transação.
  - `payer_email` string, required: e-mail valido do cliente pagador
  - `payer_name` string, required: Nome ou Razão social do cliente pagador
  - `payer_cpf_cnpj` string, required: CPF ou CNPJ do pagador de preferencia apenas os números do cpf ou cnpj
  - `payer_phone` integer: Número de telefone ou celular do cliente Exemplo: 1140638785 Sempre informar o DDD + Número
  - `days_due_date` integer, required: <strong>Dias corridos até o vencimento<br><br>Exemplo: 4</strong><br>O número representa diferença de dias entre a data da requisição e a data de vencimento.<br><br>A diferença entre as datas:<br>Data requisição: 2017-07-01<br>Data do vencimento: 2017-07-05<br><br>days_due_date: 4<br><br> Por padrão o valor maximo é de 400 dias, caso necessite emitir Pix com prazo superior a 400 dias entre em contato através do e-mail comercial@paghiper.com
  - `notification_url` string: <strong>URL de retorno automático de dados</strong><br>Endereço da página onde o PagHiper enviará o POST com as informações da transação. <br>Note que, este campo tem prioridade sobre a url que estiver configurada no painel PagHiper.<br><br>Qualquer alteração de status de uma transação, será está url que iremos notificar através de um post
  - `discount_cents` integer: <strong>Valor total do desconto da compra em centavos</strong><br><br>Exemplo, em um desconto aplicado de R$ 11,58 reais, deve ser informado: 1158 (total de centavos).<br><br>Se o desconto for aplicado em porcentagem, a sua aplicação deverá realizar o calculo e nos informar apenas o valor já calculado em centavos.
  - `shipping_price_cents` integer: <strong>Valor total do frete em centavos</strong><br><br>Exemplo: o frete custa R$ 15,99, deve ser informado: 1599 (total em centavos)
  - `shipping_methods` string: <strong>Método de entrega</strong><br><br>Exemplo: SEDEX, SEDEX10, PAC, TRANSPORTADORA, MOTOBOY, RETIRADA NO LOCAL, etc.
  - `partners_id` string: <strong>Id do parceiro</strong><br><br>Útil apenas para integração de plataformas parceiras. Na maioria dos casos, esse campo deve ser ignorado.
  - `number_ntfiscal` integer: <strong>Número da nota fiscal</strong> Se informado <strong>123456</strong>, exibira o número da nota fiscal no Pix junto á caixa de descrição da seguinte forma: “Referente a nota fiscal número: 123456”
  - `fixed_description` boolean: <strong>Frase fixa</strong><br><br>Frase pré-configurada no painel do PagHiper,<br> esta frase passa por uma pré analise antes de ser exibida no Pix.<br><br><table class="especificacoesmini"> <thead> <tr> <th>esperado</th> <th>significado</th> </tr> </thead> <tbody> <tr> <td>true</td> <td>Exibira a frase na caixa de descrição do Pix</td> </tr> <tr> <td>false</td> <td>Nenhuma frase pré-configurada</td> </tr> </tbody> </table>
  - `seller_description` string: <strong>Frase variável do vendedor</strong><br><br> Texto que irá variar de acordo com cada Pix em específico, podendo colocar informações que remetam ao pedido/ serviço adquirido pelo cliente.<br><br> A frase variável será exibida no corpo do Pix, no campo onde traz informações sobre os prazos de pagamento do Pix.<br><br> A frase será exibida no seguinte formato: “<strong>Texto do vendedor</strong>: (conteúdo da frase variável aqui)”<br><br> Obs.: A informação “<strong>Texto do vendedor</strong>” é permanente, não sendo retirada ao acrescentar uma frase variável no Pix.<br><br> Tamanho máximo de 120 caracteres.<br> <br>
  - `items` object[], required
    - `item_id` string
    - `description` string, required
    - `quantity` integer
    - `price_cents` string

## Response `201`

201

- object
  - `pix_create_request` object
    - `result` string
    - `response_message` string
    - `transaction_id` string
    - `created_date` string
    - `value_cents` string
    - `status` string
    - `order_id` string
    - `due_date` string
    - `pix_code` object
      - `qrcode_base64` string
      - `emv` string
      - `pix_url` string
      - `bacen_url` string
    - `http_code` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/paghiper/apis/pix.md) - [All operations](https://skmtc.dev/paghiper/apis/pix/llms.txt) - [OpenAPI document](https://skmtc.dev/paghiper/apis/pix/revisions/0e72404c989d?raw)
