API 1: Get Access Tokens

Get Access Tokens

This endpoint allows you to obtain a list of transaction tokens (JWT) for various payment channels associated with the provided developer ID and merchant ID. These tokens are currently designed to be long-lived.

For all subsequent requests to business-related API endpoints, the appropriate token (depending on the payment channel) must be included in the Authorization header of the HTTP request.

Test Enviroment:

POST https://oversea.paywizard.biz/ovstrade/semiOpen/generateAccessToken

Production Enviroment:

POST https://portal.paywizard.biz/ovstrade/semiOpen/generateAccessToken

Headers

Name	Value
Content-Type	application/json

Request Body

Name	Type	Mandatory	Description	Example
clientId	string		Developer ID	10000000011
clientSecret	String		Developer Secert	a393195acbf6beba52b30a98715c1407
merchantId	String		Merchant ID	10800000010
channelName	String		Payment Channel	epx
version	String			1.0.0

Request Example

{
    "clientId": "854413278057725952",
    "clientSecret": "6266b7272643b93e04336a6beb2459fb",
    "merchantId": "10800000010",
    "channelName": "epx"
}

Response Body

Name	Type	Mandatory	Description
code	Int		Response Code (200 Success, Non-200 Failed)
msg	String		Response Message
timestamp	String		Date/Time(UTC)
data	Object		Response Data
-token	String		Token Info
-merchantId	String		Expired after(Seconds)
-merchantName	String
-type	String
-channelName	String
-expiryTime	String		-1: Will not expire

Response Example

200

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "token": "BFF1PVPW6T8F7JWWVP8FRJZHB19VITIE",
            "merchantId": "10800000010",
            "merchantName": "epx",
            "type": "Terminal",
            "channelName": "epx",
            "expiryTime": -1
        },
        {
            "token": "X24BMAPMHGCCDYQXTAQYSAXZ6TJ09JIX",
            "merchantId": "10800000010",
            "merchantName": "epx",
            "type": "eCommerce",
            "channelName": "epx",
            "expiryTime": -1
        }
    ],
    "timestamp": "2024-07-23 17:57:00"
}