Перейти до основного вмісту
Цей посібник проведе вас через повний цикл замовлення з PapelShip Store API: створіть замовлення на один зі своїх товарів, перенаправте клієнта на хостингову сторінку оформлення та підтвердьте оплату, перш ніж на неї покладатися.

Передумови

  • Магазин PapelShip щонайменше з одним товаром
  • Ключ Store API (pk_live_...) з дозволом orders:write, а також ID вашого магазину для заголовка x-store-hash
Обидва значення ви знайдете в панелі керування PapelShip у налаштуваннях API вашого магазину. Див. Автентифікація.
1

Створіть замовлення

Надішліть email клієнта та товари. Додайте заголовок Idempotency-Key, щоб повторні спроби ніколи не створювали друге замовлення.
2

Перенаправте клієнта на оформлення

Відповідь містить замовлення з його checkout_url. Перенаправте туди клієнта, щоб він оплатив будь-яким способом, який приймає ваш магазин.
Відповідь (201)
Збережіть invoice.id разом зі своїм замовленням. Неоплачені замовлення спливають через 3 години. Щоб одразу списати кошти з картки або показати форму картки на власному сайті, див. PapelPay.
3

Підтвердьте оплату

Ніколи не покладайтеся лише на повернення клієнта на ваш сайт. Слухайте вебхук order.completed або прочитайте замовлення на своєму сервері:
Замовлення оплачене й доставлене, коли status має значення completed.
Зберігайте API-ключ на своєму сервері. Ніколи не включайте його в браузерний код, мобільні застосунки чи десктопні клієнти.

Наступні кроки

Замовлення

Фізичні товари, статуси, скасування та повернення коштів.

PapelPay

Оплата карткою, підписки та форма картки на вашому сайті.