> For the complete documentation index, see [llms.txt](https://docs.intram.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intram.org/merchant-api-v1/transactions.md).

# Statut transactions

## `GET /transactions/:reference`

Renvoie les détails d'une transaction du marchand authentifié.

### Requête

```http
GET /v1/transactions/AB12CD34EF
X-Api-Key: …
X-Timestamp: …
X-Signature: …
```

`:reference` accepte :

* Le `_reference` public (10 chars alphanumériques)
* L'identifiant interne Mongo (24 hex)

### Réponse `200 OK`

```json
{
  "error": false,
  "http_status": 200,
  "data": {
    "reference": "AB12CD34EF",
    "status": "SUCCESS",
    "type": "CREDIT",
    "amount": 12000,
    "fees": 240,
    "net_amount": 11760,
    "currency": "XOF",
    "payment_method": "MTN Bénin",
    "customer": {
      "email": "client@example.com",
      "name": "Ada Lovelace"
    },
    "source": {
      "number": "22961234567"
    },
    "date": "2026-05-20T10:30:00.000Z",
    "refunds": [
      {
        "reference": "9DEFGH1234",
        "status": "SUCCESS",
        "reason": "Demande client",
        "date": "2026-05-20T11:45:00.000Z"
      }
    ]
  }
}
```

### Champs

| Champ                 | Type              | Description                                                           |
| --------------------- | ----------------- | --------------------------------------------------------------------- |
| `http_status`         | number            | Écho du code HTTP de la réponse                                       |
| `reference`           | string            | Référence publique de la transaction                                  |
| `status`              | string            | Statut courant (voir tableau ci-dessous)                              |
| `type`                | string            | `CREDIT`, `DEBIT` ou `REFUND`                                         |
| `amount`              | number            | Montant brut                                                          |
| `fees`                | number            | Frais appliqués                                                       |
| `net_amount`          | number            | Montant net après frais                                               |
| `currency`            | string \| null    | Code alphabétique de la devise (`XOF`, `EUR`, …)                      |
| `payment_method`      | string \| null    | Nom du moyen de paiement (`MTN Bénin`, `Moov Bénin`, `Carte Visa`, …) |
| `customer`            | object            | Coordonnées du client (`email`, `name`) — objet vide si non renseigné |
| `source.number`       | string \| null    | Numéro source de l'opération (mobile money), s'il est connu           |
| `date`                | string (ISO 8601) | Date de création de la transaction                                    |
| `refunds[]`           | array             | Liste des remboursements liés (vide si aucun)                         |
| `refunds[].reference` | string            | Référence publique du remboursement                                   |
| `refunds[].status`    | string            | Statut du remboursement                                               |
| `refunds[].reason`    | string \| null    | Motif du remboursement                                                |
| `refunds[].date`      | string (ISO 8601) | Date du remboursement                                                 |

### Statuts possibles

| `status`   | Sens                                            |
| ---------- | ----------------------------------------------- |
| `PENDING`  | Créée, en attente du paiement client / provider |
| `SUCCESS`  | Settled                                         |
| `ERROR`    | Échouée                                         |
| `REFUNDED` | Remboursée (totalement)                         |

### Erreurs

| Code                    | HTTP | Cas                                     |
| ----------------------- | :--: | --------------------------------------- |
| `transaction_not_found` |  404 | Référence inconnue ou pas à ce marchand |

***

## `GET /transactions`

Liste paginée des transactions du marchand, triée par création décroissante.

### Query params

| Param    | Type     | Description                                                       |
| -------- | -------- | ----------------------------------------------------------------- |
| `limit`  | int      | 1-100, défaut 20                                                  |
| `status` | string   | Filtre exact : `PENDING`, `SUCCESS`, `ERROR`, `REFUNDED`          |
| `type`   | string   | Filtre exact : `CREDIT`, `DEBIT`, `REFUND`                        |
| `before` | ISO 8601 | Curseur — renvoie les éléments créés strictement avant cette date |

### Réponse

```json
{
  "error": false,
  "http_status": 200,
  "data": [ /* tableau de transactions, format identique au get unitaire */ ],
  "paging": {
    "limit": 20,
    "next_before": "2026-05-19T12:34:56.000Z"
  }
}
```

`next_before` est `null` quand il n'y a plus de page suivante. Sinon, passez-le tel quel en `before` au prochain appel.

### Pagination type

```javascript
let cursor = null;
const all = [];
do {
  const url = `/transactions?limit=100${cursor ? `&before=${encodeURIComponent(cursor)}` : ''}`;
  const r = await signedGet(url);
  all.push(...r.data);
  cursor = r.paging.next_before;
} while (cursor);
```

## Voir aussi

* [Refunds](/merchant-api-v1/refunds.md) pour rembourser une transaction
* [Payment requests](/merchant-api-v1/payment-requests.md) pour créer une nouvelle transaction


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intram.org/merchant-api-v1/transactions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.