paypal在线支付的通信接口

walksing

浏览: 217804 次
性别:
来自: 深圳

最近访客更多访客>>

u012363178

hellodota

mosoft

dec_liu

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

大杂烩

电子商务 SQL Gmail HTML Servlet

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

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

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

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

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

（1）如何调用paypal接口？（将订单的金额信息提交到paypal网站）
Html代码
<%@ 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">
    <input type="hidden" name="item_name" value="order information">
    <input type="hidden" name="amount" value="220.00">
    <input type="hidden" name="currency_code" value="USD">
    <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 type="hidden" name="notify_url" value="http://www.xxx.com/notifyurl.jsp?order_id=23876412">
    <input name="Paypal" type="button" value="Go to Paypal" onclick="javaScript:this.form.submit();"></td>
    </form>
</body>
</html>

<%@ 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">
<input type="hidden" name="item_name" value="order information">
<input type="hidden" name="amount" value="220.00">
<input type="hidden" name="currency_code" value="USD">
<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 type="hidden" name="notify_url" value="http://www.xxx.com/notifyurl.jsp?order_id=23876412">
    <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]的一个例子：
Html代码
<%@ 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");}
%>

<%@ 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发来的付款信息

Java代码
/*
* 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 {
            //
        }
    }

}

/*
* 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])中没有的。

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

<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环境的，也可以参考上面的内容。

http://dl.iteye.com/topics/download/12b978e8-b2bb-3593-bd63-ebcc7ff0e153
PP_OrderManagement_IntegrationGuide.pdf.zip (1.1 MB)

分享到：

令人担忧的国内java开发现状 | 终于搞定了Windows下Tomcat Web服务器的SS ...

2010-11-25 22:15
浏览 871
评论(0)
分类:企业架构
查看更多

发表评论

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

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论