# Our beta is now live! Start accepting STEEM anywhere you want!

After countless hours of not sleeping to focus on Steempay, together with @cass who made an amazing UI for Steempay, we're finally able to launch our beta version.

Some parts may still be raw and not yet 100% completed, but the functionality is!

# http://steempay.io

https://sc-cdn.scaleengine.net/i/1deff02237d662af32a8948289ffeff6.png

Todo list within the next 48h

 - Add more buttons to the generator
 - Publish the Github to public
 - Start creating the shopping cart plugins (WOO first)


----------
# What's next?

Steempay is just the beginning of many projets to follow. There are still some legal aspects to cover, but Steempayments (Steempay's umbrella group) will most likely start processing transactions on it's own servers. This would make it possible for simple, clean merchant solutions like **BitPay** provides, mobile wallet solutions like **Blockchain** to increase the usability of steem worldwide, and many more.

----- 

# Raw documentation until Github is public

# Donation vs payment

When choosing to receive **donations**, the user is free to send any amount of any currency. To set the donation option, simple use `amount=0` in your parameters. Set currency to either `SBD` or `STEEM` since it's irrelevant for the end user. The user will receive a message to send any amount to your address.

For fixed amounts, called **payments**, set the `amount` and `currency` to the values required for you. 

**WARNING: Make sure to use 3 decimals!** (AMOUNT.000) when generating a payment. This has multiple reasons, including future expantion of Steempay.io.

# Button generator

https://sc-cdn.scaleengine.net/i/15a4c07dacbb7652d27f04c9d8e71a58.png

See https://steempay.io/generate 
Currently there is only 1 default button available but that will change in the next couple of hours.

The generated button looks like this (this actually works!)
<a href='https://steempay.io/payment?&receiver=steve-walschot&amount=0&currency=0&callback=www.steemit.com'>
<img src='https://steempay.io/img/steempay-sbd--button@2x.png'>
</a>


Some of the proposals by @cass

https://img1.steemit.com/0x0/https://www.steemimg.com/images/2016/08/06/60c7b81e93d59950ebe4e27aff1a823d.png
# Requesting a new payment

A new payment is created by passing URL or DATA parameters to steempay.io. This means you could send raw HTTP requests, or stay on your own website and send the data via AJAX calls or JSON request.

Following parameters are **required**:

 - receiver 
 - amount 
 - currency

Following parameters are **optional** ***but recommended***

 - callback

## ! IMPORTANT !
Amount : **Make sure to use 3 decimals!** (AMOUNT.000) This has multiple reasons, including future expantion of Steempay.io

Callback: Get's called on success. You can use this to post a success message or handle data on your server/website if needed.

# Handle callbacks

Set the `callback` parameter with your desired url. Always use `http://` to start your url.

If a callback URL has been provided, steempay will `post`  the unique paymentID to your URL.  A simple php script can catch the the callback and verify the payment a last time (recommended). 

example.php
```
<?php
if (isset($_GET['payid'])) {
	// Payment is success, confirm once again
	
	$url = "http://steempay.io/payment/verify?payid=" . $_GET['success'] . "& receiver=YOUR_USERNAME&amount=1.000&currency=SBD";
	
	$json = file_get_contents($url);
	if (json_decode($json->status) && json_decode($json->success) == "success") 
	{
		// Payment is double verified, do whatever needed now.
	}
}else{
	// Some error occured
    echo $_GET['message'];
}
```

Verification is possible via `http://steempay.io/payment/verify?payid=XXX&receiver=XXX&amount=XXX&currency=XXX`.

The returned main parameters are

 - **success** *boolean*
 - **message** *Message about the success status*
 - **payid** *unique serverside generated ID*

The full response is given below (if success)

    {"status":"success","success":true,"message":"Payment completed with fixed amount (0.001 SBD).","block":4306279,"trx_id":"58c415fe70fe7d953e30997b78551415c7e4d190","payid":"Re3Hbl1ekAeSwVtzKS","amount":"0.001 SBD","timestamp":"2016-08-22T14:55:15"}


----
### Beta version - What this means


> Alpha version describes a development status that usually means the first complete version of a program or application, which is most likely unstable, but is useful to show what the product will do to, usually, a selected group—and is also called preview version; the beta version is usually the last version before wide release, often tested by users under real-world conditions.

Bugs could still occur, but all payments are made directly to the blockchain, so transactions are always safe from errors.

# Thank you community

I would like to pay my eternal respect to this community, and give a big applause to @cass for the amazing UI and the time he put in this project, and also @roelandp for giving me good advice on how to lower the server's load.

https://sc-cdn.scaleengine.net/i/ddc698fcd6c7c0f1c232ce3dfba514bf1.png

https://sc-cdn.scaleengine.net/i/6f1b07d917dcfa939592d2406f3cbbb3.png