Devis et tarifs
Confirmez le prix et la durée avant de commander une eSIM.
Créer un devis
POST /quotes
Permission :
orders:writeUn devis est valable 5 minutes et ne débite pas votre solde. Le prix est calculé à partir du tarif fournisseur à jour, majoré de 10 %.
curl -X POST 'https://esimy.siraj-ai.com/api/v1/quotes' \
-H "Authorization: Bearer $ESIMY_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"packageCode":"CODE_CATALOGUE","days":1}'| Champ | Type | Description |
|---|---|---|
packageCode | string, obligatoire | Valeur code obtenue dans le catalogue. |
days | integer, facultatif | Forfait journalier : de 1 à 365, 1 par défaut. Pour un forfait classique, la durée catalogue s’applique et ce champ n’allonge pas sa validité. |
Réponse · 201
{
"id": "aq_EXEMPLE",
"packageCode": "CODE_CATALOGUE",
"name": "France 1 GB · 7 jours",
"days": 1,
"daily": false,
"feeUnits": 10000,
"amountUnits": 110000,
"currency": "USD",
"expiresAt": "2026-11-17T12:05:00Z"
}Dans cet exemple, amountUnits = 110000 représente 11 USD, dont 1 USD de frais eSIMY (feeUnits = 10000). Ce prix est illustratif.
Expiration et changement de prix
Si le devis expire, créez-en un nouveau. Si le prix fournisseur change avant la création de la commande, l’API retourne 409 price_changed. Présentez le nouveau prix au client avant de poursuivre.
Conservez le
id du devis pour le transmettre comme quoteId à la création de commande.