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 request to payment provider to make sure the payment is actually successful.

Request

Path Params

Header Params

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200OK

application/json

Body

Example

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

🟠422Parameter Error

Modified at 2025-05-27 08:27:58

Execute Payment Request

Direct Payment