Modify a terminal's configuration. Note that changes in configuration will only be reflected on your physical terminal when it has performed an online update. You cannot modify the configuration of an inactive or deleted terminal. NOTE: the currency
parameter for Terminals only supports USD
. Note: 3.2 /terminals
endpoints are not ready for public use, and will accompany other Card Present enhancements
A successful terminals modification response.
INVALID_PARAMS, TERMINAL_HAS_NOT_BEEN_ONBOARDED
NOT_AUTHORIZED
UNEXPECTED_ERROR
{- "reference_id": "abc12346",
- "terminal_configuration": {
- "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
}, - "receipt_header_merchant_name": "Joe's Coffee",
- "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"
}
}
}
{- "id": "13A64A41D4B87HW",
- "resource": "terminals",
- "path": "/terminals/13A64A41D4B87HW",
- "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": {
- "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
}, - "receipt_header_merchant_name": "Joe's Coffee",
- "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"
}
}
}