Создание инвойса

Для создания инвойса нужно передать запрос на  https://api.1payment.com/init_invoice
со следующими параметрами:

см. формат запросов к API

  • partner_id - 1234 (ID партнера)
  • project_id - 5678 (ID проекта)
  • amount - 50 (сумма в валюте проекта)
  • description - описание платежа (опционально)
  • success_url - https://test.com/success (url возврата плательщика после успешной оплаты, опционально)
  • failure_url - https://test.com/failure (url возврата плательщика после ошибки оплаты, опционально)
  • invoice_user_data - уникальное значение, например, идентификатор инвойса на стороне партнера
  • sign - (подпись)

Пример: 

https://api.1payment.com/init_invoice?partner_id=1234&project_id=5678&amount=50&description=test_payment&sign=d724e1e6453a43397bb2aa6d6be9cc06

Подпись (sign) рассчитывается так: md5 от строки "init_invoice + конкатенация всех параметров = значение в алфавитном порядке по возрастанию с разделителем & + секретный API Key" (кроме параметра sign)
Для запроса выше строка, от которой будет браться md5, имеет вид:

init_invoiceamount=50&description=test_payment&partner_id=1234&project_id=5678[API_Key]

В ответ система выдаст в JSON: 

{"invoice_id":"inv_dp2eqgnyt008ocg88wwsw00oksgs8s88","url":"https:\/\/merchant.1payment.com\/xZ5g7F"}

Где:

  • invoice_id - id инвойса
  • url - ссылка на форму, на которую нужно направить плательщика

После получения финального статуса по оплате на ваш invoice_notify_url, указанный в настройках проекта, будет отправлено уведомление о статусе платежа. Формат уведомления POST JSON со следующими параметрами:

  • type - invoice
  • invoice_id - идентификатор инвойса
  • order_id - присутствует при успешной оплате инвойса, содержит id транзакции, которой был оплачен инвойс
  • project_id - ID проекта
  • status - статус инвойса (3 - инвойс оплачен, 4 - срок ожидания оплаты истек)
  • init_time - время создания инвойса
  • vaild_till - время окончания жизни инвойса
  • amount - сумма, на которую выставлен инвойс
  • currency - валюта инвойса (трехбуквенный код ISO 4217 )
  • invoice_user_data - идентификатор, переданный при создании инвойса
  • sign - Подпись (sign), рассчитывается так: md5 от строки "конкатенация всех параметров = значение в алфавитном порядке по возрастанию с разделителем & + секретный API Key" (кроме параметра sign)