# Aktualizacja danych instrumentu płatniczego

Metoda pozwala uzupełnić dane instrumentu płatniczego lub urządzenia bazując na wygenerowanym wcześniej paymentId. Umożliwia rozbicie flow płatności na kilka etapów (np. rejestracja płatności przez merchanta, uzupełnienie danych instrumentu płatniczego, uzupełnienie danych urządzenia).

Endpoint: PUT /v1/ecommerce/payment/{paymentId}/instrument
Version: 2.1.15
Security: bearerAuth

## Path parameters:

  - `paymentId` (string, required)
    Identyfikator płatności w systemie operatora płatności

## 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 (application/jose;charset=UTF-8):

  - `paymentId` (string)
    Identyfikator płatności w systemie operatora płatności

  - `subpayments` (array)
    Lista subtransakcji przy płatnościach z MARKETPLACE

  - `subpayments.subpaymentId` (string)
    Identyfikator subtransakcji

  - `subpayments.merchantId` (string)
    Identyfikator merchanta

  - `subpayments.extOrderId` (string)
    Identyfikator zamówienia w systemie merchanta

  - `status` (string)
    Aktualny status płatności

  - `dataRequest` (string)
    Zadanie dodatkowych danych

  - `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 kontynuacji flow webowego

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

  - `rejectInfo` (string)
    Dodatkowe informacje o powodzie odrzucenia Płatności

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

  - `blikObject` (object)
    Struktura zapytania BLIK

  - `blikObject.Type` (string)

  - `blikObject.MerchantID` (string)

  - `blikObject.Currency` (string)

  - `blikObject.Amount` (string)

  - `blikObject.CustomParam` (string)

  - `blikObject.Description` (string)

  - `blikObject.Timestamp` (string)

  - `blikObject.MCC` (string)

  - `blikObject.Code` (string)

  - `blikObject.TxID` (string)

  - `blikObject.ControlData` (string)

  - `blikObject.Buid` (string)

  - `options` (object)
    Inne parametry sterujace

  - `options.tokenize` (boolean)
    Zadanie tokenizacji karty

  - `options.recurring` (string)
    Flaga płatności cyklicznych

  - `options.transKind` (string)
    Rodzaj transakcji dla transakcji kartowych

  - `options.methods` (array,null)
    Dostępne metody płatności
    Enum: "CARD", "PBL", "BLIK", "GPAY", "APAY", "UNKNOWN", "C2P"

  - `options.registerAlias` (boolean,null)
    Rejestracja aliasu na potrzeby transparentnych płatności

  - `channel` (string)
    Kanal płatności
    Enum: "PAYWALL", "MOBILE", "WEBAPI", "EBOK", "CSS"

  - `method` (string)
    Metoda płatności
    Enum: "CARD", "PBL", "BLIK", "GPAY", "APAY", "UNKNOWN", "C2P"

  - `apaySession` (string)
    Obiekt sesji APAY do inicjalizacji płatności

  - `reattempt` (string)
    Informacja o ograniczeniach w wykonywaniu płatności. Dopuszczalne wartości: NEVER - nie wysyłaj wiecej komunikatów na ten numer karty; NEVER_RECURRING - nie wysyłaj wiecej komunikatów dla płatności powtarzalnej; LATER - spróbuj poźniej
    Enum: "NEVER", "NEVER_RECURRING", "LATER"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 500 fields