Philippines Payment Centers

Обзор

Philippines Payment Centers — платёжный метод для проведения оплат наличными через партнёрские точки приёма платежей и выплат через точки выдачи наличных средств. Для работы с этим методом доступно проведение оплат через Payment Page и Gate, выплат — через Gate и Dashboard.

Характеристика

Тип платёжного метода платежи через точки оплаты
Платёжные инструменты наличные
Регионы использования PH
Валюты платежей PHP
Конвертация валют доступна только для оплат — на стороне ecommpay
Оплаты +
Выплаты +
Оплаты по сохранённым данным
Полные возвраты +
Частичные возвраты +
Опротестования
Особенности
  • поддержка полных и частичных возвратов осуществляется со стороны провайдера
  • можно задавать дополнительные параметры при вызове Payment Page
Организация и стоимость подключения по согласованию с курирующим менеджером ecommpay

Схема работы

В проведении отдельного платежа с использованием Philippines Payment Centers задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ecommpay, а также технические средства провайдера.



Основные операции

Интерфейсы Суммы, PHP ** Время***
Payment Page CMS Plug-ins Gate Dashboard минимум максимум базовое предельное
Оплаты + + 1,00 1 000 000,00 2 дня 5 дней
Выплаты + + 10,00 100 000,00 24 часа 48 часов
Полные возвраты * * * * * *
Частичные возвраты * * * * * *

* Для проведения полных и частичных возвратов пользователям необходимо заполнять форму обращения.

** Информацию следует уточнять у курирующего менеджера ecommpay

*** Базовое и предельное время определяются следующим образом:

  • Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время, определяемое для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя (там, где они необходимы). Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа.
  • Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус decline. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки ecommpay.

Сценарии использования

Проведение оплат с использованием метода Philippines Payment Centers выполняется с перенаправлением пользователей к сервису провайдера, выплат — с получением уведомления пользователем через веб-сервис мерчанта.

Рис.: Оплата через Payment Page



Рис.: Оплата через Gate



Рис.: Выплата через Gate



Поддержка со стороны партнёрских точек приёма платежей

Проведение оплат с применением метода Philippines Payment Centers осуществляется через партнёрские точки приёма платежей, поддерживающие работу с этим методом. Точкам соответствуют свои идентификаторы, которые используются при инициировании оплат через Gate, а также при вызове Payment Page для отображения страницы с выбором метода оплаты. Далее в таблице в ознакомительных целях представлена информация об этих точках, которую следует уточнять у курирующего менеджера ecommpay или с помощью запроса /v2/info/banks/cash/philippines/sale/list, относящегося к группе запросов /v2/info/banks/{parentMethod}/{childMethod}/{operationType}/list.

Табл. 1. Список партнёрских точек приёма платежей
Точка приёма платежей ID
7-Eleven 2591
Bayad Center 2601
Cebuana Lhuillier PeraPal 2621
Cebuana Lhuillier Bills Payment 1581
ECPay (Pawnshops, Payment Centers) 2651
LBC 1591
M. Lhuillier 2631
Palawan Pawnshop 2661
Posible Partners 2671
RD Pawnshop 2681
RuralNet Banks and Coops 2691
Robinsons Dept Store 2641
SM Dept/Supermarket/Savemore Counter 2611

Поддержка со стороны сервисов точек выдачи наличных

Проведение выплат с применением метода Philippines Payment Centers осуществляется через сервисы точек выдачи наличных, поддерживающие работу с этим методом. Каждому сервису соответствуют свой идентификатор, который используется при инициировании выплат через Gate.

В таблице далее в ознакомительных целях представлена информация об этих идентификаторах. Эту информацию следует уточнять у курирующего менеджера ecommpay или с помощью запроса /v2/info/banks/cash/philippines/payout/list, относящегося к группе запросов /v2/info/banks/{parentMethod}/{childMethod}/{operationType}/list.

Табл. 2. Список точек выдачи наличных
Название ID
Cebuana Lhuillier Cash Pick-up 1581
LBC Cash Pick-up 1591
PeraHub Cash Pick-up 1601
RCBC/RCBC Savings Bank Cash Pick-up 1611
TrueMoney Cash Pick-up 1621

