Рефсейлс API
Заказы

Получить ссылку на оплату

POST
/api/v1/orders/{id}/payment-link

Выдаёт ссылку, по которой покупатель оплатит заказ через подключённый способ оплаты магазина: PayAnyWay или анкету школы ProOnline. Нужно подключение в настройках интеграций. Сумма берётся из заказа в момент запроса. Если сумма заказа изменилась, запросите ссылку заново: старая перестанет открываться. Повторный запрос для того же заказа возвращает действующую ссылку. Оплату подтверждает платёжная система, после этого заказ становится оплаченным. Ищет заказ по ID Рефсейлс, а с by=externalId по ID из вашей системы. Право: orders:write.

Авторизация

bearerApiKey
headerАвторизацияBearer <ключ>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API-ключи.

Параметры пути

id*string

ID заказа в Рефсейлс или, с by=externalId, ID во внешней системе.

Параметры запроса

by?string

По какому ID искать. По умолчанию id.

Value in"id""externalId"
provider?string

Способ оплаты: payanyway или proonline. Нужен, только если у магазина подключены оба.

Value in"payanyway""proonline"

Ответ

Ссылка на оплату.

application/json
  1. response
data*
curl -X POST "https://example.com/api/v1/orders/string/payment-link"
{  "data": {    "orderId": "3f0e6c5a-2b7d-4e21-9a0f-6d1c8b4e7a52",    "url": "https://refsales.ru/api/merchant-payments/payanyway/checkout/3b9e2f41-8c7d-4a15-b0e6-2d4f7a9c1e58",    "amount": 327000,    "currency": "RUB"  }}

Получить заказ GET

Один заказ с позициями. Ищет по ID Рефсейлс, а с by=externalId по ID из вашей системы. Право: orders:read.

Изменить заказ PATCH

Меняет статус, статус оплаты, контакты покупателя, адрес доставки или комментарий. Передайте хотя бы одно поле. Статус задаётся системным кодом (status) или ID (statusId); статус, который магазин создал сам, выставляется только по ID. Так же для оплаты: paymentStatus или paymentStatusId. Суммы и externalId не меняются. Право: orders:write.