Retrieve processing terminal | Payroc

Important: You can retrieve a processing terminal only if the terminal order was created using the Payroc API.

Use this method to retrieve information about a processing terminal.

To retrieve a processing terminal, you need its processingTerminalId. Our gateway returned the processingTerminalId in the response of the Create Terminal Order method.

Note: If you don’t have the processingTerminalId, use our Retrieve Terminal Order method or our List Processing Terminals method to search for the processing terminal.

Our gateway returns the following information about the processing terminal:

Status indicating whether the terminal is active or inactive.
Configuration settings, including gateway settings and application settings.
Features, receipt settings, and security settings.
Devices that use the processing terminal’s configuration.

**Important:** You can retrieve a processing terminal only if the terminal order was created using the Payroc API. Use this method to retrieve information about a processing terminal. To retrieve a processing terminal, you need its processingTerminalId. Our gateway returned the processingTerminalId in the response of the [Create Terminal Order](https://docs.payroc.com/api/schema/boarding/processing-accounts/create-terminal-order) method. **Note:** If you don't have the processingTerminalId, use our [Retrieve Terminal Order](https://docs.payroc.com/api/schema/boarding/terminal-orders/retrieve) method or our [List Processing Terminals](https://docs.payroc.com/api/schema/boarding/processing-accounts/list-processing-terminals) method to search for the processing terminal. Our gateway returns the following information about the processing terminal: - Status indicating whether the terminal is active or inactive. - Configuration settings, including gateway settings and application settings. - Features, receipt settings, and security settings. - Devices that use the processing terminal's configuration.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path Parameters

processingTerminalIdstringRequired4-50 characters

Unique identifier that we assigned to the terminal.

Response

Successful request. Returns the processing terminal.

processingTerminalIdstring

Unique identifier that we assigned to the processing terminal.

statusenum

Indicates if the processing terminal is active.

Allowed values:

timezoneenum

Time zone of the processing terminal.

batchClosureobject

Object that contains information about when and how the terminal closes the batch.

applicationSettingsobject

Object that contains the application settings for the solution.

featuresobject

Object that contains the feature settings for the terminal.

programstring or null<=50 characters

Name of the product and its setup.

gatewayobject or null

Object that contains the gateway settings for the solution.

taxeslist of objects or null

Array of tax objects that contains the taxes that apply to the merchant's transactions.

securityobject or null

Object that contains the tokenization settings and AVS settings for the terminal.

receiptNotificationsobject or null

Object that indicates if the terminal can send email receipts or text receipts.

deviceslist of objects or null

Array of device objects. Each object contains information about a device using the processing terminal's configuration.

Errors

Important: You can retrieve a processing terminal only if the terminal order was created using the Payroc API.

Use this method to retrieve information about a processing terminal.

To retrieve a processing terminal, you need its processingTerminalId. Our gateway returned the processingTerminalId in the response of the Create Terminal Order method.

Note: If you don’t have the processingTerminalId, use our Retrieve Terminal Order method or our List Processing Terminals method to search for the processing terminal.

Our gateway returns the following information about the processing terminal:

Status indicating whether the terminal is active or inactive.
Configuration settings, including gateway settings and application settings.
Features, receipt settings, and security settings.
Devices that use the processing terminal’s configuration.

1	import requests
2
3	url = "https://api.payroc.com/v1/processing-terminals/1234001"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"processingTerminalId": "011234001",
3	"status": "active",
4	"timezone": "Pacific/Midway",
5	"batchClosure": {
6	"batchCloseType": "automatic",
7	"batchCloseTime": "23:40"
8	},
9	"applicationSettings": {
10	"invoiceNumberPrompt": true,
11	"clerkPrompt": false
12	},
13	"features": {
14	"enhancedProcessing": {
15	"enabled": true,
16	"transactionDataLevel": "level2",
17	"shippingAddressMode": "fullAddress"
18	},
19	"ebt": {
20	"enabled": true,
21	"ebtType": "foodStamp",
22	"fnsNumber": "1234567890"
23	},
24	"pinDebitCashback": false,
25	"tips": {
26	"enabled": false,
27	"tipPrompt": false,
28	"tipAdjust": true,
29	"suggestedTips": {
30	"enabled": true,
31	"tipPercentages": [
32	"15",
33	"20"
34	]
35	}
36	},
37	"recurringPayments": true,
38	"paymentLinks": {
39	"enabled": true,
40	"logoUrl": "LogoPayLink",
41	"footerNotes": "FooterNotesPayLink"
42	},
43	"preAuthorizations": true,
44	"offlinePayments": true,
45	"security": {
46	"tokenization": false,
47	"avsPrompt": true,
48	"avsLevel": "fullAddress",
49	"cvvPrompt": true
50	},
51	"receiptNotifications": {
52	"emailReceipt": true,
53	"smsReceipt": false
54	},
55	"taxes": [
56	{
57	"taxRate": 6,
58	"taxLabel": "Sales Tax"
59	}
60	],
61	"devices": [
62	{
63	"manufacturer": "Ingenico",
64	"model": "Axium Dx4000 Tsys",
65	"serialNumber": "DX400-1234",
66	"communicationType": "bluetooth"
67	}
68	]
69	},
70	"program": "Payroc Cloud",
71	"gateway": {
72	"gateway": "payroc",
73	"terminalTemplateId": "Roc Services_DX8000"
74	},
75	"processingAccountId": "38765"
76	}