---
title: "Simulate device interaction"
method: POST
path: "/v1/device_registrations/{device_registration_id}/simulate"
tags: ["Devices"]
---

# Simulate device interaction

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

Only available in the Rainforest sandbox environment.

After presenting a payin or payment method on a virtual device this endpoint is available to move on from the `PRESENTING` status to a desired subsequent status.

The expected webhook will be sent for the payin or payment method on status change.

## 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 — Simulation request for device interactions.
  - `event` 'PRESENTED' | 'CANCEL' — Event to simulate
  - `card` 'VISA_SUCCESS' | 'VISA_42_SUCCESS' | 'VISA_DEBIT_SUCCESS' | 'MC_SUCCESS' | 'MC_2_SUCCESS' | 'MC_DEBIT_SUCCESS' | 'MC_PREPAID_SUCCESS' | 'AMEX_SUCCESS' | 'AMEX_2_SUCCESS' | 'AMEX_DEBIT_SUCCESS' | 'DISCOVER_SUCCESS' | 'DISCOVER_2_SUCCESS' | 'DISCOVER_DEBIT_SUCCESS' | 'DINERS_SUCCESS' | 'DINERS_14_SUCCESS' | 'JCB_SUCCESS' | 'CUP_SUCCESS' | 'CB_VISA_SUCCESS' | 'CB_MC_SUCCESS' | 'GENERIC_DECLINE' | 'INSUFFICIENT_FUNDS' | 'LOST_CARD' | 'STOLEN_CARD' | 'EXPIRED_CARD' | 'INCORRECT_CVC' | 'PROCESSING_ERROR' | 'INCORRECT_NUMBER' — Name of card to use

## Response `204`

OK

## 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)