Documentation/Lire une conversion
openapi.jsonOuvrir mon espace

Lire une conversion

GET/v1/conversions/{id}

Une conversion, et le taux qu’elle a pris.

La demande

bash
curl https://api.payiz.app/v1/conversions/cnv_01j9xk5tm2p7rdb4wq8c \
  -H "Authorization: Bearer sk_test_…"

La réponse

json
{
  "object": "conversion",
  "id": "cnv_01j9xk5tm2p7rdb4wq8c",
  "from_currency": "XOF",
  "to_currency": "GHS",
  "amount": 100000,
  "amount_received": 2471,
  "rate": 0.02471,
  "fee": 500,
  "created": 1790009892,
  "livemode": false
}

Ce qu’on reçoit

200 · un objet conversion

object« conversion »Le genre de l’objet rendu : il ne change jamais.
idtexteUn identifiant préfixé « cnv_ », par exemple cnv_01j9x3kq7m4tzv8qhw2n.
from_currencytexteLa monnaie vendue.
to_currencytexteLa monnaie reçue.
amountentierCe qui a quitté le portefeuille de départ.
amount_receivedentierCe qui est arrivé dans l’autre portefeuille.
ratenumberLe taux appliqué : combien d’unités reçues pour une vendue.
feeentierLes frais de change, dans la monnaie vendue.
createdentier ou nullDes secondes depuis 1970, ou null.
livemodevrai ou fauxFaux en mode test : aucun argent ne circule.
© 2026 PayizUne question ? L’aide est dans le rond, en bas à droite.

Lire une conversion

GET/v1/conversions/{id}

Une conversion, et le taux qu’elle a pris.

La demande

bash
curl https://api.payiz.app/v1/conversions/cnv_01j9xk5tm2p7rdb4wq8c \
  -H "Authorization: Bearer sk_test_…"

La réponse

json
{
  "object": "conversion",
  "id": "cnv_01j9xk5tm2p7rdb4wq8c",
  "from_currency": "XOF",
  "to_currency": "GHS",
  "amount": 100000,
  "amount_received": 2471,
  "rate": 0.02471,
  "fee": 500,
  "created": 1790009892,
  "livemode": false
}

Ce qu’on reçoit

200 · un objet conversion

object« conversion »Le genre de l’objet rendu : il ne change jamais.
idtexteUn identifiant préfixé « cnv_ », par exemple cnv_01j9x3kq7m4tzv8qhw2n.
from_currencytexteLa monnaie vendue.
to_currencytexteLa monnaie reçue.
amountentierCe qui a quitté le portefeuille de départ.
amount_receivedentierCe qui est arrivé dans l’autre portefeuille.
ratenumberLe taux appliqué : combien d’unités reçues pour une vendue.
feeentierLes frais de change, dans la monnaie vendue.
createdentier ou nullDes secondes depuis 1970, ou null.
livemodevrai ou fauxFaux en mode test : aucun argent ne circule.