If you want to execute void from a web page, you`ll need to add this URL to your website.
Example:
<a href="myposapi://glass/1.0?action=com.mypos.transaction.VOID&request_code=103&app_id=yourwebsite.com&app_version=1.0.0&foreign_transaction_id=123test321&callback=https://www.yourwebsite.com/myposglassendpoint">Start myPOS Void</a>
Method properties
|
Property |
Typical value |
Type |
Condition |
Description |
|---|---|---|---|---|
| action |
com.mypos.transaction.VOID or com.mypos.transaction.VOID_EX |
String | Mandatory |
Action Type: Void last transaction The other action is to Void a specific transaction that has mandatory parameters stan, authorization_code and transfer_date_time |
| request_code | 103 | Integer | Mandatory | Void request code |
| app_id | yourwebsite.com | String | Mandatory | Web site domain or application package name. |
| app_version | 1.0 | String | Mandatory | Version code of the application. |
| stan | 27 | Integer | Optional | Response parameter from the original transaction with the same key name. |
| authorization_code | VISSIM | String | Optional | Response parameter from the original transaction with the same key name. |
| transfer_date_time | 180129123753 | String | Optional | Response parameter from the original transaction with the same key name. |
| foreign_transaction_id | 123test321 | String | Optional | Unique transaction id for request/response matching. |
| skip_confirmation_screen | true/false | Boolean | Optional | A flag that skips the confirmation screen. |
| callback | https://www.yourwebsite.com/myposglassendpoint | String | Optional | URL that will be executed with response parameters after successful or unsuccessful payment. |
Handle the result
Make sure that the callback URL you provide is correct and controlled by you.
Example of Approved transaction:
{CALLBACK_URL}?status=0&status_text=TRANSACTION_SUCCESS&transaction_approved=true&foreign_transaction_id=123test321
Example of Declined transaction:
{CALLBACK_URL}?status=2&status_text=TRANSACTION_DECLINED&transaction_approved=false&foreign_transaction_id=123test321
Response properties
|
Property |
Typical value |
Type |
Condition |
Description |
|---|---|---|---|---|
| status | 0 | Integer | Mandatory | One of the constants in the Transaction Processing Result Class |
| status_text | TRANSACTION_SUCCESS | String | Mandatory | A textual representation of the status in Transaction Processing Result Class |
| transaction_approved | true/false | Boolean | Mandatory | Transaction Status Indicator |
| foreign_transaction_id | 123test321 | String | Optional | Unique transaction id for request/response matching |
