Gift Cards & Store Credit - PlatformDTC

https://api.platformdtc.com/api/v1/gift_cards   ·   /api/v1/store_credit

Auth: X-Agent-Key: sq_agt_*. Scopes: read_gift_cards, write_gift_cards. The full gift-card code is returned once at issue time; only a hash + last-4 are stored.

Gift cards

POST /gift_cards — issue { "initial_value": 5000, "currency":"USD", "customer_id":"…", "expires_on":"2027-01-01" } → returns the code once
GET /gift_cards · GET /gift_cards/{id} · GET /gift_cards/{id}/transactions
POST /gift_cards/{id}/credit · /debit — { "amount": 1000, "note":"…" } (tx-safe; overdraw → 409)
POST /gift_cards/{id}/deactivate

Store credit (per customer)

GET /store_credit/{customer_id}
POST /store_credit/{customer_id}/credit · /debit — { "amount": 2000, "currency":"USD" }

curl -s -X POST https://api.platformdtc.com/api/v1/gift_cards \
  -H "X-Agent-Key: sq_agt_*" -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"initial_value":5000,"currency":"USD"}'

Emits gift_cards/create|update. All balance amounts are integer cents.