{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml","oas-api/index.yaml":"oas-api/index.yaml"},"props":{"metadata":{"markdoc":{"tagList":["ApiLink","admonition","tabs","tab","openapi-code-sample","code-snippet","cards","card"]},"type":"markdown"},"seo":{"title":"POS Quickstart","description":"Connect your POS system to Finix: power on your terminal, create and activate a device, and process your first payment.","siteUrl":"https://docs.finix.com/","llmstxt":{"hide":false,"sections":[{"title":"Getting Started","includeFiles":["guides/getting-started/**/*.md"],"excludeFiles":[]},{"title":"Online Payments","includeFiles":["guides/online-payments/**/*.md"],"excludeFiles":["guides/online-payments/payment-features/fsa-hsa-non-healthcare-mcc.md"]},{"title":"In-Person Payments","includeFiles":["guides/in-person-payments/**/*.md"],"excludeFiles":[]},{"title":"Subscriptions","includeFiles":["guides/subscriptions/**/*.md"],"excludeFiles":[]},{"title":"After the Payment","includeFiles":["guides/after-the-payment/**/*.md"],"excludeFiles":[]},{"title":"Managing Operations","includeFiles":["guides/managing-operations/**/*.md"],"excludeFiles":[]},{"title":"Platform Payments","includeFiles":["guides/platform-payments/**/*.md"],"excludeFiles":[]},{"title":"Payouts","includeFiles":["guides/payouts/**/*.md"],"excludeFiles":[]},{"title":"Low-Code / No-Code","includeFiles":["low-code-no-code/**/*.md"],"excludeFiles":[]},{"title":"Developers","includeFiles":["additional-resources/developers/**/*.md"],"excludeFiles":[]},{"title":"Plugins","includeFiles":["additional-resources/plugins/**/*.md"],"excludeFiles":[]},{"title":"Industry Considerations","includeFiles":["guides/industry-considerations/**/*.md"],"excludeFiles":[]},{"title":"Regional Considerations","includeFiles":["guides/regional-considerations/**/*.md"],"excludeFiles":[]},{"title":"Release Notes","includeFiles":["release-notes/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]},"image":"/assets/guides-in-person-payments-building-your-integration-pos-integration-0-index.5388ab977b2f4a734600813705a967777db2ef5d2c05d0aeef752124f14eefd8.04fe652d.png"},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"pos-quickstart","__idx":0},"children":["POS quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow these steps to connect a PAX payment terminal to Finix and process your first in-person payment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-power-on-the-terminal","__idx":1},"children":["Step 1: Power on the terminal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Place the payment terminal where you'll use it to process payments, then power it on."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To set up the payment terminal, you'll need:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Wi-Fi network and router."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Wi-Fi network's name and password."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Physical access to the payment terminal being activated."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the terminal is on, connect it to your Wi-Fi network and open the Finix Payment App."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-create-and-activate-a-device","__idx":2},"children":["Step 2: Create and activate a Device"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-device","__idx":3},"children":["Create a Device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/devices"},"children":["Device"]}," under the ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/merchants"},"children":["Merchant"]}," provisioned to process in-person payments. Include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["model"]}," of the payment terminal you'll be using to process cards."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the payment terminal that best fits your business needs. View our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/in-person-payments/select-your-device"},"children":["available devices"]}," to compare options."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Pax A800","disable":false},"children":[{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-api/index.yaml","operationId":"createMerchantDevice","exampleKey":"Create a Device - Model PAX_A800","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"../../../../api/components/examples/merchants/responses/json/createDevicePAXA800.jsonc","language":"json","title":"Model PAX_A800 Device","header":{"title":"Model PAX_A800 Device","controls":{"copy":{}}},"lang":"json","source":"{\n  \"id\": \"DVoDo7F6yYCnX2d6Fj9hvsd\",\n  \"created_at\": \"2025-11-14T19:01:04.638451Z\",\n  \"updated_at\": \"2025-11-14T19:01:04.638451Z\",\n  \"configuration_details\": {\n    \"allow_debit\": true,\n    \"check_for_duplicate_transactions\": true,\n    \"prompt_amount_confirmation\": true,\n    \"prompt_manual_entry\": false,\n    \"signature_threshold_amount\": 10000,\n    \"bypass_device_on_capture\": true,\n    \"prompt_receipt_confirmation\": true,\n    \"display_tip_on_receipt\": false,\n    \"prompt_tip_on_screen\": false,\n    \"allow_standalone_authorizations\": false,\n    \"allow_standalone_sales\": false,\n    \"allow_standalone_refunds\": false,\n    \"tipping_details\": {\n      \"percent_tipping_threshold\": 0,\n      \"percent_options\": [\n        18,\n        20,\n        22\n      ],\n      \"fixed_options\": [\n        100,\n        150,\n        200\n      ]\n    },\n    \"idle_message\": null,\n    \"idle_image_file_id\": null,\n    \"automatic_receipt_delivery_methods\": null,\n    \"available_receipt_methods\": null,\n    \"prompt_for_signature\": \"NEVER\",\n    \"surcharge_basis_points\": null\n  },\n  \"description\": \"Cashier One\",\n  \"enabled\": false,\n  \"idle_message\": null,\n  \"integration_mode\": \"PAYMENT_APP\",\n  \"merchant\": \"MUsMvN47nRtdgUkE23SRHDC6\",\n  \"model\": \"PAX_A800\",\n  \"name\": \"My PAX_A800 Finix Device\",\n  \"serial_number\": \"1234567891\",\n  \"tags\": {},\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/devices/DVoDo7F6yYCnX2d6Fj9hvsd\"\n    },\n    \"merchant\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/merchants/MUsMvN47nRtdgUkE23SRHDC6\"\n    },\n    \"transfers\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers\"\n    },\n    \"authorizations\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/authorizations\"\n    }\n  }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Pax A920 Pro","disable":false},"children":[{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-api/index.yaml","operationId":"createMerchantDevice","exampleKey":"Create a Device - Model PAX_A920PRO","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"../../../../api/components/examples/merchants/responses/json/createDevicePAXA920Pro.jsonc","language":"json","title":"Model PAX_A920PRO Device","header":{"title":"Model PAX_A920PRO Device","controls":{"copy":{}}},"lang":"json","source":"{\n  \"id\": \"DV5znKhAQZs6J7rfXqYnr86F\",\n  \"created_at\": \"2025-05-21T19:02:11.141785Z\",\n  \"updated_at\": \"2025-05-21T19:02:11.141785Z\",\n  \"configuration_details\": {\n    \"allow_debit\": true,\n    \"check_for_duplicate_transactions\": true,\n    \"prompt_amount_confirmation\": true,\n    \"prompt_manual_entry\": false,\n    \"signature_threshold_amount\": 10000,\n    \"bypass_device_on_capture\": true,\n    \"prompt_receipt_confirmation\": true,\n    \"display_tip_on_receipt\": false,\n    \"prompt_tip_on_screen\": false,\n    \"allow_standalone_authorizations\": false,\n    \"allow_standalone_sales\": false,\n    \"allow_standalone_refunds\": false,\n    \"tipping_details\": {\n      \"percent_tipping_threshold\": 0,\n      \"percent_options\": [\n        18,\n        20,\n        22\n      ],\n      \"fixed_options\": [\n        100,\n        150,\n        200\n      ]\n    },\n    \"idle_message\": null,\n    \"idle_image_file_id\": null,\n    \"automatic_receipt_delivery_methods\": null,\n    \"available_receipt_methods\": null,\n    \"prompt_for_signature\": \"NEVER\",\n    \"surcharge_basis_points\": null\n  },\n  \"description\": \"Cashier Two\",\n  \"enabled\": false,\n  \"idle_message\": null,\n  \"integration_mode\": \"PAYMENT_APP\",\n  \"merchant\": \"MU7noQ1wdgdAeAfymw2rfBMq\",\n  \"model\": \"PAX_A920PRO\",\n  \"name\": \"My PAX_A920PRO Finix Device\",\n  \"serial_number\": \"1234567892\",\n  \"tags\": {},\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/devices/DV5znKhAQZs6J7rfXqYnr86F\"\n    },\n    \"merchant\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/merchants/MU7noQ1wdgdAeAfymw2rfBMq\"\n    },\n    \"transfers\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers\"\n    },\n    \"authorizations\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/authorizations\"\n    }\n  }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Pax IM30","disable":false},"children":[{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-api/index.yaml","operationId":"createMerchantDevice","exampleKey":"Create a Device - Model PAX_IM30","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"../../../../api/components/examples/merchants/responses/json/createDevicePAXIM30.jsonc","language":"json","title":"Model PAX_IM30 Device","header":{"title":"Model PAX_IM30 Device","controls":{"copy":{}}},"lang":"json","source":"{\n  \"id\" : \"DVfeMQJxpXaYkvBskg2VdZsh\",\n  \"created_at\" : \"2026-04-11T02:30:15.941482Z\",\n  \"updated_at\" : \"2026-04-11T02:30:15.941482Z\",\n  \"configuration_details\" : {\n    \"allow_debit\" : false,\n    \"check_for_duplicate_transactions\" : false,\n    \"prompt_amount_confirmation\" : false,\n    \"prompt_manual_entry\" : false,\n    \"signature_threshold_amount\" : 10000,\n    \"bypass_device_on_capture\" : false,\n    \"prompt_receipt_confirmation\" : false,\n    \"display_tip_on_receipt\" : false,\n    \"prompt_tip_on_screen\" : false,\n    \"allow_standalone_authorizations\" : false,\n    \"allow_standalone_sales\" : false,\n    \"allow_standalone_refunds\" : false,\n    \"tipping_details\" : {\n      \"percent_tipping_threshold\" : 0,\n      \"percent_options\" : [ 18, 20, 22 ],\n      \"fixed_options\" : [ 100, 150, 200 ]\n    },\n    \"idle_message\" : null,\n    \"idle_image_file_id\" : null,\n    \"automatic_receipt_delivery_methods\" : null,\n    \"available_receipt_methods\" : null,\n    \"prompt_for_signature\" : \"NEVER\",\n    \"surcharge_basis_points\" : null\n  },\n  \"description\" : \"Kiosk Three\",\n  \"enabled\" : false,\n  \"idle_message\" : null,\n  \"integration_mode\" : \"PAYMENT_APP\",\n  \"merchant\" : \"MUwfZPNW3r4EqLMzwgr6txw4\",\n  \"model\" : \"PAX_IM30\",\n  \"name\" : \"My PAX_IM30 Finix Device\",\n  \"serial_number\" : \"1234567890\",\n  \"tags\" : { },\n  \"_links\" : {\n    \"self\" : {\n      \"href\" : \"https://finix.sandbox-payments-api.com/devices/DVfeMQJxpXaYkvBskg2VdZsh\"\n    },\n    \"merchant\" : {\n      \"href\" : \"https://finix.sandbox-payments-api.com/merchants/MUwfZPNW3r4EqLMzwgr6txw4\"\n    },\n    \"transfers\" : {\n      \"href\" : \"https://finix.sandbox-payments-api.com/transfers\"\n    },\n    \"authorizations\" : {\n      \"href\" : \"https://finix.sandbox-payments-api.com/authorizations\"\n    }\n  }\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"activate-the-device","__idx":4},"children":["Activate the Device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the Device is created and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serial_number"]}," is set, you can link the ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/devices"},"children":["Device"]}," resource with the payment terminal by sending an activation request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To activate the Device:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Device must be online and connected to the network."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Finix Payment App is open on the Device."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","data-title":"Activate Device","header":{"title":"Activate Device","controls":{"copy":{}}},"source":"curl -i -X PUT \\\n    -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \\\n    https://finix.sandbox-payments-api.com/devices/DV7DvjGoZ2AEdhAKhtKXVv4b \\\n    -H 'Accept: application/hal+json' \\\n    -H 'Content-Type: application/json' \\\n    -H 'Finix-Version: 2022-02-01' \\\n    -d '{\n        \"action\": \"ACTIVATE\"\n    }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful request returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enabled: true"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Optionally ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#checking-the-connection"},"children":["check the device connection"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-create-a-sale","__idx":5},"children":["Step 3: Create a sale"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With the payment terminal connected, you can begin processing in-person payments. Use the Device you enabled to create a sale."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","data-title":"Transfer Request","header":{"title":"Transfer Request","controls":{"copy":{}}},"source":"curl -i -X POST \\\n    -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \\\n    https://finix.sandbox-payments-api.com/transfers \\\n    -H 'Accept: application/hal+json' \\\n    -H 'Content-Type: application/json' \\\n    -H 'Finix-Version: 2022-02-01' \\\n    -d '{\n        \"amount\": 150,\n        \"currency\": \"USD\",\n        \"device\": \"DV7DvjGoZ2AEdhAKhtKXVv4b\",\n        \"operation_key\": \"CARD_PRESENT_DEBIT\",\n        \"tags\": {\n        \"order_number\": \"chris123transfer\"\n        }\n    }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"Transfer Response","header":{"title":"Transfer Response","controls":{"copy":{}}},"source":"{\n  \"id\": \"TRarp7Pz21Low4u2Urw5Ub4W\",\n  \"created_at\": \"2019-04-29T20:44:00.13Z\",\n  \"updated_at\": \"2022-10-10T05:59:17.59Z\",\n  \"3ds_redirect_url\": null,\n  \"additional_buyer_charges\": null,\n  \"additional_healthcare_data\": null,\n  \"address_verification\": null,\n  \"amount\": 3138,\n  \"amount_requested\": 3138,\n  \"application\": \"APeUbTUjvYb1CdPXvNcwW1wP\",\n  \"capture_amount\": 150,\n  \"card_present_details\": {\n    \"emv_data\": {\n      \"application_identifier\": \"A0000001523010\",\n      \"application_label\": \"DISCOVER\",\n      \"application_preferred_name\": null,\n      \"application_transaction_counter\": \"0005\",\n      \"cryptogram\": \"ARCQ F666F8891F870D33\",\n      \"issuer_code_table_index\": null,\n      \"pin_verified\": false,\n      \"tags\": null\n    },\n    \"masked_account_number\": \"************0059\",\n    \"name\": \"Test Card 05\",\n    \"brand\": \"DISCOVER\",\n    \"entry_mode\": \"CHIP_ENTRY\",\n    \"payment_type\": \"CREDIT\",\n    \"approval_code\": \"004839\"\n  },\n  \"currency\": \"USD\",\n  \"device\": \"DVfKLD9GZtsjcJxLtc2yCcfd\",\n  \"expires_at\": \"2019-05-06T20:44:00.13Z\",\n  \"failure_code\": null,\n  \"failure_message\": null,\n  \"idempotency_id\": null,\n  \"is_void\": false,\n  \"merchant\": \"MUeDVrf2ahuKc9Eg5TeZugvs\",\n  \"merchant_identity\": \"IDsbTBawhnLBAVeinRb84vFR\",\n  \"messages\": [],\n  \"raw\": null,\n  \"security_code_verification\": null,\n  \"source\": \"PImTHaz7XVPx4M7mhu9x8gkU\",\n  \"state\": \"SUCCEEDED\",\n  \"tags\": {\n    \"TicketNumber\": \"45878\"\n  },\n  \"trace_id\": \"FNX35FSuraeKKJr65wkGVFJni\",\n  \"void_state\": \"UNATTEMPTED\",\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/authorizations/AUarp7Pz21Low4u2Urw5Ub4W\"\n    },\n    \"application\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP\"\n    },\n    \"transfer\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers/TRqQCAX7nYHUnkE5YPFTknqd\"\n    },\n    \"device\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/devices/DVfKLD9GZtsjcJxLtc2yCcfd\"\n    },\n    \"merchant_identity\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may proceed with ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/payouts"},"children":["managing payouts"]}," and the post-payments lifecycle."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"platform-setup","__idx":6},"children":["Platform setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are a Software Platform or Marketplace that is onboarding sellers, you will have multiple Merchants available to choose from when activating your device. Select the Merchant you want to process in-person payments for before activating your device."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/platform-payments/platform-quickstart"},"children":["Platform Quickstart"]}," to learn how to quickly onboard sellers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"additional-functionality","__idx":7},"children":["Additional functionality"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After completing the initial setup, you may also want to verify your device connection or cancel operations as needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"checking-the-connection","__idx":8},"children":["Checking the connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prior to initiating a payment, you can check the connection to verify that the Device is ready to process payments. Checking the connection will confirm that the:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Device is powered on."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Finix Payment App is open."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Device is connected to the internet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Device was able to connect to the Finix Server."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ID of the ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/devices"},"children":["Device"]}," you enabled to check the Connection. Below is a sample request and response."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connection"]}," field in the response has two potential values:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open"]},": the Device is ready to process payments."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["closed"]},": the Device has not met the criteria outlined above to process payment."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connection"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["closed"]}," and a payment is initiated, the ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/transfers"},"children":["Transfer"]}," will fail with an error of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DEVICE_UNREACHABLE"]},"."]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-api/index.yaml","operationId":"getDeviceConnection","exampleKey":"Device","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"../../../../api/components/examples/devices/responses/json/getDeviceConnection.jsonc","language":"json","title":"Device","header":{"title":"Device","controls":{"copy":{}}},"lang":"json","source":"{\n  \"id\": \"DVoDo7F6yYCnX2d6Fj9hvsd\",\n  \"created_at\": \"2025-11-14T19:01:04.638451Z\",\n  \"updated_at\": \"2025-11-14T19:01:04.638451Z\",\n  \"android_version\": \"10\",\n  \"configuration_details\": {\n    \"allow_debit\": true,\n    \"check_for_duplicate_transactions\": true,\n    \"prompt_amount_confirmation\": true,\n    \"prompt_manual_entry\": false,\n    \"signature_threshold_amount\": 10000,\n    \"bypass_device_on_capture\": true,\n    \"prompt_receipt_confirmation\": true,\n    \"display_tip_on_receipt\": false,\n    \"prompt_tip_on_screen\": false,\n    \"allow_standalone_authorizations\": false,\n    \"allow_standalone_sales\": false,\n    \"allow_standalone_refunds\": false,\n    \"tipping_details\": {\n      \"percent_tipping_threshold\": 0,\n      \"percent_options\": [\n        18,\n        20,\n        22\n      ],\n      \"fixed_options\": [\n        100,\n        150,\n        200\n      ]\n    },\n    \"idle_message\": null,\n    \"idle_image_file_id\": null,\n    \"automatic_receipt_delivery_methods\": null,\n    \"available_receipt_methods\": null,\n    \"prompt_for_signature\": \"NEVER\",\n    \"surcharge_basis_points\": null\n  },\n  \"connection\": \"Open\", // [!code highlight]\n  \"description\": \"Cashier One\",\n  \"enabled\": false,\n  \"firmware_version\": \"PayDroid_10.0.0_Eucalyptus_V20.1.23_20250108\",\n  \"idle_message\": null,\n  \"merchant\": \"MUsMvN47nRtdgUkE23SRHDC6\",\n  \"model\": \"PAX_A800\",\n  \"name\": \"My PAX_A800 Finix Device\",\n  \"payment_app_version\": \"5.9.0\",\n  \"serial_number\": \"2210172205\",\n  \"tags\": {},\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/devices/DVoDo7F6yYCnX2d6Fj9hvsd\"\n    },\n    \"merchant\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/merchants/MUsMvN47nRtdgUkE23SRHDC6\"\n    },\n    \"transfers\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers\"\n    },\n    \"authorizations\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/authorizations\"\n    }\n  }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"canceling-a-device","__idx":9},"children":["Canceling a Device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To deactivate a Device and prevent it from processing future payments, send a ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/devices/updatedevice"},"children":["PUT /devices/{device_id}"]}," request with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DEACTIVATE"]}," action."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"canceling-a-transaction","__idx":10},"children":["Canceling a transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To cancel an in-progress transaction, send a ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/devices/updatedevice"},"children":["PUT /devices/{device_id}"]}," request to cancel the transaction."]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-api/index.yaml","operationId":"updateDevice","exampleKey":"Device - Cancel","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If successful, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failure_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failure_message"]}," on the ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/transfers"},"children":["Transfer"]}," resource will indicate the transaction was cancelled."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"Cancel Transfer Response","data-highlight":"{36-37}","header":{"title":"Cancel Transfer Response","controls":{"copy":{}}},"source":"{\n  \"id\": \"TRt3LfP6ot6s5HG1ZN9QE5qc\",\n  \"created_at\": \"2025-07-18T23:20:55.95Z\",\n  \"updated_at\": \"2025-07-18T23:20:55.95Z\",\n  \"additional_buyer_charges\": null,\n  \"additional_healthcare_data\": null,\n  \"additional_purchase_data\": null,\n  \"address_verification\": null,\n  \"amount\": 2000,\n  \"amount_requested\": 2000,\n  \"application\": \"APc9vhYcPsRuTSpKD9KpMtPe\",\n  \"card_present_details\": {\n    \"emv_data\": {\n      \"application_identifier\": null,\n      \"application_label\": null,\n      \"application_preferred_name\": null,\n      \"application_transaction_counter\": null,\n      \"cryptogram\": null,\n      \"issuer_code_table_index\": null,\n      \"network_emv_response\": null,\n      \"pin_verified\": false,\n      \"tags\": null\n    },\n    \"masked_account_number\": null,\n    \"name\": null,\n    \"brand\": \"UNKNOWN\",\n    \"entry_mode\": \"UNKNOWN\",\n    \"payment_type\": null,\n    \"approval_code\": null,\n    \"digital_signature_file_id\": null\n  },\n  \"currency\": \"USD\",\n  \"destination\": null,\n  \"device\": \"DVae7HFLS7BXNaFpKhdH1K6x\",\n  \"externally_funded\": \"UNKNOWN\",\n  \"failure_code\": \"CANCELLATION_VIA_API\",\n  \"failure_message\": \"The transaction was canceled via API before the transaction was completed. The cardholder needs to attempt the transaction again.\",\n  \"fee\": 0,\n  \"fee_profile\": \"FPuizPqrhzYLbmJm88u7aqfj\",\n  \"idempotency_id\": null,\n  \"merchant\": \"MUmfEGv5bMpSJ9k5TFRUjkmm\",\n  \"merchant_identity\": \"ID6UfSm1d4WPiWgLYmbyeo3H\",\n  \"messages\": [\"RAW MESSAGE\"],\n  \"operation_key\": \"CARD_PRESENT_SALE\",\n  \"parent_transfer\": null,\n  \"parent_transfer_trace_id\": null,\n  \"raw\": null,\n  \"ready_to_settle_at\": null,\n  \"receipt_last_printed_at\": null,\n  \"security_code_verification\": null,\n  \"source\": \"PIhGjmMzFiT3oorhhBoMHdKc\",\n  \"split_transfers\": [],\n  \"state\": \"FAILED\",\n  \"statement_descriptor\": \"FLX*FINIX FLOWERS\",\n  \"subtype\": \"API\",\n  \"supplemental_fee\": null,\n  \"tags\": {\n    \"order_number\": \"Test Transaction\"\n  },\n  \"tip_amount\": null,\n  \"trace_id\": \"433ca932-11c4-4667-8a21-90db472b7691\",\n  \"type\": \"DEBIT\",\n  \"_links\": {\n    \"application\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/applications/APc9vhYcPsRuTSpKD9KpMtPe\"\n    },\n    \"self\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers/TRt3LfP6ot6s5HG1ZN9QE5qc\"\n    },\n    \"merchant_identity\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/identities/ID6UfSm1d4WPiWgLYmbyeo3H\"\n    },\n    \"device\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/devices/DVae7HFLS7BXNaFpKhdH1K6x\"\n    },\n    \"payment_instruments\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers/TRt3LfP6ot6s5HG1ZN9QE5qc/payment_instruments\"\n    },\n    \"reversals\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers/TRt3LfP6ot6s5HG1ZN9QE5qc/reversals\"\n    },\n    \"fees\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers/TRt3LfP6ot6s5HG1ZN9QE5qc/fees\"\n    },\n    \"disputes\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/transfers/TRt3LfP6ot6s5HG1ZN9QE5qc/disputes\"\n    },\n    \"fee_profile\": {\n      \"href\": \"https://finix.sandbox-payments-api.com/fee_profiles/FPuizPqrhzYLbmJm88u7aqfj\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":11},"children":["Next steps"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":3,"cardMinWidth":180},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Testing Your Integration","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"outlined","to":"/guides/in-person-payments/building-your-integration/testing-your-integration"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn how to test your In-Person Payments integration."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Sending Receipts","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"outlined","to":"/guides/in-person-payments/building-your-integration/pos-integration/sending-receipts"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn how to print or email card-network-compliant receipts after a payment."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Device API Reference","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"outlined","to":"/api/devices/"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Explore the Devices endpoints for activating, updating, and monitoring terminals."]}]}]}]},"headings":[{"value":"POS quickstart","id":"pos-quickstart","depth":1},{"value":"Step 1: Power on the terminal","id":"step-1-power-on-the-terminal","depth":2},{"value":"Step 2: Create and activate a Device","id":"step-2-create-and-activate-a-device","depth":2},{"value":"Create a Device","id":"create-a-device","depth":3},{"value":"Activate the Device","id":"activate-the-device","depth":3},{"value":"Step 3: Create a sale","id":"step-3-create-a-sale","depth":2},{"value":"Platform setup","id":"platform-setup","depth":2},{"value":"Additional functionality","id":"additional-functionality","depth":2},{"value":"Checking the connection","id":"checking-the-connection","depth":3},{"value":"Canceling a Device","id":"canceling-a-device","depth":3},{"value":"Canceling a transaction","id":"canceling-a-transaction","depth":3},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"POS Quickstart","description":"Connect your POS system to Finix: power on your terminal, create and activate a device, and process your first payment.","image":"/assets/guides-in-person-payments-building-your-integration-pos-integration-0-index.5388ab977b2f4a734600813705a967777db2ef5d2c05d0aeef752124f14eefd8.04fe652d.png"},"keywords":{"includes":["point of sale","POS quickstart","POS integration","POS system integration"],"excludes":["merchant","payment terminal","sale","terminal","transfer","A800","A920","D135"]}},"lastModified":"2026-08-10T22:13:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/in-person-payments/building-your-integration/pos-integration/pos-quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}