paypal在线支付的通信接口

stephen830

浏览: 3010238 次
性别:
来自: 上海

最近访客更多访客>>

jAmEs_

wangzhigang2

Z865785437029

sampou

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

java

电子商务 Firefox 浏览器 HTML SQL

★★★ 本篇为原创，需要引用转载的朋友请注明：《 http://stephen830.iteye.com/blog/254565 》，谢谢支持！★★★

本篇将讲述与paypal在线支付的通信接口问题：

关于paypal在线支付的信息可以直接访问http://www.paypal.com。paypal作为国际在线支付的一种比较常用的工具，在现在的国际电子商务中使用的非常多，这里将就paypal支付接口与企业自己的网上电子商务系统之间沟通作一详细描述。

一般电子商务系统实现的流程如下：
客户在系统内下订单 -> 将订单的金额信息提交到paypal网站 -> 客户在paypal上付款 -> paypal将客户的付款完成信息发送给电子商务系统 -> 系统收到paypal信息后确定客户订单已经付款 -> 进行发货等后续流程。

从这个流程中可以看到系统与paypal的通信尤其关键，可以实现订单的自动付款确认。

（1）如何调用paypal接口？（将订单的金额信息提交到paypal网站）

<%@ page contentType="text/html;charset=UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>goto paypal</title>
</head>
<body bgcolor="#000000" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
    <form name="paypal" action="https://www.paypal.com/cgi-bin/webscr" method="post">
    <input type="hidden" name="cmd" value="_xclick">
	<input type="hidden" name="business" value="paypal@xxx.com"><!--这里填写你的paypal账户email-->
	<input type="hidden" name="item_name" value="order information"><!--这里填写客户订单的一些相关信息，当客户连到paypal网站付款的时候将看到这些信息-->
	<input type="hidden" name="amount" value="220.00"><!--订单的总金额信息-->
	<input type="hidden" name="currency_code" value="USD"><!--订单总金额对应的货币类型 ,客户可以用其他币种来付款,比如这里订单币种是美元USD,客户可以用欧元EUR来付款,由paypal根据当前汇率自动实现币种之间的换算-->  
	<input type="hidden" name="on0" value="customerId"><!-- 自定义的参数1 -->
	<input type="hidden" name="os0" value="stephen"><!-- 对应上面自定义参数1对应的值 -->
	<input type="hidden" name="on1" value="address"><!-- 自定义的参数2 -->
	<input type="hidden" name="os1" value="shanghai china"><!-- 对应上面自定义参数2对应的值 -->
	<input type="hidden" name="notify_url" value="http://www.xxx.com/notifyurl.jsp?order_id=23876412"><!--这里告诉paypal付款的通信url,即当客户付款后调用这个url通知系统-->
    <input name="Paypal" type="button" value="Go to Paypal" onclick="javaScript:this.form.submit();"></td>
    </form>
</body>
</html>

在生成上面的paypal表单时,其中的[cmd],[action],[business],[amount],[currency_code],[notify_url]参数设置绝对不能出错,[cmd]和[action]指定paypaly接口类型，[business]出错,你将收不到客户的付款,[amount]与[currency_code]关系到订单的金额,[notify_url]是系统与paypal的付款通知接口url。

当客户下单后看到上面的页面后，就可以通过设置的按钮[Go to Paypal]连接到paypal.com网站，然后登录并进行付款。

（2）paypay将付款信息返回给系统
当客户付款后，paypal就会自动调用上面表单提供的[notify_url]，下面是一个[notifyurl.jsp]的一个例子：

<%@ page contentType="text/html;charset=UTF-8"%><%@ page import="com.soft4j.NotifyUrlMgr"%><%
	String ret = NotifyUrlMgr.insert(request);
	if(ret==null){out.print("200 OK");}else{out.print("fail");}
%>

如果确认收到paypal发来的客户付款信息，则返回"200 OK"，这样子paypal就知道系统已经收到信息了；否则返回"fail"，这样paypal会过一段时间后再次发来。其实，只有当paypal收到"200 OK"的返回信息后才会停止发送付款信息，否则会自动的每隔一段时间就调用上面
的[notify_url]通信接口。

