Common errors and solutions

curl -X POST https://app.ligdicash.com/pay/v01/... \
  -H "Apikey: {API_KEY}" \
  -H "Authorization: Bearer {AUTH_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

function validateAmount(amount) {
  if (!Number.isInteger(amount)) throw new Error("Amount must be an integer");
  if (amount < 9)        throw new Error("Minimum amount: 9 CFA francs");
  if (amount > 2000000)  throw new Error("Maximum amount: 2,000,000 CFA francs");
}

// Periodic check of pending transactions
async function checkPendingTransactions() {
  const timeout = new Date(Date.now() - 15 * 60 * 1000); // 15 minutes

  const pendingTransactions = await db.transactions.findAll({
    where: {
      status: "pending",
      created_at: { [Op.lt]: timeout },
    },
  });

  for (const tx of pendingTransactions) {
    // Last call to confirm before giving up
    const confirm = await callConfirm(tx.ligdicash_token);

    if (confirm.status === "completed") {
      await tx.update({ status: "completed" });
    } else {
      // Still pending after 15 min → merchant-side timeout
      await tx.update({ status: "timeout" });
      await notifyCustomer(tx, "Your payment did not go through. Please try again.");
    }
  }
}

async function handleCallback(payload) {
  const transactionId = payload.custom_data?.find(
    e => e.keyof_customdata === "transaction_id"
  )?.valueof_customdata;

  const transaction = await db.transactions.findOne({
    where: { transaction_id: transactionId }
  });

  if (transaction?.status === "completed") {
    return res.status(200).send("OK"); // Already processed
  }

  // ... business logic
}

// On creation — store the transaction_id and the LigdiCash token
await db.transactions.create({
  transaction_id: "TXN-MY-INTERNAL-ID",  // your identifier
  ligdicash_token: response.token,         // LigdiCash creation token
  status: "pending",
});

// In the callback — look up by transaction_id, not by callback token
function extractTransactionId(callbackPayload) {
  const customData = callbackPayload.custom_data;
  if (!Array.isArray(customData)) return null;
  const entry = customData.find(e => e.keyof_customdata === "transaction_id");
  return entry?.valueof_customdata ?? null;
}

const transactionId = extractTransactionId(callbackPayload);
const transaction = await db.transactions.findOne({
  where: { transaction_id: transactionId }
});