Customer API returns customer's information and Logout function hat logs a user out from the API.
production
development
https://api.rapidlink.piraeusbank.gr/piraeusbank/production
Base Gateway API Endpoint
Paths
/info
get /info
customer
demographics
core banking
This operation returns information related to the customer
This service contains demographic information corresponding to the customer associated with OAuth bearer token supplied. The information returned includes information such as name, address, telephone numbers, email address etc.
To use this operation you must use one of the following sets of security requirements.
clientId
X-IBM-Client-Id
(apiKey located in header)
The client id of the application as obtained by registering the client application in the developers portal.
MSIS OAuth
MSIS OAuth
(oauth2 accessCode)
OAuth URLs to use in the dev, uat and production environment using the access code OAuth 2.0 flow.
Authorization URL
https://openbank.piraeusbank.gr/identityserver/connect/authorize
Token URL
https://openbank.piraeusbank.gr/identityserver/connect/token
Scopes
winbankAccess
Sandbox OAuth
Sandbox OAuth
(oauth2 accessCode)
OAuth URLs to use in the sandbox environment using the access code OAuth 2.0 flow
Authorization URL
https://api.rapidlink.piraeusbank.gr/piraeusbank/production/oauth/oauth2/authorize
Token URL
https://api.rapidlink.piraeusbank.gr/piraeusbank/production/oauth/oauth2/token
Scopes
/sandboxapi
Scope to access to the APIs in the sandbox environment
clientId
X-IBM-Client-Id
(apiKey located in header)
The client id of the application as obtained by registering the client application in the developers portal.
Authorization
Required in header
string
This header should be in the form "Bearer Token", where Token is the OAuth2 token
Accept
Optional in header
string
application/json
200
200 OK
400
Bad Request
401
Unauthorized
404
Not Found
440
Login Time-out
501
Not Implemented
Example Request
Example Response
GET https://api.rapidlink.piraeusbank.gr/piraeusbank/production/v1.1/customer/info
Try this operation
Definitions
{
"type": "object",
"properties": {
"httpCode": {
"type": "string"
},
"httpMessage": {
"type": "string"
},
"errorCode": {
"type": "string"
},
"errorMessage": {
"type": "string"
}
},
"example": "{\n\t\"httpCode\": \"412\",\n\t\"httpMessage\": \"Precondition Failed\",\n\t\"errorCode\": \"API-987\",\n\t\"errorMessage\": \"sample error message\"\n}"
}
The response to the customer info operation
{
"type": "object",
"properties": {
"Quarantine": {
"type": "boolean",
"description": "A boolean property"
},
"Body": {
"type": "object",
"properties": {
"SiteCode": {
"type": "string",
"description": "The country where the customer is based e.g. GR"
},
"ChannelCode": {
"type": "string",
"description": "The channel that is used currently e.g. EB - electronic banking"
},
"CultureName": {
"type": "string",
"description": "The locale of the user. Messages are returned in this locale e.g. el-GR"
},
"UserId": {
"type": "number",
"description": "The user id of the customer e.g. 483450 - this is an internal bank number"
},
"UserAlias": {
"type": "string",
"description": "The user alias of the customer - it is essentially the user name that was used for authentication"
},
"DisplayName": {
"type": "string",
"description": "The display name - e.g. Shatoshi Nakamoto"
},
"Firstname": {
"type": "string",
"description": "The given name of the customer e.g. Shatoshi"
},
"Surname": {
"type": "string",
"description": "The last name of the customer e.g. Nakamoto"
},
"Fathername": {
"type": "string",
"description": "The name of the father of the customer e.g. Yanis"
},
"AddressOfCustomer": {
"type": "string",
"description": "The postal address of the customer e.g. ΧΕΙΜΑΡΑΣ 8B, 15125, ΜΑΡΟΥΣΙ ΑΤΤΙΚΗΣ, GR-ΕΛΛΑΔΑ"
},
"Email": {
"type": "string",
"description": "The email address of the customer e.g. sNakamoto@bitcoin.gr"
},
"IsCorporate": {
"type": "boolean",
"description": "Whether the customer is a corporate customer true\/false"
},
"ExtraPinMobile": {
"type": "string",
"description": "The mobile number to receive the extra pin information e.g. +306946666666"
},
"NativeSalutation": {
"type": "string",
"description": "A salutation string in the language (culture name) of the customer e.g Welcome Mr. Shatoshi Nakamoto"
},
"TaxCode": {
"type": "string",
"description": "The tax code (AFM) of the customer e.g. 012345678"
},
"IDCardOrPassport": {
"type": "string",
"description": "The id card number or passport number of the customer eg. X123456"
},
"LastLogin": {
"type": "string",
"description": "The date of last login of the customer eg. 2017-03-08T16:11:00"
},
"HasExtraPin": {
"type": "boolean",
"description": "Whether the customer has an extra pin capability true\/false"
},
"HasOtp": {
"type": "boolean",
"description": "Whether the customer has one time password token capability true\/false"
},
"BirthDate": {
"type": "string",
"description": "The birthdate of the customer e.g. 1971-12-07T00:00:00"
}
},
"description": "The body of the response to the customer info operation"
}
},
"example": "{\n\t\"Quarantine\": false,\n\t\"Body\": {\n\t\t\"SiteCode\": \"GR\",\n\t\t\"ChannelCode\": \"EB\",\n\t\t\"CultureName\": \"el-GR\",\n\t\t\"UserId\": 123456,\n\t\t\"UserAlias\": \"UserAAA\",\n\t\t\"DisplayName\": \"ΗΛΙΑΣ ΓΕΩΡΓΙΟΥ\",\n\t\t\"Firstname\": \"ΗΛΙΑΣ\",\n\t\t\"Surname\": \"ΓΕΩΡΓΙΟΥ\",\n\t\t\"Fathername\": \"ΑΘΑΝΑΣΙΟΣ\",\n\t\t\"AddressOfCustomer\": \"ΜΕΓ.ΑΛΕΞΑΝΔΡΟΥ 15, ΠΕΡΙΣΤΕΡΙ ΑΤΤΙΚΗΣ, GR-ΕΛΛΑΔΑ\",\n\t\t\"Email\": \"i.georgiou@myemail.com\",\n\t\t\"IsCorporate\": false,\n\t\t\"ExtraPinMobile\": \"+306946666666\",\n\t\t\"NativeSalutation\": \"Welcome Ilias Georgiou\",\n\t\t\"TaxCode\": \"012345678\",\n\t\t\"IDCardOrPassport\": \"ΑΔ123145\",\n\t\t\"LastLogin\": \"2017-03-08T16:11:00\",\n\t\t\"HasExtraPin\": true,\n\t\t\"HasOtp\": false,\n\t\t\"BirthDate\": \"1971-12-07T00:00:00\"\n\t}\n}"
}