Xellion Logo Payment Status API Docs
Overview Request cURL Response Try API

Check Payment Status by Order ID

Use this API to fetch the current status of any deposit or withdrawal payment using its unique order ID. Send your merchant secret in the header and the order ID in the request body.

Base URL Ready Merchant Secret Required Order ID Lookup Deposit & Withdrawal

Quick Summary

  • Method: POST
  • Endpoint: /api/payment/get-payment-status
  • Header: x-merchant-secret
  • Content type: application/json
  • Pass the orderId in the request body
  • Returns: paymentType, paymentMethod, paymentStatus

API Endpoint

Use the following base URL and endpoint to check payment status.

Base URL
https://psp-payment-sandbox.xellion.com
Endpoint
/api/payment/get-payment-status
Method
POST

Required Headers

The merchant secret will be provided by the admin.

Header Required Description
x-merchant-secret Yes Your merchant secret key. This will be provided by the admin.
Content-Type Yes Must be set to application/json.
Keep your merchant secret secure. Do not expose it publicly in production applications.

Request Body

Send the following field in JSON format.

Field Type Required Description
orderId String Yes The unique order ID of the payment whose status you want to check.
You can use this API to check the status of both deposit and withdrawal payments.

Sample JSON Payload

{
  "orderId": "1905"
}

cURL Example

curl --location 'https://psp-payment-sandbox.xellion.com/api/payment/get-payment-status' \
--header 'x-merchant-secret: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "orderId": "1905"
}'

Response Format

The API returns the payment details along with its current status.

Field Type Description
success Boolean Indicates whether the API call was successful.
message String A human-readable message about the response.
data.orderId String The order ID that was queried.
data.paymentType String Type of payment — deposit or withdrawal.
data.paymentMethod String / null The payment method used. Can be null if not yet assigned.
data.paymentStatus String Current status of the payment: PENDING, PROCESSING, SUCCESS, or FAILED.

Sample Success Response

{
  "success": true,
  "message": "Payment status",
  "data": {
    "orderId": "1905",
    "paymentType": "deposit",
    "paymentMethod": null,
    "paymentStatus": "PENDING"
  }
}

Payment Status Values

The paymentStatus field can have one of these values.

PENDING
The payment has been created but no action has been taken yet.
PROCESSING
The payment is currently being processed by the provider.
SUCCESS
The payment was completed successfully.
FAILED
The payment could not be completed or was rejected.

Try the API

Use the form below to check a payment status directly from this page.

Direct browser calls may fail because of CORS restrictions or security policies. In production, it is recommended to call this API from your backend server.

Response

Waiting for request...

The response will appear here after the API call is completed.

Payment Status API documentation page. Designed for merchant integration and testing.