Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Get payment status

GET

https://api.zid.sa/{ProviderUrl}/payments/{Provider paymentId}

After receiving a callback or a webhook for a payment success ZidPay system will send a payment status / details request to payment provider; to verify the payment status.

Request

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.paymentprovider.com/payments/b7a1c6f2-9d3e-4e2c-bf1f-05e6a1c8f317' \
--header 'Authorization: Authorization: Basic secret_key'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "id": "pay_abc123xyz789",
    "status": "paid",
    "amount": 24900,
    "currency": "SAR",
    "refunded": 0,
    "errorCode": "ZDP001"
}

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server error

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

Execute Payment Request

ApplePay