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](https://breez.technology/)

### 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'`

### 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