Aller au contenu principal

Transactions

Point de terminaison pour obtenir les transactions​

Récupérez une liste des transactions du marchand avec pagination.

Point de terminaison: GET /api/transactions

En-têtes:

Authorization: Bearer YOUR_API_TOKEN

Paramètres de requête:

  • page (nombre, facultatif): Numéro de page pour la pagination (par défaut: 1)
  • limit (nombre, facultatif): Nombre d'éléments par page (par défaut: 10)

Réponse:

{
  "status": "success",
  "message": "Transactions récupérées avec succès",
  "data": {
    "meta": {
      "total": 20,
      "per_page": 10,
      "current_page": 1,
      "last_page": 2,
      "first_page": 1,
      "first_page_url": "/?page=1",
      "last_page_url": "/?page=2",
      "next_page_url": "/?page=2",
      "previous_page_url": null
    },
    "data": [
      {
        "id": 1,
        "transactionId": 123,
        "type": "deposit",
        "merchantTokenId": 1,
        "userId": 1,
        "createdAt": "2024-01-15T10:00:00.000Z",
        "updatedAt": "2024-01-15T10:00:00.000Z",
        "transaction": {
          "id": 123,
          "userId": 1,
          "walletId": 1,
          "amount": 1000,
          "fee": 35,
          "type": "deposit",
          "status": "completed",
          "reference": "API_DEP_1_1234567890",
          "createdAt": "2024-01-15T10:00:00.000Z",
          "updatedAt": "2024-01-15T10:00:00.000Z"
        }
      }
    ]
  }
}

Point de terminaison pour obtenir une seule transaction​

Récupérez les détails d'une transaction marchande spécifique par son ID.

Point de terminaison: GET /api/transactions/:id

En-têtes:

Authorization: Bearer YOUR_API_TOKEN

Paramètres:

  • id (nombre, requis): L'ID de la transaction à récupérer.

Réponse:

{
  "status": "success",
  "message": "Transaction récupérée avec succès",
  "data": {
    "id": 1,
    "transactionId": 123,
    "type": "deposit",
    "merchantTokenId": 1,
    "userId": 1,
    "createdAt": "2024-01-15T10:00:00.000Z",
    "updatedAt": "2024-01-15T10:00:00.000Z",
    "transaction": {
      "id": 123,
      "userId": 1,
      "walletId": 1,
      "amount": 1000,
      "fee": 35,
      "type": "deposit",
      "status": "completed",
      "reference": "API_DEP_1_1234567890",
      "createdAt": "2024-01-15T10:00:00.000Z",
      "updatedAt": "2024-01-15T10:00:00.000Z"
    }
  }
}