-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
272 lines (154 loc) · 7.25 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
272
=== Pagador (Braspag) Checkout for WooCommerce ===
Contributors: mariovalney
Donate link: https://github.com/mariovalney/woo-checkout-braspag
Tags: woocommerce, payment, braspag, mariovalney
Requires at least: 4.7
Tested up to: 6.3
Requires PHP: 7.2
Stable tag: 4.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Add Braspag payment to your WooCommerce e-commerce!
== Description ==
Add Braspag gateway to WooCommerce.
[Braspag](https://www.braspag.com.br) is a Brazilian payment gateway.
### Development ###
This plugin was developer using the [official docs](https://braspag.github.io) of gateway, without any support.
None of developers have link with Braspag or WooCommerce.
### Payment Methods ###
- Bank Slip
- Credit Card
### Compatibility ###
We tested this plugin against version 8.1+ of WooCommerce.
This plugin do not require [Brazilian Market on WooCommerce](http://wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) but suggest your use.
Braspag only requires customer name, but more fields are need for anti fraud or other gateway features.
### Configuration ###
After installing the plugin, activate the payment method and go to the configuration page.
- Activate the payment method.
- Fill the title and description for this payment method.
- Add the "Merchant ID" provided by Braspag.
- Check the option "Sandbox" if the store is not in Production (available for real sale).
- Add the "Secret Merchant Key" provided by Braspag (note that it is different for Sandbox).
After that, just activate the available payment methods.
All of them require a "Provider" provided by Braspag and some settings: read the tips (icon with the question mark) for more information.
= Translations =
You can [translate Pagador (Braspag) Checkout for WooCommerce](https://translate.wordpress.org/projects/wp-plugins/woo-checkout-braspag) to your language.
== Installation ==
* Install "Pagador (Braspag) Checkout for WooCommerce" by plugins dashboard.
Or
* Upload the entire `woo-checkout-braspag` folder to the `/wp-content/plugins/` directory.
Then
* Activate the plugin through the 'Plugins' menu in WordPress.
== Frequently Asked Questions ==
= Does it works with Gutenberg? =
Yes. WooCommerce supports WordPress 5+ and we too.
= Does it works for another e-commerce plugin? =
Nope. This is a WooCommerce extension.
= I cannot add a payment on order administration =
To create a payment on admin you should:
- Add a name to "billing address".
- Make sure order is not empty and not paid (needs payment).
- Set Braspag as payment method.
- Transaction ID must be empty.
= Transaction ID? =
The transaction ID is the Braspag number on your order.
If you already have a Transaction ID (payment was done in Braspag) you must use the relative Order Action to get information from Braspag.
= My orders are not being updated automatically =
You should configure a URL to receive notification from Braspag.
It should be: "example.com/?wc-api=WC_Checkout_Braspag_Gateway"
Do not forget to change "example.com" to your home url.
= Which URL I should inform to receive Braspag POST Notifications? =
Check the previous FAQ.
= How about e-wallet? =
E-wallet is still on ALFA and not fully implemented. The payment method will not show up on checkout page (or order administration).
We DO NOT RECOMMEND, but you can implement it by yourself:
Step 1 - Create your frontend implementation as documented by e-wallet.
Step 2 - Filter the `wc_checkout_braspag_frontend_payment_methods` return to allow e-wallet on front-end.
Step 3 - Create and fill hidden inputs on `braspag/payment-methods/wl-form.php` for the data received by e-wallet:
- braspag_payment_wl_type: the e-wallet type (Braspag docs: Wallet.Type).
- braspag_payment_wl_token: the received token/code from e-wallet (we will fill the required Braspag field for each wallet type - there is no standard field name).
- braspag_payment_wl_installments: payment installments (from Braspag docs, but we are not sure it can be not 1).
Step 4 - Make sure everything is configured on WooCommerce admin (WalletKeys) and on Braspag (environment and production credentials).
If you want to contribute a PR will be appreciated.
= My bank slip number changed =
We used to sent the "BoletoNumber" to Braspag but it's not required and can cause problems for some providers.
By now we decided to remove this field and alow you to add/change it if "wc_checkout_braspag_bank_slip_number" filter.
This will not change nothing on WordPress dashboard.
= What is PHP? =
It is a programming language for web development. PHP as like any software it has versions. And we just support 7 (and above).
If you are using PHP in version below 7, please contact your host to update your environment.
= Who are the developers? =
* [Mário Valney](https://mariovalney.com/me) is a Brazilian developer who integrates the [WordPress community](https://profiles.wordpress.org/mariovalney).
= Can I help you? =
Yes! Visit [GitHub repository](https://github.com/mariovalney/woo-checkout-braspag).
== Screenshots ==
1. Screenshot 1
2. Screenshot 2
3. Screenshot 3
== Changelog ==
= 4.0.2 =
* Minor fixes.
= 4.0.1 =
* Minor fixes.
= 4.0.0 =
* Support to PHP 8.2.
= 3.2.2 =
* Added 'wc_checkout_braspag_update_order_from_payment_transaction' filter.
* Added 'is_processing_payment' method on gateway to allow developers check the first transaction data.
* Added 'get_recurrent_payment' method in query requrests.
= 3.2.1 =
* Added API error messages when creating orders ('WC_Checkout_Braspag_Messages::payment_error_message' on 'post_transaction').
= 3.2.0 =
* Added 'wc_checkout_braspag_payment_status' filter.
* Added 'wc_checkout_braspag_payment_status_note' filter.
* Added 'wc_checkout_braspag_payment_error_message' filter.
* Added 'wc_checkout_braspag_do_payment_request' filter.
= 3.1.3 =
* Added a way to overwrite wallet key with front-end (e-wallet are still in BETA).
= 3.1.0 =
* Added option to send Company Name instead Customer Name if CNPJ is presented.
= 3.0.1 =
* Fixed CardToken storage.
= 3.0.0 =
It's a developer version:
* Allow developers to create payment with a payent data array (maybe by API).
* E-wallet implementation on BETA (without front-end integration by now).
For users:
* Few translation fixes.
= 2.2.2 =
* Updated Braspag Providers.
= 2.1.1 =
* Fixed customer identity if person type is not provided.
= 2.1.0 =
* Removed "BoletoNumber" field.
* Added filters.
= 2.0.1 =
* Translation fix
= 2.0.0 =
* Improved payment info on order.
* Added customer validation on checkout.
* Allow developers skip payment method on checkout.
* Allow create payment on order administration.
= 1.4.0 =
* Added payment info on order.
* Added autofind for credit card brands.
* Removing Debit Card as it's not tested.
= 1.3.3 =
* Added payment info on mails.
= 1.3.2 =
* Support to empty Credentials if already configured on Braspag.
= 1.3.1 =
* Support to Issuer.
= 1.3.0 =
* Fix cents on order amount and improve order validation.
= 1.2.0 =
* Support to Safra
= 1.1.0 =
* Best file organization.
* Added methods to work with ExtraDataCollection on Payment info.
= 1.0 =
* It's alive!
* Receive payments with Braspag!
== Upgrade Notice ==
Support to new PHP version. It's a major update!
Please, check changes on staging before update.