> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quivr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HiPay

> Vérification des transactions et paiements HiPay

export const ToolUsage = ({name, description, arguments: args = {}, response = {}}) => {
  const argsJson = JSON.stringify(args, null, 2);
  const responseJson = JSON.stringify(response, null, 2);
  return <div className="border border-zinc-200 dark:border-zinc-700 rounded-xl p-5 my-4 bg-white dark:bg-zinc-900/50">
      {}
      <div className="flex items-center gap-2 mb-1">
        <span className="font-mono font-semibold text-base text-blue-500 dark:text-blue-400">
          @{name}
        </span>
      </div>

      {}
      {description && <p className="text-zinc-500 dark:text-zinc-400 text-sm m-0 mb-4 leading-relaxed">
          {description}
        </p>}

      {}
      <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
        <div className="flex flex-col">
          <span className="text-xs font-medium text-zinc-400 dark:text-zinc-500 mb-1.5 uppercase tracking-wide">
            Arguments
          </span>
          <pre className="font-mono text-xs bg-zinc-50 dark:bg-zinc-800/70 p-3 rounded-lg m-0 overflow-x-auto flex-1 text-zinc-600 dark:text-zinc-300 border border-zinc-100 dark:border-zinc-700/50">
            {argsJson}
          </pre>
        </div>

        <div className="flex flex-col">
          <span className="text-xs font-medium text-zinc-400 dark:text-zinc-500 mb-1.5 uppercase tracking-wide">
            Response
          </span>
          <pre className="font-mono text-xs bg-zinc-50 dark:bg-zinc-800/70 p-3 rounded-lg m-0 overflow-x-auto flex-1 text-zinc-600 dark:text-zinc-300 border border-zinc-100 dark:border-zinc-700/50">
            {responseJson}
          </pre>
        </div>
      </div>
    </div>;
};

export const WorkflowExample = ({title, whenToUse, steps = []}) => {
  const parseToolMentions = text => {
    if (!text) return text;
    const parts = text.split(/(@[\w-]+)/g);
    return parts.map((part, i) => {
      if (part.startsWith("@")) {
        const toolName = part.slice(1);
        return <span key={i} className="text-blue-500 dark:text-blue-400 font-semibold bg-blue-50 dark:bg-blue-950/50 px-1.5 py-0.5 rounded text-[0.9em] whitespace-nowrap">
            @{toolName}
          </span>;
      }
      return part;
    });
  };
  return <div className="my-6 border-2 border-dashed border-zinc-300 dark:border-zinc-600 rounded-xl p-6">
      {}
      <h3 className="text-xl font-semibold text-zinc-900 dark:text-zinc-100 m-0 mb-5">
        {title}
      </h3>

      {}
      <div className="mb-6">
        <span className="text-sm font-medium text-zinc-500 dark:text-zinc-400 block mb-2">
          When to use
        </span>
        <div className="border border-zinc-200 dark:border-zinc-700 rounded-lg p-4 bg-zinc-50/50 dark:bg-zinc-800/30">
          <p className="m-0 text-zinc-700 dark:text-zinc-300 leading-relaxed">
            {whenToUse}
          </p>
        </div>
      </div>

      {}
      <div>
        <span className="text-sm font-semibold text-zinc-900 dark:text-zinc-100 block mb-4">
          Steps
        </span>
        <div className="flex flex-col gap-4">
          {steps && steps.map((step, index) => <div key={index} className="flex gap-3 items-start">
              <span className="flex items-center gap-1.5 flex-shrink-0 pt-0.5">
                <span className="text-blue-500 dark:text-blue-400 font-medium text-sm tabular-nums">
                  {index + 1}.
                </span>
              </span>
              <span className="text-zinc-700 dark:text-zinc-300 leading-relaxed">
                {parseToolMentions(step)}
              </span>
            </div>)}
        </div>
      </div>
    </div>;
};

<Note>
  Cette intégration nécessite une activation. Contactez **[support@quivr.app](mailto:support@quivr.app)** pour l'activer.
</Note>

## Outil disponible

### @get\_hipay\_transaction\_by\_reference

Récupère les détails d'une transaction HiPay par sa référence.

<ToolUsage name="get_hipay_transaction_by_reference" description="Recupere les details d'une transaction HiPay par son ID de transaction" arguments={{ transaction_id: "TXN-12345" }} response={{ status: "captured", amount: 99.99, currency: "EUR", payment_method: "CB" }} />

## Données retournées

| Donnée           | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| `status`         | Statut du paiement (authorized, captured, refused, refunded) |
| `amount`         | Montant de la transaction                                    |
| `currency`       | Devise (EUR, USD...)                                         |
| `date`           | Date de la transaction                                       |
| `payment_method` | Moyen de paiement utilisé (CB, PayPal...)                    |
| `reason`         | Raison en cas d'échec                                        |

## Exemple de workflow complet

<WorkflowExample
  title="Verification paiement HiPay"
  whenToUse="Quand le client demande des informations sur son paiement HiPay"
  steps={[
"Le client demande des informations sur son paiement",
"Utilise @get_ticket pour trouver la reference de paiement",
"Utilise @get_hipay_transaction_by_reference",
"Si 'captured' : Paiement recu, commande en cours",
"Si 'authorized' : Paiement en attente de capture",
"Si 'refused' : Paiement refuse, proposer alternative",
"Si 'refunded' : Remboursement effectue, donner la date"
]}
/>

## Statuts de paiement

| Statut             | Signification                            |
| ------------------ | ---------------------------------------- |
| Authorized         | Paiement autorisé, en attente de capture |
| Captured           | Paiement validé et encaissé              |
| Refused            | Paiement refusé par la banque            |
| Refunded           | Transaction remboursée                   |
| Partially refunded | Transaction partiellement remboursée     |