---
title: "Merchant Add - Postilion"
method: POST
path: "/api/valor/create?postilion"
---

# Merchant Add - Postilion

`POST /api/valor/create?postilion`

## Headers

- `Authorization` string, required
- `isv-secret-key` string

## Request body

- object
  - `legalName` string, required — Max length is 48 char - varchar (Ex: Quick book dba, Valor Cafe )
  - `dbaName` string, required — Max length is 48 char - varchar (Ex: SRM Hardware LLC, Merchant Firm Cafe)
  - `firstName` string, required — Max length is 35 char - varchar (First name of the Mechant)
  - `lastName` string, required — Max length is 35 char - varchar (Last name of the Mechant)
  - `ownerName` string, required — Boarded by ISO & Sub-ISO name - varchar
  - `emailId` string, required — Merchant email id - Varchar (Ex: test@domain.com, Max length of 64 chars)
  - `userName` string, required — Merchant user name (Alphanumeric length of 35 chars)
  - `mobile` string, required — Merchnat phone number- 10 digit Numeric (Ex: 5247896523)
  - `legalAddress` string, required — Legal Address should be max 45 chars - Alphanumeric
  - `legalCity` string, required — City should be allowed max 50 chars of string (Ex: New York, San Francisco)
  - `legalState` string, required — State 2 chars of capital (Ex: New York - NY, California - CA)
  - `legalCountry` string, required — Legal country should be mention default set us US
  - `legalZipCode` string, required — Legal zip code should be 5 digits (Numeric - Ex: 10001, 90002)
  - `legalTimezone` string, required — Time zone (3 char eg: EST, AST ,PST, HST, MST)
  - `role` string — Should be set as '10' it is related to role of Merchant
  - `userType` integer, required — Should be set as '4' - User type for the merchant
  - `isTxnAllowed` string, required — Should be set isTxnAllowed default as '1'
  - `businessType` string, required — Should be sent as business type (varchar - Ex: Retail, Direct Marketing)
  - `storeData` object[], required
    - `storeName` string — Store name of Merchant (Max length is 48 char)
    - `storeAddress` string, required — Store address should be max 25 chars - Alphanumeric
    - `storeCity` string, required — Store city should be allowed max 25 chars of string (Ex: New York, San Francisco)
    - `storeState` string, required — Store state 2 chars of capital (Ex: New York - NY, California - CA)
    - `storeCountry` string — Store country should be mention default set us US
    - `storeZipCode` string, required — Store zip code should be 5 digits (Numeric - Ex: 10001, 90002)
    - `storeTimezone` string, required — Store time zone (3 char eg: EST,AST,PST,HST,MST)
    - `superVisorName` string, required — Name of the supervisor (Max length is 25 char)
    - `superVisorEmail` string, required — Supervisor email id - Varchar (Ex: test@domain.com, Max length of 50 chars)
    - `superVisorContact` string — Supervisor contact number 10 digit Numeric (Ex: 5247896523)
    - `mccCode` string, required — It should be 4 digit MCC (Ex: 8765, 5993)
    - `descriptors` string — It should be 25 chars
    - `epiData` object[]
      - `device` string, required — <p>The model description of the device to be boarded for that merchant. Have to pass the 'Device ID'</p> <table class="valor_module_table"> <tr> <th>Device Name</th> <th>Device ID</th> </tr> <tr> <td>VL100</td> <td>130</td> </tr> <tr> <td>VL110</td> <td>145</td> </tr> <tr> <td>VL500</td> <td>136</td> </tr> <tr> <td>VP100</td> <td>207</td> </tr> <tr> <td>RCKT</td> <td>274</td> </tr> <tr> <td>Virtual Terminal</td> <td>139</td> </tr> <tr> <td>VP500</td> <td>235</td> </tr> <tr> <td>VL100 Pro</td> <td>540</td> </tr> <tr> <td>VL550</td> <td>533</td> </tr> <tr> <td>VP550</td> <td>412</td> </tr> <tr> <td>VP550E</td> <td>524</td> </tr> <tr> <td>VP800</td> <td>527</td> </tr> <tr> <td>VL300</td> <td>519</td> </tr> <tr> <td>VP350</td> <td>530</td> </tr> <tr> <td>N950</td> <td>622</td> </tr> <tr> <td>VP550C</td> <td>737</td> </tr> <tr> <td>X800</td> <td>738</td> </tr></table>
      - `deviceType` string, required — <p>The type description of the device / terminal Possible Options.</p> <table class="valor_module_table"> <tr> <th>Device Name</th> <th>Device Type</th> </tr> <tr> <td>VL100, VP100, VL100 Pro, VL300</td> <td>Desktop POS</td> </tr> <tr> <td>VL500, VP500, VP550, VP550E, VP800, VP350, N950, VP550C, X800</td> <td>Smart POS</td> </tr> <tr> <td>VL110</td> <td>Handheld POS</td> </tr> <tr> <td>RCKT</td> <td>DONGLE</td> </tr> <tr> <td>Virtual Terminal</td> <td>Soft POS</td> </tr> <tr> <td>VL550</td> <td>Portable</td> </tr></table>
      - `processor` string, required
      - `epiLabel` string, required — Label description for the device /terminal. Max length 48 char
      - `batch_number` string
      - `features` object
        - `tip` object
          - `enabled` boolean, required
          - `value` integer[], required
        - `surcharge` object
          - `enabled` boolean, required
          - `value` string, required
        - `tax` object
          - `enabled` boolean, required
          - `value` string, required
      - `processorData` object[]
        - `midDP` string, required — Merchant id related to the profile
        - `groupIdDP` string, required — Group id to the particular device / terminal in surcharge profile.
        - `termNoDP` string, required — termNo mapped to the particular device / terminal in surcharge profile. If the epi is to be boarded on Traditional profile set it as ""
        - `websiteDP` string, required — Website name for profile
        - `mid_Dp6` string, required — mid_Dp6 is Postilion MID
        - `tid_Dp6` string, required — mid_Dp6 is Postilion TID
        - `certificateNo` string, required — Certificate No is Postilion Certificate No
        - `EBTcash` integer, required — EBT cash related to the surcharge profile. If the epi is to be boarded on Traditional profile set it as 0 or 1
        - `EBTfood` integer, required — EBT food related to the surcharge profile. If the epi is to be boarded on Traditional profile set it as 0 or 1
        - `EbtNoDP` string, required — Ebt number for the particular device / terminal in surcharge profile (Alphanumeric Max length 7)
        - `surchargeIndicator` integer, required — The value 0 means % and 1 means dollar
        - `surchargePercentage` string — If the epi is to be boarded on a traditional Profile set it as "null". Surcharge indicator % means the value should be (3.000) and dollar (3.00)
        - `label` string, required — If program type set as "surcharge" or "cashdiscount".
        - `programType` string, required — The storename on which the device/terminal created is mapped on this field
        - `c_nameDP3` string, required — This field is related to the gift card vendor: if the vendor is Valutec, assign 1; if the vendor is Factor4, assign 2.
        - `tidDP3` string, required — Provide the Terminal ID value for Valutec (Numeric Max length 10)
        - `clientID_DP` string, required — Provide the Client ID values for Valutec (Alphanumeric Max length 36)
        - `vendor` integer — This field is related to the ACH vendor: if the vendor is ACHECK21, assign 1; if the vendor is ACHBANKING, assign 2.
        - `client_id` string — Provide the name_on_account for ACHECK21 (Numeric Max Length for 10)
        - `status` string — Provide the status for ACHECK21/ACHBANKING (status as 1)
        - `name_on_account` string — Provide the name_on_account for ACHBANKING (Alphanumeric Max length of 50)
        - `auth_token` string — This value is required when the vendor ID is 2. Provide the auth_token for ACHBANKING ( Numeric Max length 10)
        - `app_key` string — This value is required when the vendor ID is 2. Provide the app_key for ACHBANKING (Alphanumeric Max length 128)
        - `mid_flexfactor` string — This field is related to flexfactor, provide mid_flexfactor (Alphanumeric Max length 64)
        - `tid_flexfactor` string — This field is related to flexfactor, provide tid_flexfactor (Alphanumeric Max length 8)
        - `site_id_flexfactor` string — This field is related to flexfactor, provide site_id_flexfactor (Alphanumeric Max length 64)
        - `app_key_flexfactor` string — This field is related to flexfactor, provide app_key_flexfactor (Alphanumeric Max length 128)
        - `app_secret_flexfactor` string — This field is related to flexfactor, provide app_secret_flexfactor (Alphanumeric Max length 256)
        - `location_DP4` string — Provide the Location ID values for Factor4 (Alphanumeric Max length 15)
        - `clientID_DP4` string — Provide the Client ID values for Factor4 (Alphanumeric Max length 36)
        - `integration_authDP4` string — Provide the Integration Auth values for Factor4 (Alphanumeric Max length 64)
        - `integration_pwdDP4` string — Provide the Integration PWD values for Factor4 (Alphanumeric Max length 64)
      - `selectedState` string, required — The State which is selected to be sent on it with the State code
      - `dp_direct_indicator` string — <p>The dp_direct_indicator and dp_processor mapping with corresponding processor details. Possible options are listed below.</p> <table class="valor_module_table"> <tr> <th>dp_direct_indicator</th> <th>dp_processor</th> <th>Processor Name</th> </tr> <tr> <td>1</td> <td>10</td> <td>None</td> </tr> <tr> <td>1</td> <td>41</td> <td style="white-space: nowrap;">FDR OMAHA (F/B)</td> </tr> <tr> <td>1</td> <td>45</td> <td style="white-space: nowrap;">FDR NORTH / CARDNET</td> </tr> <tr> <td>1</td> <td>48</td> <td style="white-space: nowrap;">FDR NORTH / BUYPASS</td> </tr> <tr> <td>1</td> <td>51</td> <td style="white-space: nowrap;">FDR NORTH / NASHVILLE</td> </tr> <tr> <td>2</td> <td>10</td> <td>None</td> </tr> <tr> <td>2</td> <td>82</td> <td style="white-space: nowrap;">FDR OMAHA (F/B)</td> </tr> <tr> <td>2</td> <td>83</td> <td style="white-space: nowrap;">FDR NORTH / CARDNET</td> </tr> <tr> <td>2</td> <td>84</td> <td style="white-space: nowrap;">FDR NORTH / BUYPASS</td> </tr> <tr> <td>2</td> <td>85</td> <td style="white-space: nowrap;">FDR NORTH / NASHVILLE</td> </tr> </table>
      - `dp_processor` string
  - `moduleList` integer[], required — <table> <tbody><tr> <th>Module</th> <th>Module ID</th> </tr> <tr> <td>User Management</td> <td>1</td> </tr> <tr> <td>Transactions</td> <td>3</td> </tr> <tr> <td>Settings</td> <td>6</td> </tr> <tr> <td>Virtual Terminal</td> <td>14</td> </tr> <tr> <td>Device Management</td> <td>15</td> </tr> <tr> <td>Engage My Customers</td> <td>17</td> </tr> <tr> <td>Promotions</td> <td>18</td> </tr> <tr> <td>Valor Shield RT</td> <td>19</td> </tr> <tr> <td>Contact Us</td> <td>20</td> </tr> <tr> <td>Support</td> <td>24</td> </tr> <tr> <td>My Tickets</td> <td>25</td> </tr> <tr> <td>Vault</td> <td>29</td> </tr> </tbody></table>
  - `selectedState` string, required — State 2 chars of capital (Ex: New York - NY, California - CA)
  - `processor` string, required — Update the processor params 6
  - `rollUp` string, required — Set value 0 or 1 (This value allows merchants to access the virtual terminal free of charge for 6 months)
  - `programType` string, required — 1 (cash discount) or 2 (traditional)
  - `associate_user_name` string — ISO user name (Alphanumeric length of 35 chars)
  - `ActivationNotification` string — If the ActivationNotification is set to true, it indicates that an activation email will be sent to the merchant. If set to false, it means that no activation email will be sent.
  - `isv_user_name` string[]

## 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)