🧾

QR Bills API

Create printable QR code dollar bills that credit a kid's account when redeemed. Each bill has a unique code and can only be redeemed once.

POST/api/v1/bills

Create bills

Request Body

{ "kidId": "uuid", "amount": 5.00, "template": "classic-green", "quantity": 4 }

Response

{ "bills": [{ "id": "uuid", "code": "abc123...", "amount": 5.00, "template": "classic-green", "status": "active" }] }

Templates: play-money, gift-card, gold-coin, classic-green, monopoly, rainbow. Max quantity: 50.

GET/api/v1/bills

List your bills

Server paginated. Optional query params: ?page=1&pageSize=25&kidId=uuid&status=active|redeemed|revoked. Page size is capped at 50.

DELETE/api/v1/bills/:id

Revoke a bill (make it unredeemable)

Response

{ "success": true }

GET/api/v1/redeem/:codePublic

Get bill info for redemption

Response

{ "code": "abc123...", "amount": 5.00, "kidName": "Rafi", "kidAvatar": "🐰", "template": "classic-green", "status": "active" }

POST/api/v1/redeem/:codePublic

Redeem a bill (credit the kid)

Response

{ "success": true, "amount": 5.00, "kidName": "Rafi", "newBalance": 261.00 }

Rate limited to 10 attempts per IP per minute. Returns 410 if already redeemed or revoked.