---
title: "Make a payment with token"
method: POST
path: "/v3/payment?token="
---

# Make a payment with token

`POST /v3/payment?token=`

Make a payment with the one-time-use token

## Query parameters

- `token` string, required
- `echo` boolean

## Request body

- object
  - `merchantId` integer, required — Merchant id
  - `tenderType` string, required — Tender type. Values: Card, Cash, Check, ACH (if enabled)
  - `amount` number, float, required — Amount
  - `cardAccount` object, required — Card account object
    - `number` string — Card Number
    - `expiryMonth` string — Card Expiration Month
    - `expiryYear` string — Card Expiration Year
    - `token` string — Vaulted Payment Token
    - `avsStreet` string — Billing Street Address (required if Loss Prevention Setting is turned on)
    - `avsZip` string — Billing Postal Code (required if Loss Prevention Setting is turned on)
    - `cvv` string — 3 or 4 digit card verification value (CVV) (required if Loss Prevention Setting is turned on)
    - `magstripe` string — Magnetic Stripe Data
    - `alias` string — Client provided, easy to remember name for the card
    - `emvData` string — Byte array converted to string - ICC, chip data for EMV transactions
    - `emvDataKsn` string — KSN for encrypted emv data
    - `track1` string — Track 1 data - base64 encrypted value or plaintext
    - `track2` string — Track 2 data - base64 encrypted value or plaintext
    - `track1Ksn` string — KSN for encrypted track 1 data
    - `track2Ksn` string — KSN for encrypted track 2 data

## Response `200`

200

- object
  - `created` string
  - `paymentToken` string
  - `id` integer
  - `creatorName` string
  - `merchantId` integer
  - `batch` string
  - `batchId` integer
  - `tenderType` string
  - `currency` string
  - `amount` string
  - `cardAccount` object
    - `cardType` string
    - `entryMode` string
    - `last4` string
    - `cardId` string
    - `token` string
    - `expiryMonth` string
    - `expiryYear` string
    - `hasContract` boolean
    - `cardPresent` boolean
  - `authOnly` boolean
  - `authCode` string
  - `status` string
  - `risk` object
  - `requireSignature` boolean
  - `customer` object
    - `id` integer
    - `created` string
    - `name` string
    - `firstName` string
    - `lastName` string
    - `number` string
    - `sales` string
    - `loyaltyStatus` string
    - `loyaltyEnrolled` string
    - `customFields` object[]
    - `displayColor` string
  - `settledAmount` string
  - `settledCurrency` string
  - `settledDate` string
  - `cardPresent` boolean
  - `authMessage` string
  - `availableAuthAmount` string
  - `reference` string
  - `tax` string
  - `invoice` string
  - `customerCode` string
  - `customerName` string
  - `clientReference` string
  - `type` string
  - `taxExempt` boolean
  - `reviewIndicator` integer
  - `source` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/mxmerchant/apis/checkout-api.md) · [All operations](https://skmtc.net/mxmerchant/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mxmerchant/checkout-api/versions/6807b698abcb/schema)