Invoice Payment Widget

Overview

Invoice Payment Widget is a hosted checkout page that lets customers pay invoices through Calypso UI.

Use the widget when you want to create a payment session through API and then redirect the customer to a ready-to-use Calypso checkout page or embed it into the merchant website with an iframe.

Supported payment methods

Payment method	Description
Crypto payment	Customer sends funds to the invoice address shown in the widget.
MetaMask	Customer pays from a MetaMask wallet, where supported.
WalletConnect	Customer connects a wallet through WalletConnect.
TON Connect	Customer connects a TON wallet through TON Connect.

Widget type

Widget type	When to use	Creation method
SINGLE_FIAT	One payment where the amount is set in fiat and paid in one of the allowed cryptocurrencies.	[POST] payment-widget/single-fiat/create

Test widget

You can try the test payment widget here: https://pay.calypso.money/pay?isTest=true.

Guides

Guide	Description
How to create an Invoice Payment Widget via API	Create a widget, build the widget URL, embed it with iframe, and track invoice payment status.
Invoice Payment Widget webhooks	Track invoice events created from a payment widget.

Related API methods

API	Link
Payment Widget API	Payment Widget API reference
Invoice API	Invoice API reference
Webhook API	Webhook API reference