Детальные сведения о том, что необходимо делать со стороны мерчанта для проведения платежей, а также о том, что можно использовать для анализа информации о проведённых платежах и операциях, представлены далее.

Оплаты через Payment Page

Общая информация

Для оплаты через Payment Page с использованием метода Philippines Payment Centers со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате оплаты. При этом метод Philippines Payment Centers можно сделать предварительно выбранным (подробнее — в разделе Предварительный выбор платёжных методов). Полная схема проведения оплаты представлена далее.



Рис.: Проведение оплаты через Payment Page

  1. Пользователь на стороне веб-сервиса инициирует оплату.
  2. От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение оплаты через Payment Page.
  3. Запрос на проведение оплаты поступает в платёжную платформу.
  4. Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
  5. Осуществляется формирование Payment Page согласно настройкам проекта и параметрам вызова.
  6. Пользователю отображается сформированная платёжная форма.
  7. Пользователь выбирает для оплаты метод Philippines Payment Centers.
  8. Запрос на проведение оплаты через Philippines Payment Centers поступает в платёжную платформу.
  9. Выполняются дальнейшая обработка запроса и его отправка в сервис провайдера.
  10. На стороне провайдера выполняется обработка запроса на оплату.
  11. От сервиса провайдера к платёжной платформе передаются данные для перенаправления пользователя в сервис провайдера.
  12. Данные для перенаправления пользователя передаются к Payment Page.
  13. Пользователь перенаправляется в сервис провайдера.
  14. Пользователь выполняет необходимые действия для оплаты.
  15. На стороне сервиса провайдера выполняется обработка платежа.
  16. Со стороны провайдера пользователю по электронной почте отправляется информация о результате оплаты.
  17. Пользователь перенаправляется к Payment Page.
  18. От сервиса провайдера к платёжной платформе направляется результат оплаты.
  19. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
  20. От платёжной платформы к Payment Page направляется результат проведения оплаты.
  21. Результат оплаты отображается пользователю на Payment Page.

Информация о формате запросов и параметрах вызова Payment Page при работе с Philippines Payment Centers, а также о формате оповещений о результатах оплат приведена далее; общая информация о работе с API см. в разделе Описание Payment Page API.

Формат запросов

При формировании запросов на открытие платёжной формы с применением метода Philippines Payment Centers необходимо учитывать следующее:

  1. Должен использоваться базовый минимум параметров — параметры, обязательные для любого платёжного метода:
    • project_id — идентификатор проекта, полученный от ecommpay при интеграции;
    • payment_id — идентификатор платежа, уникальный в рамках проекта;
    • payment_currency — валюта платежа в формате ISO-4217 alpha-3;
    • payment_amount — сумма платежа в дробных единицах;
    • customer_id — идентификатор пользователя уникальный в рамках проекта.
  2. Дополнительно должен использоваться параметр customer_email — адрес электронной почты пользователя. Если параметр отсутствует в запросе, на Payment Page пользователю отображается поле для ввода недостающего значения. Если параметр присутствует в запросе, на Payment Page пользователю отображается поле с предварительно заполненным значением параметра, указанного в запросе, для подтверждения или изменения.
  3. Можно настраивать отображение страницы Payment Page с выбором метода оплаты.

    По умолчанию названия партнёрских точек приёма платежей объединены в группу и отображаются одной кнопкой Philippines Payment Centers, поэтому выбор точки приёма платежей осуществляется в два этапа. Сначала выбирается Philippines Payment Centers среди прочих методов, а затем на следующей странице с перечнем точек приёма платежей выбирается конкретная точка. Существует несколько вариантов отображения страницы Payment Page с выбором метода оплаты:

    • Отображение точек приёма платежей одной кнопкой Philippines Payment Centers среди прочих платёжных методов.
    • Отображение точек приёма платежей отдельными кнопками среди прочих методов. Для этого необходимо передавать параметр split_banks со значением true в параметре payment_methods_options.
      "payment_methods_options": "{\"philippines_cash\": {\"split_banks\": true}}"
      
    • Отображение кнопок конкретных точек приёма платежей (одной или нескольких). В списке методов может присутствовать метод Philippines Payment Centers. Для этого необходимо передавать идентификаторы точек в параметре banks_id. Для отображения нескольких точек необходимо перечислять идентификаторы этих точек через запятую c пробелом.
      "payment_methods_options": "{\"philippines_cash\": {\"split_banks\": true, \"banks_id\": [2591, 2601]}}"
    • Отображение только точек приёма платежей одной кнопкой Philippines Payment Centers. Для этого используется предварительный выбор метода Philippines Payment Centers. Необходимо передавать код платежного метода philippines-cash в параметре force_payment_method. Пользователю сразу открывается страница с выбором точек.
    • Отображение отдельной точки приёма платежей. Для этого используется предварительный выбор метода Philippines Payment Centers. Необходимо передавать код платежного метода philippines-cash в параметре force_payment_method и идентификатор точки banks_id в параметре payment_methods_options.

      Ниже приведён пример запроса на открытие Payment Page с предварительно выбранной точкой приёма платежей.

      Рис.: Пример запроса на оплату с выбором точки приёма платежей

          { payment_id: 'X03936', 
            payment_amount: 10000, 
            payment_currency: 'PHP', 
            project_id: 123, 
            customer_id: 'customer1',
            customer_email: 'test@example.com',
            force_payment_method: 'philippines-cash',
            payment_methods_options: '{\"philippines_cash\": {\"banks_id\": [2601]}}',
            signature: "kUi2x9dKHAVNU0FYldJrxh+...tT4DqtVUkDJrOcZzUCwX6R\/ekpZhkIQg=="
          }
  4. Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page. Детальная информация обо всех параметрах приведена в разделе Параметры вызова платёжной формы.
  5. После определения всех параметров необходимо составить подпись. Подробную информацию см. в Работа с подписью к данным.

