---
title: "Create TransactionRequest"
method: POST
path: "/v2/clients/{ClientID}/transactionrequests"
tags: ["TransactionRequest"]
---

# Create TransactionRequest

`POST /v2/clients/{ClientID}/transactionrequests`

Creates a TransactionRequest One-time Payment Portal (<<glossary:OTPP>>).

## Path parameters

- `ClientID` string, required

## Request body

- CreateTransactionRequest
  - `type` string, required — Transaction Type. Currently, only `pull` is supported.
  - `user1` string — 1-15 character User1 Data. *Optional*
  - `user2` string — 1-15 character User2 Data. *Optional*
  - `amount` string, required — See how to [properly format an amount](/reference/data#how-to-specify-an-amount-value).
  - `customer` object, required — Customer
    - `name` object, required — Name
      - `first` string, required — First Name
      - `last` string, required — Last Name
    - `address` object — Address
      - `line1` string, required — Address Line 1
      - `line2` string — Address Line 2 *Optional*
      - `city` string, required — City
      - `state` string, required — State Code [State Code](https://developers.tabapay.com/reference/us-state-codes#/) must be a valid 2-character code if `country` is [840](https://developers.tabapay.com/reference/country-codes#/) or [Canadian 2-char code](https://developers.tabapay.com/reference/canadian-province-codes#/) if [124](https://developers.tabapay.com/reference/country-codes#/).
      - `zipcode` string, required — Zip Code If `country` is `840`, `zipcode` must be 5 or 9 digits. If country is `124`, `zipcode` must be in the *A1A 1A1* format. Zip codes from other countries will not be checked.
      - `country` string, required — [Country Code](https://developers.tabapay.com/reference/country-codes#/) *Optional. Default is `840`*
    - `callback` object — Callback, contact TabaPay. Optional.
      - `type` string, required — Currently, `URL` is the only value supported.
      - `value` string, required — URL String

## Response `200`

A Transaction is created and processing is completed.

- TransactionRequestResponse
  - `SC` integer — HTTP Status Code
  - `EC` string — Internal Error Code. Present if `SC` is `200`.
  - `EM` string — Short Description of Error if `EC` is not `"0"`.
  - `otppID` string — 22-character TransactionRequestID (<<glossary:OTPP>>) Present if `SC` is `200`.
  - `link` string — URL Present if `SC` is `200`.

---

[API](https://skmtc.dev/tabapay/apis/tabapay-apis.md) · [All operations](https://skmtc.dev/tabapay/apis/tabapay-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tabapay/tabapay-apis/revisions/154fa3d585cf/schema)