---
title: "Void API"
method: POST
path: "/?void_api"
---

# Void API

`POST /?void_api`

## 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 'void'
  - `amount` number, double — Base amount of original sale (Ex: 10.00). The amount required when ref_txn_id is provided. If auth_code, rrn, transaction number, and STAN are provided in the request, then the amount is required.
  - `ref_txn_id` string, required — A unique response transaction id from the response of a sale transaction (Numeric - Length of 20 chars)
  - `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
  - `auth_code` string — Approval code response from sale transaction (Alphanumeric - Max length of 8 chars)
  - `rrn` string — RRN number from sale txn response (Numeric - Max length of 15 chars)
  - `tran_no` integer — Should match the original sale tran_no (Numeric - Max length of chars 11)
  - `stan` integer — Should match the original sale stan (Numeric - Max length of chars 6)
  - `phone` integer — Customer phone number- 10 digit Numeric (Ex: 5247896523)
  - `email` string — Customer email id - Varchar (Ex: test@domain.com, Max length of 50 chars)
  - `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)