What the model is told
Look up a Stripe invoice by its ID (it starts with in_). Use it when the customer asks whether an invoice has been paid or how much is due. Check the customer_email in the response matches the email the customer gives before sharing details. Report the status (draft, open, paid, void or uncollectible), the amount due and paid, the currency (amounts are in the smallest unit, so 2000 GBP is 20.00) and the hosted_invoice_url if present. Do not read out any other fields.
Request
GEThttps://api.stripe.com/v1/invoices/{{invoiceId}}
Headers
AuthorizationBearer YOUR_STRIPE_SECRET_KEY
Parameters
invoiceId stringThe Stripe invoice ID.
Engage payload
{
"source": "VOICE_AI",
"tool": {
"id": "20160f27-6bcd-4f55-b33e-00db458a4d87",
"type": "HTTP_REQUEST",
"label": "Get Stripe Invoice",
"name": "get_stripe_invoice",
"customName": false,
"description": "Look up a Stripe invoice by its ID (it starts with in_). Use it when the customer asks whether an invoice has been paid or how much is due. Check the customer_email in the response matches the email the customer gives before sharing details. Report the status (draft, open, paid, void or uncollectible), the amount due and paid, the currency (amounts are in the smallest unit, so 2000 GBP is 20.00) and the hosted_invoice_url if present. Do not read out any other fields.",
"parameters": [
{
"name": "invoiceId",
"type": "string",
"description": "The Stripe invoice ID."
}
],
"config": {
"endpoint": {
"method": "GET",
"url": "https://api.stripe.com/v1/invoices/{{invoiceId}}"
},
"headers": [
{
"name": "Authorization",
"value": "Bearer YOUR_STRIPE_SECRET_KEY"
}
],
"body": null,
"timeout": null
}
}
}IDs are regenerated on every copy.