About this plugin
At checkout the buyer is sent to the hosted Pay with Xpat page, pays by card or Xpat wallet, and comes back to your store. The plugin confirms every payment with the Xpat API before it marks an order paid.
Set up in minutes
- Separate Test and Live credentials: test first, then flip one switch to go live.
- Credentials are checked against Xpat when you save, with plain-language fixes when something is wrong.
- A status panel shows your mode, whether the keys work, the webhook URL (one-click copy) and when the last webhook arrived.
- A “Test mode” notice at checkout so nobody mistakes a test store for a live one.
Built to never lose a payment
- Orders are marked paid only once Xpat accepts the payment; anything uncertain stays pending.
- Signed webhooks update orders instantly. Because a webhook can be missed, a reconcile job re-checks open orders every 15 minutes.
- A buyer retrying payment reuses their open Xpat session instead of opening a second one, so they can’t be charged twice.
- Sessions expire before WooCommerce cancels unpaid orders, and cancelling an order closes its Xpat session.
- A payment that arrives late, for the wrong amount, or is later reversed puts the order On hold with a note, instead of shipping by mistake.
Works with
- Classic checkout and the Cart & Checkout blocks.
- High-Performance Order Storage (HPOS).
External services
This plugin connects to the Pay with Xpat service, operated by Xpat, to take payments. It is required for the plugin to work.
- Xpat payments API ( api.remit2any.com, or dev.api.remit2any.com in Test mode). When a buyer chooses Pay with Xpat, the plugin sends the order number, order total and currency, the item names and quantities, the buyer’s name and email address, your site address and the return URLs. It also reads payment status for your orders, and checks your credentials when you save the settings.
- Xpat hosted checkout ( xpat.money, or dev.xpat.money in Test mode). The buyer is redirected there to pay. Card and wallet details are entered on Xpat’s page and never reach your site.
-
Webhooks from Xpat to your site’s /wp-json/pay-with-xpat/v1/webhook endpoint tell the plugin when a payment’s status changes.
-
money/service-terms
- Privacy policy: https://xpat.money/privacy
- All legal documents: https://xpat.money/legal
Developer hooks
- pay_with_xpat_session_payload — filter the create-session payload ( $payload, $order ).
- pay_with_xpat_supported_currencies — filter allowed currencies.
- pay_with_xpat_session_lifetime_minutes — how long a payment session stays open (defaults to WooCommerce’s hold-stock time minus 5 minutes).
- pay_with_xpat_reconcile_batch — orders re-checked per reconcile run (default 100).
- pay_with_xpat_api_base_url — API host ( $url, $environment ).
- pay_with_xpat_checkout_host — hosted checkout host ( $url, $environment ).
- pay_with_xpat_checkout_path — hosted checkout path, default /pay/wallet-selection ( $path, $environment ).
- pay_with_xpat_icon — checkout logo URL; return an empty string to hide it.