DoDirectPayment

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