Suivre un paiement depuis le navigateur
GET/v1/widget/payments/{id}
Le seul appel sans clé : le secret du client ouvre ce paiement-là, et rien d’autre.
Posez « client_secret », rendu une seule fois à la création. La réponse dit si c’est payé — ni métadonnées, ni référence, ni frais. Ne livrez jamais sur la seule foi du navigateur : le webhook fait foi.
Ce qu’on met dans l’adresse
client_secretREQUIStexteLe secret rendu à la création du paiement.
client_secretREQUIStexteLe secret rendu à la création du paiement.
La demande
bash
curl https://api.payiz.app/v1/widget/payments/pay_01j9x3kq7m4tzv8qhw2n
La réponse
json
{
"object": "payment",
"id": "pay_01j9x3kq7m4tzv8qhw2n",
"amount": 10000,
"currency": "XOF",
"status": "succeeded",
"description": "Commande 42",
"amount_paid": 10000,
"paid_at": 1790002912,
"created": 1790002692,
"livemode": false
}Ce qu’on reçoit
200 · un objet payment
object« payment »Le genre de l’objet rendu : il ne change jamais.
idtexteUn identifiant préfixé « pay_ », par exemple pay_01j9x3kq7m4tzv8qhw2n.
amountentierUn entier, dans l’unité mineure de la devise.
currencytexteLe code ISO 4217, en majuscules.
status« requires_payment » · « processing » · « succeeded » · « expired » · « canceled » · « partially_refunded » · « refunded »Où en est le paiement.
descriptiontexte ou nullCe que le payeur lit sur sa page.
amount_paidentier ou nullCe que le payeur a versé, frais compris.
paid_atentier ou nullDes secondes depuis 1970, ou null.
createdentier ou nullDes secondes depuis 1970, ou null.
livemodevrai ou fauxFaux en mode test : aucun argent ne circule.
object« payment »Le genre de l’objet rendu : il ne change jamais.
idtexteUn identifiant préfixé « pay_ », par exemple pay_01j9x3kq7m4tzv8qhw2n.
amountentierUn entier, dans l’unité mineure de la devise.
currencytexteLe code ISO 4217, en majuscules.
status« requires_payment » · « processing » · « succeeded » · « expired » · « canceled » · « partially_refunded » · « refunded »Où en est le paiement.
descriptiontexte ou nullCe que le payeur lit sur sa page.
amount_paidentier ou nullCe que le payeur a versé, frais compris.
paid_atentier ou nullDes secondes depuis 1970, ou null.
createdentier ou nullDes secondes depuis 1970, ou null.
livemodevrai ou fauxFaux en mode test : aucun argent ne circule.
Enchaîner les pages
Tant que has_more est vrai, rappelez avec starting_after réglé sur l’identifiant de la dernière ligne lue. Les listes vont du plus récent au plus ancien.
© 2026 PayizUne question ? L’aide est dans le rond, en bas à droite.