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.
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.
- PHP >= 8.1
- BitPay Account
You can download or clone the project from GitHub.
- Log into https://test.bitpay.com/dashboard
- Go to
- Click on
- Click the
Add New Tokenbutton
- Enter a label (this is just for your reference)
- Click the
- Copy the value of the
Tokenfield from the
See the README in https://github.com/bitpay/php-kiosk-demo-laravel for configuration options.
- Copy the token generated above
.envand configure it
application.yamland configure it
php artisan migrateto run DB migrations (and create sqlite DB if you use this database)
php artisan key:generateto generate an encryption key
Run the following command
php artisan serve
You should now be able to visit a browser at
http://localhost:8000 or the port that you configured.