Developers

Use Case Example

A common scenario where the Deep Links API is useful:

1. Customer browses products online

A customer visits the merchant’s website to explore available items.

2. Customer visits the store to purchase

Instead of checking out online, the customer goes to the merchant’s physical location to make the purchase.

On the merchant’s mobile device, the website (or PWA) sets up a shopping cart, then issues a deep link to trigger the myPOS Glass app’s payment screen with the appropriate transaction details.

4. In-person payment is completed

The customer taps their contactless card on the device to pay.

5. Order is fulfilled

The transaction is completed, and the merchant hands over the purchased items.

Benefits

  • Frictionless handover from online to physical payment
  • Enables hybrid shopping models (online browsing, offline payment)
  • Reduces manual entry or duplication between app systems
  • Simplifies the checkout experience for in-person payments

Implementation

Performing the Payment

To execute a payment from a web page, add the deep link URL to your website as an anchor tag.

Example:

<a href="myposapi://glass/1.0?action=com.mypos.transaction.START_TRANSACTION&request_code=101&amount=1.23&currency=EUR&app_id=yourwebsite.com&app_version=1.0.0&foreign_transaction_id=123test321&callback=https://www.yourwebsite.com/myposglassendpoint">Start myPOS Payment</a>

Handling the Result

Ensure that the callback URL you provide is correct and controlled by you. The myPOS Glass app will redirect to this URL with transaction result parameters.

Example of an approved transaction:

{CALLBACK_URL}?status=0&status_text=TRANSACTION_SUCCESS&transaction_approved=true&foreign_transaction_id=123test321&stan=6&date_time=211123172012&authorization_code=074114

Example of a declined transaction:

{CALLBACK_URL}?status=2&status_text=TRANSACTION_DECLINED&transaction_approved=false&foreign_transaction_id=123test321