> For the complete documentation index, see [llms.txt](https://hilals-organization.gitbook.io/magicpay-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hilals-organization.gitbook.io/magicpay-documentation/10.-pos/10.1-create-pos.md).

# 10.1 Create POS

**Request**

| Method | URL                          |
| ------ | ---------------------------- |
| POST   | /merchant/v1/merchant-poses/ |

```
{
  "allowedHostnames": ["example.com"],
  "bankId": 123,
  "bankName": "Bank Name",
  "currency": "USD",
  "enableForeignCard": true,
  "enableInstallment": true,
  "enablePaymentWithoutCvc": false,
  "enabledPaymentAuthenticationTypes": ["AuthType1", "AuthType2"],
  "hostname": "example-host",
  "id": 456,
  "merchantPosUsers": [
    {
      "posUsername": "user1",
      "posOperationType": "OperationType1",
      "posUserType": "UserType1"
    },
    {
      "posUsername": "user2",
      "posOperationType": "OperationType2",
      "posUserType": "UserType2"
    }
  ],
  "mode": "Test",
  "name": "MerchantPOS Name",
  "orderNumber": 789,
  "path": "/payment",
  "posCurrencyCode": "USD",
  "posIntegrator": "IntegratorName",
  "status": "ACTIVE",
  "supportedCardAssociations": ["Visa", "MasterCard"]
}

```

**Response**

| Status | Response                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | <p><br><br></p><p>{</p><p>    "message": "Merchant pos successfully created",</p><p>    "data": {</p><p>        "data": {</p><p>            "id": 131,</p><p>            "status": "ACTIVE",</p><p>            "name": "MerchantPOS Name",</p><p>            "alias": "",</p><p>            "posIntegrator": "IntegratorName",</p><p>            "hostname": "example-host",</p><p>            "clientId": "Bank Name",</p><p>            "posCurrencyCode": "USD",</p><p>            "mode": "P",</p><p>            "path": "/payment",</p><p>            "port": null,</p><p>            "threedsKey": "/payment",</p><p>            "threedsPath": null,</p><p>            "forceThreeDs": false,</p><p>            "enableForeignCard": true,</p><p>            "enableInstallment": true,</p><p>            "enablePaymentWithoutCvc": true,</p><p>            "newIntegration": false,</p><p>            "orderNumber": "789",</p><p>            "currency": "USD",</p><p>            "bankId": 123,</p><p>            "bankName": "Bank Name",</p><p>            "isPf": false,</p><p>            "merchantPosUsers": \[</p><p>                {</p><p>                    "id": 131,</p><p>                    "posUsername": "user1",</p><p>                    "posOperationType": "OperationType1",</p><p>                    "posUserType": "UserType1"</p><p>                },</p><p>                {</p><p>                    "id": 131,</p><p>                    "posUsername": "user2",</p><p>                    "posOperationType": "OperationType2",</p><p>                    "posUserType": "UserType2"</p><p>                }</p><p>            ],</p><p>            "supportedCardAssociations": \[</p><p>                "MASTER\_CARD",</p><p>                "VISA",</p><p>                "TROY",</p><p>                "AMEX"</p><p>            ],</p><p>            "enabledPaymentAuthenticationTypes": \[</p><p>                "THREE\_DS",</p><p>                "NON\_THREE\_DS"</p><p>            ]</p><p>        }</p><p>    }</p><p>}</p><p><br><br></p> |
| 403    | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 400    | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 401    | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 401    | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 500    | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |