Initiate Payment | Guiddini

Initiate Payment Endpoint

This endpoint allows you to initiate a payment by providing the amount to be paid. It returns a payment URL that can be used by your users to complete the payment.

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-app-secret	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://epay.guiddini.dz/api/payment/initiate', {
    amount: "2500",
    language: "fr" // or "en", "ar"
  }, {
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json',
      'x-app-key': 'YOUR_APP_KEY',
      'x-app-secret': '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)"
    }
  }
}