Issuer API
Enables card issuers to manage the operational lifecycle of payment cards. Provides a set of endpoints that allow authorized issuers to perform state-changing operations on ILP-enabled cards.
Overview
Merchant API
The control plane for merchants, operators, and internal systems participating in the Interledger Cards ecosystem. Provides for centralized onboarding and management of merchants, locations, and POS terminals.
Merchant management
Section titled “Merchant management”Merchants are legal entities that accept payments and own locations and terminals. They’re created and maintained with legal identity attributes (for example, legal name vs trade name) and compliance-relevant metadata needed for onboarding and operational workflows.
Location management
Section titled “Location management”A location is a physical store, branch, or any logical site where terminals can be deployed and payment acceptance occurs. Locations are always owned by a merchant and are a structural boundary for terminals.
POS terminal lifecycle management
Section titled “POS terminal lifecycle management”A POS terminal is the device that initiates a card-present payment transaction at a location. Terminals have strict lifecycle states. For example: created => provisioned => active => revoked/decommissioned.
POS terminal onboarding control
Section titled “POS terminal onboarding control”The onboarding flow is executed by the POS terminal to retrieve the onboarding form definition, submit the collected merchant data, and link the terminal to its merchant.
Terminals must securely obtain identity and configuration. The Merchant API coordinates the onboarding workflow but delegates cryptographic authority to the HSM subsystem through the adapter.