Таким образом, корректный запрос на открытие платёжной формы с применением метода Philippines Payment Centers должен содержать идентификаторы проекта и платежа, валюту и сумму платежа, а также адрес электронной почты пользователя и подпись:

    { payment_id: 'ECT_TEST_1547', 
      payment_amount: 1000, 
      payment_currency: 'PHP', 
      project_id: 210,
      customer_email: 'test@example.com',
      signature: "kUi2x9dKHAVNU0FYldJrxh4yo+K...tT4DqtVUkDJrOcZzUCwX6R\/ekpZhkIQg=="
    }

Формат оповещений

Для оповещений о результатах оплат с применением метода Philippines Payment Centers используется стандартный формат, описание которого представлено в разделе Оповещения.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 239 была успешно проведена оплата в размере 10,00 PHP.

Рис.: Пример оповещения о проведении оплаты

 {
        "project_id": 239,
        "payment": {
            "id": "EPfa87-bcfd",
            "type": "purchase",
            "status": "success",
            "date": "2020-03-06T14:11:00+0000",
            "method": "Philippines cash",
            "sum": {
                "amount": 1000,
                "currency": "PHP"
            },
            "description": ""
        },
        "operation": {
            "id": 464,
            "type": "sale",
            "status": "success",
            "date": "2020-03-06T14:11:00+0000",
            "created_date": "2020-03-06T14:10:34+0000",
            "request_id": "f6ab99eb0940e43a774b969cb74a88ef08eec6c8951-00000001",
            "sum_initial": {
                "amount": 1000,
                "currency": "PHP"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "PHP"
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 1369,
                "payment_id": "7QKID3P3",
                "auth_code": "",
                "endpoint_id": "BOG",
                "date": "2020-03-06T14:10:54+0000"
            }
        },
        "signature": "YZKXHr2ZdK3tPqiMzPpSJZ...+WGku5dANQAVWPteHKmwzMQ+mvGoA=="
    }
}

В следующем примере оплата была отклонена из-за превышения максимального ограничения суммы:

