=== Blipply — Crypto Payments for WooCommerce ===
Contributors: blipply
Tags: woocommerce, payment gateway, crypto, bitcoin, usdc
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept crypto at your WooCommerce checkout. Customers pay from any wallet; you are credited in dollars in your Blipply account.

== Description ==

Blipply lets a WooCommerce store take crypto without touching a blockchain, holding a coin, or learning what a wallet is.

Your customer chooses **Pay with crypto** at checkout, is taken to a secure Blipply payment page, and pays from whichever of hundreds of cryptocurrencies they hold. You are credited in **dollars**. The order is marked paid and the customer is returned to your store.

= What you should know before installing =

**The money arrives in Blipply, not in WooCommerce.** Crypto payments settle as USDC into your Blipply wallet. WooCommerce records the sale and marks the order paid, but your bank balance will not move and your usual payout will not include these orders. You spend or withdraw them from Blipply, including with the Blipply card.

**Refunds are manual.** There is no way to send crypto back automatically. You refund from your Blipply wallet and mark the order refunded in WooCommerce yourself. This plugin deliberately does not add a Refund button that could not work.

**You need a Blipply account.** It is free, and it takes about ten minutes. It cannot be created from inside WordPress, because your wallet is created on your own device — see Installation.

**Test and live are separate accounts.** The plugin can run against Blipply's test system, but that is a different system with its own sign-up and its own keys — nothing you create there exists in your live account. While in test mode the payment option is labelled "(Test mode — not a real payment)" at the checkout, so a store cannot quietly take orders that moved no money.

= Features =

* Works with both the block checkout and the classic checkout
* Prices in your own store currency — Blipply converts at payment time, so a link is worth what it says whenever the customer gets to it
* Signed payment notifications, verified before an order is ever marked paid
* An independent reconciliation job, so a dropped notification delays an order rather than losing it
* Unpaid orders are cancelled after a period you choose, which releases the stock they were holding
* HPOS (High-Performance Order Storage) compatible

== Installation ==

1. Install and activate the plugin.
2. Go to **WooCommerce → Settings → Payments → Blipply** and enable it.
3. Choose your **Environment** first. Production is real payments on your live Blipply account; Development is a separate test system where nothing is real money. Everything below depends on which one you picked, so get it right before signing up.
4. Follow the link on that screen to Blipply, sign up, and create your business.
5. In Blipply, open **Integrations** and create an API key. You are shown a key and a signing secret **once** — copy both.
6. Paste them into the plugin settings and save.

That is all. On save the plugin tells Blipply where to send payment notifications and where to return your customers to. You do not need to configure anything on Blipply's side.

== Frequently Asked Questions ==

= Which cryptocurrencies can my customers pay with? =

Hundreds, across several networks, from any wallet they already use. They choose; you always receive dollars.

= What are the fees? =

1% of the order, taken from your Blipply balance after the money arrives. There is no monthly fee and no setup fee.

= Do I need to hold or understand crypto? =

No. You are credited in dollars and never hold a coin unless you choose to.

= What happens if a customer does not finish paying? =

The order stays on hold, keeping the stock reserved, and is cancelled automatically after the period you set. Its payment link is switched off at the same time so nobody can pay for an order that is no longer coming.

= Can I test it before going live? =

Yes. Set Environment to Development and the store runs against Blipply's test system, where orders are marked paid with test money and nothing reaches a real wallet. A store left in Development cannot take a real payment.

= Do I need a separate account for testing? =

Yes, and this catches people out. Development and Production are **separate systems**, not a switch on one account. Your sign-up, your business and your API key exist in only one of them.

So when you finish testing and move to Production you must sign up again at the live Blipply app, create your business there, create a new key, and replace **both** the key and the signing secret in the plugin settings. Nothing carries over, and a test key sent to Production is rejected — if every payment suddenly fails after switching, this is why.

== External services ==

This plugin connects to the Blipply payment API, operated by Blipply, in order to create and track crypto payments. It is required for the plugin to function.

**When data is sent:** when you save your settings, when a customer places an order using Blipply, and periodically while an order is awaiting payment.

**What is sent:**

* On saving settings — your store's web address, so customers can be returned to it after paying, and the address this store should receive payment notifications on.
* When an order is placed — the order total and currency, your order number, the description of the order, and the customer's billing email address so you can identify who paid.
* While an order is awaiting payment — the identifier of that payment only.

Your API key is sent with every request to identify your business.

Service: Blipply — https://blipply.com
Terms of service: https://blipply.com/terms-of-use
Privacy policy: https://blipply.com/privacy-policy

== Screenshots ==

1. The payment option at checkout.
2. Connecting your Blipply account in the plugin settings.
3. The Blipply payment page your customer sees.

== Changelog ==

= 0.1.2 =
* Restored the description of settlement: sales are converted automatically, so you are credited in dollars.

= 0.1.1 =
* Fixed sentences breaking mid-line in the FAQ and installation steps.

= 0.1.0 =
* First release.
