6. Список дополнительных полей для идентификации отправителя и получателя переводов
Здесь находится cписок дополнительных полей для идентификации отправителя и получателя переводов при использовании платежного портала Процессингового центра "Прокард"
В случае необходимости передачи дополнительной информации в транзакциях переводов, при выполнении административной операции CreateOrder в блоке <Order>/<AddParams> могут быть использованы следующие дополнительные параметры:
Параметр | Признак обязательности | Описание |
---|---|---|
Order.AddParams.SenderName | Если мерчанту необходимо передать информацию по крайней мере в одном из этих полей, то мерчант должен заполнить все эти поля. Допускается значение UNKNOWN, либо другое приемлемое значение в случаях, если согласно закона заполнение поля не обязательно. | Имя отправителя. Указывается латинскими буквами в верхнем регистре в формате: Имя <пробел> Фамилия |
Order.AddParams.ResidentCityInLatin | Город резидентства отправителя. Указывается латинскими буквами в верхнем регистре | |
Order.AddParams.ResidentCountry | Код страны резидентства отправителя по ISO 3166-1 Numeric (например: 804) | |
Order.AddParams.SenderPostalCode | Почтовый индекс отправителя | |
Order.AddParams.Address | Адрес отправителя латинскими буквами | |
Order.AddParams.RecipientName | Имя получателя латинскими буквами в формате: | |
Order.AddParams.IdentificationType | Опционально Поля IdentificationType и IdentityNumber используются только в паре. Если заполнено одно поле, то должно быть заполнено и второе поле. | Тип идентификационного документа: 1 –паспорт; 2 –водительское удостоверение; 3 –номер социальной страховки; 4 –ИНН; 5 –национальный идентификатор; 6 – заграничный паспорт; 7 – военный билет; 8 – иной тип документа |
Order.AddParams.IdentityNumber | Номер идентификационного документа | |
Order.AddParams.SenderType | Опционально | Тип отправителя. 0 – unknown; 1 – on-us; 2 – resident; 3 – foreign |
Order.AddParams.ResidentState | Обязателен, если ResidentCountry = 840 (США) | Код штата резидентства отправителя средств |
Пример XML-запроса административной операции CreateOrder с доппараметрами:
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Request>
<Operation>CreateOrder</Operation>
<Language>RU</Language>
<Order>
<OrderType>Purchase</OrderType>
<Merchant>TEST_TRADER</Merchant>
<Amount>5000</Amount>
<Currency>980</Currency>
<Description>Тестовая покупка</Description>
<AddParams>
<SenderName>IVAN IVANOV</SenderName>
<ResidentCityInLatin>KYIV</ResidentCityInLatin>
<ResidentCountry>804</ResidentCountry>
<SenderPostalCode>10000</SenderPostalCode>
<Address>12, Ulitchnaya str</Address>
<RecipientName>PETYA PETROV</RecipientName>
<IdentificationType>1</IdentificationType>
<IdentityNumber>ABC123</IdentityNumber>
<SenderType>2</SenderType>
<ResidentState>KYV</ResidentState>
</AddParams>
</Order>
</Request>
</TKKPG>
Пример XML-запроса административной операции P2PCredit с полем Account:
<?xml version=”1.0” encoding=”UTF-8”?>
<TKKPG>
<Request>
<Operation>P2PCredit</Operation>
<Order>
<Merchant></Merchant>
<OrderID></OrderID>
<AddParams></AddParams>
</Order>
<SessionID></SessionID>
<Amount></Amount>
<Currency></Currency>
<Account></Account>
<ExpDate></ExpDate>
<CVV2></CVV2>
<CAVV></CAVV>
<eci></eci>
<IP></IP>
<PAN2></PAN2>
<Fee></Fee>
<OrigAmount></OrigAmount>
<OrigCurrency></OrigCurrency>
</Request>
</TKKPG>
Рекомендации по выбору полей для заполнения:
Данные согласно Закона | Поля Прокард P2PTransfer | Поля Прокард P2PDebit | Поля Прокард P2PCredit |
---|---|---|---|
унікальний номер електронного платіжного засобу платника | PAN | PAN | Account например, <Account>4444123456785555</Account> |
унікальний номер електронного гаманця/рахунку (IBAN) платника | N/A
| N/A
| Account например, <Account>UA123 5546655656565456564364</Account> поле указывается в административной операции P2PCredit |
ПІБ платника | AddParams.SenderName | AddParams.SenderName | AddParams.SenderName |
місце проживання платника | AddParams.ResidentCountry; AddParams.SenderPostalCode; AddParams.ResidentCityInLatin; AddParams.Address | AddParams.ResidentCountry; AddParams.SenderPostalCode; AddParams.ResidentCityInLatin; AddParams.Address | AddParams.ResidentCountry; AddParams.SenderPostalCode; AddParams.ResidentCityInLatin; AddParams.Address |
номер паспорта платника | AddParams.IdentificationType=1; AddParams.IdentityNumber | AddParams.IdentificationType=1; AddParams.IdentityNumber | AddParams.IdentificationType=1; AddParams.IdentityNumber |
ІПН платника | AddParams.IdentificationType=4; AddParams.IdentityNumber | AddParams.IdentificationType=4; AddParams.IdentityNumber | AddParams.IdentificationType=4; AddParams.IdentityNumber |
дата та місце народження платника | SenderDateOfBirth - дата рождения отправителя в формате YYYYMMDD; SenderCountryOfBirth - числовой код страны рождения отправителя по ISO 3166-1 Numeric | SenderDateOfBirth - дата рождения отправителя в формате YYYYMMDD; SenderCountryOfBirth - числовой код страны рождения отправителя по ISO 3166-1 Numeric | SenderDateOfBirth - дата рождения отправителя в формате YYYYMMDD; SenderCountryOfBirth - числовой код страны рождения отправителя по ISO 3166-1 Numeric |
повне найменування платника | AddParams.SenderName | AddParams.SenderName | AddParams.SenderName |
місце розташування платника | AddParams.ResidentCountry; AddParams.SenderPostalCode; AddParams.ResidentCityInLatin; AddParams.Address | AddParams.ResidentCountry; AddParams.SenderPostalCode; AddParams.ResidentCityInLatin; AddParams.Address | AddParams.ResidentCountry; AddParams.SenderPostalCode; AddParams.ResidentCityInLatin; AddParams.Address |
ЄДРПОУ платника | AddParams.IdentificationType=4; AddParams.IdentityNumber | AddParams.IdentificationType=4; AddParams.IdentityNumber | AddParams.IdentificationType=4; AddParams.IdentityNumber |
унікальний номер електронного платіжного засобу отримувача | PAN2 | Account2 например, <Account2>4444123456785555</Account2> поле указывается в административной операции P2PDebit | PAN2 |
унікальний номер електронного гаманця/рахунку (IBAN) отримувача | N/A | Account2 например, <Account2>UA123 5546655656565456564364</Account2> поле указывается в административной операции P2PDebit | N/A |
ПІБ отримувача | AddParams.RecipientName | AddParams.RecipientName | AddParams.RecipientName |
повне найменування отримувача | AddParams.RecipientName | AddParams.RecipientName | AddParams.RecipientName |
дані, що дозволяють визначити особу, яка уклала договір з отримувачем про поставку товарів, виконання робіт, надання послуг, надання кредиту | N/A | AddParams.RecipientName | N/A |
Copyright © 2015-2021 PROCARD