Board an ATM on its custody unit for independent review

POST/cards/atm/terminals

Verified ATM operations staff with cards:atm:read on reads and cards:atm:write plus authentication within five minutes on writes; an independent reviewer holding cards:atm:approve decides configurations, exception resolutions and network settlements. Device messages require svc_atmdevice with cards:atm:device; network messages require svc_atmnetwork with cards:atm:network; replenishment updates admit the carrier's cards:atm:replenishment identity. The general cards:read and cards:write scopes do not open the switch. CADP1 is a bank-defined NDC-style cycle, not NCR NDC. The network link is a bank-defined ISO 8583:1987 subset, not a certified Pulse or STAR interface. Software PIN work is refused in production. Surcharges on cards other banks issued are disclosed on screen (12 CFR 1005.16). Cash posts to the terminal's ATM custody unit on GL 1020. See services/cards/atm/README.md.

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

addressobjectRequired

Address of a terminal: the location Regulation E receipts print (12 CFR 1005.9(a)(5)).

5 child attributes

citystringRequired

countrystringRequired

line1stringRequired

postal_codestringRequired

statestringRequired

cash_unit_idstringRequired

The accounts ATM custody unit on GL 1020

cassettesarray of objectsRequired

3 child attributes

capacity_notesintegerRequired

What a replenishment fills the cassette to

denomination_amountintegerRequired

positionintegerRequired

evidencestringRequired

low_cash_threshold_amountintegerRequired

Estimated cassette cash below this requests replenishment

max_notesintegerRequired

max_withdrawal_amountintegerRequired

namestringRequired

operationsarray of stringsRequired

surcharge_amountintegerRequired

Disclosed on screen to cards other banks issued (12 CFR 1005.16)

terminal_idstringRequired

8 characters, the network card acceptor terminal identification

Returns

200 OK

The ATM object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503