Описание запросов для взаимодействия с Приват24.


Адреса серверов (Украина):

https://client-bank.privatbank.ua

https://cb.privatbank.ua

https://p24.privatbank.ua 


:: Остатки на счетах ::

Запрос: 

По всем счетам:

https://client-bank.privatbank.ua/p24/c2brest?endate=04.04.2013&stdate=04.04.2013&UserName=XXXXXX&UserPass=XXXXXXXXX&PUREXML=true

Описание параметров запроса:

& - разделяющий символ между параметрами

endate= конечная дата (пример: 04.04.2013)

stdate= начальная дата (пример: 04.04.2013)

UserName= - логин пользователя

UserPass= - пароль пользователя

PUREXML=true - параметр, который возвращает XML

По одному счету:

https://client-bank.privatbank.ua/p24/c2brest?acc=26002600260000&endate=26.03.2012&in_time=d&stdate=26.03.2012&UserName=XXXXX&UserPass=ZZZZZZZZ&PUREXML=true

Описание параметров:

acc= номер счета

& - разделяющий символ между параметрами

endate= конечная дата (пример: 04.04.2013)

stdate= начальная дата (пример: 04.04.2013)

UserName= - логин пользователя

UserPass= - пароль пользователя

PUREXML=true - параметр, который возвращает XML

Ссылки на данные, внутри полученного xml:

//rests/list/row/turn/@account - счет

//rests/list/row/turn/text() - наименование счета

//rests/list/row/turn/date/@id - дата

//rests/list/row/turn/customer/@crf - код ЕГРПОУ / ИНН клиента

//rests/list/row/turn/customer/text() - наименование клиента

//rests/list/row/turn/ccy/@code - валюта счета

//rests/list/row/turn/debet - сумма списаний со счета (дебет счета)

//rests/list/row/turn/credit - сумма поступлений на счет (кредит счета)

//rests/list/row/turn/inrest - входящий остаток

//rests/list/row/turn/outrest - текущий / исходящий остаток

//rests/list/row/turn/credLim - сумма кредитного лемита

//rests/list/row/turn/eqdebet - сумма списаний со счета (дебет счета) в грн. эквиваленте

//rests/list/row/turn/eqcredit - сумма поступлений на счет (кредит счета) в грн. эквиваленте

//rests/list/row/turn/eqinrest - входящий остаток в грн. эквивалент

//rests/list/row/turn/eqoutrest - текущий / исходящий остаток в грн. эквиваленте


:: Выписка по счетам ::

Запрос:

По всем доступным счетам:

https://client-bank.privatbank.ua/p24/c2bstatements?stdate=01.12.2012&endate=25.12.2012&showInf&UserName=XXXXXXXXX&UserPass=YYYYYYYYYYY&PUREXML=true

Описание параметров запроса:

stdate= - дата начала выписки

& - разделяющий символ между параметрами

endate= дата окончания выписки

showInf= показать и информационные документы**

UserName= - логин пользователя

UserPass= - пароль пользователя

XMPUREXML=true - параметр, который возвращает XML

По одному счету:

https://client-bank.privatbank.ua/p24/c2bstatements?stdate=01.02.2010&endate=04.02.2010&acc=26002600260000&showInf&UserName=XXXXX&UserPass=ZZZZZZZZ&PUREXML=true

Описание параметров запроса:

stdate= - дата начала выписки

& - разделяющий символ между параметрами

endate= дата окончания выписки

showInf= показать и информационные документы**

acc= счет для выписки

UserName= - логин пользователя

UserPass= - пароль пользователя

XMPUREXML=true - параметр, который возвращает XML

Ссылки на данные, внутри полученного xml:

//statements/list/row/info/@number - номер платежа

//statements/list/row/info/@postdate - дата и время проводки

//statements/list/row/info/@customerdate - клиентская дата и время

//statements/list/row/info/@ref - банковский референс

//statements/list/row//info/@state - состояние документа (r - проведен, t - сторнирован)

//statements/list/row//info/@flinfo - вид платежа (r - реальный, i - информационный)

//statements/list/row//info/@doctype - тип документа (p - поручение, t - требование, m - мемориальный ордер, x - приходный ордер, r - расходный ордер)

//statements/list/row/amount/@amt - сумма платежа

//statements/list/row/amount/@ccy - валюта платежа

//statements/list/row/debet/account/@name - наименование плательщика

//statements/list/row/debet/account/@number - счет плательщика

//statements/list/row/debet/account/customer/@crf - код ИНН / ЕГРПОУ плательщика

//statements/list/row/debet/account/customer/bank/@code - МФО банка плательщика

//statements/list/row/debet/account/customer/bank/city/text() - наимнование банка плательщика

//statements/list/row/credit/account/@name - наименование получателя

//statements/list/row/credit/account/@number - счет получателя

//statements/list/row/credit/account/customer/@crf - код ИНН / ЕГРПОУ получателя

//statements/list/row/credit/account/customer/bank/@code - МФО банка получателя

//statements/list/row/credit/account/customer/bank/city/text() - наименование банка получателя

//statements/list/row/purpose - назначение платежа


