Show Payment details

Show Payment Details Endpoint

This endpoint allows you to retrieve the details of a specific payment by providing the order number of the transaction. It returns the payment details, including the amount, order number, order ID, status, form URL, confirmation status, and update timestamp, plus a ready-to-show display block.

GET /api/payment/show

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 Body

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

Example Usage in Different Languages

example.js

const axios = require('axios');
 
async function showTransaction(orderNumber) {
  const response = await axios.get('https://epay.guiddini.dz/api/payment/show', {
    data: { 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);
}
 
showTransaction('1BU9MF7NVHA8WKKG8W8S');

Response

response.json

{
  "data": {
    "type": "transaction",
    "id": "1BU9MF7NVHA8WKKG8W8S",
    "attributes": {
      "amount": "3000",
      "order_number": "1BU9MF7NVHA8WKKG8W8S",
      "order_id": "rAYKqByC6d1MLIAAF775",
      "status": "processing",
      "deposit_amount": null,
      "auth_code": null,
      "action_code": null,
      "action_code_description": null,
      "error_code": "0",
      "error_message": null,
      "confirmation_status": "requires_verification",
      "license_env": "development",
      "form_url": "https://test.satim.dz/payment/merchants/merchant1/payment_fr.html?mdOrder=rAYKqByC6d1MLIAAF775",
      "svfe_response": null,
      "pan": null,
      "ip_address": null,
      "approval_code": null,
      "created_at": "2025-04-05T10:36:12+00:00",
      "updated_at": "2025-04-05T10:36:20+00:00",
      "display": {
        "outcome": "pending",
        "message": null,
        "rows": [
          { "label": "ID de transaction", "value": "1BU9MF7NVHA8WKKG8W8S" },
          { "label": "Numéro de commande", "value": "rAYKqByC6d1MLIAAF775" },
          { "label": "Montant", "value": "3 000,00 DZD" },
          { "label": "Date", "value": "05/04/2025 11:36" }
        ]
      }
    }
  },
  "meta": {
    "code": "TRANSACTION_FOUND",
    "message": "Transaction retrieved successfully"
  }
}

The display block

attributes.display holds what your page shows the payer. Show it as it is: no condition on your side.

Key	Type	Value
`outcome`	string	`success`, `pending` or `failed`
`message`	string or null	The headline to show the payer
`rows`	array	Ordered `label` and `value` pairs, printed as `label: value`

outcome

`status`	`outcome`
`paid`	`success`
`initiated`, `processing`, `pending`	`pending`
any other value	`failed`

message is params.respCode_desc when filled, otherwise action_code_description when filled, otherwise null. It is the return message the SATIM success and failed pages must show.

rows come in this order. A row with no value is left out.

`label`	`value`	Format
`ID de transaction`	`order_number`	As stored
`Numéro de commande`	`order_id`	As stored
`Numéro d'autorisation`	`approval_code`, otherwise `auth_code`	As stored
`Montant`	`amount`	`1 500,00 DZD`
`Carte`	`pan`	As stored
`Date`	`created_at`	`dd/mm/yyyy HH:mm`, Algiers time

Labels are in French and do not change. Every other attribute stays as before.

display-failed.json

{
  "outcome": "failed",
  "message": "Paiement refusé : CVV incorrect. Vérifiez et réessayez.",
  "rows": [
    { "label": "ID de transaction", "value": "1BU9MF7NVHA8WKKG8W8S" },
    { "label": "Numéro de commande", "value": "rAYKqByC6d1MLIAAF775" },
    { "label": "Montant", "value": "3 000,00 DZD" },
    { "label": "Carte", "value": "628070**5852" },
    { "label": "Date", "value": "05/04/2025 11:36" }
  ]
}