Payeer помогает продавцам создавать платёжные заказы через API или готовую страницу оплаты, а затем принимать оплату картами, криптовалютой и региональными кошельками, с уведомлениями об изменении статуса.

Обновлено:

Вопросы подключения

Я не умею программировать. Как подключить API?

Подключение идёт через API или через готовую платёжную ссылку, поэтому оно не зависит от того, на какой платформе работает ваш сайт. Создание заказа и уведомление о результате описаны в документации, и оба можно проверить в тестовой среде до запуска.

Какое название видит покупатель при оплате?

WeChat Pay: Покупатель видит название магазина при оплате, и его можно изменить. Название задаётся при подаче заявки на канал оплаты.

Alipay: Название магазина отображается во время оплаты и поддаётся изменению. После успешной оплаты покупатель видит в деталях заказа часть названия продавца, со звёздочками.

Мой сайт работает на платформе, которую вы не упоминаете. Он будет работать?

Да. В подключении нет ничего, привязанного к платформе: ваш сервер создаёт заказ через REST API и получает результат уведомлением, а это умеет любой стек. Если вы не хотите трогать код вовсе, поделитесь платёжной ссылкой, и покупатель заплатит на странице, которую размещаем мы.

Счёт и баланс

Зачем пополнять счёт, если можно удерживать комиссию из оборота?

Потому что оборот через нас не проходит: выручка идёт вам напрямую через официальный канал. Удержать из неё комиссию платформы невозможно, поэтому комиссия пополняется заранее и списывается уже с баланса.

Как вывести полученные средства?

По соображениям сохранности средств это делается через поддержку: войдите в кабинет и подайте заявку, её обработают в течение восьми часов.

Как вернуть остаток с баланса?

Порядок возврата баланса: если услуга вам больше не нужна и вы хотите вернуть остаток, сначала закройте все жалобы, убедитесь, что за тридцать дней не было операций и новых жалоб, затем обратитесь в поддержку. Деньги вернутся тем же способом, которым поступали. После возврата счёт и платёжные каналы закрываются и не восстанавливаются. Чтобы сохранить канал и счёт, держите на балансе не менее десяти юаней.

Ошибки при оплате

Payment error: errcode:400, errmsg:invalid httpstatus:400, response: Wrong signature! Please check appid, appsecret

Проверьте:

  • Правильность значений appid и appsecret
  • Нет ли лишних пробелов внутри этих значений
  • Совпадает ли адрес платёжного шлюза с адресом в настройках вашего канала
Payment error: errcode:20019, errmsg: System error: Product amount ¥:XXX is abnormal!

Примечание: некоторые сторонние плагины и темы (например Template Rabbit и 7B2) используют другой адрес шлюза: (configure apiDocsUrl in config.json)

Появляется "System internal error" или другая внутренняя ошибка

Проверьте:

  • Проведите пробную оплату на нашем сайте, чтобы убедиться, что сам канал работает
  • Если ошибка повторяется, обратитесь в поддержку

Примечание: некоторые сторонние плагины используют: (configure apiDocsUrl in config.json)

Покупатель заплатил и вернулся на сайт, но уведомление не пришло и заказ всё ещё не оплачен

Возможные причины:

  • Локальный тест: Сайт, работающий на вашей машине, не может принять уведомление. Сначала разместите его в интернете.
  • Расположение сервера: Если сервер находится за рубежом, доступ к нему может быть заблокирован.
  • Файрвол: Если на сервере стоит файрвол, добавьте наши адреса уведомлений в белый список. Напишите нам, чтобы получить их.
  • CDN: Если сайт работает через сеть доставки контента, добавьте адрес уведомления в белый список.
Оплата прошла, но после возврата на мой сайт на WordPress открывается страница 404

Ошибка 404 возникает по одной из причин:

  • Страница успешной оплаты удалена
  • Не включены постоянные ссылки в WordPress. Их нельзя оставлять на первом варианте: проверьте настройки WordPress или используемого плагина
  • Некоторые пользовательские типы записей не принимают уведомление как надо, из-за чего появляется 404
Когда я открываю свою страницу внутри приложения WeChat, после оплаты она закрывается. Почему?

Наш шлюз пока не поддерживает оплату внутри приложения WeChat. Если открыть ссылку на вашу страницу из переписки в приложении, оплата может пройти, но вернуться на сайт вы не сможете, и уведомление не дойдёт.

