On This Page
Generating a Terminal Activation Code Using a REST API Request
Before activating the terminal in the Acceptance Devices app, you must generate a terminal activation code.
You can use a REST API request to generate a terminal activation code, which is valid for
24 hours.
You must authenticate each request that you send to a
Cybersource
API. In
order to authenticate an API request, you can use a REST shared secret key or a
REST certificate. For more information about authentication requirements, see .Endpoints
The POST request must include the transacting merchant ID (MID) that is sending the
request and the quantity of activation codes to be generated. You can request up to
15 activation codes in a single request.
Test:
POST
https://apitest.cybersource.com
/dms/v2/merchants/{transacting
mid}/activation-codes?size={number of activation codes}Production:
POST
https://api.cybersource.com
/dms/v2/merchants/{transacting
mid}/activation-codes?size={number of activation codes}Required Fields for Generating a Terminal Activation Code
The body of the API request is empty. The POST request must include the information
required to return the response.
REST Example: Generating a Terminal Activation Code
Request
The body of the request is empty. The POST request includes the information required
to return the response.
{ }
Response to a Successful Request
The response includes the activation code (
token
field) and
the amount of time (ttl
field) that the activation code is
valid. The ttl
field value is shown in milliseconds. The
activation code is valid for 24 hours. { "tokens": [ { "token": "%N5wU2jH", "ttl": 86399805 } ] }