DNotes Pay custom cart and checkout integration
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md Update README.md Sep 20, 2018
button.php
dnotes.sql
dnotes_ajax.php
dnotes_cron.php Update dnotes_cron.php Sep 14, 2018
dnotes_payment.php Update dnotes_payment.php Sep 14, 2018
dnotespay.css
header.png
left.png Add files via upload Aug 11, 2018

README.md

Dnotes Pay

DNotes Pay custom cart and checkout integration

Installation

Database

Import the dnotes.sql file into your site/store database from shell or with phpMyAdmin

Upload Files

Upload the following files to your site/store directory:

  • button.php
  • dnotes_ajax.php
  • dnotes_cron.php
  • dnotes_payment.php
  • dnotespay.css
  • header.png
  • left.png

Integration

Integration is completely dependent on the specific site's setup, the following is a general guideline.

Open button.php and update the configuration settings at the top.

  • $amount and $order_num should be dynamic and get their values from your store for the current order.
  • $confirmation_url should point to your Success or Thank You store page. Or to a store page for any further processing before showing the user the Success/ThankYou page.

Method 1

Include button.php into your checkout page's PHP code: require_once("button.php");

Method 2

Copy the coding - including the configuration values - and place in parts into your checkout page where needed. The button calls the Javascript function PaymentpageShow() when clicked to submit the form, creating the new window for DNotes payment. You can add additional functionality here as needed:

  • Submit a separate, main form to a hidden iFrame
  • Perform actions via AJAX (such as validating checkout data, submitting and saving cart/order info, etc)

Cron

A cronjob is neccessary to check the blockchain against the payment transaction to update the status to completed once NOTE is sent and confirmed (to $confirm_num confirmations before valid).

  • Edit dnotes_cron.php and update with your database connection information.
  • Add your own code where commented to update your site/store order once complete. The cron will set the state field equal to complete only in the dnotes transactions table created above. You should then update your own table(s) when confirmed to mark an order complete. Ex:
    if ($confirmed){ $result = $conn->query("update myOrderTable set status='1' where ordersId='" . $row['order_num'] . "'"); }
  • Create a cronjob (from shell, or often from hosting's cPanel or similar domain management) to run dnotes_cron.php on a regular basis. Ex:
    */15 * * * * php /path/to/my/store/dnotes_cron.php
    Note: If you need help finding path to dnotes_cron.php, edit the file and add print __FILE__; near the top. Open http://my.website/dnotes_cron.php to see full path the script (then remember to delete that line :) )