Рис.: Пример оповещения об отказе в проведении оплаты

 {
        "project_id": 239,
        "payment": {
            "id": "EPfa87-bcfc",
            "type": "purchase",
            "status": "decline",
            "date": "2020-03-07T14:11:00+0000",
            "method": "Philippines cash",
            "sum": {
                "amount": 200000000,
                "currency": "PHP"
            },
            "description": ""
        },
        "operation": {
            "id": 465,
            "type": "sale",
            "status": "decline",
            "date": "2020-03-07T14:11:00+0000",
            "created_date": "2020-03-06T14:10:34+0000",
            "request_id": "f6ab99eb0940e43a774b969cb74a88ef08eec6c8951-00000002",
            "sum_initial": {
                "amount": 200000000,
                "currency": "PHP"
            },
            "sum_converted": {
                "amount": 200000000,
                "currency": "PHP"
            },
            "code": "20101",
            "message": "Decline due to amount or frequency limit",
            "provider": {
                "id": 1369,
                "payment_id": "7QKID3P3",
                "auth_code": "",
                "endpoint_id": "BOG",
                "date": "2020-03-06T14:10:54+0000"
            }
        },
        "signature": "YZKXHr2ZdK3tPqiMzPpSJZ...+WGku5dANQAVWPteHKmwzMQ+mvGob=="
    }
}

Дополнительные материалы

Для организации работы с оплатами через Payment Page также могут быть полезны следующие материалы:

Оплаты через Gate

Общая информация

Для оплаты через Gate с использованием метода Philippines Payment Centers со стороны веб-сервиса необходимо:

  1. Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay.
  2. Осуществить перенаправление в сервис провайдера.
  3. Принять оповещение от платежной платформы ecommpay о результате оплаты.

Полная схема проведения оплаты представлена далее.



Рис.: Проведение оплаты через Gate

  1. Пользователь на стороне веб-сервиса инициирует оплату через Philippines Payment Centers.
  2. От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение оплаты через Gate.
  3. Запрос на проведение оплаты поступает в платёжную платформу ecommpay.
  4. Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
  5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности. Подробнее см. в разделе Формат ответа.
  6. В платёжной платформе выполняются дальнейшая обработка запроса и его отправка в сервис провайдера.
  7. На стороне провайдера выполняется обработка запроса на оплату.
  8. От сервиса провайдера к платёжной платформе передаются данные для перенаправления пользователя на сайт Philippines Payment Centers.
  9. От платёжной платформы к веб-сервису направляется оповещение с данными для перенаправления пользователя в провайдера в объекте redirect_data.
  10. Пользователь перенаправляется в сервис провайдера.
  11. Пользователь выполняет необходимые действия для оплаты.
  12. На стороне сервиса провайдера выполняется обработка платежа.
  13. Со стороны провайдера пользователю по электронной почте отправляется информация о результате оплаты.
  14. Пользователь перенаправляется к веб-сервису.
  15. От сервиса провайдера к платёжной платформе направляется уведомление о результате оплаты.
  16. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
  17. От веб-сервиса пользователю направляется результат оплаты.

Информация о формате запросов и параметрах инициации оплат методом Philippines Payment Centers через Gate, а также о формате оповещений о результатах оплат приведена далее, общая информация о работе с API см. в разделе Работа с API.

Формат запросов

При работе с запросами на оплаты с применением метода Philippines Payment Centers необходимо учитывать следующее:

  1. Должен использоваться запрос v2/payment/cash/philippines/sale, отправляемый методом POST. Этот запрос относится к группе запросов /v2/payment/cash/{payment_method}/sale.
  2. В запросе должны использоваться следующие объекты и параметры:
    • general — объект, содержащий основные идентификационные сведения запроса:
      • project_id — идентификатор проекта, полученный от ecommpay при интеграции,
      • payment_id — идентификатор платежа, уникальный в рамках проекта,
      • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
    • payment — объект, содержащий сведения о платеже:
      • amount — сумма платежа в дробных единицах валюты,
      • currency — валюта платежа в формате ISO-4217 alpha-3;
    • customer — объект, содержащий сведения о пользователе:
      • id — идентификатор, уникальный в рамках проекта,
      • email — адрес электронной почты,
      • ip_address — используемый IP-адрес;
    • account — объект, содержащий сведения о партнёрской точке приёма платежей:
      • bank_id — идентификатор партнёрской точки приёма платежей;
    • return_url — объект, содержащий URL для перенаправления пользователя в веб-сервис:
      • success — URL для перенаправления пользователя в случае успешной оплаты.
  3. Дополнительно могут использоваться все параметры, указанные в спецификации.

