Issue a gift card (paid = purchase invoice, free = merchant-funded)

POST

/api/v1/gift-cards

Authorization

bearer

Header Parameters

Request Body

application/json

body

balanceSats*number

Initial balance in sats

issueType*string

"paid" = buyer pays a purchase invoice now (card activates on settlement) · "free" = merchant-funded comp card (active immediately)

Default"paid"

Value in"paid""free"

projectId?string

Optional project — paid issuance settles to its settlement wallet

expiresAt?string

Optional expiry (ISO)

note?string

Private note (e.g. who this is for)

Response Body

Example Request

curl -X POST 'http://localhost:3001/api/v1/gift-cards' \
  -H 'Content-Type: application/json' \
  -d '{
  "balanceSats": 21000,
  "issueType": "paid"
}'

Example Request

curl -X POST 'http://localhost:3001/api/v1/gift-cards' \  -H 'Content-Type: application/json' \  -d '{  "balanceSats": 21000,  "issueType": "paid"}'

Example Response201

Empty

Issue a gift card (paid = purchase invoice, free = merchant-funded)

AuthorizationCopy Anchor Link

Header ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Header Parameters

Request Body

Response Body