Error handling — Overview

async function initiatePayment(payload) {
  const res = await fetch("https://app.ligdicash.com/pay/v01/straight/checkout-invoice/create", {
    method: "POST",
    headers: {
      "Apikey": process.env.LIGDICASH_API_KEY,
      "Authorization": `Bearer ${process.env.LIGDICASH_AUTH_TOKEN}`,
      "Accept": "application/json",
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  });

  const data = await res.json();

  if (data.response_code === "01") {
    // Level 1 — immediate rejection
    logger.error({
      event: "ligdicash_request_rejected",
      subcode: data.response_text,  // e.g. "Echec (Code00)"
      wiki: data.wiki,              // URL for the human-readable description
    });
    throw new Error(`Request rejected: ${data.response_text}`);
  }

  // response_code === "00": transaction initiated
  // Store the token for callback re-verification
  await db.transactions.create({
    transaction_id: payload.custom_data[0].valueof_customdata,
    ligdicash_token: data.token,
    status: "pending",
  });

  return data;
}