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

Point of Sale (POS)

Accept crypto payments in person using a our PoS interface.

Point of Sale Interface


The POS interface is designed to be a simple way to accept in-person payments. Here is the preferred way to use the interface.

Start by bookmarking your POS checkout URL on your phone/tablet. [If you log in to your account and return to this page we will have your checkout URL here for you.]

When a customer wants to pay, simply:

  • Open your saved checkout page and enter the customer's total then click Next.

  • If you are accepting more than Bitcoin ask the customer which coin they would like to pay with and select it for them, then click Next.

  • The status page will have a QR code on it, display this to the buyer so they can scan it with their phone to pay the balance.

  • Watch the status page until it indicates they have sent funds, depending on the amount of the order you may want to wait for the payment to be Complete in case of any issues.

WARNING: If you do choose to accept payment without confirms make sure the amount they sent matches the total expected!

POS HTML POST Fields


Main Fields

Field Name
Description
Required?
Length Limit

cmd

This should always be set to '_pos'.

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, ETH and 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

5

amountf

The amount (in the currency chosen) of the payment.

Yes

N/A

Optional/Informational Fields

Field Name
Description
Required?
Length Limit

allow_amount

1 = Allow buyer to adjust item price. (default) 0 = Don't allow buyer to adjust item price.

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

1

allow_currency

0 = Don't allow buyer to adjust source currency (default). 1 = Allow buyer to adjust source currency.

No

255

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.

No

255

ipn_url

Sets an IPN URL. If not set or blank defaults to the IPN URL in your settings.

No

255

lang

Automatically set the checkout language to this language code. For a list of supported codes check this page.

No

16

cstyle

Automatically set the checkout language to this language code. For a list of supported codes check this page.

No

16

Miscellaneous Fields

Field Name
Description
Required?
Length Limit

ipn_url

Sets a coin selection style for the checkout page. (default: grid1) Warning: Other styles may not look right, they are untested

No

32

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

email

Buyer's email address.

No

128

POS Link & QR Code Generator


Creating a Point of Sale (POS) link and QR Code with our generator is easy. Here's a quick overview of the essential fields:

  • Merchant ID*: Unique identifier for your account, ensuring payments are directed correctly.

  • Payment Description*: This field allows you to provide a clear description of the payment or transaction.

  • Initial Amount*: The total amount to be paid in cryptocurrency.

  • Allow Buyer to Change the Currency: Enable this to let buyers change the cryptocurrency.

This guide ensures you set up your invoices accurately, making the payment process seamless for both you and your customers.

POS Button Example


When a customer wants to pay, simply:

  • Enter the Amount: Input the desired amount in the designated field.

  • Click the [Continue] Button: Press the [Continue] button to proceed to the next step.

  • View Payment Details: You will be redirected to the payment screen displaying key information, including the QR Code, Amount, Address, and Payment ID.

Note: Keep in mind that you have 5 minutes to complete the payment. If the transaction is not completed within this time, the session will expire, and you may need to restart the process.

PreviousInvoice BuilderNextPre-Built Plugins

Last updated 8 months ago

Feel free to check our our .

example buttons