Pagar.me (Stone) for nopCommerce 4.90.x

The StuCommerce Pagar.me (Stone) Payment Plugin provides a complete integration between nopCommerce 4.90.x and the Pagar.me/Stone payment platform, combining the native nopCommerce payment workflow with additional reconciliation, administration and payment management features.

The plugin uses Pagar.me's hosted checkout for payment processing while avoiding reliance solely on browser redirects to confirm transactions. An automated background process periodically checks the payment status directly with Pagar.me and updates the corresponding nopCommerce order when payment is confirmed.

This provides a more reliable payment workflow even when a customer closes the payment page, loses connectivity or does not successfully return to the store after completing a payment.

Main features include:

• PIX, credit card and boleto payment methods through Pagar.me/Stone.
• Automatic conversion to BRL, allowing orders created in other currencies to be correctly charged in Brazilian reais.
• Uses the currency exchange rates configured in nopCommerce.
• Sends the actual order products to Pagar.me, including product names, quantities and amounts.
• Handles shipping, discounts, taxes and order adjustments while keeping the Pagar.me total consistent with the final nopCommerce order total.
• Configurable order prefix, allowing references such as STU00001, EVN00001 or any store-specific format.
• Useful when the same Pagar.me account is shared across multiple companies, brands or operations.
• Automatic payment reconciliation using native nopCommerce Scheduled Tasks.
• Payment lookup using the order reference directly through the Pagar.me API.
• Manual payment synchronization from the administration area.
• Protection against duplicate payment processing.
• Orders are marked as paid using the native nopCommerce payment workflow.
• Pagar.me payment information displayed directly on the nopCommerce order administration page.
• Displays information such as payment reference, status, BRL amount, Payment Link ID, Pagar.me Order ID, Charge ID and last synchronization date.
• Direct access to the Pagar.me checkout link from the order administration page when available.
• Synchronization and payment status changes recorded in the nopCommerce order notes.
• Full and partial refunds for supported payment methods, including PIX and credit cards.
• Tracking of previously refunded amounts.
• Idempotency protection to reduce the risk of duplicate refund operations.
• Recognition of refund information performed directly from Pagar.me during synchronization.
• Cancellation of pending Payment Links directly from the nopCommerce administration panel.
• Multi-Store support, allowing each nopCommerce store to use its own Pagar.me configuration.
• Each Store can have its own Secret Key, environment and order prefix.
• Additional protections prevent orders from being synchronized or financially processed using credentials belonging to another store.
• Support for both Sandbox and Production environments.
• Administrative configuration for PIX expiration, boleto due date, credit card installments, Statement Descriptor and other payment settings.
• Developed according to the standard nopCommerce Payment Plugin architecture, without requiring changes to the nopCommerce core files.

The StuCommerce Pagar.me (Stone) plugin was designed to provide more than payment generation. It connects the Pagar.me financial workflow with nopCommerce order management, providing payment creation, reconciliation, administration and post-payment operations in a single integration.

It is suitable for e-commerce stores, digital products, ticket sales, services and other businesses running nopCommerce 4.90.x that want to process payments using the Pagar.me/Stone infrastructure.