Embedded Crypto Invoice

Overview

Meaning and scope

An embedded crypto invoice is a payment interface presented inside the merchant’s website or application rather than on a separately hosted page. It can display the amount, supported asset and network, destination, QR code, expiration, and live status while preserving the merchant’s surrounding user experience.

Mechanism and operation

The merchant application obtains invoice data from a trusted server or payment API and renders it through a component, SDK, iframe, or native interface. For Embedded Crypto Invoice, payment-critical values should originate from an authoritative server record, not editable browser parameters. Specific scope: a payment interface presented inside the merchant’s website or application a separately hosted page. Governance should connect Embedded Crypto Invoice to the original obligation, payment instructions, observed transaction, internal state, financial posting, and any fulfillment or refund. The decisive principle remains that an embedded invoice keeps checkout in the merchant experience but must obtain all authoritative payment data and status from trusted server-side systems.

Practical payment example

A merchant embeds a hosted payment panel inside its order page. The backend binds invoice identity and callback status to the order while treating cross-origin frame messages as untrusted unless authenticated.

Operational checks

A secure embedding flow keeps the merchant order identifier on the server and obtains invoice state from an authenticated backend. A parent page should restrict which frames or scripts it can load, validate any cross-window messages and avoid using unverified client data as the source of payment truth. During mobile-wallet handoffs, the embedded view may disappear; reopening it must restore the same unpaid invoice rather than generating an unintended duplicate.

Distinctions and limits

It differs from a hosted invoice, where the provider owns the complete payment page, and from a redirect invoice, where the customer leaves the merchant interface to pay.

Related reading

Related definitions: Hosted Crypto Invoice, Redirect Crypto Invoice.