> For the complete documentation index, see [llms.txt](https://experience.wallex.global/wallex-pay/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://experience.wallex.global/wallex-pay/merchant-tools/invoice-builder.md). # Invoice Builder Send your customers a link to complete a payment in crypto. {% tabs %} {% tab title="Invoice Basics" %} ### Invoice Basics *** Creating a crypto invoice is straightforward with our builder. Here's a quick overview of the essential fields: * **Merchant ID**\*: Unique identifier for your account, ensuring payments are directed correctly. * **Request Amount**\*: The total amount to be paid in cryptocurrency. * **Invoice**\*: A reference or invoice number for tracking the transaction. * **Tax Amount**: Specify any applicable taxes to be added to the total. * **Collect Shipping Address**: Option to request the buyer's shipping details. * **Shipping Cost**: Add any shipping charges to the invoice. * **IPN URL (Optional)**: Provide a custom URL for instant payment notifications, or leave blank to use the default. * **Allow Buyer to Leave a Note**: Enable this to let buyers add special instructions or comments. This guide ensures you set up your invoices accurately, making the payment process seamless for both you and your customers. {% hint style="info" %} For a full list of fields and detailed information please check out the [HTML POST Fields](/wallex-pay/merchant-tools/invoice-builder.md#html-post-fields) page. {% endhint %} {% endtab %} {% tab title="HTML POST Fields" %} ### Simple HTML POST Fields *** If you need a checkout with more options such as buyer selectable quantity, multiple item shipping, etc. check out our[ Advanced Buttons](/wallex-pay/merchant-tools/payment-buttons.md#advance-button-maker). **Main Fields**

Field Name	Description	Required?	Length Limit
cmd	This should always be set to '_pay_simple'.	Yes	N/A
reset	This tells the server to delete any cached button data for the user. Set the value to 1	Yes	1
merchant	Your merchant ID (you can find this on the My Account page).	Yes	N/A

**Item/Payment Description Fields**

Field Name	Description	Required?	Length Limit
currency	The currency of the payment (BTC, LTC, USD, EUR, etc.). Values supported: Any crypto or fiat currency on the Supported Coins page. Note we in no way process any fiat currencies, they are simply convenience values so you don't have to convert to BTC or another coin yourself.	Yes	3
amountf	The amount (in the currency chosen) of the payment.	Yes	N/A
item_name	The name of the item being purchased.	Yes	128
item_desc	Description of the item being purchased.	No	128
item_number	This is a passthru variable for your own use. [not visible to buyer]	No	128
invoice	This is a passthru variable for your own use. [not visible to buyer]	No	128
custom	This is a 2nd passthru variable for your own use. [not visible to buyer]	No	128
allow_currencies	Currency codes separated with a comma of coins you will accept. This is used to further restrict the coin selection from your list of enabled coins; for example if you are doing your own exchange rates and want to limit checkout to a user selected currency. Example: BTC,LTC	No	255
on1	1st option name. This lets you pass through a buyer option like size or color.	No(unless ov1 set)	128
ov1	1st option value. This would be the buyer's selection such as small, large, red, white.	No	128
on2	2nd option name. This lets you pass through a buyer option like size or color.	No(unless ov2 set)	128
ov2	2nd option value. This would be the buyer's selection such as small, large, red, white.	No	128

**Shipping Fields**

Field Name	Description	Required?	Length Limit
want_shipping	1 = Want buyer's shipping information.0 = Don't want buyer's shipping information. (default)	No	1
shippingf	Cost of shipping the item.	No	N/A
taxf	Any tax to charge.	No	N/A
allow_ship_countries	ISO 3166 2 digit country codes separated with a comma of countries you will ship to. The will deny transactions if the shipping address is not in one of these countries. Example: US,CA,GB	No	255

**Miscellaneous Fields**

Field Name	Description	Required?	Length Limit
ipn_url	Sets an IPN URL.If not set or blank defaults to the IPN URL in your settings.	No	255
success_url	Sets a URL to go to if the buyer does complete checkout.	No	255
cancel_url	Sets a URL to go to if the buyer decides to not complete checkout.	No	255
lang	Automatically set the checkout language to this language code. For a list of supported codes check this page.	No	16

**Buyer Information. These fields can be used to pre-populate forms with any information you already know about your buyer.**

Field Name	Description	Required?	Length Limit
first_name	Buyer's first name.	No	32
last_name	Buyer's last name.	No	32
email	Buyer's email address.	No	128
address1	Street / address line 1	No	128
address2	Street / address line 2	No	128
city	City	No	64
state	State / Province	No	64
zip	Zip / Postal Code	No	32
country	Country of Residence This uses 2 digit ISO 3166 country codes.	No	2
phone	Phone Number	No	32

{% hint style="info" %} **Note**: The system will only let you have 3 transactions at a time in the 'Waiting for funds...' state (as a buyer, no limit for sellers) {% endhint %} {% endtab %} {% endtabs %}