APIs for BusinessesCHECKOUT/ DEEPLINK
Light Mode
Authorization
POSThttps://merchantapi-demo.bill24.io/security/authorizeThis endpoint is used to authorize users to obtain a token for accessing the API.
:::note
Merchant 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
Accept
string
required
Example:
application/json
Content-Type
string
required
Example:
application/json
Body Params application/json
email
string
required
Email provide by Bill24
password
string
required
Password provide by Bill24
clientId
string
required
key provide by Bill24
secret
string
required
key provide by Bill24
refreshToken
string
optional
Example
{
"email": "demomerchant@gmail.com",
"password": "demomerchant",
"clientId": "supplier_client",
"secret": "q<8X8Eu4,Lr[4sxn",
"refreshToken": ""
}Request samples
Responses
OK(200)
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
issuer
string
optional
token
string
optional
Bearer token use to access API (expire in1 hour )
refreshToken
string
optional
Can use to get a new bearer token
tokenExpireTime
string
optional
Expiration time
userId
string
optional
User identity
email
string
optional
fullname
string
optional
permissions
array[string]
optional
isNeedChangePassword
boolean
optional
passwordNeverExprie
boolean
optional
passwordExpireIn
number
optional
isPasswordExpire
boolean
optional
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
}Last modified: 3 months ago