Fetch Token

Test environment

https://openapi-test.alchemypay.org/merchant/getToken

Prod environment

https://openapi.alchemypay.org/merchant/getToken

Http method

POST
Content-Type: application/json

Http header

Element	Mandatory	Data Type	Remarks
appId	Y	string	Partner unique ID, once a merchant has been on-boarded with Alchemy Pay, the merchant will be provided with the credentials with appId and appSecret
timestamp	Y	string	UTC time with 13 digit to represent time in milliseconds, expiration period is 5 minutes.
sign	Y	string	SHA1(appId + appSecret + timestamp), please refer to Sign demo for Initiate API

Http body

Element	Mandatory	Data Type	Remarks
email	Y	string	end user’s email

Request sample - Header

Request sample - Body

Response sample

{
    "success": true,
    "returnCode": "0000",
    "returnMsg": "SUCCESS",
    "extend": "",
    "data": {
        "id": "z1//LCqqoEoYloBXVODzPg==",
        "accessToken": "ACH7833164893ACHvJoJTBRF/b1sUp0Hq9Amo8C8NdSYwK+5ldXCtRcGMqEDudadzZ14999bggdpJPBzxKLSe5XzCmdMNmETMjbong==",
        "email": "O2Mp5tDOQk3hQFXPlQDBBUuJDUTklzdMujrrKM0XUbg="
    }
}

Note

In case the token expires, please use this API to fetch a new token.
id, email and accessToken in response need to URLEncode in http request, e.g. (https://ramptest.alchemypay.org?appId=URLEncode(id)&token=URLEncode(accessToken)&email=URLEncode(email)
Production appId and appSecret(never exposed on http request) are assigned once a merchant has been onboarded by Alchemy Pay