v1

latestOpenAPI 3.0.0Apache 2.02026-07-143281,4552.1 MB

Terminal

CreateTerminalAction

Creates a Terminal action request and sends it to the specified device.

post/v2/terminals/actions

Request body

idempotency_keystring required

A unique string that identifies this CreateAction request. Keys can be any valid string but must be unique for every CreateAction request.

See Idempotency keys for more information.

Example request

{
  "action": {
    "deadline_duration": "PT5M",
    "device_id": "{{DEVICE_ID}}",
    "save_card_options": {
      "customer_id": "{{CUSTOMER_ID}}",
      "reference_id": "user-id-1"
    },
    "type": "SAVE_CARD"
  },
  "idempotency_key": "thahn-70e75c10-47f7-4ab6-88cc-aaa4076d065e"
}

Response

Success

Example response

{
  "action": {
    "app_id": "APP_ID",
    "created_at": "2021-07-28T23:22:07.476Z",
    "deadline_duration": "PT5M",
    "device_id": "DEVICE_ID",
    "id": "termapia:jveJIAkkAjILHkdCE",
    "location_id": "LOCATION_ID",
    "save_card_options": {
      "customer_id": "CUSTOMER_ID",
      "reference_id": "user-id-1"
    },
    "status": "PENDING",
    "type": "SAVE_CARD",
    "updated_at": "2021-07-28T23:22:07.476Z"
  }
}