1 of 1

POS iFrame

POS iFrame allows the POS platform to show an iFrame that contains multiple flows with a single API call, without implementing multiple API's for each flow.

Flows supported

Cancel transaction
Send SMS message to consumer
Manual credit card number entry
QR display for consumer scanning
Timeout logics
SensePass Tag pairing

Usage

Create a transaction
From the create transaction API - get the value of transactionPage.merchantPage.POS

Example:

{
    "TransactionNumber": "5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a",
    "date": "2023-01-15T15:54:10.736Z",
    "amount": "12",
    "baseAmount": "12",
    "currency": "ILS",
    "status": 0,
    "statusName": "Initialize",
    "timeoutDate": "2023-01-15T16:04:11.141Z",
    "methodType": 0,
    "businessId": "1",
    "businessName": "SensePass IL",
    "pos": "SensePass IL",
    "businessOwnerPhone": "0505555555",
    "businessCountry": "Israel",
    "businessCity": "Tel Aviv",
    "businessState": "misisipi",
    "businessStreet": "Menachem Begin",
    "businessAddress": "Tel Aviv, Menachem Begin 0",
    "branchNumber": "144",
    "branchId": "144",
    "branch": {
        "number": "144"
    },
    "receiptPending": true,
    "productSumMismatch": true,
    "paymentMethodData": {
        "PaymentType": "Bit",
        "directAppLinks": {
            "iOSLink": "https://pay.sandbox.sensepass.com/orderSummary/5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a",
            "androidLink": "https://pay.sandbox.sensepass.com/orderSummary/5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a",
            "qrURL": "https://pay.sandbox.sensepass.com/orderSummary/5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a"
        }
    },
    "transactionPage": {
        "consumerPage": {
            "regular": "https://pay.sandbox.sensepass.com/orderSummary/5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a",
            "medium": "https://pay.sandbox.sensepass.com/orderSummary/5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a?viewMode=medium",
            "small": "https://pay.sandbox.sensepass.com/orderSummary/5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a?viewMode=small"
        },
        "merchantPage": {
            "creditCard": {
                "small": "https://api.sandbox.sensepass.com/api/transactions/sensepass-pci/credit-card/5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a?viewMode=small",
                "regular": "https://api.sandbox.sensepass.com/api/transactions/sensepass-pci/credit-card/5a961cebd09a1c07c76e36d810c4049878de6b7134fcd7e00fa2ed5a"
            },
            "POS": {
                "regular": "https://pos.sandbox.sensepass.com?mode=transaction&transactionEventId=961ddd23-8c30-4f01-850c-dc19348a48ff-7d792564-ec08-4ae0-83b0-86d4841be055"
            }
        }
    }
}

3. Show in the POS an iFrame with the URL

4. Listen to transaction status events to be notified about approval, timeout and errors