This is a demonstration Laravel app to show how BitPay can be used in the
context of a retail kiosk. It utilizes the the pos facade and with a simple
configuration file you can customize the posData fields that are sent to
BitPay. This app uses database migrations to manage the database schema and by default
uses an embedded SQLite database to make it easy to start.

📘
Note
If you'd like to utilize Instant Payment Notifications (IPN), you will need to either run the application somewhere publicly available, or use a tool such as ngrok to allow public traffic to tunnel to your local machine.

Prerequisites

BitPay Account
Docker

Download

You can download or clone the project from GitHub.

Setup

Generate Test Token

Log into https://test.bitpay.com/dashboard
Go to Payment Tools
Click on API Tokens
Click the Add New Token button
Enter a label (this is just for your reference)
Click the Add Token button
Copy the value of the Token field from the Information section

Update Configuration

📘
Note
See the README in https://github.com/bitpay/php-kiosk-demo-laravel for configuration options.

Add php-kiosk-demo-laravel.test to your OS hosts
Copy .env.example to .env and configure it
Copy application-example.yaml to application.yaml and configure it

Run the Application

Run the following command

docker-compose up

View the Application

You should now be able to visit a browser at http://localhost:8000 or the port that you configured.