Get an embedded dashboard URL

get/api/v1/bifrost/get-embededurl/{merchantId}/{page}

Creates a short-lived (10 minute) session for the embedded merchant dashboard and returns a ready-to-load URL for the requested page. The merchant must belong to the calling partner.

Endpoint destination URL

https://portal-api-sandbox.datmancrm.com/bifrost/sandbox/api/v1/bifrost/get-embededurl/{merchantId}/{page}

Authorization

ApiKeyAuth

headerapi_key<token>

Partner API key issued by Datman.

Request Parameters

RequiredOptional

Path Parameters

merchantId*string

Datman merchant ID.

page*string

Dashboard page to open.

Value in"overview""payment""payout"

Response parameters & Errors

Response Body

Embed URL created.

application/json

response

url*string

Embedded dashboard URL for the requested page, with the session token as the token query parameter.

Formaturi

expiresAt*integer

Expiry time as a Unix timestamp in seconds.

Response parameters & Errors ↓

Request

GET

/api/v1/bifrost/get-embededurl/{merchantId}/{page}

curl -X GET 'https://portal-api-sandbox.datmancrm.com/bifrost/sandbox/api/v1/bifrost/get-embededurl/1000001/overview'

JSON Response

{  "url": "https://embed.example.com/overview?token=0123456789abcdef0123456789abcdef",  "expiresAt": 1767225600}