soap - Paypal 文档(REST，经典 : SOAP & NVP ) What to choose ?

Question

我需要使用 PayPal API 开发支付解决方案。实际上我开始了文档阶段(在 http://developers.paypal.com 上)

我发现 REST API 可以理解，但我仍然不知道如何使用 SpringMVC 实现它们，所以我只是使用 cURL 来测试它们。 (对此有什么帮助吗？)

另一方面，经典 API 令人困惑。 (例如，我们可以使用自适应帐户做什么，快速结帐和自适应支付之间有什么区别等。)。

另一件事是，我们需要在创建隐藏表单 (html) 或使用 API 之间做出选择。 (我需要解释)

文档很长，我真的很困惑，我不知道该选择什么(显然 REST APIs 更适合简单的支付，但我真的很想了解更多关于SOAP & NVP ..)

我是新手，有人可以做志愿者来帮助我吗？

谢谢!

Answer 1

经过几次 PayPal 集成舞蹈(虽然现在是几年前)让我总结一下我的想法(请记住，事情可能略有变化)

PayPal 提供大量 API/集成方法的原因在于他们希望能够从大量地方 刺痛您 支持付款:

• 如果您只有博客、静态 HTML 托管、现成的电子商务网站或其他一些“原始”网络技术，submitting hidden HTML forms几乎是您唯一的选择。我怀疑这是 PayPal 使用的原始机制，虽然他们必须永远继续支持它，但您今天不会希望从像这样的现代网络框架中使用这种方法SpringMVC。

• NVP API是另一个长期存在的集成方案，在您的客户所能做的所有事情都有效地将参数拼接成 URL 的时候，它是合适的。在 REST JSON API 可用的今天，没有充分的理由使用此 API - 大多数人发现 JSON 比 URL 编码的参数更容易阅读。

• 我猜接下来按时间顺序介绍，SOAP API反射(reflect)了 XML 即将统治世界的时代。在某些(非常严格和/或传统的)地方，它仍然如此。同样，这些天，如果您有选择，您可能不会走这条路 - 使用 Java 通常涉及与 SOAP 框架的紧密集成，如 Apache CXF和大量机器生成的 .java 文件。

• REST API是最现代和(恕我直言)最适合从 Java 领域使用的，也是我推荐的选项。看起来 PayPal 也希望您使用它，所以我将在本回答的其余部分中讨论它。

作为 Java 开发人员，当您选择 REST API 时，您可以进一步选择使用 PayPal's SDK或滚动您自己的集成方案。在以下情况下考虑使用 SDK:

• 您可以预见您的 PayPal 集成将变得非常庞大和/或使用高级 API 功能

• 您没有任何其他 HTTP 集成点，因此还没有从您的代码调用 HTTP 方法的基础设施(例如 Apache HttpClient 或 Spring 3 内置的 RestTemplate 功能)

• 您没有(或不想)可用的 JSON 解析器

由于您已经通过 cURL 使用 API 并且了解调用及其顺序，因此您可能对此犹豫不决。如果您的时间压力不大，我建议您使用(和学习)Apache HttpClient 以及像 Jackson 这样的 JSON 库，走自己的路。 - 它们是您武器库中的宝贵工具，您几乎肯定会在未来的集成中再次使用它们。

另一个开发技巧，适用于任一 REST API 选项 - 如果您使用“ stub 服务器”，例如 this one为了模拟 PayPal 的连接结束，它会记录它收到的每个请求的详细信息并做出适当的响应。这可能是一个天赐之物，可以准确调试“通过线路”发出的内容和/或重复测试。