Подключить Authorize.Net

Что вам нужно

Поле	Что оно делает
API Login ID	Идентифицирует ваш счёт в вызовах API. В паре с Transaction Key.
Transaction Key	Секретная половина авторизации API. Вместе с Login ID создаёт каждую платёжную форму. Секретный.
Signature Key	Подтверждает, что вебхук действительно пришёл от Authorize.Net. Отдельно от Transaction Key. Секретный.
URL успеха / URL отмены	Куда попадает покупатель после оплаты или отказа.

API Login ID и Transaction Key всегда идут вместе. Signature Key независим.

Почему мы спрашиваем каждое поле

Называет ваш счёт в вызовах API. Работает только в паре с Transaction Key.

Transaction Key

Секрет, доказывающий, что запрос API ваш. Вместе с API Login ID он позволяет нам построить размещённую платёжную форму, чтобы списание прошло через ваш счёт.

Signature Key

Доказывает, что входящий вебхук подлинно от Authorize.Net, так что никто не подделает событие «оплачено». Это отдельное значение от Transaction Key.

URL успеха и отмены

Простые настройки: куда попадает покупатель после оплаты или отказа. Не секретные.

Настройка

Создайте бесплатный счёт песочницы (без оплаты)
Для тестирования вам не нужен платный мерчант-счёт. Authorize.Net предлагает бесплатную песочницу, повторяющую боевую среду, без кредитной карты.
1. Перейдите на developer.authorize.net/hello_world/sandbox.html и зарегистрируйте счёт песочницы. Используйте эту ссылку, а не основную страницу регистрации или цен (это платная боевая заявка).
2. Войдите в Merchant Interface песочницы на sandbox.authorize.net.
Схема подписи идентична боевой, так что всё, что вы проверите в песочнице, ведёт себя так же в боевой среде.
Скопируйте три ваших учётных данных
Один путь и в песочнице, и в боевой среде: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.
- API Login ID показан сверху.
- Transaction Key: выберите «New Transaction Key», подтвердите и скопируйте его сразу (он показывается один раз).
- Signature Key: выберите «New Signature Key», подтвердите и скопируйте его сразу.
Account → Settings → Security Settings → API Credentials and Keys
Добавьте вебхук
1. Account → Settings → Business Settings → Webhooks, добавьте эндпоинт.
2. Задайте URL эндпоинта на адрес вебхука вашего проекта (ниже).
3. Подпишитесь на события. Разовые платежи: net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created и события fraud.* (held, approved, declined). Подписки (Automated Recurring Billing): события net.authorize.customer.subscription.*. Продления приходят как authcapture.created, уже покрыто. Лишние события безвредны.
4. Сохраните. Authorize.Net подписывает каждую доставку вашим Signature Key.
```
https://api.coinmoebius.com/webhook/authorizenet/<your project id>
```
Account → Settings → Business Settings → Webhooks
Coin Moebius записывает id каждого события один раз и игнорирует дубликаты, так что повторно отправленные вебхуки обрабатываются за вас.
Тестируйте картами песочницы
Карты песочницы никогда не списывают с реальной карты. Используйте любую будущую дату окончания (например, 12/2030) и любой CVV (3 цифры, или 4 для American Express).
Сеть Карта
Visa 4111111111111111
Mastercard 5424000000000015
American Express 370000000000002
Discover 6011000000000012
Подключите в панели управления
Добавить провайдера → Authorize.Net. Введите URL успеха, URL отмены и боевую группу (API Login ID, Transaction Key, Signature Key). Добавьте необязательную группу песочницы для тестов. Группа песочницы «всё или ничего»: все три поля или ни одного. Боевая среда и песочница проверяются отдельно.

Сеть	Карта
Visa	4111111111111111
Mastercard	5424000000000015
American Express	370000000000002
Discover	6011000000000012

После подключения

Сделайте один тестовый платёж до запуска:

Создайте товар и задайте его Environment как Testing. Это запускает товар на учётных данных песочницы, так что вы можете оформить полный заказ без движения денег. (Если вы пропустили набор песочницы, товар Testing откатывается к боевой среде, так что сначала добавьте его.)
Поставьте кнопку покупки на страницу (подойдёт локальный HTML-файл), направленную на ваш проект.
Завершите оформление тестовой картой песочницы из списка выше.
Откройте вкладку «Транзакции». Появляется новая строка с меткой Testing. Когда её статус достигнет succeeded, ваши учётные данные и вебхук оба работают от начала до конца.

Переключите Environment товара на Live, когда будете готовы к реальным платежам.

Решение проблем

Начните с «Проверить». В панели нажмите «Проверить» (или «Проверить тестовые учётные данные» для набора песочницы), чтобы проверить ваши API Login ID и Transaction Key.

«Проверить» не проходит.

API Login ID и Transaction Key должны быть парой из одного и того же счёта (боевого или песочницы). Перекопируйте оба.

Проверка подписи не проходит.

Signature Key, это значение, отличное от Transaction Key. Скопируйте Signature Key с того же экрана. Схема идентична в песочнице и боевой среде.

Платёж завершается, но заказ остаётся в ожидании.

Подтвердите, что URL вебхука совпадает в точности и что вы подписались на платёжные события.

Тестовый товар списал с боевой карты.

Товар, отмеченный как тестовый, откатывается к вашим боевым учётным данным, когда полный набор песочницы не настроен. Добавьте все три поля песочницы или снимите с товара отметку «тестовый».

Подтвердите всё от начала до конца.

Authorize.Net пингует только неактивные вебхуки: сделайте эндпоинт неактивным, отправьте пинг, затем снова активируйте его и смотрите, как обновляется заказ.

Полезно знать

Токены недолговечны. Токен размещённой формы живёт около 15 минут. Мы создаём свежий на каждое оформление.

Валюта. Authorize.Net, это в основном шлюз США в USD. Не-USD зависит от вашего соглашения с процессингом.

Ротация ключей. Генерируйте новый Transaction Key или Signature Key когда угодно, затем вставьте его. Секретные поля остаются пустыми при редактировании.

Вопросы? Join our Discord

Authorize.Net