boltcard/docs/CARD_ANDROID.md

Steps for making a bolt card with the Android app

Introduction

Here we describe how to create your own bolt cards with the Bolt Card service and the Bolt Card Android app.

Resources

• some NXP DNA 424 NTAG cards
• an Android device with NFC
• a Bolt Card service
• the Bolt Card app
• the Bolt Card app usage document

Steps

Install the app

• install the app from
  • source
  • apk
  • Google Play Store Boltcard NFC Card Creator

Write the key values to the card

on the bolt card server

• ensure the environment variables for the database connection are set up (see boltcard.service)
  this can be achieved by writing these lines to the end of the ~/.bashrc file

echo "writing database_login to env vars"

export DB_HOST=localhost
export DB_PORT=5432
export DB_USER=cardapp
export DB_PASSWORD=database_password
export DB_NAME=card_db

echo "writing host_domain to env vars"

export HOST_DOMAIN=card.yourdomain.com

• use the internal API to create a card
• $ curl 'localhost:9001/createboltcard?card_name=card_5&enable=true&tx_max=1000&day_max=10000&uid_privacy=true&allow_neg_bal=true'
• this will give you a one-time link

on the app

• click scan QR code
• scan the QR code
• the app will prompt you to hold the card for programming
• the app will test the card and show you the results

Make a payment

• monitor the bolt card service logs
• $ journalctl -u boltcard.service -f
• use a PoS setup to read the bolt card, e.g. Breez wallet

Update the card settings

• use the internal API to update settings for a card
• $ curl 'localhost:9001/updateboltcard?card_name=card_5&enable=true&tx_max=100&day_max=1000'

Wipe a card

• use the internal API to wipe a card
• $ curl 'localhost:9001/wipeboltcard?card_name=card_5'
• this will mark the card as wiped and return the keys for the app to wipe the card