Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

A test-mode Merchant secret key, or an authorized Platform test key with delegation.

Headers

Ionic-Account
string

Merchant ID when an authorized Platform acts for a connected Merchant. Omit when authenticating directly as that Merchant.

Pattern: ^mer_[0-9A-Za-z]{14}$
Idempotency-Key
string
required

Reuse only when retrying the same route and request body.

Required string length: 1 - 255

Path Parameters

id
string
required

Merchant-owned simulated Terminal ID.

Pattern: ^tmr_[0-9A-Za-z]{14}$

Body

application/json
profiles
object[]
required

One to 10 profile updates. Omitted existing profiles remain unchanged.

Required array length: 1 - 10 elements

Response

The durable batch scenario.

id
string<uuid>
required

Unique identifier for the batch scenario.

object
enum<string>
required
Available options:
terminal.batch_simulation
merchant_id
string
required

ID of the account that owns the scenario (mer_…).

Pattern: ^mer_[0-9A-Za-z]{14}$
terminal_id
string
required

ID of the simulated terminal the scenario applies to (tmr_…).

Pattern: ^tmr_[0-9A-Za-z]{14}$
livemode
enum<boolean>
required
Available options:
false
profiles
object[]
required

Simulated current-batch contents, grouped by processing profile.

created_at
integer<int64>
required

Unix epoch seconds when the scenario was created.

updated_at
integer<int64>
required

Unix epoch seconds when the scenario was last updated.