Check Transaction Status

POST

https://mock.apidog.com/m1/1286474-0-1260791/api/v1/merchant/sdk-payment/get-transaction-status

Query the current state of a transaction by orderId. Use this endpoint for reconciliation, polling, or verifying a callback.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200

application/json

⚠️ Important Warning / تنبيه هام ⚠️

Attention: Please ensure you check the paymentStatus value before confirming any transaction.
A payment is ONLY considered successful and complete if the value is processed (1202).
Any other value means the transaction is unpaid or incomplete. Do not proceed with the order unless the status is exactly 1202.

انتباه: يرجى التأكد من فحص قيمة paymentStatus قبل اعتماد أي عملية.
لا تعتبر عملية الدفع صحيحة ومكتملة إلا إذا كانت القيمة هي processed (1202).
أي قيمة أخرى تعني أن العملية غير مدفوعة أو غير مكتملة. يرجى عدم تنفيذ الطلب أو تقديم الخدمة ما لم تكن القيمة 1202 بالتحديد.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://mock.apidog.com/m1/1286474-0-1260791/api/v1/merchant/sdk-payment/get-transaction-status' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "head": {
    "signature": "string",
    "requestTimestamp": ""
  },
  "body": {
    "appId": "ec05d8a6-db74-4a3f-ba6f-46e6a5609fa4",
    "orderId": "",
    "requestTimestamp": ""
  }
}'

Response Example

{
    "status": 1,
    "code": "1111",
    "messages": [
        "Success"
    ],
    "head": {
        "signature": "Q4oHboQ8xXD93exOIbEgTC4nKaUAp0Jyz54GKradtoyF37Xr1/p/gVUhkCd7E4Q2ofBjAj2b8Jlmn3FuqdecMsFR8ABiUgazMrQdjp6Hctw=",
        "requestTimestamp": "1732634833805"
    },
    "body": {
        "trxStatus": "completed",
        "trxStatusId": 1003,
        "paymentStatus": 1202,
        "paymentStatusName": "processed",
        "creationDate": "2024-11-26T18:19:29",
        "trxTypeName": "PayBill",
        "actionId": 0,
        "fromInfo": {
            "partyId": 100007703,
            "paymentMethodId": 100000006
        },
        "toInfo": {
            "partyId": 100000011,
            "paymentMethodId": 100000007
        },
        "miniAppInfo": {
            "bcrMiniAppTypeId": 100000001,
            "bcrProviderId": 100000403,
            "bcrProductId": 100000402,
            "link": "https://hubloh.com/?SuperApp=Bas",
            "nameEn": "Hubloh",
            "nameAr": "هب له",
            "iconUri": "assets/images/sections/stores/hublo_icon.png",
            "isPublished": true,
            "sort": 2,
            "appId": "ac90ddd1-6627-4ae9-b268-98c17bd8ee6c",
            "style": "{\r\n  \"startColor\": \"#FFB295\",\r\n  \"endColor\": \"#FA7D82\"\r\n}"
        },
        "appId": "ac90ddd1-6627-4ae9-b268-98c17bd8ee6c",
        "trxId": "03a5fcf5-95a5-4c80-b226-c834fa651662",
        "trxToken": "3O+4uC0O3UgkYWM5MGRkZDEtNjYyNy00YWU5LWIyNjgtOThjMTdiZDhlZTZjUFkkMGFkODcxOWQtNWRiMC00ZTgyLWExZTUtZjgxOGMyNDRlYTFh",
        "authenticated": true,
        "timestamp": 0,
        "isTokenExpired": false,
        "order": {
            "appId": "ac90ddd1-6627-4ae9-b268-98c17bd8ee6c",
            "orderId": "0ad8719d-5db0-4e82-a1e5-f818c244ea1a",
            "amount": {
                "value": 600,
                "currency": "YER"
            },
            "description": "Payment of bill HUB100016324 to Hubloh"
        }
    }
}

Modified at 2026-07-27 18:10:02

Initiate Transaction

Flutter SDK