Playing In PayPal’s Sandbox

Как это работает? 

Многие из нас думали об этом в тот или иной момент. Самый распространенный способ получить ответ на данный вопрос - сделать тестовую покупку ($1 или меньше).  Комиссия PayPal'a - около 35 центов за операцию (2,9% + $0,30). Многие люди просто считают это стоимостью стартапа. Но есть альтернативный вариант, не требующий вложений - это PayPal Sandbox.

PayPal состоит из трех компонентов:

1. Live PayPal – место, где проводятся операции с деньгами.
2. Sandbox – копия live-среды для тестирования, но без денежных операций и без реальных данных (только тестовые аккаунты и транзакции, существующие в данной среде).
3. Developer portal – обеспечивает управление тестовыми аккаунтами и предлагает доступ к инструментам тестирования. К примеру, симулятор Instant Payment Notification (мгновенное уведомление об оплате).

Get Started

Для начала вам нужен аккаунт в песочнице. Получить его можно, зарегистрировавшись на Developer PayPal. Обратите внимание что за операциями в песочнице не стоят реальные денежные средства. Вы просто оперируете цифрами на виртуальных тестовых счетах. 

Из соображений безопасности не стоит указывать email связанный с вашим доменом для аккаунта песочницы. Но если вы планируете проводить end-to-end тестирование, предполагающее отправку писем клиентам, вы можете использовать “hard to guess” e-mail адрес Вашего сайта для песочницы.

После завершения регистрации и верификации вы сможете зайти в свой sandbox account.  Вероятно, вы будете использовать в основном только две секции: “Test Accounts” и “Test Email.” 

Test accounts

После регистрации переходим в раздел “Test accounts” и создаём два “Preconfigured” счёта — один представляет собой покупателя (Buyer), другой - продавца (Seller). При создании счёта Seller его типом по умолчанию является “Business”. Рекомендуется использовать предварительно настроенные счета и корректировать их по мере необходимости. В песочнице разница между Premier и Business отсутствует. При создании счёта рекомендуется вписать сумму в валюте открываемого счёта (максимум - 9.999.999). Эта сумма будет расходоваться или добавляться в зависимости от операций между созданными счетами. Автоматически созданный email и пароль стоит куда-нибудь записать, поскольку эти реквизиты являются доступом к счетам в песочнице по адресу www.sandbox.paypal.com

Чтобы создать новый аккаунт, щелкните по кнопке New Account и заполните форму.

После того, как ваш тестовые учетные записи созданы, вы можете перейти в “Sandbox Test Site”. Здесь вы можете моделировать PayPal счета для каждой тестовой учетной записи.

Test Email

“Test Email” будет содержать все сообщения электронной почты. Всякий раз, когда система PayPal обрабатывает транзакции, она отправляет сообщения электронной почты сторонам-участникам (покупателю и продавцу). Созданным тестовым счетам присваивается случайный суффикс e-mail адресов - в том же домене что и ваш sandbox-аккаунт.

Configuring Your Site

Большинство плагинов, поддерживающих платежный шлюз PayPal позволяют вам выбирать, хотите ли вы работать в режиме Live или Sandbox. Естественно, для тестирования вам нужен режим Sandbox (песочница).

PayPal Email Address

Если ваш плагин будет использовать PayPal Simple Payment, то в таком случае вам понадобится указать почтовый адрес. Вам нужно ввести почтовый адрес для бизнес-аккаунта песочницы, который был автоматически задан для вас, когда вы вошли в портал разработчика.

Вы можете увидеть этот почтовый адрес по ссылке Applications — Sandbox accounts.

PayPal Merchant Account ID

Это поле обычно требуется, когда плагин использует шлюз Payments Standard и нуждается в Merchant ID для бизнес-аккаунта Sandbox.

Обратите внимание - эти данные недоступны в портале разработчика, поэтому вам понадобится войти на сайт PayPal Sandbox, используя учетные данные бизнес-аккаунта песочницы.

Как только вы войдете, щелкните по Profile — My Business Info.

Вы увидите различные данные, которые являются рандомными, но их можно обновлять. Merchant ID будет показан ближе к низу списка.

Вы можете изменить здесь имя аккаунта (на название вашей фирмы), чтобы платежные страницы PayPal выглядели более реалистично.

PayPal Site

Это очень важные данные. Убедитесь в том, что выбранная страна совпадает с той страной, которая указана в адресе бизнес-аккаунта. (в этом не уверен, нужно проверить)

PayPal API Credentials

Если ваш плагин использует PayPal API для доступа к шлюзу PayPal, вам нужно будет ввести для него имя пользователя, пароль и сигнатуру.

Эти данные можно найти в портале разработчика:

1. Переходим в раздел Applications — Sandbox accounts.
2. Щелкаем по стрелочке рядом с бизнес-аккаунтом и затем по profile
3. Щелкаем по API Credentials.

Эти данные и вставляем в форму конфигурации плагина.

Let’s Play!

С помощью одной сессии откройте две вкладки браузера. В первом окне “Test Conductor” и “Test Subject” во втором. В окне “Test Conductor” войдите в свой счет PayPal Sandbox. В окне “Test Subject” откройте ваш сайт и убедитесь, что Вы не вошли в систему как администратор.

В окне “Test Subject” тестируйте любые покупки/операции. Для оплаты используйте тестовую учетную запись покупателя ("Buyer"). Все сгенерированные PayPal'ом письма будут отображаться в разделе “Test Email” песочницы, доступной из окна “Test Conductor”.

Caveats And Warnings

1. Вы должны войти в песочницу для того чтобы тестировать сделки.
2. Те кто попытается сделать “реальные покупки” в то время, когда сайт настроен для песочницы будут разочарованы. При попытке оформления заказа они будут направлены на станицу входа PayPal Sandbox.
3. Сделки в песочнице неотличимы от реальных сделок. Любые продажи, инвентаризации или бухгалтерский учета на вашем сайте будут думать что продажи действительно произошли. Не забудьте сбросить записи инвентаризации или продажи.
4. Не забудьте отменить "sadnbox-mode" при изменении конфигурации вашего сайта.
5. Если, находясь в режиме " песочница", вы установили какие-либо повторяющиеся платежи - не забудьте их отменить их перед отключением песочницы. Иначе через месяц после того как вы отключите песочницу ваш сайт начнет получать поврежденные IPN из песочницы, и Вы можете подумать что вас кто-то хакнул.

Video Tutorial

---

P.S. Изначально задумывалось как перевод одной статьи. Но так вышло, что теперь здесь и перевод и анализ статей с WP и Хабрахабра. В общем, получилась сборная солянка :)