# PURCHASE Request - Step 2 #### Input parameters of the JWS payload part:
ParameterDescriptionData FormatRequiredExample
operationIdOperation ID obtained in Step 1stringYes1697008393082nW0c1jr6KVv
encryptedCardData

card expiration date and cvv2 are encrypted in JWE. First 4 characters ExpDate, next 3 characters cvv

  • If "NONCVV\noncvv" is passed in TxnType parameter then in ecnryptedCardData parameter only YYMM without CVV should be passed
  • Otherwise if nothing is passed in TxnType then in encryptedCardData parameter it is mandatory to pass in YYMMCVV format
stringYes2503111 (decrypted format)
datePayment date and timestringYes{{currentdateT}}.00+00:00
browserInfoObject containing browser dataobjectYes, if 3DS is required-
browserAcceptHeaderHTTP request headerstringYes, if 3DS is requiredtext/html,application/xhtml+xml,...
browserUserAgentBrowser user-agent stringstringYes, if 3DS is requiredMozilla/5.0 (Windows NT 10.0; Win64; x64)...
browserLanguageBrowser languagestringYes, if 3DS is requireden-US,en
browserColorDepthScreen color depth valuestringYes, if 3DS is required24
browserScreenHeightBrowser viewport heightstringYes, if 3DS is required800
browserScreenWidthBrowser viewport widthstringYes, if 3DS is required1280
browserTZBrowser timezonestringYes, if 3DS is required-180
#### Output parameters of the JWS payload part: | Parameter | Description | Data Format | Example | | ----------------------- | ---------------------------------- | ----------- | ------------------------------------------------------------------------------ | | type | Transaction type | string | Purchase | | rrn | Transaction RRN in MPS | string | 2554256963 | | purpose | Payment purpose | string | For goods | | comment | Comment | string | test | | coinAmount | Payment amount | int | 2000 | | merchantId | Merchant ID | string | 137d9304-0368-11ed-b939-0242ac120002 | | operationId | Transaction ID | string | 1712844596346b9F-WwrWZpq | | ecomOperationId | Transaction ID in Ecom system | string | 8c3303e9-7396-43b8-af4e-31d9facdde9b | | merchantName | Merchant name | string | KB test terminal | | approvalCode | Authorization code | string | 39203 | | status | Transaction status | string | SUCCESS / FAIL / PENDING / REQUIRED\_3DS / DESIRED\_THREEDS\_MODE\_ERROR | | transactionType | Numeric transaction type | string | 35 | | merchantRequestId | Merchant request ID | string | 72837906-f526-4aef-8d11-58d80b44cb75 | | transactionCurrency | Payment currency | string | 980 | | merchantCommission | Commission amount | string | 2 | | creationDateTime | Payment creation date | string | 2024.09.19 15:29:25.675 | | modificationDateTime | Payment modification date | string | 2024.09.19 15:29:25.675 | | actionCode | Response code | string | 0 | | responseCode | Response details | string | 0 | | description | Response description | string | approved | | bankCode | Issuing bank name | string | BANK\_ALLIANCE | | paymentSystem | Issuing MPS name | string | MasterCard | | productType | Terminal product type | string | PURCHASE | | notificationUrl | Callback notification URL | string | | | paymentServiceType | Payment type | string | CARD / APPLE\_PAY / GOOGLE\_PAY | | notificationEncryption | Callback data encryption flag | string | true / false | | cardNumberMask | Masked card number | string | 5573\*\*\*\*\*\*\*\*0304 | | desiredThreeDSMode | Merchant's 3DS preference | string | MUST / SHOULD / MUST\_NOT | | threeDSMode | Whether 3DS was used | string | MUST / MUST\_NOT | | statusThreeDs | 3DS transaction status | string | Y (successful) / N (unsuccessful) | | threeDSServerTransId | 3DS system transaction ID | string | b6c35fdb-28c1-454d-a2f3-51098c26bda4 | | acsTransId | ACS system transaction ID | string | 3e17fabb-71e6-498e-8794-ef8c95c5ba6f | | dsTransId | Directory Server transaction ID | string | 12ebc556-82d3-4e35-9fb8-77ac18b050ea | | eci | Electronic Commerce Indicator code | string | 02 | | processingMerchantId | Merchant ID in PC | string | AE100000 | | processingTerminalId | Terminal ID in PC | string | AE100000 | | redirect3dsUrl | 3DS redirect URL | string | ... | | txnType | Transaction subtype | enum | NONCVV/noncvv | | senderCustomerId | Sender customer ID | string | 1258728c1 | | senderFirstName | Sender's first name | string | Ivanenko | | senderLastName | Sender's last name | string | Ivan | | senderMiddleName | Sender's middle name | string | Ivanovich | | senderEmail | Sender's email | string | | | senderCountry | Sender's country | string | Ukraine | | senderRegion | Sender's region | string | Kyiv region | | senderCity | Sender's city | string | Kyiv | | senderStreet | Sender's street | string | Sichovykh Striltsiv | | senderAdditionalAddress | Additional address details | string | 23 | | senderItn | Sender's ITN | string | 123456789 | | senderPassport | Sender's passport | string | АН123456 | | senderIp | Sender's IP address | string | 123.12.12.12 | | senderPhone | Sender's phone number | string | 380630000000 | | senderBirthday | Sender's date of birth | string | 31.12.2000 | | senderGender | Sender's gender | string | M | | senderZipCode | Sender's zip code | string | 12000 | | senderBankCode | Sender's issuing bank name | string | BANK\_ALLIANCE | | senderPaymentSystem | Sender's issuing MPS name | string | MasterCard | | senderCardNumberMask | Sender's masked card number | string | 5573\*\*\*\*\*\*\*\*0304 | | externalCardToken | Token id | string | tmkEYenZSa8FV03aawVXxbep | #### Examples :
JWS Payload - the request body before signing up ```json { "operationId": "{{operationIdT}}", "encryptedCardData": "{{encryptedDateAndSecurityT}}", "browserInfo": { "browserAcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9", "browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like,Gecko)Chrome/87.0.4280.66 Safari/537.36", "browserLanguage": "en-US,en", "browserColorDepth": "24", "browserScreenHeight": "800", "browserScreenWidth": "1280", "browserTZ": "-180" }, "date": "{{currentdateT}}.00+00:00" } ```
JWS Payload - the response body before subscriptions without 3ds ```json { "type": "PURCHASE", "rrn": "410114186775", "purpose": "purpose", "comment": "comment", "coinAmount": 1000, "merchantId": "137d9304-0368-11ed-b939-0242ac120002", "operationId": "17127594157429eggOuxH5yl", "ecomOperationId": "63feb70f-8eb0-43cc-96c3-2e2eea9cec1e", "merchantName": null, "approvalCode": null, "status": "SUCCESS", "transactionType": 35, "merchantRequestId": "1d4787d6-75cb-4c75-8466-59cc698e7bbf", "transactionCurrency": "980", "merchantCommission": null, "createDateTime": "2024.09.19 15:29:25.675", "modificationDateTime": "2024.09.19 15:29:25.675", "transactionResponseInfo": { "actionCode": null, "responseCode": null, "description": "Операція успішна" }, "bankCode": null, "paymentSystem": null, "productType": "PURCHASE", "paymentServiceType": "CARD", "notificationEncryption": false, "cardNumberMask": null, "desiredThreeDSMode": "MUST_NOT", "threeDSMode": "MUST_NOT", "statusThreeDs": null, "threeDSServerTransId": null, "redirect3dsUrl": null, "txnType": "NONCVV", "senderCustomerId": null, "senderFirstName": null, "senderLastName": null, "senderMiddleName": null, "senderEmail": null, "senderCountry": null, "senderRegion": null, "senderCity": null, "senderStreet": null, "senderAdditionalAddress": null, "senderItn": null, "senderPassport": null, "senderIp": null, "senderPhone": null, "senderBirthday": null, "senderGender": null, "senderZipCode": null, "senderBankCode": null, "senderPaymentSystem": null, "senderCardNumberMask": null, "externalCardToken": "tmkEYenZSa8FV03aawVXxbep" } ```
JWS Payload - the response body before subscriptions with 3ds ```json { "type": "PURCHASE", "rrn": null, "purpose": "LLopo", "comment": "RRRR", "coinAmount": 100, "merchantId": "137d9304-0368-11ed-b939-0242ac120002", "operationId": "1712822536063CdDIRi8hhjq", "ecomOperationId": "82da90c3-50b8-4d5b-b357-2cbe55167200", "merchantName": null, "approvalCode": null, "status": "REQUIRED_3DS", "transactionType": 35, "merchantRequestId": "8aa31389-fe6f-4b40-bb5e-4ecedfefb847", "transactionCurrency": "980", "merchantCommission": null, "createDateTime": "2024.09.19 15:29:25.675", "modificationDateTime": "2024.09.19 15:29:25.675", "transactionResponseInfo": { "actionCode": null, "responseCode": null, "description": null }, "bankCode": null, "paymentSystem": null, "productType": "PURCHASE", "notificationUrl": "https://webhook.site/6e35c4af-9af9-4212-9aa4-6a79ed6d7a0d", "paymentServiceType": "CARD", "notificationEncryption": true, "cardNumberMask": null, "desiredThreeDSMode": "MUST", "threeDSMode": "MUST", "statusThreeDs": null, "threeDSServerTransId": "0ce5cc44-2698-4a2c-969a-3155bad68b6e", "redirect3dsUrl": "https://api-ecom-release.develop.bankalliance.ua/threeDS/getRedirectHtml/1712822536063CdDIRi8hhjq", "txnType": "null", "senderCustomerId": null, "senderFirstName": null, "senderLastName": null, "senderMiddleName": null, "senderEmail": null, "senderCountry": null, "senderRegion": null, "senderCity": null, "senderStreet": null, "senderAdditionalAddress": null, "senderItn": null, "senderPassport": null, "senderIp": null, "senderPhone": null, "senderBirthday": null, "senderGender": null, "senderZipCode": null, "senderBankCode": null, "senderPaymentSystem": null, "senderCardNumberMask": null, "externalCardToken": "tmkEYenZSa8FV03aawVXxbep" } ```
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.merchant.alb.ua/en/authorization-2.0/payment-methods-h2h/purchase/purchase-request-step-2.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.