Add Braspag payment to your WooCommerce e-commerce!
Add Braspag gateway to WooCommerce.
Braspag is a Brazilian payment gateway.
Development
This plugin was developer using the official docs of gateway, without any support.
None of developers have link with Braspag or WooCommerce.
Payment Methods
Compatibility
We tested this plugin against version 8.1+ of WooCommerce.
This plugin do not require Brazilian Market on WooCommerce 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 to your language.
FAQ
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?
Can I help you?
Yes! Visit GitHub repository.
ChangeLog
4.0.1
4.0.0
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
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:
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
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
1.3.0
- Fix cents on order amount and improve order validation.
1.2.0
1.1.0
- Best file organization.
- Added methods to work with ExtraDataCollection on Payment info.
1.0
- It’s alive!
- Receive payments with Braspag!
