# Tokenizacja

Dostępna jest tokenizacja kart klienta w oparciu o wewnętrzne mechanizmy bramki ecommmerce (COF) lub tokenizacja w oparciu o usługi organizacji płatniczej Visa VTS/Mastercard SCOF (NETWORK). Proces może być kilkuetapowy, w związku z czym cały flow tokenizacji spina identyfikator o nazwie tokenizerId. Do operacji na tokenie (usunięcie/modyfikacja) należy wykorzystywać identyfikator tokenu (nie tokenizacji).

## Aktualizacja danych instrumentu płatniczego dla tokenizacji

 - [PUT /v1/ecommerce/tokenizer/{tokenizerId}/instrument](https://planetayapi.redocly.app/api/tokenizacja/filltokeninstrument.md): Metoda pozwala uzupełnić dane instrumentu płatniczego, jeżeli nie zostaly podane wczesniej. Dozwolone jest przesłanie sekcji instrument i device.

## Aktualizacja atrybutu instrumentu płatniczego

 - [PATCH /v1/ecommerce/tokenizer/{tokenizerId}/instrument](https://planetayapi.redocly.app/api/tokenizacja/filltokeninstrumentcvv.md): Tą metodę można wykorzystać gdy wymagane jest dosłanie pojedynczego atrybutu instrumentu (np. kod CVV)

## Tokenizacja kart klienta

 - [POST /v1/ecommerce/tokenizer](https://planetayapi.redocly.app/api/tokenizacja/createtoken.md): Dostępna jest tokenizacja kart klienta w oparciu o wewnętrzne mechanizmy bramki ecommmerce (COF) lub tokenizacja w oparciu o usługi organizacji płatniczej Visa VTS/Mastercard SCOF (NETWORK). Proces może być kilkuetapowy, w związku z czym cały flow tokenizacji spina identyfikator o nazwie tokenizerId.

## Unieważnienie tokenu

 - [POST /v1/ecommerce/tokenizer/{tokenizerId}/discard](https://planetayapi.redocly.app/api/tokenizacja/discardtokenbytokenizerid.md): Usunięcie tokenu z systemu operatora płatności. Wariant z wykorzystaniem identyfikatora procesu tokenizacji

## Anulowanie tokenizacji

 - [POST /v1/ecommerce/tokenizer/{tokenizerId}/cancel](https://planetayapi.redocly.app/api/tokenizacja/tokenizationcancel.md): Proces tokenizacji możne zostać przerwany przez klienta. Tokenizacja otrzymuje status CANCELLED.

## Wyszukanie tokenu

 - [POST /v1/ecommerce/tokenizer/search](https://planetayapi.redocly.app/api/tokenizacja/searchtokenbyvalue.md): Wyszukiwanie tokenów kartowych po numerze. Wyszukiwanie odbywa się w kontekście merchanta.

## Unieważnienie tokenu

 - [POST /v1/ecommerce/tokenizer/discard](https://planetayapi.redocly.app/api/tokenizacja/discardtokenbyvalue.md): Usunięcie tokenu z systemu operatora płatności. Wariant wykorzystujący numer tokenu kartowego.

## Konwersja tokenu COF na NETWORK

 - [POST /v1/ecommerce/tokenizer/convert](https://planetayapi.redocly.app/api/tokenizacja/converttoken.md): Tokeny z wewnętrznej tokenizacji COF można zmigrować na tokeny NETWORK. Metoda nie usuwa danych oryginalnego tokenu.

## Określenie organizacji płatniczej i wersji protokołu (dla flow mobilnego).

 - [POST /v1/ecommerce/tokenizer/binInfo](https://planetayapi.redocly.app/api/tokenizacja/gettokenizerbininfo.md): Dodatkowy krok dla flow mobilnego do określenia organizacji płatniczej i używanej wersji protokołu. Wersja protokołu uStałana jest jako najwyższa możliwa z zakresów obsługiwanych przez komponenty: SDK, ACS, 3DS i DS.

## Pobieranie tokenu kartowego

 - [GET /v1/ecommerce/tokenizer/{tokenizerId}](https://planetayapi.redocly.app/api/tokenizacja/gettoken.md): Pobranie danych tokenu na podstawie identyfikatora procesu tokenizacji. Merchant powinien zapisać nr tokenu i posługiwać się nim w dalszej komunikacji z API.

## Aktualizacja danych instrumentu płatniczego i urządzenia

 - [PATCH /v1/ecommerce/tokenizer/{tokenizerId}](https://planetayapi.redocly.app/api/tokenizacja/filltokeninstrumentanddevice.md): Podobna metoda wykorzystywana jest przez paywall API, ale pozwala rownież na przesłanie danych urządzenia z którego klient realizuje płatność. Dozwolone jest przesłanie sekcji instrument i device.

## Sprawdzenie statusu tokenizacji

 - [GET /v1/ecommerce/tokenizer/{tokenizerId}/status](https://planetayapi.redocly.app/api/tokenizacja/gettokenizationstatus.md): Sprawdzenie statusu tokenizacji bez zwracania ciała tokenu kartowego.

## Pobranie informacji o wizerunku karty

 - [GET /v1/ecommerce/tokenizer/vts/{instrumentRef}/cardVisual/{visualId}](https://planetayapi.redocly.app/api/tokenizacja/vtsvisualcardart.md): Metoda pozwalająca pobrać dane wizerunku karty w przypadku tokenów VTS.