Таким образом, корректный запрос на оплату с применением метода Philippines Payment Centers должен содержать идентификаторы проекта и платежа, валюту и сумму платежа, подпись, идентификатор партнёрской точки приёма платежей, данные пользователя и URL для перенаправления:

Рис.: Пример запроса на оплату

{
    "general": {
        "project_id": 580,
        "payment_id": "test_cash_sale",
        "signature": "pgwRHcfv2OTsdILn33R5Nr/ymu08nMx/9FSeIqYHTTd6YhIiLWw=="
    },
    "payment": {
        "amount": 1000,
        "currency": "PHP"
    },
    "customer": {
        "email": "test_customer@example.com",
        "ip_address": "1.1.1.1",
        "id": "customer123"
    },
    "account": {
        "bank_id": 2681
    },
    "return_url": {
        "success": "http://example.com/success"
    }
}

Форматы данных для перенаправления пользователей

Для перенаправления пользователя от веб-сервиса на сайт провайдера необходимо принять оповещение от платёжной платформы, содержащее ссылку для перенаправления в параметре redirect_data.url и данные для отправки в теле запроса redirect_data.body, и использовать эти параметры при открытии HTML-страницы сайта методом, указанным в redirect_data.method.

Далее приведён фрагмент оповещения, содержащего данные для перенаправления.

"redirect_data": {
    "body": {},
    "method": "GET",
    "url": "https://test.ph/Pay.aspx?tokenid=3f511c2d&procid=BITC"
  }

Формат оповещений

Для оповещений о результатах оплат с применением метода Philippines Payment Centers используется стандартный формат, описание которого представлено в разделе Оповещения.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 239 была успешно проведена оплата в размере 10,00 PHP.

Рис.: Пример оповещения о проведении оплаты

 {
        "project_id": 239,
        "payment": {
            "id": "EPfa87-bcfd",
            "type": "purchase",
            "status": "success",
            "date": "2020-03-06T14:11:00+0000",
            "method": "Philippines cash",
            "sum": {
                "amount": 1000,
                "currency": "PHP"
            },
            "description": ""
        },
        "operation": {
            "id": 464,
            "type": "sale",
            "status": "success",
            "date": "2020-03-06T14:11:00+0000",
            "created_date": "2020-03-06T14:10:34+0000",
            "request_id": "f6ab99eb0940e43a774b969cb74a88ef08eec6c8951-00000001",
            "sum_initial": {
                "amount": 1000,
                "currency": "PHP"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "PHP"
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 1369,
                "payment_id": "7QKID3P3",
                "auth_code": "",
                "endpoint_id": "BOG",
                "date": "2020-03-06T14:10:54+0000"
            }
        },
        "signature": "YZKXHr2ZdK3tPqiMzPpSJZ...+WGku5dANQAVWPteHKmwzMQ+mvGoA=="
    }
}

В следующем примере оплата была отклонена из-за превышения максимального ограничения суммы:

Рис.: Пример оповещения об отказе в проведении оплаты

 {
        "project_id": 239,
        "payment": {
            "id": "EPfa87-bcfc",
            "type": "purchase",
            "status": "decline",
            "date": "2020-03-07T14:11:00+0000",
            "method": "Philippines cash",
            "sum": {
                "amount": 200000000,
                "currency": "PHP"
            },
            "description": ""
        },
        "operation": {
            "id": 465,
            "type": "sale",
            "status": "decline",
            "date": "2020-03-07T14:11:00+0000",
            "created_date": "2020-03-06T14:10:34+0000",
            "request_id": "f6ab99eb0940e43a774b969cb74a88ef08eec6c8951-00000002",
            "sum_initial": {
                "amount": 200000000,
                "currency": "PHP"
            },
            "sum_converted": {
                "amount": 200000000,
                "currency": "PHP"
            },
            "code": "20101",
            "message": "Decline due to amount or frequency limit",
            "provider": {
                "id": 1369,
                "payment_id": "7QKID3P3",
                "auth_code": "",
                "endpoint_id": "BOG",
                "date": "2020-03-06T14:10:54+0000"
            }
        },
        "signature": "YZKXHr2ZdK3tPqiMzPpSJZ...+WGku5dANQAVWPteHKmwzMQ+mvGob=="
    }
}

Дополнительные материалы

Для организации работы с оплатами через Gate также могут быть полезны следующие материалы:

