Wallex Pay
Sign InSign Up
  • Welcome
  • Product Introduction
  • Get Started
  • Integration Guide
  • Account Creation
    • Individual/Freelance Account
    • Business Account
  • Verification Process
    • Need Assistance?
      • Starting Point
      • Common Rejection Causes
      • Proof of Address (POA)
      • Pending Verification
      • Session Expired?
  • Supported Coins
  • Merchant Tools
    • Payment Buttons
    • Custom APIs
      • API Basics
      • Informational Commands
      • Receiving Payments
      • Withdrawals/Transfers
    • Instant Payment Notification (IPN)
    • Invoice Builder
    • Point of Sale (POS)
    • Pre-Built Plugins
  • Mass Payouts
  • API Keys Management
  • Integration Testing & Testnet
  • Profile Management
    • Manage Personal Info
    • Wallet Statement
  • Access Issues
    • Why my Account is Blocked/Suspended?
  • Security
    • Account Security
    • Two-Factor Authentication (2FA)
    • Hacked Account
  • Fees & Limits
  • Legal & Regulatory
    • Restricted Jurisdictions
    • User Agreement
    • Privacy Policy
  • Contact our Experts
Powered by GitBook
On this page
  1. Merchant Tools

Invoice Builder

Send your customers a link to complete a payment in crypto.

PreviousInstant Payment Notification (IPN)NextPoint of Sale (POS)

Last updated 8 months ago

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.

For a full list of fields and detailed information please check out the page.

Simple HTML POST Fields


If you need a checkout with more options such as buyer selectable quantity, multiple item shipping, etc. check out our.

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

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)

HTML POST Fields
Advanced Buttons