（3）系统处理paypay发来的付款信息

/*
 * Created on 2005-6-12
 * Author stephen
 * Email zhoujianqiang AT gmail DOT com
 * CopyRight(C)2005-2008 , All rights reserved.
 */
package com.soft4j;

import java.sql.Connection;
import java.sql.SQLException;
import java.util.Enumeration;
import java.util.Vector;
import javax.servlet.http.HttpServletRequest;

/**
 * paypal付款通知接口.
 * 
 * @author stephen
 * @version 1.0.0
 */
public final class NotifyUrlMgr {
	
	
    public static String insert(HttpServletRequest httpRequest) {
        
        //定义变量和进行必要的初始化工作
        Enumeration parameterNames = null;
        String parameterName = null;
        String parameterValue = null;
        int count = 0;
        Vector[] params = null;
        Vector vParameterName = new Vector();
        Vector vParameterValue = new Vector();

        //判断paypal付款账户是否正确
        String business = httpRequest.getParameter("business");
        if( !"paypal@xxx.com".equals(business) ) {
        	System.out.println("gu:Wrong receive paypal email:"+business);
        	return null;
        }
        
        try {
            String orderId = httpRequest.getParameter("order_id");//订单号
            if(orderId==null||"".equals(orderId)) orderId="-1";
            parameterNames = httpRequest.getParameterNames();
            boolean isPrint = false;
            while (parameterNames.hasMoreElements()) {//循环收取paypal发来的所有参数信息
                parameterName = (String) parameterNames.nextElement();
                parameterValue = httpRequest.getParameter(parameterName);
                if(parameterValue==null) parameterValue="";
                vParameterName.add(parameterName);
                vParameterValue.add(parameterValue);
                count++;
            }
            
            //这里添加对收到信息的处理:一般是将这些信息存入数据库,然后对客户的订单进行处理.
            
            return null;
        } catch (Exception e) {
            return e.toString();
        } finally {
            //
        }
    }

}

这样系统可以自动对客户订单的付款情况进行跟踪,更快捷的进行订单处理。

附录：
[1] paypay允许的币种

AUD Australian Dollar
CAD Canadian Dollar
CHF Swiss Franc
CZK Czech Koruna
DKK Danish Krone
EUR Euro
GBP Pound Sterling
HKD Hong Kong Dollar
HUF Hungarian Forint
JPY Japanese Yen
NOK Norwegian Krone
NZD New Zealand Dollar
PLN Polish Zloty
SEK Swedish Krona
SGD Singapore Dollar
USD U.S. Dollar

[2] paypal付款信息的参数含义：

https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html

[3] paypal提供的开发api的pdf文档

PP_OrderManagement_IntegrationGuide.pdf.zip [在附件中可以下载]

[4] paypal提交付款所支持的参数及其含义（也就是你提交给paypal中的那个Form表单中需要设置的参数）
https://www.paypal.com/IntegrationCenter/ic_std-variable-reference.html

[5] paypal显示页面的语言设置（也就是打开paypal网站的语言）。需要用参数locale.x进行设置，但这个参数在paypal提供的参数表(参见上面[4])中没有的。

<form name="paypal" action="https://www.paypal.com/cgi-bin/webscr?locale.x=zh_HK" method="post">
...
</form>

locale.x=zh_HK 繁体中文
locale.x=en_GB 英文

如果你的电子商务系统不是java环境的，也可以参考上面的内容。

PP_OrderManagement_IntegrationGuide.pdf.zip (1.1 MB)
下载次数: 1078

分享到：

ip地址与数字（长整数）之间的转换 | 把我的积累与朋友们分享

2008-10-18 08:16
浏览 8316
评论(21)
论坛回复 / 浏览 (21 / 26620)
分类:企业架构
查看更多

21 楼 tiyi 2009-10-16

woshihlp 写道

有登陆支付的页面,但是有个可怕的BUG...用firefox能跳转到正确的登陆页面,在本地支付成功返回也成功,到了远程访问支付成功后返回连接被重置...然后用其他浏览器提交表单后跳转到的登陆页面是另外一种,登陆了没有提交的表单里的信息...

