---
title: "Add/Return transaction (single)"
method: POST
path: "/transactions"
---

# Add/Return transaction (single)

`POST /transactions`

Lets you add a new transaction or return an existing transaction. It supports both loyalty and not-interested transactions.

## Query parameters

- `identifierName` 'mobile' | 'email' | 'externalId' | 'id' | 'wechat' | 'martjackId' | 'fbId' | 'cardnumber' | 'cardExternalId', required
- `identifierValue` string, required
- `accountId` string
- `use_async` boolean
- `source` 'INSTORE( for InStore)' | 'WECHAT (WeChat)' | 'MARTJACK(AnywhereCommerce)' | 'WEB_ENGAGE (Web-engage integration)' | 'ECOMMERCE (ECOMMERCE)' | 'JD (JD)' | 'TAOBAO (Taobao)' | 'TMALL (TMall)' | 'FACEBOOK (Facebook)' | 'WEBSITE (other website)' | 'OTHERS (any other source).'

## Headers

- `X-CAP-DIRECT-REPLAY` boolean

## Request body

- object
  - `type` 'REGULAR' | 'RETURN' | 'NOT_INTERESTED' | 'NOT_INTERESTED_RETURN', required — The type of transaction.
  - `billNumber` string, required — Bill number.
  - `billAmount` integer, required — Value for the bill number.

## Response `200`

200

- union
  - object
    - `createdId` integer
    - `warnings` unknown[]
      - unknown
    - `errors` unknown[]
      - unknown
    - `sideEffects` object[]
      - `entityType` string
      - `rawAwardedPoints` integer
      - `awardedPoints` integer
      - `type` string
    - `rawSideEffects` object[]
      - `awardOn` string
      - `awardStrategyId` string
      - `awardedOn` string
      - `awardedOnMillis` string
      - `billNumber` string
      - `evaluatedEntity` string
      - `expiryDate` string
      - `expiryDateMillis` string
      - `expiryStrategyId` string
      - `lineItemId` string
      - `pointTypeId` string
      - `pointTypeIsRedeemable` string
      - `pointTypeName` string
      - `points` string
      - `programId` string
      - `promoId` string
      - `promoIdentifier` string
      - `promoName` string
      - `sourceId` string
      - `sourceType` string
      - `tenderCodeId` string
      - `type` string
    - `customerInfo` object
      - `firstName` string
      - `lastName` string
  - object
    - `createdId` integer
    - `warnings` unknown[]
      - unknown
    - `errors` unknown[]
      - unknown
    - `loyaltyDetails` unknown[]
      - unknown
    - `customerInfo` object
      - `firstName` string
      - `lastName` string

## Other responses

- `201` — 201
- `400` — 400

---

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