---
title: "Capture, refund or void handler"
method: POST
path: "/admin/payment-simulator/action.json"
tags: ["Payment Simulator"]
---

# Capture, refund or void handler

`POST /admin/payment-simulator/action.json`

## Request body

- CaptureRefundOrVoidHandlerSwaggerRequest
  - `x_account_id` string — Login id of merchant in payment settings
  - `x_amount` number — Order's amount
  - `x_currency` string — Order's currency
  - `x_gateway_reference` string — Unique reference for payment issued by the payment processor.
  - `x_invoice` string — Only available on request type = capture
  - `x_reference` string — Unique token for current checkout
  - `x_signature` string — See [Signing mechanism](https://docs.ocg.to/link/4417#bkmrk-2.3%C2%A0signing-mechanis)
  - `x_transaction_type` string — The valid values are `capture`, `refund`, `void`, `get`.
  - `x_url_callback` string — URL to which a callback notification should be sent asynchronously.

## Response `200`

OK

- PaymentResponseDto
  - `x_account_id` string — Login id of merchant in payment settings
  - `x_amount` number — Order's amount
  - `x_currency` string — Order's currency
  - `x_error_code` string — An error code to be log on Shopbase
  - `x_gateway_reference` string — Unique reference for payment issued by the payment processor.
  - `x_intent` string
  - `x_message` string — A custom error message displayed to the customer.
  - `x_reference` string — Unique token for current checkout
  - `x_result` string — Valid values are completed or failed
  - `x_signature` string — Signed signature
  - `x_test` boolean — Indicates whether or not this request should be processed in test mode (if supported).
  - `x_timestamp` string — Time of transaction completion. UTC Time: YYYY-MM-DDTHH:MM:SSZ
  - `x_transaction_type` unknown

---

[API](https://skmtc.net/shopbase/apis/shopbase-internal-api.md) · [All operations](https://skmtc.net/shopbase/apis/shopbase-internal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shopbase/shopbase-internal-api/revisions/353ccde6240d/schema)