Digital Receipts

To minimize the integration effort and not force you as an Enricher to adapt to our API, OpenCard instead provides you with the OpenCard prerequisite on which you can build your own API, which we will integrate into OpenCard.

We need you to provide an API that follows the 3 following steps.

1. Request list of merchants

OpenCard will request a list of merchant id:s (called MID, Merchant ID, or CAID, Card Acceptor ID depending on terminology), which will list the merchants that you as receipt provider have integrated in your platform. The merchant id is mandatory information and part of the receipt, therefore available for all merchants.

2. Request receipt for transaction

If OpenCard receives a transaction with a merchant id found in your list, OpenCard will post the transaction to your API. Since OpenCard receives the transaction in several different states, it is required that we can update the transaction when the state changes (i.e. from authorized to cleared). This allows you to find the receipt based on the correct transaction information.

{
  "id": "10",
  "state": "cleared",
  "original_amount": 109.38,
  "original_currency": "SEK",
  "purchase_merchant": "Coop",
  "purchase_date": "2022-09-02",
  "purchase_time": "<nullable>",
  "card_last_four": "1234",
  "merchant_number": "12345678",
  "terminal_id": "12345678",
  "retrieval_reference_number": "123456789012",
  "auth_code": "123456"
}

📘

Support with matching

Do you need Support with matching receipts with the transactions data? OpenCard can support you with our automatic matching algorithm (patented by Open API Int. AB). This documentation will be provided on request so that you can implement it in your API.

3. Receive receipt

Once you have matched the transaction with a digital receipt in your platform, you will need to send it to OpenCard. We provide an API with the required security for you to post the digital receipt. It is required that you can send the digital receipt as both a PDF and as raw data in order for OpenCard to provide necessary digital receipt functionality to partner Expense Management Systems accessing the digital receipts.