API Integration

Authentication

To use our API, you must first register on epay.guiddini.dz. Upon registration, you will receive a Secret Key and an App Key. These credentials must be kept private and secure.

Initiate Payment

Endpoint

POST /api/payment/initiate

Headers

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

Example Usage in Different Languages

Request Body

example.js

const axios = require('axios');
 
async function initiatePayment() {
  const response = await axios.post('[https://api.example.com/payment/initiate](https://api.example.com/payment/initiate)', {
    data: {
      type: "transaction",
      id: "YIFXM5E7ZA8KWS8C4SC4",
      attributes: {
        amount: "2500"
      }
    }
  }, {
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json',
      'x-app-key': 'YOUR_APP_KEY',
      'x-secret-key': 'YOUR_SECRET_KEY'
    }
  });
  console.log(response.data);
}
 
initiatePayment();

Response

response.json

{
  "data": {
    "type": "transaction",
    "id": "YIFXM5E7ZA8KWS8C4SC4",
    "attributes": {
      "amount": "2500",
      "status": "processing",
      "form_url": "[https://test.satim.dz/payment/merchants/merchant1/payment_fr.html?mdOrder=Tox9krS9mLPdCUAAF2U4](https://test.satim.dz/payment/merchants/merchant1/payment_fr.html?mdOrder=Tox9krS9mLPdCUAAF2U4)"
    }
  }
}