:: Консолидированная выписка по всем картам корпорации ::

Запрос: 

За месяц: https://client-bank.privatbank.ua/p24/iqcorpcardstatements?corporation=DN04-326576562&in_time=m&month=2&year=2013&UserName=XXXXXX&UserPass=YYYYYYYYY&PUREXML=true

Описание параметров запроса:

corporation = код корпорации (пример: DN04-326576562)

& - разделяющий символ между параметрами

in_time=        - признак получения выписки за маесяц "m"

month= - номер месяца в году (например        2 - февраль)

year= - год (например 2013)

UserName= - логин пользователя

UserPass= - пароль пользователя

PUREXML=true - параметр, который возвращает XML

Ссылки на данные, внутри полученного xml:

//corpcards/list/row/statement/source/account/@card - номер карты

//corpcards/list/row/statement/source/account/@ccy - код валюта карты

//corpcards/list/row/statement/amount/@amt - сумма операции в валюте карты

//corpcards/list/row/statement/original/@amt - сумма операции

//corpcards/list/row/statement/original/@ccy - валюта операции

//corpcards/list/row/statement/fee - сумма комиссии в валюте карты

//corpcards/list/row/statement/discount - сумма скидки

//corpcards/list/row/statement/trandc - вид операции (расход DB / пополнение CR)

//corpcards/list/row/statement/posted - дата проводки (дд.мм..гггг.)

//corpcards/list/row/statement/valuedate/@id - дата и время операции с картой (ггггммддTчч:мм:сс)

//corpcards/list/row/statement/country - код страны, в которой совершена операция

//corpcards/list/row/statement/details - вид операции (не всегда заполняется)

/corpcards/list/row/statement/rest - остаток после операции (на данный момент не заполняется)

/corpcards/list/row/statement/descr - адрес и название терминала, в котором совершена операция

За день:

https://client-bank.privatbank.ua/p24/iqcorpcardstatements?corporation=DN04-326576562&in_time=d&oneday=09.02.2013&UserName=XXXXXXX&UserPass=YYYYYYY&PUREXML=true

Описание параметров запроса:

corporation= код корпорации (пример: DN04-326576562)

& - разделяющий символ между параметрами

in_time=        - признак получения выписки за день "d"

oneday= - дата на которую нужно сформировать выписку (например 09.02.2013)

UserName= - логин пользователя

UserPass= - пароль пользователя

PUREXML=true - параметр, который возвращает XML

Ссылки на данные, внутри полученного xml:

//corpcards/list/row/statement/source/account/@card - номер карты

//corpcards/list/row/statement/source/account/@ccy - код валюта карты

//corpcards/list/row/statement/amount/@amt - сумма операции в валюте карты

//corpcards/list/row/statement/original/@amt - сумма операции

//corpcards/list/row/statement/original/@ccy - валюта операции

//corpcards/list/row/statement/fee - сумма комиссии в валюте карты

//corpcards/list/row/statement/discount - сумма скидки

//corpcards/list/row/statement/trandc - вид операции (расход DB / пополнение CR)

//corpcards/list/row/statement/posted - дата проводки (дд.мм..гггг.)

//corpcards/list/row/statement/valuedate/@id - дата и время операции с картой (ггггммддTчч:мм:сс)

//corpcards/list/row/statement/country - код страны, в которой совершена операция

//corpcards/list/row/statement/details - вид операции (не всегда заполняется)

/corpcards/list/row/statement/rest - остаток после операции (на данный момент не заполняется)

/corpcards/list/row/statement/descr - адрес и название терминала, в котором совершена операция


:: Выписка по одной корп. карте ::

Запрос:

За месяц:

https://client-bank.privatbank.ua/p24/iqcorpcardstatements?corporation=DN04-35133911&card=4246000000577163-4246000000577163&month=02&year=2013&UserName=XXXXXXXX&UserPass=YYYYYYYYYY&PUREXML=true

Описание параметров запроса:

corporation = код корпорации (пример: DN04-35133911)

& - разделяющий символ между параметрами

card= - номер карты и счета карты (обычно они тождествены) (пример 4246000000577163-4246000000577163)

month=        номер месяца в году (например        02 - февраль)

year=        год (например 2013)

UserName= - логин пользователя

UserPass= - пароль пользователя

PUREXML=true - параметр, который возвращает XML

За день:

https://client-bank.privatbank.ua/p24/iqcorpcardstatements?corporation=DN04-35133911&card=4246000000577163-4246000000577163&in_time=d&oneday=09.02.2013&UserName=YYYYYY&UserPass=XXXXXXX&PUREXML=true

Описание параметров запроса:

corporation= - код корпорации (пример: DN04-35133911)

& - разделяющий символ между параметрами

card= - номер карты и счета карты (обычно они тождествены) (пример 4246000000577163-4246000000577163)

in_time        d= - признак получения выписки за день "d"

oneday= - дата на которую нужно сформировать выписку (например 09.02.2013)

UserName= - логин пользователя

UserPass= - пароль пользователя

PUREXML=true - параметр, который возвращает XML

Ссылки на данные, внутри полученного xml:

/corpcards/summary/panmain - номер основной карты выписки

