DoDirectPayment
1. DoDirectPayment Request
1.1 DoDirectPayment 参数
METHOD(必须)
说明:API名称:DoDirectPayment。
PAYMENTACTION(必须)
说明:你想如何得到付款:
Authorization - 此付款是一个基本的授权项目,是用贝宝授权和捕获解决。
Sale - 这是一个你请求付款的最终销售。
字符长度:最多13个单字节字母。
IPADDRESS(必须)
付款者浏览器IP地址。
重要:贝宝记录此IP来防止一些欺骗。
字符长度:15个单字节字母数字,比如:255.255.255.255。
允许的值:任何正确的互联网协议地址。
AMT(必须)
订单总值,包括运费、手续费和税费。
限制:不得超过等值于1万美元的任何货币总值。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
CREDITCARDTYPE(必须)
信用卡类型。
字符长度和限制:最多十个单字节字母。
允许的值:
Visa
MasterCard
Discover
Amex
Switch
Solo
重要:如果信用卡类型是 Switch 或者 Solo,PAYMENTACTION 值必须获得授权,CURRENCYCODE 必须为 GBP。此外,不管是 STARTDATE 还是 ISSUENUMBER 都必须指定。
ACCT(必须)
信用卡卡号。
字符长度和限制:仅为数字,不能包含空格或标点。必须符合每种信用卡的模式和长度。
EXPDATE(必须)
信用卡到期时间,格式是 MMYYYY。
字符长度和限制:6个单字节数字,包括0。
FIRSTNAME(必须)
付款者的名。
字符长度和限制:25个单字节字母。
LASTNAME(必须)
付款者的姓。
字符长度和限制:25个单字节字母。
STREET
街道地址第一行。
字符长度和限制:100个单字节字母。
CITY
城市名。
字符长度和限制:40个单字节字母。
STATE
州或省名。
字符长度和限制:40个单字节字母。
COUNTRYCODE
国家代码。
字符长度和限制:2个单字节字母。
ZIP
邮编。
字符长度和限制:20个单字节字母。
NOTIFYURL
接受此交易IPN的网址。
注意:如果你不指定这个网址,将使用你资料中的地址(如果你写了的话)。
字符长度和限制:2048个单字节字母。
CURRENCYCODE
三字节的货币代码,比如USD。此参数只接受下面的值:
AUD – 澳元
CAD – 加元
EUR – 欧元
GBP – 英镑
JPY – 日元
USD – 美元
ITEMAMT
订单中所有的项目成本总和。
限制:这个值必须是一个数字而且不能超过1万美元(其他货币进行转换)。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
注意:ITEMAMT 是必须的,如果你指定了 L_AMTn。
SHIPPINGAMT
订单的运费总和。
限制:这个值必须为0或者以上,不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
注意:如果你指定了 SHIPPINGAMT 的值,你必须也指定 ITEMAMT 的值。
HANDLINGAMT
手续费的总和。
限制:这个值必须为0或者以上,不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
注意:如果你指定了 HANDLINGAMT 的值,你必须也指定 ITEMAMT 的值。
TAXAMT
税费的总和。
限制:这个值必须为0或者以上,不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
注意:如果你指定了 L_TAXAMTn,TAXAMT 是必须的。
DESC
项目的说明。
字符长度和限制:127个单字节字母。
CUSTOM
一个自由输入的自定义字段。
字符长度和限制:256个单字节字母。
INVNUM
你自己的订单号码。
字符长度和限制:127个单字节字母。
BUTTONSOURCE
一个为第三方程序设置的验证码。
字符长度和限制:32个单字节字母。
L_NAMEn
项目名称。
字符长度和限制:127个单字节字母。
这些参数必须从0开始,比如:for example L_NAME0、L_NAME1。
L_NUMBERn
项目数字。
字符长度和限制:127个单字节字母。
这些参数必须从0开始,比如:L_NUMBER0、L_NUMBER1。
L_QTYn
项目数量。
字符长度和限制:任何正整数。
这些参数必须从0开始,比如:L_QTY0、L_QTY1。
L_TAXAMTn
项目税。
限制:不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。这些参数必须从0开始,比如:L_TAXAMT0、L_TAXAMT1。
L_AMTn
项目成本。
限制:不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。这些参数必须从0开始,比如:L_AMT0、L_AMT1。
注意:如果你指定了 L_AMTn 的值,你必须指定 ITEMAMT 的值。
CVV2
信用卡验证值(第二版)
注意:你的商业账号需要确定这个值是否必须。
Visa、MasterCard 和 Discover 的字符长度:3位数。
American Express 的字符长度:4位。
重要:按照信用卡交易规则,一旦你完成了交易,将不能保留CVV2的值!
STARTDATE
Switch 或者 Solo 卡发行的年和月。格式是 MMYYYY。
字符长度和限制:6位单字节数字,包括0。
ISSUENUMBER
Switch 或 Solo 卡的问题数字。
字符长度:2位数字。
EMAIL
购买者的email地址。
字符长度和限制:127个单字节字母。
STREET2
街道地址第二行。
字符长度和限制:100位单字节数字。
PHONENUM
电话号码。
字符长度和限制:20位单字节数字
RETURNFMFDETAILS
标记是否要传回风险管理过滤器的结果。默认情况下,不需要接受这个信息。
0 - 不接受 FMF 信息(默认)。
li>1 - 接受 FMF 信息。
Ship to Address
重要:邮寄地址是可选的,如果你包含这个,某些字段是必须的。
2. DoDirectPayment Response 字段
AMT
这个值是在 DoDirectPaymentRequest 中指定的交易额。
AVSCODE
地址验证返回值。
字符限制:一个单字节字母数字。
CVV2MATCH
贝宝检查 CVV2 的结果。
TRANSACTIONID
唯一的交易 ID。
注意:如果返回的交易动作为 Authorization,TransactionID 是你在 Authorization 和 Capture APIs 中使用的 AuthorizationID。
字符长度和限制:19位单字节字符。
L_FMFfilterIDn
过滤 ID,包括过滤类型,无论接受或拒绝,输入的数字从0开始。
L_FMFfilterNAMEn
过滤名称,包括过滤类型,无论接受或拒绝,输入的数字从0开始。
来源:http://www.networkdictionary.cn/blog/fhileo/DoDirectPayment
Paypal 参考网站
https://developer.paypal.com/cgi-bin/devscr?cmd=_sandbox-acct-session
https://cms.paypal.com/us/cgi-bin/?&cmd=_render-content&content_ID=developer/e_howto_api_ECTesting
https://cms.paypal.com/us/cgi-bin/?&cmd=_render-content&content_ID=developer/home
http://www.iteye.com/topic/254565
http://download.pa.parallels.com/pbas/beta/3.3/doc/HSPC_PG/configuring_paypal_direct_payment_plugin.htm
http://www.zen-cart.cn/forum/topic4809.html
https://www.paypalobjects.com/en_US/ebook/PP_NVPAPI_DeveloperGuide/Appx-SDKRuby.html
https://www.paypal-biz.com/
http://paypal.ebay.cn/integrationcenter/list__resource_1.html
http://www.paypal-china.org/shiyong/158.html
https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_html_IPNandPDTVariables
http://www.codyfauser.com/2008/1/17/paypal-express-payments-with-activemerchant
http://www.paypalobjects.com/en_US/ebook/PP_NVPAPI_DeveloperGuide/directpayment.html
1. DoDirectPayment Request
1.1 DoDirectPayment 参数
METHOD(必须)
说明:API名称:DoDirectPayment。
PAYMENTACTION(必须)
说明:你想如何得到付款:
Authorization - 此付款是一个基本的授权项目,是用贝宝授权和捕获解决。
Sale - 这是一个你请求付款的最终销售。
字符长度:最多13个单字节字母。
IPADDRESS(必须)
付款者浏览器IP地址。
重要:贝宝记录此IP来防止一些欺骗。
字符长度:15个单字节字母数字,比如:255.255.255.255。
允许的值:任何正确的互联网协议地址。
AMT(必须)
订单总值,包括运费、手续费和税费。
限制:不得超过等值于1万美元的任何货币总值。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
CREDITCARDTYPE(必须)
信用卡类型。
字符长度和限制:最多十个单字节字母。
允许的值:
Visa
MasterCard
Discover
Amex
Switch
Solo
重要:如果信用卡类型是 Switch 或者 Solo,PAYMENTACTION 值必须获得授权,CURRENCYCODE 必须为 GBP。此外,不管是 STARTDATE 还是 ISSUENUMBER 都必须指定。
ACCT(必须)
信用卡卡号。
字符长度和限制:仅为数字,不能包含空格或标点。必须符合每种信用卡的模式和长度。
EXPDATE(必须)
信用卡到期时间,格式是 MMYYYY。
字符长度和限制:6个单字节数字,包括0。
FIRSTNAME(必须)
付款者的名。
字符长度和限制:25个单字节字母。
LASTNAME(必须)
付款者的姓。
字符长度和限制:25个单字节字母。
STREET
街道地址第一行。
字符长度和限制:100个单字节字母。
CITY
城市名。
字符长度和限制:40个单字节字母。
STATE
州或省名。
字符长度和限制:40个单字节字母。
COUNTRYCODE
国家代码。
字符长度和限制:2个单字节字母。
ZIP
邮编。
字符长度和限制:20个单字节字母。
NOTIFYURL
接受此交易IPN的网址。
注意:如果你不指定这个网址,将使用你资料中的地址(如果你写了的话)。
字符长度和限制:2048个单字节字母。
CURRENCYCODE
三字节的货币代码,比如USD。此参数只接受下面的值:
AUD – 澳元
CAD – 加元
EUR – 欧元
GBP – 英镑
JPY – 日元
USD – 美元
ITEMAMT
订单中所有的项目成本总和。
限制:这个值必须是一个数字而且不能超过1万美元(其他货币进行转换)。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
注意:ITEMAMT 是必须的,如果你指定了 L_AMTn。
SHIPPINGAMT
订单的运费总和。
限制:这个值必须为0或者以上,不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
注意:如果你指定了 SHIPPINGAMT 的值,你必须也指定 ITEMAMT 的值。
HANDLINGAMT
手续费的总和。
限制:这个值必须为0或者以上,不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
注意:如果你指定了 HANDLINGAMT 的值,你必须也指定 ITEMAMT 的值。
TAXAMT
税费的总和。
限制:这个值必须为0或者以上,不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。
注意:如果你指定了 L_TAXAMTn,TAXAMT 是必须的。
DESC
项目的说明。
字符长度和限制:127个单字节字母。
CUSTOM
一个自由输入的自定义字段。
字符长度和限制:256个单字节字母。
INVNUM
你自己的订单号码。
字符长度和限制:127个单字节字母。
BUTTONSOURCE
一个为第三方程序设置的验证码。
字符长度和限制:32个单字节字母。
L_NAMEn
项目名称。
字符长度和限制:127个单字节字母。
这些参数必须从0开始,比如:for example L_NAME0、L_NAME1。
L_NUMBERn
项目数字。
字符长度和限制:127个单字节字母。
这些参数必须从0开始,比如:L_NUMBER0、L_NUMBER1。
L_QTYn
项目数量。
字符长度和限制:任何正整数。
这些参数必须从0开始,比如:L_QTY0、L_QTY1。
L_TAXAMTn
项目税。
限制:不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。这些参数必须从0开始,比如:L_TAXAMT0、L_TAXAMT1。
L_AMTn
项目成本。
限制:不能超过1万美元。不用写货币符号,但必须包含小数点后两位,小数点使用点“.”来标记,可以使用逗号“,”作为千位分隔符。这些参数必须从0开始,比如:L_AMT0、L_AMT1。
注意:如果你指定了 L_AMTn 的值,你必须指定 ITEMAMT 的值。
CVV2
信用卡验证值(第二版)
注意:你的商业账号需要确定这个值是否必须。
Visa、MasterCard 和 Discover 的字符长度:3位数。
American Express 的字符长度:4位。
重要:按照信用卡交易规则,一旦你完成了交易,将不能保留CVV2的值!
STARTDATE
Switch 或者 Solo 卡发行的年和月。格式是 MMYYYY。
字符长度和限制:6位单字节数字,包括0。
ISSUENUMBER
Switch 或 Solo 卡的问题数字。
字符长度:2位数字。
购买者的email地址。
字符长度和限制:127个单字节字母。
STREET2
街道地址第二行。
字符长度和限制:100位单字节数字。
PHONENUM
电话号码。
字符长度和限制:20位单字节数字
RETURNFMFDETAILS
标记是否要传回风险管理过滤器的结果。默认情况下,不需要接受这个信息。
0 - 不接受 FMF 信息(默认)。
li>1 - 接受 FMF 信息。
Ship to Address
重要:邮寄地址是可选的,如果你包含这个,某些字段是必须的。
2. DoDirectPayment Response 字段
AMT
这个值是在 DoDirectPaymentRequest 中指定的交易额。
AVSCODE
地址验证返回值。
字符限制:一个单字节字母数字。
CVV2MATCH
贝宝检查 CVV2 的结果。
TRANSACTIONID
唯一的交易 ID。
注意:如果返回的交易动作为 Authorization,TransactionID 是你在 Authorization 和 Capture APIs 中使用的 AuthorizationID。
字符长度和限制:19位单字节字符。
L_FMFfilterIDn
过滤 ID,包括过滤类型,无论接受或拒绝,输入的数字从0开始。
L_FMFfilterNAMEn
过滤名称,包括过滤类型,无论接受或拒绝,输入的数字从0开始。
来源:http://www.networkdictionary.cn/blog/fhileo/DoDirectPayment
Paypal 参考网站
https://developer.paypal.com/cgi-bin/devscr?cmd=_sandbox-acct-session
https://cms.paypal.com/us/cgi-bin/?&cmd=_render-content&content_ID=developer/e_howto_api_ECTesting
https://cms.paypal.com/us/cgi-bin/?&cmd=_render-content&content_ID=developer/home
http://www.iteye.com/topic/254565
http://download.pa.parallels.com/pbas/beta/3.3/doc/HSPC_PG/configuring_paypal_direct_payment_plugin.htm
http://www.zen-cart.cn/forum/topic4809.html
https://www.paypalobjects.com/en_US/ebook/PP_NVPAPI_DeveloperGuide/Appx-SDKRuby.html
https://www.paypal-biz.com/
http://paypal.ebay.cn/integrationcenter/list__resource_1.html
http://www.paypal-china.org/shiyong/158.html
https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_html_IPNandPDTVariables
http://www.codyfauser.com/2008/1/17/paypal-express-payments-with-activemerchant
http://www.paypalobjects.com/en_US/ebook/PP_NVPAPI_DeveloperGuide/directpayment.html