UPT

Resources in Wiki

• Please choose the appropriate integration method based on your specific needs.

Hardware

• UPT terminals

OPC

• Payment process flowchart for open-door cabinets

• The default timeout for OPC is 3 minutes. How can I set it to never time out?

Set paymentTimeout=0.

• How do I change the logo at the bottom?

Set LogoUrl to the customized logo URL.

• ProtocolType defination in OPC

DEFAULT: For calling AIDL API of OPC CLOUD MODE: use paywizard payment SERIAL SLAVE: use usb cable SERAL HOST: use UUcable MDB: use MDB SERIAL EXT: use physical serial port SERIAL EXT2: user RJ45 serial port PULSE MODE: use pulse SOCKET SERVER: use network

Payment

• What parameters should be passed when canceling a pre-authorization? Is it TransIndexCode?

No, TransIndexCode is unique for each transaction, and its uniqueness is guaranteed by the third-party application itself, including transactions such as consumption, reversal, pre-authorization, pre-authorization incremention, and pre-authorization completion. For transactions requiring reversal, increment, or completion, the original transaction's TransIndexCode should be sent as OriTransIndexCode. Other original transaction data should be sent as Ori data: TraceNum->OriTraceNum, TransID->OriTransId, InvoiceNum->OriInvoiceNum, RRN->OriRrn.

• How long does it take from the pre-authorization amount being authorized to the actual deduction?

Generally, it's real-time. Pre-authorization is a freeze, and pre-authorization completion is an unfreeze, which can be understood as a consumption transaction with real-time deduction. Pre-authorization and pre-authorization completion may not happen simultaneously. For example, when staying at a hotel, a pre-authorization of 500 yuan is made today, and tomorrow when leaving the hotel, the pre-authorization is completed for 400 yuan. The money is deducted when the pre-authorization is completed.

• Canceling a pre-authorization:

TransType is Reversal

• After sending a pre-authorization request message, if the user does not swipe the card after a certain period, it will return "cancel". If the card is swiped, a response will be received immediately.

• Refund requires card swiping. However, in some versions of the refund process: if the order is already completed when sending the refund request, no card swiping is needed, and it will succeed immediately. If the order does not exist, it will wait for 1 minute and then return a timeout.

• Reversal and pre-authorization completion do not require card swiping.

• If a user spends two yuan, and we realize we made a mistake and need to refund 1 yuan

this scenario can be achieved by pre-authorizing 2 yuan and completing the pre-authorization for 1 yuan, or by consuming 2 yuan and reversing 1 yuan of the consumption.

• Can Reversal only reverse pre-authorizations that have already been swiped, because there is a TransID in this case? If the user has not swiped the card, how should this pre-authorization be canceled?

You can use the protocol data CTRL: 0xC1 to indicate a Cancel Request.

• After pre-authorization completion, no further additions can be made; it's equivalent to a completed deduction. Therefore, it's necessary to perform pre-authorization increment before the pre-authorization is completed; if you want to increase the deduction after completion, you must send a new pre-authorization and must swipe the card again, then pre-authorization completion; or send a card consumption transaction. Pre-authorization increment can be sent multiple times, but completion can only be sent once.

• Settlement: Is it performed once a day at a specified time?

Yes.

• When testing settlement, do we not need to send the amount? Should all unsettled transactions be automatically settled?

Yes, you don't need to send the amount.

• Currency and minimum unit reference: https://en.wikipedia.org/wiki/ISO_4217

• The transAmount is always passed as an integer string. The actual amount depends on the minimum unit specified above. For example, if the unit is 2, then the amount will have two decimal places.

• Can refund be called multiple times? For example, if 10 yuan was deducted, can it be refunded in three installments of 2, 6, and 2?

This is allowed for offline payments, but it depends on the specific payment channel. Most channels support this type of refund.

• Generally, when we talk about scanning codes, we're looking at it from the user's perspective. When a user scans a POS terminal, it's a user-initiated scan; conversely, being scanned means the user's device is being scanned. 2c2p uses user-initiated scanning. QR code payment involves scanning the QR code on the mobile phone; it won't be displayed on the POS machine. The payment demo doesn't support user-initiated scanning because this demo is offline and doesn't have a backend to query payment results. Mpay currently only supports being scanned (passive scanning, where the merchant actively scans the payment code displayed on the consumer's mobile phone).

• Are there any extra fees for refunds? Do you support partial refunds? What is the refund processing time?

Are there any extra fees for refunds? Do they support partial refunds? The refund processing time depends on the payment method and channel. Generally, there are no extra fees, and most methods support partial refunds. Refund times vary, ranging from instant processing to taking a day or up to 7 days, depending on the payment channel.

• What is the maximum amount for a pre-authorization? How can a pre-authorization be canceled?

There is generally no upper limit set for the pre-authorization amount, but it usually does not exceed the maximum amount for a single transaction at the terminal (default is 999999.99). The pre-authorized amount can be released through a pre-authorization cancellation. If using OPC, this would involve calling the Reversal transaction.

• Does a single POS terminal have a threshold for transactions awaiting settlement? If so, what is the threshold?

The settings for each channel are different, but generally the default is 500 transactions.

• If a payment deduction or refund fails, is it possible to return the specific reason through the API?

Generally, a return code and return message will be returned.

• Can a single pre-authorization be followed by multiple pre-authorization increment or pre-authorization completions (for example, due to insufficient funds or network issues causing transaction failure)?

This is also related to the payment channel; generally, one pre-authorization supports multiple subsequent transactions and is completed in a single process.

• When settlement, will the uncompleted pre-authorization transactions be automatically captured?

No

• if Purchased Amount > Pre-Auth Amount, then there will be a need to trigger a new sales transaction charge for remaining charge. Customer will need to tap the card again.