---
title: "Submit signature instruction"
method: POST
path: "/devices/{serialNumber}/signature-instructions"
tags: ["signatureInstructions"]
---

# Submit signature instruction

`POST /devices/{serialNumber}/signature-instructions`

Use this method to submit an instruction to capture a customer's signature on a payment device.  

Our gateway returns information about the signature instruction and a signatureInstructionId, which you need for the following methods:
- [Retrieve signature instruction](https://docs.payroc.com/api/schema/payroc-cloud/signature-instructions/retrieve) - View the details of the signature instruction.
- [Cancel signature instruction](https://docs.payroc.com/api/schema/payroc-cloud/signature-instructions/delete) - Cancel the signature instruction.

## Path parameters

- `serialNumber` string, required

## Headers

- `Authorization` string, required
- `Idempotency-Key` string, uuid, required

## Request body

- SignatureInstructionRequest — Object that contains the instructions for capturing a signature on a physical device.
  - `processingTerminalId` string, required — Unique identifier that we assigned to the terminal.

## Response `202`

Successful request. We accepted the signature instruction.

- SignatureInstruction
  - `status` 'canceled' | 'completed' | 'failure' | 'inProgress', required — Indicates the current status of the instruction. - `canceled` – The instruction was canceled before it was completed. - `completed` – The instruction has completed. Use the link object to check the resource. - `failure` – The instruction failed. Check the errorMessage field for more information. - `inProgress` – The instruction is currently in progress.
  - `errorMessage` string — Description of the error that caused the instruction to fail. **Note:** We return this field only if the status is `failure`.
  - `link` Link — Object that contains HATEOAS links for the resource.
    - `rel` string, required — Indicates the relationship between the current resource and the target resource.
    - `method` string, required — HTTP method that you need to use with the target resource.
    - `href` string, required — URL of the target resource.
  - `signatureInstructionId` string, required — Unique identifier that our gateway assigned to the instruction.

## Other responses

- `400` — Validation error
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `404` — Resource not found
- `406` — Not acceptable
- `409` — Conflict
- `415` — Unsupported media type
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)