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

<figure><img src="https://3556089516-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbqMA3Kf8t2xEX9F6y9%2Fuploads%2Fzmtf4CbejmaM7pPOBZL6%2FScreenshot%202025-04-08%20at%2011.58.38.png?alt=media&#x26;token=7e1b18c5-1cb5-4521-8200-444edeb2075f" alt=""><figcaption></figcaption></figure>

### 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](https://docs.sensepass.com/sensepay/transaction-api/payment-flows/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](https://docs.sensepass.com/sensepay/transaction-api/api-notifications) to be notified about approval, timeout and errors