Skip to content

Integration guide

Adding payments to a store without disrupting daily operations

The installation is only the start. Review order states, refunds, and ownership before connecting a new payment provider.

PayPort editorial team

Start with the store your team actually operates

A platform name alone does not describe your checkout. Two WooCommerce stores can use different checkout layouts, extensions, and inventory rules. An EC-CUBE deployment or a custom storefront may have its own adjustments. Record the version, important extensions, and current payment behavior before selecting a connection.

Include the people who handle orders after the sale. They may depend on status labels, email notifications, or a particular refund screen. A technical integration that changes those habits without explanation can slow down an otherwise successful launch.

Agree on which system owns each decision

The store usually owns products, stock, and delivery. The provider owns the payment result. Your integration connects those facts, but the business must decide how they affect an order. A request created, a payment authorized, and funds confirmed may represent different steps.

Write those mappings in ordinary language before implementing them. For example, keep an unpaid convenience-store order waiting; start fulfillment only after verified payment; flag a refund that failed for staff review. Avoid a single 'complete' label that hides several different events.

Check compatibility before spending a day installing

Confirm whether the integration supports the checkout variant and methods you intend to offer. Review currency, device flows, and any requirements for your business location. An available logo is not a guarantee that the method can be enabled for every merchant or platform.

For a custom connection, clarify who maintains it after launch. Ask how updates, API changes, and troubleshooting will be handled. Those answers matter as much as the initial development estimate.

Test refunds as carefully as purchases

Platform refund behavior depends on the gateway and the type of refund. In WooCommerce, an automatic refund through a supported gateway can return money and update the order; recording a manual refund is a different operation. Your team should know which action actually moves funds.

Test a full refund and, where supported, a partial refund. Check the payment record, order notes, customer communication, and finance report. Do not conclude that money was returned solely because a status was changed in the store.

Try the cases that happen on an ordinary busy day

A customer closes a tab after paying. A notification arrives twice. A payment remains pending. Someone asks to change the order. These are not exotic situations, and they should not require the original developer to interpret them every time.

Use a small acceptance checklist: confirmed payment reaches the order; unpaid orders remain identifiable; repeated events do not duplicate fulfillment; errors are visible; staff can trace a refund. Include the supported mobile wallet flow in that exercise.

Use one delayed order as an acceptance test

Take an order that can remain unpaid after the checkout closes. On the customer side, the order page should display the correct waiting state and any required action. On the staff side, the order should be identifiable without treating it as ready to ship.

When a verified successful result arrives, confirm that the store changes the order exactly once and that the normal fulfillment workflow begins. Then replay the same notification in the test environment. The business should not send a second shipment or a duplicate customer confirmation.

Finally, process a supported refund and trace it in both the store and provider records. Agree what staff should do if that refund fails. Passing this end-to-end test tells you more about readiness than a successful installation or a single paid test order.

Launch with a recovery plan

Keep a record of the previous configuration and decide how to pause or roll back the new option if orders do not update as expected. Do not leave customers with an enabled method your team cannot operate.

After launch, compare a sample of store orders with provider transactions and review the first settlement report. When those records join cleanly, the connection is doing more than collecting money: it is supporting the daily work of the store.

A payment integration is ready when customer service, fulfillment, and finance can all follow the same order.
What to take away
Back to the blog