# Aktualizacja danych instrumentu płatniczego dla tokenizacji

Metoda pozwala uzupełnić dane instrumentu płatniczego, jeżeli nie zostaly podane wczesniej. Dozwolone jest przesłanie sekcji instrument i device.

Endpoint: PUT /v1/ecommerce/tokenizer/{tokenizerId}/instrument
Version: 2.1.15
Security: bearerAuth

## Path parameters:

  - `tokenizerId` (string, required)
    Identyfikator systemowy tokenu (służy m.in. do pobrania tokenu)

## Request fields (application/jose):

  - `type` (string, required)
    Typ instrumentu płatniczego
    Enum: "COF", "CARD", "BLIK", "BLIK_CODE", "BLIK_UID", "BLIK_PAYID", "GPAY", "APAY", "PBL", "SCOF", "VTS", "C2P_MC_UNIFIED", "C2P_VISA_UNIFIED", "EXT_COF"

  - `instrumentNo` (string,null)
    Nr instrumentu płatniczego (np. tokenu lub karty) (wymagany dla type = CARD/COF)

  - `encInstrumentNo` (string,null)
    Zaszyfrowany nr instrumentu płatniczego

  - `instrumentRef` (string,null)
    Identyfikator instrumentu płatnicznego w zewnętrznym systemie (wymagany dla type = SCOF/VTS)

  - `token` (string,null)
    Dane tokenu zwracane przez API APAY/GPAY (base64 encoded) (wymagany dla type = APAY/GPAY)

  - `expDate` (string,null)
    Data ważności (Format: YYYYMM) (wymagany dla type = CARD)
    Example: "202101"

  - `encExpDate` (string,null)
    Zaszyfrowana data ważności

  - `cvv` (string,null)
    Kod zabezpieczający (wymagany dla type = CARD)

  - `encCvv` (string,null)
    Zaszyfrowany kod zabezpieczający

  - `code` (string,null)
    Jednorazowy kod płatności BLIK (wymagany dla type = BLIK_CODE)

  - `alias` (string,null)
    Alias użytkownika BLIK dla płatności OneClick lub cyklicznych (wymagany dla type = BLIK_UID/BLIK_PAYID)

  - `app` (string,null)
    Identyfikator konta mobilnego BLIK (w przypadku niejednoznaczności aliasu)

  - `provider` (string,null)
    Identyfikator pośrednika płatności (może być wybrany automatycznie na podstawie konfiguracji merchanta)
    Enum: "BM", "PA", "PU"

  - `bank` (string,null)
    Nazwa banku (wymagany dla type = PBL)

  - `bankId` (integer,null)
    Identyfikator banku (w systemie operatora PBL) (wymagany dla type = PBL)

  - `payload` (string,null)
    Payload otrzymany z SDK na potrzeby płatności Click2Pay

  - `cardMask` (string,null)
    Maska karty otrzymana z PayU na potrzeby płatności tokenem kartowym

## Response 200 fields (*/*):

  - `tokenizerId` (string)
    Identyfikator systemowy tokenu (służy m.in. do pobrania tokenu)

  - `status` (string)
    Status tokenizacji

  - `dataRequest` (string)
    Zadanie dodatkowych danych
    Enum: "INSTRUMENT", "CARD_CVV", "CARD_3DS", "CARD_OTP", "CAPTURE", "BLIK_APP", "DEVICE", "CUSTOMER", "EMAIL", "BLIK_CODE"

  - `acsData` (object)
    Dane potrzebne do wykonania ACS challenge

  - `acsData.tdsServerTxnId` (string)
    Identyfikator transakcji z systemu 3DS Server

  - `acsData.acsTxnId` (string)
    Identyfikator transakcji z systemu ACS (z komunikatu ARes)

  - `acsData.acsRefNumber` (string)
    Numer referencyjny transakcji z systemu ACS (z komunikatu ARes)

  - `acsData.acsSignedContent` (string)
    Blok zawierający sygnaturę ACS służący do weryfikacji ACS przez SDK

  - `acsData.acsURL` (string)
    Adres URL serwera ACS (do obsługi flow webowego)

  - `acsData.challengeWindowSize` (string)
    Rozmiar okna ACS challenge
    Example: "05"

  - `acsData.messageType` (string)
    Typ komunikatu (CReq)
    Example: "ARes"

  - `acsData.messageVersion` (string)
    Wersja protokołu

  - `acsData.creqPayload` (string)
    Formularz z danymi do wykonania ACS challenge (do obsługi flow webowego)

  - `acsData.acsStartProtocol` (string)
    Najstarsza wersja protokołu wspierana przez ACS

  - `acsData.acsEndProtocol` (string)
    Najnowsza wersja protokołu wspierana przez ACS

  - `acsData.dsStartProtocol` (string)
    Najstarsza wersja protokołu wspierana przez DS

  - `acsData.dsEndProtocol` (string)
    Najnowsza wersja protokołu wspierana przez DS

  - `redirectURL` (string)
    Adres URL dla kontunuacji flow webowego

  - `rejectCode` (string)
    Powód odrzucenia (w przypadku niepowodzenia)

  - `rejectInfo` (string)
    Dodatkowe informacje o powodzie odrzucenia


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 500 fields