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

# Present payment method on a registered device

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

## Request

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

Create a payment method on a registered device using a payment method configuration. The merchant status must be `ACTIVE` to create a payment method.

> 📘 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
  - `payment_method_config_id` string, required: The unique payment method config identifier. A payment method must be configured prior to this request. See "Create a payment method config" if a payment method configuration has not been created yet. Prefix is "pmc" in production and "sbx_pmc" 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)