Skip to main content
Version: Current guides

Create invoices, quotes and adjustments

Availability and terminology​

Merchant access to invoices, quotes, credit notes, hosted payment pages and automatic conversion remains unconfirmed. Use these steps only after the relevant features are enabled; they do not establish public management APIs. “Invoice” here means a business collection document, without a promise that it is a local tax invoice.

Quote acceptance, invoice finalization, an invoice recorded as paid and on-chain receipt are separate facts. Check each independently. For currently confirmed one-time collection, use Checkout rather than waiting for unconfirmed billing modules.

Prepare and send an invoice​

  1. Select the correct customer and check name, contact, currency, due date and applicable business terms.
  2. Add products or supported custom items and review quantity, unit price, discount, tax and total. Keep one currency throughout the document.
  3. Save a draft and inspect its preview. Ensure the customer-facing amount matches the agreement before finalizing through the available screen.
  4. Send the actual generated payment entry or document and retain its version, invoice number and original order association. Use automatic charging only when both capability and customer authorization are confirmed.
  5. After payment, inspect the related payment result and remaining balance. Sending an email or opening a page does not establish receipt.

Move a quote toward a sale​

  1. Define the customer, expiry, items, prices, currency and one-time or recurring charges. Check for an existing quote first.
  2. Review the draft, then send the generated customer entry for review of terms. “Sent” does not mean accepted.
  3. Retrieve the actual accepted, declined or expired state. After acceptance, inspect whether invoices or subscriptions were really created and verify their payment and authorization. Acceptance alone does not authorize delivery.
  4. If content changes, retain the old version and use the supported revision process. Check whether the old version is invalid and tell the customer which version to use.
  5. For mixed one-time and recurring items, inspect every resulting resource so conversion does not duplicate reported revenue.

Adjust amounts and handle support​

Check edit restrictions before changing a finalized document; do not rewrite historical payment facts. If credit notes are enabled, distinguish reducing amounts due, adding customer credit and returning funds. Reconcile each outcome separately: credit is not an on-chain refund, and an invoice cleared by credit does not establish a new payment of the same amount.

Returning funds still requires the access and execution conditions in refunds. A created credit note does not establish refund completion.

Resolve exceptions​

SituationNext action
Expired link or superseded versionFind the latest valid version instead of asking the customer to pay under old instructions
Accepted quote without follow-up recordsRetain the quote ID and time and investigate conversion; do not request duplicate acceptance or payment
Underpayment or excess fundsInspect real payments and the remaining balance using payment exceptions, without applying old order states
Manual paid markerUse only when supported and backed by real accounting evidence, recording the reason; it does not create an on-chain transaction
Missing emailVerify the contact and actual delivery result, then resend through a confirmed route without creating another invoice

Use reports to separate quoted value, amounts due, receipts, credits and refunds, retaining original versions and handling associations.

Record external payments, voiding and uncollectible balances​

Use these operations only when the corresponding invoice capabilities are enabled. They do not change Checkout state rules:

  1. Before recording an external payment, obtain verifiable bank or on-chain evidence. Check customer, currency, confirmed amount, receipt time and invoice balance, and exclude a payment already recorded or matched automatically. A customer screenshot alone does not justify a paid marker.
  2. If recording payments is offered, enter the actual amount, date, transaction association and necessary note within the current allowance. Do not allocate an already-recorded payment twice. After partial payment, verify paid and remaining balances rather than treating one successful entry as full payment.
  3. Before voiding, inspect the document source, payments and allowed actions and confirm effects on customer access and amounts due. Record a reason and submit only if permitted; subscription- or quote-derived invoices may have additional restrictions.
  4. If an uncollectible or bad-debt marker is offered, obtain finance review and approval, record evidence and verify actual collection and customer-entry behavior. The marker neither refunds funds nor reverses existing payment facts.
  5. Reopen only where supported, inspecting existing payments and amounts due to avoid duplicate collection. After any timeout, reload the original invoice and payments before recording or voiding again.

Retain separate records for credits, external payments, voids and uncollectible balances. Reconcile receipts, credits, allowances and unpaid amounts separately rather than counting all of them as new on-chain revenue.