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

  1. Cancel transaction

  2. Send SMS message to consumer

  3. Manual credit card number entry

  4. QR display for consumer scanning

  5. Timeout logics

  6. SensePass Tag pairing

Usage

  1. Create a transaction

  2. 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

Last updated