Выплаты через Gate

Общая информация

Для выплаты через Gate с использованием метода Philippines Payment Centers со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате выплаты. Полная схема проведения выплаты представлена далее.



Рис.: Проведение выплаты через Gate

  1. Пользователь запрашивает выплату в одной из доступных для Philippines Payment Centers точек выдачи наличных.
  2. От веб-сервиса на заданный URL ecommpay передаётся запрос на проведение выплаты через Gate.
  3. Запрос на проведение выплаты поступает в платёжную платформу.
  4. Выполняется начальная обработка запроса, в рамках которой обеспечивается проверка наличия обязательных параметров и корректной подписи.
  5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности. Подробнее см. в разделе Формат ответа.
  6. В платёжной платформе выполняются дальнейшая обработка запроса и его отправка в сервис провайдера.
  7. На стороне провайдера выполняется обработка платежа.
  8. От сервиса провайдера пользователю отправляется электронное письмо с указанием данных для выплаты в выбранной точке получения наличных средств.
  9. Пользователь получает наличные средства в выбранном пункте.
  10. От провайдера к платёжной платформе направляется оповещение о результате.
  11. От платёжной платформы к веб-сервису направляется оповещение о результате.

Информация о формате запросов и параметрах инициализации выплат методом Philippines Payment Centers через Gate, а также о формате оповещений о результатах выплат приведена далее, общая информация о работе с API см. в разделе Работа с API.

Формат запросов

При работе с запросами на выплаты с применением метода Philippines Payment Centers необходимо учитывать следующее:

  1. Должен использоваться запрос /v2/payment/cash/philippines/payout, отправляемый методом POST. Этот запрос относится к группе запросов с использованием наличных средств: /v2/payment/cash/{payment_method}/payout.
  2. В запросе должны использоваться следующие объекты и параметры:
    • general — основные сведения:
      • project_id — идентификатор проекта,
      • payment_id — идентификатор платежа,
      • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
    • customer — сведения о пользователе:
      • id — идентификатор,
      • ip_address — используемый IP-адрес,
      • first_name — имя,
      • last_name — фамилия,
      • email — адрес электронной почты,
      • phone — номер телефона,
      • country — страна проживания,
      • state — штат или регион проживания,
      • city — город проживания,
      • district — район проживания,
      • address — адрес проживания,
      • day_of_birth — дата рождения, в формате ДД-ММ-ГГГГ,
      • citizenship — страна гражданства;
    • account — сведения о счёте пользователя:
      • bank_id — идентификатор сервиса точки выдачи наличных;
    • payment — сведения о платеже:
      • amount — сумма в дробных единицах валюты,
      • currency — валюта платежа в формате ISO-4217 alpha-3,
      • description — описание платежа.
  3. Валютой платежа может быть только PHP.
  4. Дополнительно могут использоваться все параметры, указанные в спецификации.

Таким образом, корректный запрос на выплату с применением метода Philippines Payment Centers должен содержать идентификаторы проекта и платежа, подпись, полные данные пользователя, валюту, сумму и описание платежа, а также идентификатор точки выдачи наличных:

Рис.: Пример запроса на выплату

 {
 "general": {
   "project_id": 603,
   "payment_id": "1000003",
   "signature": "PJkV8ej/UG0Di8hTng6JvC7vQsaC6tajQVVLhNN5e7cV...=="
 },
 "customer": {
   "id": "111232323",
   "ip_address": "1.1.1.1",
   "first_name": "John",
   "last_name": "Don",
   "email": "john777@gmail.com",
   "phone": "49995559988",
   "country": "PH",
   "state": "Metro Manila",
   "city": "Pasig",
   "district": "Udong",
   "address": "123 Sesame street",
   "day_of_birth": "29-12-1984",
   "citizenship": "Philippines"
 },
 "account": {
   "bank_id": "1621"
 },
 "payment": {
   "amount": 1000,
   "description": "payout",
   "currency": "PHP"
 }
}

Формат оповещений

Для оповещений о результатах выплат с применением метода Philippines Payment Centers используется стандартный формат, описание которого представлено в разделе Оповещения.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 445 для пользователя 123 была успешно проведена выплата в размере 10,00 PHP на счёт пользователя 111232323.

