Ajouter un produit
POST/v1/products
Un produit de votre catalogue : ce que vous vendez, et comment il se paie.
Son type ne changera plus : ses prix et ses ventes en dépendent. Ajoutez-lui ensuite ses prix.
Les en-têtes
Idempotency-KeytexteConseillée : rejouée, la même clé rend la première réponse au lieu de refaire le geste.
Idempotency-KeytexteConseillée : rejouée, la même clé rend la première réponse au lieu de refaire le geste.
Ce qu’on envoie
Un corps JSON. Ce qui n’est pas requis peut être omis.
nameREQUIStexteLe nom du produit.
descriptiontexteCe que vous en dites.
typeREQUIS« one_time » · « open » · « subscription » · « usage »Comment il se paie. Il ne changera plus : ses prix et ses ventes en dépendent.
activevrai ou fauxEn vente d’office. Faux : créé hors de la vente.
nameREQUIStexteLe nom du produit.
descriptiontexteCe que vous en dites.
typeREQUIS« one_time » · « open » · « subscription » · « usage »Comment il se paie. Il ne changera plus : ses prix et ses ventes en dépendent.
activevrai ou fauxEn vente d’office. Faux : créé hors de la vente.
La demande
bash
curl https://api.payiz.app/v1/products \
-H "Authorization: Bearer sk_test_…" \
-H "Idempotency-Key: catalogue-creer-01" \
-H "Content-Type: application/json" \
-d '{
"name": "Pagne wax 6 yards",
"description": "Coton imprimé, bleu indigo.",
"type": "one_time"
}'La réponse
json
{
"object": "product",
"id": "prd_01j9xm2hp7t4wzq6vc3k",
"name": "Pagne wax 6 yards",
"description": "Coton imprimé, bleu indigo.",
"type": "one_time",
"active": true,
"archived_at": null,
"prices": [
{
"object": "price",
"id": "prx_01j9xm3kq8v2tzr5wd7n",
"product": "prd_01j9xm2hp7t4wzq6vc3k",
"label": "À l’unité",
"amount": 10000,
"currency": "XOF",
"period": "one_time",
"unit": null,
"note": null,
"active": true,
"archived_at": null,
"created": 1789740092,
"livemode": false
}
],
"created": 1789740092,
"livemode": false
}Ce qu’on reçoit
201 · un objet product
object« product »Le genre de l’objet rendu : il ne change jamais.
idtexteUn identifiant préfixé « prd_ », par exemple prd_01j9xm2hp7t4wzq6vc3k.
nametexteLe nom du produit, tel que le client le lit.
descriptiontexte ou nullCe que vous en dites.
type« one_time » · « open » · « subscription » · « usage »Comment il se paie : « one_time » une fois, « open » au prix que le payeur choisit, « subscription » par période, « usage » selon ce qui est consommé. Il ne change plus : ses prix et ses ventes en dépendent.
activevrai ou fauxEn vente, ou retiré de la vente.
archived_atentier ou nullQuand il a été archivé ; null tant qu’il ne l’est pas.
pricesliste de objetSes prix, du plus ancien au plus récent. Un produit « open » n’en a aucun.
createdentier ou nullDes secondes depuis 1970, ou null.
livemodevrai ou fauxFaux en mode test : aucun argent ne circule.
object« product »Le genre de l’objet rendu : il ne change jamais.
idtexteUn identifiant préfixé « prd_ », par exemple prd_01j9xm2hp7t4wzq6vc3k.
nametexteLe nom du produit, tel que le client le lit.
descriptiontexte ou nullCe que vous en dites.
type« one_time » · « open » · « subscription » · « usage »Comment il se paie : « one_time » une fois, « open » au prix que le payeur choisit, « subscription » par période, « usage » selon ce qui est consommé. Il ne change plus : ses prix et ses ventes en dépendent.
activevrai ou fauxEn vente, ou retiré de la vente.
archived_atentier ou nullQuand il a été archivé ; null tant qu’il ne l’est pas.
pricesliste de objetSes prix, du plus ancien au plus récent. Un produit « open » n’en a aucun.
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.