Stripe

Get Stripe Invoice

Checks the status and amount of one invoice by its ID.

Unverified

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.