Glin Payments for WooCommerce -- WordPress 插件

开发者	lucianoglin
更新时间	2026年9月23日 07:28
PHP版本:	7.4 及以上
WordPress版本:	7.0
版权:	GPLv2 or later
版权网址:	版权信息

Glin Payments for WooCommerce adds Glin as a WooCommerce payment gateway. It lets Brazilian shoppers pay in BRL using card or PIX while the WooCommerce order remains in the merchant settlement currency supported by Glin. The plugin loads the official Glin Checkout SDK automatically, sends tokenized payment data from WordPress to Glin with the merchant API key, and reconciles final order state through signed Glin webhooks. Merchants do not need to configure a custom SDK URL. Main capabilities:

Card and PIX checkout support.
Classic checkout and WooCommerce Checkout Blocks support.
Automatic Glin remittance reservation during checkout.
Automatic webhook registration when gateway settings are saved.
Short card status polling so fast declines can keep shoppers on checkout.
Order-received polling and bounded WordPress cron reconciliation as webhook fallbacks.

Requirements:

WooCommerce 7.8 or newer.
A Glin merchant account.
Glin API and public checkout keys for sandbox or live mode.
A WooCommerce store currency supported by Glin.
Public HTTPS store URL for automatic webhook registration.

Install and activate WooCommerce.
Install this plugin from Plugins > Add New, or upload the plugin ZIP from Plugins > Add New > Upload Plugin.
Activate Glin Payments for WooCommerce.
Open WooCommerce > Settings > Payments.
Enable Glin.
Choose Sandbox or Live mode.
Enter the matching Glin API key and public checkout key.
Choose the payment methods to expose, then save settings.

After settings are saved, the plugin attempts to register the store webhook with Glin. Local HTTP stores can still test checkout flows, but webhook registration requires a public HTTPS URL.

0.1.12

Stop creating a second remittance for the same cart. The plugin created one every time WooCommerce refreshed the checkout, which happens on page load as well as on every address, shipping, quantity and coupon change -- so a single page load could produce two remittances seconds apart, and the spare expired unpaid. Creating a remittance is now tied to the cart total actually changing; a refresh that only replaces the page re-attaches the existing one.
When the remittance field is lost by one of those refreshes, the order now reuses the remittance already reserved for the cart where it can, instead of always creating another.

0.1.11

Tell the checkout SDK which language the store speaks. The SDK renders the card form itself and defaulted it to Portuguese regardless of the store, so an English store showed English labels wrapped around a Portuguese card form. It now follows the WordPress site language on both the classic and block checkouts.

0.1.10

Show the payer an itemised cost breakdown at checkout, the same one Glin's own checkout shows: foreign currency amount, exchange rate, converted amount, IOF with its rate, the card or PIX fee, the Glin fee, and the total -- following whichever method the payer selects. Previously this was a single line ("You pay R$X. Merchant order amount: $Y."), which told the payer the total had grown but not by what, leaving merchants to explain an unexplained gap against the spot exchange rate.
Check the store currency against your Glin payout currency instead of a fixed list. Glin charges in the payout currency chosen when your account was created, so a store selling in anything else could never complete a payment -- but the gateway still appeared at checkout and the payment failed in front of the customer, with nothing shown in the admin. The gateway is now hidden in that case and an admin notice names both currencies. If the payout currency cannot be read the previous behaviour is kept, so a temporary connection problem cannot take a working store offline.
Removed BRL from the accepted store currencies: Glin issues no BRL payout contracts, so a BRL store could not take a payment.

0.1.9

Identify the plugin on every API call. Requests used WordPress's default user agent, which is identical to every other plugin on the same site, so nothing in our own logs attributed a request to this plugin -- answering "is the plugin working in production?" meant reading raw load-balancer logs and guessing. Calls now send "GlinPaymentsWooCommerce/; WordPress/; ", which adds attribution without sending anything the default agent did not already send.

0.1.8

Load the checkout styles and the payment-status script on the My Account order page too. A pending PIX order shown there had an unstyled QR code and a status line that said it was waiting for confirmation but never updated, because nothing was polling it.

0.1.7

Stop the PIX QR code filling the whole column on desktop. The size was set on the image, and Elementor's .elementor img { max-width: 100% } is a more specific selector, so it won and the code stretched to the width of the page. The QR code is now sized by a container of its own, which a theme has no reason to restyle.

0.1.6

Fix classic checkout never sending payment data. WooCommerce dispatches checkout_place_order_<gateway> with triggerHandler(), which does not bubble, so the handler bound on document.body never ran and orders were placed with an empty payload and immediately failed with "Glin payment was not ready."
Bind the place-order handler to form.checkout directly and re-bind it after each checkout update.
Fix every card payment failing with "This remittance is not available for the current checkout session." The {remittanceId} placeholder in the prepare endpoint URL was stripped by esc_url_raw(), so the request went to a literal remittanceId path. Affected both classic and block checkout.
Send the billing phone in E.164 when preparing a payment. WooCommerce stores whatever the shopper typed, and the unnormalized value was rejected, so card payments could not get past the prepare step. The pay request already normalized; prepare did not.
Stop mangling phone numbers in area code 55, and accept a phone written with the national trunk "0" before the area code. Brazil's country code and the Santa Maria area code are the same two digits, so testing for a "55" prefix removed those shoppers' area code instead of adding the country code and their payments were rejected. Length tells the two apart once the trunk "0" is stripped.
POST the 3D Secure challenge with its creq field instead of opening the ACS URL as a plain link. EMV 3DS 2.x answers a bare GET with an error page. Falls back to a link when the provider sends no creq.
Treat an expired or canceled remittance as terminal. A checkout abandoned before any order exists reports only remittanceStatus, so orders previously stayed in "pending payment" forever and consumed every reconciliation attempt.
Keep polling for payment confirmation for the full 32 minutes a PIX code can be paid in, up from 6, and tell the payer when the page stops watching instead of leaving "Waiting for payment confirmation" on screen forever.

0.1.5

Log sanitized Glin API failure context to WooCommerce logs when debug logging is enabled.
Include request method, endpoint path, status code, safe remittance fields, and boolean presence checks for sensitive customer, address, and card payload fields.
Keep card tokens, device fingerprints, CPF/CNPJ, email, phone, and full address values out of plugin logs.

0.1.4

Validate WooCommerce order totals against the Glin merchant API amount range before initializing checkout.
Replace raw API validation text with a shopper-safe order amount message.

0.1.3

Verify the webhook JWS over the raw request body, as required by the unencoded detached payload form (RFC 7797). Earlier versions base64url-encoded the body first and rejected every valid signature.
Check the protected header claims before trusting a webhook: alg is RS256, b64 is false, aud matches the integration account, and kid names a key in Glin's JWKS.
Send the API key as a Bearer token when fetching the JWKS, which that endpoint requires.

0.1.2

Remove screenshot captions until matching WordPress.org screenshot assets are available.

0.1.1

Initial pilot release of the Glin WooCommerce gateway.

Glin Payments for WooCommerce

标签

下载

详情介绍:

安装:

升级注意事项:

常见问题:

更新日志: