订单推送API

如果您的购物车不是 Teapplix 支持的购物车,并且您希望构建自定义集成以便订单能够传入 Teapplix,您可以有多种选择。本文介绍如何使用 HTTP POST 将订单发送到 Teapplix。

使用此种方法,您可以将订单几近实时地自动推送到 Teapplix 帐户中。可以通过任何编程语言编写您的购物车。

此种方法的弊端是信息只能单向流动。订单会从购物车传递到 Teapplix,而追踪信息不会返回到您的购物车。

要传递到的 URL 是:

http://www.teapplix.com/h/[在此处输入您的 teapplix 帐户名称]/te/pin.cgi

传递内容如下所示:
(请勿仅单击链接或执行 HTTP GET 操作,如果传递内容中所
传递的签名与您在 Teapplix Setup => PayPal 页面中键入的签名不相符,将会出现 HTTP 404 错误)。

signature=[some secret you entered into your Teapplix Setup-> PayPal page]
pin_type=generic
order_number=1788
order_date=9/30/2005
order_time=20:08
ordered_by_email=mark@email.com
deliver_to_name=Mark Hood
deliver_to_company=Testing Software, Inc.
deliver_to_address=8970 Super DR SE
deliver_to_address2=
deliver_to_city=Port Orchard
deliver_to_state=WA
deliver_to_province=
deliver_to_zip=98367
deliver_to_country=[United States|Canada|国家的全名]
deliver_to_phone=253-555-1212
tax_amount=0.00 (订单收取的销售税)
shipping_amount=3.00 (配送费用,买家预付给卖家的配送费用)
grand_total=6.00 (订单总额)
shipping_method=[Standard, Expedited, SecondDay, One-Day, Economy] (订单的配送服务等级)
ship_method=(可选) (订单配送服务名称, 这个要用Teapplix所使用的订单配送方式名称)
ship_weight= (可选)(订单配送重量, 根据配送方式, 一般为盎司或克)
memo=[订单上的注解]
item_count=2
订单每行的参数:(根据有几行,最后的 _1 可改为 _2, _3, 等)
id_1= AAA (产品的SKU或品名)
describe_1= description (产品全称)
qty_1=2 (这个产品定了几个)
unit_price_1=10.5 (产品的单价)
option_name1_1=color (产品有没有选项, 如颜色 , 码号等,如有, 选项的名称)
option_selection1_1=red (选项的值,如 Red, Large, 等)
option_name2_1
option_selection2_1
id_2=...

签名

“签名”参数值可以通过下列方式获得:

1) 转到 Setup => PayPal 页面上您的 Teapplix 帐户,如果所有包含主电子邮件地址的行都不为空,则将主电子邮件地址用作“签名”值
2) 如果所有行都为空,请在第一行中输入随机加密字符串,然后单击“save primary email address”。然后将该字符串用作签名值。

以下是用 “curl” 写的一个范例:
curl -s -k -d signature='primary@email.com' -d pin_type='generic' -d param='value' http://www.teapplix.com/h//te/pin.cgi