Get merchant account status

get/api/v1/merchants/merchant-account-status/{merchantId}

Returns the onboarding, bank and account verification status of a merchant associated with the calling partner, plus outstanding verification issues and the merchant's fee tier.

Endpoint destination URL

https://portal-api-sandbox.datmancrm.com/merchants/sandbox/api/v1/merchants/merchant-account-status/{merchantId}

Authorization

ApiKeyAuth

headerapi_key<token>

Partner API key issued by Datman.

Request Parameters

RequiredOptional

Path Parameters

merchantId*string

Datman merchant ID.

Match^\d+$

Response parameters & Errors

Response Body

Merchant status.

application/json

response

status?string

Merchant status, for example Not Submitted, Merchant pending, Verified, Active, Closed, Rejected or Watchlist.

bank_verification_status?string

Bank account verification status.

Value in"Unverified""Verified"

account_verification_status?string

Merchant account verification status.

Value in"Unverified""Verified"

verification_status?

Verification details from the payment provider.

feeTier?array<>

The merchant's current fee tier entry (filtered from the available fee tiers).

Response parameters & Errors ↓

Request

GET

/api/v1/merchants/merchant-account-status/{merchantId}

curl -X GET 'https://portal-api-sandbox.datmancrm.com/merchants/sandbox/api/v1/merchants/merchant-account-status/1000001'

JSON Response

{  "status": "Active",  "bank_verification_status": "Verified",  "account_verification_status": "Verified",  "verification_status": {    "account_status": "ACTIVE",    "payout_status": "ACTIVE",    "issues": [],    "verification_tier": "T1"  },  "feeTier": [    {      "id": 2    }  ]}