POST
/
merchants
/
accounts
/
blacklist
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/merchants/accounts/blacklist" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "X-Organisation-Id: FYH0NTVW0DXK" \
  --header "X-Merchant-Account-Number: 35253486" \
  --header "Accept-Language: en" \
  -d '{
    "merchantAccountNumber": 35253486,
    "changedBy": "johndoe@example.com",
    "comments": "Merchant account blacklisted due to fraudulent activity",
    "reasonId": 3
  }'
"Merchant account has been blacklisted successfully"

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer <Token>, where <Token> is your access token.

Headers

ā€‹
X-Organisation-Id
string
required

The organization identifier

ā€‹
X-Merchant-Account-Number
string
required

The merchant account number

ā€‹
Accept-Language
string
default:en

Preferred language for the response

Body

application/json
ā€‹
merchantAccountNumber
integer
required

The unique identifier of the merchant account to blacklist

Example:

35253486

ā€‹
changedBy
string<email>
required

Email address of the user blacklisting the merchant

Example:

"johndoe@example.com"

ā€‹
reasonId
integer
required

The unique identifier of the reason category for this status change

Example:

3

ā€‹
comments
string

Additional comments or notes about the blacklisting

Example:

"Merchant account blacklisted due to fraudulent activity"

Response

200 - application/json

OK - Merchant successfully blacklisted

The response is of type string.

Example:

"Merchant account has been blacklisted successfully"