How you get paid

Customer pays with a DollaCard
  └─▶ We collect the full amount
  └─▶ DollaCard takes its 3% fee
  └─▶ We pay YOU the remaining 97% of net

Your money lands in your DemocracyCraft firm account. Use POST /api/vendor/payouts to move your net earnings whenever you like.

Payouts

POST https://DollaCard.chickenkiller.com/api/vendor/payouts
Authorization: Bearer YOUR_API_KEY

{ "amount": "100.00" }
// → moves net earnings from your DollaCard balance to your firm

GET https://DollaCard.chickenkiller.com/api/vendor/payouts
Authorization: Bearer YOUR_API_KEY
// → list your payout history

Account

Your API key is secret. Keep it server-side only — never paste it into your public website code.

Accept payments on your site (Dynamic Cart Checkout)

Pass your store cart's total amount to the DollaCard API. We charge the card, transfer the funds (bank pays full amount → we take 3% → we send you 97%), and confirm payment to your site.

Full API Reference

CHARGE A CARD
POST https://DollaCard.chickenkiller.com/api/vendor/charges
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "card_number": "1234567890",
  "amount": "25.00",
  "description": "Purchase"
}
→ { "charge_id": "ch_...", "amount": 25, "fee": 0.75,
    "net_amount": 24.25, "status": "succeeded" }

LIST CHARGES
GET https://DollaCard.chickenkiller.com/api/vendor/charges?page=1&limit=20
Authorization: Bearer YOUR_API_KEY

REQUEST PAYOUT
POST https://DollaCard.chickenkiller.com/api/vendor/payouts
Authorization: Bearer YOUR_API_KEY
{ "amount": "100.00" }

LIST PAYOUTS
GET https://DollaCard.chickenkiller.com/api/vendor/payouts
Authorization: Bearer YOUR_API_KEY

SET WEBHOOK
POST https://DollaCard.chickenkiller.com/api/vendor/webhook
Authorization: Bearer YOUR_API_KEY
{ "webhook_url": "https://yoursite.com/dollacard/hook" }

Help

• What does it cost? 3% per transaction, taken from the amount before payout.
• How do I get my money? It goes to your firm; request payouts anytime.
• What card numbers do customers use? The 10-digit number DollaCard creates for them.
• Do I need to store card numbers? No — you only ever see masked ones after the first charge.

Manage your cards

Account

Keep your API key server-side only. Use it to issue cards from your own backend.

Add a "Cards" tab to your bank site

Embed this ready-made widget. Your customers type their in-game name and get their card instantly.

Preview the widget ↗

AI prompt for your devs

Hand this to an AI to wire the widget's proxy on your server.

How payments work

Customer uses your card at a vendor
  └─▶ The charge happens — we handle the transfer
  └─▶ The cardholder repays YOU (your normal credit)
  └─▶ DollaCard takes its 3% fee, pays the vendor 97%

You are the bank — you do the credit. DollaCard just processes each charge. Your customers settle with you out of band, however you run credit.

Balance

Check your firm's Treasury balance:

GET https://DollaCard.chickenkiller.com/api/bank/balance
Authorization: Bearer YOUR_API_KEY

Full API Reference

ISSUE A CARD
POST https://DollaCard.chickenkiller.com/api/bank/cards/issue
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{ "cardholder_name": "Steve", "treasury_player_uuid": "optional-uuid" }
→ { "id": 1, "card_number": "1234567890", "cvv": "123", "active": true }

LIST YOUR CARDS
GET https://DollaCard.chickenkiller.com/api/bank/cards
Authorization: Bearer YOUR_API_KEY

DEACTIVATE A CARD
DELETE https://DollaCard.chickenkiller.com/api/bank/cards/:id
Authorization: Bearer YOUR_API_KEY

BALANCE
GET https://DollaCard.chickenkiller.com/api/bank/balance
Authorization: Bearer YOUR_API_KEY

SET WEBHOOK (optional)
POST https://DollaCard.chickenkiller.com/api/bank/webhook
Authorization: Bearer YOUR_API_KEY
{ "webhook_url": "https://yourbank.com/dollacard/hook" }

Help

• How do I make money? You decide rates/interest for your cardholders — we just take our 3% on each spend.
• Who handles the money moving out? DollaCard processes the Treasury transfers automatically.
• Can customers pay anywhere? Yes — any vendor that accepts DollaCard.
• Webhooks? Optional; we can POST charge.succeeded events to your URL.