# Invoice Creation The **«Invoices»** section of the merchant dashboard is designed for managing payment requests issued to customers. In this section, the merchant can create new invoices and track the full transaction history of all payments. ### **Creating an Invoice** To create an invoice, click the **«New Invoice»** button. A modal window will appear with the invoice creation form. The first step is to select the address type: * **Temporary address** – a one-time address that remains active for a defined period (30 minutes by default). Suitable for one-off payments. * **Static address** – a permanent address that can receive multiple incoming payments and stays active until manually deactivated by the merchant. The set of available fields and the address logic differ depending on the selected address type. #### Temporary address
The modal contains the following fields for the merchant to fill out: | Field | Required | Description | | -------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Amount USDT** | Required | The amount to be paid for this invoice (in USD/USDT). | | **Include fees in the invoice amount** | Optional |

The fee forwarding flag adds the service fee to the invoice amount.

If this option is active, the service fee is added to the invoice total and is paid by the buyer.

| | **Allowed Currencies** | Required |

Selector of allowed payment currencies. Options:
• TRX
• USDT (TRC-20)
• TRX and USDT (TRC-20): both tokens are accepted.

| | **Expiry (minutes)** | Optional | The duration for which the invoice remains active. Default is **30 minutes**. | | **Order ID** | Optional | The order identifier in the merchant's system. | | **Redirect URL** | Optional | URL to which the payer will be redirected after completing the payment. | | **Webhook URL** | Optional | URL where goodPayments will send the payment notification once the payer completes the invoice. | | **Comment** | Optional | Order description. May include any specific information related to the payment. | After completing all required fields, click **«Create»**. The newly created invoice will appear in the payment history table in the **«Invoices»** section. #### Static address
A static address is a permanent address for receiving payments that stays active until manually deactivated. Unlike a temporary address, it has no expiration time and can receive an unlimited number of payments. The modal contains the following fields: | Field | Required | Description | | ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | **Allowed Currencies** | Required |

Selector of allowed payment currencies. Options:
• TRX
• USDT (TRC-20)
• TRX and USDT (TRC-20): both tokens are accepted.

| | **Order ID** | Optional | The order identifier in the merchant's system. | | **Webhook URL** | Optional | URL where goodPayments will send the payment notification once the payer completes the invoice. | | **Comment** | Optional | Order description. May include any specific information related to the payment. | The **Expiry (minutes)** field is not available for static addresses – invoices of this type have no expiration time. {% hint style="info" %} The payment window link for a static address never expires and does not display a countdown timer. The link becomes inactive only after the merchant deactivates the address. {% endhint %} **Deactivating a static address** – to stop accepting payments on a static address, the address must be deactivated. This is done using the **«Cancel»** button located in the **«Actions»** column of the invoices table. ### **Payment History** The payment history is displayed as a table containing records of all invoices created by the merchant. The table includes the following columns: * **Invoice ID** – unique identifier of the invoice. Clicking the ID opens the detailed invoice page. * **Payment Link** – link to the payment window of the invoice, with a **«Copy»** button for convenience. * **Payment Transaction** – link to the hash of the incoming transaction associated with this invoice. * **Address** – the address generated for receiving funds from the payer. * **Address Type** – temporary or static. * **Time** – date and time when the invoice was created. * **Payment Currencies** – currencies allowed for payment. * **Network** – the blockchain network used for receiving funds. * **Status** – the current status of the invoice. * **Amount** – the expected payment amount. * **Actions** – button to cancel the invoice. ### **Invoice Details** After an invoice is created, the merchant can access a detailed invoice page by clicking the invoice ID in the payment history table. The detailed invoice page contains five main blocks: #### **1. General Information** Includes: * Invoice ID * Current status * Date and time of creation * Expiration date and time * Date and time of the last status update * Link to the transaction hash of the temporary address activation * Link to the payment window * Address type * Order ID in the merchant's system * Allowed payment currencies #### **2. Amounts** Displays the requested and actual amounts: * Expected payment amount * Amount received * Amount forwarded to the merchant * Invoice comment (if none was provided, displays “No comment”) #### **3. Transactions** Contains blockchain data on both receiving and forwarding operations: * Link to the transaction hash of the incoming payment * Link to the transaction hash of the forwarded payment * Receiving addresses – the payer’s address and the temporary address generated for the invoice * Forwarding addresses – the temporary invoice address and the merchant’s payout address For static addresses, transactions are displayed in a modal window accessible by clicking the **«View Transactions»** button. The modal includes additional data: * Amount received per transaction * Payment currency #### **4. Redirects and Webhooks** Includes URLs: * Redirect URL where the payer is sent after completing the payment * Webhook URL where goodPayments sends the payment notification #### **5. AML Check** When the AML checks feature is enabled, an additional AML block is displayed. Clicking the **«View AML Checks»** button redirects the merchant to the **«AML»** section of the dashboard. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://goodpayments.gitbook.io/docs/user-guide/invoice-creation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.