---
title: "Present payin on a registered device"
method: POST
path: "/v1/device_registrations/{device_registration_id}/payin"
tags: ["Devices"]
---

# Present payin on a registered device

`POST /v1/device_registrations/{device_registration_id}/payin`

Present a payin for processing on a registered device using a payin configuration. The merchant status must be `ACTIVE` to process a payin.

> 📘 Note
>
> A payment method created on a registered device may only be used for payins within the same merchant for which it was collected.

## Parameters

- `#/paths/~1v1~1payins/get/parameters/0` — unresolved $ref
- `#/paths/~1v1~1device_registrations~1%7Bdevice_registration_id%7D/get/parameters/1` — unresolved $ref

## Request body

- object
  - `payin_config_id` string, required — The unique payin config identifier. A payin must be configured prior to this request. See "Create a Payin Config" if a payin configuration has not been created yet. Prefix is "cfg" in production and "sbx_cfg" in sandbox.

## Response `200`

OK

- object
  - `status` Status — unresolved $ref
  - `data` Data — unresolved $ref
  - `errors` Errors — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `409` — unresolved $ref
- `5XX` — unresolved $ref

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)