This repository has been archived by the owner on Oct 29, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 51
/
readme.txt
271 lines (153 loc) · 10.5 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
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
=== Pagar.me for WooCommerce ===
Contributors: pagarme, claudiosanches, murilohns
Tags: woocommerce, pagarme, payment
Requires at least: 4.0
Tested up to: 5.6
Stable tag: 2.5.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 utilizando o Pagar.me
== Description ==
O [Pagar.me](https://pagar.me/) é a melhor forma de receber pagamentos online por cartão de crédito e boleto bancário, sendo possível o cliente fazer todo o pagamento sem sair da sua loja WooCommerce.
Saiba mais como o Pagar.me funciona:
[vimeo http://vimeo.com/74335951]
= Compatibilidade =
Compatível com desde a versão 2.2.x do WooCommerce.
Este plugin funciona integrado com o [WooCommerce Extra Checkout Fields for Brazil](http://wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/), desta forma é possível enviar documentos do cliente como "CPF" ou "CNPJ", além dos campos "número" e "bairro" do endereço. Caso você queira remover todos os campos adicionais de endereço para vender Digital Goods, é possível utilizar o plugin [WooCommerce Digital Goods Checkout](https://wordpress.org/plugins/wc-digital-goods-checkout/).
= Instalação =
Confira o nosso guia de instalação e configuração do Pagar.me na aba [Installation](http://wordpress.org/plugins/woocommerce-pagarme/installation/).
= Dúvidas? =
Você pode esclarecer suas dúvidas usando:
* A nossa sessão de [FAQ](http://wordpress.org/plugins/woocommerce-pagarme/faq/).
* Criando um tópico no [fórum de ajuda do WordPress](http://wordpress.org/support/plugin/woocommerce-pagarme).
* Criando um tópico no [fórum do Github](https://github.com/claudiosmweb/woocommerce-pagarme/issues).
= Colaborar =
Você pode contribuir com código-fonte em nossa página no [GitHub](https://github.com/claudiosmweb/woocommerce-pagarme).
== Installation ==
= Instalação do plugin: =
* Envie os arquivos do plugin para a pasta wp-content/plugins, ou instale usando o instalador de plugins do WordPress.
* Ative o plugin.
= Requerimentos: =
É necessário possuir uma conta no [Pagar.me](https://pagar.me/) e ter instalado o [WooCommerce](http://wordpress.org/plugins/woocommerce/).
= Configurações do Plugin: =
Com o plugin instalado acesse o admin do WordPress e entre em "WooCommerce" > "Configurações" > "Finalizar compra" e configure as opção "Pagar.me - Boleto bancário" e "Pagar.me - Cartão de crédito".
Habilite a opção que você deseja, preencha as opções de **Chave de API** e **Chave de Criptografia** que você pode encontrar dentro da sua conta no Pagar.me em **API Keys**.
Também será necessário utilizar o plugin [WooCommerce Extra Checkout Fields for Brazil](http://wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) para poder enviar campos de CPF e CNPJ.
Pronto, sua loja já pode receber pagamentos pelo Pagar.me.
Mais informações sobre as configurações do plugin em: [https://docs.pagar.me/v2/docs/configurando-o-plugin-pagarme-woocommerce](https://docs.pagar.me/v2/docs/configurando-o-plugin-pagarme-woocommerce).
== Frequently Asked Questions ==
= Qual é a licença do plugin? =
Este plugin esta licenciado como GPL.
= O que eu preciso para utilizar este plugin? =
* Ter instalado o plugin WooCommerce 2.2 ou superior.
* Possuir uma conta no [Pagar.me](https://pagar.me/).
* Pegar sua **Chave de API** e **Chave de Criptografia** no Pagar.me.
* Desativar a opção **Manter Estoque (minutos)** do WooCommerce.
= Quanto custa o Pagar.me? =
Confira os preços em "[Pagar.me - Preços](https://pagar.me/precos/)".
= Funciona com o Checkout Pagar.me? =
Sim, funciona desde a versão 2.0.0 para pagamentos com cartão de crédito.
= É possível utilizar a opção de pagamento recorrente? =
No momento ainda não é possível, entretanto iremos fazer esta integração em breve.
= O pedido foi pago e ficou com o status de "processando" e não como "concluído", isto esta certo ? =
Sim, esta certo e significa que o plugin esta trabalhando como deveria.
Todo gateway de pagamentos no WooCommerce deve mudar o status do pedido para "processando" no momento que é confirmado o pagamento e nunca deve ser alterado sozinho para "concluído", pois o pedido deve ir apenas para o status "concluído" após ele ter sido entregue.
Para produtos baixáveis a configuração padrão do WooCommerce é permitir o acesso apenas quando o pedido tem o status "concluído", entretanto nas configurações do WooCommerce na aba *Produtos* é possível ativar a opção **"Conceder acesso para download do produto após o pagamento"** e assim liberar o download quando o status do pedido esta como "processando".
= É obrigatório enviar todos os campos para processar o pagamento? =
Não é obrigatório caso você não utilize antifraude, no caso para digital goods.
É possível remover os campos de endereço, empresa e telefone, mantendo apenas nome, sobrenome e e-mail utilizando o plugin [WooCommerce Digital Goods Checkout](https://wordpress.org/plugins/wc-digital-goods-checkout/).
= Problemas com a integração? =
Primeiro de tudo ative a opção **Log de depuração** e tente realizar o pagamento novamente.
Feito isso copie o conteúdo do log e salve usando o [pastebin.com](http://pastebin.com) ou o [gist.github.com](http://gist.github.com), depois basta abrir um tópico de suporte [aqui](http://wordpress.org/support/plugin/woocommerce-pagarme).
= Mais dúvidas relacionadas ao funcionamento do plugin? =
Entre em contato [clicando aqui](http://wordpress.org/support/plugin/woocommerce-pagarme).
== Screenshots ==
1. Exemplo de checkout com cartão de crédito e boleto bancário do Pagar.me no tema Storefront.
2. Exemplo do Checkout Pagar.me para cartão de crédito.
3. Configurações para boleto bancário.
4. Configurações para cartão de crédito.
== Changelog ==
= 2.5.0 - 2020-01-07 =
* Exibe mensagem após instalação/ativação do plugin, recomendando a instalação do plugin Brazilian Market on WooCommerce
* Exibe mensagem após instalação/ativação do plugin, com um link para a documentação da Pagar.me
= 2.4.1 - 2020-12-17 =
* Fix: Reverte a alteração que tornava o plugin Brazilian Market on WooCommerce obrigatório
= 2.4.0 - 2020-12-16 =
* Torna o plugin Brazilian Market on WooCommerce obrigatório
= 2.3.0 - 2020-11-05 =
* Torna o campo bairro obrigatório
= 2.2.0 - 2020-09-10 =
* Adicionado header X-PagarMe-Version, dessa forma não será necessário alterar a versão de API na Dashboard.
* Adicionado User Agent para coletar informações úteis para melhor suporte.
= 2.1.0 - 2020-06-24 =
* Adicionado estorno para pagamentos via cartão de crédito.
= 2.0.18 - 2020-05-19 =
* Corrige exibição da bandeira do cartão no formulário de checkout
= 2.0.17 - 2019-10-07 =
* Alterado nome do plugin de "Woocommerce Pagar.me" para "Pagar.me for Woocommerce"
= 2.0.16 - 2019-09-23 =
* Corrigido erro "número de parcelas inválido" para compras utlizando o checkout pagar.me, onde o valor da compra era inferior ao valor da menor parcela.
= 2.0.15 - 2019-07-01 =
* Adicionado o novo status `analyzing` do Pagar.me
= 2.0.14 - 2018/05/02 =
* Corrigido problema de resetar para 1 parcela ao recarregar o formulário de dados de cartão.
= 2.0.13 - 2018/05/29 =
* Permitido resgistro de pedido para transação recusada no checkout Pagar.me.
* Corrige o timeout na captura no checkout Pagar.me.
= 2.0.12 - 2018/07/31 =
* Adicionado cidade e estado nos dados enviados para o Checkout Pagar.me.
* Adicionado suporte para "pending_review", melhorando a integração com boleto bancário.
= 2.0.11 - 2017/09/08 =
* Adicionada opção para suportar boletos assíncronos.
= 2.0.10 - 2016/09/29 =
* Adicionado `order_number` (número do pedido) como meta dado para transações com o Checkout Pagar.me.
= 2.0.9 - 2016/09/27 =
* Corrigido vendas canceladas com o Checkout Pagar.me feitas quando a parcela mínima era menor do que o mínimo permitido.
= 2.0.8 - 2016/09/15 =
* Adicionado `order_number` (número do pedido) como meta dado das transações.
= 2.0.7 - 2016/09/12 =
* Corrigido o valor da primeira parcela quando é menor do que o mínimo permitido.
* Adicionado código para corrigir o valor da taxa de juros antes de usar no Checkout Pagar.me.
= 2.0.6 - 2016/09/09 =
* Corrigida a compatibilidade com o WordPress 4.6.
* Corrigido o calculo das parcelas do cartão de crédito.
= 2.0.5 - 2016/07/15 =
* Correções para previnir mensagens de erro ao receber notificações de pagamentos.
= 2.0.4 - 2016/06/08 =
* Melhorado o fluxo das transações feitas com o Checkout Pagar.me.
= 2.0.3 - 2016/06/02 =
* Corrigido erro ao fazer uma transação com o Checkout Pagar.me onde é adicionada taxa de juros.
* Adicionado campo informando o total pago pelo cliente incluindo juros quando aplicável.
= 2.0.2 - 2016/05/11 =
* Corrigida a validação de campos da finalização para o Checkout Pagar.me.
* Melhorada das mensagens de erro para quando não abrir o Checkout Pagar.me.
= 2.0.1 - 2016/04/04 =
* Permitida a validação dos campos da finalização antes de abrir o Checkout Pagar.me.
* Corrigida a mudança de status do Checkout Pagar.me.
= 2.0.0 - 2016/04/02 =
* Adicionado novo método para pagamento com cartões de crédito.
* Adicionado novo método para pagamentos com boleto bancário.
* Adicionado suporte ao Checkout Pagar.me para pagamentos com cartão de crédito.
* Corrigida a exibição do boleto na página "Minha conta", fazendo os boletos aparecer apenas quando o pedido esta com os status de pendente ou aguardando.
= 1.2.4 - 2016/02/04 =
* Adiciona opção para cobrar juros de todas as parcelas do cartão de crédito.
= 1.2.3 - 2016/01/27 =
* Removida dependência do plugin WooCommerce Extra Checkout Fields From Brazil.
* Removida dependência dos campos de endereço, telefone e empresa (obrigatório apenas nome, sobrenome e e-mail).
* Adicionado link para segunda via do boleto na tela de administração de pedidos e na página "Minha Conta".
= 1.2.2 - 2014/10/27 =
* Atualizada URL da biblioteca JavaScript do Pagar.me.
= 1.2.1 - 2014/10/27 =
* Corrigido o método que manipula os retornos do Pagar.me.
= 1.2.0 - 2014/10/12 =
* Adicionada opção para controlar o número de parcelas sem juros.
= 1.1.0 - 2014/09/07 =
* Adicionado suporte para a API de parcelas do Pagar.me.
* Adicionada opção de taxa de juros para as parcelas.
* Adicionado suporte para o WooCommerce 2.2.
= 1.0.0 =
* Versão incial do plugin.
== Upgrade Notice ==
= 2.0.12 =
* Adicionado cidade e estado nos dados enviados para o Checkout Pagar.me.
* Adicionado suporte para "pending_review" melhorando a integração com boleto bancário.