Create POS Payment

This feature is designed to enable brick-and-mortar stores and in-person service providers to accept cryptocurrency payments through a streamlined, real-time process.

With the POS Payments API, you can:

• Create quick, one-time payment requests for in-person transactions

• Generate QR codes and payment links to share directly with customers

• Manage POS payment states (underpaid, overpaid, or fully paid) to simplify transaction tracking

Whether you’re a retail store, café, or service-based business, the POS Payments API makes it easy to expand payment options for your customers and take advantage of the flexibility crypto payments offer. Dive in to learn how to set up your POS system with WCT Pay!

POST payment-pos/post

Request Body

Name	Type	Description
asset*	String	The asset you would like to settle in your account
asset_network	String	The network you would like your customer to pay in (Required when the asset is Tether)
requested_asset*	String	The asset you would like your customer to pay in
requested_asset_network	String	The network of requested asset you would like your customer to pay in (Required when the requested_asset is Tether)
amount*	String	Amount you like to receive in the settlement asset
cart_items	Object	item_name,item_desc,item_quantity,unit_price (DVD1,Movie Name,1,80)
description*	String	Description of Payment
reference*	String	Your payment reference
postback_url	String	After postback please return a response JSON { status: “ok” }. We will try 10 attempts until response received
pos_price_update_postback_url	Strng	Price Update URL (posted at quote expiry)
personal_fname	String	Customer Firstname
personal_lname	String	Customer Lastname
personal_address	String	Street Address & Number
personal_city	String	Customer City
personal_state	String	Customer State
personal_country	String	Country, ISO 3166 2 digit code
personal_postcode	String	Postcode / ZIP code
personal_mobile	String	Customer's Mobile Number (incl. country code) e.g. [phone]
personal_dob	String	Customers Date of Birth YYYY/MM/DD
key*	String	Merchant's Terminal API ID
hash*	String	MD5 Hash key+asset+amount+api_secret

200: OK POS Payment Failed

{
  "status": "nok",
  "error": "The asset not allow for POS create payment"
}

201: Created Successfully Created

{
    "paymentId": "67bfc5f2d389ed389e1806f9",
    "payment_code": "qBBiRwD4G9",
    "payment_address": "0x62ba1ef84aac42c6b34d8c03b83f5951ccce29b9",
    "payment_amount": "1049.59",
    "payment_missing_amount": "549.59",
    "payment_amount_asset": "USDT",
    "expires_at": 1740707698,
    "exchange_rate": "1.003",
    "message": "Get pos payment update successfully",
    "status": "ok"
}

Example

Create a Payment & Show Customer QR and Address

An example of how this API can be used is if a merchant would like to receive $50.00 USD and the customer would like to pay using their own Bitcoin balance. In this scenario, the merchant can request asset=USD and requested_asset=BTC.

This will result in a response containing a BTC payment address, amount of BTC required to complete the payment, the time until the price expires, and a price update request will be required or you can use the postback price update response that is sent to your specified postback_url at the expiry time.