Magento Plugin Overview & Implementation – Paystand Help Center

Key Features

The Paystand checkout is fully embedded in the Magento UI and can be customized to include your company’s logo and background color.

It supports both zero-fee payment methods (bank transfers), credit card payments, and ACH. Customers can check out as guests or while logged into their accounts.

The integration supports syncing of Magento orders and Paystand payments with NetSuite for end-to-end ERP reconciliation (if applicable).

Orders in Magento automatically update upon successful payment. This relies on proper webhook configuration.

Webhooks must be configured correctly in Paystand to ensure order statuses are updated in Magento. Without them, payment updates will not reflect in the store.

Payment processing fees are included in the Paystand transaction total and displayed in the Magento UI.

Magento integration supports storing payment methods as a logged in user.

Supports two checkout experiences depending on whether your customer is logged into their store account or checking out as a guest. Each flow offers a slightly different set of features.

Magento 2 Guide — Install & Configure Paystand Payment Gateway

This page explains how to install, configure, and operate the Paystand Magento 2 plugin, including webhook setup, Fees & Incentives configuration, and optional NetSuite reconciliation.

1. Setup Requirements

To implement the Paystand plugin, you will need:

Before You Begin

1) Install the module (run from Magento root)

Run the following commands from your Magento root directory:

composer config repositories.paystand-magento2 git <https://github.com/paystand/paystand-magento2.git>
composer require paystand/paystandmagento:dev-master#3.6.1
composer update
php bin/magento setup:upgrade

2) Configure Paystand in Magento Admin

  1. Go to the Magento Admin Panel → Stores → Configuration → Sales → Payment Methods → Paystand

  2. Enter your credentials (including the publishable_key) from the Paystand Dashboard → API Configuration Values

  3. Click Save Config

  4. Flush Magento cache (Admin: System → Cache Management or CLI: php bin/magento cache:flush)

This enables Paystand as a payment method in your Magento checkout.

3) Enable a webhook event URL (payment status updates)

Webhooks are mandatory for accurate order posting. Without them, Magento will not receive payment confirmations.

  1. Locate your Magento 2 base URL
  2. Use this webhook URL format:
https://{your magento base url}/paystandmagento/webhook/paystand
  1. In Paystand Dashboard, go to Webhook Event URLs and click Add a Webhook event URL
  2. Paste the URL (replace {your-magento-base-url} with your real domain) and click Save

When a payment succeeds, Paystand sends a webhook event that updates the corresponding Magento order.

4) Assign Convenience Fee / Incentive plan (Preset URL Key)

If you use Paystand’s Fees & Incentives engine:

  1. In Paystand Dashboard, copy your Preset URL Key

(Dashboard → Fees & Incentives)

  1. In Magento Admin → Paystand configuration, paste it into:

Checkout preset key

  1. Save configuration

This ensures Magento applies the correct incentives, surcharges, or method restrictions at checkout.

6. Magento → Paystand Payment Flow

Base Checkout Flow (All Merchants)

  1. Customer begins checkout → Magento creates a QuoteID

  2. Paystand embedded checkout renders

  3. Customer completes payment

  4. Paystand returns a Payment Object

  5. Webhook fires → Magento updates the order status

This is the complete flow for merchants not using NetSuite.

7. Optional: NetSuite ERP Reconciliation

For merchants using Paystand + NetSuite integration, Magento is part of a larger financial workflow.

Full ERP Flow

  1. Customer checks out in Magento

  2. Paystand processes payment

  3. Webhook updates Magento order

  4. Magento pushes order + payment to NetSuite

  5. NetSuite:

API Used for Payment Application

POST https://api.paystand.com/v3/netsuites/apply-payment/public

Required fields include:

The NetSuite record must exist before a payment can be applied.

8. Troubleshooting & Common Misconfigurations

Symptom Likely Cause Fix
Orders stay in “Pending Payment” Webhook not configured or failing Verify webhook URL & response codes
Fees not showing in Magento Missing preset key Add Checkout preset key
Checkout not loading Incorrect API credentials Re-enter keys in admin
Payments not posting to NetSuite Missing ERP mapping fields Validate ERP field mappings

Prev Next

Table of contents

Magento Plugin Overview & Implementation