📘

O que você irá aprender com esse artigo?

• O que é PIX
• Configurar PIX
• Realizar cobrança de uma fatura com PIX

Diagrama de sequência

O que é o PIX?

O PIX é uma forma de pagamento que ocorre de forma instantânea. Veja como funciona o PIX na iugu:

Configurar PIX

Existem duas maneiras de realizar a configuração do método de pagamento PIX, que iremos explicar nesse artigo:
1) Pela interface da plataforma
2) Por API

Caso sua necessidade seja habilitar esse método para várias contas, indicamos o uso da API. Porém se esse processo for realizado apenas para uma conta, a melhor opção será realizar o cadastro pela plataforma.

Plataforma

Para configurar pela plataforma, basta acessar o menu Configurações> PIX> Flegar como ativo>Definir o valor de taxas e tarifas e clicar em Salvar.

API

Após realizar a criação da subconta e a verificação da conta, deve ser habilitado o PIX.

Caso não tenha realizado nenhuma dessas atividades, recomendamos ler o artigo Como posso configurar uma subconta por api.

Para realizar essa configuração, a conta precisa estar verificada, ou seja, é premissa realizar a request Enviar verificação de subconta, caso contrário será retornado o status http 401 e no body a mensagem Unauthorized.

O método da request é PUT e no body, deve ser informado true or false, na api_token deve ser usado o live-token da subconta.

Modelo de request

curl --location --request PUT 'https://api.iugu.com/v1/payments/pix' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=0061e0ce76c9748e57cfd03b25563473a0fe496a-1626699286' \
--data-raw '{
    "enable": true
}'

Modelo de response

Realizar uma cobrança com PIX

Uma vez configurada sua conta, deve ser realizado um POST na api Criar Faturas. Nela é possível criar o cliente e realizar a cobrança ou usar o id de um cliente já existente.

Modelo de request

curl --location --request POST 'https://api.iugu.com/v1/invoices' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=df598e45cd90947e522e12ec895a84f7059cacbc-1627922464' \
--data-raw '{
    "payer": {
        "address": {
            "zip_code": "09550-034",
            "street": "Sao Paulo",
            "number": "2330",
            "city": "teste",
            "state": "SP",
            "country": "BR",
            "complement": "AP 61",
            "district": "Santa Paula"
        },
        "cpf_cnpj": "numero do cpf",
        "name": "Iugu",
        "email": "[email protected]"
    },
    "items": [
        {
            "description": "item de teste iugu",
            "quantity": 1,
            "price_cents": 1500
        }
    ],
    "payable_with": [
        "pix"
    ],
    "email": "[email protected]",
    "due_date": "2021-08-02",
    "order_id": "id da order"
}'

Modelo de response

Retornamos nessa request o PIX copia e cola e a imagem do QRcode, para ser disponibilizado ao cliente final.

Após o cliente realizar o pagamento da fatura, será disparado pela iugu o gatilho invoice.status_change. Com ele é possível validar se a compra foi paga de fato, ou não, de acordo com seu status.