POST /v1/payment/send-email

Отправить покупателю письмо со счётом — с суммой и кнопкой «Оплатить», ведущей на hosted‑страницу оплаты. Полезно, когда счёт выставлен, а покупателя нужно к нему привести: выставили инвойс по почте, напомнили о неоплаченном заказе.

URL: https://api.oblodai.com/v1/payment/send-email · Аутентификация: обязательна.

Примеры используют хелпер call() и переменные $SECRET/$PUBLIC_ID — их определение см. в Как подписать запрос. Проще не писать подпись руками, а взять SDK.

---

​

Чек уходит сам

Если при создании платежа задан payer_email, на этот адрес автоматически уходит ЧЕК после оплаты. Ничего вызывать для этого не нужно — достаточно передать payer_email в POST /v1/payment (или в POST /v1/link/{id}/checkout, где его вводит сам покупатель).

POST /v1/payment/send-email — про другое: это письмо до оплаты, приглашение заплатить. Его вы шлёте сами и можете слать повторно.

	Письмо со счётом («Оплатите»)	Чек («Оплачено»)
Когда	Когда вы вызовете /v1/payment/send-email	Автоматически после оплаты
Кому	email из запроса, иначе payer_email платежа	payer_email платежа
Нужен вызов API	Да	Нет

---

​

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

uuid · string

Идентификатор платежа в Oblodai.

order_id · string

Ваша ссылка на заказ.

email · string

Кому отправить. По умолчанию — payer_email, заданный у платежа.

Нужен uuid или order_id.

Если email не передан и у платежа нет payer_email — слать некуда, придёт 400 email.no_recipient.

---

​

Пример запроса

cURL

BODY='{"order_id":"order-1"}'
TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/payment/send-email' "$BODY" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -s https://api.oblodai.com/v1/payment/send-email \
  -X POST -H 'Content-Type: application/json' \
  -H "X-Public-Id: $PUBLIC_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" \
  -d "$BODY"

# На payer_email, заданный при создании платежа:
call("/v1/payment/send-email", {"order_id": "order-1"})

# На другой адрес:
call("/v1/payment/send-email", {"uuid": "8b1d7d2e-…", "email": "[e-mail]"})

await call("/v1/payment/send-email", { order_id: "order-1" });
await call("/v1/payment/send-email", { uuid: "8b1d7d2e-…", email: "[e-mail]" });

---

​

Пример ответа

{
  "state": 0,
  "result": {
    "sent": true,
    "email": "[e-mail]",
    "uuid": "8b1d7d2e-2b0a-4a1f-9c3e-1f2a3b4c5d6e"
  }
}

sent · bool

Письмо принято в очередь отправки.

email · string

Фактический получатель.

uuid · string

Платёж, по которому отправлено письмо.

---

​

Коды ошибок

Код	Значение
400 request.bad_json	Тело не парсится.
400 email.no_recipient	Получатель не определён: не передан email и у платежа нет payer_email.
503 email.disabled	Почта не настроена на этом шлюзе.
400 payment.bad_uuid	Некорректный uuid.
400 payment.no_lookup	Не передан ни uuid, ни order_id.
404 payment.not_found	Платёж не найден.
401 auth.*	Ошибки аутентификации.

---

​

Нюансы

• Повторная отправка разрешена. Дедупликации нет: вызвав метод дважды, вы отправите два письма. Это сделано намеренно — «напомнить об оплате» законная операция.
• sent: true — это «принято в очередь», а не «доставлено в почтовый ящик». Доставку писем Oblodai не гарантирует и статус не отдаёт.
• Истёкший счёт не блокирует отправку. По истёкшему счёту письмо отправится, но кнопка «Оплатить» приведёт на страницу просроченного счёта. Перед отправкой напоминания проверяйте статус через POST /v1/payment/info — или оживите счёт через is_refresh у POST /v1/payment.

---

​

Связанные страницы

POST /v1/payment

где задаётся payer_email (он же включает автоматический чек).

POST /v1/payment/info

GET /v1/pay/{id}

POST /v1/link/{id}/checkout

покупатель вводит email сам.