Machine Card Enrollment

This page is the one cardholder-present step of agent purchasing on audit.domains. The operator enrolls a payment card once; afterwards an authorized agent can buy domain appraisals against that card without the cardholder at the keyboard. The agent is never present at enrollment and never sees the card details.

How enrollment works: the cardholder signs in with the operator account and enters the card once in Square's own fields, in the browser. The browser tokenizes the card and posts only the tokens to /api/machine/card-enroll; a raw card number never reaches audit.domains servers. The card is stored on the operator's Square customer, and only Square's card id, brand and last four digits are kept. The reply carries a card reference beginning acr_, the only handle an agent ever uses.

Enrollment is scoped consent. The defaults are a per-charge cap of $5, a daily cap of $25 and a consent length of 365 days; the cardholder can change all three when enrolling (consent length from 1 to 3650 days). The product is the current appraisal (current_appraisal) at $5 per purchase. A charge also requires a live agent grant naming that product, and charges stop at whichever limit comes first: the grant, these caps, or the consent expiry. The cardholder can revoke the card at any time with the operator revoke_card action, which stops all agent charges against it.

The enrollment form itself needs JavaScript, because the card fields are hosted by Square. The machine-readable terms are the descriptor at /api/machine/resolve, and the enrolled card is managed from the machine account.

Home · Machine account · Developer API · llms.txt