Pay by hosted invoice

This is how most orders are paid. You create an experiment, Adaptyv prices it into a quote, you confirm the quote, and Stripe issues a hosted invoice page for whoever pays your bills. No payment header, no wallet. You need a token whose role grants Quote:Update — Member, Billing, or Admin. Creating the experiment additionally needs Experiment:Create, which Member and Admin carry but Billing does not.

Create the experiment

Send no X-Adaptyv-Payment-Method header. Its absence selects this rail for an ordinary token and pins the experiment to it. If you hold a token issued with a machine payment policy, send X-Adaptyv-Payment-Method: async_invoice explicitly to get the hosted invoice.

curl -X POST "$FOUNDRY_API_URL/experiments" \
  -H "Authorization: Bearer $FOUNDRY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @experiment.json

Read the quote

curl "$FOUNDRY_API_URL/quotes/$QUOTE_ID" \
  -H "Authorization: Bearer $FOUNDRY_API_TOKEN"

curl -L "$FOUNDRY_API_URL/experiments/$EXPERIMENT_ID/quote/pdf" \
  -H "Authorization: Bearer $FOUNDRY_API_TOKEN" -o quote.pdf

Confirm the quote

Confirming finalizes the invoice. You may attach a purchase-order number, which appears on it. A JSON body is required either way — send {} if you have nothing to attach.

curl -X POST "$FOUNDRY_API_URL/quotes/$QUOTE_ID/confirm" \
  -H "Authorization: Bearer $FOUNDRY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"purchase_order_number": "PO-2026-00142"}'

{
  "id": "qt_1OqLk2...",
  "status": "accepted",
  "invoice_id": "in_1OqLk2LkdIwHu7ix6OboRpXl",
  "payment": {
    "kind": "hosted_invoice",
    "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1234/test_5678"
  }
}

Send hosted_invoice_url to whoever pays your bills. They can view the invoice, pay it with any method you have enabled, and download the PDF and receipt — see Stripe’s hosted invoice page.

Confirming is one-way. A second confirm on the same quote returns 409. To decline, call POST /quotes/{quote_id}/reject first.

Check that it settled

Payment happens on Stripe’s page, outside the API: there is no credential to submit and no endpoint that completes it. Stripe notifies the API when the money clears, and the invoice flips from open to paid.

curl "$FOUNDRY_API_URL/invoices/$INVOICE_ID" \
  -H "Authorization: Bearer $FOUNDRY_API_TOKEN"

curl -L "$FOUNDRY_API_URL/invoices/$INVOICE_ID/pdf" \
  -H "Authorization: Bearer $FOUNDRY_API_TOKEN" -o invoice.pdf

To remove the browser step, have an agent settle the invoice with x402 or MPP-SPT instead. Both are selected at experiment creation.

Getting Started

Payments

API Endpoints

Pay by hosted invoice

Pay by hosted invoice

Create the experiment

Read the quote

Confirm the quote

Check that it settled

​Pay by hosted invoice

​Create the experiment

​Read the quote

​Confirm the quote

​Check that it settled

Pay by hosted invoice

Create the experiment

Read the quote

Confirm the quote

Check that it settled