# In-Person Terminals

The in-person terminals API allows you to setup and manage your physical terminal hardware for in-person (card present) payments.


## Create a terminal to register a physical device

 - [POST /in-person/terminals](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersoncreateterminaloperation.md): Use this endpoint to setup and register a physical terminal and begin accepting payments.

## List terminals

 - [GET /in-person/terminals](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersonterminallist.md): Fetches an paginated list of terminals

## Retrieve a terminal

 - [GET /in-person/terminals/{id}](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersonterminalgetbyid.md): Fetches a terminal via its unique ID

## Update a terminal

 - [PATCH /in-person/terminals/{id}](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersonterminalupdatebyid.md): Updates a terminal via its unique ID

## Delete a terminal

 - [DELETE /in-person/terminals/{id}](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersonterminaldeletebyid.md): Deletes a terminal. Note that once deleted, the terminal will no longer be able to accept payments.

## Initiate a payment on a terminal

 - [POST /in-person/terminals/{id}/payment](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersonterminalinitpayment.md): Initiate a payment on a specific terminal. The cardholder can present their card to complete the purchase.

## Initiate a refund on a terminal

 - [POST /in-person/terminals/{id}/refund](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersonterminalinitrefund.md): Initiate a refund on a specific terminal. The cardholder can present their card to complete the refund.

## Cancel the current action on a terminal

 - [POST /in-person/terminals/{id}/cancel-action](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersonterminalcancelaction.md): Cancel the action that has been initiated and is currently in-progress on a specific terminal.

## Confirm the result of receipt printing via POS for the current action

 - [POST /in-person/terminals/{id}/confirm-receipt](https://developer.ryftpay.com/documentation/api/reference/openapi/in-person-terminals/inpersonterminalconfirmreceipt.md): Confirm the result of receipt printing via POS for the action that has been initiated and is currently waiting for a receipt to be printed on a specific terminal. This endpoint is required if the transaction's 'receiptPrintingSource' was set to 'PointOfSale'