Authorization

POST

https://bankapi-demo.bill24.net/security/authorize

This endpoint is used to authorize users to obtain a token for accessing the API.

NOTE

Bank is required to initiate an authorization process to obtain a token for accessing all API endpoints.

if token expired you can use refreshToken to get new token.

Required fields: client_id secret refreshToken

Request

Header Params

Body Params application/json

Example

{
  "email": "demobank@gmail.com",
  "password": "demobank",
  "clientId": "bank_client",
  "secret": "Wuq98rPLwYfvDJ2e",
  "refreshToken": ""
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://bankapi-demo.bill24.net/security/authorize' \
--header 'Content-Type: application/json' \
--data-raw '{
  "email": "demobank@gmail.com",
  "password": "demobank",
  "clientId": "bank_client",
  "secret": "Wuq98rPLwYfvDJ2e",
  "refreshToken": ""
}'

Responses

🟢200OK

application/json

Body

Example

{
    "issuer": "http://dc.oone.bz:40011",
    "token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjZCOUY3RDZBMjA2MTQxQzkzQ0I2NEVFNjRGOTBBNUQwQTQzOTZDODBSUzI1NiIsInR5cCI6ImF0K2p3dCIsIng1dCI6ImE1OTlhaUJoUWNrOHRrN21UNUNsMEtRNWJJQSJ9.eyJuYmYiOjE2OTI4NDg1NDEsImV4cCI6MTY5Mjg3MDE0MSwiaXNzIjoiaHR0cDovL2RjLm9vbmUuYno6NDAwMTEiLCJhdWQiOlsiYmFua19hcGkiLCJraHFyX2FwaSIsIm5vdGlmaWNhdGlvbl9hcGkiLCJzZWN1cml0eV9hcGkiLCJodHRwOi8vZGMub29uZS5iejo0MDAxMS9yZXNvdXJjZXMiXSwiY2xpZW50X2lkIjoiYjI0X2FkbWluIiwic3ViIjoiMGIyZTE3YmUtZDIyNS00Zjc5LWI2YTktOThmYTgxMWE3NjljIiwiYXV0aF90aW1lIjoxNjkyODQ4NTQxLCJpZHAiOiJsb2NhbCIsInJvbGUiOiIqIiwiZW1haWwiOiJhZG1pbkB1YmlsbDI0LmNvbSIsInVzZXJuYW1lIjoiQWRtaW4iLCJpYXQiOjE2OTI4NDg1NDEsInNjb3BlIjpbImJhbmtfYXBpIiwia2hxcl9hcGkiLCJub3RpZmljYXRpb25fYXBpIiwic2VjdXJpdHlfYXBpIiwib2ZmbGluZV9hY2Nlc3MiXSwiYW1yIjpbInBhc3N3b3JkIl19.hi4WZFmbuXImmCePmn3Ott5Oftu0760p75e-9teLGswqLXK3ah6-4WLzfFZ3oEYL-TMjXKqs7_VKPXBz4nDZUdMQZf0MiXabH6IJiHDgbR72d1eiA44x1E8D8ff7R4BteBQY8DYrHQgB6PVL4TRlzgSGU6-fv2HQ_Dg2-o8mGy0WEKA61bAkzsKHrdSq0XeN3Qm2JIgBRV2afV1uux44wVnAxINhURkH_t0ChEeVzR0HwdCw9CnWHY04blE7zLpzuhyGrnRsOXgr4gXDVJ3_Do5bxQwhFw-PtzkQtm024wzMVuS1URTu3EGfLtFAFZdoNG0dvLej8ce3xOq0IMCdnA",
    "refreshToken": "7DFB50A51E1B2CE420B154DE041FD1D3BC5777C07F43D427D328EB37E9A7C112",
    "tokenExpireTime": "2023-08-24T16:42:21.9110603+07:00",
    "userId": "0b2e17be-d225-4f79-b6a9-98fa811a769c",
    "email": "admin@ubill24.com",
    "fullname": "Administrator",
    "permissions": null,
    "isNeedChangePassword": false,
    "passwordNeverExpire": false,
    "passwordExpireIn": 2147483647,
    "isPasswordExpire": false
}

🟠404Record not found

🟠400Invalid input

Modified at 2024-08-22 07:36:04

Transaction Verification

Overview