我做的是国际接口,会不会跟浏览器或者系统语言有什么关系?

找到答案了……
你要先登录develop。记得别关掉浏览器。
回到你的支付页面，再试试

20 楼 stephen830 2009-03-17

snyyh 写道

你好 LZ
如果我是用的是购物车,用户可以更改购物数量,最后IPN返回的信息只有总共买了多少钱,而我们却不知道他是买了哪些商品,这将如何解决呢

你可以在下面的代码里面设置下订单号：

<input type="hidden" name="notify_url" value="http://www.xxx.com/notifyurl.jsp?order_id=23876412">

里面的order_id=xxxx，就是客户下单的订单号，这样在客户付款成功后就可以通过这个notifyurl.jsp收到客户这笔款项对应的订单了。

19 楼 snyyh 2009-03-17

你好 LZ
如果我是用的是购物车,用户可以更改购物数量,最后IPN返回的信息只有总共买了多少钱,而我们却不知道他是买了哪些商品,这将如何解决呢

18 楼 kjj 2009-03-09

那我就不知道，paypal那种接口，开发出来给谁用的！

17 楼 stephen830 2009-03-09

kjj 写道

有什么不可取的，许多网站都可以在本地提供支付接口

如果真是这样，相信我肯定是不会用的，而且相信大多数的用户也是这么考虑的。

就像在一个普通的购物网站上，让你输入你的支付宝账号和密码就可以进行支付，那绝对是不安全的。

当然，如果真有这样的网站，基本上是骗子网站了。

16 楼 kjj 2009-03-09

有什么不可取的，许多网站都可以在本地提供支付接口

15 楼 stephen830 2009-03-09

kjj 写道

stephen830 写道

kjj 写道

使用卡号密码支付就会更加不安全！使用evp 是加密的，就是说，卡号密码传输过程都是高度加密的，根本不需要登录paypal账户！

你所说的卡号和密码在哪里输入的呢？

paypal 支付网站提供了多种支付方法，你所举的例子只是其中最简单的一种html变量支付，直接用信用卡的属于高级内容，你可以上paypal网站下载他的例子运行看看！

不管是何种方式，如果是在非paypal的网站上要求提供paypal账号和密码都是不可取的，尤其是密码。

14 楼 kjj 2009-03-09

stephen830 写道

kjj 写道

使用卡号密码支付就会更加不安全！使用evp 是加密的，就是说，卡号密码传输过程都是高度加密的，根本不需要登录paypal账户！

你所说的卡号和密码在哪里输入的呢？

13 楼 woshihlp 2009-03-09

<form action="https://www.sandbox.paypal.com/cgi-bin/webscr"
		method="post" name="paypal">
		<input type="hidden" name="cmd" value="_xclick">
		<input type="hidden" name="notify_url"
			value="http://localhost:1118/GosafeCart/notify.jsp?oid=${myodt.orderId}">
		<!--这里填写你的paypal账户email-->
		<input type="hidden" name="business"
			value="GSTest_1235975491_biz@163.com">
		<!--这里填写客户订单的一些相关信息，当客户连到paypal网站付款的时候将看到这些信息-->
		<input type="hidden" name="item_name" value="testitem">
		<input type="hidden" name="return"
			value="http://localhost:1118/GosafeCart/notify.do?id=${myodt.id}&oid=${myodt.orderId}">
		<input type="hidden" name="cancel_return"
			value="http://localhost:1118/GosafeCart/pay_fail.jsp">
		<input type="hidden" name="item_number" value="1">
		<input type="hidden" name="buyer_credit_promo_code" value="">
		<input type="hidden" name="buyer_credit_product_category" value="">
		<input type="hidden" name="buyer_credit_shipping_method" value="">
		<input type="hidden" name="buyer_credit_user_address_change" value="">
		<input type="hidden" name="no_shipping" value="0">
		<input type="hidden" name="cn" value="Information">
		<input type="hidden" name="no_note" value="0">
		<input type="hidden" name="currency_code" value="USD">
		<input type="hidden" name="bn" value="PP-BuyNowBF">
		<input type="hidden" name="amount" value="${myodt.total}">
		<input type="hidden" name="on0" value="customerId">
		<input type="hidden" name="os0" value="stephen">
		<input type="hidden" name="on1" value="address">
		<input type="hidden" name="os1" value="shanghai china">
		<input src="https://www.paypal.com/en_US/i/btn/btn_buynow_LG.gif"
			name="submit"
			alt="Make payments with PayPal - it' s fast, free and
			secure!"
			border="0" height="26" type="image" width="107">
		<img alt="" src="../../../pixel.gif" border="0" height="1" width="1">
	</form>