/corpcards/summary/holder - ФИО держателя карты

/corpcards/summary/brest - входящий остаток

/corpcards/summary/erest - исходящий остаток

/corpcards/summary/db - сумма расходов за выбранный месяц

/corpcards/summary/cr - сумма пополнений за выбранный месяц

/corpcards/summary/fee - общая сумма комиссий за выбранный месяц

/corpcards/summary/discount  - общая сумма скидок за выбранный месяц

/corpcards/list/row/statement/source/account/@ccy - валюта карты

/corpcards/list/row/statement/source/account/@card - карта  операции

/corpcards/list/row/statement/amount/@amt - сумма операции в валюте карты

/corpcards/list/row/statement/amount/@ccy - валюта операции

/corpcards/list/row/statement/original/@amt - сумма операции

/corpcards/list/row/statement/original/@ccy - валюта операции

/corpcards/list/row/statement/fee - сумма комиссии в валюте карты

/corpcards/list/row/statement/discount - сумма скидки

/corpcards/list/row/statement/trandc - вид операции (расход DB / пополнение CR)

/corpcards/list/row/statement/posted - дата проводки (дд.мм..гггг.)

/corpcards/list/row/statement/valuedate/@id - дата и время операции с картой (ггггммддTчч:мм:сс)

/corpcards/list/row/statement/country - код страны, в которой совершена операция

/corpcards/list/row/statement/details - вид операции

/corpcards/list/row/statement/rest - остаток после операции

/corpcards/list/row/statement/descr - адрес и название терминала, в котором совершена операция


:: Список карт корпорации ::

Запрос: https://client-bank.privatbank.ua/p24/corpcardlist?ccy=UAH&corporation=DN04-35223911&UserName=XXXXX&UserPass=YYYYYY&PUREXML=true

Описание параметров запроса:

ccy = валюта корпорации (UAH) не !!!обязательно!!!

corporation =         код корпорации (пример: DN04-326576562)

& - разделяющий символ между параметрами

UserName= - логин пользователя

UserPass= - пароль пользователя

PUREXML=true - параметр, который возвращает XML

Ссылки на данные, внутри полученного xml:

//corpcardlist/list/row/card/@num - номер карты

//corpcardlist/list/row/card/date/@id - срок действия карты (ггггммдд)

//corpcardlist/list/row/card/ccy/@code - валюта карты

//corpcardlist/list/row/card/status/@value - статус карты

//corpcardlist/list/row/card/text() - ФИО держателя карты


:: Импорт НБУ платежа в Приват24 ::

Запрос: https://client-bank.privatbank.ua/p24/c2b_nbu_payment_new?mur=780&a_acc=26002600260&amt=777.77&b_acc=29092909290900&b_bic=305299&b_crf=14360570&b_name=ПАТ КБ ПРИВАТБАНК&dat_inp=09.02.2010&dat_val=10.02.2010&detalis=_назначение платежа_&type=cr&UserName=XXXXX&UserPass=ZZZZZZZZ&PUREXML=true

Описание параметров запроса:

UserName - логин пользователя

UserPass - пароль пользователя

A_ACC - счет плательщика

amt - сумма (формат  0.00)

B_ACC - счет получателя

B_BIC - МФО банка получателя

B_CRF - код ЕГРПОУ / ИНН получателя

B_NAME - наименование получателя

DAT_INP - дата документа

DAT_VAL - дата валютирования (формат 09.02.2010)

DETAILS - назначение платежа

MUR - номер документа

type - тип документа (cr)

Перед отправкой запроса, URL (запрос) нужно сконвертировать в Юникод.


:: Импорт СВИФТ платежа в Приват24 ::

Запрос:

https://client-bank.privatbank.ua/p24/c2b_swift_payment_new?A_ACC=26000500076001&amt=1000.00&B_ACC=0123456789&B_BANK=DABADKKKAAB&B_NAME=DANSKE BANK A/S AABENRAA DENMARK&ccy=USD&CHRG=BEN&CHRG_AMT=10.00&DAT_VAL=29.03.2013&DETAILS=Назначение платежа&INT_ACC=987654321&INT_B_ACC=876543210&INT_BIC=DABADKKKAAB&INT_NAME=testb&MUR=0123456789&SND2REC=Дополнительно назначение платежаUserName=XXXXXX&UserPass=XXXXXXXXX&PUREXML=true

Описание параметров запроса:

A_ACC -Счет плательщика

amt - Сумма

B_ACC - Счет получателя

B_BANK - Наименование банка получателя

B_BIC - СВИФТ код банка получателя

B_NAME - Наименование получателя

ccy - Валюта

CHRG - Плательщик комиссии по платежу

CHRG_AMT - Сумма комиссии

DAT_VAL - Дата документа

DETAILS - Назначение платежа

INT_ACC - Счет посредника в банке корреспонденте

INT_B_ACC - Счет банка получателя в банке посреднике

INT_BIC - СВИФТ код банка посредника

INT_NAME - Наименование банка посредника

MUR - Номер документа

SND2REC - Дополнительное назначение платежа

Перед отправкой запроса, URL (запрос) нужно сконвертировать в Юникод.