Login

Login Endpoint

post

https://merchants-api.onekeypayments.com/v1https://merchants-api-stg.onekeypayments.com/v1

/auth/login

Authenticates a user by submitting an accessKey (email) and secretKey (password) to get a bearer token.

Body

application/json

accessKeystringOptional

Configured API User email address

Example: [e-mail]

secretKeystringOptional

Configured API User's password

Example: your-password

Responses

200

OK - Login success. A BEARER_TOKEN cookie is set in the response headers.

application/json

idUserintegerOptionalExample: 123

usernamestringOptionalExample: [e-mail]

idMerchantintegerOptionalExample: 456

403

Forbidden - Failure: invalid location

application/json

post

/auth/login

HTTPcURLJavaScriptPython

POST /v1/auth/login HTTP/1.1
Host: merchants-api.onekeypayments.com
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "accessKey": "[e-mail]",
  "secretKey": "your-password"
}

{
  "idUser": 123,
  "username": "[e-mail]",
  "idMerchant": 456
}