> ## Documentation Index
> Fetch the complete documentation index at: https://next-developers.opencard.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Digital Receipts API Overview

> Reference for receipts.opencard.io — card issuers discover publishers and submit card transactions for digital receipt matching across OpenCard merchants.

Payment providers and card issuers use this API to **request digital receipt matching** from OpenCard's merchant network.

<Warning>
  This API is for **card issuers** only. If you collect receipts and deliver them to OpenCard → see [Receipt Providers](/receipt-providers).
</Warning>

## Base URL

```
https://receipts.opencard.io
```

## How it works

```mermaid theme={null}
sequenceDiagram
    participant Issuer as Card Issuer
    participant R as receipts.opencard.io
    participant M as Merchant Network

    Issuer->>R: GET /publishers (which merchants?)
    Issuer->>R: POST /callbackrequests (transaction data)
    R->>M: Match receipt
    R->>Issuer: Callback to your URL with receipt
```

## Auth

Bearer JWT. Contact **[support@opencard.io](mailto:support@opencard.io)** for credentials.

## Key endpoints

| Method   | Path                                   | Purpose                              |
| -------- | -------------------------------------- | ------------------------------------ |
| `GET`    | `/api/v1/marcet/publishers`            | List merchants with digital receipts |
| `POST`   | `/api/v1/marcet/callbackrequests`      | Submit transaction for matching      |
| `PUT`    | `/api/v1/marcet/callbackrequests/{id}` | Update (e.g. mark cleared)           |
| `DELETE` | `/api/v1/marcet/callbackrequests/{id}` | Cancel request                       |

Full guide → [Integration guide](/card-issuers/digital-receipts/integration)