Issuer API Overview

Card issuers use this API to register cards and deliver transaction states to OpenCard. Connected EMS apps receive the data via webhooks.

This is not receipts.opencard.io. For digital receipt matching only → Digital Receipts API.

Base URLs

Environment	URL
Sandbox	`https://sandbox-api.opencard.io`
Production	`https://api.opencard.io`

/api/v1/issuers/{slug}/

{slug} is assigned at integration start (e.g. your program identifier in the URL).

OAuth 2.0 client credentials → POST /oauth/token → Authentication

Method	Path	Description
`POST`	`/api/v1/issuers/{slug}/cards`	Create card
`DELETE`	`/api/v1/issuers/{slug}/cards/{cardId}`	Delete card
`PUT`	`/api/v1/issuers/{slug}/cards/{cardId}`	Update card (boilerplate)
`GET`	`/api/v1/issuers/{slug}/cards/{cardId}`	Get card (boilerplate)
`GET`	`/api/v1/issuers/{slug}/cards`	List cards (boilerplate)
`POST`	`/api/v1/issuers/{slug}/cards/{cardId}/transaction_states`	Create transaction state

Not every {slug} enables all card methods — see Cards guide.

Guide	Topic
How it works	Flow and prerequisites
Onboarding	TPA and go-live
Cards	Card registry
Transaction states	Lifecycle events
TPA delivery	Signed / terminated TPA callbacks

Contact support@opencard.io for client_id, client_secret, scopes, and {slug}.