operator products

Utilisez cet endpoint pour les paiements de factures basés sur des produits et pour les opérateurs dont les produits représentent des banques ou d’autres destinations.

GET /api/v1/payment/funds-transfer/operator/products?operatorId=ELECTRICITY HTTP/1.1
Host: api.example.com
Authorization: Bearer <access-token>
Accept: application/json

curl --get "https://api.example.com/api/v1/payment/funds-transfer/operator/products" \
  --header "Authorization: Bearer ${QOS_ACCESS_TOKEN}" \
  --header "Accept: application/json" \
  --data-urlencode "operatorId=ELECTRICITY"

Réponse réussie — HTTP 200

{
  "data": [
    {
      "productName": "Prepaid Electricity",
      "description": "Prepaid meter token",
      "productCode": "ELEC_PREPAID",
      "minPrice": "1000",
      "maxPrice": "50000",
      "currency": "NGN",
      "actualPrice": null
    }
  ],
  "message": "Success",
  "success": true,
  "responseCode": "00"
}

Champ	Signification
productName	Nom d’affichage. Ne l’envoyez pas comme identifiant du produit.
description	Description du produit ou de la destination.
productCode	Valeur à transmettre comme productCode dans les requêtes de validation et d’initiation.
minPrice	Montant minimum autorisé lorsqu’il est renseigné.
maxPrice	Montant maximum autorisé lorsqu’il est renseigné.
currency	Devise du produit. Elle doit correspondre à la devise de la transaction.
actualPrice	Prix fixe obligatoire lorsqu’il est renseigné ; sinon, choisissez un montant dans la plage configurée.

Les messages HTTP 400 possibles incluent Operator not found, Could not instantiate provider, No products found ainsi que des messages de disponibilité du provider. Rafraîchissez d’abord la liste des opérateurs. Si l’opérateur reste présent dans la liste mais que la découverte des produits échoue de manière répétée, suspendez ce parcours produit.