代码有些不同,但是这问题也出的太怪了

12 楼 stephen830 2009-03-08

kjj 写道

使用卡号密码支付就会更加不安全！使用evp 是加密的，就是说，卡号密码传输过程都是高度加密的，根本不需要登录paypal账户！

你所说的卡号和密码在哪里输入的呢？

11 楼 kjj 2009-03-08

使用卡号密码支付就会更加不安全！
使用evp 是加密的，就是说，卡号密码传输过程都是高度加密的，根本不需要登录paypal账户！

10 楼 stephen830 2009-03-07

kjj 写道

dawangzi 写道

请教下，是不是customer购物的时候必须要有一个paypal帐户?

可不可以不用paypal帐户。

我看到很多网站没有登录，用户也没有支付网关帐户。

但是他们在购物网站上只要输入卡号，好cvc就能购物，请问这个一般是怎么实现的哈？

就是如何做到用户没有支付网关帐户而只需要卡号和cvc号码就能付款、
(我猜的是他们直接用的visa卡或者其他卡机构提供的api，不知道对不对？)

谢谢。。

这个不一定，楼主这种支付支持basic 形式，paypal api 支持直接在页面上使用卡号密码支付形式！
PS:楼主这个支付没加密

使用卡号密码支付就会更加不安全！

另外客户不可能把密码提供给你的网站。一般都是由客户直接在官方paypal上登录后再进行支付的。

9 楼 stephen830 2009-03-07

woshihlp 写道

我做的是国际接口,会不会跟浏览器或者系统语言有什么关系?

应该不会，我做的一家客户使用这个接口已经用了近3年了，而且每天差不多有200笔左右的订单支付进来，没有出现过任何问题。

8 楼 kjj 2009-03-07

dawangzi 写道

这个不一定，楼主这种支付支持basic 形式，paypal api 支持直接在页面上使用卡号密码支付形式！
PS:楼主这个支付没加密

7 楼 woshihlp 2009-03-07

我做的是国际接口,会不会跟浏览器或者系统语言有什么关系?

6 楼 stephen830 2009-03-06

woshihlp 写道

我按上面写了页面提交表单后会转到登陆页面,登陆进去没有定单
之后用paypal生成的按钮,里面只有一个参数[hosted_button_id],提交后转到支付页面,但是里面的产品名,金额什么的都是静态绑定的
希望LZ指点...

提交表单后会转到登陆页面，在登录页面的最上面可以看到本次提交的一些信息，这个应该有的吧？

5 楼 woshihlp 2009-03-06

4 楼 stephen830 2008-12-03

firefox_1983 写道

很多网站不需要走paypal或者支付宝,可以走银联或国际信用卡的支付网关。

如果你面向的是客户主要是华人的话，你可以这样。但是如果你面向世界各地的人，建议最好使用paypal。

当然，如果你只是面向国内的客户，你就根本不需要使用paypal，使用国内的支付宝完全可以了。

3 楼 stephen830 2008-12-03

dawangzi 写道

请教下，是不是customer购物的时候必须要有一个paypal帐户? 可不可以不用paypal帐户。我看到很多网站没有登录，用户也没有支付网关帐户。但是他们在购物网站上只要输入卡号，好cvc就能购物，请问这个一般是怎么实现的哈？就是如何做到用户没有支付网关帐户而只需要卡号和cvc号码就能付款、 (我猜的是他们直接用的visa卡或者其他卡机构提供的api，不知道对不对？) 谢谢。。

是的。必须要有paypal账号，而且与信用卡进行绑定。

2 楼 firefox_1983 2008-12-02

很多网站不需要走paypal或者支付宝,可以走银联或国际信用卡的支付网关。

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论