Link Merchant Event

POST

https://api.zid.sa//api/webhook/v1/thirdpartywebhook

This event is used to link a merchant to the OpenAPIs through ZidPay, allowing them to start processing payments on their Zid store.

Authorization: No authentication required for this event (as it’s webhook-based and triggered by the provider).

Request

Body Params application/json

Example

{
    "type": "merchant_linked",
    "thirdPartyId": 1, // assigned to payment provider by ZidPay
    "merchantId": "45cb5978-c6cd-4e34-bd93-de6bee9b3cae"
    "data": {
        "storeId": "123",
        "thirdPartyApiKeys": {
            "Publishable_Key": "pk_test_9a6Z61CUnM6nX4bStnNnZLnrKrbj2QK6xxscScDe",
            "Secret_Key": "sk_test_aLdogZnphPpoqcka4Qf5hRPFdffGL4p8dwB1Scsa"
        }
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa//api/webhook/v1/thirdpartywebhook' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "merchant_linked",
    "thirdPartyId": 1, // assigned to payment provider by ZidPay
    "merchantId": "45cb5978-c6cd-4e34-bd93-de6bee9b3cae"
    "data": {
        "storeId": "123",
        "thirdPartyApiKeys": {
            "Publishable_Key": "pk_test_9a6Z61CUnM6nX4bStnNnZLnrKrbj2QK6xxscScDe",
            "Secret_Key": "sk_test_aLdogZnphPpoqcka4Qf5hRPFdffGL4p8dwB1Scsa"
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{}

Modified at 2025-06-13 05:24:13

Webhooks

Payment Paid Event