Check Payment Status

Check Payment Status Endpoint

Optional

This endpoint is optional. It actively queries the payment gateway to verify and update the transaction status. Use it when you need real-time confirmation — for example, if a customer claims they paid but the status hasn't updated yet. For simply reading stored transaction data, use the Show endpoint instead.

The key difference between Check and Show:

Show reads the transaction as stored in the database
Check contacts the payment gateway, updates the transaction status, and returns the latest state

GET /api/payment/check

Headers

Key	Value	Required
Accept	application/json	Yes
Content-Type	application/json	Yes
x-app-key	YOUR_APP_KEY	Yes
x-app-secret	YOUR_SECRET_KEY	Yes

Request Parameters

Parameter	Type	Required	Description
order_number	string	Yes	The order number of the transaction to verify

Example Usage in Different Languages

example.js

const axios = require('axios');
 
async function checkTransaction(orderNumber) {
  const response = await axios.get('https://epay.guiddini.dz/api/payment/check', {
    params: { order_number: orderNumber },
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json',
      'x-app-key': 'YOUR_APP_KEY',
      'x-app-secret': 'YOUR_SECRET_KEY'
    }
  });
  console.log(response.data);
}
 
checkTransaction('1BU9MF7NVHA8WKKG8W8S');

Response

response.json

{
  "data": {
    "type": "transaction",
    "id": "1BU9MF7NVHA8WKKG8W8S",
    "attributes": {
      "amount": "3000",
      "order_number": "1BU9MF7NVHA8WKKG8W8S",
      "order_id": "rAYKqByC6d1MLIAAF775",
      "status": "confirmed",
      "deposit_amount": "3000",
      "auth_code": "831000",
      "action_code": "0",
      "action_code_description": "Approved",
      "error_code": "0",
      "error_message": null,
      "confirmation_status": "confirmed",
      "license_env": "development",
      "form_url": "https://test.satim.dz/payment/merchants/merchant1/payment_fr.html?mdOrder=rAYKqByC6d1MLIAAF775",
      "svfe_response": null,
      "pan": "6280XXXXXXXX1234",
      "ip_address": "192.168.1.1",
      "approval_code": "831000",
      "updated_at": "2025-04-05T10:40:15+00:00"
    },
    "links": {
      "self": "https://epay.guiddini.dz/api/payment/show?order_number=1BU9MF7NVHA8WKKG8W8S",
      "href": "https://epay.guiddini.dz/api/payment/receipt?order_number=1BU9MF7NVHA8WKKG8W8S"
    }
  },
  "meta": {
    "code": "TRANSACTION_FOUND",
    "message": "Transaction retrieved successfully"
  }
}