---
title: "Terminal Transaction - Create"
method: POST
path: "/transaction/merchantid/{merchantId}/terminalid/{terminalId}"
---

# Terminal Transaction - Create

`POST /transaction/merchantid/{merchantId}/terminalid/{terminalId}`

## Request

- Base URL: `https://sandbox.api.mxmerchant.com/checkout`
- URL: `https://sandbox.api.mxmerchant.com/checkout/transaction/merchantid/{merchantId}/terminalid/{terminalId}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mxmerchant/apis/checkout-api/docs/transaction/merchantid/:merchantId/terminalid/:terminalId/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `merchantId` string, required
- `terminalId` string, required

## Request body

- object
  - `amount` number, float, required
  - `type` string, required: 'Sale', 'Refund', 'Authorization', 'SaleCompletion' or 'Void'.
  - `vaultCard` boolean
  - `replayId` string, required: Unique 15 digit string only.

## Response `200`

200

- union
  - object
    - `message` string
    - `prioritypaymentsystems` object
      - `mxmerchant` object
        - `merchant` object
          - `devicePaymentAuditId` string
        - `transaction` object
    - `provider` object
      - `key` string
      - `name` string
      - `transaction` object
        - `terminalID` string
        - `status` string
        - `transactionType` string
        - `totalAmount` string
        - `callbackUrl` string
        - `uuid` string
        - `id` string
        - `portfolio` string
        - `dateCreated` string
        - `clientReference` string
        - `currency` string
        - `merchantId` string
        - `source` string
        - `replayId` string
    - `status` string
  - object
    - `message` string
    - `prioritypaymentsystems` object
      - `mxmerchant` object
        - `merchant` object
          - `devicePaymentAuditId` string
        - `transaction` object
    - `provider` object
      - `key` string
      - `name` string
      - `transaction` object
        - `message` string
    - `status` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/mxmerchant/apis/checkout-api.md) - [All operations](https://skmtc.dev/mxmerchant/apis/checkout-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mxmerchant/apis/checkout-api/revisions/6807b698abcb?raw)