kyc.submitted

POST

/webhooks/outbound/kyc.submitted

Documentation only -- this event is sent by OpenSylo to your webhook URL.

Fired when a marketplace-onboarded merchant submits KYC for review
(via the Marketplace API or inside the embedded journey).

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Your server should return 200 to acknowledge receipt.

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.opensylo.com/webhooks/outbound/kyc.submitted' \
--header 'X-OpenSylo-Signature: sha256=f1e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1e2' \
--header 'X-OpenSylo-Timestamp: 1712495400' \
--header 'X-OpenSylo-Event-Id: evt_oa_20260407_001' \
--header 'Content-Type: application/json' \
--data '{
    "event": "kyc.submitted",
    "event_id": "evt_kyc.submitted_b2c3d4e5",
    "timestamp": "2026-06-10T10:05:00.123Z",
    "merchant": {
        "opensylo_id": "mch_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "marketplace_id": "mkt_9f8e7d6c-5b4a-3210-fedc-ba0987654321",
        "third_party_customer_id": "mkt_merchant_8421"
    },
    "kyc_status": "SUBMITTED",
    "rejection_reason": null
}'

Modified at 2026-06-10 14:59:36

merchant.created

kyc.approved