Onboard a Point-of-Sale terminal into the WePay system. A Terminal resource allows you to control the configuration and lifecycle of a physical terminal. You can only have one non-deleted instance of a terminals resource per physical terminal, which is uniquely identified by the model and serial number. 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 creation response.
id required | string <= 15 characters A hashed value that uniquely identifies a physical terminal (the terminal ID on both Wepay and EMS ecosystem). | ||||||
resource required | string Helps organize information by identifying the resource type of the object data.
| ||||||
path required | string The HTTP path of the resource. The path can be used to retrieve details about the resource and perform actions on it. | ||||||
required | object or null Details the owner resource and owner path. | ||||||
api_version required | string | ||||||
status required | string The status of the terminal. Note: Deleted terminals will only be returned via
| ||||||
serial_number required | string [ 1 .. 32 ] characters ^[a-zA-Z0-9-]+$ The serial number of the physical terminal. | ||||||
model required | string The model of the physical terminal.
| ||||||
reference_id required | string or null [ 1 .. 255 ] characters A reference ID that can be used to identify the terminals resource in WePay's system. Searching capabilities are supported on this field. | ||||||
required | object |
INVALID_PARAMS, ACCOUNT_CANNOT_CREATE_TERMINALS
NOT_AUTHORIZED
UNEXPECTED_ERROR
{- "account_id": "0ef0dcd6-a2c6-49c4-9051-bbbe5c6c36e2",
- "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"
}
}
}
{- "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": {
- "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"
}
}
}