=== SkinPlata for WooCommerce ===
Contributors: skinplata
Tags: payments, skins, cs2, steam, payment gateway
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let customers pay with CS2, Dota 2 and Rust skins. The payment is credited to your SkinPlata balance in USD.

== Description ==

SkinPlata adds "Pay with skins (CS2, Dota 2, Rust)" to your checkout. Customers pick items from their Steam inventory on the SkinPlata checkout, accept one Steam trade, and the payment is credited to your SkinPlata balance in USD.

* Classic checkout and the block checkout.
* Orders complete on their own when SkinPlata confirms the payment with a signed webhook.
* Steam Trade Protection handled: protected payments put the order on hold until they are final.
* Test mode with your test API secret.
* Compatible with High-Performance Order Storage.

You need a SkinPlata account and a project: https://skinplata.com/app/projects

== Installation ==

1. Plugins > Add New > Upload Plugin, choose skinplata-woocommerce.zip, then Activate.
2. WooCommerce > Settings > Payments > SkinPlata.
3. Paste your project key (pk_…), live API secret (sk_live_…), test API secret (sk_test_…) and webhook signing secret (whsec_…). You find them on your project at https://skinplata.com/app/projects.
4. Required: copy the webhook URL shown in the settings (it looks like https://your-store.example/?wc-api=skinplata) into your project at https://skinplata.com/app/projects > Webhook URL, and save. SkinPlata sends webhooks only to that address; without it orders are never marked paid.
5. Press "Send test.ping" on the project page to check that your store answers.
6. Enable the method, turn on Test mode and place a small test order.

API reference: https://skinplata.com/developers

== Frequently Asked Questions ==

= Which currencies work? =

USD, EUR, GBP, CAD, AUD, NZD, BRL, CNY, MXN, RUB, UAH, KZT, ARS, CLP, PEN and COP. The method hides itself in other store currencies. Your SkinPlata balance is always in USD.

= When is an order marked as paid? =

When SkinPlata confirms the payment: the plugin checks the webhook signature and reads the payment again from the SkinPlata API before it changes the order. A customer's browser can never mark an order as paid.

= What is "on hold" for? =

Steam can hold traded items for up to 7 days (Trade Protection) and return them to the customer in that window. Those orders stay on hold and complete on their own when the hold ends. You can release a payment early in your SkinPlata dashboard.

= How does test mode work? =

Turn on Test mode and paste your test API secret (sk_test_…). The checkout shows test buttons instead of a real Steam trade; no items or money move. Order notes are marked [Test]. Live and test webhooks use the same signing secret.

= Orders stay "Pending payment". =

Check that the webhook URL is saved on your SkinPlata project and that your store is reachable over https. The Webhooks page of your SkinPlata dashboard shows every delivery and your store's answer.

= Where are the logs? =

Turn on Debug log, then WooCommerce > Status > Logs, source "skinplata". Secrets are never logged.

== External services ==

This plugin connects to SkinPlata (operated by SKINPLATA Limited) to take payments:

* skinplata.com/api — to create and read payments when a customer checks out with skins, and to list supported currencies. The order number, order total, currency and your store's return addresses are sent.
* skinplata.com/pay — the checkout page your customers are sent to.

Terms: https://skinplata.com/legal/terms · Privacy: https://skinplata.com/legal/privacy

== Changelog ==

= 1.0.0 =
* First release.
