Receipts

The moment a payment is confirmed, AgentaOS emails the buyer a receipt. You don’t trigger it and don’t need to build it: it’s automatic, tied to the invoice, and always available to re-send if the buyer loses it.

A receipt exists for every paid invoice. If an invoice was issued before receipts existed on your account, getReceipt falls back to the invoice PDF, so the method always returns something useful.

Download the receipt PDF

SDK
CLI
cURL

import { writeFileSync } from 'fs';

const pdf = await agentaos.invoices.getReceipt('invoice-uuid');
writeFileSync('receipt.pdf', pdf);

agenta invoices receipt invoice-uuid -o receipt.pdf

curl https://api.agentaos.ai/api/v1/gateway/invoices/invoice-uuid/receipt \
  -H "x-api-key: sk_live_..." \
  -o receipt.pdf

Resend the receipt email

Re-sends to whichever email address is on file for the buyer, the same address the original receipt went to. Only works for paid invoices: there’s nothing to send a receipt for on an unpaid or voided one.

SDK
CLI
cURL

const result = await agentaos.invoices.sendReceipt('invoice-uuid');
console.log(result.sentTo); // the email it was sent to

agenta invoices send-receipt invoice-uuid

curl -X POST https://api.agentaos.ai/api/v1/gateway/invoices/invoice-uuid/send-receipt \
  -H "x-api-key: sk_live_..."

Response

boolean

Always true on success.

string

The email address the receipt was (re-)sent to.

Next steps

Invoices

Every receipt is tied to an underlying invoice.

Customers

Where the buyer’s email on file comes from.

Webhooks

React to checkout.session.completed the moment a receipt goes out.

Getting Started

Build with AI agents

Sell

Merchant of Record

Webhooks

For customers

Legacy

Download the receipt PDF

Resend the receipt email

Response

Next steps

Invoices

Customers

Webhooks

​Download the receipt PDF

​Resend the receipt email

​Response

​Next steps

Invoices

Customers

Webhooks

Download the receipt PDF

Resend the receipt email

Response

Next steps