---
title: "Store Sync (RCKT Device)"
method: POST
path: "/api/valor/store-sync?rckt"
---

# Store Sync (RCKT Device)

`POST /api/valor/store-sync?rckt`

## Headers

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

## Request body

- object
  - `mp_id` integer, required — It is a merchant profile id which is respective to the particular merchant (Max length of 11 chars)
  - `store_id` integer, required — It is a merchant store id which is respective to the particular merchant (Max length of 11 chars)
  - `device_type` integer, required — VT - 1, RCKT - 2, Hardware - 3
  - `data` object, required
    - `tip_enabled` boolean — Excepted either true or false.
    - `tip_on_screen` boolean — Excepted either true or false.
    - `tip_options_type` integer — <table class="valor_module_table"> <tr> <th>Tip Option Type</th> <th>Options</th> </tr> <tr> <td>Percentage</td> <td>1</td> </tr> <tr> <td>Dollar</td> <td>2</td> </tr> <tr> <td>Variable</td> <td>3</td> </tr> </table>
    - `tip_custom_type` integer — <table class="valor_module_table"> <tr> <th>Tip Custom Type</th> <th>Options</th> </tr> <tr> <td>Percentage</td> <td>1</td> </tr> <tr> <td>Dollar</td> <td>2</td> </tr> </table>
    - `tip_custom_range` integer — The Input must fall within the range of 0 to 99999.
    - `tip_options` integer[] — The Input must fall within the range of '1' to '350' and must contain exactly eight unique numeric values, split into two sets of four.
    - `max_tip_percentage` integer — The Input must fall within the range of 1 to 9999.
    - `max_tip_dollar` integer — The Input must fall within the range of 1 to 9999.
    - `fixed_tip_enabled` boolean — Excepted either true or false.
    - `fixed_tip_in_percentage` boolean — Excepted either true or false.
    - `fixed_tip_value` integer — The Input must fall within the range of 1 to 9999.
    - `tax_enabled` boolean — Excepted either true or false.
    - `include_tax_for_cash` boolean — Excepted either true or false.
    - `state_tax` number, float — The Input must fall within the range of 0.001 to 15.000.
    - `city_tax` number, float — The Input must fall within the range of 0.001 to 15.000.
    - `reduced_tax` number, float — The Input must fall within the range of 0.001 to 15.000.
    - `enable_for_all_debit_card` boolean — Excepted either true or false.
    - `signature_debit_only` boolean — Excepted either true or false.
    - `customer_fee_disclosure` boolean — Excepted either true or false.
    - `include_tip_on_screen` boolean — Excepted either true or false.
    - `apply_fee_with_tip` boolean — Excepted either true or false.
    - `include_tax` boolean — Excepted either true or false.
    - `apply_fee_with_tax` boolean — Excepted either true or false.
    - `include_cash` boolean — Excepted either true or false.
    - `cash_discount_enabled` boolean — Excepted either true or false.
    - `cash_discount_label` string — The Input should consist of 1 to 17 characters at most.
    - `show_discount_enabled` boolean — The Input should consist of 1 to 17 characters at most.
    - `show_remove_fee` boolean — Excepted either true or false.
    - `prompt_password_to_remove_fee` boolean — Excepted either true or false.
    - `email_settlement_report` boolean — Excepted either true or false.
    - `hide_receipt_option` boolean — Excepted either true or false.
    - `sms_receipt` boolean — Excepted either true or false.
    - `email_receipt` boolean — Excepted either true or false.
    - `force_on_screen_signature` boolean — Excepted either true or false.
    - `forced_signature_prompt` boolean — Excepted either true or false.
    - `avs` integer — <table class="valor_module_table"> <tr> <th>AVS</th> <th>Options</th> </tr> <tr> <td>None</td> <td>1</td> </tr> <tr> <td>Zip Only</td> <td>2</td> </tr> <tr> <td>Address Only</td> <td>3</td> </tr> <tr> <td>Zip & Address</td> <td>4</td> </tr> </table>
    - `avs_action_on_failed` integer — <table class="valor_module_table"> <tr> <th>AVS Action on Failed</th> <th>Options</th> </tr> <tr> <td>Decline</td> <td>1</td> </tr> <tr> <td>Approve and Notify</td> <td>2</td> </tr> </table>
    - `disable_pin_debit` boolean — Excepted either true or false.
    - `cash_back_on_debit_cards_enabled` boolean — Excepted either true or false.
    - `cash_back_on_debit_cards_amount` integer — The Input must fall within the range of 1 to 9999.
    - `qsr_enabled` boolean — Excepted either true or false.
    - `qsr_amount` number, float — The Input must fall within the range of 1.00 to 250.00.
    - `pre_sale_qr_allowed` boolean — Excepted either true or false.
    - `password_for_void` boolean — Excepted either true or false.
    - `password_for_refund_enabled` boolean — Excepted either true or false.
    - `password_for_refund_amount` integer — The Input must fall within the range of 1 to 9999.
    - `password_for_preauth` boolean — Excepted either true or false.
    - `partial_approval` boolean — Excepted either true or false.
    - `application_options` integer — <table class="valor_module_table"> <tr> <th>Application Type</th> <th>Options</th> </tr> <tr> <td>Default</td> <td>1</td> </tr> <tr> <td>Dual Pricing</td> <td>2</td> </tr> <tr> <td>Bin Base Surcharge</td> <td>3</td> </tr> <tr> <td>Falcon Manual Tax</td> <td>4</td> </tr> <tr> <td>Falcon Exclusive Tax</td> <td>5</td> </tr> <tr> <td>Falcon Inclusive Tax</td> <td>6</td> </tr> </table>
    - `amount_confirmation_screen_enabled` boolean — Excepted either true or false.
    - `amount_confirmation_before_present_card` boolean — Excepted either true or false.
    - `validate_fee` boolean — Excepted either true or false.
    - `assigned_keygroup` string — The "assigned_keygroup" parameter is only applicable in the production environment. Enter Key Group Name
    - `force_acknowledge` boolean — The "force_acknowledge" parameter is only applicable in the production environment. Excepted either true or false.
    - `header_two` string — The Input should consist of 1 to 26 characters at most.
    - `header_three` string — The Input should consist of 1 to 25 characters at most.
    - `header_four` string — The Input should consist of 1 to 25 characters at most.
    - `header_five` string — The Input should consist of 1 to 25 characters at most.
    - `header_six` string — The Input should consist of 1 to 25 characters at most.
    - `header_seven` string — The Input should consist of 1 to 25 characters at most.
    - `footer_one` string — The Input should consist of 1 to 24 characters at most.
    - `footer_two` string — The Input should consist of 1 to 24 characters at most.
    - `footer_three` string — The Input should consist of 1 to 24 characters at most.
    - `footer_four` string — The Input should consist of 1 to 24 characters at most.
    - `footer_five` string — The Input should consist of 1 to 24 characters at most.
    - `footer_six` string — The Input should consist of 1 to 24 characters at most.
    - `footer_seven` string — The Input should consist of 1 to 24 characters at most.
    - `footer_eight` string — The Input should consist of 1 to 24 characters at most.
    - `footer_nine` string — The Input should consist of 1 to 24 characters at most.
    - `footer_ten` string — The Input should consist of 1 to 24 characters at most.
    - `enable_disclaimer` boolean — Excepted either true or false.
    - `disclaimer_one` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_two` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_three` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_four` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_five` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_six` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_seven` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_eigth` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_nine` string — The Input should consist of 1 to 24 characters at most.
    - `disclaimer_ten` string — The Input should consist of 1 to 24 characters at most.
    - `sleep_timer` integer — The Input must fall within the range of '30' to '600000'.
    - `batch_out_timer` string — The Input must be in 15-min intervals, from '00:00 AM' to '11:45 PM'.
    - `show_device_lable` boolean — Excepted either true or false.
    - `password_for_ebt` boolean — Excepted either true or false.
    - `server_clerk_setup` boolean — Excepted either true or false.
    - `clerk_mandate` boolean — Excepted either true or false.
    - `add_clerk_details` object
      - `label` string — The Input should consist of 1 to 10 characters at most.
      - `options` object[]
        - `serverid` string — The Input must fall within the range of 1 to 999.
        - `servername` string — The Input should consist of 1 to 14 characters at most.
    - `surcharge_label` string — The Input should consist of 1 to 26 characters at most.
    - `card_type` integer — Expected values are 1, 2 or 3.
    - `visa_ten_dollar` boolean — Excepted either true or false.
    - `manual_entry` boolean — Excepted either true or false.
    - `manual_entry_credit` boolean — Excepted either true or false.
    - `manual_entry_debit` boolean — Excepted either true or false.
    - `bypass_cvv_entry` boolean — Excepted either true or false.
    - `surcharge_indicator` boolean — Excepted either true or false.
    - `surcharge_indicator_mode` integer — Expected values are 1 or 2.
    - `surcharge_range_from` number, float — The Input must fall within the range of '0.01' to '9999.99'.
    - `surcharge_range_end` number, float — The Input must fall within the range of '0.01' to '9999.99'.
    - `food_amount` boolean — Excepted either true or false.
    - `remove_sub_total` boolean — Excepted either true or false.
    - `show_card_cash_presale` boolean — Excepted either true or false.
    - `password_for_cash` boolean — Excepted either true or false.
    - `show_pricing_on_receipt` boolean — Excepted either true or false.
    - `show_savings` boolean — Excepted either true or false.
    - `saving_label_card` string — The Input should consist of 1 to 31 characters at most.
    - `saving_label_cash` string — The Input should consist of 1 to 31 characters at most.
    - `show_card_cash_pricing` boolean — Excepted either true or false.
    - `card_label_on_terminal` string — The Input should consist of 1 to 8 characters at most.
    - `customer_satisfaction_survey` boolean — Excepted either true or false.
    - `additional_input_enabled` boolean — Excepted either true or false.
    - `additional_input` object[]
      - `display_text` string — The input should be a string of 1 to 16 alphanumeric characters without special characters.
      - `text_format` string — Expected values are 1 or 2.
      - `min_length` string — The Input must fall within the range of 0 to 15.
      - `max_length` string — The Input must fall within the range of 1 to 16.
      - `mandatory` integer — Expected values are 1 or 2.
    - `ebt_cashback_enabled` boolean — Excepted either true or false.
    - `ebt_cashback_amount` integer — The Input must fall within the range of '1' to '9999'.
  - `associate_user_name` string — ISO user name (Alphanumeric length of 35 chars)

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