Malaleem API
POST /api/v1/payments/card-charge

Charge a Malaleem card

Merchant side of a Malaleem NFC or RFID card: the card's owner pays the caller. A charge at or below the card's per-tap limit goes through on the tap. Above it, or on a card with no limit, the owner's payment PIN is needed: without one the call answers `pin_required`, and a wrong one answers `wrong_pin` (repeated failures lock the PIN). A frozen card answers `card_frozen`. Merchant, staff, agency and healthcare accounts only.

Parameters

uid string · required

The card's UID as read by your reader.

amount integer · required

Amount in minor units.

currency string

Defaults to USD.

pin string

The card owner's payment PIN, typed by them, when the amount is over the card's limit.

curl https://malaleem.com/api/v1/payments/card-charge \
  -H "Authorization: Bearer {token}" \
  -d uid=04A1B2C3 -d amount=1200