Invoice hosted page
An invoice hosted page is a web page that you can embed into your website to display the payment details of a particular invoice to a customer.
There is a hosted_page_url attribute in the invoice details that contains its hosted page URL.
{
"data": {
"id": "dad9c70c-959b-45b8-abe8-f56d7f9b7ceb",
"custom_id": "12398123981722",
"customer_id": null,
"subscription_id": null,
"status": "new",
"status_context": null,
"address": "0x492cBb7092f178fcC6973BBf2396F7436e5cfF25",
"network": "bnb_smart_chain",
"uri": "0x492cBb7092f178fcC6973BBf2396F7436e5cfF25",
"price_amount": "20.0",
"price_currency": "EUR",
"pay_amount": "22.207418",
"pay_currency": "USDC",
"fee": "0.2",
"fee_currency": "EUR",
"paid_amount": "0.0",
"exchange": {
"pair": "USDCEUR",
"rate": "0.9006",
"fee": "0.0",
"fee_currency": "EUR"
},
"transactions": [],
"name": null,
"description": null,
"metadata": null,
"success_redirect_url": null,
"unsuccess_redirect_url": null,
"hosted_page_url": "https://hosted-page.minfeesandbox.com/invoices/dad9c70c-959b-45b8-abe8-f56d7f9b7ceb",
"created_at": "2025-04-23T08:23:56+00:00",
"expires_at": "2025-04-23T08:33:56+00:00"
}Settings
You can apply different settings to hosted pages appearance like a specific locale by adding its acronym to the end of the hosted_page_url value via a query parameter. For example:
https://hosted-page.minfeesandbox.com/invoices/8c2f5e91-5fec-4e73-b61a-c900d817bbac?locale=jp
Below is a list of variables you can use.
locale
string
Can be en, de, fr, es, pt, ru and jp which means English, German, French, Spanish, Portuguese, Russian or Japanese language.
If parameter is not set, the language will be taken from the browser settings.
back_button
boolean
Show/hide a back button on the page. This might be useful if you redirect customers to hosted pages. false if set by default
Transaction created
As soon as a sender broadcasts the transaction, you'll receive a callback with the following attributes:
"event": "transaction_created"
Status changed
You'll receive one more callback when the invoice changes its status to one of the final ones (completed or refunded) upon transaction confirmation:
"event": "status_changed"
Invoice expired
Last updated