Create Merchant Configs - Order Preferences
Use these endpoints to set Configs related to Order Preferences
This endpoint uses HMAC with SHA-256
Check out our API Authentication section to learn more
To Add Merchant Configurations to a Skipify Merchant Account, send an API call to:
Staging: POST https://stage-merchants.skipify.com/merchants/{MerchantId}/configs
Production: POST https://merchants.skipify.com/merchants/{MerchantId}/configs
Create No Shipping Required Config
Request Body Parameters
| Parameter Name | Required | Type | Description/Value |
|---|---|---|---|
| name | yes | string | NO_SHIPPING_REQUIRED |
| enabled | yes | boolean | true |
| value | yes | boolean | true |
Request Body Example
{
"name": "NO_SHIPPING_REQUIRED",
"enabled": true,
"value": true
}
API Response
Response Body Parameters (WIP)
| Parameter Name | Type | Description |
|---|---|---|
| enabled | boolean | The current status of the configuration |
| name | string | The name of the configuration |
| value | boolean | true |
| type | string | The Type of configuration if applicable |
| configId | string | The ID of this configuration |
| merchantId | string | The Skipify Merchant identifier |
| createdAt | string, dateTime | The date/time this configuration was created Ex: `2024-06-02T21:48:02Z |
| updatedAt | string, dateTime | The date/time this configuration was last updated Ex: `2024-06-02T21:48:02Z |
Response Body Example
{
"enabled": true,
"name": "NO_SHIPPING_REQUIRED",
"value": true,
"type": "order",
"configId": "d710423e-dc98-4f78-8e98-ba8780faab77",
"merchantId": "215b4518-96d1-45c8-ba95-614edf1abd3b",
"createdAt": "2024-06-10T20:04:20.595Z",
"updatedAt": "2024-06-10T20:04:20.595Z"
}
Create Tipping Percentages Config
Request Body Parameters
| Parameter Name | Required | Type | Description/Value |
|---|---|---|---|
| name | yes | string | TIPPING_PERCENTAGES |
| enabled | yes | boolean | true |
| value | yes | array/integers | Send Tipping percentage prompts to be displayed to Shopper |
Note* - This Configuration is only applicable to merchants that accept tips/gratuities in service-based establishments.
Request Body Example
{
"name": "TIPPING_PERCENTAGES",
"enabled": true,
"value": [
18,
20,
25
]
}
API Response
Response Body Parameters
| Parameter Name | Type | Description |
|---|---|---|
| enabled | boolean | The current status of the configuration |
| name | string | The Name of the Configuration |
| value | array, integers | The values of tipping percentages configured |
| type | string, nullable | The Type of configuration |
| configId | string | The Id of this configuration |
| merchantId | string | The Skipify Merchant Identifier |
| createdAt | string, dateTime | The created date/time for this configuration Ex: `2024-06-02T21:48:02Z |
| updatedAt | string, dateTime | The date/time this configuration was last updated Ex: `2024-06-02T21:48:02Z |
Response Body Example
{
"enabled": true,
"name": "TIPPING_PERCENTAGES",
"value": [
18,
20,
25
],
"type": "order",
"configId": "530d1a01-6f7d-4399-b080-ac381ea1f0cf",
"merchantId": "264b9068-96d1-45c8-ba95-614edf1abd3b",
"createdAt": "2024-06-10T20:07:44.359Z",
"updatedAt": "2024-06-10T20:07:44.359Z"
}
Create General Fee Config
The General Fee Configuration allows you to set a Flat $ amount or Percentage % fee to be applied to all orders, shown to the shopper and added to the order total for payment processing.
Request Body Parameters
| Parameter Name | Required | Type | Description/Value |
|---|---|---|---|
| name | yes | string | GENERAL_FEE |
| enabled | yes | boolean | true |
| value | yes | array (integer, string) | See next table for parameters in value array |
Value Array Request Parameters
| Parameter Name | Required | Type | Description/Value |
|---|---|---|---|
| value | yes | integer | The Value of the General Fee as a percentage (if style=percentage), or minor units (if style=flat) |
| style | yes | string | enums: PERCENTAGE, FLAT |
| feeType | yes | string | GENERAL_FEE |
| description | yes | string | The description of the fee that will appear to the Shopper during checkout |
Note* - Please check with your Implementation Engineer before setting this Configuration in production
Request Body Example
{
"name": "GENERAL_FEE",
"enabled": true,
"value": {
"description": "string",
"feeType": "GENERAL_FEE",
"value": 3,
"style": "PERCENTAGE"
}
}
API Response
Response Body Parameters (WIP)
| Parameter Name | Type | Description |
|---|---|---|
| enabled | boolean | The current status of the configuration |
| name | string | The Name of the Configuration |
| value | array, integers | An array of values for the GENERAL_FEE |
| type | string | The Type of configuration if applicable i.e. |
| configId | string | The Id of this configuration |
| merchantId | string | The Skipify Merchant Identifier |
| createdAt | string, dateTime | The created date/time for this configuration Ex: `2024-06-02T21:48:02Z |
| updatedAt | string, dateTime | The date/time this configuration was last updated Ex: `2024-06-02T21:48:02Z |
Response Body Example (WIP)
{
"enabled": true,
"name": "GENERAL_FEE",
"value": {
"style": "PERCENTAGE",
"value": 3,
"description": "Cleaning Fee",
"feeType": "GENERAL_FEE"
},
"type": "order",
"configId": "bd8ec59a-fa7f-41c0-b72e-167c2f63d51f",
"merchantId": "215b9068-96d1-45c8-ba95-614edf1abd3b",
"createdAt": "2025-01-10T20:15:56.564Z",
"updatedAt": "2025-01-10T20:15:56.564Z"
}
Create Surcharge Fee Config
The Surcharge Fee Configuration allows you to set a Flat $ amount or Percentage % fee to be applied to orders with a credit card. Skipify performs a BIN check in the background to ensure this fee is not applied to Debit card transactions.
Request Body Parameters
| Parameter Name | Required | Type | Description/Value |
|---|---|---|---|
| name | yes | string | SURCHARGE_FEE |
| enabled | yes | boolean | true |
| value | yes | array | See next table for parameters in value array |
Value array Body Parameters
| Parameter Name | Required | Type | Description/Value |
|---|---|---|---|
| value | yes | integer | The Value of the surcharge as a percentage (if style=percentage), or minor units (if style=flat) |
| style | yes | string | enums: PERCENTAGE, FLAT |
| feeType | yes | string | SURCHARGE_FEE |
| description | yes | string | The description of the fee that will appear to the Shopper during checkout |
Note* - Please check with your Implementation Engineer before setting this Configuration in production
Request Body Example
{
"name": "SURCHARGE_FEE",
"enabled": true,
"value": {
"value": 3, //PERCENTAGE: 3% FLAT: $0.03
"style": "PERCENTAGE", // PERCENTAGE OR FLAT
"feeType": "SURCHARGE_FEE",
"description": "Surcharge"
}
}
API Response
Response Body Parameters
| Parameter Name | Type | Description |
|---|---|---|
| enabled | boolean | The current status of the configuration |
| name | string | The Name of the Configuration |
| value | array | The an array of the surcharge values |
| type | string | The Type of configuration if applicable |
| configId | string | the Id of this configuration |
| merchantID | string | The Skipify merchant identifier |
| createdAt | string, dateTime | The created date/time for this configuration Ex: `2024-06-02T21:48:02Z |
| updatedAt | string, dateTime | The date/time this configuration was last updated Ex: `2024-06-02T21:48:02Z |
Response Body Example
{
"enabled": true,
"name": "SURCHARGE_FEE",
"value": {
"style": "PERCENTAGE",
"value": 3,
"description": "Surcharge",
"feeType": "SURCHARGE_FEE"
},
"type": "order",
"configId": "b0f2c0b-3re4-4798-98e2-4f326b2rdfe8",
"merchantId": "215b9068-96d1-45c8-ba95-614edf1abd3b",
"createdAt": "2024-06-10T20:24:11.328Z",
"updatedAt": "2024-06-10T20:24:11.328Z"
}
Updated 11 days ago
What’s Next