Параметр | Признак обязательности | Описание |
---|---|---|
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 |