Authorization

POST

https://merchantapi-demo.bill24.io/merchantsecurity/authorize

Bill24 Implement this endpoint.

NOTE

This endpoint is used to authorize users to obtain a token for accessing the API. if token expired you can use refreshToken to get new token.

Request

Header Params

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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"
  }
}

Modified at 2025-03-20 07:58:01

Web SDK

Init Subscription