Mirakl

Integration type

eComm

What we solve

Marketplace operators running on Mirakl need a scalable way to complete seller KYB/KYC (and enforce buyer step-up on high-value orders) without manual review bottlenecks or fragmented tooling. This integration connects Mirakl Operator API events and webhooks to 1Kosmos BlockID Verify and LiveID—triggering business verification when shop applications are submitted, writing assurance level and verification artifacts back to Mirakl additional fields, and enabling automated approval/hold decisions for both seller onboarding and high-risk marketplace transactions.

Integration architecture

Mirakl is the dominant enterprise marketplace platform (used by Macy's, Best Buy, Decathlon, and 100+ operators). 1Kosmos integrates via the Mirakl Connect partner ecosystem and the Operator API.

Seller KYC onboarding flow:




Mirakl API calls:

# 1Kosmos reads seller application data
GET /api/shops?shop_states=WAITING_FOR_APPROVAL
Authorization: Mirakl-API-Key {operator_api_key}

# 1Kosmos writes verification result back
PATCH /api/shops/{shop_id}
{
  "shop_additional_fields": [
    { "code": "BLOCKID_IAL_LEVEL", "value": "2" },
    { "code": "BLOCKID_VC_TOKEN", "value": "{jwt}" },
    { "code": "BLOCKID_LIVEID_ENROLLED", "value": "true" },
    { "code": "BLOCKID_VERIFIED_AT", "value": "2025-04-01T12:00:00Z" }
  ]

# 1Kosmos reads seller application data
GET /api/shops?shop_states=WAITING_FOR_APPROVAL
Authorization: Mirakl-API-Key {operator_api_key}

# 1Kosmos writes verification result back
PATCH /api/shops/{shop_id}
{
  "shop_additional_fields": [
    { "code": "BLOCKID_IAL_LEVEL", "value": "2" },
    { "code": "BLOCKID_VC_TOKEN", "value": "{jwt}" },
    { "code": "BLOCKID_LIVEID_ENROLLED", "value": "true" },
    { "code": "BLOCKID_VERIFIED_AT", "value": "2025-04-01T12:00:00Z" }
  ]

# 1Kosmos reads seller application data
GET /api/shops?shop_states=WAITING_FOR_APPROVAL
Authorization: Mirakl-API-Key {operator_api_key}

# 1Kosmos writes verification result back
PATCH /api/shops/{shop_id}
{
  "shop_additional_fields": [
    { "code": "BLOCKID_IAL_LEVEL", "value": "2" },
    { "code": "BLOCKID_VC_TOKEN", "value": "{jwt}" },
    { "code": "BLOCKID_LIVEID_ENROLLED", "value": "true" },
    { "code": "BLOCKID_VERIFIED_AT", "value": "2025-04-01T12:00:00Z" }
  ]

Buyer step-up for high-value marketplace orders:




Mirakl Connect listing positions the integration as an "Identity & Trust" category app, targeting marketplace operators in financial services, B2B industrial supply, and regulated consumer goods.

Transform how you verify and authenticate

Secure onboarding, eliminate passwords, and stop fraud on one platform. Schedule a demo and see it in action.

Transform how you verify and authenticate

Secure onboarding, eliminate passwords, and stop fraud on one platform. Schedule a demo and see it in action.

Transform how you verify and authenticate

Secure onboarding, eliminate passwords, and stop fraud on one platform. Schedule a demo and see it in action.