---
title: "TIP Adjust API"
method: POST
path: "/?tipadjust_api"
---

# TIP Adjust API

`POST /?tipadjust_api`

## Request body

- object
  - `appid` string, required — Merchant APP ID (Alphanumeric - Length of 32 chars and special chars $@%#)
  - `appkey` string, required — Merchant APP ID (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
  - `amount` number, double, required — Transaction amount is dollar. A request should not be sent when the amount is 0. The amount must be greater than zero
  - `txn_type` string, required — Transaction type always should be set as 'tipadjust'
  - `ref_txn_id` string, required — A unique response transaction id from the response of a sale transaction (Numeric - Length of 20 chars)
  - `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)
  - `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)