---
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`

## Request

- Base URL: `https://api.sandbox.rainforestpay.com`
- URL: `https://api.sandbox.rainforestpay.com/v1/device_registrations/{device_registration_id}/payin`
- Auth: HTTP bearer

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{device_registration_id}/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/payments.md) - [All operations](https://skmtc.dev/rainforestpay/apis/payments/llms.txt) - [OpenAPI document](https://skmtc.dev/rainforestpay/apis/payments/revisions/9d7d0b1553a8?raw)