Banklink requests technical specification

Transcription

1 Version 1.0 Banklink requests technical specification Requests... 2 Requests specifications... 3 Payment services... 3 Service Service Service Service Identification services... 5 Service Service Service Service

2 Requests Decimal points and cents in the amounts presented in queries are separated with a dot"." Thousands separator will not be used. Dates and times will be represented in DATETIME format within second precision, e.g: T07:21: The receiver of the request has to check the value in the DATETIME field, whereas the value of the field may differ from the current checking time by a maximum of ± 5 minutes. Length of fields cannot be greater than specified in this technical specification. If field is greater, then this request will not be processed. Field values are represented as symbols. Field value can be shorter than maximum length. Non-compliant requests will be responded with proper error message. Field names, used in the Banklink requests (VK_...) cannot be used in the field VK_RETURN. There can be following requests: 1. Initiator based: Merchant or Bank requests. 2. Response based: That require response That will not require response. 3. Function based: 1xxx initiating transactions 3xxx identification requests Calculating checksum VK_MAC based on version 008 The signature MAC008 (VK_MAC) is calculated using the public key algorithm RSA and hashalgorithm SHA1. MAC008(x1,x2,..., xn):= RSA (SHA-1(p(x1) x1 p(x2) x2... p(xn) xn),d,n) Explanations: - string adding operation x1, x2,..., xn request parameters (numbered in the specification). p function of length of the parameter. Length is a number in a form of a three-digit string. d RSA - secret exponent n RSA modulus 2

3 Requests specifications Payment services Service 1011 Partner will send to the Bank signed data of payment order, that customer cannot edit during paying process. After successful payment request 1111 is generated, otherwise 1911 is generated. 1 VK_SERVICE 4 Service number (1011) 3 VK_SND_ID 15 Payment request initiator ID (Partner ID) 4 VK_STAMP 20 Request ID 5 VK_AMOUNT 12 Payment amount 6 VK_CURR 3 Currency: EUR 7 VK_ACC 34 Beneficiary account number 8 VK_NAME 70 Beneficiary name 9 VK_REF 35 Payment order reference number 10 VK_MSG 95 Payment order description 11 VK_RETURN 255 URL, where to send answer if payment is successful 12 VK_CANCEL 255 URL, where to send answer if payment is NOT successful 13 VK_DATETIME 24 Request initiation date and time in DATETIME format Service 1012 Partner will send to Bank Customers proposal to start payment transaction. Beneficiary name and account will be taken from Bank s database. After successful payment request 1111 is generated, otherwise 1911 is generated. 1 VK_SERVICE 4 Service number (1012) 3 VK_SND_ID 15 Payment request initiator ID (Partner ID) 4 VK_STAMP 20 Request ID 5 VK_AMOUNT 12 Payment amount 6 VK_CURR 3 Currency: EUR 7 VK_REF 35 Payment order reference number 8 VK_MSG 95 Payment order description 9 VK_RETURN 255 URL, where to send answer if payment is successful 10 VK_CANCEL 255 URL, where to send answer if payment is NOT successful 11 VK_DATETIME 24 Request initiation date and time in DATETIME format 3

4 Service 1111 Used as domestic payment response. 1 VK_SERVICE 4 Service number (1111) 3 VK_SND_ID 15 Payment request initiator ID (Bank ID) 4 VK_REC_ID 15 Request receiver ID (Partner ID) 5 VK_STAMP 20 Request ID 6 VK_T_NO 24 Payment order number 7 VK_AMOUNT 12 Payment amount 8 VK_CURR 3 Currency: EUR 9 VK_REC_ACC 34 Beneficiary account number 10 VK_REC_NAME 70 Beneficiary name 11 VK_SND_ACC 34 Payer account number 12 VK_SND_NAME 70 Payer name 13 VK_REF 35 Payment order reference number 14 VK_MSG 95 Payment order description 15 VK_T_DATETIME 24 Payment order date and time in DATETIME format - VK_LANG 3 Preferred language of communication (EST, ENG or RUS) - VK_AUTO 1 N = response is sent while customer is redirected back to Partner page Service 1911 Used as response for unsuccessful payment. 1 VK_SERVICE 4 Service number (1911) 3 VK_SND_ID 15 Payment request initiator ID (Bank ID) 4 VK_REC_ID 15 Request receiver ID (Partner ID) 5 VK_STAMP 20 Request ID 6 VK_REF 35 Payment order reference number 7 VK_MSG 95 Payment order description - VK_AUTO 1 N = response is sent while customer is redirected back to Partner page 4

5 Identification services Service 3012 To Partner will be sent user identificator and date and time of generating this request. For security reasons Partner has to check date and time of this request (VK_DATETIME). 1 VK_SERVICE 4 Service number (3012) 3 VK_USER 16 Agreed user ID 4 VK_DATETIME 24 Request generating time in DATETIME format 5 VK_SND_ID 15 Payment request initiator ID (Bank ID=NORDEA) 6 VK_REC_ID 15 Request receiver ID (Partner ID) 7 VK_USER_NAME 140 User name (last name, first name[s]) 8 VK_USER_ID 20 User personal ID 9 VK_COUNTRY 2 Personal ID country (two places ISO ) 10 VK_OTHER 150 Other info about user 11 VK_TOKEN 2 Authentication device ID. 1- ID-card; 2- Mobile-ID; 5- onetime codes (except PIN-calculator); 6- PIN-calculator; 7- re-usable card 12 VK_RID 30 ID that is linked to session. Optional field. Service 3013 To Partner will be sent time and date of generating user ID and nonce copy. For security reasons Partner has to check date and time of this request (VK_DATETIME). 1 VK_SERVICE 4 Service number (3013) 3 VK_DATETIME 24 Request generating time in DATETIME format 4 VK_SND_ID 15 Payment request initiator ID (Bank ID=NORDEA) 5 VK_REC_ID 15 Request receiver ID (Partner ID) 6 VK_NONCE 50 Nonce copy, that was in the request 7 VK_USER_NAME 140 User name (last name, first name[s]) 8 VK_USER_ID 20 User personal ID 9 VK_COUNTRY 2 Personal code country(two places ISO ) 10 VK_OTHER 150 Other info about user 11 VK_TOKEN 2 Authentication device ID 12 VK_RID 30 ID that is linked to session. Optional field. 5

6 Service 4011 Request sent from Partner to identify customer. Service is provided to Partners, who have appropriate service agreement. Response request code is VK_SERVICE 4 Service number (4011) 3 VK_SND_ID 15 Request initiator ID (Partner ID) 4 VK_REPLY 4 Expected response request code (3012) 5 VK_RETURN 255 Partner URL, where response is sent 6 VK_DATETIME 24 Request generating time and date in DATETIME format 7 VK_RID 30 ID that is linked to session. Optional field. Service 4012 Request sent by Partner, to identify user. Service is provided to Partners, who have appropriate service agreement. Response request code is VK_SERVICE 4 Service number (4012) 3 VK_SND_ID 15 Request initiator ID (Partner ID) 4 VK_REC_ID 15 Request receiver ID (Bank ID) 5 VK_NONCE 50 Random nonce generated by request initiator 6 VK_RETURN 255 Partner URL, where response is sent 7 VK_DATETIME 24 Request generating time and date in DATETIME format 8 VK_RID 30 ID that is linked to session. Optional field. 6