Рис.: Пример оповещения о проведении выплаты

 {
        "project_id": 445,
        "payment": {
            "id": "100011",
            "type": "payout",
            "status": "success",
            "date": "2019-03-18T08:06:13+0000",
            "method": "Phillipines cash",
            "sum": {
                "amount": 1000,
                "currency": "PHP"
            },
            "description": "payout"
        },
        "customer": {
            "id": "111232323"
        },
        "operation": {
            "id": 147,
            "type": "payout",
            "status": "success",
            "date": "2019-03-18T08:06:13+0000",
            "created_date": "2019-03-18T08:06:06+0000",
            "request_id": "9499286583e3d43bcf14dbd0d45",
            "sum_initial": {
                "amount": 1000,
                "currency": "PHP"
            },
            "sum_converted": {
                "amount": 1000,
                "currency": "PHP"
            },
            "provider": {
                "id": 1346,
                "payment_id": "6Q2G5D83",
                "date": "2019-03-18T08:06:11+0000",
                "auth_code": ""
            },
            "code": "0",
            "message": "Success"
        },
        "signature": "oFGfjOtZZkFxi7Pd1yikCw01b0BsedgKr8QQrAUZS5L...=="
    }

В следующем примере выплата была отклонена из-за нарушения ограничения на сумму или частоту выплаты.

Рис.: Пример оповещения об отказе в проведении выплаты

{
        "project_id": 445,
        "payment": {
            "id": "100014",
            "type": "payout",
            "status": "decline",
            "date": "2019-03-18T10:49:50+0000",
            "method": "Phillipines cash",
            "sum": {
                "amount": 900,
                "currency": "PHP"
            },
            "description": "payout"
         },
        "customer": {
            "id": "111232323"
        },
        "operation": {
            "id": 148,
            "type": "payout",
            "status": "decline",
            "date": "2019-03-18T10:49:51+0000",
            "created_date": "2019-03-18T10:49:46+0000",
            "request_id": "d626cece0855a8863f687985e616",
            "sum_initial": {
                "amount": 900,
                "currency": "PHP"
            },
            "sum_converted": {
                "amount": 900,
                "currency": "PHP"
            },
            "provider": {
                "id": 1346,
                "payment_id": "YDK0QS4X",
                "auth_code": ""
            },
            "code": "20101",
            "message": "Decline due to amount or frequency limit"
        },
        "signature": "fz0Yu5BFLRLJez747kDfZHgmKGtCmzduW27YGzLvo...=="
    }

Дополнительные материалы

Для организации работы с выплатами через Gate также могут быть полезны следующие материалы:

Выплаты через Dashboard

При использовании интерфейса Dashboard можно проводить одиночные и массовые выплаты методом Philippines Payment Centers с единичной и пакетной отправкой запросов, называемые соответственно одиночными и массовыми.

  • Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры (включая метод), отправить запрос и убедиться в проведении выплаты.
  • Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат.

    При этом должен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе Сведения о массовых платежах, а параметры выплат должны соответствовать требованиям, представленным в разделе Выплаты через Gate этой статьи (за исключением пункта о подписи).

Более подробная информация о проведении выплат через Dashboard представлена в отдельной статье.

Анализ результатов проведения платежей

Как и при работе с другими платёжными методами, которые предоставляет ecommpay, при использовании метода Philippines Payment Centers доступны разные способы анализа информации о платежах и операциях с применением этого метода — как в отдельности, так и в совокупности с другими методами.

Всю необходимую информацию можно получать и анализировать средствами Dashboard, в том числе с помощью аналитических панелей на вкладке Analytics.

Также можно выгружать нужную информацию для последующего анализа с помощью специализированных аналитических средств сторонних разработчиков:

  • Dashboard позволяет выгружать данные в форматах CSV и XLS с помощью инструментов на вкладке Платежи. При этом можно выполнять разовые выгрузки информации на локальный компьютер и задействовать периодическую выгрузку и отправку информации на заданные адреса электронной почты.
  • Data API позволяет получать информацию в формате JSON и отправлять ее на заданный URL — для этого применяются запросы /operations/get.

С любыми вопросами о возможностях анализа можно обращаться в службу технической поддержки ecommpay.