{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-android/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Device Setup | Android Card Present SDK Reference","description":"Create and activate a PAX D135 device in Finix before connecting it to the Android Card Present 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/subscriptions/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":"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":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"device-setup","__idx":0},"children":["Device Setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before connecting the SDK to a PAX D135, you must create a Device resource in Finix and activate it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-credentials","__idx":1},"children":["API Credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Finix API credentials you use with the SDK must have the appropriate role:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROLE_MERCHANT"]}," — for single-merchant devices. Recommended for dedicated point-of-sale hardware."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROLE_PARTNER"]}," — required for multi-merchant devices and split transactions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-device","__idx":2},"children":["Create a Device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a POST request to create a Device under the target Merchant. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["model"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAX_D135"]}," and include the physical serial number printed on the device."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  -u {your_api_key}:{your_api_secret} \\\n  https://finix.sandbox-payments-api.com/merchants/{merchant_id}/devices \\\n  -H 'Accept: application/hal+json' \\\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":"p","attributes":{},"children":["Copy the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," field from the response. This is the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceId"]}," value you supply in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/android/card-present/credentials"},"children":["Credentials"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activate-a-device","__idx":3},"children":["Activate a Device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a PUT request with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"action\": \"ACTIVATE\""]}," to enable the device. A successful response returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enabled: true"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"curl -i -X PUT \\\n  -u {your_api_key}:{your_api_secret} \\\n  https://finix.sandbox-payments-api.com/devices/{device_id} \\\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":"Admonition","attributes":{"type":"info","name":"Set Up Device on Dashboard"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Devices can also be created and activated directly in the Finix Dashboard. The API steps above are only required if you prefer to manage devices programmatically."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"version-compatibility","__idx":4},"children":["Version Compatibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SDK version 3.0.0 is a major update and is incompatible with earlier versions. If you have existing production devices running SDK version 2.0.0 or later, coordinate with Finix before upgrading."]}]},"headings":[{"value":"Device Setup","id":"device-setup","depth":1},{"value":"API Credentials","id":"api-credentials","depth":2},{"value":"Create a Device","id":"create-a-device","depth":2},{"value":"Activate a Device","id":"activate-a-device","depth":2},{"value":"Version Compatibility","id":"version-compatibility","depth":2}],"frontmatter":{"seo":{"title":"Device Setup | Android Card Present SDK Reference","description":"Create and activate a PAX D135 device in Finix before connecting it to the Android Card Present SDK."}},"lastModified":"2026-06-04T00:03:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/android/card-present/device-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}