Aller au contenu
HPay Developers
English
Référence de l'API marchande

Authentification

L'API marchande sert à vos serveurs et à vos terminaux de paiement agréés. Pour encaisser sur un site ou dans une application, commencez par la passerelle de paiement. Voir la passerelle

Conventions

POSThttps://api.hpay.cash/…/

Erreurs communes

Ces codes peuvent être renvoyés par tous les points d'accès qui utilisent un jeton (sauf le remboursement, qui a sa propre numérotation).

error_codeCauseQue faire
5Nombre de clés incorrect.Envoyer exactement les clés listées.
10Clé inattendue.Vérifier l'orthographe des clés.
20Valeur requise vide.Remplir la valeur ; le champ concerné est nommé dans message.
30Clé API inconnue.Vérifier api_key / main_api_key.
31Jeton tronqué ou invalide.Redemander un jeton.
32Jeton expiré.Redemander un jeton.
41Mode différent de celui de vos clés.Aligner mode.
50Clé secrète ou publique incorrecte.Vérifier vos clés.
60Jeton émis pour une autre action.Demander un jeton avec la bonne action.

Obtenir un jeton

POSThttps://api.hpay.cash/token/

Chaque opération demande un jeton récent, propre à l'action. Il est créé avec vos trois clés et reste valable 5 minutes (15 minutes pour les lectures). Demandez-en un nouveau avant chaque opération.

Paramètres (JSON)

api_keyrequisstring Votre clé API.
api_secret_keyrequisstring Votre clé secrète.
api_public_keyrequisstring Votre clé publique.
moderequisstring test ou live, comme vos clés.
actionrequisstring L'opération visée, indiquée sur chaque point d'accès : payment, refund, history, get_balance, submarchant, newaccount, deposit, withdraw, check-card, transfert, withdraw-code, addBank, list-banks, delete-bank, add-withdraw, all-withdraw, cancel-withdraw.
curl -X POST https://api.hpay.cash/token/ \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_API_KEY",
  "api_secret_key": "YOUR_SECRET_KEY",
  "api_public_key": "YOUR_PUBLIC_KEY",
  "mode": "test",
  "action": "payment"
}'
Réponse
{
  "success": true,
  "message": "Token generated",
  "token": "TVlYb2ZhZ0x…",
  "livetime": "3mn",
  "time_generated": 1763474820,
  "error_code": 0
}

Erreurs propres à ce point d'accès

error_codeHTTPCause
30200Clé API inconnue.
40200Le mode ne correspond pas à vos clés.
50200Clé secrète ou publique incorrecte.
60200Action inconnue.

Suite : Paiements →