> For the complete documentation index, see [llms.txt](https://magicpay.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://magicpay.gitbook.io/magicpay-documentation/pos/create-pos.md).

# Create POS

## 10.1 Create POS

**Request**

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

Copy

```
{
  "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>{</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> |
| 403    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 400    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 401    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 401    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 500    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

[<br>](https://hilals-organization.gitbook.io/magicpay-documentation/10.-pos)