{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition","ApiLink","img","cards","card"]},"type":"markdown"},"seo":{"title":"PAX D135 Integration Prerequisites","description":"Set up your environment, API credentials, and Device resource before integrating the PAX D135 with the Finix Android or iOS SDK.","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":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"pax-d135-integration-prerequisites","__idx":0},"children":["PAX D135 integration prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before integrating the PAX D135 with the Android or iOS SDK, complete the following one-time setup. These steps configure your device's environment, establish your API credentials, and register your PAX D135 with Finix."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"environment-designation","__idx":1},"children":["Environment designation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ordering a PAX D135, specify whether each Device is designated for Sandbox or Production. Finix provides you with the serial number assigned to each Device."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Device Designation"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A D135 Device can be designated for either Sandbox development or Production transaction processing ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["but not both"]},". We recommend requesting enough devices to utilize in both your Sandbox development and Production testing."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your PAX D135 device is fully charged."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["iOS:"]}," iOS 18.1 or higher."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Android:"]}," Android 8.0 (API level 26) or higher."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Charging the Device"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Charge the battery only with PAX-approved power supplies. Using others may damage the product and void the warranty."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Charging time must not exceed 24 hours. If the battery is empty, recharge it fully, then disconnect the device to avoid shortening its life."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-creating-user-credentials","__idx":3},"children":["1. Creating user credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK supports the use of either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROLE_PARTNER"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROLE_MERCHANT"]}," credentials. If you would like to scope your device to a single Merchant, it is recommended to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROLE_MERCHANT"]}," credentials. If you plan to use the Device across multiple merchants, you should use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROLE_PARTNER"]}," credentials."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/payment-features/split-transactions"},"children":["Split Transactions"]}," require the use of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROLE_PARTNER"]}," credentials."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creating-role_merchant-credentials","__idx":4},"children":["Creating ROLE_MERCHANT credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/users"},"children":["User"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role: ROLE_MERCHANT"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda \\\n  https://finix.sandbox-payments-api.com/users \\\n  -H 'Content-Type: application/json' \\\n  -H 'Finix-Version: 2022-02-01' \\\n  -d '{\n    \"role\": \"ROLE_MERCHANT\",\n    \"identity_id\": \"ID6YeRojM2ppNkPt4mP8ExNH\"\n  }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use the credentials across multiple devices as long as the devices are associated with the same Merchant."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creating-role_partner-credentials","__idx":5},"children":["Creating ROLE_PARTNER credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROLE_PARTNER"]}," credentials:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://live.payments-dashboard.com/Login"},"children":["Finix Dashboard"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the environment for which you would like to create the API credentials (Sandbox or Live)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the bottom left-hand corner, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Keys"]}," tab, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create API Key"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/developer-api-keys-create.734cc8d9fcbceaa6500a394d7b7a350bb854b952c502fe5cb57d74ee9792b476.08ff7529.png","alt":"Create API Key","withLightbox":true},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-creating-a-device","__idx":6},"children":["2. Creating a Device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creating a ",{"$$mdtype":"Tag","name":"ApiLink","attributes":{"href":"/api/devices"},"children":["Device"]}," can be done either using the Finix Dashboard or the Finix API. Below are the steps for creating a Device using the API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a 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":"CodeBlock","attributes":{"data-language":"shell","data-title":"Request","header":{"title":"Request","controls":{"copy":{}}},"source":"curl -i -X POST \\\n  -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda \\\n  https://finix.sandbox-payments-api.com/merchants/MUwfZPNW3r4EqLMzwgr6txw4/devices \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"description\": \"Cashier Three\",\n    \"model\": \"PAX_D135\",\n    \"name\": \"My PAX_D135 Finix Device\",\n    \"serial_number\": \"19046260947\"\n  }'\n","lang":"shell"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"Response","header":{"title":"Response","controls":{"copy":{}}},"source":"{\n    \"id\": \"DVxcL2fiBdt9frYCKAbZikZK\",\n    \"created_at\": \"2025-05-21T19:01:32.000581Z\",\n    \"updated_at\": \"2025-05-21T19:01:32.000581Z\",\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\": [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\": \"Cashier Three\",\n    \"enabled\": false,\n    \"idle_message\": null,\n    \"merchant\": \"MU7noQ1wdgdAeAfymw2rfBMq\",\n    \"model\": \"PAX_D135\",\n    \"name\": \"My PAX_D135 Finix Device\",\n    \"serial_number\": \"19046260947\",\n    \"tags\": {},\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://finix.sandbox-payments-api.com/devices/DVxcL2fiBdt9frYCKAbZikZK\"\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","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":7},"children":["Next steps"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":3,"cardMinWidth":180},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Android SDK","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"outlined","to":"/guides/in-person-payments/building-your-integration/mobile-integration/pax_d135_android_quickstart"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Install and initialize the Finix Android SDK, connect to your D135, and process your first transaction."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"iOS SDK","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"outlined","to":"/guides/in-person-payments/building-your-integration/mobile-integration/pax_d135_ios_quickstart"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Install and initialize the Finix iOS SDK, connect to your D135, and process your first transaction."]}]}]}]},"headings":[{"value":"PAX D135 integration prerequisites","id":"pax-d135-integration-prerequisites","depth":1},{"value":"Environment designation","id":"environment-designation","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"1. Creating user credentials","id":"1-creating-user-credentials","depth":2},{"value":"Creating ROLE_MERCHANT credentials","id":"creating-role_merchant-credentials","depth":3},{"value":"Creating ROLE_PARTNER credentials","id":"creating-role_partner-credentials","depth":3},{"value":"2. Creating a Device","id":"2-creating-a-device","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"PAX D135 Integration Prerequisites","description":"Set up your environment, API credentials, and Device resource before integrating the PAX D135 with the Finix Android or iOS SDK."}},"lastModified":"2026-08-10T22:13:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/in-person-payments/building-your-integration/mobile-integration/integration-prerequisites","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}