Meios de pagamento da iugu
A iugu é um serviço de pagamentos online.

É possível escolher entre dois tipos de integração:
  • Checkout transparente: os dados do cartão de crédito são informados dentro da própria loja. Neste tipo de integração não ocorre o redirecionamento do navegador para o site da iugu.
  • Boleto bancário: o boleto é gerado ao fim do pedido.
Para utilizar, faça seu cadastro no site da iugu através deste link. Depois de aceito o cadastro, acesse o site administrativo da iugu para gerar o token na aba Configurações, opção Integração via API. Este token deve ser informado no respectivo campo na seção iugu da página Pagamentos do site administrativo da loja virtual.

Preencha também o campo AccountID com o ID da conta criada na iugu. Esta informação pode ser obtida ao acessar a página de configurações dentro do painel da iugu (CONTA).

Caso a loja queira usar o FLUXO DE PAGAMENTO EM DUAS ETAPAS, que habilita a transação em duas etapas [Autorização e Captura], deverá marcar essa opção em Configurações > Cartão de crédito do painel da iugu. Neste caso, a loja terá que capturar as transações com status IN_ANALYSIS pela ficha do pedido, que deverá estar com status Em aprovação. Nesta mesma página de configuração existe a opção de ativar a opção de PARCELAS.

Caso queira emitir boletos pela iugu, altere o campo Aceita na seção Boleto bancário do site administrativo da loja virtual para iugu.

Para utilizar o checkout transparente, marque o campo Aceita e escolha as bandeiras que serão transacionadas através da iugu na coluna Tecnologia da seção Cartões de crédito. Em seguida, faça pedidos de teste com cada bandeira selecionada para verificar se está tudo OK.

Nas duas formas de integração, clique no ícone ao lado do campo Alteração de status para definir ações automáticas que ocorrem quando a iugu aprova ou cancela as transações.

Sobre as faturas e pagamentos

Ao realizar um pedido com cartão de crédito ou boleto, uma ou mais faturas podem ser geradas na iugu. Estas faturas estão associadas a pagamentos. Na ficha do pedido serão informados os códigos da fatura e o status do pagamento.

Os status possíveis de fatura são draft, pending, paid, canceled, payment_in_progress, expired, refunded, partially_paid, chargeback, in_analysis, in_protest e partially_refunded.

Os status possíveis de transações de cartão de crédito são pending, authorized, unauthorized, captured, canceled, partially_canceled e technical_issue.

Quando uma fatura é cancelada pela loja, seu status será CANCELED. Não é possível cancelar faturas que tenham pagamentos confirmados/aprovados. Neste caso é possível somente fazer um REEMBOLSO.

Se a transação não for aprovada pela iugu ou for cancelada, é possível enviar uma mensagem para o cliente contendo um link para que este tente novamente a aprovação.

Se a loja tiver os dados do cartão do cliente, acesse a ficha do pedido e aperte o botão Criar transação. Este botão será exibido somente na ficha do pedido com status novo ou em aprovação.

Sobre o cancelamento de faturas

Para cancelar uma fatura, acesse a ficha do pedido e aperte o botão Cancelar fatura. Para que este botão seja exibido, o status do pedido deverá ser novo, em aprovação ou cancelado.

Sobre o reembolso de pagamentos

Para reembolsar um pagamento, acesse a ficha do pedido e aperte o botão Reembolsar. Para que este botão seja exibido, o status do pedido deverá ser novo, em aprovação ou cancelado.

ATENÇÃO: Antes de remeter qualquer pedido, consulte o Portal iugu para verificar se está tudo OK com a respectiva fatura/pagamento. Da mesma forma, antes de cancelar um pedido não aprovado, consulte o Portal da iugu para verificar se a transação ocorreu sem que houvesse aviso para a loja.

Obs: Após configurar ou alterar a integração de qualquer forma de pagamento, faça pedidos de teste na loja virtual com esta forma de pagamento e confira os valores da transação nas fichas dos pedidos, nos LOGs dos pedidos e no site da forma de pagamento. Certifique-se de que a configuração e os valores estão corretos nas duas plataformas (loja virtual e forma de pagamento).