Authorization - APIs for Businesses

Request

Header Params

Accept

string

required

Example:

application/json

Content-Type

string

required

Example:

application/json

Body Params application/json

token

string

required

Merchant token (provide by bill24)

clientId

string

required

Client id (provide by bill24)

secret

string

required

Client secret (provide by bill24)

refreshToken

string

optional

Refresh Token is used to extend the expiration date without requiring a token.

Example

{
  "token": "3687203e-1cf4-43de-8a1c-c2192248132a",
  "clientId": "supplier_client",
  "secret": "q<8X8Eu4,Lr[4sxn",
  "refreshToken": ""
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://merchantapi-demo.bill24.io/merchantsecurity/authorize' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "3687203e-1cf4-43de-8a1c-c2192248132a",
    "clientId": "supplier_client",
    "secret": "q<8X8Eu4,Lr[4sxn",
    "refreshToken": ""
}'

Responses

🟢200Success

application/json

Body

code

integer

optional

Response code

message

string

optional

Response message

data

object

optional

issuer

string

required

The URL where the token was issued

token

string

required

The Bearer token used for API requests

refreshToken

string

required

The token is used to obtain a new access token when the current one expires.

tokenExpireTime

string

required

The time when the token expires.

Example

{
  "code": 200,
  "message": "",
  "data": {
    "issuer": "http://192.168.197.18:23030",
    "token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjZCOUY3RDZBMjA2MTQxQzkzQ0I2NEVFNjRGOTBBNUQwQTQzO",
    "refreshToken": "65EE30E135B51D343F077738345CBDEEA66A3A796494F172DCF2EE6C9C1E0B7B",
    "tokenExpireTime": "2024-06-24T14:46:07.8930774+07:00"
  }
}