Look up a terminal to see its current status and configuration. Returns terminal information without terminal configuration when terminal has not been successfully onboarded yet. Note: 3.2 /terminals
endpoints are not ready for public use, and will accompany other Card Present enhancements
A successful terminal lookup response.
INVALID_PARAMS
NOT_AUTHORIZED
UNEXPECTED_ERROR
{- "id": "13A64A41D4B87HW",
- "resource": "terminals",
- "path": "/terminals/eaf1ef26-ea2d-4be3-b990-ec2c410b54de",
- "owner": {
- "id": "0ef0dcd6-a2c6-49c4-9051-bbbe5c6c36e2",
- "path": "/accounts/0ef0dcd6-a2c6-49c4-9051-bbbe5c6c36e2",
- "resource": "accounts"
}, - "api_version": "3.2",
- "status": "active",
- "serial_number": "FA00332-1000138",
- "model": "DX8000",
- "reference_id": "abc12345",
- "terminal_configuration": {
- "receipt_header_merchant_name": "Joe's Coffee",
- "name": "Front Desk",
- "manual_entry_configuration": {
- "avs_prompt_enabled": false,
- "cvd_prompt_enabled": true
}, - "address": {
- "city": "Redwood City",
- "country": "US",
- "line1": "250 Convention Way",
- "line2": "Suite 200",
- "postal_code": "94063",
- "region": "CA"
}, - "currency": "USD",
- "timezone": "US/Pacific",
- "quick_chip": {
- "enabled": true
}, - "tip": {
- "mode": "prompt_on_terminal",
- "terminal_display": {
- "amount_guide_type": "percentage_guide",
- "percentage_guide": {
- "percentage_low": 15,
- "percentage_medium": 18,
- "percentage_high": 20
}
}
}, - "signature_required": false,
- "deferred_authorization": {
- "enabled": true,
- "international_enabled": true,
- "max_transaction_count": 200,
- "max_total_amount": 25000,
- "max_transaction_amount": 12500,
- "supported_card_entry_modes": "all_entry_modes"
}
}
}