Skip to main content
GET
Consulter un lien de paiement
Cette opération ne demande aucune clé. Toute personne qui connaît la référence peut consulter l’état du lien et, une fois un paiement complété, les informations du payeur qu’il contient. Générez toujours cette référence de façon aléatoire et à forte entropie (voir Créer un lien de paiement hébergé), et ne la journalisez ni ne l’affichez dans un contexte accessible à un tiers non concerné par ce paiement.
  • Forme de la réponse. Elle dépend de l’état réel du lien : un paiement mené à son terme, un lien encore en attente d’un premier essai de paiement, ou un lien expiré sans paiement complété. Un remboursement effectué après coup ne modifie pas cette forme : cette opération n’est pas un indicateur fiable pour détecter un remboursement.
  • Lien expiré. Passé le délai de trente minutes sans paiement complété, la consultation répond toujours 200, avec has_expire à true et status à cancelled. Traitez cette forme comme un lien définitivement inutilisable, et non comme une erreur transitoire à retenter.
  • Référence inconnue. Une référence qui ne correspond à aucun lien renvoie 404. Comme l’opération est publique, une énumération par force brute est possible si la référence n’est pas assez aléatoire : c’est la raison de l’avertissement ci-dessus.
Messages d’erreur communs : Erreurs.

Path Parameters

reference
string
required

Référence privée à forte entropie, non publiée côté client.

Minimum string length: 32

Response

État du lien ou du paiement associé

Forme renvoyée lorsqu'un paiement a été mené à son terme pour ce lien. status ne peut alors valoir que succeeded ou failed : sur cette opération, jamais initiated, pending ni refunded. Cas limite : un paiement remboursé après coup n'est plus rattaché au lien, et l'opération renvoie alors la forme d'un lien encore en attente (status: initiated) au lieu d'exposer le remboursement — ne pas utiliser cette opération comme indicateur fiable de remboursement.

reference
string
amount
integer
country
string
currency
string
transaction_id
string
msisdn
string
customer_name
string
status
enum<string>
Available options:
succeeded,
failed
created_at
string<date-time>