---
title: "Capture/Ticket API"
method: POST
path: "/?ticket"
---

# Capture/Ticket API

`POST /?ticket`

## Request body

- object
  - `appid` string, required — Merchant APP ID (Alphanumeric - Length of 32 chars and special chars $@%#)
  - `appkey` string, required — Merchant APP KEY (Alphanumeric - Length of 32 chars and special chars $@%#)
  - `epi` string, required — EPI is an end point identifier, Identify the device on valor infrastructure, it's a 10 digit number starts with 2
  - `txn_type` string, required — Transaction type always should be set as 'capture'
  - `ref_txn_id` string, required — A unique response transaction id from the response of a sale transaction (Numeric - Length of 20 chars)
  - `amount` number, double, required — Transaction amount - Maximum amount $99,999.99 (Ex: 0.1 to 99,999.99). A request should not be sent when the amount is 0. The amount must be greater than zero
  - `surchargeIndicator` string, required — The value '0' represents a transaction being ran on the traditional MID with no custom fee added, while '1' represents a transaction being ran on the cash discounting MID with the custom fee added
  - `tran_no` integer — Should match the original sale tran_no (Numeric - Max length of chars 11)
  - `stan` string — Should match the original sale stan (Numeric - Max length of chars 6)
  - `rrn` string — RRN number from sale txn response (Numeric - Max length of 15 chars)
  - `auth_code` string — Approval code response from sale transaction (Alphanumeric - Max length of 8 chars)
  - `surchargeAmount` string — Additional fee of surcharge amount - Currency $ (Eg: 10.00)
  - `tax_amount` string — The tax amount should be passed for example, `$10.00` should be sent as `1000` and `$2.01` as `201`.
  - `child_epi` string — If the merchant has multi-MIDs, they need to send both the child EPI and the parent EPI in the EPI request

## Response `200`

200

- object

## Other responses

- `400` — 400

---

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