Рекомендация: Оплачивайте через браузер на компьютере или телефоне. Если ваш трафик идёт в основном изнутри WeChat, через официальный аккаунт или группы, этот канал может вам не подойти.

Если оплата внутри приложения нужна вам действительно, напишите в поддержку: содержимое сайта проверят и подадут заявку на резервной платформе.

Alipay shows: "System is busy, please try again later"

Попробуйте оплатить с другого аккаунта Alipay. Себе самому заплатить нельзя.

Управление счётом

Я долго не пользовался WeChat Pay и Alipay и больше не могу принимать оплату. Что делать?

WeChat Pay: После длительного перерыва нужно подтвердить намерение вести счёт. Найдите в WeChat мини-программу "WeChat Pay Merchant Assistant", войдите и пройдите: Главная → Работа с рисками → Подтверждение намерения открыть счёт. После подтверждения работа восстановится на следующий день.

Важно: Нужна хотя бы одна операция в месяц, иначе через шесть месяцев без транзакций счёт закроется автоматически.

Alipay: После длительного перерыва напишите в поддержку для повторной авторизации.

Если всё перечисленное не помогло, обратитесь в поддержку, чтобы проверить, нет ли на счёте нарушений или ограничений по рискам.

Работа с жалобами

По какому критерию WeChat Pay считает жалобу закрытой?

WeChat Pay считает жалобу отработанной в одном из трёх случаев:

  1. Возврат тем же способом, которым платили
  2. Если возвращать вы не хотите: Свяжитесь с покупателем и решите вопрос. После того как он перестал жаловаться, загрузите в мини-программу переписку или подтверждение решения и нажмите завершение работы с жалобой
  3. Если вернули вне платформы: Загрузите скриншоты переписки вместе с данными о возврате и подтверждением, затем нажмите завершение работы с жалобой

Выбирается один из трёх вариантов. Это признанный WeChat критерий. Требования: ответить в течение 24 часов, завершить в течение 72 часов.

Споры по операциям идут между покупателем и продавцом, и закрытие должны подтвердить обе стороны. Если жалоба закрыта в одностороннем порядке, нужно предоставить подтверждение работы: загрузите переписку или подтверждение возврата в мини-программу.

Что делать при недобросовестной жалобе?

Недобросовестную жалобу отбивают доказательствами, а не ответами:

  • Предоставьте скриншоты переписки, показывающие, что проблема на стороне покупателя, а не продавца
  • Общайтесь с покупателем через WeChat или QQ и сохраняйте скриншоты
  • Загрузите скриншоты как доказательства в мини-программе WeChat Pay Merchant Assistant, в разделе жалоб потребителей
  • Отказ отвечать на звонки и принимать заявки в друзья в WeChat или QQ сам по себе годится как доказательство

После загрузки доказательств не нажимайте завершение. Если покупатель отвечает, отвечайте и вы, можно тем же текстом. Через месяц такой переписки сообщения обычно прекращаются.

Безопасность и поддержка

Нужна ли мне собственная регистрация ИП?

Нет. Payeer подал собственную лицензию компании в шлюзы WeChat Pay и Alipay, поэтому приём идёт под лицензией платформы, а не под вашей. Расчёты при этом по-прежнему проходят через официальный канал каждого кошелька и попадают на ваш счёт без отдельного шага вывода.

Термины платёжного шлюза

Короткие определения понятий, которые встречаются при интеграции с Payeer.

API Key
Секретные учётные данные, которые выдаются продавцу для подтверждения запросов к REST API Payeer, например при создании платёжного заказа.
Webhook
Адрес HTTPS, на который Payeer отправляет подписанное обновление статуса оплаты после успеха, отказа или истечения срока заказа.
KYC
Проверка личности и документов бизнеса, которая требуется перед подключением некоторых способов оплаты.
Checkout
Размещённая или встроенная страница оплаты, где покупатель выбирает способ и завершает заказ.
Notify URL
Адрес на стороне продавца, который принимает асинхронные уведомления об оплате; его же называют адресом обратного вызова или webhook.
Order ID
Уникальный идентификатор, который Payeer присваивает каждой платёжной сессии, чтобы продавец мог сверять статусы и возвраты.