Chargement de vos clés API…

Ajouter un article au catalogue

POSThttps://api.mobupay.nc/api/v1/billing/catalog

Ce que fait cet appel

Ajoute un élément. Modifier son prix ensuite ne change aucune facture, même en brouillon : les lignes copient les valeurs du catalogue au moment où elles sont ajoutées. C'est ce qui permet de faire évoluer ses prix sans réécrire son historique.

En-tête d'authentification

Authorization: Bearer sk_test_XXXX

Le pool est déduit du préfixe de la clé

Il n'y a pas d'interrupteur test et production sur cette page. sk_test_* ne traite aucun paiement réel, sk_live_* encaisse.

Corps de la requête

application/json

typestringRequis

Détermine l'exigibilité de la taxe sur les lignes issues de cet élément.

labelstringRequis

descriptionstringOptionnel

unitstringOptionnel

unitPriceCentsintegerRequis

Prix unitaire HT, dans la plus petite unité de la devise.

currencystringOptionnel

defaultTaxTypeIdsarray[string]Optionnel

Taxes proposées par défaut sur les lignes issues de cet élément.

internalRefstringOptionnel

Votre référence interne. Unique par marchand.

Codes de retour

201

Élément créé.

409

CATALOG_FULL : plafond de 1 000 éléments atteint, ou référence interne déjà utilisée.

Langage

Requête cURLpostExemple

1curl --request POST \

2 --url https://api.mobupay.nc/api/v1/billing/catalog \

3 --header 'authorization: Bearer sk_test_XXXX' \

4 --header 'content-type: application/json' \

5 --data '{ "type": "SERVICE", "label": "Prestation de conseil", "unit": "day", "unitPriceCents": 25000, "currency": "XPF", "internalRef": "CONS-J" }'

Réponse

Cliquez sur Essayer pour lancer la requête et voir la réponse ici.