Link Merchant Event

POST

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

This event is used to link the merchant to the Open APIs partner through Zid Payments, allowing them to start accepting online payments on their Zid store.

`Authorization: No authentication required for this event.

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 Code 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-08-06 13:55:50

Overview

Payment Paid Event