---
title: "TEO Know-Your-Customer"
url: "https://developer.migros.ch/apis/teo-know-your-customer-0/versions/b0a27734-b39e-404b-9776-1e030548f01b"
---

# TEO Know-Your-Customer

OpenAPI specification document.

```json
{"info":{"contact":{"email":"arg_mgb-udp-business-services@mgb.ch","name":"MGB-UDP-Business-Services"},"description":"The TEO KYC project is used to control (allow/disallow) access for potential customers.\nIt receives access requests, meaning someone it at the main entrance at a physical store.\nBased on TBD business logic we can determine whether the access will be granted or not.\nAs this project also has access to the door control for the respective stores it can then\nalso open the main door or display a suitable disallow message.\n","title":"TEO Know-Your-Customer","version":"0.9.0"},"openapi":"3.0.1","paths":{"/migros/customer/teo/v1/auth/eft":{"post":{"description":"This is one of the starting points for requesting access to a store","requestBody":{"content":{"application/json":{"schema":{"properties":{"cardBrandName":{"description":"What type of card is it","example":"Visa","type":"string"},"cardCountryCode":{"description":"country code of where the card was issued","example":"CH","type":"string"},"cardNumberEnc":{"description":"Encoded card number to have a more unique footprint","example":"AABBCCDDEEFFGHH","type":"string"},"cardNumberPrintable":{"description":"Partly anonymized credit card number","example":"123456xxxx4321","type":"string"},"cardTenderName":{"description":"Additional card type info","example":"Visa contactless","type":"string"},"doorId":{"description":"There can be multiple doors at a location. Usually at 1 meaning main entrance","example":"1","type":"string"},"storeId":{"description":"From which store is the access requested","example":"A16BCZ","type":"string"},"trackingId":{"description":"UUID to identify requests","example":"04a2bebf-42c7-46b3-afb3-7ec0a4866703","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Successful request"},"400":{"content":{"application/json":{"schema":{"properties":{"field":{"example":"doorId","type":"string"},"message":{"example":"The provided field is not valid","type":"string"}},"type":"object"}}},"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"properties":{"field":{"example":"storeID","type":"string"},"message":{"example":"Entity not found","type":"string"}},"type":"object"}}},"description":"Not Found"},"500":{"description":"Internal Server Error"}},"summary":"Potential customer requests access to store via ECR Valina terminal","tags":["teo"]}},"/migros/customer/teo/v1/auth/qr":{"post":{"description":"This is one of the starting points for requesting access to a store","requestBody":{"content":{"application/json":{"schema":{"properties":{"doorId":{"description":"There can be multiple doors at a location. Usually at 1 meaning main entrance","example":"1","type":"string"},"qrValue":{"description":"Scanned QR code from Migros App","example":"9201A11/XX9aWgESA3RzaB9fa1YAUwtlHRkCXHNkdVceZg==","type":"string"},"storeId":{"description":"From which store is the access requested","example":"A16BCZ","type":"string"},"trackingId":{"description":"UUID to identify requests coming from ES Security","example":"04a2bebf-42c7-46b3-afb3-7ec0a4866703","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Successful request"},"400":{"content":{"application/json":{"schema":{"properties":{"field":{"example":"doorId","type":"string"},"message":{"example":"The provided field is not valid","type":"string"}},"type":"object"}}},"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"properties":{"field":{"example":"storeID","type":"string"},"message":{"example":"Entity not found","type":"string"}},"type":"object"}}},"description":"Not Found"},"500":{"description":"Internal Server Error"}},"summary":"Potential customer requests access to store via scanning of QR code of M-APP","tags":["teo"]}}},"servers":[{"description":"URL of upstream service","url":"https://smart-entry.service.migros.cloud"}],"x-company":"migros","x-headmatter":{"readable_by":"*"},"x-kong-route-defaults":{"strip_path":false},"x-leanix-id":"ac6ffeb9-6d21-45f2-a81f-821ce89566d8","x-link-get-access":"https://forms.office.com/e/zhzbEqAQ26","x-link-get-support":"mailto:9961fcb6.migros.onmicrosoft.com@ch.teams.ms"}
```