Payment Paid Event

POST

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

The "Payment Paid Event" is used to notify Zid Payments system of any updates regarding the status of a payment, whether it is successful or failed. This ensures that Zid Payments is informed about the payment status and can update its records accordingly.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🔴500Internal Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.zid.sa//api/webhook/v1/thirdpartywebhook' \
--header 'Authorization: Authorization: Basic secret_key' \
--header 'Content-Type: application/json' \
--data '{
    "type": "object",
    "example": {
        "type": "payment_paid",
        "thirdPartyId": 1,
        "merchantId": "45cb5978-c6cd-4e34-bd93-de6bee9b3cae",
        "data": {
            "id": "pay_abc123xyz",
            "paymentReferenceId": "123456",
            "status": "paid"
        }
    }
}'

Response Example

200 - Example 1

{}

Modified at 2026-01-30 20:55:20

Link Merchant Event

Refund Event