Передача информации по оплате заказа в АГБИС.docx

Передача информации по оплате заказа в АГБИС.

Данный раздел подойдет для тех, кто самостоятельно интегрирует оплаты в свои мобильные приложения (МП) и личный кабинет (ЛК).

Весь механизм оплат и все оплаты реализуется и хранится на стороне клиента.

Наша сервисная служба (агент) примерно раз в 30 секунд посылает GET запрос на определенный скрипт (по адресу предоставленный клиентом), который отвечает за выгрузку оплат, и передает в него параметры. В ответ скрипт будет сообщать нам данные (xml) об оплаченных заказах, после чего агент пометит заказы как оплаченные.

Путь до скрипта должен быть для всех запросов один, например, https://www.example.ru/api/pay.php.

После разработки скрипта, передать этот путь до скрипта, а также значения для параметров Ld и Pd, в АГБИС для дальнейшей настройки агента и тестирования работы выгрузки оплат.

1. Запрос выгрузки оплат:

Пример запроса агента на адрес: https://www.example.ru/api/pay.php?Load&guid=guid&Lg=login&Pd=pwd

где guid - GUID текущей выгрузки (формируется агентом),

login и pwd - авторизационные параметры (предоставляются клиентом клиентом).

Скрипт должен проверять login и pwd на правильность, если совпадают, то продолжает дальше работать.

Параметр Load сообщает скрипту, что нужно найти все не выгруженные записи оплат, и пометить найденные оплаты в БД mysql переданным guid, формируя XML и возвращает в ответе на запрос.

Пример XML ответа на запрос параметром Load:

1. <?xml version=«1.0» encoding=«utf-8»?>

2. <Agbis>

3. >

   <Pay>

4. >

   <mysql_id>57</mysql_id>

5. >

   <dor_id>158671</dor_id>

6. >

   <contr_id>44708</contr_id>

7. >

   <amount>31.88</amount>

8. >

   <token/>

9. >

   <card_last_four>4242</card_last_four>

10. >

    <card_type>Visa</card_type>

11. >

    </Pay>

12. >

    <Pay>

13. >

    <mysql_id>59</mysql_id>

14. >

    <dor_id>159060</dor_id>

15. >

    <contr_id>44708</contr_id>

16. >

    <amount>2125</amount>

17. >

    <token/>

18. >

    <card_last_four>4242</card_last_four>

19. >

    <card_type>Visa</card_type>

20. >

    </Pay>

21. ……

22. </Agbis>

где mysql_id – ID строки из БД mysql на стороне клиента,

dor_id – ID заказа,

contr_id – ID клиента химчистки,

amount – сумма оплаты заказа,

card_last_four – последние 4 цифры карты оплаты,

card_type – тип карты/банка оплаты.

После обработки XML ответа, агент сохраняет в АГБИС все оплаты заказов.

2. Запрос успешного сохранения оплат:

Для определения успешной выгрузки оплат в АГБИС, агент отправляет GET запрос в скрипт.

Пример запроса агента на адрес: https://www.example.ru/api/pay.php?SavePay&guid=guid&Lg=login&Pd=pwd

где guid - GUID текущей выгрузки, сформированный агентом, еще при отправке запроса Load;

login и pwd - авторизационные параметры (предоставляются клиентом клиентом).

Скрипт должен проверять login и pwd на правильность, если совпадают, то продолжает дальше работать.

Если передан параметр SavePay, тогда скрипт находит в БД mysql все оплаты помеченные guid (GUID прошлой выгрузки), и делает отметку, что эти оплаты выгружены в химчистку успешно и возвращает XML об успешном выполнении.

Пример XML ответа на запрос параметром SavePay:

1. <?xml version=«1.0» encoding=«utf-8»?>

2. <Agbis>

3. >

   <Error>0</Error>

4. </Agbis>

На этом выгрузка заканчивается и оплаты появляются в программе АГБИС химчистка и ЛК.

Пример скрипта php обрабатывающий Load и SavePay запросы от агента:

1. >

   <?php

2. ini_set('display_errors', 0);

3. error_reporting(E_ALL);

5. header('Content-type: text/html; charset=UTF-8');

7. include('_class/mysql.php');

8. include('_class/GenerateXML.php');

10. if (count($_GET) == 0) //если ни каких параметров в строке нет, то убиваем выполнение скрипта

11. die('Ошибка');

12. $DB = new DB;

13. if (!$DB→link)

14. die('Ошибка базы данных!');

16. if (isset($_GET['Lg']) && !empty($_GET['Lg']) && isset($_GET['Pd']) && !empty($_GET['Pd'])){

17. // проверка логина пароля

18. $lg = substr($_GET['Lg'], 0, 50);

19. $pd = substr($_GET['Pd'], 0, 50);

20. // тут проверка на правильность $lg и $pd

21. }

