Мы рады сообщить об общедоступности API следующего поколения (v2 / checkout / orders) и Payments (v2 / payments). Это основа для включения PayPal Checkout с использованием интеллектуальных кнопок оплаты и поддержки нового инновационного способа оплаты, который мы внедряем во всем мире в ближайшие месяцы.
Этот выпуск не влияет на продавцов, разработчиков и партнеров PayPal, которые в настоящее время интегрированы с PayPal Checkout. Мы, конечно, продолжим поддерживать все текущие интеграции и исправлять ошибки в приоритетном порядке, но текущий REST API v1 / payments отныне будет помечен как устаревший, и новые интеграции не приветствуются.
Почему именно v2?
Новые API v2 делают тяжелую работу для продавцов и разработчиков. Они предоставляют комплексное и целостное решение, которое приносит пользу всем пользователям. Они включают согласованный и согласованный набор конечных точек API, охватывающий текущие и будущие возможности PayPal по обработке платежей для обслуживания всех продавцов по всему миру.
Улучшения включают:
- Интерфейсы API переработаны, чтобы максимально соответствовать мировоззрению продавца / партнера, а именно. Заказ, авторизация, захват и возврат.
- Минимальное количество обязательных полей. Начните с малого с 5 строк JSON, чтобы Создать заказ, и настройте другие необязательные поля в соответствии с требованиями варианта использования.
curl -v -X POST https://api.sandbox.paypal.com/v2/checkout/orders \ -H "Content-Type: application/json" \ -H "Authorization: Bearer Access-Token" \ -d '{ "intent": "CAPTURE", "purchase_units": [{ "amount": { "currency_code": "USD", "value": "100.00" } }] }'
- Получение заказа так же просто, как показано ниже, после того, как плательщик утвердил заказ в потоке PayPal Checkout:
curl -v -X POST https://api.sandbox.paypal.com/v2/checkout/orders/order_id/capture \ -H "Content-Type: application/json" \ -H "Authorization: Bearer Access-Token" \ -H "PayPal-Request-Id: 7b92603e-77ed-4896-8e78-5dea2050476a" -d '{}'
- Оптимизированный интерфейс API, который удалил избыточность и непонятные поля. Например, в нашем текущем интерфейсе REST продавец должен будет вызвать любую из указанных ниже конечных точек для возврата в зависимости от того, совершили ли они транзакцию «ПРОДАЖА» или «AUTH CAPTURE».
POST v1/payments/payment/sale/{sale_id}/refund
POST v1/payments/payment/capture/{capture_id}/refund
With this launch we would have a single end point to refund
POST v2/payments/captures/{capture_id}/refund
- Четкие сообщения об ошибках и добавление новых подробных сообщений с полезными деталями.
Обратите внимание, что, хотя фактические интерфейсы API эволюционировали, наша основная платформа обработки платежей остается неизменной, обеспечивая аналогичную производительность, стабильность и доступность.
Мы выпускаем API v2 в полностью протестированном и валидированном состоянии. Мы тестировали API-интерфейсы с продавцами и партнерами в ограниченном выпуске в течение почти 12 месяцев, прежде чем они станут общедоступными. С начала 2018 года они также были доступны для внутреннего пользования и прошли стресс-тестирование нашими инженерами по продажам и специалистами по оказанию профессиональных услуг по всему миру.
Сотни членов команды PayPal и заинтересованных сторон по всему миру сотрудничали и внесли свой вклад в наши API v2. Не раз в процессе разработки мы были близки к запуску API, но понимали, что не решили проблемы продавца и разработчика, которые намеревались исправить. Вместо того, чтобы выпускать нестандартный опыт, мы переориентировались и добились большего, откладывая, пока все не получится.
Готовы переключиться?
Если вы регистрируетесь сейчас или собираетесь начать интеграцию, мы рекомендуем вам начать с новых API v2. Пожалуйста, просмотрите Руководство по интеграции PayPal Checkout, чтобы начать работу. Только на них будут запускаться новые улучшения и улучшения.
Если у вас уже интегрирована PayPal Checkout, мы объяснили шаги, которые необходимо выполнить, чтобы успешно перейти на новые API версии 2. См. Обновление интеграции PayPal Checkout.
Вниз по переулку памяти…
PayPal была пионером в открытии своей платформы, что позволило тысячам мелких торговцев интегрировать кнопку PayPal на свой веб-сайт всего за несколько кликов. По мере роста нашего бизнеса, более крупные продавцы подписывались на предложение PayPal, и вслед за этим возникла необходимость упростить обработку бэк-офиса (например, возврат средств). Чтобы удовлетворить эту потребность пользователей, мы запустили наш первый в истории SOAP API в 2004 году. В 2013 году, по мере развития индустрии и парадигм API, мы запустили наш флагманский REST API v1 / payments.
По мере органического роста API-интерфейсов PayPal Checkout за последнее десятилетие росла и сложность того, что мы предлагали, и того, как мы просили продавцов интегрироваться. Например, с API для конкретных случаев (например, продажа, авторизация и захват, множественная авторизация и множественный захват, обработка кредитных карт), что сделало интеграцию продавцов трудоемкой, а повторную интеграцию - дорогостоящей по мере развития бизнеса и соответствующих потребностей.
Сегодня мы хотим, чтобы наши продавцы один раз интегрировались с API и легко обновились, чтобы получить доступ ко всем возможностям, которые может предложить PayPal.
Сосредоточьтесь на документации
Мы очень позаботились о том, чтобы имена ресурсов, конечные точки и поля были интуитивно понятными. Мы также знаем, что одинаково хорошая документация является ключом к успешной интеграции и положительному опыту продавца / разработчика.
Мы реструктурировали наши руководства по интеграции, чтобы дать возможность нашему сообществу разработчиков как можно быстрее приступить к базовой интеграции с возможностью настройки и решения сложных вариантов использования, когда в этом возникает необходимость.
Дайте нам знать, что вы думаете
В PayPal мы полны энтузиазма и стремимся к вашему успеху. Мы рекомендуем вам попробовать наши новые API и поделиться своими отзывами, чтобы мы могли оптимизировать и продолжать улучшать вашу интеграцию.
