STEEMPAY.IO v1.0.1 LIVE! Accept Steem/SBD anywhere! Button generator included!

steve-walschot (68)in #steempay • 8 years ago (edited)

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

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

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!)

Some of the proposals by @cass

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.