This should not be displayed
``` ##### Процесс 3DS 2.x.0 Challenge ```plantuml title Процесс 3DS 2.x.0 Challenge start #Turquoise:(1) Send **/api/v2/status/** API request; #Turquoise:(2) Process **/api/v2/status/** response. Gather: **tds-creq-form-creq** **tds-creq-form-acs-url**; #Turquoise:(3) Construct CReq HTML Page based on the gathered parameters. Add **threeDSSessionData** with the custom data in the format: Max length: 1024 bytes, format: Alphanumeric, base64url encoded without padding.; #Turquoise:(4) Return CReq HTML Page to Payer's browser; :(5) CReq Page gets redirected to ACS URL **tds-creq-form-acs-url**. Payer passes 3DS Challenge Verification. ACS return CRes Page. CRes Page gets submitted to **notificationURL**; #Turquoise:(6) Process CRes Page parameters. Gather parameters: **cres** **threeDSSessionData**; #Turquoise:(7) Send HTTP POST **/api/3ds/v1/upload-cres-result/** API Request providing **cres**, **orderid=paynet-order-id**; #Turquoise:(8) Send **/api/v2/status/** API request Process **/api/v2/status/** response and follow **Схема прохождения 3DS**.; stop legend left =Legend | Color | Implementation responsibility | |<#Turquoise>| Connecting party | | | Other Party | endlegend ``` (1) Для реализации запроса статуса заказа см. [/api/v2/status/](https://doc.payneteasy.ru/integration/API_commands/api_v2_status.html.md). Статус следует запрашивать несколько раз с интервалом 3-5 секунд до получения финального статуса в ответе. (2) То же, что и в пункте (1). (3) О создании HTML-страницы CReq см. [пример](#creqform-example-overview). (5) О реализации редиректа CRes см. [CRes redirect](https://doc.payneteasy.ru/integration/API_commands/CRes_redirect.html.md). (7) Для загрузки результата CRes см. [/api/3ds/v1/upload-cres-result/](https://doc.payneteasy.ru/integration/API_commands/upload-cres-result.html.md). (8) То же, что и в пункте (1). ###### Пример HTML-страницы CReq HTML-страница CReq перенаправляет браузер плательщика на URL ACS-сервера, указанный в параметре tds-creq-form-acs-url. Результирующее значение CRes будет возвращено от ACS на notificationURL, предоставленный Подключенной стороной в запросе [/api/3ds/v1/upload-method-url-result](https://doc.payneteasy.ru/integration/API_commands/upload-method-url-result.html.md) во время процесса 3DS 2.x.0 Frictionless. | Поле | Описание | Необходимость | |--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------| | creq | Данные ACS 3DS CReq, полученные Подключенной стороной в ответе [/api/v2/status/](https://doc.payneteasy.ru/integration/API_commands/api_v2_status.html.md). То же, что и tds-creq-form-creq. | Обязательно | | threeDSSession Data | значение, которое будет отправлено обратно в CRes на notificationURL в конце процесса. Максимальная длина: 1024 байта, формат: буквенно-цифровой, кодировка Base64url без дополнения (padding). | Опционально | ```html
### Описание: Perform transfer
#### Введение
Описание: Perform transfer инициируется через запрос HTTPS POST с использованием [URL-адресов](#api-url-perform-transfer) и [параметров](#api-parameters-perform-transfer).
На этом этапе приложение Присоединяющейся Стороны отправляет данные держателя карты, устройства, сессии и другие параметры напрямую в Payneteasy для выполнения перевода средств с карты на карту.
Может применяться множество проверок и фильтров по различным критериям, таким как BIN, валюта, страна, наличие в чёрном списке и т.д. В зависимости от интеграции эти настройки могут быть конфигурируемыми.
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|--------------------------------------------------------------------------------|-----------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/dapi/v1/transfer/{endpoint Id}/{invoice Id} | https://gate.payneteasy.ru/paynet/dapi/v1/transfer/{endpoint Id}/{invoice Id} |
#### Параметры запроса
| Название параметра | Описание | Значение |
|-------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|
| consumer | | `Необходимость`: Обязательно `Тип`: **Object** |
| consumer.device | | `Необходимость`: Обязательно `Тип`: **Object** |
| consumer.device.serial Number | Серийный номер устройства потребителя. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| consumer.email | Адрес электронной почты клиента, если он был отправлен в исходной транзакции сопоставления карты и вместо данных держателя карты используется ссылка на карту. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3-128 |
| destination Of Funds | | `Необходимость`: Обязательно `Тип`: **Object** |
| destination Of Funds.card | Следует использовать только один из этих подтипов (card, reference). | `Необходимость`: Обязательно `Тип`: **Object** |
| destination Of Funds.card.number | Destination карта номер (PAN). | `Необходимость`: Обязательно `Тип`: String `Length`: 9-19 |
| destination Of Funds.reference | Следует использовать только один из этих подтипов (card, reference). | `Необходимость`: Обязательно `Тип`: **Object** |
| destination Of Funds.reference.client Card Id | Идентификатор ссылки на карту получателя (на стороне клиента). | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-128 |
| session | | `Необходимость`: Обязательно `Тип`: **Object** |
| session.access Token | Ключ токена доступа, полученный при необязательной аутентификации потребителя. | `Необходимость`: Обязательно `Тип`: String `Длина`: 32-128 |
| session.nonce | Значение, полученное в ответе Initiate transfer. | `Необходимость`: Обязательно `Тип`: String `Длина`: 32-128 |
| session.signature | Значение, полученное в ответе Initiate transfer. | `Необходимость`: Обязательно `Тип`: String `Длина`: 32-128 |
| source Of Funds | | `Необходимость`: Обязательно `Тип`: **Object** |
| source Of Funds.card | Следует использовать только один из этих подтипов (card, reference). | `Необходимость`: Обязательно `Тип`: **Object** |
| source Of Funds.card.expiry | | `Необходимость`: Обязательно `Тип`: **Object** |
| source Of Funds.card.expiry.month | Месяц окончания срока действия исходной карты. | `Необходимость`: Обязательно `Тип`: Integer `Длина`: 2 |
| source Of Funds.card.expiry.year | Год окончания срока действия исходной карты. | `Необходимость`: Обязательно `Тип`: Integer `Длина`: 4 |
| source Of Funds.card.holder | | `Необходимость`: Обязательно `Тип`: **Object** |
| source Of Funds.card.holder.first Name | Название Cardholder’s first. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| source Of Funds.card.holder.last Name | Название Cardholder’s last. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| source Of Funds.card.holder.printed Name | Имя держателя карты, напечатанное на карте (имя и фамилия вместе). Может использоваться вместо first Name + last Name. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| source Of Funds.card.number | Номер исходной карты (PAN). | `Необходимость`: Обязательно `Тип`: String `Length`: 9-19 |
| source Of Funds.card.security Code | Код безопасности исходной карты (CVV). | `Необходимость`: Обязательно `Тип`: String `Длина`: 3-4 |
| source Of Funds.reference | Следует использовать только один из этих подтипов (card, reference). | `Необходимость`: Обязательно `Тип`: **Object** |
| source Of Funds.reference.client Card Id | Ссылочный идентификатор исходной карты (на стороне клиента). | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-128 |
| source Of Funds.reference.security Code | Код безопасности исходной карты (CVV). | `Необходимость`: Обязательно `Тип`: String `Длина`: 3-4 |
| transaction | | `Необходимость`: Обязательно `Тип`: **Object** |
| transaction.amount Centis | Сумма транзакции: 1,00 EUR = 100 центов. | `Необходимость`: Обязательно `Тип`: Integer |
| transaction.currency | Буквы верхнего регистра (alpha-код по ISO 4217). | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| location | | `Необходимость`: Опционально `Тип`: **Object** |
| location.lat | Широта указывается в диапазоне от -90.0 до +90.0 включительно. | `Необходимость`: Опционально `Тип`: Double |
| location.lng | Долгота указывается в диапазоне от -180.0 до +180.0 включительно. | `Необходимость`: Опционально `Тип`: Double |
| billing | | `Необходимость`: Опционально `Тип`: **Object** |
| billing.address | | `Необходимость`: Опционально `Тип`: **Object** |
| billing.address.city | Название города. | `Необходимость`: Опционально `Тип`: String `Length`: 1-100 |
| billing.address.country | Трёхбуквенный код страны ISO. | `Необходимость`: Опционально `Тип`: String `Длина`: 3 |
| billing.address.postcode Zip | Почтовый индекс ZIP. | `Необходимость`: Опционально `Тип`: String `Length`: 1-10 |
| billing.address.state | Поле «Штат» используется при наличии. Например, Лос-Анджелес находится в штате CA. | `Необходимость`: Опционально `Тип`: String `Длина`: 2-3 |
| billing.address.street | Поле «Улица» используется для названий районов и улиц. | `Необходимость`: Опционально `Тип`: String `Длина`: 1-50 |
| billing.address.street2 | Поле «Улица 2» используется для длинных адресов. Обычно оно содержит номер квартиры и здания. | `Необходимость`: Опционально `Тип`: String `Длина`: 1-50 |
| billing.phone | Контактный номер телефона потребителя. | `Необходимость`: Опционально `Тип`: String `Length`: 1-20 |
| consumer.birth Day | Дата рождения потребителя в формате “ddMMyyyy”. | `Необходимость`: Опционально `Тип`: String `Длина`: 8 |
| consumer.device.imei | Международный идентификатор мобильного оборудования устройства потребителя. | `Необходимость`: Опционально `Тип`: String `Длина`: 14-16 |
| consumer.ip Addresses | IP-адреса потребителя. | `Необходимость`: Опционально `Тип`: List |
| consumer.ip Addresses[] | Адрес Сonsumer’s IP. | `Необходимость`: Опционально `Тип`: String `Длина`: 7-15 |
| order | | `Необходимость`: Опционально `Тип`: **Object** |
| order.description | Краткое описание транзакции. Может быть обязательным для некоторых банков-эквайеров. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| order.site Url | URL веб-сайта, связанного с транзакцией. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| order.purpose | Может использоваться для более эффективного контроля транзакции или дополнительных проверок. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
#### Параметры успешного ответа
| Название параметра | Описание | Значение |
|----------------------|------------------------------------|-----------------------------|
| invoice Id | Идентификатор транзакции transfer. | `Тип`: String |
| session | | `Тип`: **Object** |
| session.token | Token сессии транзакции transfer. | `Тип`: String |
#### Параметры неуспешного ответа
| Название параметра | Описание | Значение |
|----------------------|------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| error | | `Тип`: **Object** |
| error.cause | Причина ошибки. Возможные значения: `INVALID_REQUEST`, `INVALID_CONFIGURATION`, `INTERNAL_ERROR`, `PROCESSING_FAILED`. | `Тип`: Enum |
| error.code | Уникальный код ошибки. | `Тип`: String |
| error.message | Описание ошибки. | `Тип`: String |
| invoice Id | Идентификатор транзакции transfer. | `Тип`: String |
#### Пример запроса
```json
{
"billing": {
"address": {
"city": "string",
"country": "string",
"postcodeZip": "string",
"state": "string",
"street": "string",
"street2": "string"
},
"phone": "string"
},
"consumer": {
"birthDay": "string",
"device": {
"imei": "string",
"serialNumber": "string"
},
"email": "string",
"ipAddresses": ["string"]
},
"destinationOfFunds": {
"card": {
"number": "string",
},
"reference": {
"clientCardId": "string"
}
},
"location": {
"lat": "double",
"lng": "double"
},
"order": {
"description": "string",
"siteUrl": "string",
"purpose": "string"
},
"session": {
"accessToken": "string",
"nonce": "string",
"signature": "string"
},
"sourceOfFunds": {
"card": {
"expiry": {
"month": "integer",
"year": "integer"
},
"holder":{
"firstName": "string",
"lastName": "string"
},
"number": "string",
"securityCode": "string"
},
"reference": {
"clientCardId": "string",
"securityCode": "string"
}
},
"transaction": {
"amountCentis": "integer",
"currency": "string"
}
}
```
#### Пример успешного ответа
```json
{
"invoiceId": "string",
"session": {
"token": "string"
}
}
```
#### Пример неуспешного ответа
```json
{
"error": {
"cause": "enum",
"code": "string",
"message": "string"
},
"invoiceId": "string"
}
```
#### Конструктор запросов
Для интеграции используйте [Сценарии тестирования Payneteasy](https://doc.payneteasy.ru/integration/general_api_usage/test_scenarios.html.md) для генерации случайных номеров карт.
### Описание: Perform validation
#### Введение
Проверка выполнения инициируется запросом HTTPS POST с использованием [URL-адресов](#api-url-perform-verification) и [параметров](#api-parameters-perform-verification).
Приложение Присоединяющейся стороны отправляет данные держателя карты, устройства, сессии и другие параметры напрямую в Payneteasy для проверки валидности карты.
Может применяться множество проверок и фильтров по различным критериям, таким как BIN, валюта, страна, наличие в чёрном списке и т.д. В зависимости от интеграции эти настройки могут быть конфигурируемыми.
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/dapi/v1/verification/{endpoint Id}/{invoice Id} | https://gate.payneteasy.ru/paynet/dapi/v1/verification/{endpoint Id}/{invoice Id} |
#### Параметры запроса
| Название параметра | Описание | Значение |
|-------------------------------|----------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------|
| consumer | | `Необходимость`: Обязательно `Тип`: **Object** |
| consumer.device | | `Необходимость`: Обязательно `Тип`: **Object** |
| consumer.device.serial Number | Серийный номер устройства потребителя. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| consumer.email | Адрес электронной почты клиента. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3-128 |
| session | | `Необходимость`: Обязательно `Тип`: **Object** |
| session.access Token | Ключ токена доступа, полученный при необязательной аутентификации потребителя. | `Необходимость`: Обязательно `Тип`: String `Длина`: 32-128 |
| session.nonce | Значение, полученное в ответе Initial verification. | `Необходимость`: Обязательно `Тип`: String `Длина`: 32-128 |
| session.signature | Значение, полученное в ответе Initial verification. | `Необходимость`: Обязательно `Тип`: String `Длина`: 32-128 |
| source Card | | `Необходимость`: Обязательно `Тип`: **Object** |
| source Card.expiry | | `Необходимость`: Обязательно `Тип`: **Object** |
| source Card.expiry.month | Месяц окончания срока действия исходной карты. | `Необходимость`: Обязательно `Тип`: Integer `Длина`: 2 |
| source Card.expiry.year | Год окончания срока действия исходной карты. | `Необходимость`: Обязательно `Тип`: Integer `Длина`: 4 |
| source Card.holder | | `Необходимость`: Обязательно `Тип`: **Object** |
| source Card.holder.first Name | Название Cardholder’s first. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| source Card.holder.last Name | Название Cardholder’s last. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| source Card.holder.printed Name | Имя держателя карты, напечатанное на карте (имя и фамилия вместе). Может использоваться вместо first Name + last Name. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| source Card.number | Номер исходной карты (PAN). | `Необходимость`: Обязательно `Тип`: String `Length`: 9-19 |
| source Card.security Code | Код безопасности исходной карты (CVV). | `Необходимость`: Обязательно `Тип`: String `Длина`: 3-4 |
| transaction | | `Необходимость`: Обязательно `Тип`: **Object** |
| transaction.currency | Буквы верхнего регистра (alpha-код по ISO 4217). | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| location | | `Необходимость`: Опционально `Тип`: **Object** |
| location.lat | Широта указывается в диапазоне от -90.0 до +90.0 включительно. | `Необходимость`: Опционально `Тип`: Double |
| location.lng | Долгота указывается в диапазоне от -180.0 до +180.0 включительно. | `Необходимость`: Опционально `Тип`: Double |
| billing | | `Необходимость`: Опционально `Тип`: **Object** |
| billing.address | | `Необходимость`: Опционально `Тип`: **Object** |
| billing.address.city | Название города. | `Необходимость`: Опционально `Тип`: String `Length`: 1-100 |
| billing.address.country | Трёхбуквенный код страны ISO. | `Необходимость`: Опционально `Тип`: String `Длина`: 3 |
| billing.address.postcode Zip | Описание: ZIP post code | `Необходимость`: Опционально `Тип`: String `Length`: 1-10 |
| billing.address.state | Поле «Штат» используется при наличии. Например, Лос-Анджелес находится в штате CA. | `Необходимость`: Опционально `Тип`: String `Длина`: 2-3 |
| billing.address.street | Поле «Улица» используется для названий районов и улиц. | `Необходимость`: Опционально `Тип`: String `Длина`: 1-50 |
| billing.address.street2 | Поле «Улица 2» используется для длинных адресов. Обычно оно содержит номер квартиры и здания. | `Необходимость`: Опционально `Тип`: String `Длина`: 1-50 |
| billing.phone | Контактный номер телефона клиента. | `Необходимость`: Опционально `Тип`: String `Length`: 1-20 |
| consumer.birth Day | Дата рождения потребителя в формате “ddMMyyyy”. | `Необходимость`: Опционально `Тип`: String `Длина`: 8 |
| consumer.device.imei | Международный идентификатор мобильного оборудования устройства потребителя. | `Необходимость`: Опционально `Тип`: String `Длина`: 14-16 |
| consumer.ip Addresses | IP-адреса потребителя. | `Необходимость`: Опционально `Тип`: List |
| consumer.ip Addresses[] | Адрес Сonsumer’s IP. | `Необходимость`: Опционально `Тип`: String `Длина`: 7-15 |
| order | | `Необходимость`: Опционально `Тип`: **Object** |
| order.description | Краткое описание транзакции. Может быть обязательным для некоторых банков-эквайеров. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| order.site Url | URL веб-сайта, связанного с транзакцией. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| order.purpose | Может использоваться для более эффективного контроля транзакции или дополнительных проверок. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
#### Параметры успешного ответа
| Название параметра | Описание | Значение |
|----------------------|---------------------------------------|-----------------------------|
| invoice Id | Идентификатор транзакции верификации. | `Тип`: String |
| session | | `Тип`: **Object** |
| session.token | Токен сеанса транзакции верификации. | `Тип`: String |
#### Параметры неуспешного ответа
| Название параметра | Описание | Значение |
|----------------------|------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| error | | `Тип`: **Object** |
| error.cause | Причина ошибки. Возможные значения: `INVALID_REQUEST`, `INVALID_CONFIGURATION`, `INTERNAL_ERROR`, `PROCESSING_FAILED`. | `Тип`: Enum |
| error.code | Уникальный код ошибки. | `Тип`: String |
| error.message | Описание ошибки. | `Тип`: String |
| invoice Id | Идентификатор транзакции верификации. | `Тип`: String |
#### Пример запроса
```json
{
"billing": {
"address": {
"city": "string",
"country": "string",
"postcodeZip": "string",
"state": "string",
"street": "string",
"street2": "string"
},
"phone": "string"
},
"consumer": {
"birthDay": "string",
"device": {
"imei": "string",
"serialNumber": "string"
},
"email": "string",
"ipAddresses": ["string"]
},
"location": {
"lat": "double",
"lng": "double"
},
"order": {
"description": "string",
"siteUrl": "string",
"purpose": "string"
},
"session": {
"accessToken": "string",
"nonce": "string",
"signature": "string"
},
"sourceCard": {
"expiry": {
"month": "integer",
"year": "integer"
},
"holder":{
"firstName": "string",
"lastName": "string"
},
"number": "string",
"securityCode": "string"
},
"transaction": {
"currency": "string"
}
}
```
#### Пример успешного ответа
```json
{
"invoiceId": "string",
"session": {
"token": "string"
}
}
```
#### Пример неуспешного ответа
```json
{
"error": {
"cause": "enum",
"code": "string",
"message": "string"
},
"invoiceId": "string"
}
```
#### Конструктор запросов
Для интеграции используйте [Сценарии тестирования Payneteasy](https://doc.payneteasy.ru/integration/general_api_usage/test_scenarios.html.md) для генерации случайных номеров карт.
Параметры со светло-красным фоном являются обязательными.
### Уведомление о сопоставлении карты Sale
#### Введение
Уведомление о сопоставлении карты Sale инициируется запросом HTTPS POST с использованием [URL-адресов](#api-url-sale-card-mapping-notification) и [параметров](#api-parameters-sale-card-mapping-notification).
Уведомление о сопоставлении карт позволяет сопоставлять учётные данные Consumer (телефон, e-mail, адрес выставления счёта, имя в Twitter и т. д.) с данными карты. Сопоставления можно использовать в транзакциях Transfer или Sale вместо номеров карт и иной информации о держателе карты. Payneteasy отправляет запрос уведомления о сопоставлении карты Sale на сервер/прокси Присоединяющейся стороны с созданной на своей стороне ссылкой на карту — {server Card Id}.
Сервер Присоединяющейся стороны сопоставляет {server Card Id} с созданным на своей стороне {client Card Id}. Затем этот {client Card Id} может быть сопоставлен в приложении или на сервере Присоединяющейся стороны с любыми данными Consumer из исходного запроса Perform sale. Это позволяет приложению Присоединяющейся стороны обрабатывать транзакции Sale или Transfer по электронному адресу Consumer, номеру телефона и т. д.
{unique Reference Card Id} остаётся прежним, если потребитель выполняет другую транзакцию с тем же номером карты, но, например, другой датой истечения срока. Присоединяющаяся сторона может использовать его для программ лояльности или контроля мошенничества.
Приложение Присоединяющейся стороны создаёт новые запросы Sale, используя {client Card Id} вместо данных исходной карты. Payneteasy отправляет этот {client Card Id} на сервер Присоединяющейся стороны в «Check sale request» и получает сопоставленный с ним {server Card Id} в «Check sale response» от сервера Присоединяющейся стороны, который используется для продолжения обработки этой транзакции.
{server Card Id} карты-источника или проверенной карты можно использовать для новых транзакций Sale и как источник или получатель для новых транзакций Transfer.
#### API URL
> **Note:** Это пример URL на сервере Присоединяющейся Стороны.
| Сервер Присоединяющейся Стороны |
|-----------------------------------------------------------|
| https://proxy.connectingpartyserver.com/sale/notification |
#### Параметры запроса
| Название параметра | Описание | Значение |
|--------------------------------------------|---------------------------------------------------------------|--------------------------------------------------------------------------------------------------|
| consumer | | `Необходимость`: Обязательно `Тип`: **Object** |
| consumer.device | | `Необходимость`: Обязательно `Тип`: **Object** |
| consumer.device.serial Number | Серийный номер устройства потребителя. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| session | | `Необходимость`: Обязательно `Тип`: **Object** |
| session.access Token | Ключ токена доступа потребителя. | `Необходимость`: Обязательно `Тип`: String `Длина`: 32-128 |
| session.token | Session token транзакции sale. | `Необходимость`: Обязательно `Тип`: String `Длина`: 16-36 |
| source Card | | `Необходимость`: Опционально `Тип`: **Object** |
| source Card.bin | BIN исходной карты. | `Необходимость`: Опционально `Тип`: Integer |
| source Card.reference | | `Необходимость`: Опционально `Тип`: **Object** |
| source Card.reference.server Card Id | Ссылочный идентификатор исходной карты (на стороне сервера). | `Необходимость`: Опционально `Тип`: String `Length`: 1-64 |
| source Card.reference.unique Reference Card Id | Уникальный идентификатор исходной карты (на стороне сервера). | `Необходимость`: Опционально `Тип`: Integer |
#### Параметры успешного ответа
| Название параметра | Описание | Значение |
|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| invoice Id | Идентификатор транзакции sale. | `Тип`: String |
| session | | `Тип`: **Object** |
| session.check Signature | Контрольная сумма, сгенерированная hmac-sha1 (см. [Вычисление подписи](https://doc.payneteasy.ru/integration/api_development_tools.html.md)) из конкатенации session.nonce, endpoint Id и invoice Id. | `Тип`: String |
| session.nonce | Уникальная случайная строка, сгенерированная сервером Присоединяющейся стороны. | `Тип`: String |
| session.token | Session token транзакции sale. | `Тип`: String |
#### Параметры неуспешного ответа
| Название параметра | Описание | Значение |
|----------------------|-----------------------------------------------------------------------------------------------------------|-----------------------------|
| error | | `Тип`: **Object** |
| error.cause | Причина ошибки. Возможные значения: `FILTERED`, `INVALID_REQUEST`, `SERVER_FAILED`, `SERVER_UNAVAILABLE`. | `Тип`: Enum |
| error.code | Уникальный код ошибки. | `Тип`: String |
| error.message | Описание ошибки. | `Тип`: String |
| invoice Id | Идентификатор транзакции sale. | `Тип`: String |
#### Пример запроса
```json
{
"consumer": {
"device": {
"serialNumber": "string"
}
},
"session": {
"accessToken": "string",
"token":"string"
},
"sourceCard": {
"bin": "integer",
"reference": {
"serverCardId": "string",
"uniqueReferenceCardId": "integer"
}
}
}
```
#### Пример успешного ответа
```json
{
"invoiceId": "string",
"session": {
"checkSignature": "string",
"nonce": "string",
"token": "string"
}
}
```
#### Пример неуспешного ответа
```json
{
"error": {
"cause": "enum",
"code": "string",
"message": "string"
},
"invoiceId": "string"
}
```
### Sale статус
#### Введение
Sale статус инициируется через запрос HTTPS POST с использованием [URLs](#api-url-sale-status) и [parameters](#api-parameters-sale-status).
Sale статус запрос is made by Присоединяющаяся сторона’s app to Payneteasy to get the статус of sale транзакция. Payneteasy
Рекомендуется отправлять запрос статуса Sale в течение 2–3 минут с интервалом 3–5 секунд между запросами. Сервер Присоединяющейся стороны должен полагаться на callback для получения окончательного статуса.
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|-----------------------------------------------------------------------------------|--------------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/dapi/v1/sale/{endpoint Id}/{invoice Id}/status | https://gate.payneteasy.ru/paynet/dapi/v1/sale/{endpoint Id}/{invoice Id}/status |
#### Параметры запроса
| Название параметра | Описание | Значение |
|----------------------|-----------------------------------------------------------------------------|-------------------------------------------------------|
| session | | `Тип`: **Object** |
| session.access Token | The access token key received in Необязательное потребителя authentication. | `Тип`: String `Длина`: 32-128 |
| session.token | Session token транзакции sale. | `Тип`: String `Длина`: 16-36 |
#### Параметры успешного ответа
| Название параметра | Описание | Значение |
|------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| invoice Id | Идентификатор транзакции sale. | `Тип`: String |
| session | | `Тип`: **Object** |
| session.token | The session token of sale транзакция | `Тип`: String |
| state | Возможные значения: `PROCESSING`, `REDIRECT_REQUEST`, `APPROVED`, `DECLINED`. | `Тип`: Enum |
| bank Order Id | Обязательное if state is `APPROVED` or `DECLINED`. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| redirect Url | Обязательное if state is `REDIRECT_REQUEST`. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| order Id | Идентификатор заказа в системе обработки платежей. | `Необходимость`: Условно `Тип`: String |
| transaction | | `Необходимость`: Условно `Тип`: **Object** |
| transaction.amount Centis | Сумма денежного перевода в центах: 1,00 EUR = 100 центов. | `Необходимость`: Условно `Тип`: Integer |
| transaction.commission Centis | Сумма удержанной комиссии в центах (зависит от интеграции). | `Необходимость`: Условно `Тип`: Integer |
| transaction.order Created Date | Дата создания заказа в системе обработки платежей. | `Необходимость`: Условно `Тип`: String |
| transaction.transaction Created Date | Дата создания транзакции в системе обработки платежей. | `Необходимость`: Условно `Тип`: String |
| error Code | Код причины отклонения; может присутствовать, если состояние — `DECLINED`. | `Необходимость`: Опционально `Тип`: Integer |
| error Message | Сообщение о причине отклонения; может присутствовать, если состояние — `DECLINED`. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| secure3DAuth Status | Возможные значения: `AUTHENTICATED`, `NOT_AUTHENTICATED`, `UNSUPPORTED`. `UNSUPPORTED` означает, что карта не поддерживает 3-D Secure или процесс аутентификации 3DS завершился с неизвестным статусом. | `Необходимость`: Опционально `Тип`: Enum |
| random Sum Auth Status | Возможные значения: `AUTHENTICATED`, `NOT_AUTHENTICATED`. | `Необходимость`: Опционально `Тип`: Enum |
#### Параметры неуспешного ответа
| Название параметра | Описание | Значение |
|----------------------|------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| error | | `Тип`: **Object** |
| error.cause | Причина ошибки. Возможные значения: `FILTERED`, `INVALID_REQUEST`, `INTERNAL_ERROR`, `PROCESSING_FAILED`, `ORDER_NOT_FOUND`. | `Тип`: Enum |
| error.code | Уникальный код ошибки. | `Тип`: String |
| error.message | Описание ошибки. | `Тип`: String |
| invoice Id | Идентификатор транзакции sale. | `Тип`: String |
#### Пример запроса
```json
{
"session": {
"accessToken": "string",
"token": "string"
}
}
```
#### Пример успешного ответа
```json
{
"bankOrderId": "string",
"invoiceId": "string",
"redirectUrl": "string",
"session": {
"token": "string"
},
"state": "enum"
}
```
#### Пример неуспешного ответа
```json
{
"error": {
"cause": "enum",
"code": "string",
"message": "string"
},
"invoiceId": "string"
}
```
#### Конструктор запросов
### Уведомление о сопоставлении карты Transfer
#### Введение
Уведомление о сопоставлении карты Transfer инициируется запросом HTTPS POST с использованием [URL-адресов](#api-url-transfer-card-mapping-notification) и [параметров](#api-parameters-transfer-card-mapping-notification).
Уведомление о сопоставлении карт позволяет сопоставлять учётные данные Consumer (телефон, e-mail, адрес выставления счёта, имя в Twitter и т. д.) с данными карты. Сопоставления можно использовать в транзакциях Transfer или Sale вместо номеров карт и иной информации о держателе карты. Payneteasy отправляет запрос уведомления о сопоставлении карты Transfer на сервер/прокси Присоединяющейся стороны с созданной на своей стороне ссылкой на карту — {server Card Id}.
Сервер Присоединяющейся стороны сопоставляет {server Card Id} с созданным на своей стороне {client Card Id}. Затем {client Card Id} может быть сопоставлен в приложении или на сервере Присоединяющейся стороны с любыми данными Consumer из исходного запроса Perform transfer. Это позволяет приложению Присоединяющейся стороны обрабатывать транзакции Sale или Transfer по электронному адресу Consumer, номеру телефона и т. д.
{unique Reference Card Id} остаётся неизменным, если клиент выполняет другую проверку с тем же номером карты, но, например, с другой датой истечения срока действия. Присоединяющаяся сторона может использовать его для программ лояльности или контроля мошенничества.
Приложение Присоединяющейся стороны создаёт новые запросы Transfer, используя {client Card Id} вместо данных исходной или целевой карты. Payneteasy отправляет этот {client Card Id} на сервер Присоединяющейся стороны в «Check transfer request» и получает сопоставленный с ним {server Card Id} в «Check transfer response», который используется для продолжения обработки транзакции Transfer.
{server Card Id} исходной или проверенной карты можно использовать как источник или назначение для новых транзакций Transfer и Sale; {server Card Id} карты назначения можно использовать только как назначение для новых переводов.
#### API URL
> **Note:** Это пример URL на сервере Присоединяющейся Стороны.
| Сервер Присоединяющейся Стороны |
|---------------------------------------------------------------|
| https://proxy.connectingpartyserver.com/transfer/notification |
#### Параметры запроса
| Название параметра | Описание | Значение |
|-------------------------------------------------|-----------------------------------------------------------------|--------------------------------------------------------------------------------------------------|
| consumer | | `Необходимость`: Обязательно `Тип`: **Object** |
| consumer.device | | `Необходимость`: Обязательно `Тип`: **Object** |
| consumer.device.serial Number | Серийный номер устройства потребителя. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1-50 |
| session | | `Необходимость`: Обязательно `Тип`: **Object** |
| session.access Token | Ключ токена доступа потребителя. | `Необходимость`: Обязательно `Тип`: String `Длина`: 32-128 |
| session.token | Token сессии транзакции transfer. | `Необходимость`: Обязательно `Тип`: String `Длина`: 16-36 |
| destination Card | | `Необходимость`: Опционально `Тип`: **Object** |
| destination Card.bin | BIN карты получателя. | `Необходимость`: Опционально `Тип`: Integer |
| destination Card.reference | | `Необходимость`: Опционально `Тип`: **Object** |
| destination Card.reference.server Card Id | Идентификатор ссылки на карту получателя (на стороне сервера). | `Необходимость`: Опционально `Тип`: String `Length`: 1-64 |
| destination Card.reference.unique Reference Card Id | Уникальный идентификатор карты получателя (на стороне сервера). | `Необходимость`: Опционально `Тип`: Integer |
| source Card | | `Необходимость`: Опционально `Тип`: **Object** |
| source Card.bin | BIN исходной карты. | `Необходимость`: Опционально `Тип`: Integer |
| source Card.reference | | `Необходимость`: Опционально `Тип`: **Object** |
| source Card.reference.server Card Id | Ссылочный идентификатор исходной карты (на стороне сервера). | `Необходимость`: Опционально `Тип`: String `Length`: 1-64 |
| source Card.reference.unique Reference Card Id | Уникальный идентификатор исходной карты (на стороне сервера). | `Необходимость`: Опционально `Тип`: Integer |
#### Параметры успешного ответа
| Название параметра | Описание | Значение |
|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| invoice Id | Идентификатор транзакции transfer. | `Тип`: String |
| session | | `Тип`: **Object** |
| session.check Signature | Контрольная сумма, сгенерированная hmac-sha1 (см. [Вычисление подписи](https://doc.payneteasy.ru/integration/api_development_tools.html.md)) из конкатенации session.nonce, endpoint Id и invoice Id. | `Тип`: String |
| session.nonce | Уникальная случайная строка, сгенерированная сервером Присоединяющейся стороны. | `Тип`: String |
| session.token | Token сессии транзакции transfer. | `Тип`: String |
#### Параметры неуспешного ответа
| Название параметра | Описание | Значение |
|----------------------|-----------------------------------------------------------------------------------------------------------|-----------------------------|
| error | | `Тип`: **Object** |
| error.cause | Причина ошибки. Возможные значения: `FILTERED`, `INVALID_REQUEST`, `SERVER_FAILED`, `SERVER_UNAVAILABLE`. | `Тип`: Enum |
| error.code | Уникальный код ошибки. | `Тип`: String |
| error.message | Описание ошибки. | `Тип`: String |
| invoice Id | Идентификатор транзакции transfer. | `Тип`: String |
#### Пример запроса
```json
{
"consumer": {
"device": {
"serialNumber": "string"
}
},
"destinationCard": {
"bin": "integer",
"reference": {
"serverCardId": "string",
"uniqueReferenceCardId": "integer"
}
},
"session": {
"accessToken": "string",
"token":"string"
},
"sourceCard": {
"bin": "integer",
"reference": {
"serverCardId": "string",
"uniqueReferenceCardId": "integer"
}
}
}
```
#### Пример успешного ответа
```json
{
"invoiceId": "string",
"session": {
"checkSignature": "string",
"nonce": "string",
"token": "string"
}
}
```
#### Пример неуспешного ответа
```json
{
"error": {
"cause": "enum",
"code": "string",
"message": "string"
},
"invoiceId": "string"
}
```
### Transfer статус
#### Введение
Статус перевода инициируется через запрос HTTPS POST с использованием [URLs](#api-url-transfer-status) и [parameters](#api-parameters-transfer-status).
Funds transfer статус запрос is made by Присоединяющаяся сторона’s app to Payneteasy to get the статус of transfer транзакция. Payneteasy
Рекомендуется отправлять запрос статуса Transfer в течение 2–3 минут с интервалом 3–5 секунд между запросами. Сервер Присоединяющейся стороны должен полагаться на callback для окончательного статуса.
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|---------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/dapi/v1/transfer/{endpoint Id}/{invoice Id}/status | https://gate.payneteasy.ru/paynet/dapi/v1/transfer/{endpoint Id}/{invoice Id}/status |
#### Параметры запроса
| Название параметра | Описание | Значение |
|----------------------|-----------------------------------------------------------------------------|-------------------------------------------------------|
| session | | `Тип`: **Object** |
| session.access Token | The access token key received in Необязательное потребителя authentication. | `Тип`: String `Длина`: 32-128 |
| session.token | Token сессии транзакции transfer. | `Тип`: String `Длина`: 16-36 |
#### Параметры успешного ответа
| Название параметра | Описание | Значение |
|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| invoice Id | Идентификатор транзакции transfer. | `Тип`: String |
| session | | `Тип`: **Object** |
| session.token | Token сессии транзакции transfer. | `Тип`: String |
| state | Возможные значения: `PROCESSING`, `REDIRECT_REQUEST`, `APPROVED`, `DECLINED`. Если включены заданные Покупателем тарифы перевода, возвращается `TRANSFER_FEE_REQUEST`. | `Тип`: Enum |
| bank Order Id | Обязательное if state is `APPROVED` or `DECLINED`. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| redirect Url | Обязательное if state is `REDIRECT_REQUEST`. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| order Id | Идентификатор заказа в системе обработки платежей. | `Необходимость`: Условно `Тип`: String |
| transaction | | `Необходимость`: Условно `Тип`: **Object** |
| transaction.amount Centis | Сумма денежного перевода в центах: 1,00 EUR = 100 центов. | `Необходимость`: Условно `Тип`: Integer |
| transaction.commission Centis | Сумма удержанной комиссии в центах. | `Необходимость`: Условно `Тип`: Integer |
| transaction.order Created Date | Дата создания заказа в системе обработки платежей. | `Необходимость`: Условно `Тип`: String |
| transaction.transaction Created Date | Дата создания транзакции в системе обработки платежей. | `Необходимость`: Условно `Тип`: String |
| error Code | Код причины отклонения; может присутствовать, если состояние — `DECLINED`. | `Необходимость`: Опционально `Тип`: Integer |
| error Message | Сообщение о причине отклонения; может присутствовать, если состояние — `DECLINED`. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| secure3DAuth Status | Возможные значения: `AUTHENTICATED`, `NOT_AUTHENTICATED`, `UNSUPPORTED` означают, что карта не поддерживает 3-D Secure либо процесс аутентификации 3DS завершился с неизвестным статусом. | `Необходимость`: Опционально `Тип`: Enum |
| random Sum Auth Status | Возможные значения: `AUTHENTICATED`, `NOT_AUTHENTICATED`. | `Необходимость`: Опционально `Тип`: Enum |
#### Параметры успешного ответа для определённых клиентом тарифов Transfer
Ответ статуса Transfer содержит параметр state со значением TRANSFER_FEE_REQUEST и объект transfer Fee List со списком комиссий для возможных гейтов обработки. Каждый гейт обработки представлен собственным псевдонимом в параметре assigned Id. Значение TRANSFER_FEE_REQUEST параметра state существует только в потоке «Consumer defined transfer rates».
Когда транзакция достигает состояния TRANSFER_FEE_REQUEST, обработка останется приостановленной, пока не будет отправлен запрос Complete transfer.
| Название параметра | Описание | Значение |
|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| transfer Fee List | | `Тип`: **Object** |
| transfer Fee List.assigned Id | Aliased платёж gateway название. | `Тип`: String |
| transfer Fee List.commission Centis | Сумма комиссии для удержания в центах: 1,00 EUR = 100 центов. | `Тип`: Integer |
| transfer Fee List.currency | Буквы верхнего регистра (alpha-код по ISO 4217). | `Тип`: String |
| state | Помимо значений из [Status Transfer](#api-transfer-status), только в этом процессе существует значение `TRANSFER_FEE_REQUEST`. | `Тип`: String |
#### Параметры неуспешного ответа
| Название параметра | Описание | Значение |
|----------------------|------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| error | | `Тип`: **Object** |
| error.cause | Причина ошибки. Возможные значения: `FILTERED`, `INVALID_REQUEST`, `INTERNAL_ERROR`, `PROCESSING_FAILED`, `ORDER_NOT_FOUND`. | `Тип`: Enum |
| error.code | Уникальный код ошибки. | `Тип`: String |
| error.message | Описание ошибки. | `Тип`: String |
| invoice Id | Идентификатор транзакции transfer. | `Тип`: String |
#### Пример запроса
```json
{
"session": {
"accessToken": "string",
"token": "string"
}
}
```
#### Пример успешного ответа
```json
{
"bankOrderId": "string",
"invoiceId": "string",
"redirectUrl": "string",
"session": {
"token": "string"
},
"state": "enum"
}
```
#### Success Ответ Example for Потребитель defined transfer rates
**Следующая структура расширяет стандартное тело ответа о статусе Transfer (например, 2 обрабатывающих шлюза):**
```json
{
"bankOrderId": "string",
"invoiceId": "string",
"redirectUrl": "string",
"session": {
"token": "string"
},
"state": "TRANSFER_FEE_REQUEST",
"transferFeeList": [
{
"assignedId": "string",
"commissionCentis": "integer",
"currency": "string"
},
{
"assignedId": "string",
"commissionCentis": "integer",
"currency": "string"
}
]
}
```
#### Пример неуспешного ответа
```json
{
"error": {
"cause": "enum",
"code": "string",
"message": "string"
},
"invoiceId": "string"
}
```
#### Конструктор запросов
### Сценарии использования API
### /api/v2/auth-cash
#### Введение
Auth-cash инициируется запросом HTTPS POST с использованием указанных ниже [URL](#api-v2-auth-cash-url) и [параметров](#api-v2-auth-cash-request-parameters-url). Для аутентификации используйте [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|------------------------------------------------------------------|---------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/auth-cash/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/auth-cash/ENDPOINTID |
#### Параметры запроса
| Название параметра | Описание | Значение |
|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| order_desc | Описание заказа. | `Необходимость`: Обязательно `Тип`: String `Длина`: 64k |
| amount | Сумма к оплате. Сумма должна быть указана в наибольших единицах с разделителем .. Например, 10.5 для USD означает 10 долларов США и 50 центов. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция (см. [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| address1 | Адрес Плательщика, строка 1. (Обратите внимание, что в некоторых случаях невозможно отправить адрес длиной более 50 символов. Для получения более подробной информации обратитесь к вашему менеджеру.) | `Необходимость`: Обязательно `Тип`: String `Длина`: 256 |
| city | Город Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| zip_code | Почтовый индекс Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 10 |
| country | Страна Плательщика. Для списка действительных кодов см. [Коды стран](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). | `Необходимость`: Обязательно `Тип`: String `Длина`: 2 |
| phone | Полный международный номер телефона Плательщика, включая код страны. | `Необходимость`: Обязательно `Тип`: String `Длина`: 15 |
| email | Адрес электронной почты Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| ipaddress | IP-адрес Плательщика, передаётся для целей мониторинга мошенничества. | `Необходимость`: Обязательно `Тип`: String `Длина`: 45 |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1.
### /api/v2/capture
#### Введение
Списание инициируется через запрос HTTPS POST на указанный ниже [URL](#api-v2-capture-request-url) с использованием указанных [параметров](#api-v2-capture-request-parameters). Для аутентификации запроса используется [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Списание может быть вызвано только по предавторизации в конечном успешном статусе. См. [Статусы транзакций](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|---------------------------------------------------------------------------|------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/capture/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/capture/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/capture/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/capture/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
| Параметры запроса | Описание |
|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| login | Логин Присоединяющейся Стороны в Платёжном Шлюзе. |
| client_orderid | Идентификатор заказа Присоединяющейся Стороны для транзакции, статус которой запрашивается. |
| orderid | Номер заказа в системе Payneteasy |
| currency | Валюта списания транзакции (см. [коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). Примеры: USD для доллара США, EUR для евро. Этот параметр может передаваться или не передаваться. |
| amount | Сумма списания. Сумму необходимо указать в старших единицах с разделителем .. Например, 10.5 для USD означает 10 долларов США и 50 центов. Этот параметр может передаваться или не передаваться. |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса:login. 2. Параметр запроса: merchant-order-id. 3. Параметр запроса: paynet-order-id. 4. Параметр запроса:amount в минимальных денежных единицах (если отправлен). 5. Параметр запроса: currency (если отправлена сумма). 6. merchant_control (Контрольный ключ, назначенный для учетной записи Присоединяющейся Cтороны в Payneteasy). |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Параметры ответа | Описание |
|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может принимать такие значения как: async-response, validation-error, error и т.д. Если тип ответа validation-error или error, параметры error-message и error-code будут содержать детали ошибки. |
| paynet-order-id | Идентификатор заказа, присвоенный Payneteasy. |
| merchant-order-id | Идентификатор заказа Присоединяющейся Стороны. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| error-message | Для транзакций в статусе error этот параметр будет содержать причину отклонения или сведения об ошибке. |
| error-code | Код ошибки для транзакций в статусе error. |
| end-point-id | Идентификатор терминала, используемый для транзакции. |
#### Пример запроса
```http
POST /paynet/api/v2/capture/39914 HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.83.0
Accept: */*
Content-Length: 119
Content-Type: application/x-www-form-urlencoded
Connection: close
login=TestMerchant
&client_orderid=902B4FF5
&orderid=6863088
&amount=345
¤cy=USD
&control=da832c0fcff0105728e26465d5f99e6f83179a45
```
#### Пример успешного ответа
```http
HTTP/1.1 200 OK
Server: server
Date: Mon, 22 Aug 2022 13:15:19 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 140
type=async-response
&serial-number=00000000-0000-0000-0000-000002ddb06a
&merchant-order-id=902B4FF5
&paynet-order-id=6863088
&end-point-id=37211
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200 OK
Server: server
Date: Mon, 22 Aug 2022 12:59:09 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 154
pe=validation-error
&serial-number=00000000-0000-0000-0000-000002ddb06b
&error-message=Can+not+make+capture+for+order+state+AUTH_3D_VALIDATING
&error-code=27
```
#### Open API Collection
Open this method in the OpenAPI Reference
View in OpenAPI
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/create-card-ref
#### Введение
Создание идентификатора ссылки на карту инициируется запросом HTTPS POST с использованием указанных ниже [URL-адресов](#api-v2-card-ref-id-request-url) и [параметров](#card-ref-id-request-parameters). Для аутентификации используйте [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|-----------------------------------------------------------------------------------|--------------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/create-card-ref/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/create-card-ref/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/create-card-ref/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/create-card-ref/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
| Параметры запроса | Описание |
|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| login | Логин Присоединяющейся стороны в Системе. |
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. |
| orderid | Идентификатор заказа транзакции, присвоенный Платёжным Шлюзом. |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса: login 2. Параметр запроса: client_orderid 3. Параметр запроса: orderid 4. merchant_control (Контрольный ключ, назначенный для аккаунта Присоединяющейся стороны в системе Payneteasy). |
Присоединяющаяся Сторона должна предоставить orderid и client_orderid, связанные с первой платёжной транзакцией. Это подчёркивает, что первый платёж является обязательным шагом для обработки рекуррентных платежей. Для авторизации кредитной карты информация о ней должна быть достаточной, а первоначальный платёж должен находиться в [финальном статусе](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
The returned Recurring Payment ID and/or Card Reference ID is a token that refers to cardholder data stored on Payment Gateway side. See the required API command to find which type of token is supported in request parameters. This ID has the following usage:
1. In direct API commands it can be passed instead of cardholder data to initiate new transaction.
2. In form API commands it can be passed to prefill the payment form with previously saved cardholder data.
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Параметры ответа | Описание |
|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может принимать такие значения как - async-response, validation-error, error и т.д. Если тип равен validation-error или error, параметры error-message и error-code будут содержать сведения об ошибке. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| card-ref-id | Ссылочный идентификатор, для использования в повторных оплатах. |
| unq-card-ref-id | Уникальный идентификатор ссылки на карту для каждого PAN. Может использоваться Присоединяющейся стороной для программ лояльности или контроля мошенничества. |
| status | См. [список статусов](https://doc.payneteasy.ru/integration/reference/statuses.html.md). |
| error-message | Для транзакций в статусе declined или error этот параметр будет содержать причину отклонения или сведения об ошибке. |
| error-code | Код ошибки для транзакций в статусе declined или error. |
#### Пример запроса
```http
POST /paynet/api/v2/create-card-ref/46750 HTTP/1.1
Host: https://sandbox.payneteasy.ru
User-Agent: curl/7.85.0
Accept: */*
Content-Length: 100
Content-Type: application/x-www-form-urlencoded
Connection: close
login=login
&client_orderid=902B4FF5
&orderid=6937242
&control=717349cab3fcab2c13c93ff5770ae07a7b8e0727
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Tue, 07 Feb 2023 08:46:24 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 144
type=create-card-ref-response
&serial-number=00000000-0000-0000-0000-000002e110a2
&card-ref-id=1461670
&unq-card-ref-id=2463777
&status=approved
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200
Server: server
Date: Tue, 07 Feb 2023 08:55:26 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 123
type=validation-error
&serial-number=00000000-0000-0000-0000-000002e110ad
&error-message=INVALID_CONTROL_CODE
&error-code=2
```
#### Open API Collection
Open this method in the OpenAPI Reference
View in OpenAPI
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/get-card-info
#### Введение
Для интеграции используйте запрос интеграционной среды HTTPS POST к указанным ниже [URL](#api-v2-get-card-info-request-url) и [параметрам](#api-v2-get-card-info-request-parameters). Для аутентификации используйте [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|---------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/get-card-info/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/get-card-info/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
| Название параметра | Описание | Значение |
|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| login | Логин Присоединяющейся стороны в Системе. | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| cardrefid | ИД ссылки на карту, полученный на шаге [Регистрации Карты](https://doc.payneteasy.ru/integration/api_v2_create-card-ref.html.md). | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса: login 2. Параметр запроса: cardrefid 3. merchant_control (Контрольный ключ, присвоенный аккаунту Присоединяющейся стороны в системе шлюза Payneteasy). | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Information Параметры ответа | Описание |
|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может быть get-card-info-response, validation-error, error. Если type равен error, параметры error-message и error-code содержат детали ошибки. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| card-printed-name | Карта holder’s название. |
| bin | Bank Identification Number. |
| last-four-digits | Последние четыре цифры PAN. |
| expire-year | Год срока действия карты. |
| expire-month | Месяц срока действия карты. |
| result-3d | Описание: 3DS completion result. |
| error-message | Если статус validation-error или error, этот параметр содержит причину отклонения или детали ошибки. |
| error-code | Код ошибки в случае статуса validation-error или error. |
#### Пример запроса
```http
POST /paynet/api/v2/get-card-info/46750 HTTP/1.1
Host: https://sandbox.payneteasy.ru
User-Agent: curl/7.85.0
Accept: */
Content-Length: 77
Content-Type: application/x-www-form-urlencoded
Connection: close
&login=Test
&cardrefid=1461665
&control=f8ffd7dac9e334799862da0e9190387510d43ff7
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 11:21:39 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 193
type=get-card-info-response
&serial-number=00000000-0000-0000-0000-000002e0d218
&card-printed-name=CARD+HOLDER
&bin=453897
&last-four-digits=6732
&expire-year=2099
&expire-month=12
&result-3d=F
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 11:26:22 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 136
type=validation-error
&serial-number=00000000-0000-0000-0000-000002e0d21f
&error-message=End+point+with+id+99999+not+found
&error-code=3
```
#### Open API Collection
Open this method in the OpenAPI Reference
View in OpenAPI
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/get-exchange
#### Введение
Получение обменного курса инициируется запросом HTTPS POST с использованием указанных ниже [URL](#api-v2-get-exchange-request-url) и [параметров](#api-v2-get-exchange-parameters). Для аутентификации используйте [OAuth HMAC-SHA1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md). См. [статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|---------------------------------------------------------------------|------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/get-exchange/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/get-exchange/ENDPOINTID |
#### Параметры запроса
> **Note:** Запрос должен иметь content-type=application/x-www-form-urlencoded и [заголовки авторизации](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md).
| Название параметра | Описание | Значение |
|-----------------------------|-------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| exchange-provider | Описание: Exchange provider. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| exchange-currency-code-from | Код валюты, которую необходимо обменять (см.: [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| exchange-currency-code-to | Код валюты, который необходимо получить (см.: [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Название параметра | Описание |
|----------------------|---------------------------------|
| exchange-low-rate | Описание: Provider’s buy rate. |
| exchange-high-rate | Описание: Provider’s sell rate. |
#### Пример запроса
```http
POST /paynet/api/v2/get-exchange/39790 HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.83.0
Accept: */*
Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="test_merch",oauth_timestamp="1684995901",oauth_nonce="1kKy3hMlAe1",oauth_signature_method="HMAC-SHA1",oauth_signature="jGUaNFqLvBO1gGgWag%2FSU3wMnUc%3D"
Content-Length: 222
Content-Type: application/x-www-form-urlencoded
Connection: close
exchange-currency-code-from=USD
&exchange-currency-code-to=RUB
&exchange-provider=test
&oauth_consumer_key=test_merch
&oauth_nonce=1kKy3hMlAe1
&oauth_signature_method=HMAC-SHA1
&oauth_timestamp=1684995901
&oauth_version=1.0
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Thu, 25 May 2023 06:27:46 GMT
Content-Length: 48
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000
exchange-low-rate=10.00
&exchange-high-rate=20.00
```
#### Пример неуспешного ответа
```http
HTTP/1.1 403
Server: server
Date: Thu, 25 May 2023 07:02:59 GMT
Content-Type: text/html
Content-Length: 735
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
error-message=Book TCurrencyBook was not found by code USB
```
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/get-balance
#### Введение
Get Balance инициируется запросом HTTPS POST с использованием указанных ниже [URLs](#api-v2-get-balance-request-url) и [parameters](#api-v2-get-balance-request-parameters). Для аутентификации используйте [OAuth HMAC-SHA1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md). См. [Статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md). Также доступно для просмотра в UI. Обратитесь к менеджерам поддержки, чтобы включить эту функцию.
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|--------------------------------------------------------------------|-----------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/get-balance/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/get-balance/ENDPOINTID |
#### Параметры запроса
> **Note:** Запрос должен иметь content-type=application/x-www-form-urlencoded и [заголовки авторизации](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md).
| Название параметра | Описание | Значение |
|----------------------|-----------------------------|-----------------------------------------------------------------------------------------------|
| balance-provider | Введите поставщика баланса. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Параметры ответа | Описание |
|--------------------|----------------------------|
| balance-amount | Описание: Current balance. |
#### Пример запроса
```http
POST /paynet/api/v2/get-balance/ HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.83.0
Accept: */*
Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="balance_test_merchant14",oauth_signature_method="HMAC-SHA1",oauth_signature="hSXMSUPP%2FIGYOOWpU4LVx0mu7SA%3D"
Content-Length: 108
Content-Type: application/x-www-form-urlencoded
Connection: close
balance-provider=Test
&oauth_consumer_key=balance_test_merchant14
&oauth_nonce=2xGTFuAgetE
&oauth_signature_method=HMAC-SHA1
&oauth_timestamp=1686923599
&oauth_version=1.0
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Tue, 16 May 2023 08:06:05 GMT
Content-Length: 192
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000
[
{
"balance-amount":29.99,
}
]
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200
Server: server
Date: Fri, 16 Jun 2023 13:53:43 GMT
Content-Length: 42
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000
error-message=Unknown balance provider saa
```
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/get-balance/manager
#### Введение
Запрос баланса менеджером инициируется через HTTPS POST запрос с использованием [URL](#api-v2-get-balance-manager-request-url) и [параметров](#api-v2-get-balance-manager-request-parameters), указанных ниже. Для аутентификации используется [OAuth HMAC-SHA1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md). См. [Статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md). Также доступно в UI. Для подключения данной функциональности обратитесь в службу технической поддержки.
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/get-balance/manager/MANAGERLOGIN | https://gate.payneteasy.ru/paynet/api/v2/get-balance/manager/MANAGERLOGIN |
#### Параметры запроса
> **Note:** Запрос должен иметь content-type=application/x-www-form-urlencoded и [заголовки авторизации](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md).
| Название параметра | Описание | Значение |
|----------------------|-------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| balance-name | Название баланса. Если параметр не указан, в результате будут возвращены все доступные балансы. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Параметры ответа | Описание |
|------------------------------|----------------------------------------------------------------------------------------------------------|
| name | Название баланса. |
| amount | Текущий баланс с учётом STH и Rolling reserve. |
| online-balance-live-amount | Текущий баланс, рассчитанный по конфигурации без учёта STH и Rolling reserve. Live = current - STH - RR. |
| total-short-term-hold-amount | Текущая сумма удержания на основе Date bumping function. |
| total-rolling-reserve-amount | Текущая сумма, рассчитанная на основе удержания тарифного плана. |
| currency | Валюта, используемая для выбранного баланса. |
| merchant Login | Логин Торговца для данного баланса. |
| amount-buffer-hold | Рассчитанная сумма для исходящих операций без финального статуса. |
#### Пример запроса
```http
POST /paynet/api/v2/get-balance/manager/BalanceTestManager HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.83.0
Accept: */*
Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="BalanceTestManager",oauth_timestamp="1686924196",oauth_nonce="sT33IbJ4QHs",oauth_signature_method="HMAC-SHA1",oauth_signature="LyKy7M8P%2F%2FZxyLnh7ULW405ODVs%3D"
Content-Length: 156
Content-Type: application/x-www-form-urlencoded
Connection: close
balance-name=saa
&oauth_consumer_key=BalanceTestManager
&oauth_nonce=sT33IbJ4QHs
&oauth_signature_method=HMAC-SHA1
&oauth_timestamp=1686924196
&oauth_version=1.0
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Tue, 16 May 2023 08:06:05 GMT
Content-Length: 192
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000
[
{
"name":"saa",
"amount":219.500,
"online-balance-live-amount":219.500,
"total-short-term-hold-amount":0.000,
"total-rolling-reserve-amount":0.000,
"currency":"USD",
"merchantLogin":"balance_test_merchant14",
"externalMerchantIdentifier":null,
"amount-buffer-hold":0.000
}
]
```
#### Пример неуспешного ответа
```http
HTTP/1.1 403
Server: server
Date: Fri, 16 Jun 2023 13:23:37 GMT
Content-Type: text/html
Content-Length: 735
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
...
Access is denied
``` #### Коллекция Postman #### Конструктор запросов
### /api/v2/get-balance/merchant
#### Введение
Get Balance by Merchant инициируется через HTTPS POST запрос с использованием [URL](#api-v2-get-balance-merchant-request-url) и [параметров](#api-v2-get-balance-merchant-request-parameters), указанных ниже. Для аутентификации используйте [OAuth HMAC-SHA1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md). См. [Статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md). Также можно просмотреть в интерфейсе. Свяжитесь со службой поддержки, чтобы включить эту функцию.
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|--------------------------------------------------------------------------------|-----------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/get-balance/merchant/MERCHANTLOGIN | https://gate.payneteasy.ru/paynet/api/v2/get-balance/merchant/MERCHANTLOGIN |
#### Параметры запроса
> **Note:** Запрос должен иметь content-type=application/x-www-form-urlencoded и [заголовки авторизации](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md).
| Название параметра | Описание | Значение |
|----------------------|-------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| balance-name | Название баланса. Если параметр не указан, в результате будут возвращены все доступные балансы. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Параметры ответа | Описание |
|------------------------------|----------------------------------------------------------------------------------------------------------|
| name | Название баланса. |
| amount | Текущий баланс с учётом STH и Rolling reserve. |
| online-balance-live-amount | Текущий баланс, рассчитанный по конфигурации без учёта STH и Rolling reserve. Live = current - STH - RR. |
| total-short-term-hold-amount | Текущая сумма удержания на основе Date bumping function. |
| total-rolling-reserve-amount | Текущая сумма, рассчитанная на основе удержания тарифного плана. |
| currency | Валюта, используемая для выбранного баланса. |
| amount-buffer-hold | Рассчитанная сумма для исходящих операций без финального статуса. |
#### Пример запроса
```http
POST /paynet/api/v2/get-balance/merchant/balance_test_merchant14 HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.83.0
Accept: */*
Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="balance_test_merchant14",oauth_timestamp="1686924613",oauth_nonce="qoJPcins4Aw",oauth_signature_method="HMAC-SHA1",oauth_signature="M6fTXbI0tFz4Dy7YEL3SBzCN1I0%3D"
Content-Length: 161
Content-Type: application/x-www-form-urlencoded
Connection: close
balance-name=saa
&oauth_consumer_key=balance_test_merchant14
&oauth_nonce=qoJPcins4Aw
&oauth_signature_method=HMAC-SHA1
&oauth_timestamp=1686924613
&oauth_version=1.0
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Tue, 16 May 2023 08:06:05 GMT
Content-Length: 192
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000
[
{
"name":"Test1",
"amount":8854.000,
"online-balance-live-amount":8854.000,
"total-short-term-hold-amount":0.000,
"total-rolling-reserve-amount":0.000,
"currency":"AUD",
"amount-buffer-hold":0.000
}
]
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200
Server: server
Date: Tue, 16 May 2023 08:06:05 GMT
Content-Length: 192
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000
...
Access is denied
``` #### Коллекция Postman #### Конструктор запросов
### /api/v2/make-rebill-preauth
#### Введение
Повторная предавторизация инициируется через запрос HTTPS POST на указанный ниже [URL](#make-rebill-request-url) с использованием указанных [параметров](#make-rebill-request-parameters). Для аутентификации запроса используется [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [Статусы транзакций](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|---------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/make-rebill-preauth/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/make-rebill-preauth/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/make-rebill-preauth/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/make-rebill-preauth/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
| Название параметра | Описание | Значение |
|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| login | Логин Присоединяющейся стороны в Системе. | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| cardrefid | Ссылочный идентификатор, полученный на этапе регистрации карты (или иного платежного метода) [/api/v2/create-card-ref/](https://doc.payneteasy.ru/integration/api_v2_create-card-ref.html.md). | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| amount | Сумма к оплате. Сумма должна быть указана в наибольших единицах с разделителем .. Например, 10.5 для USD означает 10 долларов США и 50 центов. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция. Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| enumerate_amounts | Парметр может содержать последовательность из нескольких сумм, разделенных запятой ,. Payneteasy проведет несколько попыток оплаты с указанными суммами, пока не будет получен успешный статус или пока не закончится последовательность переданных сумм. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| recurrent_scenario | Тип повторной оплаты. Возможные значения: REGULAR (регулярный) или IRREGULAR (нерегулярный). Если параметр передан в запросе, его значение имеет приоритет над значением этого параметра, установленном на шлюзе. Актуально только для некоторых Экваеров. | `Необходимость`: Опционально `Тип`: String `Длина`: 50 |
| recurrent_initiator | Инициатор повторной оплаты. Возможные значения: CARDHOLDER (держатель карты) или MERCHANT (торговец). Если параметр передан в запросе, его значение имеет приоритет над значением этого параметра, установленном на шлюзе. Актуально только для некоторых Экваеров. | `Необходимость`: Опционально `Тип`: String `Длина`: 50 |
| cvv2 | CVV2-код Плательщика. CVV2 (Card Verification Значение) — это трех- или четырех-значное число ПОСЛЕ номера кредитной карты в области подписи карты. Может быть пустым или отсутствовать, если эквайринговый канал поддерживает процессинг без CVV2 или он не актуален для данного платёжного метода. | `Необходимость`: Опционально `Тип`: Numeric `Длина`: 3-4 |
| ipaddress | IP-адрес Плательщика. Включен для отслеживания мошеннических действий. | `Необходимость`: Обязательно `Тип`: String `Длина`: 45 |
| comment | Короткий комментарий. | `Необходимость`: Опционально `Тип`: String `Длина`: 50 |
| order_desc | Описание заказа. | `Необходимость`: Обязательно `Тип`: String `Длина`: 64k |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса: login 2. Параметр запроса: client_orderid 3. Параметр запроса: cardrefid 4. Параметр запроса:amount в минимальных денежных единицах (если отправлен). 5. Параметр запроса: currency 6. merchant_control (Контрольный ключ, назначенный для учетной записи Присоединяющейся Cтороны в Payneteasy). | `Необходимость`: Обязательно `Тип`: String `Длина`: 40 |
| purpose | Получатель платежа. Это полезно для Присоединяющейся стороны, позволяющей клиентам переводить деньги с кредитной карты на какой-либо счёт клиента, например игровой счёт или счёт мобильного телефона. Примеры значений: +9999999999; mail@example.com и т. д. Это значение будет использоваться системой мониторинга мошенничества. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| redirect_url | URL-адрес, на который будет перенаправлен держатель карты после завершения транзакции. Обратите внимание: держатель карты будет перенаправлен в любом случае — независимо от того, была ли транзакция approved или declined. Этот параметр не следует использовать для получения результатов из Платёжного Шлюза Payneteasy, поскольку все параметры передаются через браузер клиента и могут быть потеряны при передаче. Для доставки корректного результата платежа в бэкенд следует использовать server_callback_url. Параметр обязателен для сценария 3DS и необязателен для сценария без 3DS. https://doc.payneteasy.ru можно использовать для тестирования, если неизвестно, используется ли 3DS. | `Необходимость`: Опционально `Тип`: String `Длина`: 1024 |
| server_callback_url | URL-адрес server_callback_url, по которому будет отправлен обратный вызов с результатом транзакции. Присоединяющаяся сторона может использовать обратные вызовы для индивидуальной обработки завершения транзакции (например, для сбора данных о платежах в информационной системе Присоединяющейся стороны). Список параметров, включенных в обратный вызов, см. в разделе [Обратного вызова Присоединяющейся стороны](https://doc.payneteasy.ru/integration/merchant_callback_parameters.html.md). Данный параметр может быть передан вместо notify_url. При использовании server_callback_url платежный шлюз отправляет callback-уведомление только при получении финального статуса исходной транзакции. При использовании notify_url платежный шлюз отправляет уведомление при получении финального статуса и продолжает отправлять уведомления о всех последующих изменениях (возвраты, chargeback и др.). | `Необходимость`: Опционально `Тип`: String `Длина`: 1024 |
| notify_url | URL-адрес notify_url, по которому будет отправлен обратный вызов с результатом транзакции. Присоединяющаяся сторона может использовать обратные вызовы для индивидуальной обработки завершения транзакции (например, для сбора данных о платежах в информационной системе Присоединяющейся стороны). Список параметров, включенных в обратный вызов, см. в разделе [Обратного вызова Присоединяющейся стороны](https://doc.payneteasy.ru/integration/merchant_callback_parameters.html.md). Данный параметр может быть передан вместо server_callback_url. При использовании notify_url платежный шлюз отправляет уведомление при получении финального статуса и продолжает отправлять уведомления о всех последующих изменениях (возвраты, chargeback и др.). При использовании server_callback_url платежный шлюз отправляет callback-уведомление только при получении финального статуса исходной транзакции. | `Необходимость`: Опционально `Тип`: String `Длина`: 1024 |
| merchant_data | Любая дополнительная информация о транзакции, которая может быть полезна во внешних системах Присоединяющейся стороны, например VIP клиент, лид промокампании на ТВ. | `Необходимость`: Опционально `Тип`: String `Длина`: 64 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Параметры ответа | Описание |
|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может принимать такие значения как - async-response, validation-error, error и т.д. Если тип равен validation-error или error, параметры error-message и error-code будут содержать сведения об ошибке. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| merchant-order-id | Номер заказа в системе Присоединяющейся Стороны. |
| paynet-order-id | Идентификатор заказа, присвоенный Payneteasy. |
| end-point-id | Идентификатор терминала, используемый для транзакции. |
| error-message | Для транзакций в статусе error этот параметр будет содержать причину отклонения или сведения об ошибке. |
| error-code | Код ошибки для транзакций в статусе error. |
#### Пример запроса
```http
POST /paynet/api/v2/make-rebill-preauth/46750 HTTP/1.1
Host: https://sandbox.payneteasy.ru
User-Agent: curl/7.85.0
Accept: */
Content-Length: 229
Content-Type: application/x-www-form-urlencoded
Connection: close
&login=login
&client_orderid=902B4FF5
&cardrefid=1461665
&amount=5.00
¤cy=USD
&cvv2=321
&ipaddress=34.129.65.12
&comment=Information abount Rebill
&order_desc=Rebill order description
&control=a37f4972233b4a5dbfb4dcaae149ce7feed01ef9
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 13:10:44 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 144
&type=async-response
&serial-number=00000000-0000-0000-0000-000002e0d498
&merchant-order-id=902B4FF5
&paynet-order-id=6937030
&end-point-id=46750
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 13:18:50 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 164
type=validation-error
&serial-number=00000000-0000-0000-0000-000002e0d614
&merchant-order-id=902B4FF5
&error-message=End+point+with+id+99999+not+found
&error-code=3
```
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/make-rebill-sale
#### Введение
Повторная оплата инициируется через запрос HTTPS POST на указанный ниже [URL](#api-v2-make-rebill-request-url) с использованием указанных [параметров](#api-v2-make-rebill-request-parameters). Для аутентификации запроса используется [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [Статусы транзакций](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/make-rebill-sale/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/make-rebill-sale/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/make-rebill-sale/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/make-rebill-sale/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
| Название параметра | Описание | Значение |
|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| login | Логин Присоединяющейся стороны в Системе. | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| cardrefid | Ссылочный идентификатор, полученный на этапе регистрации карты (или иного платежного метода) [/api/v2/create-card-ref/](https://doc.payneteasy.ru/integration/api_v2_create-card-ref.html.md). | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| amount | Сумма к оплате. Сумма должна быть указана в наибольших единицах с разделителем .. Например, 10.5 для USD означает 10 долларов США и 50 центов. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция. Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| enumerate_amounts | Парметр может содержать последовательность из нескольких сумм, разделенных запятой ,. Payneteasy проведет несколько попыток оплаты с указанными суммами, пока не будет получен успешный статус или пока не закончится последовательность переданных сумм. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| recurrent_scenario | Тип повторной оплаты. Возможные значения: REGULAR (регулярный) или IRREGULAR (нерегулярный). Если параметр передан в запросе, его значение имеет приоритет над значением этого параметра, установленном на шлюзе. Актуально только для некоторых Экваеров. | `Необходимость`: Опционально `Тип`: String `Длина`: 50 |
| recurrent_initiator | Инициатор повторной оплаты. Возможные значения: CARDHOLDER (держатель карты) или MERCHANT (торговец). Если параметр передан в запросе, его значение имеет приоритет над значением этого параметра, установленном на шлюзе. Актуально только для некоторых Экваеров. | `Необходимость`: Опционально `Тип`: String `Длина`: 50 |
| cvv2 | CVV2-код Плательщика. CVV2 (Card Verification Значение) — это трех- или четырех-значное число ПОСЛЕ номера кредитной карты в области подписи карты. Может быть пустым или отсутствовать, если эквайринговый канал поддерживает процессинг без CVV2 или он не актуален для данного платёжного метода. | `Необходимость`: Опционально `Тип`: Numeric `Длина`: 3-4 |
| ipaddress | IP-адрес Плательщика. Включен для отслеживания мошеннических действий. | `Необходимость`: Обязательно `Тип`: String `Длина`: 45 |
| comment | Короткий комментарий. | `Необходимость`: Опционально `Тип`: String `Длина`: 50 |
| order_desc | Описание заказа. | `Необходимость`: Обязательно `Тип`: String `Длина`: 64k |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса: login 2. Параметр запроса: client_orderid 3. Параметр запроса: cardrefid 4. Параметр запроса:amount в минимальных денежных единицах (если отправлен). 5. Параметр запроса: currency 6. merchant_control (Контрольный ключ, назначенный для учетной записи Присоединяющейся Cтороны в Payneteasy). | `Необходимость`: Обязательно `Тип`: String `Длина`: 40 |
| purpose | Получатель платежа. Это полезно для Присоединяющейся стороны, позволяющей клиентам переводить деньги с кредитной карты на какой-либо счёт клиента, например игровой счёт или счёт мобильного телефона. Примеры значений: +9999999999; mail@example.com и т. д. Это значение будет использоваться системой мониторинга мошенничества. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| redirect_url | URL-адрес, на который будет перенаправлен держатель карты после завершения транзакции. Обратите внимание: держатель карты будет перенаправлен в любом случае — независимо от того, была ли транзакция approved или declined. Этот параметр не следует использовать для получения результатов из Платёжного Шлюза Payneteasy, поскольку все параметры передаются через браузер клиента и могут быть потеряны при передаче. Для доставки корректного результата платежа в бэкенд следует использовать server_callback_url. Параметр обязателен для сценария 3DS и необязателен для сценария без 3DS. https://doc.payneteasy.ru можно использовать для тестирования, если неизвестно, используется ли 3DS. | `Необходимость`: Опционально `Тип`: String `Длина`: 1024 |
| server_callback_url | URL-адрес server_callback_url, по которому будет отправлен обратный вызов с результатом транзакции. Присоединяющаяся сторона может использовать обратные вызовы для индивидуальной обработки завершения транзакции (например, для сбора данных о платежах в информационной системе Присоединяющейся стороны). Список параметров, включенных в обратный вызов, см. в разделе [Обратного вызова Присоединяющейся стороны](https://doc.payneteasy.ru/integration/merchant_callback_parameters.html.md). Данный параметр может быть передан вместо notify_url. При использовании server_callback_url платежный шлюз отправляет callback-уведомление только при получении финального статуса исходной транзакции. При использовании notify_url платежный шлюз отправляет уведомление при получении финального статуса и продолжает отправлять уведомления о всех последующих изменениях (возвраты, chargeback и др.). | `Необходимость`: Опционально `Тип`: String `Длина`: 1024 |
| notify_url | URL-адрес notify_url, по которому будет отправлен обратный вызов с результатом транзакции. Присоединяющаяся сторона может использовать обратные вызовы для индивидуальной обработки завершения транзакции (например, для сбора данных о платежах в информационной системе Присоединяющейся стороны). Список параметров, включенных в обратный вызов, см. в разделе [Обратного вызова Присоединяющейся стороны](https://doc.payneteasy.ru/integration/merchant_callback_parameters.html.md). Данный параметр может быть передан вместо server_callback_url. При использовании notify_url платежный шлюз отправляет уведомление при получении финального статуса и продолжает отправлять уведомления о всех последующих изменениях (возвраты, chargeback и др.). При использовании server_callback_url платежный шлюз отправляет callback-уведомление только при получении финального статуса исходной транзакции. | `Необходимость`: Опционально `Тип`: String `Длина`: 1024 |
| merchant_data | Любая дополнительная информация о транзакции, которая может быть полезна во внешних системах Присоединяющейся стороны, например VIP клиент, лид промокампании на ТВ. | `Необходимость`: Опционально `Тип`: String `Длина`: 64 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Параметры ответа | Описание |
|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может принимать такие значения как - async-response, validation-error, error и т.д. Если тип равен validation-error или error, параметры error-message и error-code будут содержать сведения об ошибке. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| merchant-order-id | Номер заказа в системе Присоединяющейся Стороны. |
| paynet-order-id | Идентификатор заказа, присвоенный Payneteasy. |
| end-point-id | Идентификатор терминала, используемый для транзакции. |
| error-message | Для транзакций в статусе error этот параметр будет содержать причину отклонения или сведения об ошибке. |
| error-code | Код ошибки для транзакций в статусе error. |
#### Пример запроса
```http
POST /paynet/api/v2/make-rebill-sale/46750 HTTP/1.1
Host: https://sandbox.payneteasy.ru
User-Agent: curl/7.85.0
Accept: */
Content-Length: 229
Content-Type: application/x-www-form-urlencoded
Connection: close
&login=login
&client_orderid=902B4FF5
&cardrefid=1461665
&amount=5.00
¤cy=USD
&cvv2=123
&ipaddress=34.129.65.12
&comment=Information abount Rebill
&order_desc=Rebill order description
&control=a37f4972233b4a5dbfb4dcaae149ce7feed01ef9
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 13:22:04 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 144
type=async-response
&serial-number=00000000-0000-0000-0000-000002e0d6b9
&merchant-order-id=902B4FF5
&paynet-order-id=6937242
&end-point-id=46750
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 13:24:47 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 164
type=validation-error
&serial-number=00000000-0000-0000-0000-000002e0d74c
&merchant-order-id=902B4FF5
&error-message=End+point+with+id+99999+not+found
&error-code=3
```
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/payout-form
#### Введение
Оплата по форме инициируется через запрос методом HTTPS POST на указанный ниже [URL](#api-v2-payout-form-url) с использованием указанных [параметров](#api-v2-payout-form-parameters). Для аутентификации запроса используется [OAuth HMAC-SHA1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md). См. [Статусы транзакций](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|---------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/payout-form/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/payout-form/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/payout-form/group/ENDPOINTIDGROUPID | https://gate.payneteasy.ru/paynet/api/v2/payout-form/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь content-type=application/x-www-form-urlencoded и [Заголовки авторизации](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md).
Уточните у менеджера поддержки, требуются ли условные поля для интеграции.
| Название параметра | Описание | Значение |
|-----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| client_orderid | Идентификатор заказа, присвоенный Присоединяющейся Стороной. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| amount | Сумма к оплате. Сумма должна быть указана в максимальных единицах с “.” разделителем. Например, 100.5 в RUB означает 100 российских рублей и 50 копеек. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция (трёхбуквенные алфавитные коды валют). Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| order_desc | Описание заказа. | `Необходимость`: Обязательно `Тип`: String `Длина`: 65K |
| ipaddress | IP-адрес получателя (IPv4 или IPv6). | `Необходимость`: Условно `Тип`: String `Длина`: 7-45 |
| purpose | Назначение Payout. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| server_callback_url | URL-адрес server_callback_url, по которому будет отправлен обратный вызов с результатом транзакции. Присоединяющаяся сторона может использовать обратные вызовы для индивидуальной обработки завершения транзакции (например, для сбора данных о платежах в информационной системе Присоединяющейся стороны). Список параметров, включенных в обратный вызов, см. в разделе [Обратного вызова Присоединяющейся стороны](https://doc.payneteasy.ru/integration/merchant_callback_parameters.html.md). Данный параметр может быть передан вместо notify_url. При использовании server_callback_url платежный шлюз отправляет callback-уведомление только при получении финального статуса исходной транзакции. При использовании notify_url платежный шлюз отправляет уведомление при получении финального статуса и продолжает отправлять уведомления о всех последующих изменениях (возвраты, chargeback и др.). | `Необходимость`: Опционально `Тип`: String `Длина`: 1024 |
| notify_url | URL-адрес notify_url, по которому будет отправлен обратный вызов с результатом транзакции. Присоединяющаяся сторона может использовать обратные вызовы для индивидуальной обработки завершения транзакции (например, для сбора данных о платежах в информационной системе Присоединяющейся стороны). Список параметров, включенных в обратный вызов, см. в разделе [Обратного вызова Присоединяющейся стороны](https://doc.payneteasy.ru/integration/merchant_callback_parameters.html.md). Данный параметр может быть передан вместо server_callback_url. При использовании notify_url платежный шлюз отправляет уведомление при получении финального статуса и продолжает отправлять уведомления о всех последующих изменениях (возвраты, chargeback и др.). При использовании server_callback_url платежный шлюз отправляет callback-уведомление только при получении финального статуса исходной транзакции. | `Необходимость`: Опционально `Тип`: String `Длина`: 1024 |
| redirect_url | URL, where the Receiver is redirected to upon completion of the transaction. Please note that redirection is performed in any case, no matter whether transaction is approved, declined in any other final [status](https://doc.payneteasy.ru/integration/reference/statuses.html.md). Connecting Party must not use the parameters come along with the redirect HTTP Request to treat the status of the transaction. Instead Connecting Party can utilize server_callback_url or [status API command](https://doc.payneteasy.ru/integration/api_v2_status.html.md). Pass https://doc.payneteasy.ru if you have no need to return Receiver anywhere. Use either redirect_url or combination of redirect_success_url and redirect_fail_url, not both. | `Необходимость`: требуется, если отсутствуют оба параметра redirect_success_url и redirect_fail_url `Тип`: String `Длина`: 1024 |
| redirect_success_url | URL, на который Получатель перенаправляется, когда статус транзакции — approved (см. [список статусов](https://doc.payneteasy.ru/integration/reference/statuses.html.md)). Connecting Party must not use the parameters come along with the redirect HTTP Request to treat the status of the transaction. Instead Connecting Party can utilize server_callback_url or [status API command](https://doc.payneteasy.ru/integration/api_v2_status.html.md). Otherwise put https://doc.payneteasy.ru if there is no need to redirect Receiver anywhere. Use either combination of redirect_success_url and redirect_fail_url or redirect_url, not both. | `Необходимость`: требуется, если отсутствует параметр redirect_url `Тип`: String `Длина`: 1024 |
| redirect_fail_url | URL, на который Получатель перенаправляется, когда статус транзакции не approved (см. [список статусов](https://doc.payneteasy.ru/integration/reference/statuses.html.md)). Connecting Party must not use the parameters come along with the redirect HTTP Request to treat the status of the transaction. Instead Connecting Party can utilize server_callback_url or [status API command](https://doc.payneteasy.ru/integration/api_v2_status.html.md). Pass https://doc.payneteasy.ru if you use non-3DS schema for transactions processing and you have no need to return Receiver anywhere. Use either combination of redirect_fail_url and redirect_success_url or redirect_url, not both. | `Необходимость`: требуется, если отсутствует параметр redirect_url `Тип`: String `Длина`: 1024 |
| account_number | Account номер. | `Необходимость`: Условно `Тип`: String `Длина`: 32 |
| account_name | Банковский счет | `Необходимость`: Условно `Тип`: String `Length`: 512 |
| ewallet_wallet | Идентификатор e-wallet. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| crypto_wallet_address | Адрес криптокошелька. | `Необходимость`: Условно `Тип`: String `Длина`: 64 |
| bank_name | Имя банка. | `Необходимость`: Условно `Тип`: String `Length`: 512 |
| bank_branch | Имя банковского отделения. | `Необходимость`: Условно `Тип`: String `Length`: 512 |
| bank_code | Код банка. | `Необходимость`: Условно `Тип`: String `Длина`: 32 |
| bank_address1 | Адрес банка. | `Необходимость`: Условно `Тип`: String `Длина`: 255 |
| bank_zip_code | Почтовый индекс банка. | `Необходимость`: Условно `Тип`: String `Длина`: 32 |
| bank_province | Штат банка. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| bank_area | Область банка | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| bank_city | Город банка. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| routing_number | Номер маршрута, используется для определения отдела банка в Китае. | `Необходимость`: Условно `Тип`: String `Длина`: 32 |
| legal_person_name | Имя на юридическом документе. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| legal_person_document_number | Номер юридического документа | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| receiver_first_name | Имя Получателя, так же можно отправить как first_name. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| receiver_last_name | Фамилия Получателя, так же можно отправить как last_name. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| receiver_birthday | Дата рождения получателя, так-же можно отправить как birthday. | `Необходимость`: Условно `Тип`: Numeric `Длина`: 30 |
| receiver_country_code | Код страны Получателя, также можно отправить как country. | `Необходимость`: Условно `Тип`: String `Длина`: 3 |
| receiver_state | Штат Получателя, обязательный параметр для стран, которые делятся на штаты (США, Канада, Австралия), также можно отправить как state. | `Необходимость`: Условно `Тип`: String `Длина`: 4 |
| receiver_city | Город Получателя, также можно отправить как city. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| receiver_zip_code | Почтовый индекс Получателя, также можно отправить как zip_code. | `Необходимость`: Условно `Тип`: Numeric `Длина`: 32 |
| receiver_address1 | Адрес Получателя, также можно отправить как address1. | `Необходимость`: Условно `Тип`: String `Длина`: 255 |
| receiver_phone | Номер телефона Получателя, также можно отправить как phone. | `Необходимость`: Условно `Тип`: Numeric `Длина`: 128 |
| receiver_email | Адрес электронной почты Получателя, также можно отправить как email. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| receiver_identity_document_id | Идентификатор удостоверения личности получателя, так-же можно отправитькак identity_document_id. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| receiver_identity_document_number | Номер удостоверения личности получателя, так-же можно отправитькак identity_document_number. | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| merchant_data | Любая дополнительная информация для этой транзакции, которая может быть полезна во внешних системах Присоединяющейся стороны, например VIP-клиент, лид промокампании TV. Будет возвращена в ответе Status и Callback Присоединяющейся стороны. | `Необходимость`: Опционально `Тип`: String `Length`: 65k |
| merchant_form_data | Parameters sent in merchant_form_data API parameter are parsed into macros with the same name, the parameter is url-encoded, example: testparam%3Dtest1%26mynewparam%3Dtest2 and is parsed into $MFD_testparam = test1 and $MFD_mynewparam = test2 macros in the form. Parameter name characters[a-zA-Z0-9], parameter value characters[a-zA-Z0-9], only characters = and & are allowed as control characters, 2MB max size. For example, this parameter can be used to display payment form in light/dark mode depending on the value passed by Connecting Party (e.g. pass merchant_form_data=theme%3Ddark in request and $MFD_theme macro placeholder on payment form will be changed to dark. | `Необходимость`: Опционально `Тип`: String `Длина`: 2M |
| preferred_language | Предпочтительный язык. | `Необходимость`: Опционально `Тип`: String `Длина`: 2 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют формат x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Название параметра | Описание |
|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может принимать такие значения как: async-response, validation-error, error и т.д. Если тип ответа validation-error или error, параметры error-message и error-code будут содержать детали ошибки. |
| paynet-order-id | Идентификатор заказа, присвоенный Payneteasy. |
| merchant-order-id | Идентификатор заказа Присоединяющейся Стороны. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| error-message | Для транзакций в статусе error этот параметр будет содержать причину отклонения или сведения об ошибке. |
| error-code | Код ошибки для транзакций в статусе error. |
| redirect_url | URL страницы, на которую Присоединяющаяся сторона должна перенаправить браузер клиента. Присоединяющаяся сторона должна отправить перенаправление HTTP 302. |
#### Пример запроса
```http
POST /paynet/api/v2/payout-form/39529 HTTP/1.1
Host: sandbox.doc2.com
User-Agent: curl/8.12.1
Accept: */*
Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="merchantlogin",oauth_timestamp="1753337681",oauth_nonce="T5v7kcMBsgi",oauth_signature_method="HMAC-SHA1",oauth_signature="wTTQQiN%2F2bGjfCTcSAQ3ZhAHMLw%3D"
Content-Length: 249
Content-Type: application/x-www-form-urlencoded
Connection: keep-alive
account_number=1234567890
&order_desc=Test_Order_Описание
&amount=100
&bank_branch=test_branch
&bank_name=test_bank
&client_orderid=12345
¤cy=USD
&oauth_consumer_key=merchantlogin
&oauth_nonce=T5v7kcMBsgi
&oauth_signature_method=HMAC-SHA1
&oauth_timestamp=1753337681
&oauth_version=1.0
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Thu, 24 Jul 2025 06:45:56 GMT
Content-Type: text/html;charset=utf-8
Connection: keep-alive
Keep-Alive: timeout=60
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 142
type=async-response
&serial-number=00000000-0000-0000-0000-000002f3b45d
&merchant-order-id=12345
&paynet-order-id=7366391
&end-point-id=132490
```
#### Пример неуспешного ответа
```http
HTTP/1.1 403
Server: server
Date: Thu, 24 Jul 2025 06:26:23 GMT
Content-Type: application/x-www-form-urlencoded;charset=UTF-8
Connection: keep-alive
Keep-Alive: timeout=60
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Length: 102
type=error
&serial-number=00000000-0000-0000-0000-000002f3b456
&error-message=Forbidden
&error-code=-1
```
#### Test Scenario
Различные статусы транзакций Payout можно получить в sandbox в зависимости от значения account_number, переданного в запросе Payout.
Тестовые значения account_number:
> * account_number = 1234567890 для получения APPROVED
> * account_number = 0987654321 для получения DECLINED
> * account_number = 1987654321 для получения PROCESSOR_INTERNAL_ERROR
#### Open API Collection
Open this method in the OpenAPI Reference
View in OpenAPI
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/preauth-form
#### Введение
Предавторизация по форме инициируется через запрос методом HTTPS POST на указанный ниже [URL](#api-v2-preauth-form-url) с использованием указанных [параметров](#api-v2-preauth-form-request-parameters). Для аутентификации запроса используется [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [Статусы транзакций](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|--------------------------------------------------------------------------------|-----------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/preauth-form/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/preauth-form/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/preauth-form/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/preauth-form/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
Банк может переопределить необходимость некоторых полей, сделав их обязательными.
Пробелы в начале и в конце значений параметров будут отсечены.
| Название параметра | Описание | Значение |
|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| order_desc | Описание заказа. | `Необходимость`: Обязательно `Тип`: String `Длина`: 64k |
| amount | Сумма к оплате. Сумма должна быть указана в наибольших единицах с разделителем .. Например, 10.5 для USD означает 10 долларов США и 50 центов. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция (см. [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| address1 | Адрес Плательщика, строка 1. (Обратите внимание, что в некоторых случаях невозможно отправить адрес длиной более 50 символов. Для получения более подробной информации обратитесь к вашему менеджеру.) | `Необходимость`: Обязательно `Тип`: String `Длина`: 256 |
| city | Город Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| zip_code | Почтовый индекс Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 10 |
| country | Страна Плательщика. Для списка действительных кодов см. [Коды стран](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). | `Необходимость`: Обязательно `Тип`: String `Длина`: 2 |
| phone | Полный международный номер телефона Плательщика, включая код страны. | `Необходимость`: Обязательно `Тип`: String `Длина`: 15 |
| email | Адрес электронной почты Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| ipaddress | IP-адрес Плательщика, передаётся для целей мониторинга мошенничества. | `Необходимость`: Обязательно `Тип`: String `Длина`: 45 |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1.
### /api/v2/preauth
#### Введение
Preauth инициируется запросом HTTPS POST с использованием указанных ниже [URL](#api-v2-preauth-request-url) и [параметров](#api-v2-preauth-request-parameters-url). Для аутентификации используйте [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|---------------------------------------------------------------------------|------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/preauth/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/preauth/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/preauth/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/preauth/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
| Название параметра | Описание | Значение |
|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| order_desc | Описание заказа. | `Необходимость`: Обязательно `Тип`: String `Длина`: 1525 |
| amount | Сумма к оплате. Сумма должна быть указана в наибольших единицах с разделителем .. Например, 10.5 для USD означает 10 долларов США и 50 центов. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция (см. [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| address1 | Адрес Плательщика, строка 1. (Обратите внимание, что в некоторых случаях невозможно отправить адрес длиной более 50 символов. Для получения более подробной информации обратитесь к вашему менеджеру.) | `Необходимость`: Обязательно `Тип`: String `Длина`: 256 |
| city | Город Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| zip_code | Почтовый индекс Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 10 |
| country | Страна Плательщика. Для списка действительных кодов см. [Коды стран](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). | `Необходимость`: Обязательно `Тип`: String `Длина`: 2 |
| phone | Полный международный номер телефона Плательщика, включая код страны. | `Необходимость`: Обязательно `Тип`: String `Длина`: 15 |
| email | Адрес электронной почты Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| ipaddress | IP-адрес Плательщика, передаётся для целей мониторинга мошенничества. | `Необходимость`: Обязательно `Тип`: String `Длина`: 45 |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1.
### /api/v2/return
#### Введение
Транзакции Return можно инициировать только после получения транзакцией окончательного успешного статуса. См. [Статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md). Для Preauth создаётся транзакция Cancel, для Capture и Sale — Reversal. Транзакции Return инициируются запросом HTTPS POST с использованием указанных ниже [URL-адресов](#api-v2-return-request-url) и [параметров](#api-v2-return-request-parameters-url). Для аутентификации используйте [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|--------------------------------------------------------------------------|-----------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/return/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/return/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/return/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/return/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
> **Warning:** В значениях параметров необходимо экранировать следующие символы: & + “.
| Название параметра | Описание | Значение |
|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| login | Логин Присоединяющейся Стороны в Платёжном Шлюзе. | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| orderid | Уникальный идентификационный номер транзакции, присвоенный системой Payneteasy. | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| client_orderid | Уникальный идентификационный номер Присоединяющейся Стороны. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса:login. 2. Параметр запроса:client_orderid. 3. Параметр запроса:orderid. 4. Параметр запроса: amount (в минимальных единицах). 5. Параметр запроса: currency. 6. merchant_control (Контрольный ключ, назначенный для учетной записи Присоединяющейся Cтороны в Payneteasy). | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| amount | Сумма должна быть указана в минимальных единицах с . разделителем. Например, 100.5 в RUB означает 100 российских рублей и 50 копеек. Если данный параметр пропущен, будет произведен возврат всей суммы. Данный параметр имеет смысл для возвратов, но не отмены. Сумма не может быть больше изначальной суммы транзакции. Важно! Если указана сумма, необходимо также указать валюту! | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция (см. [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| comment | Краткое описание. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Название параметра | Описание |
|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может принимать такие значения как: async-response, validation-error, error и т.д. Если тип ответа validation-error или error, параметры error-message и error-code будут содержать детали ошибки. |
| paynet-order-id | Идентификатор заказа, присвоенный Payneteasy. |
| merchant-order-id | Идентификатор заказа Присоединяющейся Стороны. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| end-point-id | Идентификатор терминала, используемый для транзакции. |
| error-message | Для транзакций в статусе error этот параметр будет содержать причину отклонения или сведения об ошибке. |
| error-code | Код ошибки для транзакций в статусе error. |
#### Пример запроса
```http
POST /paynet/api/v2/return/39914 HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.83.0
Accept: */*
Content-Length: 162
Content-Type: application/x-www-form-urlencoded
Connection: close
login=TestMerchant
&client_orderid=Test
&orderid=6862958
&amount=5.00
¤cy=RUB
&comment=Service not provided
&control=2dfdb99c4eff5b31c978ecb8bc4b4d094e24c1d4
```
#### Пример успешного ответа
```http
HTTP/1.1 200 OK
Server: server
Date: Mon, 08 Aug 2022 07:50:08 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 141
type=async-response
&serial-number=00000000-0000-0000-0000-000002ddad4a
&merchant-order-id=Test
&paynet-order-id=6862958
&end-point-id=39914
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200 OK
Server: server
Date: Mon, 08 Aug 2022 10:45:32 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 153
type=validation-error
&serial-number=00000000-0000-0000-0000-000002ddad5c
&error-message=Reversal+currency+does+not+match+project+currency
&error-code=16
```
#### Open API Collection
Open this method in the OpenAPI Reference
View in OpenAPI
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/sale-form
#### Введение
Оплата по форме инициируется через запрос методом HTTPS POST на указанный ниже [URL](#api-v2-sale-form-url) с использованием указанных [параметров](#api-v2-sale-form-request-parameters). Для аутентификации запроса используется [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [Статусы транзакций](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|-----------------------------------------------------------------------------|--------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/sale-form/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/sale-form/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/sale-form/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/sale-form/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
Банк может переопределить необходимость некоторых полей, сделав их обязательными.
Пробелы в начале и в конце значений параметров будут отсечены.
> **Warning:** В значениях параметров необходимо экранировать следующие символы: & + “.
| Название параметра | Описание | Значение |
|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| order_desc | Описание заказа. | `Необходимость`: Обязательно `Тип`: String `Длина`: 64k |
| first_name | Имя Плательщика. Необходимость параметра зависит от канала эквайринга и необходимость параметра, необходимо уточнять у техподдержки. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| last_name | Фамилия Плательщика. Необходимость параметра зависит от канала эквайринга и необходимость параметра, необходимо уточнять у техподдержки. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| ssn | Последние четыре цифры номера социального страхования Плательщика. | `Необходимость`: Опционально `Тип`: Numeric `Длина`: 32 |
| birthday | Дата рождения Плательщика в формате YYYYMMDD. | `Необходимость`: Опционально `Тип`: Numeric `Длина`: 8 |
| address1 | Адрес Плательщика, строка 1. (Обратите внимание, что в некоторых случаях невозможно отправить адрес длиной более 50 символов. Для получения более подробной информации обратитесь к вашему менеджеру.) | `Необходимость`: Обязательно `Тип`: String `Длина`: 256 |
| city | Город Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| state | Штат Плательщика. Для списка действительных кодов штатов см. [Обязательные коды штатов](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). Требуется для США, Канады и Австралии. | `Необходимость`: Условно `Тип`: String `Длина`: 2-3 |
| zip_code | Почтовый индекс Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 10 |
| country | Страна Плательщика. Для списка действительных кодов см. [Коды стран](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). | `Необходимость`: Обязательно `Тип`: String `Длина`: 2 |
| phone | Полный международный номер телефона Плательщика, включая код страны. | `Необходимость`: Обязательно `Тип`: String `Длина`: 15 |
| cell_phone | Полный международный мобильный номер телефона Плательщика, включая код страны. | `Необходимость`: Опционально `Тип`: String `Длина`: 15 |
| email | Адрес электронной почты Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| purpose | Назначение платежа. Параметр может использоваться для указания пополняемого счёта (счета мобильных телефонов, игровые учётные записи и т. д.). Примеры значений:+9999999999; mail@example.com и т. д. Это значение может проверяться системой защиты от мошенничества. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| amount | Сумма к оплате. Сумма должна быть указана в наибольших единицах с разделителем .. Например, 10.5 для USD означает 10 долларов США и 50 центов. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция (см. [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| ipaddress | IP-адрес Плательщика, передаётся для целей мониторинга мошенничества. | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| site_url | URL-адрес сайта электронной коммерции, откуда происходит платеж. | `Необходимость`: Опционально `Тип`: String `Длина`: 128 |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1.
### /api/v2/sale
#### Введение
Оплата инициируется через запрос HTTPS POST на указанный ниже [URL](#api-v2-sale-request-url) с использованием указанных [параметров](#api-v2-sale-request-parameters). Для аутентификации запроса используется [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [Статусы транзакций](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|------------------------------------------------------------------------|---------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/sale/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/sale/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/sale/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/sale/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
Банк может переопределить необходимость некоторых полей, сделав их обязательными.
Пробелы в начале и в конце значений параметров будут отсечены.
> **Warning:** В значениях параметров необходимо экранировать следующие символы: & + “.
| Название параметра | Описание | Значение |
|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. | `Необходимость`: Обязательно `Тип`: String `Длина`: 128 |
| order_desc | Описание заказа. | `Необходимость`: Обязательно `Тип`: String `Длина`: 64k |
| amount | Сумма к оплате. Сумма должна быть указана в наибольших единицах с разделителем .. Например, 10.5 для USD означает 10 долларов США и 50 центов. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| currency | Валюта, в которой проводится операция (см. [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Обязательно `Тип`: String `Длина`: 3 |
| address1 | Адрес Плательщика, строка 1. (Обратите внимание, что в некоторых случаях невозможно отправить адрес длиной более 50 символов. Для получения более подробной информации обратитесь к вашему менеджеру.) | `Необходимость`: Обязательно `Тип`: String `Длина`: 256 |
| city | Город Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| zip_code | Почтовый индекс Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 10 |
| country | Страна Плательщика. Для списка действительных кодов см. [Коды стран](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). | `Необходимость`: Обязательно `Тип`: String `Длина`: 2 |
| phone | Полный международный номер телефона Плательщика, включая код страны. | `Необходимость`: Обязательно `Тип`: String `Длина`: 15 |
| email | Адрес электронной почты Плательщика. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
| ipaddress | IP-адрес Плательщика, передаётся для целей мониторинга мошенничества. | `Необходимость`: Обязательно `Тип`: String `Длина`: 45 |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1.
### /api/v2/status
#### Введение
Получение статуса транзакции осуществляется через запрос методом HTTPS POST на указанный ниже [URL](#status-request-url) с использованием указанных [параметров](#status-request-parameters). Для аутентификации запроса используется [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). См. [Статусы транзакций](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|--------------------------------------------------------------------------|-----------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/status/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/status/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/status/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/status/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
| Название параметра | Описание | Необходимость |
|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|
| login | Логин Присоединяющейся Стороны в Платёжном Шлюзе. | Обязательно |
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. | Обязательно |
| orderid | Идентификатор заказа, присвоенный Payneteasy. | С условием |
| by-request-sn | Серийный номер, присвоенный Payneteasy конкретному API-запросу. Если параметр присутствует в запросе статуса, ответ на запрос будет возвращён только для той стадии транзакции, на которой она находилась в момент совершения запроса с таким серийным номером. Параметр может быть включён в запрос для получения такой стадии в специальных случаях. Для получения наиболее актуального статуса транзакции, не следует включать этот параметр в запрос. | Опционально |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса:login. 2. Параметр запроса:client_orderid. 3. Параметр запроса:orderid. 4. merchant_control (Контрольный ключ, назначенный для аккаунта Присоединяющейся стороны в системе Payneteasy). | Обязательно |
В большинстве случаев наилучшим вариантом является включение обоих параметров client_orderid и orderid в запрос статуса. Статус заказа можно запросить только с client_orderid, если он уникален для Торговца и orderid не получен. Если orderid не получен в ответе, но ответ содержитошибку, см. полученное сообщение об ошибке, чтобы получить информацию о том, почему транзакция не была создана в системе.
#### Параметры ответа
API команда запроса статуса участвует во множестве сценариев использования API, поэтому некоторые из указанных параметров могут не встречаться в определенных сценариях. Ниже предоставлен полный список возможных параметров ответа.
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
\* - эти параметры не возвращаются в ответе по умолчанию. Для их получения необходимо связаться со службой поддержки.
| Параметры ответа на запрос статуса | Описание |
|-------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может быть status-response. |
| status | Подробности см. в [Список статусов](https://doc.payneteasy.ru/integration/reference/statuses.html.md). |
| amount | Фактическая сумма транзакции. Данное значение может быть изменено в ходе транзакции. |
| currency | Валюта, в которой взимается транзакция (трехбуквенный код валюты). Примеры допустимых значений параметров: USD для доллара США EUR для евро. |
| paynet-order-id | Идентификатор заказа, присвоенный заказу gate.payneteasy.ru. |
| merchant-order-id | Идентификатор заказа Присоединяющейся Стороны. |
| phone | Полный международный номер телефона Плательщика, включая код страны. |
| html | HTML-код формы авторизации 3DS, закодированный в формате MIME application/x-www-form-urlencoded. Торговец должен декодировать этот параметр перед показом формы Плательщику. Система gate.payneteasy.ru возвращает следующие параметры ответа, когда получает форму авторизации 3DS от Банка-эмитента. Он содержит HTML-код формы авторизации, который должен быть передан без каких-либо изменений в браузер клиента. Этот параметр существует и имеет значение только тогда, когда HTML перенаправления уже доступен. Для не-3DS этого никогда не происходит. Для 3DS HTML имеет значение через некоторое короткое время после начала обработки. |
| redirect-to | Для авторизации 3DS Торговец может перенаправить плательщика на URL, указанный в данном параметре, вместо отображения страницы, указанной в параметре html. Параметр redirect-to возвращается только в том случае, если возвращается параметр html. Для перенаправления Торговец должен использовать метод HTTP GET. Данный параметр должен использоваться для работы с 3DS 2.0. |
| serial-number | Уникальный номер, присваиваемый сервером gate.payneteasy.ru конкретному запросу от присоединяющейся стороны. |
| last-four-digits | Последние четыре цифры номера банковской карты Плательщика. |
| dest-last-four-digits | Последние четыре цифры номера кредитной карты клиента. Относится только к транзакциям перевода. |
| bin | BIN банка или номер банковской карты плательщика. |
| card-type | Тип банковской карты Плательщика (VISA, MASTERCARD и т.д.). |
| gate-partial-reversal | Возможность проведения частичного возврата (enabled - возможно, disabled - невозможно). |
| gate-partial-capture | Возможность проведения частичного списания захолдированной суммы (enabled - возможно, disabled - невозможно). |
| transaction-type | Тип тпанзакции (продажа, возврат, списание, преавторизация). |
| processor-rrn | Регистрационный номер банка-получателя. |
| processor-tx-id | Идентификатор транзакции, присвоенный Эквайером. |
| receipt-id | Электронная ссылка на квитанцию: https://gate.payneteasy.ru/paynet/view-receipt/ENDPOINTID/receipt-id/. |
| name | Имя плательщика |
| card-ref-id | Ссылочный идентификатор, используемый в последующих повторяющихся платежах. Имеет значение только в том случае, если card-ref-id был создан для первоначальной транзакции. |
| cardholder-name | Имя владельца карты. |
| card-exp-month | Месяц окончания срока действия банковской карты. |
| card-exp-year | Год окончания срока действия банковской карты. |
| card-hash-id | Уникальный идентификатор карты для использования в программах лояльности или проверках на мошенничество. |
| card-country-alpha-three-code | Трехбуквенный код страны эмитента карты отправителя. Подробности см. в [Коды стран и штатов](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). |
| destination-card-country-alpha-three-code | Трехбуквенный код страны эмитента карты получателя. Подробности см. в [Коды стран и штатов](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). |
| dest-bin | Банковский BIN кредитной карты клиента. |
| dest-card-type | Тип кредитной карты клиента (VISA, MASTERCARD и т.д.). |
| dest-bank-name | Наименование банка по BIN карты клиента. |
| destination-hash-id | Уникальный идентификатор карты для использования в программах лояльности или проверках на мошенничество. Актуально только для транзакций переводов. |
| destination-card-hash-id | Уникальный идентификатор карты для использования в программах лояльности или проверках на мошенничество. |
| first-name | Имя плательщика. |
| last-name | Фамилия Плательщика. |
| email | Электронная почта плательщика. |
| Параметр country \* | Страна плательщика (двухбуквенный код страны). Список допустимых кодов стран см. в [Коды стран и штатов](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). |
| Параметр state \* | Штат плательщика. Список допустимых кодов штатов см. в [Коды стран и штатов](https://doc.payneteasy.ru/integration/reference/country_codes.html.md). Обязательно для США, Канады и Австралии. |
| Параметр city \* | Город Плательщика. |
| Параметр zip_code \* | Почтовый индекс Плательщика. |
| Параметр address1 \* | Адрес Плательщика, строка 1. |
| purpose | Место назначения платежа. Это полезно для продавцов, которые позволяют своим плательщикам пополнять свои счета с помощью банковских карт (счета мобильных телефонов, игровые счета и т. д.). Примеры значений: +9999999999; mail@example.com и т. д. Данное значение может использоваться системой мониторинга мошенничества. |
| bank-name | Наименование банка по BIN карты плательщика. |
| terminal-id | Идентификатор терминала эквайера, который будет указан в чеке. |
| paynet-processing-date | Дата обработки транзакции эквайером. |
| approval-code | Код одобрения банка. |
| order-stage | Текущая стадия обработки транзакции. Подробности см. в [Стадии транзакции](https://doc.payneteasy.ru/integration/reference/order_stage.html.md). |
| total-reversal-amount | Сумма последнего обработанного возврата. Актуально только для транзакций возврата. |
| reversal-amount | Сумма последнего обработанного возврата. Актуально только для транзакций возврата. |
| auth-response-code | Код ответа, используемый в протоколе Iso8583. Возвращается только в определенных случаях. |
| acquirer-processing-date | Дата обработки транзакции эквайером. |
| processor-auth-credit-code | Код одобрения кредита. Возвращается только в определенных случаях. |
| processor-credit-rrn | Номер ссылки извлечения для кредитной транзакции. |
| processor-credit-arn | Ссылочный номер карты-эквайера для кредитной транзакции. |
| processor-debit-arn | Ссылочный номер карты-эквайера для дебитной транзакции. |
| loyalty-balance | Текущий баланс бонусов программы лояльности для текущей операции. если доступно. |
| loyalty-message | Сообщение от программы лояльности. если доступно. |
| loyalty-bonus | Бонусная стоимость программы лояльности для текущей операции если доступно. |
| loyalty-program | Название программы лояльности для текущей операции если доступно. |
| descriptor | Банковский идентификатор получателя платежа. |
| original-gate-descriptor | Дескриптор, который устанавливается на уровне шлюза в системе. |
| error-message | Если статус declined, error или filtered, этот параметр содержит причину отклонения. |
| error-code | Код ошибки для транзакций в статусе declined, error, filtered. |
| by-request-sn | Серийный номер, назначенный конкретному запросу gate.payneteasy.ru. Если это поле существует в запросе статуса, ответ статуса возвращается для этого конкретного запроса. |
| verified-3d-status | Подробную информацию см. [Список статусов 3D Secure](https://doc.payneteasy.ru/integration/reference/statuses.html.md). |
| verified-rsc-status | Возвращается, если была выполнена проверка случайной суммы. См. [Альтернативная аутентификация держателя карты](https://doc.payneteasy.ru/integration/reference/3ds_overview.html.md) |
| eci | Индикатор электронной коммерции (Visa). |
| ips-src-payment-product-code | Код карты, установленный международной финансовой службой (Visa/Mastercard). |
| ips-src-payment-product-name | Расшифрованный код для карты, установленный международной финансовой службой (Visa/Mastercard). |
| ips-src-payment-type-code | Код типа карты, установленный международной финансовой службой (Visa/Mastercard). |
| ips-src-payment-type-name | Расшифрованный код типа карты, установленный международной финансовой службой (Visa/Mastercard). |
| merchantdata | Если параметр merchant_data и его значение указаны в первоначальном запросе, они будут включены в ответ о статусе. |
| initial-amount | Сумма, установленная при инициировании транзакции, без каких-либо сборов или комиссий. Это значение не может измениться в ходе транзакции. |
| seller-commission | Общая комиссия за обработанную транзакцию. Это необязательный параметр. Пожалуйста, свяжитесь с вашим менеджером в Payneteasy, если вы хотите его получить. |
| acquirer-commission | Комиссия эквайера за обработанную транзакцию. Это необязательный параметр. Обратитесь к своему менеджеру в Payneteasy, если хотите его получить. |
| motivational-message | Опциональный параметр, содержаний сообщение с расширенной информацией по причине отклонения транзакции. |
| transaction-date | Дата присвоения окончательного статуса транзакции. |
| orig-amount | Содержит исходную сумму запроса, если она была преобразована на вспомогательном терминале в интеграции с параллельной формой. Актуально только для транзакций Payment Cashier. |
| orig-currency | Содержит исходную валюту запроса, если она была преобразована на вспомогательном терминале в интеграции с параллельной формой. Актуально только для транзакций Payment Cashier. |
#### Параметры ответа на запрос статуса Pa Req Form
| Название | Описание |
|------------------------|-------------------------------------------------------------------------------------|
| tds-pareq-form-pareq | Данные ACS 3DS Pa Req, полученные Присоединяющейся Стороной. |
| tds-pareq-form-acs-url | ACS URL для перенаправления Плательщика в рамках сценария аутентификации 3DS 1.0.2. |
#### Параметры ответа на запрос статуса CReq Form
| Название | Описание |
|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| tds-creq-form-creq | Сообщение CReq инициирует взаимодействие держателя карты в полной проверке 3DS (Challenge) и используется для передачи аутентификационных данных. Формируется сервером 3DS торговцем через браузер держателя карты в адрес ACS URL. |
| tds-creq-form-acs-url | ACS URL для перенаправления Плательщика для полной проверки 3DS (Challenge). |
#### Параметры ответа на запрос статуса Method Url Frame
| Название | Описание |
|------------------------------------------|---------------------------------------------------------------------------------------------------------------------|
| tds-method-url-frame-3ds-server-trans-id | Универсальный уникальный идентификатор транзакции, присвоенный 3DS-сервером для идентификации отдельной транзакции. |
| tds-method-url-frame-3ds-method-url | URL 3DS Метода используется в форме iframe, передающейся от торговца к Плательщику. |
Правила создания HTML формы.
Данные метода 3DS: threeDSMethod Data (threeDSMethod NotificationURL + threeDSServer TransID).
#### Пример запроса
```http
POST /paynet/api/v2/status/37211 HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.77.0
Accept: */*
Content-Length: 99
Content-Type: application/x-www-form-urlencoded
Connection: close
login=TestYujik
&client_orderid=123
&orderid=6863082
&control=647f0581bbceb804a73e98d9ea7e78640a75bf1c
```
#### Пример успешного ответа
```http
HTTP/1.1 200 OK
Server: server
Date: Mon, 12 Sep 2022 09:02:42 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
X-Cached: EXPIRED
Content-Length: 1275
type=status-response
&serial-number=00000000-0000-0000-0000-000002ddb056
&merchant-order-id=123
&processor-tx-id=PNTEST-6863082
&paynet-order-id=6863082
&status=approved
&amount=555.00
¤cy=USD
&descriptor=XXXX
&original-gate-descriptor=XXXX
&gate-partial-reversal=enabled
&gate-partial-capture=enabled
&transaction-type=sale
&receipt-id=081c0c0b-0dd1-3083-b251-e624ac8e57b4
&name=CARD+HOLDER
&cardholder-name=CARD+HOLDER
&card-exp-month=12
&card-exp-year=2099
&email=john.smith%40gmail.com
&last-name=Smith
&first-name=John
&processor-rrn=0225083062885
&approval-code=979249
&order-stage=sale_approved
&merchantdata=VIP+customer
&last-four-digits=2063
&bin=410002
&card-type=VISA
&phone=12063582043
&bank-name=BANCO+ITAUCARD+S.A.
&auth-response-code=00
&terminal-id=12345678
&paynet-processing-date=2022-09-07+13%3A22%3A39+MSK
&acquirer-processing-date=2022-09-07+13%3A22%3A39+MSK
&processor-auth-credit-code=206551
&card-hash-id=2639503
&card-country-alpha-three-code=BRA
&verified-3d-status=NOT_AUTHENTICATED
&processor-credit-rrn=0225060914211
&processor-credit-arn=809124106
&processor-debit-arn=601904020
&purpose=user_account1
&ips-src-payment-product-code=F
&ips-src-payment-product-name=Visa+Classic
&ips-src-payment-type-code=Credit
&ips-src-payment-type-name=VISA+Credit
&initial-amount=555.00
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200 OK
Server: server
Date: Mon, 12 Sep 2022 09:08:02 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
X-Cached: MISS
Content-Length: 137
type=validation-error
&serial-number=00000000-0000-0000-0000-000002ddb057
&error-message=End+point+with+id+372118+not+found
&error-code=3
```
#### Open API Collection
Open this method in the OpenAPI Reference
View in OpenAPI
#### Коллекция Postman
#### Конструктор запросов
### /api/v2/void
#### Введение
Void может быть обработан только для транзакций Sale и Capture с финальным успешным статусом (см. [Статусы](https://doc.payneteasy.ru/integration/reference/statuses.html.md)). Чтобы выполнить запрос Void, отправьте запрос HTTPS POST на указанные [URL](#api-v2-void-request-url) и [параметры](#api-v2-void-request-parameters-url). Для аутентификации используйте [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|------------------------------------------------------------------------|--------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/void/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v2/void/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v2/void/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v2/void/void/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь заголовок content-type=application/x-www-form-urlencoded.
> **Warning:** В значениях параметров необходимо экранировать следующие символы: & + “.
| Название параметра | Описание | Значение |
|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| login | Логин Присоединяющейся Стороны в Платёжном Шлюзе. | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| orderid | Уникальный идентификационный номер транзакции, присвоенный системой Payneteasy. | `Необходимость`: Обязательно `Тип`: String `Длина`: 20 |
| client_orderid | Уникальный идентификационный номер Присоединяющейся Стороны. | `Необходимость`: Обязательно `Тип`: Numeric `Длина`: 10 |
| amount | Этот необязательный параметр указывает сумму для Reversal. | `Необходимость`: Обязательно `Тип`: String `Длина`: 10 |
| currency | Валюта, в которой проводится операция (см. [Коды валют](https://doc.payneteasy.ru/integration/reference/currency_codes.html.md)). Примеры значений: USD для доллара США, EUR для европейского евро, RUB для российского рубля. | `Необходимость`: Условно `Тип`: String `Длина`: 3 |
| control | Контрольная сумма, сгенерированная [SHA-1](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/sha.html.md). Строка для подписи представляет собой объединение следующих параметров: 1. Параметр запроса: login 2. Параметр запроса: client_orderid 3. Параметр запроса: orderid 4. merchant_control (Контрольный ключ, назначенный для аккаунта Присоединяющейся стороны в системе Payneteasy). | `Необходимость`: Условно `Тип`: String `Длина`: 128 |
| comment | Краткое описание. | `Необходимость`: Обязательно `Тип`: String `Длина`: 50 |
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Название параметра | Описание |
|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может принимать такие значения как: async-response, validation-error, error и т.д. Если тип ответа validation-error или error, параметры error-message и error-code будут содержать детали ошибки. |
| paynet-order-id | Идентификатор заказа, присвоенный Payneteasy. |
| merchant-order-id | Идентификатор заказа Присоединяющейся Стороны. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| end-point-id | Идентификатор терминала, используемый для транзакции. |
| error-message | Для транзакций в статусе error этот параметр будет содержать причину отклонения или сведения об ошибке. |
| error-code | Код ошибки для транзакций в статусе error. |
#### Пример запроса
```http
POST /paynet/api/v2/void/39914 HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.83.0
Accept: */*
Content-Length: 123
Content-Type: application/x-www-form-urlencoded
Connection: close
login=Test
&client_orderid=55
&orderid=6862995
&comment=Service not provided
&control=246e0a2074f9e4b84cff59b2567ed48ec3aab87d
```
#### Пример успешного ответа
```http
HTTP/1.1 200 OK
Server: server
Date: Tue, 16 Aug 2022 06:57:40 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 138
type=async-response
&serial-number=00000000-0000-0000-0000-000002ddae76
&merchant-order-id=55
&paynet-order-id=6862995
&end-point-id=39914
```
#### Пример неуспешного ответа
```http
HTTP/1.1 200 OK
Server: server
Date: Tue, 16 Aug 2022 07:21:37 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 148
type=validation-error
&serial-number=00000000-0000-0000-0000-000002ddae78
&merchant-order-id=Test
&error-message=INVALID_CONTROL_CODE
&error-code=2
```
#### Open API Collection
Open this method in the OpenAPI Reference
View in OpenAPI
#### Коллекция Postman
#### Конструктор запросов
### /api/v4/create-card-ref
#### Введение
Создание Card reference ID и Recurring Payment ID инициируется через HTTPS POST запрос с использованием [URL](#api-v4-card-ref-id-request-url) и [параметров](#v4-card-ref-id-request-parameters), указанных ниже. Для аутентификации используйте [OAuth RSA-SHA256](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md).
#### API URL
> **Note:** Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.
| Интеграционная среда | Производственная среда |
|-----------------------------------------------------------------------------------|--------------------------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v4/create-card-ref/ENDPOINTID | https://gate.payneteasy.ru/paynet/api/v4/create-card-ref/ENDPOINTID |
| https://sandbox.payneteasy.ru/paynet/api/v4/create-card-ref/group/ENDPOINTGROUPID | https://gate.payneteasy.ru/paynet/api/v4/create-card-ref/group/ENDPOINTGROUPID |
#### Параметры запроса
> **Note:** Запрос должен иметь content-type=application/x-www-form-urlencoded и [Заголовки авторизации](https://doc.payneteasy.ru/integration/general_api_usage/request_authentication_methods/oauth.html.md).
| Параметры запроса Sale | Описание |
|--------------------------|-----------------------------------------------------------------------------------|
| login | Логин Присоединяющейся стороны в Системе. |
| client_orderid | Уникальный идентификатор заказа, присвоенный Присоединяющейся Стороной. |
| orderid | Идентификатор заказа транзакции, присвоенный Платёжным Шлюзом. |
Присоединяющаяся Сторона должна предоставить orderid и client_orderid, связанные с первой платёжной транзакцией. Это подчёркивает, что первый платёж является обязательным шагом для обработки рекуррентных платежей. Для авторизации кредитной карты информация о ней должна быть достаточной, а первоначальный платёж должен находиться в [финальном статусе](https://doc.payneteasy.ru/integration/reference/statuses.html.md).
#### Параметры ответа
> **Note:** Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.
| Параметр ответа на регистрацию | Описание |
|----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| type | Тип ответа. Может быть create-card-ref-response, validation-error, error. Если type равен validation-error или error, параметры error-message и error-code содержат детали ошибки. |
| serial-number | Уникальный номер, присваиваемый сервером Payneteasy конкретному запросу от Присоединяющейся стороны. |
| card-ref-id | Card reference ID, используемый в последующих рекуррентных платежах. |
| unq-card-ref-id | Уникальный идентификатор ссылки на карту для каждого PAN. Может использоваться Присоединяющейся стороной для программ лояльности или контроля мошенничества. |
| recurring-payment-id | ID токенизированных данных держателя карты Плательщика, называемый Recurring Payment ID (RPI). |
| dst-card-ref-id | Card reference ID Получателя, используемый в последующих рекуррентных платежах. Может использоваться только в transfer API. |
| dst-unq-card-ref-id | Уникальный card reference ID Получателя для каждого PAN. Может использоваться Присоединяющейся Стороной для программ лояльности или контроля фрода. Может использоваться только в transfer API. |
| dst-recurring-payment-id | ID токенизированных данных держателя карты Получателя, называемый Recurring Payment ID (RPI). Может использоваться только в transfer API. |
| error-message | Для транзакций в статусе declined или error этот параметр будет содержать причину отклонения или сведения об ошибке. |
| error-code | Код ошибки для транзакций в статусе declined или error. |
| status | Подробности см. в [Список статусов](https://doc.payneteasy.ru/integration/reference/statuses.html.md). |
#### Пример запроса
```http
POST /paynet/api/v4/create-card-ref/39915 HTTP/1.1
Host: sandbox.payneteasy.ru
User-Agent: curl/7.83.0
Accept: */*
Authorization: OAuth oauth_consumer_key="TestMerchant", oauth_nonce="KT6cZmuVGqg0V6Jm2RE3q4o79KXC1v2q", oauth_signature="KucF0eYk3WZCV7oKwOi1z6PR%2BkHxiZwPucD6Sx%2BX2mV%2BbaidPy9K9USh8ciMKM60NNl1LYYjywdaErB1uTIdFFbQ8ZKs8M1smaMPOaHDaApceTOlDh6E7u3BzBTKYhBc%2BWnksZz9Wyz8%2B39lHCIODo0KZmNmXCTjjZmlx%2FrFNkK%2FhwJV9Kwq1nPbA5QZTkF686O0O0lHFy3Prx649AIRgsrqDLb5%2FgHL9M8fSScVUPnGdLGJ2hSgKJFpIOFibT0nC89Xg8odn1hR9WIa1650glaqZntSkocBzXAkOKa7kIbSOZW1sFCiBjksy6o1sny9hmc%2F9cC9t86RoEY1QhVYuvOLztQm1dLhpRy%2FPOL9LCmIzO3B%2FUB2wJUXPkEyFsSLZVeqQl%2B0IukljV6Cr1ZfuyUktbvvXJsnod5AK%2FsV2GaxEf%2BttqqWv%2FFNjPLoUZYrPB6rKsIpw%2FOftinIwIxYzLY3FMmbKQd6zxnMJLJm7M2s6cQFGiAnfgvZFAMZhugBuuigy4T9Ckq1t5N9vQkl2htDv0TTnswx50wpF%2F7OKiXTVFNqOE%2FCj%2F07ZwZbxbD%2FMxKhOhfNMME1jGxzgI0wEj1166eKpxnCOk%2BTlYTJvNW5%2BbKuGnU43Q2Nmga0aQ007NKRfIV%2FWk6e%2BUuGO48wGdi0CiKxS9hpnpvjyPLc%2BsA%3D", oauth_signature_method="RSA-SHA256", oauth_timestamp="1673335450", oauth_version="1.0"
Content-Length: 40
Content-Type: application/x-www-form-urlencoded
Connection: close
client_orderid=34T43R77N
&orderid=6868305
```
#### Пример успешного ответа
```http
HTTP/1.1 200
Server: server
Date: Tue, 10 Jan 2023 07:24:36 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 174
type=create-card-ref-response
&serial-number=00000000-0000-0000-0000-000002de3113
&card-ref-id=1461608
&recurring-payment-id=1491863
&dst-card-ref-id=1461608
&status=approved
```
#### Пример неуспешного ответа
```http
HTTP/1.1 403
Server: server
Date: Tue, 10 Jan 2023 07:34:08 GMT
Content-Type: text/html
Content-Length: 735
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Access is denied
``` #### Open API Collection Open this method in the OpenAPI Reference View in OpenAPI #### Коллекция Postman #### Конструктор запросов Вставьте приватный ключ PKCS#1 PEM для среды sandbox в поле ниже. Конструктор запросов поддерживает длину ключа до 4096.Use either destination-card-no or destination-card-ref-id
\* HEX encoded string is for debug purposes only. You shouldn't send this string to the server neither in HEX nor in Encoded HEX representation. \* Binary RSA-SHA256 signature directly encoded in base64 should be sent to the server.Access is denied
``` #### Open API Collection Open this method in the OpenAPI Reference View in OpenAPI #### Коллекция Postman #### Конструктор запросов Вставьте приватный ключ PKCS#1 PEM для среды sandbox в поле ниже. Конструктор запросов поддерживает длину ключа до 4096.Access is denied
``` #### Open API Collection Open this method in the OpenAPI Reference View in OpenAPI #### Коллекция Postman #### Конструктор запросов Вставьте приватный ключ PKCS#1 PEM для среды sandbox в поле ниже. Конструктор запросов поддерживает длину ключа до 4096.Access is denied
``` #### Коллекция Postman #### Конструктор запросов Вставьте приватный ключ PKCS#1 PEM для среды sandbox в поле ниже. Конструктор запросов поддерживает длину ключа до 4096.
### Асинхронные ответы
```plantuml
@startuml
participant cp as "Connecting Party"
participant paynet as "Payneteasy"
==Request Initiation==
cp -> paynet: API Request
activate cp
activate paynet
paynet --> cp: Order ID
deactivate cp
deactivate paynet
==Order Status Request==
cp -> paynet: api/v2/status
activate cp
activate paynet
paynet --> cp: Response\nstatus, order-stage
deactivate cp
deactivate paynet
==Receive Merchant Callback==
paynet -> cp: callback with final status
activate cp
activate paynet
cp --> paynet: HTTP 200
deactivate cp
deactivate paynet
@enduml
```
Если иное явно не указано в соответствующей команде API, все ответы Payneteasy являются асинхронными, независимо от отправленного запроса или callback.
### Банковский перевод со счётом
#### Введение
Этот сценарий использования описывает, как Присоединяющаяся сторона может выставлять счета для Swift или аналогичных систем банковских переводов в Платёжном Шлюзе и отображать их плательщикам. Статусы входящих банковских переводов могут обновляться автоматически или вручную.
Значение терминов см. в [Глоссарии](https://doc.payneteasy.ru/integration/reference/glossary.html.md).
#### Bank Wire Transfer Flow
```plantuml
skinparam roundcorner 20
skinparam sequenceArrowThickness 2
skinparam ParticipantPadding 30
actor Плательщик as Customer
participant "Веб-сайт \nПрисоединяющейся Стороны" as Merchant
participant "Платёжный Шлюз" as g
autonumber
Customer -> Merchant: Инициализация
activate Merchant
== Запрос на проведение оплаты ==
Merchant -> g: api/v2/auth-cash
activate g
g --> Merchant: orderId
g --> g: Генерация инвойса
== Получение обратного вызова \nПрисоединяющейся Стороны ==
Merchant <- g: Обратный вызов с финальным статусом
g <-- Merchant: HTTP 200
deactivate g
== Запрос статуса ==
Merchant -> g: api/v2/status
activate g
g --> Merchant: Ответ со статусом, order-stage, \nreceipt-id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
deactivate g
== Получение инвойса в форматах \nXML, PDF или обоих сразу ==
group XML
g <-- Merchant: view-invoice-xml/ENDPOINTID/receipt-id
activate g
g --> Merchant: XML
deactivate g
end
group PDF
g <-- Merchant: view-invoice/ENDPOINTID/receipt-id
activate g
g --> Merchant: PDF
deactivate g
end
Merchant -> Customer: Показ результата
deactivate Merchant
```
(2) Для реализации запроса банковского перевода см. [/api/v2/auth-cash/](https://doc.payneteasy.ru/integration/API_commands/api_v2_auth-cash.html.md).
(5,6) Для реализации запроса статуса заказа см. [/api/v2/status/](https://doc.payneteasy.ru/integration/API_commands/api_v2_status.html.md). Статус следует запрашивать несколько раз с интервалом 3–5 секунд, пока в ответе не будет получен окончательный статус. receipt-id будет получен в ответе статуса.
(7) Для реализации обратного вызова с обработкой окончательного статуса см. [Присоединяющаяся сторона](https://doc.payneteasy.ru/integration/API_commands/merchant_callback_parameters.html.md).
(9) Для реализации запроса view-invoice-xml см. [/view-invoice-xml/](https://doc.payneteasy.ru/integration/API_commands/view-invoice-xml.html.md). receipt-id будет использоваться для получения счёта в формате XML.
(11) Для реализации запроса просмотра счёта см. [/view-invoice/](https://doc.payneteasy.ru/integration/API_commands/view-invoice.html.md). receipt-id будет использоваться для получения счёта в формате PDF.
#### Simple Bank Transfer Flow Statuses
| Stage название | Описание |
|-------------------|----------------------------------------------------------------------------------------------------------------------------|
| AUTH_APPROVED | Счёт был выставлен Плательщику. |
| CANCEL_APPROVED | Плательщик не завершил перевод. Этот этап необязателен и может использоваться для лучшего контроля транзакции в бэк-офисе. |
| CAPTURE_APPROVED | Funds were transferred to the Присоединяющаяся сторона account (settled). |
| VOID_APPROVED | Средства были возвращены Плательщиком (отозваны). |
| REVERSAL_APPROVED | Funds were returned to the Payer by Присоединяющаяся сторона. |
#### Extended Bank Transfer Flow Statuses
| Stage название | Описание |
|---------------------|------------------------------------------------------------------------------------------------------------------------------------|
| AUTH_STARTING | Транзакция was initiated. |
| AUTH_INVOICED | Счёт был выставлен плательщику. Его можно скачать в бэк-офисе, отправить плательщику по электронной почте или запросить через API. |
| AUTH_SENT | Плательщик сообщил Присоединяющейся стороне, что счёт оплачен. Этот этап может быть пропущен. |
| CANCEL_APPROVED | Плательщик не завершил перевод. Этот этап необязателен и может использоваться для лучшего контроля транзакции в бэк-офисе. |
| AUTH_APPROVED | Перевод был получен банком. |
| CAPTURE_APPROVED | Funds were transferred to the Присоединяющаяся сторона account (settled). |
| VOID_APPROVED | Средства были возвращены Плательщиком (отозваны). |
| REVERSAL_APPROVED | Funds were returned to the Payer by Присоединяющаяся сторона. |
| CHARGEBACK_APPROVED | Средства были возвращены плательщиком. |
### Bitrix24
The Bitrix24 (1C-Bitrix) plugin is a payment module that adds Payneteasy as a payment system handler inside a Bitrix online store. It is distributed as a PHP module folder that is uploaded to the site via FTP and then activated through the Bitrix Marketplace, after which it can be selected as a payment handler for a store’s payment systems.
Documentation for this plugin is intentionally brief, since it mostly points to the plugin’s source repository and the (Russian- and English-language) installation notes published alongside it.
#### Source code
The plugin source is published on Git Hub: [php-plugin-bitrix](https://github.com/payneteasy/php-plugin-bitrix). The repository contains the plugin module itself, in a folder named `payneteasypayments.ecom`, together with a plain-text installation guide.
An accompanying documentation repository is also available: [bitrix-doc](https://github.com/annihilatoratm/bitrix-doc), which links to an [English-language installation guide](https://github.com/annihilatoratm/bitrix-doc/blob/main/documentation/doc-eng.md).
### Кнопка Купить сейчас
#### Введение
Интеграция Кнопка Купить сейчас актуальна для Присоединяющейся Стороны с ограниченным портфелем продаваемых продуктов. Это самый простой способ интеграции с Payneteasy. Такой способ интеграции не требует значительных технических усилий. Интеграция Кнопка Купить сейчас также позволяет Присоединяющейся Стороне снять с себя ответственность за хранение, обработку или передачу карточных данных Плательщика или иной конфиденциальной платёжной информации. Эти данные вводятся Плательщиком на размещённой Payneteasy форме данных клиента и платёжной форме в среде, сертифицированной по стандарту PCI DSS.
Значение терминов см. в [Глоссарии](https://doc.payneteasy.ru/integration/reference/glossary.html.md).
1. Плательщик нажимает на Кнопка Купить сейчас, перенаправляется на форму данных клиента, предоставленную Платёжным Шлюзом, и отправляет данные клиента;
`Форма Кнопка Купить сейчас`
1. Затем Плательщик перенаправляется на платёжную форму и отправляет платёжные данные (данные держателя карты).
`Платёжная Форма`
1. Контекстные данные собираются Payneteasy для обработки транзакции, Плательщик остаётся на форме ожидания до завершения транзакции;
`Форма Ожидания`
1. Браузер Плательщика перенаправляется на сайт Присоединяющейся Стороны на страницу с результатом.
#### Параметры, необходимые для интеграции Кнопка Купить сейчас
Присоединяющаяся Сторона предоставляет в поддержку Платёжного Шлюза следующую информацию для каждого продукта (товара): Сумма, Описание, URL финального перенаправления, Назначение (цель платежа) и Платёжный инструмент (метод оплаты).
Платёжный Шлюз предоставляет Присоединяющейся Стороне URL-адреса Кнопка Купить сейчас для каждого продукта (товара). URL-адреса имеют следующий формат:
| Интеграционная среда | Производственная среда |
|-------------------------------------------------------------------|----------------------------------------------------------------|
| https://sandbox.payneteasy.ru/paynet/api/v2/pay/ENDPOINTID/ITEMID | https://gate.payneteasy.ru/paynet/api/v2/pay/ENDPOINTID/ITEMID |
#### Сценарий формы Кнопка Купить сейчас
```plantuml
skinparam roundcorner 20
skinparam sequenceArrowThickness 2
skinparam ParticipantPadding 30
actor Плательщик as Customer
participant "Веб-сайт \nПрисоединяющейся Стороны" as Merchant
participant "Платёжный Шлюз" as g
autonumber
Customer -> Merchant: Инициализация
activate Customer
activate Merchant
Customer <-- Merchant: Показ кнопки Buy Now
deactivate Merchant
Customer -> g: Перенаправление на форму с кнопкой Buy Now
activate g
g --> Customer: Возврат формы с информацией Клиента
deactivate g
g <- Customer: Форма подтверждения информации Клиента
activate g
g --> Customer: Возврат платёжной формы
deactivate g
Customer -> g: Подтверждени плтёжной формы
deactivate Customer
activate g
g --> g: Обработка платежа
== Финальное перенаправление Клиента ==
g -> Customer: redirect_url веб-сайта \nПрисоединяющейся Стороны
activate Customer
Customer -> Merchant: POST redirect_url\nstatus, orderid
deactivate Customer
activate Merchant
group Получение финального статуса
== Получение обратного вызова \nПрисоединяющейся Стороны ==
Merchant <- g: Обратный вызов со статусом
g <-- Merchant: HTTP 200
deactivate g
== Запрос статуса ==
Merchant -> g: api/v2/status
activate g
g --> Merchant: Ответ \nstatus, order-stage
deactivate g
end
Merchant -> Customer: Показ результата
deactivate Merchant
```
(2) Разместите HTML-элемент Кнопка Купить сейчас на странице оформления заказа, доступной Плательщику.
(9) Для имплементации финального перенаправления Плательщика см. [Финальное Перенаправление](https://doc.payneteasy.ru/integration/API_commands/final_redirect.html.md).
(11,12) Для имплементации запроса статуса заказа см. [/api/v2/status/](https://doc.payneteasy.ru/integration/API_commands/api_v2_status.html.md). Присоединяющаяся Сторона может запросить статус заказа после получения transaction ID в обратном вызове Присоединяющейся Стороны или в финальном перенаправлении.
(13) Для имплементации обратного вызова с обработкой финального статуса см. [Обратный вызов Присоединяющейся Стороны](https://doc.payneteasy.ru/integration/API_commands/merchant_callback_parameters.html.md).
### Общие утилиты
### Коды стран и штатов
#### Коды стран
* Коды стран в формате Alpha-2 используются в параметре country.
* Коды в формате Alpha-3 содержатся в ответе на запрос статуса и обратном вызове в параметрах card-country-alpha-three-code и destination-card-country-alpha-three-code.
* Коды ISO используются в конфигурации Платёжного Шлюза.
| Страна | Код Alpha-2 | Код Alpha-3 | Код ISO |
|----------------------------------------------|---------------|---------------|-----------|
| Åland Islands | AX | ALA | 248 |
| Afghanistan | AF | AFG | 004 |
| Albania | AL | ALB | 008 |
| Algeria | DZ | DZA | 012 |
| American Samoa | AS | ASM | 016 |
| Andorra | AD | AND | 020 |
| Angola | AO | AGO | 024 |
| Anguilla | AI | AIA | 660 |
| Antarctica | AQ | ATA | 010 |
| Antigua and Barbuda | AG | ATG | 028 |
| Argentina | AR | ARG | 032 |
| Armenia | AM | ARM | 051 |
| Aruba | AW | ABW | 533 |
| Australia | AU | AUS | 036 |
| Austria | AT | AUT | 040 |
| Azerbaijan | AZ | AZE | 031 |
| Bahamas | BS | BHS | 044 |
| Bahrain | BH | BHR | 048 |
| Bangladesh | BD | BGD | 050 |
| Barbados | BB | BRB | 052 |
| Belarus | BY | BLR | 112 |
| Belgium | BE | BEL | 056 |
| Belize | BZ | BLZ | 084 |
| Benin | BJ | BEN | 204 |
| Bermuda | BM | BMU | 060 |
| Bhutan | BT | BTN | 064 |
| Bolivia, Plurinational State of | BO | BOL | 068 |
| Bosnia and Herzegovina | BA | BIH | 070 |
| Botswana | BW | BWA | 072 |
| Bouvet Island | BV | BVT | 074 |
| Brazil | BR | BRA | 076 |
| British Indian Ocean Territory | IO | IOT | 086 |
| Brunei Darussalam | BN | BRN | 096 |
| Bulgaria | BG | BGR | 100 |
| Burkina Faso | BF | BFA | 854 |
| Burundi | BI | BDI | 108 |
| Cambodia | KH | KHM | 116 |
| Cameroon | CM | CMR | 120 |
| Canada | CA | CAN | 124 |
| Cabo Verde | CV | CPV | 132 |
| Cayman Islands | KY | CYM | 136 |
| Central African Republic | CF | CAF | 140 |
| Chad | TD | TCD | 148 |
| Chile | CL | CHL | 152 |
| China | CN | CHN | 156 |
| Christmas Island | CX | CXR | 162 |
| Cocos (Keeling) Islands | CC | CCK | 166 |
| Colombia | CO | COL | 170 |
| Comoros | KM | COM | 174 |
| Congo | CG | COG | 178 |
| Congo, the Democratic Republic of the | CD | COD | 180 |
| Cook Islands | CK | COK | 184 |
| Costa Rica | CR | CRI | 188 |
| Cote d’Ivoire | CI | CIV | 384 |
| Croatia | HR | HRV | 191 |
| Cuba | CU | CUB | 192 |
| Cyprus | CY | CYP | 196 |
| Czechia | CZ | CZE | 203 |
| Denmark | DK | DNK | 208 |
| Djibouti | DJ | DJI | 262 |
| Dominica | DM | DMA | 212 |
| Dominican Republic | DO | DOM | 214 |
| Ecuador | EC | ECU | 218 |
| Egypt | EG | EGY | 818 |
| El Salvador | SV | SLV | 222 |
| Equatorial Guinea | GQ | GNQ | 226 |
| Eritrea | ER | ERI | 232 |
| Estonia | EE | EST | 233 |
| Ethiopia | ET | ETH | 231 |
| Falkland Islands (Malvinas) | FK | FLK | 238 |
| Faroe Islands | FO | FRO | 234 |
| Fiji | FJ | FJI | 242 |
| Finland | FI | FIN | 246 |
| France | FR | FRA | 250 |
| French Guiana | GF | GUF | 254 |
| French Polynesia | PF | PYF | 258 |
| French Southern Territories | TF | ATF | 260 |
| Gabon | GA | GAB | 266 |
| Gambia | GM | GMB | 270 |
| Georgia | GE | GEO | 268 |
| Germany | DE | DEU | 276 |
| Ghana | GH | GHA | 288 |
| Gibraltar | GI | GIB | 292 |
| Greece | GR | GRC | 300 |
| Greenland | GL | GRL | 304 |
| Grenada | GD | GRD | 308 |
| Guadeloupe | GP | GLP | 312 |
| Guam | GU | GUM | 316 |
| Guatemala | GT | GTM | 320 |
| Guernsey | GG | GGY | 831 |
| Guinea | GN | GIN | 324 |
| Guinea-Bissau | GW | GNB | 624 |
| Guyana | GY | GUY | 328 |
| Haiti | HT | HTI | 332 |
| Heard Island and Mc Donald Islands | HM | HMD | 334 |
| Holy See (Vatican City State) | VA | VAT | 336 |
| Honduras | HN | HND | 340 |
| Hong Kong | HK | HKG | 344 |
| Hungary | HU | HUN | 348 |
| Iceland | IS | ISL | 352 |
| India | IN | IND | 356 |
| Indonesia | ID | IDN | 360 |
| Iran, Islamic Republic of | IR | IRN | 364 |
| Iraq | IQ | IRQ | 368 |
| Ireland | IE | IRL | 372 |
| Isle of Man | IM | IMN | 833 |
| Israel | IL | ISR | 376 |
| Italy | IT | ITA | 380 |
| Jamaica | JM | JAM | 388 |
| Japan | JP | JPN | 392 |
| Jersey | JE | JEY | 832 |
| Jordan | JO | JOR | 400 |
| Kazakhstan | KZ | KAZ | 398 |
| Kenya | KE | KEN | 404 |
| Kosovo | XK | XKX | 983 |
| Kiribati | KI | KIR | 296 |
| Korea, Democratic People’s Republic of | KP | PRK | 408 |
| Korea, Republic of | KR | KOR | 410 |
| Kuwait | KW | KWT | 414 |
| Kyrgyzstan | KG | KGZ | 417 |
| Lao People’s Democratic Republic | LA | LAO | 418 |
| Latvia | LV | LVA | 428 |
| Lebanon | LB | LBN | 422 |
| Lesotho | LS | LSO | 426 |
| Liberia | LR | LBR | 430 |
| Libya | LY | LBY | 434 |
| Liechtenstein | LI | LIE | 438 |
| Lithuania | LT | LTU | 440 |
| Luxembourg | LU | LUX | 442 |
| Macao | MO | MAC | 446 |
| North Macedonia | MK | MKD | 807 |
| Madagascar | MG | MDG | 450 |
| Malawi | MW | MWI | 454 |
| Malaysia | MY | MYS | 458 |
| Maldives | MV | MDV | 462 |
| Mali | ML | MLI | 466 |
| Malta | MT | MLT | 470 |
| Marshall Islands | MH | MHL | 584 |
| Martinique | MQ | MTQ | 474 |
| Mauritania | MR | MRT | 478 |
| Mauritius | MU | MUS | 480 |
| Mayotte | YT | MYT | 175 |
| Mexico | MX | MEX | 484 |
| Micronesia, Federated States of | FM | FSM | 583 |
| Moldova, Republic of | MD | MDA | 498 |
| Monaco | MC | MCO | 492 |
| Mongolia | MN | MNG | 496 |
| Montenegro | ME | MNE | 499 |
| Montserrat | MS | MSR | 500 |
| Morocco | MA | MAR | 504 |
| Mozambique | MZ | MOZ | 508 |
| Myanmar | MM | MMR | 104 |
| Namibia | NA | NAM | 516 |
| Nauru | NR | NRU | 520 |
| Nepal | NP | NPL | 524 |
| Netherlands | NL | NLD | 528 |
| New Caledonia | NC | NCL | 540 |
| New Zealand | NZ | NZL | 554 |
| Nicaragua | NI | NIC | 558 |
| Niger | NE | NER | 562 |
| Nigeria | NG | NGA | 566 |
| Niue | NU | NIU | 570 |
| Norfolk Island | NF | NFK | 574 |
| Northern Mariana Islands | MP | MNP | 580 |
| Norway | NO | NOR | 578 |
| Oman | OM | OMN | 512 |
| Pakistan | PK | PAK | 586 |
| Palau | PW | PLW | 585 |
| Palestine, State of | PS | PSE | 275 |
| Panama | PA | PAN | 591 |
| Papua New Guinea | PG | PNG | 598 |
| Paraguay | PY | PRY | 600 |
| Peru | PE | PER | 604 |
| Philippines | PH | PHL | 608 |
| Pitcairn | PN | PCN | 612 |
| Poland | PL | POL | 616 |
| Portugal | PT | PRT | 620 |
| Puerto Rico | PR | PRI | 630 |
| Qatar | QA | QAT | 634 |
| Reunion | RE | REU | 638 |
| Romania | RO | ROU | 642 |
| Russian Federation | RU | RUS | 643 |
| Rwanda | RW | RWA | 646 |
| Saint Barthelemy | BL | BLM | 652 |
| Saint Helena, Ascension and Tristan da Cunha | SH | SHN | 654 |
| Saint Kitts and Nevis | KN | KNA | 659 |
| Saint Lucia | LC | LCA | 662 |
| Saint Martin (French part) | MF | MAF | 663 |
| Saint Pierre and Miquelon | PM | SPM | 666 |
| Saint Vincent and the Grenadines | VC | VCT | 670 |
| Samoa | WS | WSM | 882 |
| San Marino | SM | SMR | 674 |
| Sao Tome and Principe | ST | STP | 678 |
| Saudi Arabia | SA | SAU | 682 |
| Senegal | SN | SEN | 686 |
| Serbia | RS | SRB | 688 |
| Seychelles | SC | SYC | 690 |
| Sierra Leone | SL | SLE | 694 |
| Singapore | SG | SGP | 702 |
| Slovakia | SK | SVK | 703 |
| Slovenia | SI | SVN | 705 |
| Solomon Islands | SB | SLB | 090 |
| Somalia | SO | SOM | 706 |
| South Africa | ZA | ZAF | 710 |
| South Georgia and the South Sandwich Islands | GS | SGS | 239 |
| Spain | ES | ESP | 724 |
| Sri Lanka | LK | LKA | 144 |
| Sudan | SD | SDN | 729 |
| Suriname | SR | SUR | 740 |
| Svalbard and Jan Mayen | SJ | SJM | 744 |
| Eswatini | SZ | SWZ | 748 |
| Sweden | SE | SWE | 752 |
| Switzerland | CH | CHE | 756 |
| Syrian Arab Republic | SY | SYR | 760 |
| Taiwan, Province of China | TW | TWN | 158 |
| Tajikistan | TJ | TJK | 762 |
| Tanzania, United Republic of | TZ | TZA | 834 |
| Thailand | TH | THA | 764 |
| Timor-Leste | TL | TLS | 626 |
| Togo | TG | TGO | 768 |
| Tokelau | TK | TKL | 772 |
| Tonga | TO | TON | 776 |
| Trinidad and Tobago | TT | TTO | 780 |
| Tunisia | TN | TUN | 788 |
| Türkiye | TR | TUR | 792 |
| Turkmenistan | TM | TKM | 795 |
| Turks and Caicos Islands | TC | TCA | 796 |
| Tuvalu | TV | TUV | 798 |
| Uganda | UG | UGA | 800 |
| Ukraine | UA | UKR | 804 |
| United Arab Emirates | AE | ARE | 784 |
| United Kingdom | GB | GBR | 826 |
| United States | US | USA | 840 |
| United States Minor Outlying Islands | UM | UMI | 581 |
| Uruguay | UY | URY | 858 |
| Uzbekistan | UZ | UZB | 860 |
| Vanuatu | VU | VUT | 548 |
| Venezuela, Bolivarian Republic of | VE | VEN | 862 |
| Viet Nam | VN | VNM | 704 |
| Virgin Islands, British | VG | VGB | 092 |
| Virgin Islands, U.S. | VI | VIR | 850 |
| Wallis and Futuna | WF | WLF | 876 |
| Western Sahara | EH | ESH | 732 |
| Yemen | YE | YEM | 887 |
| Zambia | ZM | ZMB | 894 |
| Zimbabwe | ZW | ZWE | 716 |
| Sint Maarten (Dutch part) | SX | SXM | 534 |
| Curaçao | CW | CUW | 531 |
| Bonaire, Sint Eustatius and Saba | BQ | BES | 535 |
| South Sudan | SS | SSD | 728 |
#### Обязательные коды штатов
Передача кода штата в параметре state обязательна для США, Канады и Австралии.
| Страна | Код штата | Название |
|----------|-------------|------------------------------|
| AU | ACT | Australian Capital Territory |
| AU | NSW | New South Wales |
| AU | NT | Northern Territory |
| AU | QLD | Queensland |
| AU | SA | South Australia |
| AU | TAS | Tasmania |
| AU | VIC | Victoria |
| AU | WA | Western Australia |
| CA | AB | Alberta |
| CA | BC | British Columbia |
| CA | MB | Manitoba |
| CA | NB | New Brunswick |
| CA | NL | Newfoundland and Labrador |
| CA | NT | Northwest Territories |
| CA | NS | Nova Scotia |
| CA | NU | Nunavut |
| CA | ON | Ontario |
| CA | PE | Prince Edward Island |
| CA | QC | Quebec |
| CA | SK | Saskatchewan |
| CA | YT | Yukon |
| US | AL | Alabama |
| US | AK | Alaska |
| US | AS | American Samoa |
| US | AZ | Arizona |
| US | AR | Arkansas |
| US | CA | California |
| US | CO | Colorado |
| US | CT | Connecticut |
| US | DE | Delaware |
| US | DC | District of Columbia |
| US | FL | Florida |
| US | GA | Georgia |
| US | GU | Guam |
| US | HI | Hawaii |
| US | ID | Idaho |
| US | IL | Illinois |
| US | IN | Indiana |
| US | IA | Iowa |
| US | KS | Kansas |
| US | KY | Kentucky |
| US | LA | Louisiana |
| US | ME | Maine |
| US | MD | Maryland |
| US | MA | Massachusetts |
| US | MI | Michigan |
| US | MN | Minnesota |
| US | MS | Mississippi |
| US | MO | Missouri |
| US | MT | Montana |
| US | NE | Nebraska |
| US | NV | Nevada |
| US | NH | New Hampshire |
| US | NJ | New Jersey |
| US | NM | New Mexico |
| US | NY | New York |
| US | NC | North Carolina |
| US | ND | North Dakota |
| US | OH | Ohio |
| US | OK | Oklahoma |
| US | OR | Oregon |
| US | PA | Pennsylvania |
| US | PR | Puerto Rico |
| US | RI | Rhode Island |
| US | SC | South Carolina |
| US | SD | South Dakota |
| US | TN | Tennessee |
| US | TX | Texas |
| US | UT | Utah |
| US | VT | Vermont |
| US | VI | Virgin Islands |
| US | VA | Virginia |
| US | WA | Washington |
| US | WV | West Virginia |
| US | WI | Wisconsin |
| US | WY | Wyoming |
#### Прочие коды штатов
Ниже представлен список штатов, передача которых возможна в параметре state. В зависимости от используемого процессингового решения, передача этих штатов также может быть обязательна.
| Страна | ISO 3166-2 Сode | Название |
|----------|-------------------|-----------------------------------------------------------------------------|
| AF | BDS | Badakhshan |
| AF | BDG | Badghis |
| AF | BGL | Baghlan |
| AF | BAL | Balkh |
| AF | BAM | Bamian |
| AF | FRA | Farah |
| AF | FYB | Faryab |
| AF | GHA | Ghazni |
| AF | GHO | Ghowr |
| AF | HEL | Helmand |
| AF | HER | Herat |
| AF | JOW | Jowzjan |
| AF | KAB | Kabul |
| AF | KAN | Kandahar |
| AF | KAP | Kapisa |
| AF | KHO | Khost |
| AF | KNR | Konar |
| AF | KDZ | Kondoz |
| AF | LAG | Laghman |
| AF | NAN | Nangrahar |
| AF | NIM | Nimruz |
| AF | NUR | Nurestan |
| AF | PIA | Paktia |
| AF | PKA | Paktika |
| AF | PAR | Parwan |
| AF | SAM | Samangan |
| AF | SAR | Sar-e Pol |
| AF | TAK | Takhar |
| AF | WAR | Wardak |
| AF | DAY | Dāykundī |
| AF | LOG | Lōgar |
| AF | PAN | Panjshayr |
| AF | URU | Uruzgān |
| AF | ZAB | Zābul |
| AL | 01 | Berat |
| AL | 09 | Diber |
| AL | 02 | Durres |
| AL | 03 | Elbasan |
| AL | 04 | Fier |
| AL | 05 | Gjirokaster |
| AL | 06 | Korce |
| AL | 07 | Kukes |
| AL | 08 | Lezhe |
| AL | 10 | Shkoder |
| AL | 11 | Tirane |
| AL | 12 | Vlore |
| DZ | 01 | Adrar |
| DZ | 44 | Ain Defla |
| DZ | 46 | Ain Temouchent |
| DZ | 16 | Alger |
| DZ | 23 | Annaba |
| DZ | 05 | Batna |
| DZ | 08 | Bechar |
| DZ | 06 | Bejaia |
| DZ | 07 | Biskra |
| DZ | 09 | Blida |
| DZ | 34 | Bordj Bou Arreridj |
| DZ | 10 | Bouira |
| DZ | 35 | Boumerdes |
| DZ | 02 | Chlef |
| DZ | 25 | Constantine |
| DZ | 17 | Djelfa |
| DZ | 32 | El Bayadh |
| DZ | 39 | El Oued |
| DZ | 36 | El Tarf |
| DZ | 47 | Ghardaia |
| DZ | 24 | Guelma |
| DZ | 33 | Illizi |
| DZ | 18 | Jijel |
| DZ | 40 | Khenchela |
| DZ | 03 | Laghouat |
| DZ | 28 | M’Sila |
| DZ | 26 | Medea |
| DZ | 43 | Mila |
| DZ | 27 | Mostaganem |
| DZ | 45 | Naama |
| DZ | 31 | Oran |
| DZ | 30 | Ouargla |
| DZ | 48 | Relizane |
| DZ | 20 | Saida |
| DZ | 19 | Setif |
| DZ | 22 | Sidi Bel Abbes |
| DZ | 21 | Skikda |
| DZ | 41 | Souk Ahras |
| DZ | 12 | Tebessa |
| DZ | 14 | Tiaret |
| DZ | 37 | Tindouf |
| DZ | 42 | Tipaza |
| DZ | 38 | Tissemsilt |
| DZ | 15 | Tizi Ouzou |
| DZ | 13 | Tlemcen |
| DZ | 04 | Oum el Bouaghi |
| DZ | 11 | Tamanrasset |
| DZ | 29 | Mascara |
| AD | 07 | Andorra la Vella |
| AD | 02 | Canillo |
| AD | 03 | Encamp |
| AD | 08 | Escaldes-Engordany |
| AD | 04 | La Massana |
| AD | 05 | Ordino |
| AD | 06 | Sant Julia de Loria |
| AO | BGO | Bengo |
| AO | BGU | Benguela |
| AO | BIE | Bie |
| AO | CAB | Cabinda |
| AO | CCU | Cuando-Cubango |
| AO | CNO | Cuanza Norte |
| AO | CUS | Cuanza Sul |
| AO | CNN | Cunene |
| AO | HUA | Huambo |
| AO | HUI | Huila |
| AO | LUA | Luanda |
| AO | LNO | Lunda Norte |
| AO | LSU | Lunda Sul |
| AO | MAL | Malange |
| AO | MOX | Moxico |
| AO | NAM | Namibe |
| AO | UIG | Uige |
| AO | ZAI | Zaire |
| AG | 10 | Barbuda |
| AG | 11 | Redonda |
| AG | 03 | Saint George |
| AG | 04 | Saint John |
| AG | 05 | Saint Mary |
| AG | 06 | Saint Paul |
| AG | 07 | Saint Peter |
| AG | 08 | Saint Philip |
| AR | B | Buenos Aires |
| AR | K | Catamarca |
| AR | H | Chaco |
| AR | U | Chubut |
| AR | X | Cordoba |
| AR | W | Corrientes |
| AR | E | Entre Rios |
| AR | P | Formosa |
| AR | Y | Jujuy |
| AR | L | La Pampa |
| AR | F | La Rioja |
| AR | M | Mendoza |
| AR | N | Misiones |
| AR | Q | Neuquen |
| AR | R | Rio Negro |
| AR | A | Salta |
| AR | J | San Juan |
| AR | D | San Luis |
| AR | Z | Santa Cruz |
| AR | S | Santa Fe |
| AR | G | Santiago del Estero |
| AR | V | Tierra del Fuego |
| AR | T | Tucuman |
| AR | C | Ciudad Autónoma de Buenos Aires |
| AM | AR | Ararat |
| AM | AV | Armavir |
| AM | KT | Kotayk’ |
| AM | SU | Syunik’ |
| AM | AG | Aragac̣otn |
| AM | ER | Erevan |
| AM | GR | Geġark’unik’ |
| AM | LO | Loṙi |
| AM | SH | Širak |
| AM | TV | Tavuš |
| AM | VD | Vayoć Jor |
| AT | 1 | Burgenland |
| AT | 3 | Niederösterreich |
| AT | 5 | Salzburg |
| AT | 6 | Steiermark |
| AT | 7 | Tirol |
| AT | 8 | Vorarlberg |
| AT | 9 | Wien |
| AT | 2 | Kärnten |
| AT | 4 | Oberösterreich |
| AZ | ABS | Abseron |
| AZ | AGC | Agcab Adi |
| AZ | AGM | Agdam |
| AZ | AGS | Agdas |
| AZ | AGA | Agstafa |
| AZ | AGU | Agsu |
| AZ | AST | Astara |
| AZ | BAR | BArdA |
| AZ | BAB | Bab Ak |
| AZ | BA | Baki |
| AZ | BAL | Balak An |
| AZ | BEY | Beylaqan |
| AZ | BIL | Bilasuvar |
| AZ | CAB | Cabrayil |
| AZ | CAL | Calilabab |
| AZ | CUL | Culfa |
| AZ | DAS | Daskasan |
| AZ | FUZ | Fuzuli |
| AZ | GAD | Gadabay |
| AZ | GA | Ganca |
| AZ | GOR | Goranboy |
| AZ | GOY | Goycay |
| AZ | HAC | Haciqabul |
| AZ | IMI | Imisli |
| AZ | ISM | Ismayilli |
| AZ | KAL | Kalbacar |
| AZ | KUR | Kurdamir |
| AZ | LAC | Lacin |
| AZ | LA | Lankaran |
| AZ | LER | Lerik |
| AZ | MAS | Masalli |
| AZ | MI | Mingacevir |
| AZ | NA | Naftalan |
| AZ | NX | Naxcivan |
| AZ | NEF | Neftcala |
| AZ | OGU | Oguz |
| AZ | ORD | Ordubad |
| AZ | QAB | Qabala |
| AZ | QAX | Qax |
| AZ | QAZ | Qazax |
| AZ | QOB | Qobustan |
| AZ | QBA | Quba |
| AZ | QBI | Qubadli |
| AZ | QUS | Qusar |
| AZ | SAT | Saatli |
| AZ | SAB | Sabirabad |
| AZ | SAD | Sadarak |
| AZ | SAH | Sahbuz |
| AZ | SA | Saki |
| AZ | SAL | Salyan |
| AZ | SMI | Samaxi |
| AZ | SKR | Samkir |
| AZ | SMX | Samux |
| AZ | SAR | Sarur |
| AZ | SIY | Siyazan |
| AZ | SM | Sumqayit |
| AZ | SUS | Susa |
| AZ | TAR | Tartar |
| AZ | TOV | Tovuz |
| AZ | UCA | Ucar |
| AZ | XAC | Xacmaz |
| AZ | XA | Xankandi |
| AZ | XIZ | Xizi |
| AZ | XCI | Xocali |
| AZ | XVD | Xocavand |
| AZ | YAR | Yardimli |
| AZ | YE | Yevlax |
| AZ | ZAN | Zangilan |
| AZ | ZAQ | Zaqatala |
| AZ | ZAR | Zardab |
| AZ | GYG | Göygöl |
| AZ | KAN | Kǝngǝrli |
| AZ | SBN | Şabran |
| AZ | SR | Şirvan |
| BS | AK | Acklins |
| BS | BY | Berry Islands |
| BS | BI | Bimini |
| BS | BP | Black Point |
| BS | CI | Cat Island |
| BS | CO | Central Abaco |
| BS | CS | Central Andros |
| BS | CE | Central Eleuthera |
| BS | FP | City of Freeport |
| BS | EG | East Grand Bahama |
| BS | EX | Exuma |
| BS | GC | Grand Cay |
| BS | HI | Harbour Island |
| BS | HT | Hope Town |
| BS | IN | Inagua |
| BS | LI | Long Island |
| BS | MC | Mangrove Cay |
| BS | MG | Mayaguana |
| BS | MI | Moore’s Island |
| BS | NO | North Abaco |
| BS | NS | North Andros |
| BS | NE | North Eleuthera |
| BS | RI | Ragged Island |
| BS | RC | Rum Cay |
| BS | SS | San Salvador |
| BS | SO | South Abaco |
| BS | SA | South Andros |
| BS | SE | South Eleuthera |
| BS | SW | Spanish Wells |
| BS | WG | West Grand Bahama |
| BS | CK | Crooked Island and Long Cay |
| BS | NP | New Providence |
| BH | 13 | Al ‘Āşimah |
| BH | 14 | Al Janūbīyah |
| BH | 15 | Al Muḩarraq |
| BH | 17 | Ash Shamālīyah |
| BD | C | Dhaka |
| BD | D | Khulna |
| BD | E | Rajshahi |
| BD | G | Sylhet |
| BD | 01 | Bandarban |
| BD | 02 | Barguna |
| BD | 03 | Bogura |
| BD | 04 | Brahmanbaria |
| BD | 05 | Bagerhat |
| BD | 06 | Barishal |
| BD | 07 | Bhola |
| BD | 08 | Cumilla |
| BD | 09 | Chandpur |
| BD | 10 | Chattogram |
| BD | 11 | Cox’s Bazar |
| BD | 12 | Chuadanga |
| BD | 14 | Dinajpur |
| BD | 15 | Faridpur |
| BD | 16 | Feni |
| BD | 17 | Gopalganj |
| BD | 18 | Gazipur |
| BD | 19 | Gaibandha |
| BD | 20 | Habiganj |
| BD | 21 | Jamalpur |
| BD | 22 | Jashore |
| BD | 23 | Jhenaidah |
| BD | 24 | Joypurhat |
| BD | 25 | Jhalakathi |
| BD | 26 | Kishoreganj |
| BD | 28 | Kurigram |
| BD | 29 | Khagrachhari |
| BD | 30 | Kushtia |
| BD | 31 | Lakshmipur |
| BD | 32 | Lalmonirhat |
| BD | 33 | Manikganj |
| BD | 34 | Mymensingh |
| BD | 35 | Munshiganj |
| BD | 36 | Madaripur |
| BD | 37 | Magura |
| BD | 38 | Moulvibazar |
| BD | 39 | Meherpur |
| BD | 40 | Narayanganj |
| BD | 41 | Netrakona |
| BD | 42 | Narsingdi |
| BD | 43 | Narail |
| BD | 44 | Natore |
| BD | 45 | Chapai Nawabganj |
| BD | 46 | Nilphamari |
| BD | 47 | Noakhali |
| BD | 48 | Naogaon |
| BD | 49 | Pabna |
| BD | 50 | Pirojpur |
| BD | 51 | Patuakhali |
| BD | 52 | Panchagarh |
| BD | 53 | Rajbari |
| BD | 55 | Rangpur |
| BD | 56 | Rangamati |
| BD | 57 | Sherpur |
| BD | 58 | Satkhira |
| BD | 59 | Sirajganj |
| BD | 61 | Sunamganj |
| BD | 62 | Shariatpur |
| BD | 63 | Tangail |
| BD | 64 | Thakurgaon |
| BD | A | Barishal |
| BD | B | Chattogram |
| BD | F | Rangpur |
| BD | H | Mymensingh |
| BB | 01 | Christ Church |
| BB | 02 | Saint Andrew |
| BB | 03 | Saint George |
| BB | 04 | Saint James |
| BB | 05 | Saint John |
| BB | 06 | Saint Joseph |
| BB | 07 | Saint Lucy |
| BB | 08 | Saint Michael |
| BB | 09 | Saint Peter |
| BB | 10 | Saint Philip |
| BB | 11 | Saint Thomas |
| BY | BR | Brestskaya (Brest) |
| BY | HO | Homyel’skaya (Homyel’) |
| BY | HM | Horad Minsk |
| BY | HR | Hrodzyenskaya (Hrodna) |
| BY | MA | Mahilyowskaya (Mahilyow) |
| BY | MI | Minskaya |
| BY | VI | Vitsyebskaya (Vitsyebsk) |
| BE | VAN | Antwerpen |
| BE | WBR | Brabant Wallon |
| BE | WHT | Hainaut |
| BE | WLG | Liege |
| BE | VLI | Limburg |
| BE | WLX | Luxembourg |
| BE | WNA | Namur |
| BE | VOV | Oost-Vlaanderen |
| BE | VBR | Vlaams Brabant |
| BE | VWV | West-Vlaanderen |
| BE | BRU | “Bruxelles-Capitale, Région de” |
| BE | VLG | Vlaams Gewest |
| BE | WAL | “wallonne, Région” |
| BZ | BZ | Belize |
| BZ | CY | Cayo |
| BZ | CZL | Corozal |
| BZ | OW | Orange Walk |
| BZ | SC | Stann Creek |
| BZ | TOL | Toledo |
| BJ | AL | Alibori |
| BJ | AK | Atakora |
| BJ | AQ | Atlantique |
| BJ | BO | Borgou |
| BJ | CO | Collines |
| BJ | DO | Donga |
| BJ | KO | Kouffo |
| BJ | LI | Littoral |
| BJ | MO | Mono |
| BJ | OU | Oueme |
| BJ | PL | Plateau |
| BJ | ZO | Zou |
| BT | 33 | Bumthang |
| BT | 22 | Dagana |
| BT | GA | Gasa |
| BT | 13 | Haa |
| BT | 11 | Paro |
| BT | 23 | Punakha |
| BT | 45 | Samdrup Jongkhar |
| BT | 14 | Samtse |
| BT | 31 | Sarpang |
| BT | 15 | Thimphu |
| BT | 41 | Trashigang |
| BT | 32 | Trongsa |
| BT | 21 | Tsirang |
| BT | 24 | Wangdue Phodrang |
| BT | 34 | Zhemgang |
| BT | 12 | Chhukha |
| BT | 42 | Monggar |
| BT | 43 | Pema Gatshel |
| BT | 44 | Lhuentse |
| BT | TY | Trashi Yangtse |
| BO | H | Chuquisaca |
| BO | C | Cochabamba |
| BO | L | La Paz |
| BO | O | Oruro |
| BO | N | Pando |
| BO | P | Potosi |
| BO | S | Santa Cruz |
| BO | T | Tarija |
| BO | B | El Beni |
| BA | BIH | Federacija Bosne i Hercegovine |
| BA | BRC | Brčko distrikt |
| BA | SRP | Republika Srpska |
| BW | CE | Central |
| BW | GH | Ghanzi |
| BW | KG | Kgalagadi |
| BW | KL | Kgatleng |
| BW | KW | Kweneng |
| BW | NE | North East |
| BW | NW | North West |
| BW | SE | South East |
| BW | SO | Southern |
| BW | CH | Chobe |
| BW | FR | Francistown |
| BW | GA | Gaborone |
| BW | JW | Jwaneng |
| BW | LO | Lobatse |
| BW | SP | Selibe Phikwe |
| BW | ST | Sowa Town |
| BR | AC | Acre |
| BR | AL | Alagoas |
| BR | AP | Amapa |
| BR | AM | Amazonas |
| BR | BA | Bahia |
| BR | CE | Ceara |
| BR | DF | Distrito Federal |
| BR | ES | Espirito Santo |
| BR | GO | Goias |
| BR | MA | Maranhao |
| BR | MT | Mato Grosso |
| BR | MS | Mato Grosso do Sul |
| BR | MG | Minas Gerais |
| BR | PA | Para |
| BR | PB | Paraiba |
| BR | PR | Parana |
| BR | PE | Pernambuco |
| BR | PI | Piaui |
| BR | RN | Rio Grande do Norte |
| BR | RS | Rio Grande do Sul |
| BR | RJ | Rio de Janeiro |
| BR | RO | Rondonia |
| BR | RR | Roraima |
| BR | SC | Santa Catarina |
| BR | SP | Sao Paulo |
| BR | SE | Sergipe |
| BR | TO | Tocantins |
| BN | BE | Belait |
| BN | TE | Temburong |
| BN | TU | Tutong |
| BN | BM | Brunei-Muara |
| BG | 01 | Blagoevgrad |
| BG | 02 | Burgas |
| BG | 08 | Dobrich |
| BG | 07 | Gabrovo |
| BG | 26 | Haskovo |
| BG | 09 | Kardjali |
| BG | 10 | Kyustendil |
| BG | 11 | Lovech |
| BG | 12 | Montana |
| BG | 13 | Pazardjik |
| BG | 14 | Pernik |
| BG | 15 | Pleven |
| BG | 16 | Plovdiv |
| BG | 17 | Razgrad |
| BG | 27 | Shumen |
| BG | 19 | Silistra |
| BG | 20 | Sliven |
| BG | 21 | Smolyan |
| BG | 23 | Sofia |
| BG | 22 | Sofia - town |
| BG | 24 | Stara Zagora |
| BG | 25 | Targovishte |
| BG | 03 | Varna |
| BG | 04 | Veliko Tarnovo |
| BG | 05 | Vidin |
| BG | 06 | Vratza |
| BG | 28 | Yambol |
| BG | 18 | Ruse |
| BF | BAL | Bale |
| BF | BAM | Bam |
| BF | BAN | Banwa |
| BF | BAZ | Bazega |
| BF | BGR | Bougouriba |
| BF | BLG | Boulgou |
| BF | BLK | Boulkiemde |
| BF | COM | Comoe |
| BF | GAN | Ganzourgou |
| BF | GNA | Gnagna |
| BF | GOU | Gourma |
| BF | HOU | Houet |
| BF | IOB | Ioba |
| BF | KAD | Kadiogo |
| BF | KEN | Kenedougou |
| BF | KMD | Komondjari |
| BF | KOP | Kompienga |
| BF | KOS | Kossi |
| BF | KOP | Koulpelogo |
| BF | KOT | Kouritenga |
| BF | KOW | Kourweogo |
| BF | LER | Leraba |
| BF | LOR | Loroum |
| BF | MOU | Mouhoun |
| BF | NAO | Nahouri |
| BF | NAM | Namentenga |
| BF | NAY | Nayala |
| BF | NOU | Noumbiel |
| BF | OUB | Oubritenga |
| BF | OUD | Oudalan |
| BF | PAS | Passore |
| BF | PON | Poni |
| BF | SNG | Sanguie |
| BF | SMT | Sanmatenga |
| BF | SEN | Seno |
| BF | SIS | Sissili |
| BF | SOM | Soum |
| BF | SOR | Sourou |
| BF | TAP | Tapoa |
| BF | TUI | Tuy |
| BF | YAG | Yagha |
| BF | YAT | Yatenga |
| BF | ZIR | Ziro |
| BF | ZON | Zondoma |
| BF | ZOU | Zoundweogo |
| BF | 01 | Boucle du Mouhoun |
| BF | 02 | Cascades |
| BF | 03 | Centre |
| BF | 04 | Centre-Est |
| BF | 05 | Centre-Nord |
| BF | 06 | Centre-Ouest |
| BF | 07 | Centre-Sud |
| BF | 08 | Est |
| BF | 09 | Hauts-Bassins |
| BF | 10 | Nord |
| BF | 11 | Plateau-Central |
| BF | 12 | Sahel |
| BF | 13 | Sud-Ouest |
| BI | BB | Bubanza |
| BI | BR | Bururi |
| BI | CA | Cankuzo |
| BI | CI | Cibitoke |
| BI | GI | Gitega |
| BI | KR | Karuzi |
| BI | KY | Kayanza |
| BI | KI | Kirundo |
| BI | MA | Makamba |
| BI | MU | Muramvya |
| BI | MY | Muyinga |
| BI | MW | Mwaro |
| BI | NG | Ngozi |
| BI | RT | Rutana |
| BI | RY | Ruyigi |
| BI | BL | Bujumbura Rural |
| BI | BM | Bujumbura Mairie |
| BI | RM | Rumonge |
| KH | 1 | Banteay Meanchey |
| KH | 3 | Kampong Cham |
| KH | 4 | Kampong Chhnang |
| KH | 7 | Kampot |
| KH | 8 | Kandal |
| KH | 9 | Kaoh Kong |
| KH | 23 | Keb |
| KH | 24 | Pailin |
| KH | 12 | Phnom Penh |
| KH | 13 | Preah Vihear |
| KH | 14 | Prey Veng |
| KH | 20 | Svay Rieng |
| KH | 10 | Krâchéh |
| KH | 11 | Môndól Kiri |
| KH | 15 | Poŭthĭsăt |
| KH | 16 | Rôtânôkiri |
| KH | 17 | Siĕmréab |
| KH | 18 | Preah Sihanouk |
| KH | 19 | Stueng Traeng |
| KH | 2 | Bătdâmbâng |
| KH | 21 | Takêv |
| KH | 22 | Ŏtdâr Méan Choăy |
| KH | 25 | Tbong Khmum |
| KH | 5 | Kâmpóng Spœ |
| KH | 6 | Kâmpóng Thum |
| CM | CE | Centre |
| CM | LT | Littoral |
| CM | AD | Adamaoua |
| CM | EN | Far North |
| CM | ES | Est |
| CM | NO | North |
| CM | NW | North-West |
| CM | OU | West |
| CM | SU | Sud |
| CM | SW | Sud-Ouest |
| CV | BV | Boa Vista |
| CV | BR | Brava |
| CV | MA | Maio |
| CV | MO | Mosteiros |
| CV | PA | Paul |
| CV | PN | Porto Novo |
| CV | PR | Praia |
| CV | RG | Ribeira Grande |
| CV | SL | Sal |
| CV | CA | Santa Catarina |
| CV | CR | Santa Cruz |
| CV | SD | Sao Domingos |
| CV | SF | Sao Filipe |
| CV | SV | Sao Vicente |
| CV | TA | Tarrafal |
| CV | B | Ilhas de Barlavento |
| CV | CF | Santa Catarina do Fogo |
| CV | RB | Ribeira Brava |
| CV | RS | Ribeira Grande de Santiago |
| CV | S | Ilhas de Sotavento |
| CV | SM | São Miguel |
| CV | SO | São Lourenço dos Órgãos |
| CV | SS | São Salvador do Mundo |
| CV | TS | Tarrafal de São Nicolau |
| CF | BB | Bamingui-Bangoran |
| CF | BGF | Bangui |
| CF | BK | Basse-Kotto |
| CF | HM | Haut-Mbomou |
| CF | HK | Haute-Kotto |
| CF | LB | Lobaye |
| CF | MB | Mbomou |
| CF | NM | Nana-Mambere |
| CF | UK | Ouaka |
| CF | AC | Ouham |
| CF | OP | Ouham-Pende |
| CF | VK | Vakaga |
| CF | HS | Tö-Sangä / Mbaere-Kadeï |
| CF | KB | Gribingui |
| CF | KG | Kémo-Gribingui |
| CF | MP | Ombella-Mpoko |
| CF | SE | Sangha |
| TD | BA | Batha |
| TD | CB | Chari-Baguirmi |
| TD | GR | Guera |
| TD | KA | Kanem |
| TD | LC | Lac |
| TD | LC | Logone Occidental |
| TD | LR | Logone Oriental |
| TD | MC | Moyen-Chari |
| TD | OD | Ouaddai |
| TD | SA | Salamat |
| TD | TA | Tandjile |
| TD | BG | Bahr el Ghazal |
| TD | BO | Būrkū |
| TD | EE | Inīdī ash Sharqī |
| TD | EO | Inīdī al Gharbī |
| TD | HL | Ḩajjar Lamīs |
| TD | LO | Lūghūn al Gharbī |
| TD | MA | Māndūl |
| TD | ME | Māyū Kībbī ash Sharqī |
| TD | MO | Māyū Kībbī al Gharbī |
| TD | ND | Ville de Ndjamena |
| TD | SI | Sīlā |
| TD | TI | Tibesti |
| TD | WF | Wādī Fīrā’ |
| CL | AI | Aisen del General Carlos Ibanez |
| CL | AN | Antofagasta |
| CL | AR | Araucania |
| CL | AT | Atacama |
| CL | BI | Bio-Bio |
| CL | CO | Coquimbo |
| CL | LI | Libertador General Bernardo O’Hi |
| CL | LL | Los Lagos |
| CL | MA | Magallanes y de la Antartica Chi |
| CL | ML | Maule |
| CL | RM | Region Metropolitana |
| CL | TA | Tarapaca |
| CL | VS | Valparaiso |
| CL | AP | Arica y Parinacota |
| CL | LR | Los Ríos |
| CL | NB | Ñuble |
| CN | GX | Guangxi |
| CN | GZ | Guizhou |
| CN | HA | Hainan |
| CN | HB | Hebei |
| CN | HL | Heilongjiang |
| CN | HE | Henan |
| CN | HK | Hong Kong |
| CN | HN | Hunan |
| CN | JX | Jiangxi |
| CN | JL | Jilin |
| CN | SH | Shaanxi |
| CN | SX | Shanxi |
| CN | AH | Anhui Sheng |
| CN | BJ | Beijing Shi |
| CN | CQ | Chongqing Shi |
| CN | FJ | Fujian Sheng |
| CN | GD | Guangdong Sheng |
| CN | GS | Gansu Sheng |
| CN | HI | Hainan Sheng |
| CN | JS | Jiangsu Sheng |
| CN | LN | Liaoning Sheng |
| CN | MO | Macau SAR (see also separate country code entry under MO) |
| CN | NM | Nei Mongol Zizhiqu |
| CN | NX | Ningxia Huizi Zizhiqu |
| CN | QH | Qinghai Sheng |
| CN | SC | Sichuan Sheng |
| CN | SD | Shandong Sheng |
| CN | SN | Shaanxi Sheng |
| CN | TJ | Tianjin Shi |
| CN | TW | Taiwan Sheng (see also separate country code entry under TW) |
| CN | XJ | Xinjiang Uygur Zizhiqu |
| CN | XZ | Xizang Zizhiqu |
| CN | YN | Yunnan Sheng |
| CN | ZJ | Zhejiang Sheng |
| CO | AMA | Amazonas |
| CO | ANT | Antioquia |
| CO | ARA | Arauca |
| CO | ATL | Atlantico |
| CO | BOL | Bolivar |
| CO | BOY | Boyaca |
| CO | CAL | Caldas |
| CO | CAQ | Caqueta |
| CO | CAS | Casanare |
| CO | CAU | Cauca |
| CO | CES | Cesar |
| CO | CHO | Choco |
| CO | COR | Cordoba |
| CO | CUN | Cundinamarca |
| CO | GUA | Guainia |
| CO | GUV | Guaviare |
| CO | HUI | Huila |
| CO | MAG | Magdalena |
| CO | MET | Meta |
| CO | NAR | Narino |
| CO | NSA | Norte de Santander |
| CO | PUT | Putumayo |
| CO | QUI | Quindio |
| CO | RIS | Risaralda |
| CO | SAP | San Andres y Providencia |
| CO | SAN | Santander |
| CO | SUC | Sucre |
| CO | TOL | Tolima |
| CO | VAC | Valle del Cauca |
| CO | VAU | Vaupes |
| CO | VID | Vichada |
| CO | DC | Distrito Capital de Bogotá |
| CO | LAG | La Guajira |
| KM | A | Anjouan |
| KM | G | Grande Comore |
| KM | M | Moheli |
| CG | 11 | Bouenza |
| CG | BZV | Brazzaville |
| CG | 8 | Cuvette |
| CG | 15 | Cuvette-Ouest |
| CG | 5 | Kouilou |
| CG | 2 | Lekoumou |
| CG | 7 | Likouala |
| CG | 9 | Niari |
| CG | 14 | Plateaux |
| CG | 12 | Pool |
| CG | 13 | Sangha |
| CG | 16 | Pointe-Noire |
| CD | BC | Bas-Congo |
| CD | EQ | Equateur |
| CD | KE | Kasai-Oriental |
| CD | KN | Kinshasa |
| CD | MA | Maniema |
| CD | NK | Nord-Kivu |
| CD | SK | Sud-Kivu |
| CD | BU | Bas-Uélé |
| CD | HK | Haut-Katanga |
| CD | HL | Haut-Lomami |
| CD | HU | Haut-Uélé |
| CD | IT | Ituri |
| CD | KC | Kasaï Central |
| CD | KG | Kwango |
| CD | KL | Kwilu |
| CD | KS | Kasaï |
| CD | LO | Lomami |
| CD | LU | Lualaba |
| CD | MN | Mai-Ndombe |
| CD | MO | Mongala |
| CD | NU | Nord-Ubangi |
| CD | SA | Sankuru |
| CD | SU | Sud-Ubangi |
| CD | TA | Tanganyika |
| CD | TO | Tshopo |
| CD | TU | Tshuapa |
| CR | A | Alajuela |
| CR | C | Cartago |
| CR | G | Guanacaste |
| CR | H | Heredia |
| CR | L | Limon |
| CR | P | Puntarenas |
| CR | SJ | San Jose |
| CI | AB | Abidjan |
| CI | YM | Yamoussoukro |
| CI | BS | Bas-Sassandra |
| CI | CM | Comoé |
| CI | DN | Denguélé |
| CI | GD | Gôh-Djiboua |
| CI | LC | Lacs |
| CI | LG | Lagunes |
| CI | MG | Montagnes |
| CI | SM | Sassandra-Marahoué |
| CI | SV | Savanes |
| CI | VB | Vallée du Bandama |
| CI | WR | Woroba |
| CI | ZZ | Zanzan |
| HR | 01 | Zagrebačka županija |
| HR | 02 | Krapinsko-zagorska županija |
| HR | 03 | Sisačko-moslavačka županija |
| HR | 04 | Karlovačka županija |
| HR | 05 | Varaždinska županija |
| HR | 06 | Koprivničko-križevačka županija |
| HR | 07 | Bjelovarsko-bilogorska županija |
| HR | 08 | Primorsko-goranska županija |
| HR | 09 | Ličko-senjska županija |
| HR | 10 | Virovitičko-podravska županija |
| HR | 11 | Požeško-slavonska županija |
| HR | 12 | Brodsko-posavska županija |
| HR | 13 | Zadarska županija |
| HR | 14 | Osječko-baranjska županija |
| HR | 15 | Šibensko-kninska županija |
| HR | 16 | Vukovarsko-srijemska županija |
| HR | 17 | Splitsko-dalmatinska županija |
| HR | 18 | Istarska županija |
| HR | 19 | Dubrovačko-neretvanska županija |
| HR | 20 | Međimurska županija |
| HR | 21 | Grad Zagreb |
| CU | 09 | Camaguey |
| CU | 08 | Ciego de Avila |
| CU | 06 | Cienfuegos |
| CU | 12 | Granma |
| CU | 14 | Guantanamo |
| CU | 11 | Holguin |
| CU | 99 | Isla de la Juventud |
| CU | 03 | La Habana |
| CU | 10 | Las Tunas |
| CU | 04 | Matanzas |
| CU | 01 | Pinar del Rio |
| CU | 07 | Sancti Spiritus |
| CU | 13 | Santiago de Cuba |
| CU | 05 | Villa Clara |
| CU | 15 | Artemisa |
| CU | 16 | Mayabeque |
| CY | 01 | Lefkosia |
| CY | 02 | Leymasun |
| CY | 03 | Larnaka |
| CY | 04 | Mağusa |
| CY | 05 | Pafos |
| CY | 06 | Keryneia |
| CZ | 10 | “Praha, Hlavní město” |
| CZ | 20 | Středočeský kraj |
| CZ | 201 | Benešov |
| CZ | 202 | Beroun |
| CZ | 203 | Kladno |
| CZ | 204 | Kolín |
| CZ | 205 | Kutná Hora |
| CZ | 206 | Mělník |
| CZ | 207 | Mladá Boleslav |
| CZ | 208 | Nymburk |
| CZ | 209 | Praha-východ |
| CZ | 20A | Praha-západ |
| CZ | 20B | Příbram |
| CZ | 20C | Rakovník |
| CZ | 31 | Jihočeský kraj |
| CZ | 311 | České Budějovice |
| CZ | 312 | Český Krumlov |
| CZ | 313 | Jindřichův Hradec |
| CZ | 314 | Písek |
| CZ | 315 | Prachatice |
| CZ | 316 | Strakonice |
| CZ | 317 | Tábor |
| CZ | 32 | Plzeňský kraj |
| CZ | 321 | Domažlice |
| CZ | 322 | Klatovy |
| CZ | 323 | Plzeň-město |
| CZ | 324 | Plzeň-jih |
| CZ | 325 | Plzeň-sever |
| CZ | 326 | Rokycany |
| CZ | 327 | Tachov |
| CZ | 41 | Karlovarský kraj |
| CZ | 411 | Cheb |
| CZ | 412 | Karlovy Vary |
| CZ | 413 | Sokolov |
| CZ | 42 | Ústecký kraj |
| CZ | 421 | Děčín |
| CZ | 422 | Chomutov |
| CZ | 423 | Litoměřice |
| CZ | 424 | Louny |
| CZ | 425 | Most |
| CZ | 426 | Teplice |
| CZ | 427 | Ústí nad Labem |
| CZ | 51 | Liberecký kraj |
| CZ | 511 | Česká Lípa |
| CZ | 512 | Jablonec nad Nisou |
| CZ | 513 | Liberec |
| CZ | 514 | Semily |
| CZ | 52 | Královéhradecký kraj |
| CZ | 521 | Hradec Králové |
| CZ | 522 | Jičín |
| CZ | 523 | Náchod |
| CZ | 524 | Rychnov nad Kněžnou |
| CZ | 525 | Trutnov |
| CZ | 53 | Pardubický kraj |
| CZ | 531 | Chrudim |
| CZ | 532 | Pardubice |
| CZ | 533 | Svitavy |
| CZ | 534 | Ústí nad Orlicí |
| CZ | 63 | Kraj Vysočina |
| CZ | 631 | Havlíčkův Brod |
| CZ | 632 | Jihlava |
| CZ | 633 | Pelhřimov |
| CZ | 634 | Třebíč |
| CZ | 635 | Žďár nad Sázavou |
| CZ | 64 | Jihomoravský kraj |
| CZ | 641 | Blansko |
| CZ | 642 | Brno-město |
| CZ | 643 | Brno-venkov |
| CZ | 644 | Břeclav |
| CZ | 645 | Hodonín |
| CZ | 646 | Vyškov |
| CZ | 647 | Znojmo |
| CZ | 71 | Olomoucký kraj |
| CZ | 711 | Jeseník |
| CZ | 712 | Olomouc |
| CZ | 713 | Prostějov |
| CZ | 714 | Přerov |
| CZ | 715 | Šumperk |
| CZ | 72 | Zlínský kraj |
| CZ | 721 | Kroměříž |
| CZ | 722 | Uherské Hradiště |
| CZ | 723 | Vsetín |
| CZ | 724 | Zlín |
| CZ | 80 | Moravskoslezský kraj |
| CZ | 801 | Bruntál |
| CZ | 802 | Frýdek-Místek |
| CZ | 803 | Karviná |
| CZ | 804 | Nový Jičín |
| CZ | 805 | Opava |
| CZ | 806 | Ostrava-město |
| DK | 81 | Nordjylland |
| DK | 82 | Midtjylland |
| DK | 83 | Syddanmark |
| DK | 84 | Hovedstaden |
| DK | 85 | Sjælland |
| DJ | DI | Dikhil |
| DJ | DJ | Djibouti |
| DJ | OB | Obock |
| DJ | AR | ‘Artā |
| DJ | AS | ‘Alī Şabīḩ |
| DJ | TA | Tājūrah |
| DM | 02 | Saint Andrew |
| DM | 03 | Saint David |
| DM | 04 | Saint George |
| DM | 05 | Saint John |
| DM | 06 | Saint Joseph |
| DM | 07 | Saint Luke |
| DM | 08 | Saint Mark |
| DM | 09 | Saint Patrick |
| DM | 10 | Saint Paul |
| DM | 11 | Saint Peter |
| DO | 02 | Azua |
| DO | 03 | Baoruco |
| DO | 04 | Barahona |
| DO | 05 | Dajabon |
| DO | 06 | Duarte |
| DO | 07 | Elias Pina |
| DO | 09 | Espaillat |
| DO | 30 | Hato Mayor |
| DO | 10 | Independencia |
| DO | 11 | La Altagracia |
| DO | 12 | La Romana |
| DO | 13 | La Vega |
| DO | 14 | Maria Trinidad Sanchez |
| DO | 28 | Monsenor Nouel |
| DO | 15 | Monte Cristi |
| DO | 29 | Monte Plata |
| DO | 16 | Pedernales |
| DO | 18 | Puerto Plata |
| DO | 20 | Samana |
| DO | 21 | San Cristobal |
| DO | 31 | San Jose de Ocoa |
| DO | 22 | San Juan |
| DO | 23 | San Pedro de Macoris |
| DO | 24 | Sanchez Ramirez |
| DO | 25 | Santiago |
| DO | 26 | Santiago Rodriguez |
| DO | 32 | Santo Domingo |
| DO | 27 | Valverde |
| DO | 01 | Distrito Nacional (Santo Domingo) |
| DO | 08 | El Seibo |
| DO | 17 | Peravia |
| DO | 19 | Hermanas Mirabal |
| DO | 33 | Cibao Nordeste |
| DO | 34 | Cibao Noroeste |
| DO | 35 | Cibao Norte |
| DO | 36 | Cibao Sur |
| DO | 37 | El Valle |
| DO | 38 | Enriquillo |
| DO | 39 | Higuamo |
| DO | 40 | Ozama |
| DO | 41 | Valdesia |
| DO | 42 | Yuma |
| EC | A | Azuay |
| EC | B | Bolivar |
| EC | C | Carchi |
| EC | H | Chimborazo |
| EC | X | Cotopaxi |
| EC | O | El Oro |
| EC | E | Esmeraldas |
| EC | W | Galápagos |
| EC | G | Guayas |
| EC | I | Imbabura |
| EC | L | Loja |
| EC | R | Los Rios |
| EC | M | Manabí |
| EC | S | Morona Santiago |
| EC | N | Napo |
| EC | D | Orellana |
| EC | Y | Pastaza |
| EC | P | Pichincha |
| EC | U | Sucumbíos |
| EC | T | Tungurahua |
| EC | Z | Zamora Chinchipe |
| EC | F | Cañar |
| EC | SD | Santo Domingo de los Tsáchilas |
| EC | SE | Santa Elena |
| EG | DK | Ad Daqahliyah |
| EG | BA | Al Bahr al Ahmar |
| EG | BH | Al Buhayrah |
| EG | FYM | Al Fayyum |
| EG | GH | Al Gharbiyah |
| EG | ALX | Al Iskandariyah |
| EG | IS | Al Isma’iliyah |
| EG | GZ | Al Jizah |
| EG | MNF | Al Minufiyah |
| EG | MN | Al Minya |
| EG | C | Al Qahirah |
| EG | KB | Al Qalyubiyah |
| EG | WAD | Al Wadi al Jadid |
| EG | SUZ | As Suways |
| EG | SHR | Ash Sharqiyah |
| EG | ASN | Aswan |
| EG | AST | Asyut |
| EG | BNS | Bani Suwayf |
| EG | DT | Dumyat |
| EG | JS | Janub Sina’ |
| EG | KFS | Kafr ash Shaykh |
| EG | MT | Matruh |
| EG | KN | Qina |
| EG | SIN | Shamal Sina’ |
| EG | SHG | Suhaj |
| EG | LX | Al Uqşur |
| EG | PTS | Būr Sa‘īd |
| SV | AH | Ahuachapan |
| SV | CA | Cabanas |
| SV | CH | Chalatenango |
| SV | CU | Cuscatlan |
| SV | LI | La Libertad |
| SV | PA | La Paz |
| SV | UN | La Union |
| SV | MO | Morazan |
| SV | SM | San Miguel |
| SV | SS | San Salvador |
| SV | SV | San Vicente |
| SV | SA | Santa Ana |
| SV | SO | Sonsonate |
| SV | US | Usulutan |
| GQ | AN | Provincia Annobon |
| GQ | BN | Provincia Bioko Norte |
| GQ | BS | Provincia Bioko Sur |
| GQ | CS | Provincia Centro Sur |
| GQ | KN | Provincia Kie-Ntem |
| GQ | LI | Provincia Litoral |
| GQ | WN | Provincia Wele-Nzas |
| GQ | C | Région Continentale |
| GQ | DJ | Djibloho |
| GQ | I | Región Insular |
| ER | MA | Central (Maekel) |
| ER | SK | Northern Red Sea (Semien-Keih-Bahri) |
| ER | DK | Southern Red Sea (Debub-Keih-Bahri) |
| ER | AN | ‘Anseba |
| ER | DU | Debub |
| ER | GB | Qāsh-Barkah |
| EE | 130 | Alutaguse |
| EE | 141 | Anija |
| EE | 142 | Antsla |
| EE | 171 | Elva |
| EE | 184 | Haapsalu |
| EE | 191 | Haljala |
| EE | 198 | Harku |
| EE | 205 | Hiiumaa |
| EE | 214 | Häädemeeste |
| EE | 245 | Jõelähtme |
| EE | 247 | Jõgeva |
| EE | 251 | Jõhvi |
| EE | 255 | Järva |
| EE | 272 | Kadrina |
| EE | 283 | Kambja |
| EE | 284 | Kanepi |
| EE | 291 | Kastre |
| EE | 293 | Kehtna |
| EE | 296 | Keila |
| EE | 303 | Kihnu |
| EE | 305 | Kiili |
| EE | 317 | Kohila |
| EE | 321 | Kohtla-Järve |
| EE | 338 | Kose |
| EE | 353 | Kuusalu |
| EE | 37 | Harjumaa |
| EE | 39 | Hiiumaa |
| EE | 424 | Loksa |
| EE | 430 | Lääneranna |
| EE | 431 | Lääne-Harju |
| EE | 432 | Luunja |
| EE | 441 | Lääne-Nigula |
| EE | 442 | Lüganuse |
| EE | 446 | Maardu |
| EE | 45 | Ida-Virumaa |
| EE | 478 | Muhu |
| EE | 480 | Mulgi |
| EE | 486 | Mustvee |
| EE | 50 | Jõgevamaa |
| EE | 503 | Märjamaa |
| EE | 511 | Narva |
| EE | 514 | Narva-Jõesuu |
| EE | 52 | Järvamaa |
| EE | 528 | Nõo |
| EE | 557 | Otepää |
| EE | 56 | Läänemaa |
| EE | 567 | Paide |
| EE | 586 | Peipsiääre |
| EE | 60 | Lääne-Virumaa |
| EE | 615 | Põhja-Sakala |
| EE | 618 | Põltsamaa |
| EE | 622 | Põlva |
| EE | 624 | Pärnu |
| EE | 638 | Põhja-Pärnumaa |
| EE | 64 | Põlvamaa |
| EE | 651 | Raasiku |
| EE | 653 | Rae |
| EE | 661 | Rakvere |
| EE | 663 | Rakvere |
| EE | 668 | Rapla |
| EE | 68 | Pärnumaa |
| EE | 689 | Ruhnu |
| EE | 698 | Rõuge |
| EE | 708 | Räpina |
| EE | 71 | Raplamaa |
| EE | 712 | Saarde |
| EE | 714 | Saaremaa |
| EE | 719 | Saku |
| EE | 726 | Saue |
| EE | 732 | Setomaa |
| EE | 735 | Sillamäe |
| EE | 74 | Saaremaa |
| EE | 784 | Tallinn |
| EE | 79 | Tartumaa |
| EE | 792 | Tapa |
| EE | 793 | Tartu |
| EE | 796 | Tartu |
| EE | 803 | Toila |
| EE | 809 | Tori |
| EE | 81 | Valgamaa |
| EE | 824 | Tõrva |
| EE | 834 | Türi |
| EE | 84 | Viljandimaa |
| EE | 855 | Valga |
| EE | 87 | Võrumaa |
| EE | 890 | Viimsi |
| EE | 897 | Viljandi |
| EE | 899 | Viljandi |
| EE | 901 | Vinni |
| EE | 903 | Viru-Nigula |
| EE | 907 | Vormsi |
| EE | 917 | Võru |
| EE | 919 | Võru |
| EE | 928 | Väike-Maarja |
| ET | AA | Addis Ababa |
| ET | AF | Afar |
| ET | DD | Dire Dawa |
| ET | OR | Oromia |
| ET | SO | Somali |
| ET | SN | Southern Nations - Nationalities and Peoples Region |
| ET | TI | Tigray |
| ET | AM | Āmara |
| ET | BE | Bīnshangul Gumuz |
| ET | GA | Gambela Peoples |
| ET | HA | Hārerī Hizb |
| FJ | C | Central Division |
| FJ | E | Eastern Division |
| FJ | N | Northern Division |
| FJ | R | Rotuma |
| FJ | W | Western Division |
| FJ | 01 | Ba |
| FJ | 02 | Bua |
| FJ | 03 | Cakaudrove |
| FJ | 04 | Kadavu |
| FJ | 05 | Lau |
| FJ | 06 | Lomaiviti |
| FJ | 07 | Macuata |
| FJ | 08 | Nadroga and Navosa |
| FJ | 09 | Naitasiri |
| FJ | 10 | Namosi |
| FJ | 11 | Ra |
| FJ | 12 | Rewa |
| FJ | 13 | Serua |
| FJ | 14 | Tailevu |
| FI | 01 | Landskapet Åland |
| FI | 02 | Södra Karelen |
| FI | 03 | Södra Österbotten |
| FI | 04 | Södra Savolax |
| FI | 05 | Kajanaland |
| FI | 06 | Kanta-Häme |
| FI | 07 | Mellersta Österbotten |
| FI | 08 | Mellersta Finland |
| FI | 09 | Kymmenedalen |
| FI | 10 | Lappland |
| FI | 11 | Pirkanmaa |
| FI | 12 | Pohjanmaa |
| FI | 13 | Pohjois-Karjala |
| FI | 14 | Pohjois-Pohjanmaa |
| FI | 15 | Pohjois-Savo |
| FI | 16 | Päijät-Häme |
| FI | 17 | Satakunta |
| FI | 18 | Uusimaa |
| FI | 19 | Varsinais-Suomi |
| FR | 20R | Corse |
| FR | 01 | Ain |
| FR | 02 | Aisne |
| FR | 03 | Allier |
| FR | 04 | Alpes-de-Haute-Provence |
| FR | 05 | Hautes-Alpes |
| FR | 06 | Alpes-Maritimes |
| FR | 07 | Ardèche |
| FR | 08 | Ardennes |
| FR | 09 | Ariège |
| FR | 10 | Aube |
| FR | 11 | Aude |
| FR | 12 | Aveyron |
| FR | 13 | Bouches-du-Rhône |
| FR | 14 | Calvados |
| FR | 15 | Cantal |
| FR | 16 | Charente |
| FR | 17 | Charente-Maritime |
| FR | 18 | Cher |
| FR | 19 | Corrèze |
| FR | 21 | Côte-d’Or |
| FR | 22 | Côtes-d’Armor |
| FR | 23 | Creuse |
| FR | 24 | Dordogne |
| FR | 25 | Doubs |
| FR | 26 | Drôme |
| FR | 27 | Eure |
| FR | 28 | Eure-et-Loir |
| FR | 29 | Finistère |
| FR | 2A | Corse-du-Sud |
| FR | 2B | Haute-Corse |
| FR | 30 | Gard |
| FR | 31 | Haute-Garonne |
| FR | 32 | Gers |
| FR | 33 | Gironde |
| FR | 34 | Hérault |
| FR | 35 | Ille-et-Vilaine |
| FR | 36 | Indre |
| FR | 37 | Indre-et-Loire |
| FR | 38 | Isère |
| FR | 39 | Jura |
| FR | 40 | Landes |
| FR | 41 | Loir-et-Cher |
| FR | 42 | Loire |
| FR | 43 | Haute-Loire |
| FR | 44 | Loire-Atlantique |
| FR | 45 | Loiret |
| FR | 46 | Lot |
| FR | 47 | Lot-et-Garonne |
| FR | 48 | Lozère |
| FR | 49 | Maine-et-Loire |
| FR | 50 | Manche |
| FR | 51 | Marne |
| FR | 52 | Haute-Marne |
| FR | 53 | Mayenne |
| FR | 54 | Meurthe-et-Moselle |
| FR | 55 | Meuse |
| FR | 56 | Morbihan |
| FR | 57 | Moselle |
| FR | 58 | Nièvre |
| FR | 59 | Nord |
| FR | 60 | Oise |
| FR | 61 | Orne |
| FR | 62 | Pas-de-Calais |
| FR | 63 | Puy-de-Dôme |
| FR | 64 | Pyrénées-Atlantiques |
| FR | 65 | Hautes-Pyrénées |
| FR | 66 | Pyrénées-Orientales |
| FR | 67 | Bas-Rhin |
| FR | 68 | Haut-Rhin |
| FR | 69 | Rhône |
| FR | 70 | Haute-Saône |
| FR | 71 | Saône-et-Loire |
| FR | 72 | Sarthe |
| FR | 73 | Savoie |
| FR | 74 | Haute-Savoie |
| FR | 75 | Paris |
| FR | 76 | Seine-Maritime |
| FR | 77 | Seine-et-Marne |
| FR | 78 | Yvelines |
| FR | 79 | Deux-Sèvres |
| FR | 80 | Somme |
| FR | 81 | Tarn |
| FR | 82 | Tarn-et-Garonne |
| FR | 83 | Var |
| FR | 84 | Vaucluse |
| FR | 85 | Vendée |
| FR | 86 | Vienne |
| FR | 87 | Haute-Vienne |
| FR | 88 | Vosges |
| FR | 89 | Yonne |
| FR | 90 | Territoire de Belfort |
| FR | 91 | Essonne |
| FR | 92 | Hauts-de-Seine |
| FR | 93 | Seine-Saint-Denis |
| FR | 94 | Val-de-Marne |
| FR | 95 | Val-d’Oise |
| FR | 971 | Guadeloupe |
| FR | 972 | Martinique |
| FR | 973 | Guyane (française) |
| FR | 974 | La Réunion |
| FR | 976 | Mayotte |
| FR | ARA | Auvergne-Rhône-Alpes |
| FR | BFC | Bourgogne-Franche-Comté |
| FR | BL | Saint-Barthélemy (see also separate country code entry under BL) |
| FR | BRE | Bretagne |
| FR | CP | Clipperton |
| FR | CVL | Centre-Val de Loire |
| FR | GES | Grand-Est |
| FR | GF | Guyane (française) (see also separate country code entry under GF) |
| FR | GP | Guadeloupe (see also separate country code entry under GP) |
| FR | HDF | Hauts-de-France |
| FR | IDF | Île-de-France |
| FR | MF | Saint-Martin (see also separate country code entry under MF) |
| FR | MQ | Martinique (see also separate country code entry under MQ) |
| FR | NAQ | Nouvelle-Aquitaine |
| FR | NC | Nouvelle-Calédonie (see also separate country code entry under NC) |
| FR | NOR | Normandie |
| FR | OCC | Occitanie |
| FR | PAC | Provence-Alpes-Côte-d’Azur |
| FR | PDL | Pays-de-la-Loire |
| FR | PF | Polynésie française (see also separate country code entry under PF) |
| FR | PM | Saint-Pierre-et-Miquelon (see also separate country code entry under PM) |
| FR | RE | La Réunion (see also separate country code entry under RE) |
| FR | TF | Terres australes françaises (see also separate country code entry under TF) |
| FR | WF | Wallis-et-Futuna (see also separate country code entry under WF) |
| FR | YT | Mayotte (see also separate country code entry under YT) |
| GA | 1 | Estuaire |
| GA | 2 | Haut-Ogooue |
| GA | 3 | Moyen-Ogooue |
| GA | 4 | Ngounie |
| GA | 5 | Nyanga |
| GA | 6 | Ogooue-Ivindo |
| GA | 7 | Ogooue-Lolo |
| GA | 8 | Ogooue-Maritime |
| GA | 9 | Woleu-Ntem |
| GM | B | Banjul |
| GM | M | Central River |
| GM | L | Lower River |
| GM | N | North Bank |
| GM | U | Upper River |
| GM | W | Western |
| GE | AB | Abkhazia |
| GE | AJ | Ajaria |
| GE | GU | Guria |
| GE | IM | Imereti |
| GE | KA | Kakheti |
| GE | KK | Kvemo Kartli |
| GE | MM | Mtskheta-Mtianeti |
| GE | RL | Racha Lechkhumi and Kvemo Svanet |
| GE | SZ | Samegrelo-Zemo Svaneti |
| GE | SJ | Samtskhe-Javakheti |
| GE | SK | Shida Kartli |
| GE | TB | Tbilisi |
| DE | BY | Bayern |
| DE | BE | Berlin |
| DE | BB | Brandenburg |
| DE | HB | Bremen |
| DE | HH | Hamburg |
| DE | HE | Hessen |
| DE | MV | Mecklenburg-Vorpommern |
| DE | NI | Niedersachsen |
| DE | NW | Nordrhein-Westfalen |
| DE | RP | Rheinland-Pfalz |
| DE | RP | Rhineland-Palatinate |
| DE | SL | Saarland |
| DE | SN | Sachsen |
| DE | ST | Sachsen-Anhalt |
| DE | SH | Schleswig-Holstein |
| DE | TH | Thüringen |
| DE | BW | Baden-Württemberg |
| GH | UE | Upper East Region |
| GH | UW | Upper West Region |
| GH | AA | Greater Accra |
| GH | AF | Ahafo |
| GH | AH | Ashanti |
| GH | BE | Bono East |
| GH | BO | Bono |
| GH | CP | Central |
| GH | EP | Eastern |
| GH | NE | North East |
| GH | NP | Northern |
| GH | OT | Oti |
| GH | SV | Savannah |
| GH | TV | Volta |
| GH | WN | Western North |
| GH | WP | Western |
| GR | 69 | Ágion Óros |
| GR | A | Anatolikí Makedonía kai Thráki |
| GR | B | Kentrikí Makedonía |
| GR | C | Dytikí Makedonía |
| GR | D | Ípeiros |
| GR | E | Thessalía |
| GR | F | Ionía Nísia |
| GR | G | Dytikí Elláda |
| GR | H | Stereá Elláda |
| GR | I | Attikí |
| GR | J | Pelopónnisos |
| GR | K | Vóreio Aigaío |
| GR | L | Nótio Aigaío |
| GR | M | Kríti |
| GL | AV | Avannaata Kommunia |
| GL | KU | Kommune Kujalleq |
| GL | QE | Qeqqata Kommunia |
| GL | QT | Kommune Qeqertalik |
| GL | SM | Kommuneqarfik Sermersooq |
| GD | 01 | Saint Andrew |
| GD | 02 | Saint David |
| GD | 03 | Saint George |
| GD | 04 | Saint John |
| GD | 05 | Saint Mark |
| GD | 06 | Saint Patrick |
| GD | 10 | Southern Grenadine Islands |
| GT | AV | Alta Verapaz |
| GT | BV | Baja Verapaz |
| GT | CM | Chimaltenango |
| GT | CQ | Chiquimula |
| GT | PE | El Peten |
| GT | PR | El Progreso |
| GT | QC | El Quiche |
| GT | ES | Escuintla |
| GT | GU | Guatemala |
| GT | HU | Huehuetenango |
| GT | IZ | Izabal |
| GT | JA | Jalapa |
| GT | JU | Jutiapa |
| GT | QZ | Quetzaltenango |
| GT | RE | Retalhuleu |
| GT | SA | Sacatepequez |
| GT | SM | San Marcos |
| GT | SR | Santa Rosa |
| GT | SO | Solola |
| GT | SU | Suchitepequez |
| GT | TO | Totonicapan |
| GT | ZA | Zacapa |
| GN | BE | Beyla |
| GN | BF | Boffa |
| GN | B | Boke |
| GN | C | Conakry |
| GN | CO | Coyah |
| GN | DB | Dabola |
| GN | DL | Dalaba |
| GN | DI | Dinguiraye |
| GN | DU | Dubreka |
| GN | F | Faranah |
| GN | FO | Forecariah |
| GN | FR | Fria |
| GN | GA | Gaoual |
| GN | K | Kankan |
| GN | KE | Kerouane |
| GN | D | Kindia |
| GN | KS | Kissidougou |
| GN | KB | Koubia |
| GN | KN | Koundara |
| GN | KO | Kouroussa |
| GN | L | Labe |
| GN | LE | Lelouma |
| GN | LO | Lola |
| GN | MC | Macenta |
| GN | ML | Mali |
| GN | M | Mamou |
| GN | MD | Mandiana |
| GN | N | Nzerekore |
| GN | PI | Pita |
| GN | SI | Siguiri |
| GN | TE | Telimele |
| GN | TO | Tougue |
| GN | YO | Yomou |
| GN | GU | Guékédou |
| GW | BS | Bissau Region |
| GW | BL | Bolama Region |
| GW | CA | Cacheu Region |
| GW | GA | Gabu Region |
| GW | OI | Oio Region |
| GW | QU | Quinara Region |
| GW | TO | Tombali Region |
| GW | BA | Bafatá |
| GW | BM | Biombo |
| GW | L | Leste |
| GW | N | Norte |
| GW | S | Sul |
| GY | BA | Barima-Waini |
| GY | CU | Cuyuni-Mazaruni |
| GY | DE | Demerara-Mahaica |
| GY | EB | East Berbice-Corentyne |
| GY | ES | Essequibo Islands-West Demerara |
| GY | MA | Mahaica-Berbice |
| GY | PM | Pomeroon-Supenaam |
| GY | PT | Potaro-Siparuni |
| GY | UD | Upper Demerara-Berbice |
| GY | UT | Upper Takutu-Upper Essequibo |
| HT | AR | Artibonite |
| HT | CE | Centre |
| HT | GA | Grand’Anse |
| HT | ND | Nord |
| HT | NE | Nord-Est |
| HT | NO | Nord-Ouest |
| HT | OU | Ouest |
| HT | SD | Sud |
| HT | SE | Sud-Est |
| HT | NI | Nippes |
| HN | AT | Atlantida |
| HN | CH | Choluteca |
| HN | CL | Colon |
| HN | CM | Comayagua |
| HN | CP | Copan |
| HN | CR | Cortes |
| HN | EP | El Paraiso |
| HN | FM | Francisco Morazan |
| HN | GD | Gracias a Dios |
| HN | IN | Intibuca |
| HN | IB | Islas de la Bahia (Bay Islands) |
| HN | LP | La Paz |
| HN | LE | Lempira |
| HN | OC | Ocotepeque |
| HN | OL | Olancho |
| HN | SB | Santa Barbara |
| HN | VA | Valle |
| HN | YO | Yoro |
| HU | BK | Bacs-Kiskun |
| HU | BA | Baranya |
| HU | BE | Bekes |
| HU | BC | Bekescsaba |
| HU | BZ | Borsod-Abauj-Zemplen |
| HU | BU | Budapest |
| HU | CS | Csongrad |
| HU | DE | Debrecen |
| HU | DU | Dunaujvaros |
| HU | EG | Eger |
| HU | FE | Fejer |
| HU | GY | Gyor |
| HU | GS | Gyor-Moson-Sopron |
| HU | HB | Hajdu-Bihar |
| HU | HE | Heves |
| HU | HV | Hodmezovasarhely |
| HU | JN | Jasz-Nagykun-Szolnok |
| HU | KV | Kaposvar |
| HU | KM | Kecskemet |
| HU | KE | Komarom-Esztergom |
| HU | MI | Miskolc |
| HU | NK | Nagykanizsa |
| HU | NO | Nograd |
| HU | NY | Nyiregyhaza |
| HU | PE | Pecs |
| HU | PE | Pest |
| HU | SO | Somogy |
| HU | SN | Sopron |
| HU | SZ | Szabolcs-Szatmar-Bereg |
| HU | SZ | Szeged |
| HU | SF | Szekesfehervar |
| HU | SK | Szolnok |
| HU | SH | Szombathely |
| HU | TB | Tatabanya |
| HU | TO | Tolna |
| HU | VA | Vas |
| HU | VE | Veszprem |
| HU | ZA | Zala |
| HU | ZE | Zalaegerszeg |
| HU | ER | Érd |
| HU | ST | Salgótarján |
| IS | 7 | Austurland |
| IS | 3 | Vesturland |
| IS | 1 | Höfuðborgarsvæði |
| IS | 2 | Suðurnes |
| IS | 4 | Vestfirðir |
| IS | 5 | Norðurland vestra |
| IS | 6 | Norðurland eystra |
| IS | 8 | Suðurland |
| IS | AKH | Akrahreppur |
| IS | AKN | Akraneskaupstaður |
| IS | AKU | Akureyrarbær |
| IS | ARN | Árneshreppur |
| IS | ASA | Ásahreppur |
| IS | BFJ | Borgarfjarðarhreppur |
| IS | BLA | Bláskógabyggð |
| IS | BLO | Blönduósbær |
| IS | BOG | Borgarbyggð |
| IS | BOL | Bolungarvíkurkaupstaður |
| IS | DAB | Dalabyggð |
| IS | DAV | Dalvíkurbyggð |
| IS | DJU | Djúpavogshreppur |
| IS | EOM | Eyja- og Miklaholtshreppur |
| IS | EYF | Eyjafjarðarsveit |
| IS | FJD | Fjarðabyggð |
| IS | FJL | Fjallabyggð |
| IS | FLA | Flóahreppur |
| IS | FLD | Fljótsdalshérað |
| IS | FLR | Fljótsdalshreppur |
| IS | GAR | Garðabær |
| IS | GOG | Grímsnes- og Grafningshreppur |
| IS | GRN | Grindavíkurbær |
| IS | GRU | Grundarfjarðarbær |
| IS | GRY | Grýtubakkahreppur |
| IS | HAF | Hafnarfjarðarkaupstaður |
| IS | HEL | Helgafellssveit |
| IS | HRG | Hörgársveit |
| IS | HRU | Hrunamannahreppur |
| IS | HUT | Húnavatnshreppur |
| IS | HUV | Húnaþing vestra |
| IS | HVA | Hvalfjarðarsveit |
| IS | HVE | Hveragerðisbær |
| IS | ISA | Ísafjarðarbær |
| IS | KAL | Kaldrananeshreppur |
| IS | KJO | Kjósarhreppur |
| IS | KOP | Kópavogsbær |
| IS | LAN | Langanesbyggð |
| IS | MOS | Mosfellsbær |
| IS | MYR | Mýrdalshreppur |
| IS | NOR | Norðurþing |
| IS | RGE | Rangárþing eystra |
| IS | RGY | Rangárþing ytra |
| IS | RHH | Reykhólahreppur |
| IS | RKN | Reykjanesbær |
| IS | RKV | Reykjavíkurborg |
| IS | SBH | Svalbarðshreppur |
| IS | SBT | Svalbarðsstrandarhreppur |
| IS | SDN | Suðurnesjabær |
| IS | SDV | Súðavíkurhreppur |
| IS | SEL | Seltjarnarnesbær |
| IS | SEY | Seyðisfjarðarkaupstaður |
| IS | SFA | Sveitarfélagið Árborg |
| IS | SHF | Sveitarfélagið Hornafjörður |
| IS | SKF | Skaftárhreppur |
| IS | SKG | Skagabyggð |
| IS | SKO | Skorradalshreppur |
| IS | SKU | Skútustaðahreppur |
| IS | SNF | Snæfellsbær |
| IS | SOG | Skeiða- og Gnúpverjahreppur |
| IS | SOL | Sveitarfélagið Ölfus |
| IS | SSF | Sveitarfélagið Skagafjörður |
| IS | SSS | Sveitarfélagið Skagaströnd |
| IS | STR | Strandabyggð |
| IS | STY | Stykkishólmsbær |
| IS | SVG | Sveitarfélagið Vogar |
| IS | TAL | Tálknafjarðarhreppur |
| IS | THG | Þingeyjarsveit |
| IS | TJO | Tjörneshreppur |
| IS | VEM | Vestmannaeyjabær |
| IS | VER | Vesturbyggð |
| IS | VOP | Vopnafjarðarhreppur |
| IN | AN | Andaman and Nicobar Islands |
| IN | AP | Andhra Pradesh |
| IN | AR | Arunāchal Pradesh |
| IN | AS | Assam |
| IN | CH | Chandīgarh |
| IN | CT | Chhattīsgarh |
| IN | DH | Dādra and Nagar Haveli and Damān and Diu |
| IN | GA | Goa |
| IN | HP | Himāchal Pradesh |
| IN | HR | Haryāna |
| IN | JH | Jhārkhand |
| IN | JK | Jammu and Kashmīr |
| IN | KL | Kerala |
| IN | LA | Ladākh |
| IN | LD | Lakshadweep |
| IN | MH | Mahārāshtra |
| IN | ML | Meghālaya |
| IN | MN | Manipur |
| IN | MP | Madhya Pradesh |
| IN | MZ | Mizoram |
| IN | NL | Nāgāland |
| IN | OR | Odisha |
| IN | PB | Punjab |
| IN | PY | Puducherry |
| IN | RJ | Rājasthān |
| IN | TG | Telangāna |
| IN | TN | Tamil Nādu |
| IN | UP | Uttar Pradesh |
| IN | UT | Uttarākhand |
| IN | WB | West Bengal |
| ID | AC | Aceh |
| ID | BA | Bali |
| ID | BT | Banten |
| ID | BE | Bengkulu |
| ID | GO | Gorontalo |
| ID | JK | Jakarta Raya |
| ID | JA | Jambi |
| ID | JB | Jawa Barat |
| ID | JT | Jawa Tengah |
| ID | JI | Jawa Timur |
| ID | KB | Kalimantan Barat |
| ID | KS | Kalimantan Selatan |
| ID | KT | Kalimantan Tengah |
| ID | KI | Kalimantan Timur |
| ID | BB | Kepulauan Bangka Belitung |
| ID | LA | Lampung |
| ID | ML | Maluku |
| ID | MU | Maluku Utara |
| ID | NB | Nusa Tenggara Barat |
| ID | NT | Nusa Tenggara Timur |
| ID | PP | Papua |
| ID | RI | Riau |
| ID | SN | Sulawesi Selatan |
| ID | ST | Sulawesi Tengah |
| ID | SG | Sulawesi Tenggara |
| ID | SA | Sulawesi Utara |
| ID | SB | Sumatera Barat |
| ID | SS | Sumatera Selatan |
| ID | SU | Sumatera Utara |
| ID | YO | Yogyakarta |
| ID | JW | Jawa |
| ID | KA | Kalimantan |
| ID | KR | Kepulauan Riau |
| ID | KU | Kalimantan Utara |
| ID | NU | Nusa Tenggara |
| ID | PB | Papua Barat |
| ID | SL | Sulawesi |
| ID | SM | Sumatera |
| ID | SR | Sulawesi Barat |
| IR | 24 | Ardabil |
| IR | 18 | Bushehr |
| IR | 10 | Esfahan |
| IR | 07 | Fars |
| IR | 01 | Gilan |
| IR | 27 | Golestan |
| IR | 13 | Hamadan |
| IR | 22 | Hormozgan |
| IR | 16 | Ilam |
| IR | 08 | Kerman |
| IR | 05 | Kermanshah |
| IR | 06 | Khuzestan |
| IR | 15 | Lorestan |
| IR | 00 | Markazi |
| IR | 02 | Mazandaran |
| IR | 26 | Qazvin |
| IR | 25 | Qom |
| IR | 20 | Semnan |
| IR | 23 | Tehran |
| IR | 21 | Yazd |
| IR | 19 | Zanjan |
| IR | 03 | Āz̄ārbāyjān-e Shārqī |
| IR | 04 | Āz̄ārbāyjān-e Ghārbī |
| IR | 09 | Khorāsān-e Raẕavī |
| IR | 11 | Sīstān va Balūchestān |
| IR | 12 | Kordestān |
| IR | 14 | Chahār Maḩāl va Bakhtīārī |
| IR | 17 | Kohgīlūyeh va Bowyer Aḩmad |
| IR | 28 | Khorāsān-e Shomālī |
| IR | 29 | Khorāsān-e Jonūbī |
| IR | 30 | Alborz |
| IQ | AN | Al Anbar |
| IQ | BA | Al Basrah |
| IQ | MU | Al Muthanna |
| IQ | QA | Al Qadisyah |
| IQ | NA | An Najaf |
| IQ | AR | Arbil |
| IQ | SU | As Sulaymaniyah |
| IQ | BB | Babil |
| IQ | BG | Baghdad |
| IQ | DA | Dahuk |
| IQ | DQ | Dhi Qar |
| IQ | DI | Diyala |
| IQ | MA | Maysan |
| IQ | NI | Ninawa |
| IQ | SD | Salah ad Din |
| IQ | WA | Wasit |
| IQ | KA | Karbalā’ |
| IQ | KI | Kirkūk |
| IE | CW | Carlow |
| IE | CN | Cavan |
| IE | CE | Clare |
| IE | CO | Cork |
| IE | DL | Donegal |
| IE | D | Dublin |
| IE | G | Galway |
| IE | KE | Kerry |
| IE | KE | Kildare |
| IE | KK | Kilkenny |
| IE | LS | Laois |
| IE | LM | Leitrim |
| IE | LK | Limerick |
| IE | LD | Longford |
| IE | LH | Louth |
| IE | MO | Mayo |
| IE | MH | Meath |
| IE | MO | Monaghan |
| IE | OY | Offaly |
| IE | RN | Roscommon |
| IE | SO | Sligo |
| IE | TA | Tipperary |
| IE | WD | Waterford |
| IE | WH | Westmeath |
| IE | WX | Wexford |
| IE | WW | Wicklow |
| IE | C | Connaught |
| IE | L | Leinster |
| IE | M | Munster |
| IE | U | Ulster |
| IL | HA | Haifa |
| IL | JM | Jehuda Mountains |
| IL | TA | Tel Aviv (Gosh Dan) |
| IL | D | Ha Darom |
| IL | M | Ha Merkaz |
| IL | Z | Ha Tsafon |
| IT | AG | Agrigento |
| IT | AL | Alessandria |
| IT | AN | Ancona |
| IT | AR | Arezzo |
| IT | AP | Ascoli Piceno |
| IT | AT | Asti |
| IT | AV | Avellino |
| IT | BA | Bari |
| IT | BL | Belluno |
| IT | BN | Benevento |
| IT | BG | Bergamo |
| IT | BI | Biella |
| IT | BO | Bologna |
| IT | BZ | Bolzano |
| IT | BS | Brescia |
| IT | BR | Brindisi |
| IT | CA | Cagliari |
| IT | CL | Caltanissetta |
| IT | CB | Campobasso |
| IT | CE | Caserta |
| IT | CT | Catania |
| IT | CZ | Catanzaro |
| IT | CH | Chieti |
| IT | CO | Como |
| IT | CS | Cosenza |
| IT | CR | Cremona |
| IT | KR | Crotone |
| IT | CN | Cuneo |
| IT | EN | Enna |
| IT | FE | Ferrara |
| IT | FI | Firenze |
| IT | FG | Foggia |
| IT | FC | Forli-Cesena |
| IT | FR | Frosinone |
| IT | GE | Genova |
| IT | GO | Gorizia |
| IT | GR | Grosseto |
| IT | IM | Imperia |
| IT | IS | Isernia |
| IT | AQ | L’Aquila |
| IT | SP | La Spezia |
| IT | LT | Latina |
| IT | LE | Lecce |
| IT | LC | Lecco |
| IT | LI | Livorno |
| IT | LO | Lodi |
| IT | LU | Lucca |
| IT | MC | Macerata |
| IT | MN | Mantova |
| IT | MS | Massa-Carrara |
| IT | MT | Matera |
| IT | ME | Messina |
| IT | MI | Milano |
| IT | MO | Modena |
| IT | NA | Napoli |
| IT | NO | Novara |
| IT | NU | Nuoro |
| IT | OR | Oristano |
| IT | PD | Padova |
| IT | PA | Palermo |
| IT | PR | Parma |
| IT | PV | Pavia |
| IT | PG | Perugia |
| IT | PU | Pesaro e Urbino |
| IT | PE | Pescara |
| IT | PC | Piacenza |
| IT | PI | Pisa |
| IT | PT | Pistoia |
| IT | PN | Pordenone |
| IT | PZ | Potenza |
| IT | PO | Prato |
| IT | RG | Ragusa |
| IT | RA | Ravenna |
| IT | RC | Reggio Calabria |
| IT | RE | Reggio Emilia |
| IT | RI | Rieti |
| IT | RN | Rimini |
| IT | RM | Roma |
| IT | RO | Rovigo |
| IT | SA | Salerno |
| IT | SS | Sassari |
| IT | SV | Savona |
| IT | SI | Siena |
| IT | SR | Siracusa |
| IT | SO | Sondrio |
| IT | TA | Taranto |
| IT | TE | Teramo |
| IT | TR | Terni |
| IT | TO | Torino |
| IT | TP | Trapani |
| IT | TN | Trento |
| IT | TV | Treviso |
| IT | TS | Trieste |
| IT | UD | Udine |
| IT | VA | Varese |
| IT | VE | Venezia |
| IT | VB | Verbano-Cusio-Ossola |
| IT | VC | Vercelli |
| IT | VR | Verona |
| IT | VV | Vibo Valentia |
| IT | VI | Vicenza |
| IT | VT | Viterbo |
| IT | 21 | Piemonte |
| IT | 23 | Valle d’Aosta |
| IT | 25 | Lombardia |
| IT | 32 | Trentino-Südtirol |
| IT | 34 | Veneto |
| IT | 36 | Friuli Venezia Giulia |
| IT | 42 | Liguria |
| IT | 45 | Emilia-Romagna |
| IT | 52 | Toscana |
| IT | 55 | Umbria |
| IT | 57 | Marche |
| IT | 62 | Lazio |
| IT | 65 | Abruzzo |
| IT | 67 | Molise |
| IT | 72 | Campania |
| IT | 75 | Puglia |
| IT | 77 | Basilicata |
| IT | 78 | Calabria |
| IT | 82 | Sicilia |
| IT | 88 | Sardegna |
| IT | BT | Barletta-Andria-Trani |
| IT | FM | Fermo |
| IT | MB | Monza e Brianza |
| IT | SU | Sud Sardegna |
| JM | 01 | Kingston |
| JM | 02 | Saint Andrew |
| JM | 03 | Saint Thomas |
| JM | 04 | Portland |
| JM | 05 | Saint Mary |
| JM | 06 | Saint Ann |
| JM | 07 | Trelawny |
| JM | 08 | Saint James |
| JM | 09 | Hanover |
| JM | 10 | Westmoreland |
| JM | 11 | Saint Elizabeth |
| JM | 12 | Manchester |
| JM | 13 | Clarendon |
| JM | 14 | Saint Catherine |
| JP | 23 | Aichi |
| JP | 05 | Akita |
| JP | 02 | Aomori |
| JP | 12 | Chiba |
| JP | 38 | Ehime |
| JP | 18 | Fukui |
| JP | 40 | Fukuoka |
| JP | 07 | Fukushima |
| JP | 21 | Gifu |
| JP | 34 | Hiroshima |
| JP | 01 | Hokkaido |
| JP | 28 | Hyogo |
| JP | 08 | Ibaraki |
| JP | 17 | Ishikawa |
| JP | 03 | Iwate |
| JP | 37 | Kagawa |
| JP | 46 | Kagoshima |
| JP | 14 | Kanagawa |
| JP | 39 | Kochi |
| JP | 43 | Kumamoto |
| JP | 26 | Kyoto |
| JP | 24 | Mie |
| JP | 04 | Miyagi |
| JP | 45 | Miyazaki |
| JP | 20 | Nagano |
| JP | 42 | Nagasaki |
| JP | 29 | Nara |
| JP | 15 | Niigata |
| JP | 44 | Oita |
| JP | 33 | Okayama |
| JP | 47 | Okinawa |
| JP | 27 | Osaka |
| JP | 41 | Saga |
| JP | 11 | Saitama |
| JP | 25 | Shiga |
| JP | 32 | Shimane |
| JP | 22 | Shizuoka |
| JP | 09 | Tochigi |
| JP | 36 | Tokushima |
| JP | 13 | Tokyo |
| JP | 31 | Tottori |
| JP | 16 | Toyama |
| JP | 30 | Wakayama |
| JP | 06 | Yamagata |
| JP | 35 | Yamaguchi |
| JP | 19 | Yamanashi |
| JP | 10 | Gunma |
| JO | AM | ‘Amman |
| JO | AJ | Ajlun |
| JO | KA | Al Karak |
| JO | MA | Al Mafraq |
| JO | AT | At Tafilah |
| JO | AZ | Az Zarqa’ |
| JO | IR | Irbid |
| JO | JA | Jarash |
| JO | MA | Ma’an |
| JO | MD | Madaba |
| JO | AQ | Al ‘Aqabah |
| JO | BA | Al Balqā’ |
| JO | MN | Ma‘ān |
| KZ | ALA | Almaty |
| KZ | AKM | Aqmola oblysy |
| KZ | AKT | Aqtöbe oblysy |
| KZ | ALM | Almaty oblysy |
| KZ | AST | Nur-Sultan |
| KZ | ATY | Atyrauskaya oblast’ |
| KZ | KAR | Qaraghandy oblysy |
| KZ | KUS | Qostanay oblysy |
| KZ | KZY | Qyzylorda oblysy |
| KZ | MAN | Mangystauskaja oblast’ |
| KZ | PAV | Pavlodarskaya oblast’ |
| KZ | SEV | Soltüstik Qazaqstan oblysy |
| KZ | SHY | Šimkent |
| KZ | VOS | Vostočno-Kazahstanskaja oblast’ |
| KZ | YUZ | Türkistan oblysy |
| KZ | ZAP | Zapadno-Kazakhstanskaya oblast’ |
| KZ | ZHA | Zhambylskaya oblast’ |
| KE | 01 | Baringo |
| KE | 02 | Bomet |
| KE | 03 | Bungoma |
| KE | 04 | Busia |
| KE | 05 | Elgeyo/Marakwet |
| KE | 06 | Embu |
| KE | 07 | Garissa |
| KE | 08 | Homa Bay |
| KE | 09 | Isiolo |
| KE | 10 | Kajiado |
| KE | 11 | Kakamega |
| KE | 12 | Kericho |
| KE | 13 | Kiambu |
| KE | 14 | Kilifi |
| KE | 15 | Kirinyaga |
| KE | 16 | Kisii |
| KE | 17 | Kisumu |
| KE | 18 | Kitui |
| KE | 19 | Kwale |
| KE | 20 | Laikipia |
| KE | 21 | Lamu |
| KE | 22 | Machakos |
| KE | 23 | Makueni |
| KE | 24 | Mandera |
| KE | 25 | Marsabit |
| KE | 26 | Meru |
| KE | 27 | Migori |
| KE | 28 | Mombasa |
| KE | 29 | Murang’a |
| KE | 30 | Nairobi City |
| KE | 31 | Nakuru |
| KE | 32 | Nandi |
| KE | 33 | Narok |
| KE | 34 | Nyamira |
| KE | 35 | Nyandarua |
| KE | 36 | Nyeri |
| KE | 37 | Samburu |
| KE | 38 | Siaya |
| KE | 39 | Taita/Taveta |
| KE | 40 | Tana River |
| KE | 41 | Tharaka-Nithi |
| KE | 42 | Trans Nzoia |
| KE | 43 | Turkana |
| KE | 44 | Uasin Gishu |
| KE | 45 | Vihiga |
| KE | 46 | Wajir |
| KE | 47 | West Pokot |
| KI | G | Gilbert Islands |
| KI | L | Line Islands |
| KI | P | Phoenix Islands |
| KP | 04 | Chagang-do |
| KP | 09 | Hamgyong-bukto |
| KP | 08 | Hamgyong-namdo |
| KP | 06 | Hwanghae-bukto |
| KP | 05 | Hwanghae-namdo |
| KP | 07 | Kangwon-do |
| KP | 03 | P’yongan-bukto |
| KP | 02 | P’yongan-namdo |
| KP | 01 | Phyeongyang |
| KP | 10 | Ryangkangto |
| KP | 13 | Rasǒn |
| KP | 14 | Namp’o |
| KR | 11 | Seoul-teukbyeolsi |
| KR | 26 | Busan-gwangyeoksi |
| KR | 27 | Daegu-gwangyeoksi |
| KR | 28 | Incheon-gwangyeoksi |
| KR | 29 | Gwangju-gwangyeoksi |
| KR | 30 | Daejeon-gwangyeoksi |
| KR | 31 | Ulsan-gwangyeoksi |
| KR | 41 | Gyeonggi-do |
| KR | 42 | Gangwon-do |
| KR | 43 | Chungcheongbuk-do |
| KR | 44 | Chungcheongnam-do |
| KR | 45 | Jeollabuk-do |
| KR | 46 | Jeollanam-do |
| KR | 47 | Gyeongsangbuk-do |
| KR | 48 | Gyeongsangnam-do |
| KR | 49 | Jeju-teukbyeoljachido |
| KR | 50 | Sejong |
| KW | AH | Al Ahmadi |
| KW | FA | Al Farwaniyah |
| KW | HA | Hawalli |
| KW | JA | Al Jahrā’ |
| KW | KU | Al ‘Āşimah |
| KW | MU | Mubārak al Kabīr |
| KG | B | Batken |
| KG | GB | Bishkek |
| KG | C | Chu |
| KG | J | Jalal-Abad |
| KG | N | Naryn |
| KG | O | Osh |
| KG | T | Talas |
| KG | Y | Ysyk-Kol |
| KG | GO | Osh Shaary |
| LA | AT | Attapu |
| LA | BK | Bokeo |
| LA | BL | Bolikhamxai |
| LA | CH | Champasak |
| LA | HO | Houaphan |
| LA | KH | Khammouan |
| LA | LM | Louang Namtha |
| LA | LP | Louangphabang |
| LA | OU | Oudomxai |
| LA | PH | Phongsali |
| LA | SL | Salavan |
| LA | SV | Savannakhet |
| LA | VT | Vientiane |
| LA | XA | Xaignabouli |
| LA | XS | Xaisomboun |
| LA | XE | Xekong |
| LA | XI | Xiangkhoang |
| LV | DGV | Daugavpils |
| LV | JEL | Jelgava |
| LV | JUR | Jurmala |
| LV | LPX | Liepaja |
| LV | REZ | Rezekne |
| LV | RIX | Riga |
| LV | VEN | Ventspils |
| LV | 001 | Aglonas novads |
| LV | 002 | Aizkraukles novads |
| LV | 003 | Aizputes novads |
| LV | 004 | Aknīstes novads |
| LV | 005 | Alojas novads |
| LV | 006 | Alsungas novads |
| LV | 007 | Alūksnes novads |
| LV | 008 | Amatas novads |
| LV | 009 | Apes novads |
| LV | 010 | Auces novads |
| LV | 011 | Ādažu novads |
| LV | 012 | Babītes novads |
| LV | 013 | Baldones novads |
| LV | 014 | Baltinavas novads |
| LV | 015 | Balvu novads |
| LV | 016 | Bauskas novads |
| LV | 017 | Beverīnas novads |
| LV | 018 | Brocēnu novads |
| LV | 019 | Burtnieku novads |
| LV | 020 | Carnikavas novads |
| LV | 021 | Cesvaines novads |
| LV | 022 | Cēsu novads |
| LV | 023 | Ciblas novads |
| LV | 024 | Dagdas novads |
| LV | 025 | Daugavpils novads |
| LV | 026 | Dobeles novads |
| LV | 027 | Dundagas novads |
| LV | 028 | Durbes novads |
| LV | 029 | Engures novads |
| LV | 030 | Ērgļu novads |
| LV | 031 | Garkalnes novads |
| LV | 032 | Grobiņas novads |
| LV | 033 | Gulbenes novads |
| LV | 034 | Iecavas novads |
| LV | 035 | Ikšķiles novads |
| LV | 036 | Ilūkstes novads |
| LV | 037 | Inčukalna novads |
| LV | 038 | Jaunjelgavas novads |
| LV | 039 | Jaunpiebalgas novads |
| LV | 040 | Jaunpils novads |
| LV | 041 | Jelgavas novads |
| LV | 042 | Jēkabpils novads |
| LV | 043 | Kandavas novads |
| LV | 044 | Kārsavas novads |
| LV | 045 | Kocēnu novads |
| LV | 046 | Kokneses novads |
| LV | 047 | Krāslavas novads |
| LV | 048 | Krimuldas novads |
| LV | 049 | Krustpils novads |
| LV | 050 | Kuldīgas novads |
| LV | 051 | Ķeguma novads |
| LV | 052 | Ķekavas novads |
| LV | 053 | Lielvārdes novads |
| LV | 054 | Limbažu novads |
| LV | 055 | Līgatnes novads |
| LV | 056 | Līvānu novads |
| LV | 057 | Lubānas novads |
| LV | 058 | Ludzas novads |
| LV | 059 | Madonas novads |
| LV | 060 | Mazsalacas novads |
| LV | 061 | Mālpils novads |
| LV | 062 | Mārupes novads |
| LV | 063 | Mērsraga novads |
| LV | 064 | Naukšēnu novads |
| LV | 065 | Neretas novads |
| LV | 066 | Nīcas novads |
| LV | 067 | Ogres novads |
| LV | 068 | Olaines novads |
| LV | 069 | Ozolnieku novads |
| LV | 070 | Pārgaujas novads |
| LV | 071 | Pāvilostas novads |
| LV | 072 | Pļaviņu novads |
| LV | 073 | Preiļu novads |
| LV | 074 | Priekules novads |
| LV | 075 | Priekuļu novads |
| LV | 076 | Raunas novads |
| LV | 077 | Rēzeknes novads |
| LV | 078 | Riebiņu novads |
| LV | 079 | Rojas novads |
| LV | 080 | Ropažu novads |
| LV | 081 | Rucavas novads |
| LV | 082 | Rugāju novads |
| LV | 083 | Rundāles novads |
| LV | 084 | Rūjienas novads |
| LV | 085 | Salas novads |
| LV | 086 | Salacgrīvas novads |
| LV | 087 | Salaspils novads |
| LV | 088 | Saldus novads |
| LV | 089 | Saulkrastu novads |
| LV | 090 | Sējas novads |
| LV | 091 | Siguldas novads |
| LV | 092 | Skrīveru novads |
| LV | 093 | Skrundas novads |
| LV | 094 | Smiltenes novads |
| LV | 095 | Stopiņu novads |
| LV | 096 | Strenču novads |
| LV | 097 | Talsu novads |
| LV | 098 | Tērvetes novads |
| LV | 099 | Tukuma novads |
| LV | 100 | Vaiņodes novads |
| LV | 101 | Valkas novads |
| LV | 102 | Varakļānu novads |
| LV | 103 | Vārkavas novads |
| LV | 104 | Vecpiebalgas novads |
| LV | 105 | Vecumnieku novads |
| LV | 106 | Ventspils novads |
| LV | 107 | Viesītes novads |
| LV | 108 | Viļakas novads |
| LV | 109 | Viļānu novads |
| LV | 110 | Zilupes novads |
| LV | JKB | Jēkabpils |
| LV | VMR | Valmiera |
| LB | AK | Aakkâr |
| LB | BI | Al Biqā‘ |
| LB | JA | Al Janūb |
| LB | NA | An Nabaţīyah |
| LB | AS | Ash Shimāl |
| LB | BH | Baalbek-Hermel |
| LB | BA | Beyrouth |
| LB | BI | Béqaa |
| LB | BH | B‘alabak-Al Hirmil |
| LB | JL | Jabal Lubnān |
| LB | AS | Liban-Nord |
| LB | JA | Liban-Sud |
| LB | JL | Mont-Liban |
| LB | NA | Nabatîyé |
| LS | D | Berea |
| LS | C | Leribe |
| LS | E | Mafeteng |
| LS | A | Maseru |
| LS | F | Mohale’s Hoek |
| LS | J | Mokhotlong |
| LS | H | Qacha’s Nek |
| LS | G | Quthing |
| LS | K | Thaba-Tseka |
| LS | B | Botha-Bothe |
| LR | BM | Bomi |
| LR | BG | Bong |
| LR | GB | Grand Bassa |
| LR | CM | Grand Cape Mount |
| LR | GG | Grand Gedeh |
| LR | GK | Grand Kru |
| LR | LO | Lofa |
| LR | MG | Margibi |
| LR | MY | Maryland |
| LR | MO | Montserrado |
| LR | NI | Nimba |
| LR | RI | River Cess |
| LR | SI | Sinoe |
| LR | GP | Gbarpolu |
| LR | RG | River Gee |
| LY | JA | Al Jabal al Akhdar |
| LY | JU | Al Jufrah |
| LY | KF | Al Kufrah |
| LY | NQ | An Nuqat al Khams |
| LY | ZA | Az Zawiyah |
| LY | BA | Banghazi |
| LY | DR | Darnah |
| LY | MI | Misratah |
| LY | MQ | Murzuq |
| LY | SB | Sabha |
| LY | SR | Surt |
| LY | BU | Al Buţnān |
| LY | GT | Ghāt |
| LY | JG | Al Jabal al Gharbī |
| LY | JI | Al Jafārah |
| LY | MB | Al Marqab |
| LY | MJ | Al Marj |
| LY | NL | Nālūt |
| LY | TB | Ţarābulus |
| LY | WA | Al Wāḩāt |
| LY | WD | Wādī al Ḩayāt |
| LY | WS | Wādī ash Shāţi’ |
| LI | 01 | Balzers |
| LI | 02 | Eschen |
| LI | 03 | Gamprin |
| LI | 04 | Mauren |
| LI | 05 | Planken |
| LI | 06 | Ruggell |
| LI | 07 | Schaan |
| LI | 08 | Schellenberg |
| LI | 09 | Triesen |
| LI | 10 | Triesenberg |
| LI | 11 | Vaduz |
| LT | AL | Alytus |
| LT | 16 | Kaunas |
| LT | KL | Klaipeda |
| LT | 25 | Marijampole |
| LT | 33 | Panevezys |
| LT | 44 | Siauliai |
| LT | TA | Taurage |
| LT | TE | Telsiai |
| LT | UT | Utena |
| LT | 58 | Vilnius |
| LT | 01 | Akmenė |
| LT | 02 | Alytaus miestas |
| LT | 04 | Anykščiai |
| LT | 05 | Birštono |
| LT | 06 | Biržai |
| LT | 07 | Druskininkai |
| LT | 08 | Elektrėnai |
| LT | 09 | Ignalina |
| LT | 10 | Jonava |
| LT | 11 | Joniškis |
| LT | 12 | Jurbarkas |
| LT | 13 | Kaišiadorys |
| LT | 14 | Kalvarijos |
| LT | 15 | Kauno miestas |
| LT | 17 | Kazlų Rūdos |
| LT | 18 | Kėdainiai |
| LT | 19 | Kelmė |
| LT | 20 | Klaipėdos miestas |
| LT | 22 | Kretinga |
| LT | 23 | Kupiškis |
| LT | 24 | Lazdijai |
| LT | 26 | Mažeikiai |
| LT | 27 | Molėtai |
| LT | 28 | Neringa |
| LT | 29 | Pagėgiai |
| LT | 30 | Pakruojis |
| LT | 31 | Palangos miestas |
| LT | 32 | Panevėžio miestas |
| LT | 34 | Pasvalys |
| LT | 35 | Plungė |
| LT | 36 | Prienai |
| LT | 37 | Radviliškis |
| LT | 38 | Raseiniai |
| LT | 39 | Rietavo |
| LT | 40 | Rokiškis |
| LT | 41 | Šakiai |
| LT | 42 | Šalčininkai |
| LT | 43 | Šiaulių miestas |
| LT | 45 | Šilalė |
| LT | 46 | Šilutė |
| LT | 47 | Širvintos |
| LT | 48 | Skuodas |
| LT | 49 | Švenčionys |
| LT | 52 | Trakai |
| LT | 53 | Ukmergė |
| LT | 55 | Varėna |
| LT | 56 | Vilkaviškis |
| LT | 57 | Vilniaus miestas |
| LT | 59 | Visaginas |
| LT | 60 | Zarasai |
| LT | KU | Kauno apskritis |
| LT | MR | Marijampolės apskritis |
| LT | PN | Panevėžio apskritis |
| LT | SA | Šiaulių apskritis |
| LT | VL | Vilniaus apskritis |
| LU | CA | Capellen |
| LU | CL | Clervaux |
| LU | DI | Diekirch |
| LU | EC | Echternach |
| LU | ES | Esch-sur-Alzette |
| LU | GR | Grevenmacher |
| LU | LU | Luxembourg |
| LU | ME | Mersch |
| LU | RD | Redange |
| LU | RM | Remich |
| LU | VD | Vianden |
| LU | WI | Wiltz |
| MK | 101 | Veles |
| MK | 102 | Gradsko |
| MK | 103 | Demir Kapija |
| MK | 104 | Kavadarci |
| MK | 105 | Lozovo |
| MK | 106 | Negotino |
| MK | 107 | Rosoman |
| MK | 108 | Sveti Nikole |
| MK | 109 | Čaška |
| MK | 201 | Berovo |
| MK | 202 | Vinica |
| MK | 203 | Delčevo |
| MK | 204 | Zrnovci |
| MK | 205 | Karbinci |
| MK | 206 | Kočani |
| MK | 207 | Makedonska Kamenica |
| MK | 208 | Pehčevo |
| MK | 209 | Probištip |
| MK | 210 | Češinovo-Obleševo |
| MK | 211 | Štip |
| MK | 301 | Vevčani |
| MK | 303 | Debar |
| MK | 304 | Debrca |
| MK | 307 | Kičevo |
| MK | 308 | Makedonski Brod |
| MK | 310 | Ohrid |
| MK | 311 | Plasnica |
| MK | 312 | Struga |
| MK | 313 | Centar Župa |
| MK | 401 | Bogdanci |
| MK | 402 | Bosilovo |
| MK | 403 | Valandovo |
| MK | 404 | Vasilevo |
| MK | 405 | Gevgelija |
| MK | 406 | Dojran |
| MK | 407 | Konče |
| MK | 408 | Novo Selo |
| MK | 409 | Radoviš |
| MK | 410 | Strumica |
| MK | 501 | Bitola |
| MK | 502 | Demir Hisar |
| MK | 503 | Dolneni |
| MK | 504 | Krivogaštani |
| MK | 505 | Kruševo |
| MK | 506 | Mogila |
| MK | 507 | Novaci |
| MK | 508 | Prilep |
| MK | 509 | Resen |
| MK | 601 | Bogovinje |
| MK | 602 | Brvenica |
| MK | 603 | Vrapčište |
| MK | 604 | Gostivar |
| MK | 605 | Želino |
| MK | 606 | Jegunovce |
| MK | 607 | Mavrovo i Rostuše |
| MK | 608 | Tearce |
| MK | 609 | Tetovo |
| MK | 701 | Kratovo |
| MK | 702 | Kriva Palanka |
| MK | 703 | Kumanovo |
| MK | 704 | Lipkovo |
| MK | 705 | Rankovce |
| MK | 706 | Staro Nagoričane |
| MK | 801 | Aerodrom † |
| MK | 802 | Aračinovo |
| MK | 803 | Butel † |
| MK | 804 | Gazi Baba † |
| MK | 805 | Gjorče Petrov † |
| MK | 806 | Zelenikovo |
| MK | 807 | Ilinden |
| MK | 808 | Karpoš † |
| MK | 809 | Kisela Voda † |
| MK | 810 | Petrovec |
| MK | 811 | Saraj † |
| MK | 812 | Sopište |
| MK | 813 | Studeničani |
| MK | 814 | Centar † |
| MK | 815 | Čair † |
| MK | 816 | Čučer-Sandevo |
| MK | 817 | Šuto Orizari † |
| MG | T | Antananarivo |
| MG | D | Antsiranana |
| MG | F | Fianarantsoa |
| MG | M | Mahajanga |
| MG | A | Toamasina |
| MG | U | Toliara |
| MW | BA | Balaka |
| MW | BL | Blantyre |
| MW | CK | Chikwawa |
| MW | CR | Chiradzulu |
| MW | CT | Chitipa |
| MW | DE | Dedza |
| MW | DO | Dowa |
| MW | KR | Karonga |
| MW | KS | Kasungu |
| MW | LK | Likoma |
| MW | LI | Lilongwe |
| MW | MH | Machinga |
| MW | MG | Mangochi |
| MW | MC | Mchinji |
| MW | MU | Mulanje |
| MW | MW | Mwanza |
| MW | MZ | Mzimba |
| MW | NB | Nkhata Bay |
| MW | NK | Nkhotakota |
| MW | NS | Nsanje |
| MW | NU | Ntcheu |
| MW | NI | Ntchisi |
| MW | PH | Phalombe |
| MW | RU | Rumphi |
| MW | SA | Salima |
| MW | TH | Thyolo |
| MW | ZO | Zomba |
| MW | C | Chapakati |
| MW | N | Northern Region |
| MW | NE | Neno |
| MW | S | Southern Region |
| MY | 01 | Johor |
| MY | 02 | Kedah |
| MY | 03 | Kelantan |
| MY | 04 | Melaka |
| MY | 05 | Negeri Sembilan |
| MY | 06 | Pahang |
| MY | 08 | Perak |
| MY | 09 | Perlis |
| MY | 07 | Pulau Pinang |
| MY | 12 | Sabah |
| MY | 13 | Sarawak |
| MY | 10 | Selangor |
| MY | 11 | Terengganu |
| MY | 14 | Wilayah Persekutuan Kuala Lumpur |
| MY | 15 | Wilayah Persekutuan Labuan |
| MY | 16 | Wilayah Persekutuan Putrajaya |
| MV | 01 | Addu |
| MV | 03 | Faadhippolhu |
| MV | 08 | Kolhumadulu |
| MV | 26 | Male Atoll |
| MV | 12 | Mulaku Atoll |
| MV | 00 | South Ari Atoll |
| MV | 02 | North Ari Atoll |
| MV | 04 | Felidhu Atoll |
| MV | 05 | Hahdhunmathi |
| MV | 07 | Thiladhunmathee Uthuruburi |
| MV | 13 | North Maalhosmadulu |
| MV | 14 | North Nilandhe Atoll |
| MV | 17 | South Nilandhe Atoll |
| MV | 20 | South Maalhosmadulu |
| MV | 23 | Thiladhunmathee Dhekunuburi |
| MV | 24 | North Miladhunmadulu |
| MV | 25 | South Miladhunmadulu |
| MV | 27 | North Huvadhu Atoll |
| MV | 28 | South Huvadhu Atoll |
| MV | 29 | Fuvammulah |
| MV | MLE | Male |
| ML | 7 | Gao |
| ML | 1 | Kayes |
| ML | 8 | Kidal |
| ML | 2 | Koulikoro |
| ML | 5 | Mopti |
| ML | 4 | Segou |
| ML | 3 | Sikasso |
| ML | 6 | Tombouctou |
| ML | 10 | Taoudénit |
| ML | 9 | Ménaka |
| ML | BKO | Bamako |
| MT | 01 | Attard |
| MT | 02 | Balzan |
| MT | 03 | Birgu |
| MT | 04 | Birkirkara |
| MT | 05 | Birzebbuga |
| MT | 06 | Bormla |
| MT | 07 | Dingli |
| MT | 08 | Fgura |
| MT | 09 | Floriana |
| MT | 10 | Fontana |
| MT | 11 | Gudja |
| MT | 12 | Gzira |
| MT | 19 | Iklin |
| MT | 20 | Isla |
| MT | 21 | Kalkara |
| MT | 22 | Kercem |
| MT | 23 | Kirkop |
| MT | 24 | Lija |
| MT | 25 | Luqa |
| MT | 26 | Marsa |
| MT | 27 | Marsaskala |
| MT | 28 | Marsaxlokk |
| MT | 29 | Mdina |
| MT | 31 | Mgarr |
| MT | 32 | Mosta |
| MT | 33 | Mqabba |
| MT | 34 | Msida |
| MT | 35 | Mtarfa |
| MT | 36 | Munxar |
| MT | 37 | Nadur |
| MT | 38 | Naxxar |
| MT | 39 | Paola |
| MT | 40 | Pembroke |
| MT | 41 | Pieta |
| MT | 42 | Qala |
| MT | 43 | Qormi |
| MT | 44 | Qrendi |
| MT | 47 | Safi |
| MT | 48 | San Giljan |
| MT | 49 | San Gwann |
| MT | 50 | San Lawrenz |
| MT | 52 | Sannat |
| MT | 53 | Santa Lucija |
| MT | 54 | Santa Venera |
| MT | 55 | Siggiewi |
| MT | 56 | Sliema |
| MT | 57 | Swieqi |
| MT | 59 | Tarxien |
| MT | 60 | Valletta |
| MT | 62 | Xewkija |
| MT | 64 | Zabbar |
| MT | 67 | Zejtun |
| MT | 68 | Zurrieq |
| MT | 13 | Għajnsielem |
| MT | 14 | Għarb |
| MT | 15 | Għargħur |
| MT | 16 | Għasri |
| MT | 17 | Għaxaq |
| MT | 18 | Ħamrun |
| MT | 30 | Mellieħa |
| MT | 45 | Rabat Għawdex |
| MT | 46 | Rabat Malta |
| MT | 51 | San Pawl il-Baħar |
| MT | 58 | Ta’ Xbiex |
| MT | 61 | Xagħra |
| MT | 63 | Xgħajra |
| MT | 65 | Żebbuġ Għawdex |
| MT | 66 | Żebbuġ Malta |
| MH | ALL | Ailinglaplap |
| MH | ALK | Ailuk |
| MH | ARN | Arno |
| MH | AUR | Aur |
| MH | EBO | Ebon |
| MH | JAB | Jabat |
| MH | JAL | Jaluit |
| MH | KIL | Kili |
| MH | KWA | Kwajalein |
| MH | LAE | Lae |
| MH | LIB | Lib |
| MH | LIK | Likiep |
| MH | MAJ | Majuro |
| MH | MAL | Maloelap |
| MH | MEJ | Mejit |
| MH | MIL | Mili |
| MH | NMK | Namorik |
| MH | NMU | Namu |
| MH | RON | Rongelap |
| MH | UJA | Ujae |
| MH | WTH | Wotho |
| MH | WTJ | Wotje |
| MH | ENI | Enewetak & Ujelang |
| MH | L | Ralik chain |
| MH | T | Ratak chain |
| MH | UTI | Utrōk |
| MR | 07 | Adrar |
| MR | 03 | Assaba |
| MR | 05 | Brakna |
| MR | 08 | Dakhlet Nouadhibou |
| MR | 04 | Gorgol |
| MR | 10 | Guidimaka |
| MR | 01 | Hodh Ech Chargui |
| MR | 02 | Hodh El Gharbi |
| MR | 12 | Inchiri |
| MR | 09 | Tagant |
| MR | 11 | Tiris Zemmour |
| MR | 06 | Trarza |
| MR | 13 | Nuwākshūţ al Gharbīyah |
| MR | 14 | Nuwākshūţ ash Shamālīyah |
| MR | 15 | Nuwākshūţ al Janūbīyah |
| MU | AG | Agalega Islands |
| MU | BL | Black River |
| MU | CC | Cargados Carajos Shoals (Saint Brandon Islands) |
| MU | FL | Flacq |
| MU | GP | Grand Port |
| MU | MO | Moka |
| MU | PA | Pamplemousses |
| MU | PW | Plaines Wilhems |
| MU | PL | Port Louis |
| MU | RR | Riviere du Rempart |
| MU | RO | Rodrigues |
| MU | SA | Savanne |
| MX | AGU | Aguascalientes |
| MX | BCS | Baja California Sur |
| MX | CAM | Campeche |
| MX | CHP | Chiapas |
| MX | CHH | Chihuahua |
| MX | COA | Coahuila de Zaragoza |
| MX | COL | Colima |
| MX | DUR | Durango |
| MX | GUA | Guanajuato |
| MX | GRO | Guerrero |
| MX | HID | Hidalgo |
| MX | JAL | Jalisco |
| MX | MEX | Mexico |
| MX | MIC | Michoacan de Ocampo |
| MX | MOR | Morelos |
| MX | NAY | Nayarit |
| MX | NLE | Nuevo Leon |
| MX | OAX | Oaxaca |
| MX | PUE | Puebla |
| MX | ROO | Quintana Roo |
| MX | SLP | San Luis Potosi |
| MX | SIN | Sinaloa |
| MX | SON | Sonora |
| MX | TAB | Tabasco |
| MX | TAM | Tamaulipas |
| MX | TLA | Tlaxcala |
| MX | YUC | Yucatan |
| MX | ZAC | Zacatecas |
| MX | BCN | Baja California |
| MX | CMX | Ciudad de México |
| MX | QUE | Querétaro |
| MX | VER | Veracruz de Ignacio de la Llave |
| FM | TRK | Chuuk |
| FM | KSA | Kosrae |
| FM | PNI | Pohnpei |
| FM | YAP | Yap |
| MD | BA | Balti |
| MD | CA | Cahul |
| MD | CU | Chisinau |
| MD | ED | Edinet |
| MD | GA | Gagauzia |
| MD | OR | Orhei |
| MD | SO | Soroca |
| MD | SN | Stînga Nistrului |
| MD | UN | Ungheni |
| MD | AN | Anenii Noi |
| MD | BD | Bender [Tighina] |
| MD | BR | Briceni |
| MD | BS | Basarabeasca |
| MD | CL | Călărași |
| MD | CM | Cimișlia |
| MD | CR | Criuleni |
| MD | CS | Căușeni |
| MD | CT | Cantemir |
| MD | DO | Dondușeni |
| MD | DR | Drochia |
| MD | DU | Dubăsari |
| MD | FA | Fălești |
| MD | FL | Florești |
| MD | GL | Glodeni |
| MD | HI | Hîncești |
| MD | IA | Ialoveni |
| MD | LE | Leova |
| MD | NI | Nisporeni |
| MD | OC | Ocnița |
| MD | RE | Rezina |
| MD | RI | Rîșcani |
| MD | SD | Șoldănești |
| MD | SI | Sîngerei |
| MD | ST | Strășeni |
| MD | SV | Ștefan Vodă |
| MD | TA | Taraclia |
| MD | TE | Telenești |
| MC | FO | Fontvieille |
| MC | CO | La Condamine |
| MC | MO | Monaco-Ville |
| MC | MC | Monte-Carlo |
| MC | CL | La Colle |
| MC | GA | La Gare |
| MC | JE | Jardin Exotique |
| MC | LA | Larvotto |
| MC | MA | Malbousquet |
| MC | MG | Moneghetti |
| MC | MU | Moulins |
| MC | PH | Port-Hercule |
| MC | SD | Sainte-Dévote |
| MC | SO | La Source |
| MC | SP | Spélugues |
| MC | SR | Saint-Roman |
| MC | VR | Vallon de la Rousse |
| MN | 073 | Arhangay |
| MN | 071 | Bayan-Olgiy |
| MN | 069 | Bayanhongor |
| MN | 067 | Bulgan |
| MN | 037 | Darhan uul |
| MN | 061 | Dornod |
| MN | 057 | Dzavhan |
| MN | 065 | Govi-Altay |
| MN | 064 | Govi-Sumber |
| MN | 039 | Hentiy |
| MN | 043 | Hovd |
| MN | 041 | Hovsgol |
| MN | 053 | Omnogovi |
| MN | 035 | Orhon |
| MN | 055 | Ovorhangay |
| MN | 049 | Selenge |
| MN | 051 | Suhbaatar |
| MN | 047 | Tov |
| MN | 1 | Ulanbaatar |
| MN | 046 | Uvs |
| MN | 059 | Dundgovĭ |
| MN | 063 | Dornogovĭ |
| ME | 01 | Andrijevica |
| ME | 02 | Bar |
| ME | 03 | Berane |
| ME | 04 | Bijelo Polje |
| ME | 05 | Budva |
| ME | 06 | Cetinje |
| ME | 07 | Danilovgrad |
| ME | 08 | Herceg-Novi |
| ME | 09 | Kolašin |
| ME | 10 | Kotor |
| ME | 11 | Mojkovac |
| ME | 12 | Nikšić |
| ME | 13 | Plav |
| ME | 14 | Pljevlja |
| ME | 15 | Plužine |
| ME | 16 | Podgorica |
| ME | 17 | Rožaje |
| ME | 18 | Šavnik |
| ME | 19 | Tivat |
| ME | 20 | Ulcinj |
| ME | 21 | Žabljak |
| ME | 22 | Gusinje |
| ME | 23 | Petnjica |
| ME | 24 | Tuzi |
| MA | AGD | Agadir |
| MA | HOC | Al Hoceima |
| MA | AZI | Azilal |
| MA | BEM | Beni Mellal |
| MA | BOM | Boulemane |
| MA | CAS | Casablanca |
| MA | JDI | El Jadida |
| MA | KES | El Kelaa des Sraghna |
| MA | ESM | Es Smara |
| MA | ESI | Essaouira |
| MA | FES | Fes |
| MA | FIG | Figuig |
| MA | GUE | Guelmim |
| MA | IFR | Ifrane |
| MA | KEN | Kenitra |
| MA | KHE | Khemisset |
| MA | KHN | Khenifra |
| MA | KHO | Khouribga |
| MA | LAR | Larache |
| MA | MAR | Marrakech |
| MA | MEK | Meknes |
| MA | NAD | Nador |
| MA | OUA | Ouarzazate |
| MA | OUJ | Oujda |
| MA | SAF | Safi |
| MA | SET | Settat |
| MA | SIK | Sidi Kacem |
| MA | TAO | Taounate |
| MA | TAR | Taroudannt |
| MA | TAT | Tata |
| MA | TAZ | Taza |
| MA | TET | Tetouan |
| MA | TIZ | Tiznit |
| MA | 01 | Tanger-Tétouan-Al Hoceïma |
| MA | 02 | L’Oriental |
| MA | 03 | Fès-Meknès |
| MA | 04 | Rabat-Salé-Kénitra |
| MA | 05 | Béni Mellal-Khénifra |
| MA | 06 | Casablanca-Settat |
| MA | 07 | Marrakech-Safi |
| MA | 08 | Drâa-Tafilalet |
| MA | 09 | Souss-Massa |
| MA | 10 | Guelmim-Oued Noun (EH-partial) |
| MA | 11 | Laâyoune-Sakia El Hamra (EH-partial) |
| MA | 12 | Dakhla-Oued Ed-Dahab (EH) |
| MA | AOU | Aousserd (EH) |
| MA | ASZ | Assa-Zag (EH-partial) |
| MA | BER | Berkane |
| MA | BES | Benslimane |
| MA | BOD | Boujdour (EH) |
| MA | BRR | Berrechid |
| MA | CHE | Chefchaouen |
| MA | CHI | Chichaoua |
| MA | CHT | Chtouka-Ait Baha |
| MA | DRI | Driouch |
| MA | ERR | Errachidia |
| MA | FAH | Fahs-Anjra |
| MA | FQH | Fquih Ben Salah |
| MA | GUF | Guercif |
| MA | HAJ | El Hajeb |
| MA | HAO | Al Haouz |
| MA | INE | Inezgane-Ait Melloul |
| MA | JRA | Jerada |
| MA | LAA | Laâyoune (EH) |
| MA | MDF | M’diq-Fnideq |
| MA | MED | Médiouna |
| MA | MID | Midelt |
| MA | MOH | Mohammadia |
| MA | MOU | Moulay Yacoub |
| MA | NOU | Nouaceur |
| MA | OUD | Oued Ed-Dahab (EH) |
| MA | OUZ | Ouezzane |
| MA | RAB | Rabat |
| MA | REH | Rehamna |
| MA | SAL | Salé |
| MA | SEF | Sefrou |
| MA | SIB | Sidi Bennour |
| MA | SIF | Sidi Ifni |
| MA | SIL | Sidi Slimane |
| MA | SKH | Skhirate-Témara |
| MA | TAF | Tarfaya (EH-partial) |
| MA | TAI | Taourirt |
| MA | TIN | Tinghir |
| MA | TNG | Tanger-Assilah |
| MA | TNT | Tan-Tan (EH-partial) |
| MA | YUS | Youssoufia |
| MA | ZAG | Zagora |
| MZ | P | Cabo Delgado |
| MZ | G | Gaza |
| MZ | I | Inhambane |
| MZ | B | Manica |
| MZ | MPM | Maputo |
| MZ | N | Nampula |
| MZ | A | Niassa |
| MZ | S | Sofala |
| MZ | T | Tete |
| MZ | Q | Zambezia |
| MM | 07 | Ayeyarwady |
| MM | 02 | Bago |
| MM | 03 | Magway |
| MM | 04 | Mandalay |
| MM | 01 | Sagaing |
| MM | 05 | Tanintharyi |
| MM | 06 | Yangon |
| MM | 11 | Kachin |
| MM | 12 | Kayah |
| MM | 13 | Kayin |
| MM | 14 | Chin |
| MM | 15 | Mon |
| MM | 16 | Rakhine |
| MM | 17 | Shan |
| MM | 18 | Nay Pyi Taw |
| NA | CA | Caprivi |
| NA | ER | Erongo |
| NA | HA | Hardap |
| NA | KH | Khomas |
| NA | KU | Kunene |
| NA | OW | Ohangwena |
| NA | OH | Omaheke |
| NA | OS | Omusati |
| NA | ON | Oshana |
| NA | OT | Oshikoto |
| NA | OD | Otjozondjupa |
| NA | KA | //Karas |
| NA | KE | Kavango East |
| NA | KW | Kavango West |
| NR | 01 | Aiwo |
| NR | 02 | Anabar |
| NR | 03 | Anetan |
| NR | 04 | Anibare |
| NR | 06 | Boe |
| NR | 07 | Buada |
| NR | 08 | Denigomodu |
| NR | 09 | Ewa |
| NR | 10 | Ijuw |
| NR | 11 | Meneng |
| NR | 12 | Nibok |
| NR | 13 | Uaboe |
| NR | 14 | Yaren |
| NR | 05 | Baitsi |
| NP | BA | Bagmati |
| NP | BH | Bheri |
| NP | DH | Dhawalagiri |
| NP | GA | Gandaki |
| NP | JA | Janakpur |
| NP | KA | Karnali |
| NP | KO | Kosi |
| NP | LU | Lumbini |
| NP | MA | Mahakali |
| NP | ME | Mechi |
| NP | NA | Narayani |
| NP | RA | Rapti |
| NP | SA | Sagarmatha |
| NP | SE | Seti |
| NP | 1 | Madhyamanchal |
| NP | 2 | Mid Western |
| NP | 3 | Western |
| NP | 4 | Purwanchal |
| NP | 5 | Sudur Pashchimanchal |
| NP | P1 | Province 1 |
| NP | P2 | Province 2 |
| NP | P5 | Province 5 |
| NP | P7 | Sudūr Pashchim |
| NL | DR | Drenthe |
| NL | FL | Flevoland |
| NL | FR | Friesland |
| NL | GE | Gelderland |
| NL | GR | Groningen |
| NL | LI | Limburg |
| NL | NB | Noord Brabant |
| NL | NH | Noord Holland |
| NL | OV | Overijssel |
| NL | UT | Utrecht |
| NL | ZE | Zeeland |
| NL | ZH | Zuid Holland |
| NL | AW | Aruba (see also separate country code entry under AW) |
| NL | BQ1 | Bonaire (see also separate country code entry under BQ) |
| NL | BQ2 | Saba (see also separate country code entry under BQ) |
| NL | BQ3 | Sint Eustatius (see also separate country code entry under BQ) |
| NL | CW | Curaçao (see also separate country code entry under CW) |
| NL | SX | Sint Maarten (see also separate country code entry under SX) |
| NZ | AUK | Auckland |
| NZ | BOP | Bay of Plenty |
| NZ | CAN | Canterbury |
| NZ | GIS | Gisborne |
| NZ | HKB | Hawke’s Bay |
| NZ | MWT | Manawatu-Wanganui |
| NZ | MBH | Marlborough |
| NZ | NSN | Nelson |
| NZ | NTL | Northland |
| NZ | OTA | Otago |
| NZ | STL | Southland |
| NZ | TKI | Taranaki |
| NZ | WKO | Waikato |
| NZ | WGN | Wellington |
| NZ | WTC | West Coast |
| NZ | CIT | Wharekauri |
| NZ | TAS | Tasman |
| NI | AN | Atlantico Norte |
| NI | AS | Atlantico Sur |
| NI | BO | Boaco |
| NI | CA | Carazo |
| NI | CI | Chinandega |
| NI | CO | Chontales |
| NI | ES | Esteli |
| NI | GR | Granada |
| NI | JI | Jinotega |
| NI | LE | Leon |
| NI | MD | Madriz |
| NI | MN | Managua |
| NI | MS | Masaya |
| NI | MT | Matagalpa |
| NI | NS | Nuevo Segovia |
| NI | SJ | Rio San Juan |
| NI | RI | Rivas |
| NE | 1 | Agadez |
| NE | 2 | Diffa |
| NE | 3 | Dosso |
| NE | 4 | Maradi |
| NE | 8 | Niamey |
| NE | 5 | Tahoua |
| NE | 6 | Tillaberi |
| NE | 7 | Zinder |
| NG | AB | Abia |
| NG | FC | Abuja Federal Capital Territory |
| NG | AD | Adamawa |
| NG | AK | Akwa Ibom |
| NG | AN | Anambra |
| NG | BA | Bauchi |
| NG | BY | Bayelsa |
| NG | BE | Benue |
| NG | BO | Borno |
| NG | CR | Cross River |
| NG | DE | Delta |
| NG | EB | Ebonyi |
| NG | ED | Edo |
| NG | EK | Ekiti |
| NG | EN | Enugu |
| NG | GO | Gombe |
| NG | IM | Imo |
| NG | JI | Jigawa |
| NG | KD | Kaduna |
| NG | KN | Kano |
| NG | KT | Katsina |
| NG | KE | Kebbi |
| NG | KO | Kogi |
| NG | KW | Kwara |
| NG | LA | Lagos |
| NG | NA | Nassarawa |
| NG | NI | Niger |
| NG | OG | Ogun |
| NG | ON | Ondo |
| NG | OS | Osun |
| NG | OY | Oyo |
| NG | PL | Plateau |
| NG | RI | Rivers |
| NG | SO | Sokoto |
| NG | TA | Taraba |
| NG | YO | Yobe |
| NG | ZA | Zamfara |
| NO | 18 | Nordland |
| NO | 03 | Oslo |
| NO | 11 | Rogaland |
| NO | 15 | Møre og Romsdal |
| NO | 21 | Svalbard (Arctic Region) (see also separate country code entry under SJ) |
| NO | 22 | Jan Mayen (Arctic Region) (see also separate country code entry under SJ) |
| NO | 30 | Viken |
| NO | 34 | Innlandet |
| NO | 38 | Vestfold og Telemark |
| NO | 42 | Agder |
| NO | 46 | Vestland |
| NO | 50 | Trøndelag |
| NO | 54 | Tromssan ja Finmarkun |
| OM | DA | Ad Dakhiliyah |
| OM | WU | Al Wusta |
| OM | ZA | Az Zahirah |
| OM | MA | Masqat |
| OM | MU | Musandam |
| OM | ZU | Zufar |
| OM | BJ | Janūb al Bāţinah |
| OM | BS | Shamāl al Bāţinah |
| OM | BU | Al Buraymī |
| OM | SJ | Janūb ash Sharqīyah |
| OM | SS | Shamāl ash Sharqīyah |
| PK | BA | Balochistan |
| PK | PB | Punjab |
| PK | SD | Sindh |
| PK | GB | Gilgit-Baltistan |
| PK | IS | Islamabad |
| PK | JK | Āzād Jammūñ o Kashmīr |
| PK | KP | Khyber Pakhtunkhwa |
| PW | 002 | Aimeliik |
| PW | 004 | Airai |
| PW | 010 | Angaur |
| PW | 050 | Hatohobei |
| PW | 100 | Kayangel |
| PW | 150 | Koror |
| PW | 212 | Melekeok |
| PW | 214 | Ngaraard |
| PW | 218 | Ngarchelong |
| PW | 222 | Ngardmau |
| PW | 224 | Ngatpang |
| PW | 226 | Ngchesar |
| PW | 227 | Ngeremlengui |
| PW | 228 | Ngiwal |
| PW | 350 | Peleliu |
| PW | 370 | Sonsorol |
| PS | BTH | Bethlehem |
| PS | DEB | Deir El Balah |
| PS | GZA | Ghazzah |
| PS | HBN | Hebron |
| PS | JEM | Jerusalem |
| PS | JEN | Jenin |
| PS | JRH | Jericho and Al Aghwar |
| PS | KYS | Khān Yūnis |
| PS | NBS | Nāblus |
| PS | NGZ | Shamāl Ghazzah |
| PS | QQA | Qalqīlyah |
| PS | RBH | Ramallah |
| PS | RFH | Rafaḩ |
| PS | SLT | Salfīt |
| PS | TBS | Ţūbās |
| PS | TKM | Ţūlkarm |
| PA | 1 | Bocas del Toro |
| PA | 4 | Chiriqui |
| PA | 2 | Cocle |
| PA | 3 | Colon |
| PA | 5 | Darien |
| PA | 6 | Herrera |
| PA | 7 | Los Santos |
| PA | 8 | Panama |
| PA | 9 | Veraguas |
| PA | 10 | Panamá Oeste |
| PA | EM | Emberá |
| PA | KY | Guna Yala |
| PA | NB | Ngöbe-Buglé |
| PG | NSB | Bougainville |
| PG | CPM | Central |
| PG | CPK | Chimbu |
| PG | EBR | East New Britain |
| PG | ESW | East Sepik |
| PG | EHG | Eastern Highlands |
| PG | EPW | Enga |
| PG | GPK | Gulf |
| PG | MPM | Madang |
| PG | MRL | Manus |
| PG | MBA | Milne Bay |
| PG | MPL | Morobe |
| PG | NIK | New Ireland |
| PG | NPP | Northern |
| PG | SHM | Southern Highlands |
| PG | WBK | West New Britain |
| PG | WPD | Western |
| PG | WHM | Western Highlands |
| PG | HLA | Hela |
| PG | JWK | Jiwaka |
| PG | NCD | National Capital District (Port Moresby) |
| PG | SAN | West Sepik |
| PY | 16 | Alto Paraguay |
| PY | 10 | Alto Parana |
| PY | 13 | Amambay |
| PY | ASU | Asuncion |
| PY | 19 | Boqueron |
| PY | 5 | Caaguazu |
| PY | 6 | Caazapa |
| PY | 14 | Canindeyu |
| PY | 11 | Central |
| PY | 1 | Concepcion |
| PY | 3 | Cordillera |
| PY | 4 | Guaira |
| PY | 7 | Itapua |
| PY | 8 | Misiones |
| PY | 12 | Neembucu |
| PY | 9 | Paraguari |
| PY | 15 | Presidente Hayes |
| PY | 2 | San Pedro |
| PE | AMA | Amazonas |
| PE | ANC | Ancash |
| PE | APU | Apurimac |
| PE | ARE | Arequipa |
| PE | AYA | Ayacucho |
| PE | CAJ | Cajamarca |
| PE | CUS | Cusco |
| PE | HUV | Huancavelica |
| PE | HUC | Huanuco |
| PE | ICA | Ica |
| PE | JUN | Junin |
| PE | LAL | La Libertad |
| PE | LAM | Lambayeque |
| PE | LIM | Lima |
| PE | LOR | Loreto |
| PE | MDD | Madre de Dios |
| PE | MOQ | Moquegua |
| PE | PAS | Pasco |
| PE | PIU | Piura |
| PE | PUN | Puno |
| PE | SAM | San Martin |
| PE | TAC | Tacna |
| PE | TUM | Tumbes |
| PE | UCA | Ucayali |
| PE | CAL | Qallaw |
| PE | LMA | Municipalidad Metropolitana de Lima |
| PH | ABR | Abra |
| PH | AGN | Agusan del Norte |
| PH | AGS | Agusan del Sur |
| PH | AKL | Aklan |
| PH | ALB | Albay |
| PH | ANT | Antique |
| PH | APA | Apayao |
| PH | AUR | Aurora |
| PH | BAS | Basilan |
| PH | BAN | Bataan |
| PH | BTN | Batanes |
| PH | BTG | Batangas |
| PH | BEN | Benguet |
| PH | BIL | Biliran |
| PH | BOH | Bohol |
| PH | BUK | Bukidnon |
| PH | BUL | Bulacan |
| PH | CAG | Cagayan |
| PH | CAN | Camarines Norte |
| PH | CAS | Camarines Sur |
| PH | CAM | Camiguin |
| PH | CAP | Capiz |
| PH | CAT | Catanduanes |
| PH | CAV | Cavite |
| PH | CEB | Cebu |
| PH | DAO | Davao Oriental |
| PH | DAV | Davao del Norte |
| PH | DAS | Davao del Sur |
| PH | EAS | Eastern Samar |
| PH | GUI | Guimaras |
| PH | IFU | Ifugao |
| PH | ILN | Ilocos Norte |
| PH | ILS | Ilocos Sur |
| PH | ILI | Iloilo |
| PH | ISA | Isabela |
| PH | KAL | Kalinga |
| PH | LUN | La Union |
| PH | LAG | Laguna |
| PH | LAN | Lanao del Norte |
| PH | LAS | Lanao del Sur |
| PH | LEY | Leyte |
| PH | MAG | Maguindanao |
| PH | MAD | Marinduque |
| PH | MAS | Masbate |
| PH | MDC | Mindoro Occidental |
| PH | MDR | Mindoro Oriental |
| PH | MSC | Misamis Occidental |
| PH | MSR | Misamis Oriental |
| PH | NEC | Negros Occidental |
| PH | NER | Negros Oriental |
| PH | NSA | Northern Samar |
| PH | NUE | Nueva Ecija |
| PH | NUV | Nueva Vizcaya |
| PH | PLW | Palawan |
| PH | PAM | Pampanga |
| PH | PAN | Pangasinan |
| PH | QUE | Quezon |
| PH | QUI | Quirino |
| PH | RIZ | Rizal |
| PH | ROM | Romblon |
| PH | WSA | Samar |
| PH | SAR | Sarangani |
| PH | SIG | Siquijor |
| PH | SOR | Sorsogon |
| PH | SCO | South Cotabato |
| PH | SLE | Southern Leyte |
| PH | SUK | Sultan Kudarat |
| PH | SLU | Sulu |
| PH | SUN | Surigao del Norte |
| PH | SUR | Surigao del Sur |
| PH | TAR | Tarlac |
| PH | TAW | Tawi-Tawi |
| PH | ZMB | Zambales |
| PH | ZSI | Zamboanga Sibugay |
| PH | ZAN | Zamboanga del Norte |
| PH | ZAS | Zamboanga del Sur |
| PH | 00 | Pambansang Punong Rehiyon |
| PH | 01 | Rehiyon ng Iloko |
| PH | 02 | Rehiyon ng Lambak ng Kagayan |
| PH | 03 | Rehiyon ng Gitnang Luson |
| PH | 05 | Rehiyon ng Bikol |
| PH | 06 | Western Visayas (Region VI) |
| PH | 07 | Rehiyon ng Gitnang Bisaya |
| PH | 08 | Rehiyon ng Silangang Bisaya |
| PH | 09 | Zamboanga Peninsula (Region IX) |
| PH | 10 | Rehiyon ng Hilagang Mindanaw |
| PH | 11 | Rehiyon ng Dabaw |
| PH | 12 | Soccsksargen (Region XII) |
| PH | 13 | Rehiyon ng Karaga |
| PH | 14 | Nagsasariling Rehiyon ng Muslim sa Mindanaw |
| PH | 15 | Rehiyon ng Administratibo ng Kordilyera |
| PH | 40 | Rehiyon ng Calabarzon |
| PH | 41 | Rehiyon ng Mimaropa |
| PH | COM | Davao de Oro |
| PH | DIN | Pulo ng Dinagat |
| PH | DVO | Kanlurang Dabaw |
| PH | MOU | Mountain Province |
| PH | NCO | Kotabato |
| PL | 02 | Dolnoslaskie |
| PL | 04 | Kujawsko-Pomorskie |
| PL | 06 | Lubelskie |
| PL | 08 | Lubuskie |
| PL | 14 | Mazowieckie |
| PL | 16 | Opolskie |
| PL | 18 | Podkarpackie |
| PL | 20 | Podlaskie |
| PL | 22 | Pomorskie |
| PL | 24 | Slaskie |
| PL | 26 | Swietokrzyskie |
| PL | 28 | Warminsko-Mazurskie |
| PL | 30 | Wielkopolskie |
| PL | 32 | Zachodniopomorskie |
| PL | 10 | Łódzkie |
| PL | 12 | Małopolskie |
| PT | 07 | Évora |
| PT | 01 | Aveiro |
| PT | 02 | Beja |
| PT | 03 | Braga |
| PT | 04 | Bragança |
| PT | 05 | Castelo Branco |
| PT | 06 | Coimbra |
| PT | 08 | Faro |
| PT | 09 | Guarda |
| PT | 10 | Leiria |
| PT | 11 | Lisboa |
| PT | 12 | Portalegre |
| PT | 13 | Porto |
| PT | 14 | Santarém |
| PT | 15 | Setúbal |
| PT | 16 | Viana do Castelo |
| PT | 17 | Vila Real |
| PT | 18 | Viseu |
| PT | 20 | Região Autónoma dos Açores |
| PT | 30 | Região Autónoma da Madeira |
| QA | DA | Ad Dawhah |
| QA | WA | Al Wakrah |
| QA | RA | Ar Rayyan |
| QA | MS | Madinat ash Shamal |
| QA | US | Umm Salal |
| QA | KH | Al Khawr wa adh Dhakhīrah |
| QA | SH | Ash Shīḩānīyah |
| QA | ZA | Az̧ Z̧a‘āyin |
| RO | AB | Alba |
| RO | AR | Arad |
| RO | AG | Arges |
| RO | BC | Bacau |
| RO | BH | Bihor |
| RO | BN | Bistrita-Nasaud |
| RO | BT | Botosani |
| RO | BR | Braila |
| RO | BV | Brasov |
| RO | B | Bucuresti |
| RO | BZ | Buzau |
| RO | CL | Calarasi |
| RO | CS | Caras-Severin |
| RO | CJ | Cluj |
| RO | CT | Constanta |
| RO | CV | Covasna |
| RO | DB | Dimbovita |
| RO | DJ | Dolj |
| RO | GL | Galati |
| RO | GR | Giurgiu |
| RO | GJ | Gorj |
| RO | HR | Harghita |
| RO | HD | Hunedoara |
| RO | IL | Ialomita |
| RO | IS | Iasi |
| RO | IF | Ilfov |
| RO | MM | Maramures |
| RO | MH | Mehedinti |
| RO | MS | Mures |
| RO | NT | Neamt |
| RO | OT | Olt |
| RO | PH | Prahova |
| RO | SJ | Salaj |
| RO | SM | Satu-Mare |
| RO | SB | Sibiu |
| RO | SV | Suceava |
| RO | TR | Teleorman |
| RO | TM | Timis |
| RO | TL | Tulcea |
| RO | VL | Valcea |
| RO | VS | Vaslui |
| RO | VN | Vrancea |
| RU | BA | Barnaul |
| RU | KL | Kaluga |
| RU | KO | Kostroma |
| RU | KR | Krasnodar |
| RU | KK | Kursk |
| RU | MO | Moscow |
| RU | SA | Samara |
| RU | TA | Tambov |
| RU | TY | Tyumen |
| RU | AD | “Adygeya, Respublika” |
| RU | AL | “Altay, Respublika” |
| RU | ALT | Altayskiy kray |
| RU | AMU | Amurskaya oblast’ |
| RU | ARK | Arkhangel’skaya oblast’ |
| RU | AST | Astrakhanskaya oblast’ |
| RU | BEL | Belgorodskaya oblast’ |
| RU | BRY | Bryanskaya oblast’ |
| RU | BU | “Buryatiya, Respublika” |
| RU | CE | Chechenskaya Respublika |
| RU | CHE | Chelyabinskaya oblast’ |
| RU | CHU | Čukotskij avtonomnyj okrug |
| RU | CU | Čuvašskaja Respublika |
| RU | DA | “Dagestan, Respublika” |
| RU | IN | “Ingushetiya, Respublika” |
| RU | IRK | Irkutskaya oblast’ |
| RU | IVA | Ivanovskaya oblast’ |
| RU | KAM | Kamchatskiy kray |
| RU | KB | Kabardino-Balkarskaya Respublika |
| RU | KC | Karachayevo-Cherkesskaya Respublika |
| RU | KDA | Krasnodarskiy kray |
| RU | KEM | Kemerovskaya oblast’ |
| RU | KGD | Kaliningradskaya oblast’ |
| RU | KGN | Kurganskaya oblast’ |
| RU | KHA | Khabarovskiy kray |
| RU | KHM | Khanty-Mansiyskiy avtonomnyy okrug |
| RU | KIR | Kirovskaya oblast’ |
| RU | KLU | Kalužskaja oblast’ |
| RU | KOS | Kostromskaya oblast’ |
| RU | KRS | Kurskaya oblast’ |
| RU | KYA | Krasnoyarskiy kray |
| RU | LEN | Leningradskaya oblast’ |
| RU | LIP | Lipetskaya oblast’ |
| RU | MAG | Magadanskaya oblast’ |
| RU | ME | “Mariy El, Respublika” |
| RU | MOS | Moskovskaya oblast’ |
| RU | MOW | Moskva |
| RU | MUR | Murmanskaya oblast’ |
| RU | NEN | Nenetskiy avtonomnyy okrug |
| RU | NGR | Novgorodskaya oblast’ |
| RU | NIZ | Nizhegorodskaya oblast’ |
| RU | NVS | Novosibirskaya oblast’ |
| RU | OMS | Omskaya oblast’ |
| RU | ORE | Orenburgskaya oblast’ |
| RU | ORL | Orlovskaya oblast’ |
| RU | PER | Permskiy kray |
| RU | PNZ | Penzenskaya oblast’ |
| RU | PRI | Primorskiy kray |
| RU | PSK | Pskovskaya oblast’ |
| RU | ROS | Rostovskaya oblast’ |
| RU | RYA | Ryazanskaya oblast’ |
| RU | SAK | Sakhalinskaya oblast’ |
| RU | SAM | Samarskaya oblast’ |
| RU | SAR | Saratovskaya oblast’ |
| RU | SE | “Severnaya Osetiya, Respublika” |
| RU | SMO | Smolenskaya oblast’ |
| RU | SPE | Sankt-Peterburg |
| RU | STA | Stavropol’skiy kray |
| RU | SVE | Sverdlovskaya oblast’ |
| RU | TAM | Tambovskaya oblast’ |
| RU | TOM | Tomskaya oblast’ |
| RU | TUL | Tul’skaya oblast’ |
| RU | TVE | Tverskaya oblast’ |
| RU | TYU | Tyumenskaya oblast’ |
| RU | UD | Udmurtskaya Respublika |
| RU | ULY | Ul’yanovskaya oblast’ |
| RU | VGG | Volgogradskaya oblast’ |
| RU | VLA | Vladimirskaya oblast’ |
| RU | VLG | Vologodskaya oblast’ |
| RU | VOR | Voronežskaja oblast’ |
| RU | YAN | Yamalo-Nenetskiy avtonomnyy okrug |
| RU | YAR | Yaroslavskaya oblast’ |
| RU | YEV | Yevreyskaya avtonomnaya oblast’ |
| RU | ZAB | Zabaykal’skiy kray |
| RW | 01 | Ville de Kigali |
| RW | 02 | Iburasirazuba |
| RW | 03 | Northern |
| RW | 04 | Western |
| RW | 05 | Sud |
| SH | AC | Ascension |
| SH | HL | Saint Helena |
| SH | TA | Tristan da Cunha |
| KN | 01 | Christ Church Nichola Town |
| KN | 02 | Saint Anne Sandy Point |
| KN | 03 | Saint George Basseterre |
| KN | 04 | Saint George Gingerland |
| KN | 05 | Saint James Windward |
| KN | 07 | Saint John Figtree |
| KN | 08 | Saint Mary Cayon |
| KN | 10 | Saint Paul Charlestown |
| KN | 11 | Saint Peter Basseterre |
| KN | 12 | Saint Thomas Lowland |
| KN | 13 | Saint Thomas Middle Island |
| KN | 15 | Trinity Palmetto Point |
| KN | 06 | Saint John Capisterre |
| KN | 09 | Saint Paul Capisterre |
| KN | K | Saint Kitts |
| KN | N | Nevis |
| LC | 02 | Castries |
| LC | 03 | Choiseul |
| LC | 05 | Dennery |
| LC | 07 | Laborie |
| LC | 08 | Micoud |
| LC | 10 | Soufriere |
| LC | 01 | Anse la Raye |
| LC | 06 | Gros Islet |
| LC | 11 | Vieux Fort |
| LC | 12 | Canaries |
| VC | 01 | Charlotte |
| VC | 06 | Grenadines |
| VC | 02 | Saint Andrew |
| VC | 03 | Saint David |
| VC | 04 | Saint George |
| VC | 05 | Saint Patrick |
| WS | AA | A’ana |
| WS | AL | Aiga-i-le-Tai |
| WS | AT | Atua |
| WS | FA | Fa’asaleleaga |
| WS | GE | Gaga’emauga |
| WS | GI | Gagaifomauga |
| WS | PA | Palauli |
| WS | SA | Satupa’itea |
| WS | TU | Tuamasaga |
| WS | VF | Va’a-o-Fonoti |
| WS | VS | Vaisigano |
| SM | 01 | Acquaviva |
| SM | 06 | Borgo Maggiore |
| SM | 02 | Chiesanuova |
| SM | 07 | Citta di San Marino |
| SM | 03 | Domagnano |
| SM | 04 | Faetano |
| SM | 05 | Fiorentino |
| SM | 08 | Montegiardino |
| SM | 09 | Serravalle |
| ST | P | Principe |
| ST | 01 | Água Grande |
| ST | 02 | Cantagalo |
| ST | 03 | Caué |
| ST | 04 | Lembá |
| ST | 05 | Lobata |
| ST | 06 | Mé-Zóchi |
| SA | 14 | ‘Asir |
| SA | 11 | Al Bahah |
| SA | 08 | Al Hudud ash Shamaliyah |
| SA | 12 | Al Jawf |
| SA | 05 | Al Qasim |
| SA | 01 | Ar Riyad |
| SA | 06 | Ha’il |
| SA | 10 | Najran |
| SA | 07 | Tabuk |
| SA | 02 | Makkah al Mukarramah |
| SA | 03 | Al Madīnah al Munawwarah |
| SA | 04 | Ash Sharqīyah |
| SA | 09 | Jāzān |
| SN | DK | Dakar |
| SN | DB | Diourbel |
| SN | FK | Fatick |
| SN | KA | Kaolack |
| SN | KD | Kolda |
| SN | LG | Louga |
| SN | MT | Matam |
| SN | SL | Saint-Louis |
| SN | TC | Tambacounda |
| SN | TH | Thies |
| SN | ZG | Ziguinchor |
| SN | KE | Kédougou |
| SN | SE | Sédhiou |
| RS | 00 | Beograd |
| RS | 01 | Severnobački okrug |
| RS | 02 | Srednjebanatski okrug |
| RS | 03 | Severnobanatski okrug |
| RS | 04 | Južnobanatski okrug |
| RS | 05 | Zapadnobački okrug |
| RS | 06 | Južnobački okrug |
| RS | 07 | Sremski okrug |
| RS | 08 | Mačvanski okrug |
| RS | 09 | Kolubarski okrug |
| RS | 10 | Podunavski okrug |
| RS | 11 | Braničevski okrug |
| RS | 12 | Šumadijski okrug |
| RS | 13 | Pomoravski okrug |
| RS | 14 | Borski okrug |
| RS | 15 | Zaječarski okrug |
| RS | 16 | Zlatiborski okrug |
| RS | 17 | Moravički okrug |
| RS | 18 | Raški okrug |
| RS | 19 | Rasinski okrug |
| RS | 20 | Nišavski okrug |
| RS | 21 | Toplički okrug |
| RS | 22 | Pirotski okrug |
| RS | 23 | Jablanički okrug |
| RS | 24 | Pčinjski okrug |
| RS | 25 | Kosovski okrug |
| RS | 26 | Pećki okrug |
| RS | 27 | Prizrenski okrug |
| RS | 28 | Kosovsko-Mitrovački okrug |
| RS | 29 | Kosovsko-Pomoravski okrug |
| RS | KM | Kosovo-Metohija |
| RS | VO | Vojvodina |
| SC | 02 | Anse Boileau |
| SC | 03 | Anse Etoile |
| SC | 05 | Anse Royale |
| SC | 01 | Anse aux Pins |
| SC | 06 | Baie Lazare |
| SC | 07 | Baie Sainte Anne |
| SC | 08 | Beau Vallon |
| SC | 09 | Bel Air |
| SC | 10 | Bel Ombre |
| SC | 11 | Cascade |
| SC | 12 | Glacis |
| SC | 15 | La Digue |
| SC | 16 | La Riviere Anglaise |
| SC | 17 | Mont Buxton |
| SC | 18 | Mont Fleuri |
| SC | 19 | Plaisance |
| SC | 20 | Pointe La Rue |
| SC | 21 | Port Glaud |
| SC | 22 | Saint Louis |
| SC | 23 | Takamaka |
| SC | 04 | O Kap |
| SC | 13 | Grand’Anse Mahé |
| SC | 14 | Grand’Anse Praslin |
| SC | 24 | Les Mamelles |
| SC | 25 | Ros Kaiman |
| SC | 26 | Ile Perseverance I |
| SC | 27 | Ile Perseverance II |
| SL | E | Eastern |
| SL | N | Northern |
| SL | S | Southern |
| SL | W | Western |
| SL | NW | North Western |
| SG | 01 | Central Singapore |
| SG | 02 | North East |
| SG | 03 | North West |
| SG | 04 | South East |
| SG | 05 | South West |
| SK | NI | Nitriansky |
| SK | TC | Trenčiansky |
| SK | ZI | Žilinský |
| SK | BC | Banskobystrický kraj |
| SK | BL | Bratislavský kraj |
| SK | KI | Košický kraj |
| SK | PV | Prešovský kraj |
| SK | TA | Trnavský kraj |
| SI | 001 | Ajdovščina |
| SI | 002 | Beltinci |
| SI | 003 | Bled |
| SI | 004 | Bohinj |
| SI | 005 | Borovnica |
| SI | 006 | Bovec |
| SI | 007 | Brda |
| SI | 008 | Brezovica |
| SI | 009 | Brežice |
| SI | 010 | Tišina |
| SI | 011 | Celje |
| SI | 012 | Cerklje na Gorenjskem |
| SI | 013 | Cerknica |
| SI | 014 | Cerkno |
| SI | 015 | Črenšovci |
| SI | 016 | Črna na Koroškem |
| SI | 017 | Črnomelj |
| SI | 018 | Destrnik |
| SI | 019 | Divača |
| SI | 020 | Dobrepolje |
| SI | 021 | Dobrova-Polhov Gradec |
| SI | 022 | Dol pri Ljubljani |
| SI | 023 | Domžale |
| SI | 024 | Dornava |
| SI | 025 | Dravograd |
| SI | 026 | Duplek |
| SI | 027 | Gorenja vas-Poljane |
| SI | 028 | Gorišnica |
| SI | 029 | Gornja Radgona |
| SI | 030 | Gornji Grad |
| SI | 031 | Gornji Petrovci |
| SI | 032 | Grosuplje |
| SI | 033 | Šalovci |
| SI | 034 | Hrastnik |
| SI | 035 | Hrpelje-Kozina |
| SI | 036 | Idrija |
| SI | 037 | Ig |
| SI | 038 | Ilirska Bistrica |
| SI | 039 | Ivančna Gorica |
| SI | 040 | Izola |
| SI | 041 | Jesenice |
| SI | 042 | Juršinci |
| SI | 043 | Kamnik |
| SI | 044 | Kanal |
| SI | 045 | Kidričevo |
| SI | 046 | Kobarid |
| SI | 047 | Kobilje |
| SI | 048 | Kočevje |
| SI | 049 | Komen |
| SI | 050 | Koper |
| SI | 051 | Kozje |
| SI | 052 | Kranj |
| SI | 053 | Kranjska Gora |
| SI | 054 | Krško |
| SI | 055 | Kungota |
| SI | 056 | Kuzma |
| SI | 057 | Laško |
| SI | 058 | Lenart |
| SI | 059 | Lendava |
| SI | 060 | Litija |
| SI | 061 | Ljubljana |
| SI | 062 | Ljubno |
| SI | 063 | Ljutomer |
| SI | 064 | Logatec |
| SI | 065 | Loška dolina |
| SI | 066 | Loški Potok |
| SI | 067 | Luče |
| SI | 068 | Lukovica |
| SI | 069 | Majšperk |
| SI | 070 | Maribor |
| SI | 071 | Medvode |
| SI | 072 | Mengeš |
| SI | 073 | Metlika |
| SI | 074 | Mežica |
| SI | 075 | Miren-Kostanjevica |
| SI | 076 | Mislinja |
| SI | 077 | Moravče |
| SI | 078 | Moravske Toplice |
| SI | 079 | Mozirje |
| SI | 080 | Murska Sobota |
| SI | 081 | Muta |
| SI | 082 | Naklo |
| SI | 083 | Nazarje |
| SI | 084 | Nova Gorica |
| SI | 085 | Novo Mesto |
| SI | 086 | Odranci |
| SI | 087 | Ormož |
| SI | 088 | Osilnica |
| SI | 089 | Pesnica |
| SI | 090 | Piran |
| SI | 091 | Pivka |
| SI | 092 | Podčetrtek |
| SI | 093 | Podvelka |
| SI | 094 | Postojna |
| SI | 095 | Preddvor |
| SI | 096 | Ptuj |
| SI | 097 | Puconci |
| SI | 098 | Rače-Fram |
| SI | 099 | Radeče |
| SI | 100 | Radenci |
| SI | 101 | Radlje ob Dravi |
| SI | 102 | Radovljica |
| SI | 103 | Ravne na Koroškem |
| SI | 104 | Ribnica |
| SI | 105 | Rogašovci |
| SI | 106 | Rogaška Slatina |
| SI | 107 | Rogatec |
| SI | 108 | Ruše |
| SI | 109 | Semič |
| SI | 110 | Sevnica |
| SI | 111 | Sežana |
| SI | 112 | Slovenj Gradec |
| SI | 113 | Slovenska Bistrica |
| SI | 114 | Slovenske Konjice |
| SI | 115 | Starše |
| SI | 116 | Sveti Jurij ob Ščavnici |
| SI | 117 | Šenčur |
| SI | 118 | Šentilj |
| SI | 119 | Šentjernej |
| SI | 120 | Šentjur |
| SI | 121 | Škocjan |
| SI | 122 | Škofja Loka |
| SI | 123 | Škofljica |
| SI | 124 | Šmarje pri Jelšah |
| SI | 125 | Šmartno ob Paki |
| SI | 126 | Šoštanj |
| SI | 127 | Štore |
| SI | 128 | Tolmin |
| SI | 129 | Trbovlje |
| SI | 130 | Trebnje |
| SI | 131 | Tržič |
| SI | 132 | Turnišče |
| SI | 133 | Velenje |
| SI | 134 | Velike Lašče |
| SI | 135 | Videm |
| SI | 136 | Vipava |
| SI | 137 | Vitanje |
| SI | 138 | Vodice |
| SI | 139 | Vojnik |
| SI | 140 | Vrhnika |
| SI | 141 | Vuzenica |
| SI | 142 | Zagorje ob Savi |
| SI | 143 | Zavrč |
| SI | 144 | Zreče |
| SI | 146 | Železniki |
| SI | 147 | Žiri |
| SI | 148 | Benedikt |
| SI | 149 | Bistrica ob Sotli |
| SI | 150 | Bloke |
| SI | 151 | Braslovče |
| SI | 152 | Cankova |
| SI | 153 | Cerkvenjak |
| SI | 154 | Dobje |
| SI | 155 | Dobrna |
| SI | 156 | Dobrovnik |
| SI | 157 | Dolenjske Toplice |
| SI | 158 | Grad |
| SI | 159 | Hajdina |
| SI | 160 | Hoče-Slivnica |
| SI | 161 | Hodoš |
| SI | 162 | Horjul |
| SI | 163 | Jezersko |
| SI | 164 | Komenda |
| SI | 165 | Kostel |
| SI | 166 | Križevci |
| SI | 167 | Lovrenc na Pohorju |
| SI | 168 | Markovci |
| SI | 169 | Miklavž na Dravskem polju |
| SI | 170 | Mirna Peč |
| SI | 171 | Oplotnica |
| SI | 172 | Podlehnik |
| SI | 173 | Polzela |
| SI | 174 | Prebold |
| SI | 175 | Prevalje |
| SI | 176 | Razkrižje |
| SI | 177 | Ribnica na Pohorju |
| SI | 178 | Selnica ob Dravi |
| SI | 179 | Sodražica |
| SI | 180 | Solčava |
| SI | 181 | Sveta Ana |
| SI | 182 | Sveti Andraž v Slovenskih goricah |
| SI | 183 | Šempeter-Vrtojba |
| SI | 184 | Tabor |
| SI | 185 | Trnovska Vas |
| SI | 186 | Trzin |
| SI | 187 | Velika Polana |
| SI | 188 | Veržej |
| SI | 189 | Vransko |
| SI | 190 | Žalec |
| SI | 191 | Žetale |
| SI | 192 | Žirovnica |
| SI | 193 | Žužemberk |
| SI | 194 | Šmartno pri Litiji |
| SI | 195 | Apače |
| SI | 196 | Cirkulane |
| SI | 197 | Kosanjevica na Krki |
| SI | 198 | Makole |
| SI | 199 | Mokronog-Trebelno |
| SI | 200 | Poljčane |
| SI | 201 | Renče-Vogrsko |
| SI | 202 | Središče ob Dravi |
| SI | 203 | Straža |
| SI | 204 | Sveta Trojica v Slovenskih goricah |
| SI | 205 | Sveti Tomaž |
| SI | 206 | Šmarješke Toplice |
| SI | 207 | Gorje |
| SI | 208 | Log-Dragomer |
| SI | 209 | Rečica ob Savinji |
| SI | 210 | Sveti Jurij v Slovenskih goricah |
| SI | 211 | Šentrupert |
| SI | 212 | Mirna |
| SI | 213 | Ankaran |
| SB | CE | Central |
| SB | CH | Choiseul |
| SB | GU | Guadalcanal |
| SB | IS | Isabel |
| SB | MK | Makira |
| SB | ML | Malaita |
| SB | RB | Rennell and Bellona |
| SB | TE | Temotu |
| SB | WE | Western |
| SB | CT | Capital Territory (Honiara) |
| SO | AW | Awdal |
| SO | BK | Bakool |
| SO | BN | Banaadir |
| SO | BR | Bari |
| SO | BY | Bay |
| SO | GA | Galguduud |
| SO | GE | Gedo |
| SO | HI | Hiiraan |
| SO | JD | Jubbada Dhexe |
| SO | JH | Jubbada Hoose |
| SO | MU | Mudug |
| SO | NU | Nugaal |
| SO | SA | Sanaag |
| SO | SD | Shabeellaha Dhexe |
| SO | SH | Shabeellaha Hoose |
| SO | SO | Sool |
| SO | TO | Togdheer |
| SO | WO | Woqooyi Galbeed |
| ZA | EC | Eastern Cape |
| ZA | FS | Free State |
| ZA | GP | Gauteng |
| ZA | KZN | Kwa Zulu-Natal |
| ZA | LP | Limpopo |
| ZA | MP | Mpumalanga |
| ZA | NW | North West |
| ZA | NC | Northern Cape |
| ZA | WC | Western Cape |
| ES | AL | Álava |
| ES | AV | Ávila |
| ES | AB | Albacete |
| ES | A | Alicante |
| ES | AL | Almeria |
| ES | AS | Asturias |
| ES | BA | Badajoz |
| ES | IB | Baleares |
| ES | BA | Barcelona |
| ES | BU | Burgos |
| ES | CC | Cáceres |
| ES | CA | Cádiz |
| ES | CO | Córdoba |
| ES | CB | Cantabria |
| ES | CL | Castellón |
| ES | CE | Ceuta |
| ES | CR | Ciudad Real |
| ES | CU | Cuenca |
| ES | GI | Girona |
| ES | GR | Granada |
| ES | GU | Guadalajara |
| ES | H | Huelva |
| ES | HU | Huesca |
| ES | J | Jaén |
| ES | CA | La Coruña |
| ES | RI | La Rioja |
| ES | GC | Las Palmas |
| ES | LE | Leon |
| ES | MD | Madrid |
| ES | MA | Malaga |
| ES | ML | Melilla |
| ES | MU | Murcia |
| ES | NA | Navarra |
| ES | P | Palencia |
| ES | PO | Pontevedra |
| ES | SA | Salamanca |
| ES | TF | Santa Cruz de Tenerife |
| ES | SG | Segovia |
| ES | SE | Sevilla |
| ES | SO | Soria |
| ES | TE | Teruel |
| ES | TO | Toledo |
| ES | VC | Valencia |
| ES | VA | Valladolid |
| ES | ZA | Zamora |
| ES | Z | Zaragoza |
| ES | AN | Andalucía |
| ES | AR | Aragón |
| ES | B | Barcelona [Barcelona] |
| ES | BI | Bizkaia |
| ES | C | A Coruña [La Coruña] |
| ES | CM | Castilla-La Mancha |
| ES | CN | Canarias |
| ES | EX | Extremadura |
| ES | GA | Galicia [Galicia] |
| ES | L | Lleida [Lérida] |
| ES | LU | Lugo [Lugo] |
| ES | MC | “Murcia, Región de” |
| ES | NC | “Navarra, Comunidad Foral de” |
| ES | OR | Ourense [Orense] |
| ES | PV | País Vasco |
| ES | SS | Gipuzkoa |
| ES | T | Tarragona [Tarragona] |
| LK | 1 | Western Province |
| LK | 11 | Kŏl̮umpu |
| LK | 12 | Kampahā |
| LK | 13 | Kaḷuttuṟai |
| LK | 2 | Mattiya mākāṇam |
| LK | 21 | Mahanuvara |
| LK | 22 | Māttaḷai |
| LK | 23 | Nuwara Eliya |
| LK | 3 | Tĕṉ mākāṇam |
| LK | 31 | Kāli |
| LK | 32 | Māttaṛai |
| LK | 33 | Hambantota |
| LK | 4 | Vaṭakku mākāṇam |
| LK | 41 | Yāpanaya |
| LK | 42 | Kilinochchi |
| LK | 43 | Mannārama |
| LK | 44 | Vavuniyāva |
| LK | 45 | Mullaittivu |
| LK | 5 | Næ̆gĕnahira paḷāta |
| LK | 51 | Maṭṭakkaḷappu |
| LK | 52 | Ampāṟai |
| LK | 53 | Trincomalee |
| LK | 6 | Vayamba paḷāta |
| LK | 61 | Kuruṇægala |
| LK | 62 | Puttalama |
| LK | 7 | Vaṭamattiya mākāṇam |
| LK | 71 | Anurātapuram |
| LK | 72 | Polonnaruwa |
| LK | 8 | Uva Province |
| LK | 81 | Patuḷai |
| LK | 82 | Mŏṉarākalai |
| LK | 9 | Sabaragamuwa Province |
| LK | 91 | Ratnapura |
| LK | 92 | Kægalla |
| SD | RS | Al Bahr al Ahmar |
| SD | GZ | Al Jazirah |
| SD | KH | Al Khartum |
| SD | GD | Al Qadarif |
| SD | NW | An Nil al Abyad |
| SD | NB | An Nil al Azraq |
| SD | NO | Ash Shamaliyah |
| SD | DW | Gharb Darfur |
| SD | GK | Gharb Kurdufan |
| SD | DS | Janub Darfur |
| SD | KS | Janub Kurdufan |
| SD | KA | Kassala |
| SD | NR | Nahr an Nil |
| SD | DN | Shamal Darfur |
| SD | KN | Shamal Kurdufan |
| SD | SI | Sinnar |
| SD | DC | Wasaţ Dārfūr |
| SD | DE | Sharq Dārfūr |
| SR | BR | Brokopondo |
| SR | CM | Commewijne |
| SR | CR | Coronie |
| SR | MA | Marowijne |
| SR | NI | Nickerie |
| SR | PR | Para |
| SR | PM | Paramaribo |
| SR | SA | Saramacca |
| SR | SI | Sipaliwini |
| SR | WA | Wanica |
| SZ | HH | Hhohho |
| SZ | LU | Lubombo |
| SZ | MA | Manzini |
| SZ | SH | Shiselweni |
| SE | T | Örebro |
| SE | E | Östergötland |
| SE | K | Blekinge |
| SE | W | Dalama |
| SE | X | Gävleborg |
| SE | I | Gotland |
| SE | N | Halland |
| SE | Z | Jämtland |
| SE | F | Jönköping |
| SE | H | Kalmar |
| SE | G | Kronoberg |
| SE | BD | Norrbotten |
| SE | D | Södermanland |
| SE | M | Skåne |
| SE | AB | Stockholm |
| SE | C | Uppsala |
| SE | S | Värmland |
| SE | AC | Västerbotten |
| SE | Y | Västernorrland |
| SE | U | Västmanland |
| SE | O | Västra Götaland |
| CH | AG | Aargau |
| CH | AR | Appenzell Ausserrhoden |
| CH | AI | Appenzell Innerrhoden |
| CH | BL | Basel-Landschaft |
| CH | BS | Basel-Stadt |
| CH | BE | Bern |
| CH | FR | Fribourg |
| CH | GE | Genève |
| CH | GL | Glarus |
| CH | GR | Graubünden |
| CH | JU | Jura |
| CH | LU | Luzern |
| CH | NE | Neuchâtel |
| CH | NW | Nidwald |
| CH | OW | Obwald |
| CH | SH | Schaffhausen |
| CH | SZ | Schwyz |
| CH | SO | Solothurn |
| CH | SG | St. Gallen |
| CH | TG | Thurgau |
| CH | TI | Ticino |
| CH | UR | Uri |
| CH | VS | Valais |
| CH | VD | Vaud |
| CH | ZH | Zürich |
| CH | ZG | Zug |
| SY | HA | Al Hasakah |
| SY | LA | Al Ladhiqiyah |
| SY | QU | Al Qunaytirah |
| SY | RA | Ar Raqqah |
| SY | SU | As Suwayda |
| SY | DY | Dayr az Zawr |
| SY | DI | Dimashq |
| SY | HL | Halab |
| SY | HM | Hamah |
| SY | HI | Hims |
| SY | ID | Idlib |
| SY | RD | Rif Dimashq |
| SY | TA | Tartus |
| SY | DR | Dar’ā |
| TW | CHA | Changhua |
| TW | CYI | Chiayi |
| TW | CYQ | Chiayi |
| TW | HSQ | Hsinchu |
| TW | HSZ | Hsinchu |
| TW | HUA | Hualien |
| TW | ILA | Yilan |
| TW | KEE | Keelung |
| TW | KHH | Kaohsiung |
| TW | KIN | Kinmen |
| TW | LIE | Lienchiang |
| TW | MIA | Miaoli |
| TW | NAN | Nantou |
| TW | NWT | New Taipei |
| TW | PEN | Penghu |
| TW | PIF | Pingtung |
| TW | TAO | Taoyuan |
| TW | TNN | Tainan |
| TW | TPE | Taipei |
| TW | TTT | Taitung |
| TW | TXG | Taichung |
| TW | YUN | Yunlin |
| TJ | GB | Gorno-Badakhstan |
| TJ | KT | Khatlon |
| TJ | SU | Sughd |
| TJ | DU | Dushanbe |
| TJ | RA | nohiyahoi tobei jumhurí |
| TZ | 01 | Arusha |
| TZ | 02 | Dar es Salaam |
| TZ | 03 | Dodoma |
| TZ | 04 | Iringa |
| TZ | 05 | Kagera |
| TZ | 08 | Kigoma |
| TZ | 09 | Kilimanjaro |
| TZ | 12 | Lindi |
| TZ | 26 | Manyara |
| TZ | 13 | Mara |
| TZ | 14 | Mbeya |
| TZ | 16 | Morogoro |
| TZ | 17 | Mtwara |
| TZ | 18 | Mwanza |
| TZ | 06 | Pemba North |
| TZ | 10 | Pemba South |
| TZ | 19 | Pwani |
| TZ | 20 | Rukwa |
| TZ | 21 | Ruvuma |
| TZ | 22 | Shinyanga |
| TZ | 23 | Singida |
| TZ | 24 | Tabora |
| TZ | 25 | Tanga |
| TZ | 07 | Zanzibar North |
| TZ | 11 | Zanzibar South |
| TZ | 15 | Zanzibar West |
| TZ | 27 | Geita |
| TZ | 28 | Katavi |
| TZ | 29 | Njombe |
| TZ | 30 | Simiyu |
| TZ | 31 | Songwe |
| TH | 37 | Amnat Charoen |
| TH | 15 | Ang Thong |
| TH | 14 | Ayutthaya |
| TH | 10 | Bangkok |
| TH | 31 | Buriram |
| TH | 24 | Chachoengsao |
| TH | 18 | Chai Nat |
| TH | 36 | Chaiyaphum |
| TH | 22 | Chanthaburi |
| TH | 50 | Chiang Mai |
| TH | 57 | Chiang Rai |
| TH | 20 | Chon Buri |
| TH | 86 | Chumphon |
| TH | 46 | Kalasin |
| TH | 62 | Kamphaeng Phet |
| TH | 71 | Kanchanaburi |
| TH | 40 | Khon Kaen |
| TH | 81 | Krabi |
| TH | 52 | Lampang |
| TH | 51 | Lamphun |
| TH | 42 | Loei |
| TH | 16 | Lop Buri |
| TH | 58 | Mae Hong Son |
| TH | 44 | Maha Sarakham |
| TH | 49 | Mukdahan |
| TH | 26 | Nakhon Nayok |
| TH | 73 | Nakhon Pathom |
| TH | 48 | Nakhon Phanom |
| TH | 30 | Nakhon Ratchasima |
| TH | 60 | Nakhon Sawan |
| TH | 80 | Nakhon Si Thammarat |
| TH | 55 | Nan |
| TH | 96 | Narathiwat |
| TH | 39 | Nong Bua Lamphu |
| TH | 43 | Nong Khai |
| TH | 12 | Nonthaburi |
| TH | 13 | Pathum Thani |
| TH | 94 | Pattani |
| TH | 82 | Phangnga |
| TH | 93 | Phatthalung |
| TH | 56 | Phayao |
| TH | 67 | Phetchabun |
| TH | 76 | Phetchaburi |
| TH | 66 | Phichit |
| TH | 65 | Phitsanulok |
| TH | 54 | Phrae |
| TH | 83 | Phuket |
| TH | 25 | Prachin Buri |
| TH | 77 | Prachuap Khiri Khan |
| TH | 85 | Ranong |
| TH | 70 | Ratchaburi |
| TH | 21 | Rayong |
| TH | 45 | Roi Et |
| TH | 27 | Sa Kaeo |
| TH | 47 | Sakon Nakhon |
| TH | 11 | Samut Prakan |
| TH | 74 | Samut Sakhon |
| TH | 75 | Samut Songkhram |
| TH | 19 | Sara Buri |
| TH | 91 | Satun |
| TH | 17 | Sing Buri |
| TH | 33 | Sisaket |
| TH | 90 | Songkhla |
| TH | 64 | Sukhothai |
| TH | 72 | Suphan Buri |
| TH | 84 | Surat Thani |
| TH | 32 | Surin |
| TH | 63 | Tak |
| TH | 92 | Trang |
| TH | 23 | Trat |
| TH | 34 | Ubon Ratchathani |
| TH | 41 | Udon Thani |
| TH | 61 | Uthai Thani |
| TH | 53 | Uttaradit |
| TH | 95 | Yala |
| TH | 35 | Yasothon |
| TH | 38 | Bueng Kan |
| TH | S | Phatthaya |
| TL | AL | Aileu |
| TL | AN | Ainaro |
| TL | BA | Baucau |
| TL | BO | Bobonaro |
| TL | CO | Cova Lima |
| TL | DI | Dili |
| TL | ER | Ermera |
| TL | LA | Lautem |
| TL | LI | Liquica |
| TL | MT | Manatuto |
| TL | MF | Manufahi |
| TL | OE | Oecussi |
| TL | VI | Viqueque |
| TG | C | Centrale |
| TG | K | Kara |
| TG | M | Maritime |
| TG | P | Plateaux |
| TG | S | Savanes |
| TO | 02 | Ha’apai |
| TO | 04 | Tongatapu |
| TO | 05 | Vava’u |
| TO | 01 | ‘Eua |
| TO | 03 | Niuas |
| TT | ARI | Arima |
| TT | CHA | Chaguanas |
| TT | DMN | Diego Martin |
| TT | PTF | Point Fortin |
| TT | POS | Port of Spain |
| TT | PRT | Princes Town |
| TT | SFO | San Fernando |
| TT | SGE | Sangre Grande |
| TT | SIP | Siparia |
| TT | TOB | Tobago |
| TT | CTT | Couva-Tabaquite-Talparo |
| TT | MRC | Mayaro-Rio Claro |
| TT | PED | Penal-Debe |
| TT | SJL | San Juan-Laventille |
| TT | TUP | Tunapuna-Piarco |
| TN | 31 | Beja |
| TN | 13 | Ben Arous |
| TN | 23 | Bizerte |
| TN | 81 | Gabes |
| TN | 71 | Gafsa |
| TN | 32 | Jendouba |
| TN | 41 | Kairouan |
| TN | 42 | Kasserine |
| TN | 73 | Kebili |
| TN | 53 | Mahdia |
| TN | 82 | Medenine |
| TN | 52 | Monastir |
| TN | 21 | Nabeul |
| TN | 61 | Sfax |
| TN | 34 | Siliana |
| TN | 51 | Sousse |
| TN | 83 | Tataouine |
| TN | 72 | Tozeur |
| TN | 11 | Tunis |
| TN | 22 | Zaghouan |
| TN | 12 | L’Ariana |
| TN | 14 | La Manouba |
| TN | 33 | Le Kef |
| TN | 43 | Sidi Bouzid |
| TR | 01 | Adana |
| TR | 02 | Adiyaman |
| TR | 03 | Afyonkarahisar |
| TR | 04 | Agri |
| TR | 68 | Aksaray |
| TR | 05 | Amasya |
| TR | 06 | Ankara |
| TR | 07 | Antalya |
| TR | 75 | Ardahan |
| TR | 08 | Artvin |
| TR | 09 | Aydin |
| TR | 10 | Balikesir |
| TR | 74 | Bartin |
| TR | 72 | Batman |
| TR | 69 | Bayburt |
| TR | 11 | Bilecik |
| TR | 12 | Bingol |
| TR | 13 | Bitlis |
| TR | 14 | Bolu |
| TR | 15 | Burdur |
| TR | 16 | Bursa |
| TR | 17 | Canakkale |
| TR | 18 | Cankiri |
| TR | 19 | Corum |
| TR | 20 | Denizli |
| TR | 21 | Diyarbakir |
| TR | 81 | Duzce |
| TR | 22 | Edirne |
| TR | 23 | Elazig |
| TR | 24 | Erzincan |
| TR | 25 | Erzurum |
| TR | 26 | Eskisehir |
| TR | 27 | Gaziantep |
| TR | 28 | Giresun |
| TR | 29 | Gumushane |
| TR | 30 | Hakkari |
| TR | 31 | Hatay |
| TR | 76 | Igdir |
| TR | 32 | Isparta |
| TR | 34 | Istanbul |
| TR | 35 | Izmir |
| TR | 46 | Kahramanmaras |
| TR | 78 | Karabuk |
| TR | 70 | Karaman |
| TR | 36 | Kars |
| TR | 37 | Kastamonu |
| TR | 38 | Kayseri |
| TR | 79 | Kilis |
| TR | 71 | Kirikkale |
| TR | 39 | Kirklareli |
| TR | 40 | Kirsehir |
| TR | 41 | Kocaeli |
| TR | 42 | Konya |
| TR | 43 | Kutahya |
| TR | 44 | Malatya |
| TR | 45 | Manisa |
| TR | 47 | Mardin |
| TR | 33 | Mersin |
| TR | 48 | Mugla |
| TR | 49 | Mus |
| TR | 50 | Nevsehir |
| TR | 51 | Nigde |
| TR | 52 | Ordu |
| TR | 80 | Osmaniye |
| TR | 53 | Rize |
| TR | 54 | Sakarya |
| TR | 55 | Samsun |
| TR | 63 | Sanliurfa |
| TR | 56 | Siirt |
| TR | 57 | Sinop |
| TR | 73 | Sirnak |
| TR | 58 | Sivas |
| TR | 59 | Tekirdag |
| TR | 60 | Tokat |
| TR | 61 | Trabzon |
| TR | 62 | Tunceli |
| TR | 64 | Usak |
| TR | 65 | Van |
| TR | 77 | Yalova |
| TR | 66 | Yozgat |
| TR | 67 | Zonguldak |
| TM | A | Ahal Welayaty |
| TM | B | Balkan Welayaty |
| TM | D | Dashhowuz Welayaty |
| TM | L | Lebap Welayaty |
| TM | M | Mary Welayaty |
| TM | S | Aşgabat |
| TV | FUN | Funafuti |
| TV | NMG | Nanumanga |
| TV | NMA | Nanumea |
| TV | NIT | Niutao |
| TV | NUI | Nui |
| TV | NKF | Nukufetau |
| TV | NKL | Nukulaelae |
| TV | VAI | Vaitupu |
| UG | 301 | Adjumani |
| UG | 302 | Apac |
| UG | 303 | Arua |
| UG | 201 | Bugiri |
| UG | 401 | Bundibugyo |
| UG | 402 | Bushenyi |
| UG | 202 | Busia |
| UG | 304 | Gulu |
| UG | 403 | Hoima |
| UG | 203 | Iganga |
| UG | 204 | Jinja |
| UG | 404 | Kabale |
| UG | 405 | Kabarole |
| UG | 213 | Kaberamaido |
| UG | 101 | Kalangala |
| UG | 102 | Kampala |
| UG | 205 | Kamuli |
| UG | 413 | Kamwenge |
| UG | 414 | Kanungu |
| UG | 206 | Kapchorwa |
| UG | 406 | Kasese |
| UG | 207 | Katakwi |
| UG | 112 | Kayunga |
| UG | 407 | Kibaale |
| UG | 103 | Kiboga |
| UG | 408 | Kisoro |
| UG | 305 | Kitgum |
| UG | 306 | Kotido |
| UG | 208 | Kumi |
| UG | 415 | Kyenjojo |
| UG | 307 | Lira |
| UG | 104 | Luwero |
| UG | 105 | Masaka |
| UG | 409 | Masindi |
| UG | 214 | Mayuge |
| UG | 209 | Mbale |
| UG | 410 | Mbarara |
| UG | 308 | Moroto |
| UG | 309 | Moyo |
| UG | 106 | Mpigi |
| UG | 107 | Mubende |
| UG | 108 | Mukono |
| UG | 311 | Nakapiripirit |
| UG | 109 | Nakasongola |
| UG | 310 | Nebbi |
| UG | 411 | Ntungamo |
| UG | 312 | Pader |
| UG | 210 | Pallisa |
| UG | 110 | Rakai |
| UG | 412 | Rukungiri |
| UG | 111 | Sembabule |
| UG | 215 | Sironko |
| UG | 211 | Soroti |
| UG | 212 | Tororo |
| UG | 113 | Wakiso |
| UG | 313 | Yumbe |
| UG | 114 | Lyantonde |
| UG | 115 | Mityana |
| UG | 116 | Nakaseke |
| UG | 117 | Buikwe |
| UG | 118 | Bukomansibi |
| UG | 119 | Butambala |
| UG | 120 | Buvuma |
| UG | 121 | Gomba |
| UG | 122 | Kalungu |
| UG | 123 | Kyankwanzi |
| UG | 124 | Lwengo |
| UG | 125 | Kyotera |
| UG | 126 | Kasanda |
| UG | 216 | Amuria |
| UG | 217 | Budaka |
| UG | 218 | Bududa |
| UG | 219 | Bukedea |
| UG | 220 | Bukwo |
| UG | 221 | Butaleja |
| UG | 222 | Kaliro |
| UG | 223 | Manafwa |
| UG | 224 | Namutumba |
| UG | 225 | Bulambuli |
| UG | 226 | Buyende |
| UG | 227 | Kibuku |
| UG | 228 | Kween |
| UG | 229 | Luuka |
| UG | 230 | Namayingo |
| UG | 231 | Ngora |
| UG | 232 | Serere |
| UG | 233 | Butebo |
| UG | 234 | Namisindwa |
| UG | 235 | Bugweri |
| UG | 236 | Kapelebyong |
| UG | 237 | Kalaki |
| UG | 314 | Abim |
| UG | 315 | Amolatar |
| UG | 316 | Amuru |
| UG | 317 | Dokolo |
| UG | 318 | Kaabong |
| UG | 319 | Koboko |
| UG | 320 | Maracha |
| UG | 321 | Oyam |
| UG | 322 | Agago |
| UG | 323 | Alebtong |
| UG | 324 | Amudat |
| UG | 325 | Kole |
| UG | 326 | Lamwo |
| UG | 327 | Napak |
| UG | 328 | Nwoya |
| UG | 329 | Otuke |
| UG | 330 | Zombo |
| UG | 331 | Omoro |
| UG | 332 | Pakwach |
| UG | 333 | Kwania |
| UG | 334 | Nabilatuk |
| UG | 335 | Karenga |
| UG | 336 | Madi-Okollo |
| UG | 337 | Obongi |
| UG | 416 | Buliisa |
| UG | 417 | Ibanda |
| UG | 418 | Isingiro |
| UG | 419 | Kiruhura |
| UG | 420 | Buhweju |
| UG | 421 | Kiryandongo |
| UG | 422 | Kyegegwa |
| UG | 423 | Mitooma |
| UG | 424 | Ntoroko |
| UG | 425 | Rubirizi |
| UG | 426 | Sheema |
| UG | 427 | Kagadi |
| UG | 428 | Kakumiro |
| UG | 429 | Rubanda |
| UG | 430 | Bunyangabu |
| UG | 431 | Rukiga |
| UG | 432 | Kikuube |
| UG | 433 | Kazo |
| UG | 434 | Kitagwenda |
| UG | 435 | Rwampara |
| UG | C | Central |
| UG | E | Eastern |
| UG | N | Northern |
| UG | W | Western |
| UA | 40 | Sevastopol |
| UA | 05 | Vinnytska oblast |
| UA | 07 | Volynska oblast |
| UA | 09 | Luhanska oblast |
| UA | 12 | Dnipropetrovska oblast |
| UA | 14 | Donetska oblast |
| UA | 18 | Zhytomyrska oblast |
| UA | 21 | Zakarpatska oblast |
| UA | 23 | Zaporizka oblast |
| UA | 26 | Ivano-Frankivska oblast |
| UA | 30 | Kyiv |
| UA | 32 | Kyivska oblast |
| UA | 35 | Kirovohradska oblast |
| UA | 43 | Avtonomna Respublika Krym |
| UA | 46 | Lvivska oblast |
| UA | 48 | Mykolaivska oblast |
| UA | 51 | Odeska oblast |
| UA | 53 | Poltavska oblast |
| UA | 56 | Rivnenska oblast |
| UA | 59 | Sumska oblast |
| UA | 61 | Ternopilska oblast |
| UA | 63 | Kharkivska oblast |
| UA | 65 | Khersonska oblast |
| UA | 68 | Khmelnytska oblast |
| UA | 71 | Cherkaska oblast |
| UA | 74 | Chernihivska oblast |
| UA | 77 | Chernivetska oblast |
| AE | AJ | ‘Ajman |
| AE | AZ | Abu Zaby |
| AE | FU | Al Fujayrah |
| AE | SH | Ash Shariqah |
| AE | DU | Dubayy |
| AE | RK | R’as al Khaymah |
| AE | UQ | Umm al Qaywayn |
| GB | ABE | Aberdeen City |
| GB | ABD | Aberdeenshire |
| GB | ANS | Angus |
| GB | AGB | Argyll and Bute |
| GB | BDG | Barking and Dagenham |
| GB | BNE | Barnet |
| GB | BNS | Barnsley |
| GB | BAS | Bath and North East Somerset |
| GB | BDF | Bedfordshire |
| GB | BFS | Belfast |
| GB | BEX | Bexley |
| GB | BIR | Birmingham |
| GB | BBD | Blackburn with Darwen |
| GB | BPL | Blackpool |
| GB | BGW | Blaenau Gwent |
| GB | BOL | Bolton |
| GB | BRC | Bracknell Forest |
| GB | BRD | Bradford |
| GB | BEN | Brent |
| GB | BGE | Bridgend [Pen-y-bont ar Ogwr GB-POG] |
| GB | BNH | Brighton and Hove |
| GB | BST | “Bristol, City of” |
| GB | BRY | Bromley |
| GB | BKM | Buckinghamshire |
| GB | BUR | Bury |
| GB | CAY | Caerphilly [Caerffili GB-CAF] |
| GB | CLD | Calderdale |
| GB | CAM | Cambridgeshire |
| GB | CMD | Camden |
| GB | CRF | Cardiff [Caerdydd GB-CRD] |
| GB | CMN | Carmarthenshire [Sir Gaerfyrddin GB-GFY] |
| GB | CBF | Central Bedfordshire |
| GB | CGN | Ceredigion [Sir Ceredigion] |
| GB | CHE | Cheshire East |
| GB | CHW | Cheshire West and Chester |
| GB | CLK | Clackmannanshire |
| GB | CWY | Conwy |
| GB | CON | Cornwall |
| GB | COV | Coventry |
| GB | CRY | Croydon |
| GB | CMA | Cumbria |
| GB | DAL | Darlington |
| GB | DEN | Denbighshire [Sir Ddinbych GB-DDB] |
| GB | DBY | Derbyshire |
| GB | DER | Derby |
| GB | DEV | Devon |
| GB | DNC | Doncaster |
| GB | DOR | Dorset |
| GB | DUD | Dudley |
| GB | DGY | Dumfries and Galloway |
| GB | DND | Dundee City |
| GB | DUR | Durham |
| GB | EAL | Ealing |
| GB | EAY | East Ayrshire |
| GB | EDU | East Dunbartonshire |
| GB | ELN | East Lothian |
| GB | ERW | East Renfrewshire |
| GB | ERY | East Riding of Yorkshire |
| GB | ESX | East Sussex |
| GB | EDH | “Edinburgh, City of” |
| GB | ELS | Eilean Siar |
| GB | ENF | Enfield |
| GB | ESS | Essex |
| GB | FAL | Falkirk |
| GB | FIF | Fife |
| GB | FLN | Flintshire [Sir y Fflint GB-FFL] |
| GB | GAT | Gateshead |
| GB | GLG | Glasgow City |
| GB | GLS | Gloucestershire |
| GB | GRE | Greenwich |
| GB | GWN | Gwynedd |
| GB | HCK | Hackney |
| GB | HAL | Halton |
| GB | HMF | Hammersmith and Fulham |
| GB | HAM | Hampshire |
| GB | HRY | Haringey |
| GB | HRW | Harrow |
| GB | HPL | Hartlepool |
| GB | HAV | Havering |
| GB | HEF | “Herefordshire, County of” |
| GB | HRT | Hertfordshire |
| GB | HLD | Highland |
| GB | HIL | Hillingdon |
| GB | HNS | Hounslow |
| GB | IVC | Inverclyde |
| GB | AGY | Isle of Anglesey [Sir Ynys Môn GB-YNM] |
| GB | IOW | Isle of Wight |
| GB | ISL | Islington |
| GB | KEC | Kensington and Chelsea |
| GB | KEN | Kent |
| GB | KHL | “Kingston upon Hull, City of” |
| GB | KTT | Kingston upon Thames |
| GB | KIR | Kirklees |
| GB | KWL | Knowsley |
| GB | LBH | Lambeth |
| GB | LAN | Lancashire |
| GB | LDS | Leeds |
| GB | LEC | Leicestershire |
| GB | LCE | Leicester |
| GB | LEW | Lewisham |
| GB | LIN | Lincolnshire |
| GB | LIV | Liverpool |
| GB | LND | “London, City of” |
| GB | LUT | Luton |
| GB | MAN | Manchester |
| GB | MDW | Medway |
| GB | MTY | Merthyr Tydfil [Merthyr Tudful GB-MTU] |
| GB | MRT | Merton |
| GB | MDB | Middlesbrough |
| GB | MLN | Midlothian |
| GB | MIK | Milton Keynes |
| GB | MON | Monmouthshire [Sir Fynwy GB-FYN] |
| GB | MRY | Moray |
| GB | NTL | Neath Port Talbot [Castell-nedd Port Talbot GB-CTL] |
| GB | NET | Newcastle upon Tyne |
| GB | NWM | Newham |
| GB | NWP | Newport [Casnewydd GB-CNW] |
| GB | NFK | Norfolk |
| GB | NAY | North Ayrshire |
| GB | NEL | North East Lincolnshire |
| GB | NLK | North Lanarkshire |
| GB | NLN | North Lincolnshire |
| GB | NSM | North Somerset |
| GB | NTY | North Tyneside |
| GB | NYK | North Yorkshire |
| GB | NTH | Northamptonshire |
| GB | NBL | Northumberland |
| GB | NTT | Nottinghamshire |
| GB | NGM | Nottingham |
| GB | OLD | Oldham |
| GB | ORK | Orkney Islands |
| GB | OXF | Oxfordshire |
| GB | PEM | Pembrokeshire [Sir Benfro GB-BNF] |
| GB | PKN | Perth and Kinross |
| GB | PTE | Peterborough |
| GB | PLY | Plymouth |
| GB | POR | Portsmouth |
| GB | POW | Powys |
| GB | RDG | Reading |
| GB | RDB | Redbridge |
| GB | RCC | Redcar and Cleveland |
| GB | RFW | Renfrewshire |
| GB | RCT | “Rhondda, Cynon, Taff [Rhondda, Cynon,Taf]” |
| GB | RIC | Richmond upon Thames |
| GB | RCH | Rochdale |
| GB | ROT | Rotherham |
| GB | RUT | Rutland |
| GB | SLF | Salford |
| GB | SAW | Sandwell |
| GB | SCB | “Scottish Borders, The” |
| GB | SFT | Sefton |
| GB | SHF | Sheffield |
| GB | ZET | Shetland Islands |
| GB | SHR | Shropshire |
| GB | SLG | Slough |
| GB | SOL | Solihull |
| GB | SOM | Somerset |
| GB | SAY | South Ayrshire |
| GB | SGC | South Gloucestershire |
| GB | SLK | South Lanarkshire |
| GB | STY | South Tyneside |
| GB | STH | Southampton |
| GB | SOS | Southend-on-Sea |
| GB | SWK | Southwark |
| GB | SHN | St. Helens |
| GB | STS | Staffordshire |
| GB | STG | Stirling |
| GB | SKP | Stockport |
| GB | STT | Stockton-on-Tees |
| GB | STE | Stoke-on-Trent |
| GB | SFK | Suffolk |
| GB | SND | Sunderland |
| GB | SRY | Surrey |
| GB | STN | Sutton |
| GB | SWA | Swansea [Abertawe GB-ATA] |
| GB | SWD | Swindon |
| GB | TAM | Tameside |
| GB | TFW | Telford and Wrekin |
| GB | THR | Thurrock |
| GB | TOB | Torbay |
| GB | TOF | Torfaen [Tor-faen] |
| GB | TWH | Tower Hamlets |
| GB | TRF | Trafford |
| GB | VGL | “Vale of Glamorgan, The [Bro Morgannwg GB-BMG]” |
| GB | WKF | Wakefield |
| GB | WLL | Walsall |
| GB | WFT | Waltham Forest |
| GB | WND | Wandsworth |
| GB | WRT | Warrington |
| GB | WAR | Warwickshire |
| GB | WBK | West Berkshire |
| GB | WDU | West Dunbartonshire |
| GB | WLN | West Lothian |
| GB | WSX | West Sussex |
| GB | WSM | Westminster |
| GB | WGN | Wigan |
| GB | WIL | Wiltshire |
| GB | WNM | Windsor and Maidenhead |
| GB | WRL | Wirral |
| GB | WOK | Wokingham |
| GB | WLV | Wolverhampton |
| GB | WOR | Worcestershire |
| GB | WRX | Wrexham [Wrecsam GB-WRC] |
| GB | YOR | York |
| GB | ABC | “Armagh City, Banbridge and Craigavon” |
| GB | AND | Ards and North Down |
| GB | ANN | Antrim and Newtownabbey |
| GB | BCP | “Bournemouth, Christchurch and Poole” |
| GB | CCG | Causeway Coast and Glens |
| GB | DRS | Derry and Strabane |
| GB | FMO | Fermanagh and Omagh |
| GB | IOS | Isles of Scilly |
| GB | LBC | Lisburn and Castlereagh |
| GB | MEA | Mid and East Antrim |
| GB | MUL | Mid-Ulster |
| GB | NMD | “Newry, Mourne and Down” |
| UM | 81 | Baker Island |
| UM | 84 | Howland Island |
| UM | 86 | Jarvis Island |
| UM | 67 | Johnston Atoll |
| UM | 89 | Kingman Reef |
| UM | 76 | Navassa Island |
| UM | 95 | Palmyra Atoll |
| UM | 79 | Wake Island |
| UM | 71 | Midway Islands |
| UY | AR | Artigas |
| UY | CA | Canelones |
| UY | CL | Cerro Largo |
| UY | CO | Colonia |
| UY | DU | Durazno |
| UY | FS | Flores |
| UY | FD | Florida |
| UY | LA | Lavalleja |
| UY | MA | Maldonado |
| UY | MO | Montevideo |
| UY | PA | Paysandu |
| UY | RN | Rio Negro |
| UY | RV | Rivera |
| UY | RO | Rocha |
| UY | SA | Salto |
| UY | SJ | San Jose |
| UY | SO | Soriano |
| UY | TA | Tacuarembo |
| UY | TT | Treinta y Tres |
| UZ | AN | Andijon |
| UZ | BU | Buxoro |
| UZ | FA | Farg’ona |
| UZ | JI | Jizzax |
| UZ | NG | Namangan |
| UZ | NW | Navoiy |
| UZ | QA | Qashqadaryo |
| UZ | QR | Qoraqalpog’iston Republikasi |
| UZ | SA | Samarqand |
| UZ | SI | Sirdaryo |
| UZ | SU | Surxondaryo |
| UZ | TK | Toshkent City |
| UZ | TO | Toshkent Region |
| UZ | XO | Xorazm |
| VU | MAP | Malampa |
| VU | PAM | Penama |
| VU | SAM | Sanma |
| VU | SEE | Shefa |
| VU | TAE | Tafea |
| VU | TOB | Torba |
| VE | Z | Amazonas |
| VE | B | Anzoategui |
| VE | C | Apure |
| VE | D | Aragua |
| VE | E | Barinas |
| VE | F | Bolivar |
| VE | G | Carabobo |
| VE | H | Cojedes |
| VE | Y | Delta Amacuro |
| VE | W | Dependencias Federales |
| VE | I | Falcon |
| VE | J | Guarico |
| VE | K | Lara |
| VE | L | Merida |
| VE | M | Miranda |
| VE | N | Monagas |
| VE | O | Nueva Esparta |
| VE | P | Portuguesa |
| VE | R | Sucre |
| VE | S | Tachira |
| VE | T | Trujillo |
| VE | U | Yaracuy |
| VE | V | Zulia |
| VE | A | Distrito Capital |
| VE | X | La Guaira |
| VN | 44 | An Giang |
| VN | 54 | Bac Giang |
| VN | 53 | Bac Kan |
| VN | 55 | Bac Lieu |
| VN | 56 | Bac Ninh |
| VN | 50 | Ben Tre |
| VN | 57 | Binh Duong |
| VN | 58 | Binh Phuoc |
| VN | 40 | Binh Thuan |
| VN | 59 | Ca Mau |
| VN | CT | Can Tho |
| VN | 04 | Cao Bang |
| VN | DN | Da Nang |
| VN | 30 | Gia Lai |
| VN | 03 | Ha Giang |
| VN | 63 | Ha Nam |
| VN | HN | Ha Noi |
| VN | 23 | Ha Tinh |
| VN | 61 | Hai Duong |
| VN | HP | Hai Phong |
| VN | 73 | Hau Giang |
| VN | 14 | Hoa Binh |
| VN | 66 | Hung Yen |
| VN | 01 | Lai Châu |
| VN | 02 | Lào Cai |
| VN | 05 | Sơn La |
| VN | 06 | Yên Bái |
| VN | 07 | Tuyên Quang |
| VN | 09 | Lạng Sơn |
| VN | 13 | Quảng Ninh |
| VN | 18 | Ninh Bình |
| VN | 20 | Thái Bình |
| VN | 21 | Thanh Hóa |
| VN | 22 | Nghệ An |
| VN | 24 | Quảng Bình |
| VN | 25 | Quảng Trị |
| VN | 26 | Thừa Thiên-Huế |
| VN | 27 | Quảng Nam |
| VN | 28 | Kon Tum |
| VN | 29 | Quảng Ngãi |
| VN | 31 | Bình Định |
| VN | 32 | Phú Yên |
| VN | 33 | Đắk Lắk |
| VN | 34 | Khánh Hòa |
| VN | 35 | Lâm Đồng |
| VN | 36 | Ninh Thuận |
| VN | 37 | Tây Ninh |
| VN | 39 | Đồng Nai |
| VN | 41 | Long An |
| VN | 43 | Bà Rịa - Vũng Tàu |
| VN | 45 | Đồng Tháp |
| VN | 46 | Tiền Giang |
| VN | 47 | Kiến Giang |
| VN | 49 | Vĩnh Long |
| VN | 51 | Trà Vinh |
| VN | 52 | Sóc Trăng |
| VN | 67 | Nam Định |
| VN | 68 | Phú Thọ |
| VN | 69 | Thái Nguyên |
| VN | 70 | Vĩnh Phúc |
| VN | 71 | Điện Biên |
| VN | 72 | Đắk Nông |
| VN | SG | Hồ Chí Minh |
| WF | AL | Alo |
| WF | SG | Sigave |
| WF | UV | Uvea |
| YE | AB | Abyan |
| YE | DA | Ad Dali |
| YE | AD | Adan |
| YE | BA | Al Bayda |
| YE | HU | Al Hudaydah |
| YE | JA | Al Jawf |
| YE | MR | Al Mahrah |
| YE | MW | Al Mahwit |
| YE | AM | Amran |
| YE | DH | Dhamar |
| YE | HD | Hadramawt |
| YE | HJ | Hajjah |
| YE | IB | Ibb |
| YE | LA | Lahij |
| YE | MA | Ma’rib |
| YE | SD | Sa’dah |
| YE | SN | San’a |
| YE | SH | Shabwah |
| YE | TA | Ta’izz |
| YE | RA | Raymah |
| YE | SA | Amānat al ‘Āşimah [city] |
| YE | SU | Arkhabīl Suquţrá |
| ZM | 02 | Central |
| ZM | 08 | Copperbelt |
| ZM | 03 | Eastern |
| ZM | 04 | Luapula |
| ZM | 09 | Lusaka |
| ZM | 06 | North-Western |
| ZM | 05 | Northern |
| ZM | 07 | Southern |
| ZM | 01 | Western |
| ZM | 10 | Muchinga |
| ZW | BU | Bulawayo |
| ZW | HA | Harare |
| ZW | MA | Manicaland |
| ZW | MC | Mashonaland Central |
| ZW | ME | Mashonaland East |
| ZW | MW | Mashonaland West |
| ZW | MV | Masvingo |
| ZW | MN | Matabeleland North |
| ZW | MS | Matabeleland South |
| ZW | MI | Midlands |
| BQ | BO | Boneiru |
| BQ | SA | Saba |
| BQ | SE | Sint Eustatius |
| SS | BN | Northern Bahr el Ghazal |
| SS | BW | Western Bahr el Ghazal |
| SS | EC | Central Equatoria |
| SS | EE | Eastern Equatoria |
| SS | EW | Western Equatoria |
| SS | JG | Jonglei |
| SS | LK | Lakes |
| SS | NU | Upper Nile |
| SS | UY | Unity |
| SS | WR | Warrap |
### CS-Cart
The CS-Cart plugin integrates Payneteasy payment processing with the [CS-Cart](https://www.cs-cart.com/) e-commerce platform. It ships as a standard CS-Cart addon (module id `payneteasy`, display name “Paynet Easy Payment”) that registers a new payment processor in the store’s admin panel, so shop administrators can accept card payments through Payneteasy without writing custom code.
A live example of the checkout flow produced by this plugin can be seen on the [CS-Cart demo shop](https://cscart.codetime.net/).
#### Source code
The plugin source is published on Git Hub at [payneteasy/php-plugin-cscart](https://github.com/payneteasy/php-plugin-cscart). The repository contains the addon files under `app/addons/payneteasy` (install/uninstall logic, the payment processor registration, and language files) together with the corresponding `design` templates for the CS-Cart storefront and admin area.
### Коды валют
| Код валюты | Описание |
|--------------|-----------------------------------------|
| AED | United Arab Emirates dirham |
| ALL | Albanian lek |
| AMD | Armenian dram |
| ARS | Argentine peso |
| AUD | Australian dollar |
| AZN | Azerbaijani manat |
| BAM | Bosnia and Herzegovina convertible mark |
| BDT | Bangladeshi taka |
| BGN | Bulgarian lev (obsolete) |
| BHD | Bahraini dinar |
| BIF | Burundian franc |
| BOB | Bolivian boliviano |
| BRL | Brazilian real |
| BWP | Ботсванская пула |
| BYN | Белорусский рубль |
| CAD | Канадский доллар |
| CDF | Конголезский франк |
| CHF | Швейцарский франк |
| CLP | Чилийское песо |
| CNY | Китайский юань |
| COP | Колумбийское песо |
| CRC | Костариканский колон |
| CVE | Эскудо Кабо-Верде |
| CZK | Чешская крона |
| DKK | Датская крона |
| DJF | Джибутийский франк |
| DLS | Программа лояльности DLS |
| DOP | Доминиканское песо |
| DZD | Алжирский динар |
| EGP | Египетский фунт |
| ERN | Эритрейская накфа |
| ETB | Эфиопский быр |
| EUR | Евро |
| FIM | Финская марка (устаревшая) |
| GBP | Фунт стерлингов |
| GEL | Грузинский лари |
| GHS | Ганский седи |
| GMD | Гамбийский даласи |
| GNF | Гвинейский франк |
| GTQ | Гватемальский кетсаль |
| HKD | Гонконгский доллар |
| HNL | Гондурасская лемпира |
| HRK | Хорватская куна (obsolete) |
| HUF | Венгерский форинт |
| IDR | Индонезийская рупия |
| ILS | Новый израильский шекель |
| INR | Индийская рупия |
| IRR | Иранский риал |
| ISK | Исландская крона |
| JOD | Иорданский динар |
| JPY | Японская иена |
| KES | Кенийский шиллинг |
| KGS | Киргизский сом |
| KHR | Камбоджийский риель |
| KMF | Коморский франк |
| Won | Южнокорейская вона |
| KWD | Кувейтский динар |
| KZT | Казахстанский тенге |
| LAK | Лаосский кип |
| LKR | Шри-Ланкийская рупия |
| LSL | Лоти Лесото |
| MAD | Марокканский дирхам |
| MDL | Молдавский лей |
| MGA | Малагасийский ариари |
| MKD | Македонский денар |
| MMK | Мьянманский кьят |
| MNT | Монгольский тугрик |
| MRU | Мавританская угия |
| MUR | Маврикийская рупия |
| MWK | Малавийская квача |
| MXN | Мексиканское песо |
| MYR | Малайзийский ринггит |
| MZN | Мозамбикский метикал |
| NAD | Намибийский доллар |
| NGN | Нигерийская найра |
| NIO | Никарагуанская кордоба |
| NOK | Норвежская крона |
| NZD | Новозеландский доллар |
| OMR | Оманский риал |
| PAB | Панамское бальбоа |
| PEN | Перуанский соль |
| PHP | Филиппинское песо |
| PKR | Пакистанская рупия |
| PLN | Польский злотый |
| PYG | Парагвайский гуарани |
| QAR | Катарский риал |
| RON | Romanian leu |
| RSD | Сербский динар |
| RUB | Российский рубль |
| RWF | Руандийский франк |
| SAR | Саудовский риял |
| SCR | Сейшельская рупия |
| SEK | Шведская крона |
| SGD | Сингапурский доллар |
| SHP | Фунт Святой Елены |
| SLE | Сьерра-леонский леоне |
| SRD | Суринамский доллар |
| STN | Добра Сан-Томе и Принсипи |
| SZL | Лилангени Эсватини |
| THB | Thai baht |
| TJS | Таджикский сомони |
| TMT | Туркменский манат |
| TND | Тунисский динар |
| TRY | Турецкая лира |
| TWD | Тайваньский доллар |
| TZS | Танзанийский шиллинг |
| UAH | Украинская гривна |
| UGX | Угандийский шиллинг |
| USD | Доллар США |
| UYU | Уругвайское песо |
| UZS | Узбекский сум |
| VES | Венесуэльский суверенный боливар |
| VND | Вьетнамский донг |
| WMZ | Web Money WMZ (USD) |
| XAF | Франк КФА BEAC (Центральная Африка) |
| XOF | Франк КФА BCEAO (Западная Африка) |
| ZAR | Южноафриканский рэнд |
| ZMW | Замбийская квача |
| BTC | Биткоин |
| μBTC | Микробиткоин |
| USDT | Tether (стейблкоин) |
| UNS | Не указана (XXX) |
### Миграция данных
Чувствительная информация, такая как данные держателя карты, должна быть зашифрована для миграции в соответствии с требованиями PCI. Шифрование выполняется с помощью PGP-ключа Payneteasy.
После [импорта](https://www.gnupg.org/gph/en/manual.html#AEN84) PGP-ключа Payneteasy выполните следующую команду для шифрования файлов перед отправкой. Будет создан файл file_name.gpg:
```text
gpg --encrypt --recipient 3C7266AE file_name
```
Публичный PGP-ключ Payneteasy
Key ID: 91D14F90
Тип ключа: RSA
Размер ключа: 4096 бит
Fingerprint: C519 7432 AF07 595A C081 3B83 3501 1DD3 CBC2 E0AB
Идентификатор пользователя: ключ импорта Payneteasy (PCI) <[security@Payneteasy.ru](mailto:security@Payneteasy.ru)>
```http
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v2.0.22 (GNU/Linux)
mQINBGLNircBEADNI7fzBBc2NyhhzKGb1gI94ASwNqA37dxPaC8bW1hxThaZV0Aj
jPc1EbMT9UdSjJgHZafvAqYo0EUfJqCS1BFnhjTrHiWWBr1dKQ35dMkUB4UWmius
vungosQeFgAy70eY4MS+2r05DYaBylHHhc/0TZ+v0UOaQp8ch2Uu2C6N7wYT97nV
DC0373StsON36m6k1pXLYuTSzXX9ZgZlLYvK1gyItvBqziT7AsSHeGFFjCFygcCL
i3qrmT2S4JBDXQTDaSCWG36aGTerMvkGlwixnpj6nw1E6GJsApQNY7qahn2rY3UK
40Fk7BniHLbFmR4AK5RvDWNTgu3jDdc1z9dS/6n3beM9HExly3TjpmlZDa1CxhtH
W3o69m/3BbzLOjgW6XQX1QoCjuv1ejw6Hm1b5dphyab2xXfEXS40jghuTKTMK7TN
gAsOn8siD4zTedcWdo4rUUX/WATtyRAyFBDLzORFxj4iRezGda1XfTOIgRqPc/3U
ggQhOT6BQuevdtuHjdSNY36TEJHOPi28xMOPMMpMVA5nPBHX/L+I6Z8Z9/pGDZPa
mQwlg5XebtL2t3AakGQ8goobImavQrNgDPQU+hf3maNAkBzKirqLVcAKjqG/KX7v
AMNUzzXCRqc/yGEobJuSa0wTpf2pJhHqExrAgbn3FEBiu42kY/wE20jyLQARAQAB
tDRQYXluZXRlYXN5IEltcG9ydCBLZXkgKFBDSSkgPHNlY3VyaXR5QHBheW5ldGVh
c3kucnU+iQI/BBMBAgApBQJizYq3AhsDBQkDwmcABwsJCAcDAgEGFQgCCQoLBBYC
AwECHgECF4AACgkQNQEd08vC4KubdA/9G0okz/MOp6Nz7DE2u7Hz0OVoP5OMHQ+U
TdXINlYG0PWJGricF5ohw5jYp/iwgumAb9lXJBc0/h3LZBemW/H0/HCID+wFJT6p
kSoQ2ZGKL37MRdJ6kf9H+VMjGJYS0VOJoj1xWiwUhBjmjeWCAGx88Ovej9IzZsaO
F9hCgsB/PiTm95wdqpwEfh0Cy+C5r03PoWOsa8v4bpMwl3PaNxifaD+uorJX4kOF
EvGIOkrm3o1C6gkZJR2f6RLnazDFlW0KmXUOik1MEosKYCprY2Bk3wBZ0GskyLlY
jcKppVdzfeX66vYUlczR57mlk3GSZzCQHl5fBFoX+yUY+IiowRVqjmneFP6rv9MY
Csvcl/2vdJ8Ou4pyRmRcxJiYhoNSxowWTenbhj40KHUfw7YH3/VLY2UI/LBedEMF
Dx0CqtHSNVogeb5RzzIbhySeXAut79In8AAsvtNT/OMF5ZrZtlNBi6wqZO/invgv
UkdCngSL0+TZAOySwfR0iNZaZJmZ/DfrBuP9p82HZRyK7X9GB/5Ziqs8WStOIzJr
2iQVB9TCKIrE7kWHFxA7HNzfWYgWU32lx/2R+0cH4zwuhFH2rKfrBR6Ekgl8F0+m
tuYqMMBCagF0U6OhFqTtTiQ3cz1A8inNlVkVv9AHI/2Rl5w9hRb88139TtV7aeK2
jbYLHaIwmZC5Ag0EYs2KtwEQAMwaMSjHenq5rU/vVNhhisKKvrzrzHtRFiSnshs8
cWWtr2hyAVRb+loZa5trBs6pal/X+V/fAm7LWBSjt0z1gyZfgamf0PHvmWl5JHiK
O6x22qYLS/F4O4d/tDwUPdPJPx/FXYu/q50B4IsJ0zfoKW2Zwp9hCUoY67EM+8c+
NF5pTqbZ8Fp7zM1oHIkhYRga2qXRW5lxhC8Xojc/nZp65qwW+r2JVlBECa/A2OL8
FsMMObkdgE2W6MWN8zXPayvGinx+PYRne9h8WiyJN9N44aG4No0kd4mXPO9vGXAg
8dhNZxKMXmWOqOBcme6aIVGJQtSEEjTl3qqSxYj8kUdIiR4Fznf5cYvjbzSgXRSi
tJdQu5eOk28c99t4TtnLzR1B6qrPDtwjtApoxw5YsjZKbKweOm+DqzhRVSOsoQE5
DC6CFkmdWybz+2O/UNA4qcJIq4bAHYfYskFHkmkIix71YLIthWq6F9+Fpnq8ZQp5
kX+TqxDyAqhirYhl3kJ/DSstpPe+GjebFWPNkvfXxJ8iwnOUqOzuVerpbWFYF8SC
B0lpxMncoJgx5dIM0QRFcw17rv1+GK8Ga0+8avhZ5hqd4raUvxlY7ZInwsMn70sN
Jc2hH70fYF9U3WW4o6p2IY/bh8V0Pu9nMJIILXFuSN7PdcNpSGk3tdQgJ32seAbc
OWfnABEBAAGJAiUEGAECAA8FAmLNircCGwwFCQPCZwAACgkQNQEd08vC4KtZvBAA
kyJd2aNJhpyQQMVZHUdnXwl/W16r+HwO+gg1nXBTj0swNiNKq9mk78IWKJW+XIEC
5RucAq4c2pg8lCHOwuIpPexEKsHTe6PjFnx6DT6ykaZjZQNiPJAl7QoPu0eUGW2L
vBG4/qlJNKzQQQUHBLMV8MlQhNdx5wBbs8s6UGQ0Q+YUzYCBZ4thQb8SfRSNDGc3
0DitLJD+hSJGeDQ38/1brF8hCQuJcOMYpKv7rWDpBDXY0oWhDWCkQo0F4+Ke+8ou
IUMWc/toyhIHcjRP6XpihC2utFfQE4hlugRn2lOI8vkCQkEidXqYZzvfA7zqdmjX
LYWkISsF6jd7tD/ScN8h9KW58Rq/fTiQ5eXsWbV5fY0wMsJJ6uXL/8/yfvJxw/Zp
YkHA+gIMvdmxTxP3qd+W9Hq+vToD8MbGqPFrVb29+xF6VmzB2KFyvNbiGnwSR7Ke
FuFbKkIoly1hlc7s/N1maU2LS4ByvPh0Q6h7AJO7jJL+/wu2kDoQbCLZ85nRGAth
j2b1ZsftaZk4vdZQrRoTovta5gVYJjxMYwFlBqoucXZF3VXoiBz0Hec6Oh9YsK3a
GGO1yxMkDDJPUSl5p43dfJIg9nVvpB37tFp+vn7Ogu01SLYsXChQWdNdw3BQT4pl
Plb3Yd+plt7shbg9LTSafrv7nNukxPzZmVk1FL9w3Ec=
=m5/V
-----END PGP PUBLIC KEY BLOCK-----
```
### Deposit To Card Transfer
#### Введение
Перевод с пополнением карты (D2C) — перевод средств с банковского счёта Присоединяющейся стороны (Deposit) на номер банковской карты получателя (PAN) или токенизированные данные карты (Card Reference ID). Выполняется в три этапа:
Первоначальный платёж — любой тип транзакции с данными держателя карты: sale, preauth, transfer и т. д. Важно выполнить первоначальный платёж максимально безопасно, чтобы гарантировать регистрацию карты её реальным держателем.
Регистрация карты — получите card-ref-id (идентификатор ссылки на карту) и зарегистрируйте карту клиента в его профиле. Идентификатор ссылки на карту можно использовать неограниченное число раз, пока банковская карта активна.
Перевод денег – выполните команду API v4/transfer-by-ref/, используя destination-card-ref-id, полученный на предыдущем шаге.
Значение терминов см. в [Глоссарии](https://doc.payneteasy.ru/integration/reference/glossary.html.md).
#### Deposit To Card Transfer Flow
```plantuml
@startuml
skinparam roundcorner 20
skinparam sequenceArrowThickness 1
skinparam maxmessagesize 1200
skinparam sequenceParticipant underline
actor Плательщик as P
participant "Присоединяющаяся Сторона" as A
participant "Payneteasy" as B
autonumber
hnote over P,B : Инициация платежа
== Регистрация карты ==
A -> B: api/v2/create-card-ref
activate A
activate B
B --> A: Return card-ref-id
deactivate B
A -> A: Назначение токен ИД профилю Клиента
deactivate A
== Получение информации о карте ==
group Опционально
A -> B: api/v2/get-card-info/
activate A
activate B
B -> A: Получение информации о карте
deactivate A
deactivate B
end
== Списание средств на карту ==
A -> B: api/v4/transfer-by-ref/
activate A
activate B
B --> A: Ответ с ИД транзакции
B -> B: Обработка\nсписания средств
group Получение финального статуса
== Получение обратного вызова \nПрисоединяющейся Стороны ==
A <- B: Обратный вызов с финальным статусом
A --> B: HTTP 200
deactivate B
== Запрос статуса ==
A -> B: Получение статуса по ИД транзакции
activate B
B --> A: Конечный статус
deactivate A
deactivate B
end
@enduml
```
(1) Для реализации регистрации карты и получения Card Reference ID см. [/api/v2/create-card-ref](https://doc.payneteasy.ru/integration/API_commands/api_v2_create-card-ref.html.md).
(3) Присоединяющаяся сторона назначает идентификатор ссылки на карту профилю клиента, после чего отображает страницу с сообщением об успешной регистрации карты и одобрении первоначального платежа.
(4) Сведения о реализации запроса информации о карте по Card Reference ID см. в [/api/v2/get-card-info](https://doc.payneteasy.ru/integration/API_commands/api_v2_get-card-info.html.md). Содержимое ответа на этот запрос можно использовать для отображения Плательщику информации о ранее использованной карте или для обновления базы данных Присоединяющейся стороны. Этот запрос можно выполнять в любое время, если Присоединяющаяся сторона располагает Card Reference ID.
(6) Присоединяющаяся сторона инициирует deposit to card transfer (D2C). Для реализации запроса deposit to card см. [/api/v4/transfer-by-ref](https://doc.payneteasy.ru/integration/API_commands/api_v4_deposit_transfer.html.md)
(9) Для имплементации обратного вызова с обработкой финального статуса см. [Обратный вызов Присоединяющейся Стороны](https://doc.payneteasy.ru/integration/API_commands/merchant_callback_parameters.html.md).
(11) Для реализации запроса статуса заказа см. [/api/v2/status/](https://doc.payneteasy.ru/integration/API_commands/api_v2_status.html.md). Статус следует запрашивать несколько раз с интервалом 3-5 секунд до получения финального статуса в ответе.
(12) Финальный статус может быть отправлен Присоединяющейся стороной на основе внутренней бизнес-модели или по запросу Получателя.
### Описание: Direct Bank transfer
#### Введение
Описание: Direct Bank transfer — международный банковский перевод через сеть Swift. Этот метод позволяет обрабатывать банковские переводы методом Direct (с прямой передачей банковских данных плательщика).
Значение терминов см. в [Глоссарии](https://doc.payneteasy.ru/integration/reference/glossary.html.md).
#### Direct Bank Transfer Flow
```plantuml
skinparam roundcorner 20
skinparam sequenceArrowThickness 1
skinparam maxmessagesize 1200
skinparam sequenceParticipant underline
actor Плательщик
participant "Присоединяющаяся Сторона" as A
participant "Payneteasy" as B
autonumber
Payer -> A: Инициализация
activate A
A -> B: /api/v2/bank-wire-transfer/
activate B
B --> A: ИД транзакции
B -> B: Обработка списания \nсредств Bank Wire
group Получение финального статуса
== Получение обратного вызова \nПрисоединяющейся Стороны ==
A <- B: Обратный вызов с финальным статусом
A --> B: HTTP 200
deactivate B
== Запрос статуса ==
A -> B: Получение статуса по ИД транзакции
activate B
B --> A: Конечный статус
deactivate B
end
A --> Плательщик: Показ результата
deactivate Плательщик
deactivate A
```
(2) Для реализации запроса банковского перевода см. /api/v2/bank-wire-transfer/.
(5) Для реализации обратного вызова с обработкой финального статуса см. [Обратный вызов Присоединяющейся Стороны](https://doc.payneteasy.ru/integration/API_commands/merchant_callback_parameters.html.md).
(7) Для реализации запроса статуса заказа см. [/api/v2/status/](https://doc.payneteasy.ru/integration/API_commands/api_v2_status.html.md). Статус следует запрашивать несколько раз с интервалом 3-5 секунд, пока в ответе не будет получен финальный статус.
### FAQ
#### Информация для диагностики
Пожалуйста, соберите эту информацию и предоставьте ее в службу поддержки для быстрого решения проблем, возникших во время интеграции.
> - Использовалась ли интеграционная среда (песочница) или производственная среда?
> - Работала ли данная функциональность ранее? С какого момента она перестала работать?
> - Добавьте доступную релевантную информацию из журналов (orderid, serial-number, client_orderid, ENDPOINTID, ENDPOINTGROUPID).
#### Часто задаваемые вопросы во время интеграции
##### Что означает ошибка INVALID_CONTROL_CODE?
Расчет подписи различается для разных типов вызовов API. Наиболее распространенные причины:
> - Неверные учетные данные. Проверьте учетные данные, полученные от менеджера платежного шлюза.
> - Вызов API для тестовой среды содержит URL производственной среды или наоборот.
> - Производственные учетные данные (ENDPOINTID, ENDPOINTGROUPID, control key и т. д.) использовались в песочнице или наоборот.
> - Параметры для расчета подписи указаны в неправильном порядке.
> - Сумма транзакции не конвертируется в минимальные десятичные единицы.
Лучший способ проверить расчет подписи — воспользоваться разделами конструктора запросов в документации API:
> - Выберите правильный URL-адрес из раскрывающегося списка с выбором вызовов API, если таковые имеются.
> - После нажатия кнопки Sign, пожалуйста, проверьте значение подписи для String to sign, подписывается ли та же самая строка или нет.
> - Если строка подписи выглядит правильно, значение подписи должно быть таким же, как в поле Signature.
> - Войдите в пользовательский интерфейс и найдите конкретные запросы и ответы API на экране интеграционной панели в разделе Инструменты.
##### В чём разница между ENDPOINTID и ENDPOINTGROUPID?
Шлюз Payneteasy может поддерживать любую валюту.
> - ENDPOINTID поддерживает одну валюту.
> - ENDPOINTGROUPID может поддерживать столько валют, сколько необходимо. Полный список валют следует отправить менеджеру платежного шлюза для настройки проекта.
Из-за разной природы этих двух сущностей невозможно использовать ENDPOINTID вместо ENDPOINTGROUPID и наоборот.
##### Можно ли использовать синхронный API?
Все API асинхронны, см. [Асинхронные ответы](https://doc.payneteasy.ru/integration/general_api_usage/async_response.html.md). Если требуется использование синхронного API, его следует реализовать на Присоединяющейся Стороне. Уточните у менеджера платёжного шлюза, возможно ли делать синхронные вызовы в вашей интеграции.
##### Как реализовать 3-D Secure (Verified by Visa / Master Card Secure Code) в собственном мобильном приложении?
Даже в собственном приложении необходимо использовать встроенный компонент Web View для открытия URL-адреса банковского сервера ACS.
Для обработки транзакций без перенаправления на страницу 3-D Secure приложение Присоединяющейся Стороны должно соответствовать следующим требованиям:
> - Плательщики идентифицированы, и вероятность мошенничества в этом случае низкая Присоединяющаяся Сторона может попросить менеджера платежного шлюза открыть счёт non3D.
> - У Присоединяющейся Стороны есть сертификат PCI DSS, и она может собирать данные о держателях карт на своей стороне. В этом случае Присоединяющаяся Сторона может попросить менеджера платежного шлюза открыть счет с поддержкой Direct API, чтобы избежать ненужных перенаправлений.
##### Что такое client_orderid?
Данный идентификатор транзакции генерируется на Присоединяющейся Стороне. Также в некоторых API данный параметр называется как merchant-order-id.
##### Как получить одобренную транзакцию в среде песочницы?
Для разных типов API Payneteasy имеет разные механизмы для получения одобренных транзакций и транзакций в других статусах. Для транзакций электронной коммерции Payneteasy использует разные CVV, см. [test_cards](https://doc.payneteasy.ru/integration/general_api_usage/test_scenarios.html.md). Для транзакций mPOS см. [mpos](https://doc.payneteasy.ru/integration/mpos_api_index.html.md).
##### Почему ответ отформатирован как (0xA)?
Для улучшения читаемости ответа в большинстве API Payneteasy добавляет символ (0xA) в конце каждого значения параметра. Для обработки ответа от платежного шлюза, пожалуйста, реализуйте механизм обработки этого символа.
##### Можно ли использовать redirect_url для получения статуса транзакции для бэк-офиса?
Это не рекомендуется.
Все параметры для конечного редиректа передаются через браузер клиента. Параметры могут быть утеряны во время передачи через интернет. Чтобы получить гарантированный результат от шлюза Payneteasy, см. [Обратный вызов Присоединяющейся Стороны](https://doc.payneteasy.ru/integration/API_commands/merchant_callback_parameters.html.md).
##### Можно ли использовать GET вместо POST для отправки данных на шлюз Payneteasy?
К сожалению это невозможно.
Передача параметров с использованием HTTP GET строго запрещена во избежание возможных утечек данных.
##### Что означает INVALID_CALLBACK_URL?
Пожалуйста, используйте полный публичный URL-адрес с http:// или https://
Например, [http://www.example.com](http://www.example.com) или [https://www.example.com](https://www.example.com) вместо www.example.com. Разрешены только следующие порты:
> - 80, 8080 для HTTP
> - 443, 8443 для HTTPS
##### Как часто можно опрашивать статус транзакции?
Статус следует запрашивать несколько раз с интервалом в 3–5 секунд, пока в ответ не будет получен окончательный статус.
Обычно обработка не3D-транзакции занимает до 5 секунд, а 3D-транзакции — до 60 минут. Транзакции, выполненные с помощью некоторых платежных методов или платежных каналов, особенно обработанные в автономном режиме, могут оставаться в нефинальном статусе в течение нескольких часов или даже дней, поэтому нет смысла часто опрашивать статус транзакции в таких случаях. Присоединяющаяся Сторона должна полагаться на обратный вызов для получения финального статуса транзакции, см. [Обратный вызов Присоединяющейся Стороны](https://doc.payneteasy.ru/integration/API_commands/merchant_callback_parameters.html.md).
##### Почему транзакция была отклонена из-за ошибки base 64?
Пожалуйста, используйте urldecode для обработки параметра html в ответе шлюза Payneteasy.
Эта ошибка введена Payneteasy для помощи Присоединяющейся Стороне в правильной обработке ответов API. Тест Base64 дает Присоединяющейся Стороне возможность проверить, будет ли страница 3DS, предоставленная банком, правильно обработана в производственной среде. Если Connecting Party получает эту ошибку, это означает, что urldecode, вероятно, не использовался для разбора ответа шлюза Payneteasy или, возможно, он работает неправильно (например, в некоторых версиях PHP вместо этого необходимо использовать rawurldecode).
### Финальное Перенаправление
#### Параметры Финального Перенаправления
Финальное перенаправление на сайт торговца (представленного Присоединяющейся Стороной) осуществляется, когда Плательщик завершает процесс оплаты. Финальное перенаправление инициируется внутри браузера клиента с помощью метода HTTP POST.
| Название параметра перенаправления | Описание |
|--------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| status | Подробности см. в [Список статусов](https://doc.payneteasy.ru/integration/reference/statuses.html.md). |
| orderid | Идентификатор заказа, присвоенный заказу gate.payneteasy.ru. |
| merchant_order | Идентификатор заказа Присоединяющейся Стороны. |
| client_orderid | Идентификатор заказа Присоединяющейся Стороны. |
| error_message | Для транзакций в статусе declined или error, этот параметр будет содержать причину отклонения или сведения об ошибке. |
| control | Контрольная сумма, подтверждающая, что gate.payneteasy.ru (а не мошенник) инициирует запрос. Представляет собой хеш SHA-1 от конкатенации параметров status + orderid + client_orderid + merchant-control. |
| descriptor | Дескриптор шлюза. |
| processor-tx-id | Идентификатор транзакции, присвоенный Эквайером. |
| amount | Фактическая сумма транзакции. |
| bin | Банковский BIN кредитной карты клиента. |
| type | Тип ответа. |
| card-type | Тип карты плательщика. |
| phone | Номер телефона плательщика. |
| last-four-digits | Последние четыре цифры карты плательщика. |
| card-holder-name | Имя на карте плательщика. |
| error_code | Код ошибки. |
Присоединяющейся Стороне не рекомендуется использовать перенаправление плательщика как основной источник информации о статусе транзакции. Если Присоединяющейся Стороной был передан параметр server_callback_url в инициирующем запросе на проведение транзакции, Платёжный Шлюз вызовет этот URL при достижении транзакцией финального статуса. Присоединяющаяся Сторона может использовать этот URL для произвольной обработки информации о транзакции, например, для сбора информации о транзакциях в базу данных. Параметры, отправляемые на URL обратного вызова описаны в разделе [Обратный вызов](https://doc.payneteasy.ru/integration/merchant_callback_parameters.html.md).
#### Пример запроса финального перенаправления
Платёжный Шлюз совершает перенаправление методом POST на адрес https://connectingparty.com/pay/redirect?token=some_token с параметрами в формате x-www-form-urlencoded format:
```http
error_message=null
&processor-tx-id=PNTEST-1788082
&amount=100.00
&merchant_order=test
&orderid=1788082
&client_orderid=test
&bin=444455
&control=854f38715ee6bf43fa18e3ca202985a06e0ae755
&gate-partial-reversal=enabled
&descriptor=DEMO1
&gate-partial-capture=enabled
&type=sale
&card-type=VISA
&phone=%2B31201112233
&last-four-digits=1111
&card-holder-name=TEST+HOLDER
&status=approved
```
### Сервис фискализации
#### Введение
Сервис фискализации используется для регистрации финансовых чеков и счетов в Платёжном Шлюзе Payneteasy и их дальнейшей обработки. Фискализация поддерживается как для первоначальных, так и для рекуррентных транзакций Sale и Preauth через интеграцию Server-To-Server или Form. Подходящий сценарий интеграции см. в соответствующих примерах использования или уточните детали у менеджера службы поддержки. Транзакция с чеком/счётом обрабатывается Платёжным Шлюзом Payneteasy с дополнительными запросами для налогового учёта.
#### Параметр сервиса фискализации (чек)
Чтобы инициировать транзакцию с использованием сервиса фискализации, Присоединяющаяся сторона отправляет HTTPS POST-запрос на Sale или Preauth с дополнительным параметром.
| Параметры запроса | Проверка | Comment |
|---------------------|-----------------------|-----------------------------------------------------------------------------|
| cheque | Описание: Json string | Финансовый чек или счёт. Обязательно для запроса транзакции с фискализацией |
#### Структура строки JSON для параметра чека
Пример простой строки JSON для параметра cheque:
```http
{
"cheque_type" : 1,
"tax_system" : 1,
"positions" : [
{
"quantity" : 2,
"price" : 322.94,
"tax" : 4,
"description" : "Product/Service 1"
},
{
"quantity" : 1,
"price" : 500,
"tax" : 4,
"description" : "Product/Service 2"
}
]
}
```
Параметры строки JSON:
| Параметр | Проверка | Comment | Описание: Possible values |
|-------------|-------------|------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| cheque_type | Десятичный | Тип/признак расчёта | 0 — доход, 1 — расход, 2 — возврат дохода, 3 — возврат расхода |
| tax_system | Десятичный | Описание: Tax system | 0 — общая система налогообложения, 1 — упрощённая система налогообложения доходов, 2 — упрощённая система «доходы минус расходы», 3 — единый налог на вменённый доход, 4 — единый сельскохозяйственный налог, 5 — патентная система налогообложения. |
| positions | Array | Массив товаров/услуг | Массив товаров/услуг |
| quantity | Десятичный | Количество товара/услуги | |
| price | Десятичный | Цена за товар/услугу с учётом скидок и наценок | |
| tax | Десятичный | Описание: value-added tax | 1 — НДС 22%, 2 — НДС 10%, 3 — НДС 0%, 4 — без НДС, 5 — НДС 22/122, 6 — НДС 10/110 |
| description | String(128) | Описание товара/услуги | |
> **Note:** Обратите внимание: общая стоимость всех товаров/услуг, указанных в массиве positions, должна быть равна значению параметра amount в запросе Sale.
#### Пример запроса транзакции с фискализацией
Этот пример тела запроса Server-To-Server Sale с фискализацией показывает, как правильно включить параметр чека. Пример ответа приведён в документации соответствующей команды API.
```http
client_orderid=902B4FF5
&order_desc=Test Order Description
&first_name=John
&last_name=Smith
&ssn=1267
&birthday=19820115
&address1=100 Main st
&city=Seattle
&state=WA
&zip_code=98102
&country=US
&phone=%2B12063582043
&cell_phone=%2B19023384543
&amount=700.00
&email=john.smith@gmail.com
¤cy=USD
&ipaddress=65.153.12.232
&site_url=www.google.com
&credit_card_number=4538977399606732
&card_printed_name=CARD HOLDER
&expire_month=12
&expire_year=2099
&cvv2=123
&purpose=user_account1
&redirect_url=https://doc.payneteasy.ru/doc/dummy.htm
&server_callback_url=https://httpstat.us/200
&merchant_data=VIP customer
&cheque={ "cheque_type" : 1, "tax_system" : 1, "positions" : [ { "quantity" : 2, "price" : 100.00, "tax" : 4, "description" : "Product/Service 1" }, { "quantity" : 1, "price" : 500, "tax" : 4, "description" : "Product/Service 2" } ] }
&control=768eb8162fc361a3e14150ec46e9a6dd8fbfa483
```
### Forms Customization
#### Платёж Page Display Logic
```plantuml
skinparam ConditionEndStyle hline
: (1) Initiate transaction;
if ((2) Additional Payer input required?) then (yes)
: (3) return input form;
: (4) submit form;
else (no)
endif
if ((5) External form required?) then (yes)
: (6) request external form from the payment provider;
: (7) redirect to external form;
: (8) submit form on payment provider side;
else (no)
endif
: (9) show wait form;
: (10) process transaction;
: (11) show finish form or redirect \nto Connecting Party website;
```
(1) Транзакции могут инициироваться API-запросами, пакетной загрузкой или через виртуальный терминал в UI. Для каждого метода оплаты предусмотрена собственная логика отображения платёжной страницы.
> **Note:** Payment Cashier может содержать несколько транзакций, инициированных в рамках одного платёжного сеанса, поскольку для Плательщика может быть доступно несколько способов оплаты. Когда Плательщик выбирает вкладку оплаты, инициируется соответствующая вспомогательная транзакция. См. [Настройка страницы Payment Cashier](#payment-cashier-page-customization-reference).
(3) Для способа оплаты банковской картой форма отображается на стороне Платёжного Шлюза и может быть настроена. См. [Настройка страницы оплаты](#payment-page-customization-reference). Для некоторых других способов оплаты на стороне Платёжного Шлюза могут быть дополнительные формы. За подробностями обратитесь в службу поддержки Payneteasy.
(7) Некоторые методы оплаты требуют перенаправления плательщика на собственную форму. Эта форма не размещается Платёжным Шлюзом и не может быть настроена.
(9) Пока транзакция не достигнет финального статуса, Платёжный Шлюз отображает [Wait Form](#wait-page-customization-reference) для Плательщика.
(11) После достижения транзакцией окончательного статуса Платёжный Шлюз показывает плательщику [Finish Form](#finish-page-customization-reference) или выполняет [перенаправление](https://doc.payneteasy.ru/integration/API_commands/final_redirect.html.md) на сайт Присоединяющейся стороны.
#### Payment Page Customization
##### Payment Page Example
```html