williamren / alipay-sdk

alipay sdk implemented in java

支付宝服务器端SDK for Java / alipay seller-side sdk for Java

Disclaimer/免责声明

Though I make effort to not stealing your money or any secret about your alipay account, or leak to third-party. But I am still not responsable for any direct or indriect lost for your using of these (or part of) source code. It is your responsibility to check any risk before apply them.

作者不对使用代码所带来的直接或间接损失负责. 由于源代码是公开的, 检查和确保代码的安全性是属于使用者的职责. 请时刻清醒地意识这一点.

Tutorial/教程

Frist of all, ensure you have jdk and apache-ant.
Development environment applied Oracle-jdk 1.7 and apache-ant-1.9.2, all goes well.

1. Generated jar file

run ant jar then there will be the alipay-sdk-x.y.z.jar in project root, where xyz is version code.

2. Config

add these to your classpath: the jar-file mentioned above alipay.properties, whose schema are provided in doc/alipay.properties.sample

3. Invoke

demos are provided in src/com/github/cuter44/stub.java.

首先, 你要有一个 jdk 和 apache-ant. 开发环境使用 Oracle家的jdk7 和 ant 1.9.2, 请依个人喜好酌量添加.

1. 编译: 执行 ant jar, 然后你就有个jar了....
2. 配置: 将那个jar加到你的classpath, 然后还需要一个配置文件, 怎么写参见 doc/alipay.properties.sample
3. 调用: 参见 src/com/github/cuter44/stub.java.

Sample/样例

Initiative request/主动请求

Where initiative means your app generate links and provides to your customer (BUY ME NOW!), or directly send to alibaba's server to achieve certain action.

    public static String demoTradeCreateByBuyer()
    {
        Random rand = new Random();

        try{
            AlipayFactory factory = new AlipayFactory();

            RequestBase req = factory.newTradeCreateByBuyer()
                .setProperty("out_trade_no",        "test"+rand.nextLong())
                .setProperty("subject",             "标准双接口支付测试")
                .setProperty("payment_type",        "1")
                .setProperty("logistics_type",      "EMS")
                .setProperty("logistics_fee",       "0.01")
                .setProperty("logistics_payment",   "SELLER_PAY")
                .setProperty("price",               "2.00")
                .setProperty("quantity",            "1");

            return(req.build().sign().toURL());
        }
        catch (Exception ex)
        {
            ex.printStackTrace();
            return(null);
        }
    }

All initiiative reqs are handled alike, you should first new a AlipayFactory (to load alipay.properties), then call the factory method you need, Pass additional parameters.
And the rest are in one breath. You should sequentially call .build().sign().toURL()(if you need to put it on html) or build().sign().execute()(...if it is executed on server-side, according to alipay's specification).

If executed, the execute() method returns a response in correponding class (need manual casting), which has the response parsed in key-value pairs. As of the to-url-requests, a UnsupportedOperationException will be thrown.

主动请求是指支付宝提供的接口, 包括放在页面上给客户点击的(买买买买买!)和直接在服务器端执行的.

(代码见上)

主动请求的操作方法基本类同, 首先要new一个AlipayFactory(加载配置文件); 然后使用工厂方法构建你想要的请求; 往请求里填参数...
然后就简单了, .build().sign().toURL() 用于生成链接并嵌入到页面, 或者 .build().sign().execute() 直接执行(视支付宝文档而定).

可执行的请求会在执行后返回一个响应, 里面包含解析成键值对的信息; 不应该在服务器端执行的请求会被以 UnsupportedOperationException 吐槽.

Notify/接受回调

Some interfaces accept a notify_url, which means alipay will callback while trade status varying.
This sdk provided a default servlet and a event-publisher to help you accomplish it:

...

Well, I am not pasting code here, go and find it in src/.../webinterface/AlipayNotifyGatewayServlet.java and src/.../AlipayNotifyPublisher.java. If you are too lazy to read them, just have a look at doc/web.xml, and come up your experience about standard publisher-listener model.

有些接口接受名为 notify_url 的参数, 配置的 URL 会在诸如交易状态变化的时候被回调. 本 sdk 提供了一个 servlet 和一个 publisher-listener 结构来完成这个工作:

(不贴代码了)

你这么聪明肯定懂的, 参考这两个就好了: src/.../webinterface/AlipayNotifyGatewayServlet.java
src/.../AlipayNotifyPublisher.java

Covered API/已封装的接口

Listed as below, indluding related API.

// BETA
标准双接口-trade_create_by_buyer(20140122)
即时到账交易接口-create_direct_pay_by_user(20140617)
确认发货接口-send_goods_confirm_by_platform(20130530)
手机网页即时到账接口-wap_trade_create_redirect(20131121)
// TODO
即时到账批量退款有密接口-refund_fastpay_by_platform_pwd(20130621)

Detailed docs/详细文档

For questions with alipay, ask your search engineer. For javadoc, run ant javadoc. For bugs/issues, thanks for visiting https://github.com/cuter44/alipay-sdk/issues