-
Notifications
You must be signed in to change notification settings - Fork 3
/
readme.txt
193 lines (124 loc) · 10.1 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
=== WooCommerce iugu ===
Contributors: iugu, claudiosanches, braising, andsnleo, eduardoiugu
Tags: woocommerce, iugu, payment
Requires at least: 3.9
Tested up to: 4.9
Stable tag: 3.1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Receba pagamentos por cartão de crédito e boleto bancário na sua loja WooCommerce com a iugu.
== Description ==
A iugu disponibiliza toda a infraestrutura necessária para que você possa transacionar pagamentos online com menos burocracia e mais vantagens. Com a nossa plataforma, você pode oferecer pagamentos com checkout transparente com cartão de crédito e boleto bancário. Para mais informações sobre o funcionamento da iugu, [leia a documentação](https://docs.iugu.com).
= Compatibilidade =
O **WooCommerce iugu** é compatível com:
* [WooCommerce 5.1+](https://wordpress.org/plugins/woocommerce/)
* [WooCommerce Subscriptions 3.1.4+](http://www.woothemes.com/products/woocommerce-subscriptions/): para pagamentos recorrentes/assinaturas.
* [WooCommerce Pre-orders](http://www.woothemes.com/products/woocommerce-pre-orders/): para pré-venda de produtos.
* [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/): permite enviar dados do cliente como **CPF** ou **CNPJ**, além dos campos **número** e **bairro** do endereço.
= Requerimentos =
* [Wordpress v5.6 ou superior](https://wordpress.org).
* [WooCommerce v5.1 ou superior](https://br.wordpress.org/plugins/woocommerce/).
* [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/).
* Conta ativa na [iugu](https://iugu.com/) com boleto bancário e/ou cartão de crédito habilitados como métodos de pagamento. Entenda [*O que é necessário para começar a usar iugu?*](https://support.iugu.com/hc/pt-br/articles/201531709).
== Installation ==
= 1. Instale o plugin =
Envie os arquivos do plugin para a pasta `wp-content/plugins` ou instale-o usando o instalador de plugins do WordPress. Em seguida, ative o **WooCommerce iugu**.
= 2. Obtenha o ID da sua conta iugu e um API token =
No painel da iugu, acesse o menu [*Administração > Configurações da conta*](https://app.iugu.com/account) e crie um *API token* do tipo LIVE. Ele será usado, junto com o ID da sua conta iugu, para configurar o plugin.
Você também pode criar um API token do tipo TEST para realizar testes com o plugin.
= 3. Configure o WooCommerce =
No WordPress, acesse o menu *WooCommerce > Configurações > Produtos > Inventário* e deixe em branco a opção **Manter estoque (minutos)**.
Essa funcionalidade, introduzida na versão 2.0 do Woocommerce, permite cancelar a compra e liberar o estoque depois de alguns minutos, mas não funciona muito bem com pagamentos por boleto bancário, pois estes podem levar até 48 horas para serem validados.
= 4. Ative os pagamentos pela iugu =
Ainda no WordPress, acesse o menu *WooCommerce > Configurações > Finalizar compra* e selecione **iugu - Cartão de crédito** ou **iugu - Boleto bancário**. Marque a caixa de seleção para ativar o(s) método(s) de pagamento que lhe interessa(m) e preencha as opções de **ID da conta** e **API Token** para cada um deles.
= Modo de testes =
É possível trabalhar com o plugin **WooCommerce iugu** em Sandbox (modo de testes). Dessa forma, você pode testar os processos de pagamentos por boleto e cartão antes de realizá-los em produção.
1. Acesse o painel da iugu e, no menu [*Administração > Configurações da conta*](https://app.iugu.com/account), crie um API token do tipo TEST.
2. Agora no WordPress, acesse as configurações de cartão de crédito ou boleto bancário do WooCommerce iugu (*WooCommerce > Configurações > Finalizar compra*) e adicione o seu API token (TEST).
3. Ao fim da página, marque a caixa de seleção *Ativar o sandbox da iugu*.
Opcional: Marque também a opção *Habilitar log* para ver o registro dos seus pagamentos no menu *WooCommerce > Status > Logs*.
== Frequently Asked Questions ==
= Qual é a licença do plugin? =
[GNU GPL (General Public Licence) v2](http://www.gnu.org/licenses/gpl-2.0.html).
= Do que preciso para utilizar o plugin? =
Ver [Requerimentos](https://github.com/iugu/iugu-woocommerce/wiki/Requerimentos).
= Quais são as tarifas da iugu? =
Conheça todas as tarifas da iugu em [iugu.com/precos](https://iugu.com/precos/).
= É possível utilizar a opção de pagamento recorrente/assinaturas? =
Sim, é possível utilizar este plugin para fazer pagamentos recorrentes com o [WooCommerce Subscriptions](https://www.woothemes.com/products/woocommerce-subscriptions/), que permite um maior controle sobre assinaturas dentro da sua loja WooCommerce.
= O pedido foi pago e ficou com o status *processando*, e não *concluído*. Isso está certo? =
Sim. Todo gateway de pagamento no WooCommerce deve mudar o status do pedido para *processando* no momento em que o pagamento é confirmado. O status só deve ser alterado para *concluído* após o pedido ter sido entregue.
Para produtos digitais, por padrão, o WooCommerce só permite o acesso do comprador quando o pedido tem o status *concluído*. No entanto, nas configurações do WooCommerce, na aba *Produtos*, é possível ativar a opção **Conceder acesso para download do produto após o pagamento**, liberando o download no status *processando*.
== Changelog ==
= 3.0.0.13 =
* Correção: Gerava um erro de session quando o usuário era excluido pelo admin
= 3.0.0.12 =
* Correção: Quando PIX ou Boleto sáo pagos, o plugin recebe duas vezes a informação de pagamento. Alterado para ignorar a segunda recepção
= 3.0.0.11 =
* Correção: Quando a transação do cartão for negada, alterar o status para malsucedido direto.
= 3.0.0.10 =
* Correção: Envio de Bairro na criação do Customer
= 3.0.0.9 =
* Melhoria: Adicionado parâmetro para configurar a partir de qual data deve ser verificado se os Customers IDs são validos. Usado quando o "ID da conta na IUGU" precisa ser alterado.
= 3.0.0.8 =
* Melhoria: Alterado para quando tem apenas uma parcela no cartão não demostrar o combo com a seleção de parcela
= 3.0.0.7 =
* Melhoria: Incluído a possibilidade de na assinatura alterar a forma de pagamento para a proxima recorrencia
= 3.0.0.6 =
* Melhoria: Unificado as configurações comuns da API, na aba IUGU das configurações
* Melhoria: Ao salvar a aba IUGU nas configurações, agora é verificado se é preciso recriar o webhook
* Melhoria: Incluído configuração para qual status deve ser modificado o pedido para pagamento é pendente
* Melhoria: Incluído configuração para qual status deve ser modificado o pedido para processamento
* Melhoria: Incluído para utlizar o celular no cadastro do cliente caso o telefone não esteja informado
= 3.0.0.5 =
* Melhoria: Alterado para permitir postegar o ciclo de assinatura no woocommerce subscriptions
* Melhoria: Alterado para enviar s/n caso o número do endereço no cadastro do cliente não esteja preenchido
= 3.0.0.4 =
* Melhoria: Adicionado compatibilidade com o plugin "HandMade WooCommerce Order Status Control"
= 3.0.0.3 =
* Melhoria: Adicionado mensagem ao clicar no botão de cópia do PIX
= 3.0.0.2 =
* Melhoria: Criação de configuração para envio de split na fatura
= 3.0.0.1 =
* Correção: Não obrigar salvar o cartão se não tiver assinatura no carrinho
* Correção: Correção para gerar o boleto com vencimento futuro
= 3.0.0.0 =
* Correção: Correções de bugs
= 2.2.1 =
* Correção: Correção na demostração de formas de pagamento do Pluggin da IUGU, para produtos já cadastrados no Woocommerce antes da ativação do Plugin da IUGU
= 2.1.5 =
* Correção: Correção no parcelamento, que estava sendo gravado errado em certos cenários
= 2.1.4 =
* Correção: Correções na integração com WooCommerce Subscriptions com cartão de crédito
= 2.1.3 =
* Correção: Correções na integração com WooCommerce Subscriptions
* Melhoria: Suporte a salvamento e reutilização de cartões de crédito
* Melhoria: Suporte a reembolso de pagamentos feitos com cartão de crédito
* Melhoria: Campo de parcelamento agora precisa ser selecionado a cada recarga de página
* Melhoria: Criação de parâmetro para ligar/desligar envio de emails de cobrança pela Iugu
* Correção: Valor de menor parcela agora pode ser maior do que o do pedido
* Correção: Correção no tratamento de erros no acesso à API Iugu
= 2.0.2 =
* Correção: Algumas traduções para o português não funcionavam.
= 2.0.1 =
* Adição: Tradução do plugin para o português.
= 2.0.0 =
* Melhoria: Removidas as funções deprecadas do WooCommerce.
* Correção: Função responsável por identificar se o cliente é uma empresa não funcionava apropriadamente.
Veja o [changelog completo no Github](https://github.com/iugu/iugu_payment-gateway-woocommerce/wiki).
== Upgrade Notice ==
= 2.0.2 =
Alguns usuários reportaram que tiveram problemas com algumas das traduções para o português liberadas na v2.0.1. Tentamos dar um jeito nisso nesta versão. Se, ainda assim, você não ver as traduções direitinho, é só mandar abrir um chamado no link https://support.iugu.com/hc/pt-br/requests/new .
== Suporte ==
= Canais =
* [Issues no Github](https://github.com/iugu/iugu_payment-gateway-woocommerce/issues)
* Atendimento da iugu:
* Chamados: Necessário enviar solicitação no link https://support.iugu.com/hc/pt-br/requests/new
= Compartilhando os logs =
1. Na administração do plugin do WooCommerce, acesse as configurações da iugu, ative o **Log de depuração** e tente realizar o pagamento novamente. Caso o log já esteja ativado, procure o número do pedido feito pelo comprador.
2. Copie o log referente ao número do pedido no menu *WooCommerce > Status > Logs*.
3. Crie um [pastebin](http://pastebin.com) ou um [gist](http://gist.github.com) e salve o log para gerar um link público de compartilhamento.
= Outras dúvidas =
Para dúvidas específicas sobre a iugu, acesse nossa [base de conhecimento](https://support.iugu.com).
== Colabore ==
Você pode contribuir para o desenvolvimento do plug-in fazendo o fork do repositório no [GitHub](https://github.com/iugu/iugu_payment-gateway-woocommerce).