Initiate Merchant Activation

PSP (Non-FI) only.

CAMP has two partner types: FI (licensed financial institutions) and Non-FI. For Non-FI partners, each merchant must complete a one-time email OTP activation before the merchant can use fund-out APIs (withdrawal, conversion). FI partners skip this entirely their merchants are always active.

This endpoint initiates that activation. Call it after the merchant is created and KYC is approved (check via getMerchant), and the end-user has reviewed the authorization agreement (available via getTnc). It sends a 6-digit OTP to the merchant registered email. The masked email address and tncId are returned for use in confirmActivation. On success the merchant moves to PENDING_ACTIVATION.

OTP expires in 10 minutes. Re-initiating invalidates any previous OTP. After 5 consecutive wrong confirmActivation attempts the activation locks for 30 minutes, then automatically returns to PENDING_ACTIVATION. For an already-activated merchant, this endpoint returns 400.

LINK activation
Alternatively, pass activationMethod: "LINK" to activate via a hosted-page link instead of OTP. The end-user receives an email link and completes activation by consenting on the hosted page, after which the link is single-use. On success the merchant moves to PENDING_ACTIVATION. For LINK the response returns activationMethod and linkExpiresAt (72-hour TTL) instead of the OTP-specific fields; supportContactEmail and showPartnerLogo configure the activation email and apply to both OTP and LINK. Re-initiating with LINK supersedes any previous link.

The activationStatus value differs by channel: OTP reports MerchantActivationStatus (NOT_ACTIVATED / PENDING_ACTIVATION / ACTIVATED / LOCKED / EXPIRED / NO_NEED_ACTIVATION), while LINK reports LinkActivationStatus (PENDING_ACTIVATION / ACTIVATED / EXPIRED / NO_NEED_ACTIVATION / INVALIDATED).

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Example 1Example 2 (LINK)

{
  "participantCode": "B0100106",
  "clientReference": "REF202607090001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

SuccessSuccess (LINK)

{
 "code": 200,
 "msg": "success",
 "data": {
  "participantCode": "A0105003",
  "activationStatus": "PENDING_ACTIVATION",
  "otpSentToMaskedEmail": "s***@a***.com",
  "otpExpiresAt": 1751000300000,
  "tncId": "N001"
 }
}