Créer une ligne de facture avec l'API Stripe

Ajoute une ligne à une facture brouillon, avec une description et un montant dans la plus petite unité de la devise, comme les centimes. Envoyez amount, ou unit_amount_decimal avec quantity. Sans invoice, la ligne attend la prochaine facture du client.

Identifiant
stripe_create_invoice_item

L'appel

POST https://connect.reportei.com/api/tools/stripe_create_invoice_item/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "customer": "<customer>"
  }
}

Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.

Paramètres

Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.

ParamètreTypeObligatoireDescription
customerstringOuiId of the customer billed, starting with cus_, the same as the invoice, from Search customers or Create customer.
invoicestringNonId of the draft invoice, starting with in_, from Create invoice or Search invoices.
descriptionstringNonText of the line, shown on the invoice.
amountintegerNonTotal of the line in the smallest unit of the currency, for example 15000 for BRL 150.00. A negative amount lowers the invoice total.
unit_amount_decimalstringNonPrice of one unit in the smallest unit of the currency, as a decimal string like 1500.5, multiplied by quantity. Use it instead of amount.
quantityintegerNonNumber of units, with unit_amount_decimal. The default is 1.
currencystringNonThree-letter currency code in lowercase, for example brl. It must match the currency of the invoice.

Connexions possibles

Votre client connecte son compte Stripe une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.

Clé d'API

Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.

La réponse

En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.

Prête pour les agents IA

L'input de cette tool est un JSON Schema, disponible via GET /api/tools/stripe_create_invoice_item. Il devient la définition de tool de votre agent sans conversion.

Autres tools Stripe

Voir les 12 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.