Xaurr for WooCommerce

Priskribo

Xaurr for WooCommerce adds “Pay with Xaurr” to your checkout.

  • The customer places the order and a secure Xaurr window opens right there on your checkout page to pay with the methods Xaurr offers, such as mobile money, card or bank transfer. The address bar keeps showing your own shop the whole time, and their payment details never touch your site.
  • Once they pay, they are brought back to your order-received page automatically.
  • Your order is marked paid (Processing) only once Xaurr confirms it is safe to ship, meaning your payout is confirmed. Until then it stays On hold.
  • A refund started from your order (or at Xaurr) marks the order Refunded.
  • Works with the classic checkout and the block-based checkout.
  • Orders in US dollars are accepted: the buyer pays in local currency at the live exchange rate.
  • You choose in Xaurr whether you are paid out the same day or the next working day. Same day takes mobile money only, so keep Next day if you take cards.

Test mode uses a test key and moves no real money. Live mode uses your live key and takes real payments once Xaurr has opened live checkout for your account.

Your shop needs a Xaurr Business account (free to open at https://xaurr.com) with a receiving account for your payouts (mobile money or bank) in a country where Xaurr pays out.

External services

This plugin connects to Xaurr (https://xaurr.com), the payment service that takes the payment. It is needed for the plugin to work: without it there is nothing to pay with.

  • When a customer places an order and chooses Pay with Xaurr, the plugin sends the Xaurr Checkout API (https://api.xaurr.com) the order reference, the amount and currency, a title made of the order number and your shop’s name, a short list of the items and quantities, and the addresses of your order-received and checkout pages. Xaurr returns a payment page.
  • The customer then pays in a Xaurr window loaded from https://xaurr.com. Their mobile money number, card or bank details and the payment itself go to Xaurr only, never to your site.
  • To keep your orders up to date, the plugin asks the Xaurr Checkout API for the status of orders that are still open: when the customer returns to your shop, and every few minutes.
  • When you refund an order from WooCommerce, the plugin sends the refund request (the order reference and the amount) to the Xaurr Checkout API.
  • If you add the optional webhook, Xaurr sends payment and refund updates for your orders to your site’s webhook address, signed with a secret only you and Xaurr hold.

Every request is made with your own Xaurr secret key. Xaurr’s terms: https://xaurr.com/?terms=true. Xaurr’s privacy policy: https://xaurr.com/?privacy=true.

Instalo

  1. In WordPress, go to Plugins, Add New, Upload Plugin, choose xaurr-for-woocommerce.zip, Install Now, then Activate. WooCommerce must be installed and active.
  2. In Xaurr, open Business Tools, then Webhooks & API Keys, and create a key in the Test environment. Copy the secret key (it starts with sk_test_).
  3. In WordPress, go to WooCommerce, Settings, Payments, Xaurr. Tick Enable, paste the test secret key, and save.
  4. Make a test order at your shop, choose “Pay with Xaurr”, and follow the steps.
  5. Optional, for instant order updates: in Xaurr add the webhook address shown on the settings screen, and paste its signing secret into the plugin.
  6. When you are ready for real payments, add your live key (sk_live_), untick Test mode, and save.

OD

Which currency does it work with?

Ghana cedis (GHS), for orders between GHS 1 and GHS 15,000, and US dollars (USD), for orders between 1 and 500 dollars for now. A US dollar order is paid by the buyer in cedis at the live exchange rate and you are paid out in cedis. In any other currency the option is hidden at checkout.

When is my order marked paid?

When Xaurr says it is safe to ship. Before that the order is On hold. Do not ship On hold orders.

How can my customers pay?

With the methods Xaurr offers, such as mobile money, card or bank transfer, in Xaurr’s secure window on your checkout page.

How am I paid?

To the receiving account in your Xaurr dashboard (mobile money or bank), in local currency. Xaurr pays out in Ghana today, with more countries coming.

Do I need a webhook?

No. Without one, your orders are updated when the customer returns to your shop and every few minutes. A webhook makes it instant.

Pritaksoj

There are no reviews for this plugin.

Kontribuantoj k. programistoj

“Xaurr for WooCommerce” estas liberkoda programo. La sekvaj homoj kontribuis al la kromprogramo.

Kontribuantoj

Traduki “Xaurr for WooCommerce” en vian lingvon.

Ĉu interesita en programado?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Ŝanĝprotokolo

1.0.4

  • Website verification: paste your Xaurr website verification code in the settings to prove the website is yours, which live payments need.

1.0.3

  • Shops can sell in Nigerian naira, Kenyan, Ugandan and Tanzanian shillings, Zambian kwacha, Congolese francs and West African CFA francs as well as Ghana cedis and US dollars. A currency outside Ghana works once Xaurr has opened payments in that country for your account.
  • Refunds work the same way in every currency: you approve a mobile money request on your own number in that country and the customer is refunded automatically. Naira orders are refunded by you directly and recorded with “Refund manually”.

1.0.2

  • A warning on the WooCommerce screens when the site runs a PHP version that no longer gets security fixes (older than 8.2), so the shop can ask its host to update.

1.0.1

  • The payment window’s styles and script are loaded with wp_enqueue functions.
  • The “needs WooCommerce” notice shows on the Plugins screen only.
  • Shorter, simpler names and descriptions.

1.0.0

  • First release in the WordPress plugin directory.
  • Talks to Xaurr at api.xaurr.com.
  • Checked against the WordPress plugin guidelines and tested on WordPress 7.1.

0.1.1

  • Orders in US dollars are accepted (the buyer pays the cedi equivalent at the live rate; you are paid in cedis).

0.1.0

  • First version: classic and block checkout, test and live keys, automatic order updates, refunds.