Для базового подключения к palych.io вам нужно научиться работать с одним видом запроса и обрабатывать postback.
Основной запрос, который вам нужен для начала работы - это
https://palych.io/api/v1/bill/create
Например
curl --location --request POST 'https://palych.io/api/v1/bill/create' \
--header 'Authorization: Bearer 123|q4uNcWNKMNZoSFSY1XTxp36nsM0kUMSu0otSA95' \
--form 'amount="16"' \
--form 'order_id="Заказ 123"' \
--form 'description="Описание ссылки"' \
--form 'type="normal"' \
--form 'shop_id="G1vrEyX0LR"' \
--form 'currency_in="RUB"' \
--form 'custom="кастомное поле со свободным текстом"' \
--form 'payer_pays_commission="1"' \
--form 'name="Платёж"'
И вы получите такой ответ
{
"success": "true",
"link_url": "https://palych.io/link/3P1p2rgW7Y",
"link_page_url": "https://palych.io/transfer/3P1p2rgW7Y",
"bill_id": "3P1p2rgW7Y"
}
Далее вам нужно или показыть ссылку из поля "link_page_url" пользователю, чтобы он сам на неё нажал и перешёл на оплату.
Лучше перенаправить плательщика автоматически на платёжную страницу по ссылке вида
https://palych.io/transfer/3P1p2rgW7Y
После того, как вы отправили пользователя на платёжную страницу, вам нужно дождаться его по Success или Fail URL, а так же получить и обработать postback, который придёт на Result URL.
На Success или Fail URL вы получите такой запрос
{
"OutSum": "18.54",
"SignatureValue": "5A41374P24C99A2156D1D306C800B53C",
"CurrencyIn": "RUB",
"InvId": "Заказ 123",
"custom": "кастомное поле со свободным текстом"
}
После редиректа на Success или Fail URL пользователь должен увидеть сообщение со статусом платежа.
Так как вы можете получить order_id обратно, и в пример выше - это поле InvId, то можно сразу показать сообщение вида
"Ваш заказ InvId успешно оплачен. Благодарим за платёж!"
или
"Оплата по заказу InvId не прошла. Пожалуйста, попробуйте ещё раз или обратитесь в службу поддержки"
Ещё на Result URL вы получите postback с таким содержимым.
{
"Status": "SUCCESS",
"InvId": "Заказ 123",
"Commission": "2.54",
"CurrencyIn": "RUB",
"OutSum": "18.54",
"TrsId": "3P1p2rgW7Y",
"custom": "кастомное поле со свободным текстом",
"SignatureValue": "4A41373E24C99A2656D1D306C800B53C"
}
На основе этого postback вам нужно поменять статус в своей CMS/сайте.
Получив статус SUCCESS вы в своей базе меняете статус заказа на "ОПЛАЧЕНО".
Получив статус FAIL вы соотвественно меняете у себя статус заказа на "НЕ ОПЛАЧЕНО".
Описанного выше достаточно, чтобы начать принимать платежи.
