API 4: POS Initiate Transaction

Through this API interface, you will be able to initiate a transaction from your Point Of Sale system or web platform.

This API is for Point of Sale system

The payment terminal which receiving the transaction request is the one binded to the POSID which belongs to the merchant.

Initiate a Transaction

Test Enviroment:

POST https://oversea.paywizard.biz/ovstrade/semiOpen/internetTrans

Production Enviroment:

POST https://portal.paywizard.biz/ovstrade/semiOpen/internetTrans

Headers

Name	Value
Content-Type	application/json
jwt-token	The token responesed from Get Access Token

Request Body

Name	Type	Mandatory	Description
clientId	string		Developer ID
merchantId	String		Merchant ID
posId	String		POSID
tradeNo	String		Third-party POS systems order numbers, must be unique under the same ISO/ISV.
transType	String		See support transaction type
transScheme	String		{Credit,Debit,EBT,ECS} Default can be Credit if not sure
callerName	String		Merchant Name
transAmount	Long		This is the final total transaction amount. Mandatory if it is a financial transaction. The number of decimal places is determined by the CurrencyCode.
otherAmount	Long		Cash back amount
tipAmount	Long		Tip amount
currencyCode	String		Currency Code Mandatory if it is a financial transaction.
reqTransDate	String		Trans Date (YYYYMMDD)
reqTransTime	String		Trans Time(hhmmss)
oriTransIndexCode	String		Origin Transaction Index Code
oriTraceNum	String		Origin Transaction Trace Number
oriInvoiceNum	String		Origin Transaction Invoice Number
oriTransId	String		Origin Transaction ID
oriRrn	String		Origin Transaction Reference Number
enableReceipt	boolean		{false,true} Print receipt flag: false: do not print, true: print.
appendingReceiptInfo	String		Additional information to print on the receipt.
skipConfirmProcedure	boolean		{false,true} Skip confirmation step: false: do not skip. true: skip
callBackUrl	String		If the POS system is cloud-based, the transaction result can be obtained through this URL. Please see: Transaction result callback interface

Request Sample

{
    "clientId": "client12345",
    "merchantId": "10800000003",
    "posId": "POS12345",
    "tradeNo": "2024081210800000003001",
    "transType": "Purchase",
    "transScheme": "Credit",
    "callerName": "Caller001",
    "transAmount": 10000,
    "otherAmount": 0,
    "tipAmount": 0,
    "currencyCode": "156",
    "reqTransDate": "20240812",
    "reqTransTime": "144400",
    "enableReceipt": true,
    "appendingReceiptInfo": "",
    "skipConfirmProcedure": true
}

Response Body

Name	Type	Mandatory	Description
code	int		Response Code (200 Success, Non-200 Failed)
msg	String		Response Message
timestamp	String		Date/Time(UTC)

Response Sample

200

{
    "code": 200,
    "msg": "200",
    "timestamp": "2024-08-12 14:45:54"
}