22. else

23. die('Ошибка'); // не позволяем работать дальше

25. if (isset($_GET['guid']) && !empty($_GET['guid']))

26. $guid = $_GET['guid'];

27. else

28. die('Ошибка');

30. $TABLE_PAY = ''; // имя таблицы

32. if (isset($_GET['Load'])){ // Загружаем оплаты

33. $sql = «select

34. id,

35. dor_id,

36. contr_id,

37. amount,

38. datetime_load_server,

39. datetime_load,

40. datetime_unloading,

41. token,

42. card_last_four,

43. card_type,

44. user_name,

45. ip_address,

46. transaction_id,

47. email,

48. is_loaded

49. from $TABLE_PAY

50. where is_loaded = 0»;

51. $result = $DB→query($sql) or die('Ошибка');

53. $xml = new GenerateXML();

54. while ($product=$DB→fetch_array($result, MYSQL_BOTH)){

55. $a = $xml→addEl('Pay');

56. $xml→addEl('mysql_id', $product['id'], $a); // ID записи из mysql

57. $xml→addEl('dor_id', $product['dor_id'], $a); // dоr_id - id заказа

58. $xml→addEl('contr_id', $product['contr_id'], $a); // contr_id - id клиента

59. $xml→addEl('amount', $product['amount'], $a); // сумма оплаты

60. $xml→addEl('card_last_four', $product['card_last_four'], $a); // неполный номер карты

61. $xml→addEl('card_type', $product['card_type'], $a); // тип карты Visa, Mastercard/краткое имя банка

63. $sql2 = «update ».$TABLE_PAY.« set guid='».$DB→real_escape_string($guid).«' where id = ».$product['id']; // помечаем оплаты тек выгрузкой

64. $result2 = $DB→query($sql2) or die('Ошибка');

65. }

67. echo $xml→saveXML();

68. }

69. else

70. if (isset($_GET['SavePay'])){ // сохранение оплаты

71. $sql2 = «update ».$TABLE_PAY.« set is_loaded=1, token=null, datetime_unloading = CURRENT_TIMESTAMP() where guid = '».$DB→real_escape_string($guid).«'»; // помечает что оплаты выгрузились успешно

72. $result2 = $DB→query($sql2) or die('Ошибка');

74. $xml = new GenerateXML();

75. $xml→addEl('Error', 0);

76. echo $xml→saveXML();

77. }

78. >

    ?>

Пример скрипта таблицы хранения информации об оплаченных заказов в MYSQL:

CREATE TABLE `payment_orders ` (

`id` BIGINT(20) NOT NULL AUTO_INCREMENT,

`guid` VARCHAR(50) NULL DEFAULT NULL COMMENT 'GUID выгрузки',

`contr_id` BIGINT(20) NOT NULL COMMENT 'контрагент в БД',

`dor_id` BIGINT(20) NULL DEFAULT NULL COMMENT 'заказ в БД',

`amount` DOUBLE NOT NULL COMMENT 'сумма оплаты',

`datetime_load_server` TIMESTAMP NULL DEFAULT NULL COMMENT 'Дата создания по времени сервера',

`datetime_load` TIMESTAMP NULL DEFAULT NULL COMMENT 'Дата создания по времени сервера оплаты',

`datetime_unloading` TIMESTAMP NULL DEFAULT NULL COMMENT 'Дата выгрузки в БД агбис',

`card_last_four` VARCHAR(4) NULL DEFAULT NULL COMMENT 'последние 4 цифры',

`card_type` VARCHAR(50) NULL DEFAULT NULL COMMENT 'тип кары',

`user_name` VARCHAR(500) NULL DEFAULT NULL COMMENT 'Имя пользователя карты',

`ip_address` VARCHAR(500) NULL DEFAULT NULL COMMENT 'ip клиента',

`transaction_id` VARCHAR(500) NULL DEFAULT NULL COMMENT 'номер транзакции',

`email` VARCHAR(250) NULL DEFAULT NULL COMMENT 'email адрес плательщика',

`is_loaded` TINYINT(4) NOT NULL DEFAULT '0' COMMENT 'Признак успешной выгрузки True/False',

`waiting` TINYINT(4) NULL DEFAULT NULL COMMENT 'Ожидание подтверждения от системы оплаты. 1 ожидание, 0 - уже оплачено',

`com` VARCHAR(500) NULL DEFAULT NULL,

PRIMARY KEY (`id`)

)

COMMENT='Оплаты заказов из ЛК'

COLLATE='utf8_general_ci'

ENGINE=MyISAM