paydollar paygate administrator user guide · 2020. 7. 13. · paydollar paygate integration guide...

PayDollar PayGate

集成指南 v3.60

(留白)

PayDollar PayGate Integration Guide (v3.60) Page 1

版权信息

联款通(香港)有限公司

香港北角渣华道 191 号

嘉华国际中心 17 楼 1701-02 室

电话: (852) 2538 8278

传真: (852) 2545 3898

网址: http://www.asiapay.com

本文档及本文件所述软件的版权 2012 均为联款通(香港)有限公司所有。版权所有。仅可根据软件提供的

许可协议来使用本文档所述的软件。除根据软件提供的许可协议使用本文档中所述的软件目的外，不得

全部或部分复制本文档。本文档资料如有更改，恕不另行通知。如无特别说明，本文档示例中使用的公

司、名称、数据均为虚构。

所有商标归其各自所有者所有。本文档制定和产生于香港特别行政区。

http://www.asiapay.com/


保密和使用

此文档（以及附件）中的内容是联款通（香港）有限公司提供的保密信息。此文档仅供联款通（香港）

有限公司同意的商家使用。严禁其他地方复制、分发或传播此文件。


版本历史

Revision Date Revision Description

0.0 July 11,2001 First Draft issue

1.0 Apr 28, 2003 First issue (All in One Copy)

1.1 Oct 7, 2003 Add VBV Parameters for Server Side Integration

1.2 Nov 1, 2003 Modify VBV Parameters for Server Side Integration

1.3 Nov 6, 2003 Deleted Data Feed Retry Message

1.4 Nov 13, 2003 Add AuthId to Data Feed Output

1.5 Feb 20, 2004 Add JCB Card Type and Japanese Lang Parameter

1.6 Mar 9, 2004 All-in-One Version

1.7 May 6, 2004 Add JPY and TWD Currency Code

1.8 May 13, 2004 Add data feed flow comment

1.9 Aug. 20, 2004 Add AMEX and Security Code parameter

2.0 Sept 14, 2004 Add Payment Flow, 3D Transaction, PayPal Transaction and New Currencies

2.1 Oct 8, 2004 Modify the pop-up flow to be inline flow of 3D Transaction

2.2 Dec 6, 2004 Add errorUrl parameter to Direct Client Side Connection

2.3 Sep 15, 2005 Add ECI and Payer Authentication Status to datafeed section

2.5 Jan 25, 2006 Add data feed port requirement

2.6 Mar 30, 2006 Add new parameters to datafeed :

- sourceIp

- ipCountry

2.7 Jun 15, 2006 Add sample data feed page in ASP.

2.8 Jun 20, 2006 Modified Payment Method to support CUP.

2.9 Nov 27, 2006 Add Transaction Handling and FAQ Section

3.0 Aug 30, 2007 Add Alipay payment method

3.1 Jan 24, 2008 Language update – Supporting Thai

3.11 June, 25, 2008 Revise and updated content

3.2 Mar 25, 2009 Add China UnionPay (CHINAPAY) payment method

3.2.1 Apr 29, 2009 Add new parameter “payMethod” to Data Feed Output

3.2.2 May 14, 2009 Add APPENDIX

3.3 Nov 5, 2009 Add Tenpay and 99bill payment method

3.4 Dec 18, 2009 Add new optional parameter for connect to payment page.

Origin Country and Destination Country

3.5 Jun 1, 2010 Add new parameter “cardIssuingCountry” to Data Feed Output

3.5.5 Jun 25, 2010 Add new parameter “channelType” to Data Feed Output

3.6 Jun 29,2010 Add new function “Multi-Currency Processing” and merge “Server Side Direct Connection” Spec into one spec. Move “Data Feed Handling” into a new section. Add mps fields in datafeed and merchant api.


3.7 Jul 27, 2010 Add Secure Hash Function.

Add new optional parameter “amount” for Merchant API RequestRefund action

3.8 Dec 6,2010 Merchant can set Return Value Link (Data Feed) at merchant admin

Language update – Supporting French, German, Russian and Spanish

3.9 Feb 16, 2011 Add new optional parameters on Client Post Through Browser for disable the print and retry function at payment result page.

3.10 Apr 1, 2011 Update the description of the parameter “payType” for integration.

Add new parameters “mSchPayId”, “dSchPayId” to Data Feed Output.

3.11 Apr 20, 2011 Add MOP, PHP, THB, MYR, IDR and KRW Currency Code

3.12 Jun 1, 2011 Update the list of response code from PayDollar

3.13 Jul 12, 2011 Add SAR, NZD, AED, BND Currency Code

Add MEPS payment method

Add MemberPay Service integration parameters

3.14 Nov 2, 2011 Update Browser version compatibility

Update IP Ranges

Add “AMEX SafeKey”

Update the wording of “3D-Secure” to “3-D Secure”

Add datafeed return parameters (AlertCode and MerchantId)

3.15 Jan 30,2012 Update Debit payment for Thailand

Add SCB , BAY, UOB, TMB , UOB , KTB , IBANKING, Bill Payment

3.16 Jun 6, 2012 Add Installment service

3.17 Jun 27, 2012 Update testing environment IP Ranges

3.18 Aug 3, 2012 Add Airline data support

- Air Ticket Number

3.19 Oct 5, 2012 Add new optional parameters panFirst4, panLast4, accountHash and

accountHashAlgo to Data Feed Out and Merchant API Query

Add new payment method “UPOP”

3.20 Jan 8, 2013 Add customer billing information

3.21 Jan 28, 2013 Add payment gateway transaction time into datafeed and query function

3.22 Jun 13, 2013 Add VND Currency Code

3.23 Jun 21,2013 Add 99BILL, ALIPAY, CHINAPAY, PAYPAL, PPS, TENPAY, MEPS,

OCTOPUS, ENETS, MYCLEAR, POLI, UPOP, UPOP-GNETE, UPOP-DNA,

FUIOU, SCB, KRUNGSRIONLINE, KTB, UOB, TMB, IBANKING, BPM,

GCash, BancNet, SMARTMONEY into direct client side connection method

3.24 Aug 22, 2013 Add M2U and CIMBCLICK

3.25 Nov 11, 2013 Add new optional parameter “panFull” to Data Feed output and Merchant API

Query.

3.26 Nov 22, 2013 Add new currency INR

3.27 Feb 18, 2014 Add new language Vietnamese


3.28 Mar 19, 2014 Add OCTOPUS

3.29 May 29, 2014 Add “mpLatestStaticToken” and “mpMemberId” in DataFeed

3.30 Jun 06, 2014 Add “timeoutValue” to control Octopus timeout value

3.31 Jul 03, 2014 Add “hiddenAmount” and “expDateCheck”, for Client Post Through Browser

3.32 Oct 06, 2014 - Add Ewallet Integration Parameters in Direct Client Side Connection and Server Side Direct Connection

- Add Ewallet information in Data Feed Response

3.33 Oct 31, 2014 Add WeChat payment method

3.34 Nov 3, 2014 Add Multi Currency Pricing and Integration Parameters for card data

encryption

3.35 Nov 25, 2014 Update description of optional parameter “foreignAmount” on MCP Function

3.36 Dec 2, 2014 Add “promotionCode”, “promotionRuleCode”, “promotionOriginalAmt” on

Query API

3.37 Dec 12, 2014 Add ONEPAY (ATM Card) Payment Method

3.38 Mar 19, 2015 Change the type of “Ord”

3.39 Jun 11, 2015 Add new parameters “rewardsRedeemTotalAmt”, “rewardsRedeemType”, “rewardsRedeemProgram”, “rewardsRedeemCode1”, “rewardsRedeemLabel1”, “rewardsRedeemAmt1”, “rewardsBalance1”, “rewardsRedeemCode2”, “rewardsRedeemLabel2”, “rewardsRedeemAmt2”, “rewardsBalance2”, “rewardsRedeemCode3”, “rewardsRedeemLabel3”, “rewardsRedeemAmt3”, “rewardsBalance3” to Data Feed Output and Query API Output

3.40 Aug 19, 2015 Add new parameters “netAmtAfterRewards” to Data Feed Output and Query API Output Add new parameters “netAmtAfterRewards “, “rewardsRedeemTotalAmt”, “rewardsRedeemType”, “rewardsRedeemProgram”, “rewardsRedeemCode1”, “rewardsRedeemLabel1”, “rewardsRedeemAmt1”, “rewardsBalance1”, “rewardsRedeemCode2”, “rewardsRedeemLabel2”, “rewardsRedeemAmt2”, “rewardsBalance2”, “rewardsRedeemCode3”, “rewardsRedeemLabel3”, “rewardsRedeemAmt3”, “rewardsBalance3” to Capture API Output

3.41 Sep 14, 2015 Add VISA Checkout and MasterPass Payment Method

3.42 Sep 16,2015 Add installOnly

3.43 Sep 23,2015 Revise output of “Settlement Report Request”

Update description of Datafeed for VISA Checkout

3.44 Nov 12, 2015 Add VISA Checkout and MasterPass Payment Method

3.45 Dec 16,2015 Change the length of “ atched”

3.46 Jan 22, 2016 Add API function – Query payment request log

3.47 Jan 26, 2016 Add new parameter “payMode” for control which payment mode use of

transaction

3.48 Jan 28, 2016 Updates on API function – Query payment request log

Update compatible version of browsers

3.49 Apr 6, 2016 Updates Datafeed

Updates API return value

3.50 Apr 28,2016 Updates API return value


3.51 May 23,2016 Add WELEND, update settlement report request

3.52 Sep 12, 2016 Change IP Address of UAT server

3.53 Feb 7, 2017 Add new integration parameter “orderPhoneNo”

3.54 Mar 14, 2017 Add installment provider datafeed output

Add VA payment flow

Add Credit Card with Installment flow

3.55 May 12, 2017 Add new API function “Cancel Payment” (Only for payment bank FASPAY)

3.56 Aug 28, 2017 Update example of source codes

3.57 Jun 18, 2019 Add MoMo Payment

3.58 July 15, 2019 Add Samsung Pay Payment

3.59 Sep 05, 2019 Add 3DS 2.0 related parts.

Update the list of “Response Code From PayDollar”

Add PaySDK iOS

Add PaySDK Android

3.60 Oct 17, 2019 Flow chart Update.

Update length for field named “threeDSVersion”


目录

1 概述 ................................................................................................................................................................... 10

介绍 .................................................................................................................................................................. 10

2 连接方法 ............................................................................................................................................................ 11

2.1 客户端通过浏览器提交 POST (CLIENT POST THROUGH BROWSER) ....................................................................... 11

范围和兼容性 ............................................................................................................................................................................................. 11

信用卡支付流程 ......................................................................................................................................................................................... 12

信用卡分期付款流程 ............................................................................................................................................................................... 12

99BILL, ALIPAY, CHINAPAY, PAYPAL, PPS, TENPAY, SCB, BAY, KTB, UOB, TMB, BBL iBanking, UPOP, M2U,

CIMBCLICK, OCTOPUS, WECHAT, ONEPAY 支付流程 ................................................................................................................ 14

账单支付流程 (BPM) ............................................................................................................................................................................... 14

Permata, BII 和 BCA 虚拟账户(VA)支付流程 ................................................................................................................................... 16

集成页中参数的定义 ............................................................................................................................................................................... 17

支持 3DS 2.0 的参数 ................................................................................................................................................................................ 21

客户端 Post 方法示例 (源代码) ........................................................................................................................................................... 27

启用 ................................................................................................................................................................................................................ 28

2.2 客户端直接连接（DIRECT CLIENT SIDE CONNECTION） ................................................................................. 29

VISA, Master, Diners, JCB, AMEX 信用卡与借记卡支付流程 .................................................................................................... 30

其他支付流程 ............................................................................................................................................................................................. 30

非 3D 认证交易 .......................................................................................................................................................................................... 32

3D 认证交易 ................................................................................................................................................................................................ 32

集成步骤 ....................................................................................................................................................................................................... 34

集成页中参数的定义 ............................................................................................................................................................................... 34

支持 3DS 2.0 的参数 ................................................................................................................................................................................ 37

连接我们网关的示例 (客户端直接连接).......................................................................................................................................... 45

启用 ................................................................................................................................................................................................................ 45

2.3 服务器端直接连接（SERVER SIDE DIRECT CONNECTION） ............................................................................ 46

集成页中参数的定义 ............................................................................................................................................................................... 47

支持 3DS 2.0 的参数 ................................................................................................................................................................................ 52

源代码示例 .................................................................................................................................................................................................. 54

启用 ................................................................................................................................................................................................................ 55

3 返回链接处理 ..................................................................................................................................................... 56

返回链接输出中的参数定义 ............................................................................................................................... 56

返回链接设置 .................................................................................................................................................... 62

返回链接页面示例 ............................................................................................................................................. 62


4 哈希码安全交易 ................................................................................................................................................. 64

简介 .................................................................................................................................................................. 64

哈希码安全验证流程 ......................................................................................................................................... 64

PAYDOLLAR 提供的客户端库文件 ........................................................................................................................ 65

手动生成和验证哈希码 ...................................................................................................................................... 66

开通商户账号的哈希码安全验证 ........................................................................................................................ 67

5 多币种处理服务 ................................................................................................................................................. 68

简介 .................................................................................................................................................................. 68

简单货币转换(SCP) ............................................................................................................................................ 69

简单货币转换 (SCP) 样板交易示例 .................................................................................................................... 70

多货币计价 (MCP) ............................................................................................................................................. 72

多货币计价（MCP）样板交易示例 .................................................................................................................... 74

动态货币转换（DCC） ...................................................................................................................................... 75

动态货币转换（DCC）样板交易示例 ................................................................................................................. 76

6 商家 API 功能 ..................................................................................................................................................... 77

API 功能简介 ..................................................................................................................................................... 77

预授权支付 ........................................................................................................................................................ 78

撤销已经接受的支付 ......................................................................................................................................... 80

对已经接受的支付请求退款 ............................................................................................................................... 81

查询付款状态 .................................................................................................................................................... 82

查询请求日志 .................................................................................................................................................... 91

取消支付 ........................................................................................................................................................... 94

结算报告请求 .................................................................................................................................................... 96

服务器端 JAVA 编写的 HTML 示例源代码 .......................................................................................................... 98

7 异常交易处理 ................................................................................................................................................... 100

A) 返回链接失败 ............................................................................................................................................. 100

B) 跳转至 SUCCESSURL / FAILURL / CANCELURL 失败 ............................................................................................... 100

C) 客户进行的不完整 3D 认证交易 .................................................................................................................. 100

D) 客户进行的不完整的 99BILL / ALIPAY / CHINAPAY / PPS / TENPAY / SCB / BAY / KTB / UOB / TMB / BBL IBANKING /

UPOP / M2U / CIMBCLICK / WECHAT 交易 ....................................................................................................... 100

8 PAYSDK IOS 移动端 SDK .................................................................................................................................. 102

A) SDK 集成步骤： .......................................................................................................................................... 102

B) WEBVIEW 支付调用 ....................................................................................................................................... 105

C) 直接支付调用 ............................................................................................................................................. 106

D) 分期支付调用 ............................................................................................................................................. 107


E) 计划支付调用 .............................................................................................................................................. 107

F) 会员支付调用 .............................................................................................................................................. 108

G) 促销支付 .................................................................................................................................................... 109

H) ALIPAY 全球支付调用 .................................................................................................................................... 109

I) ALIPAY 香港支付调用 ...................................................................................................................................... 110

J) ALIPAY 中国支付调用 ..................................................................................................................................... 112

K) 3DS 2.0 支付调用 ......................................................................................................................................... 114

9 PAYSDK ANDROID 移动端 SDK ...................................................................................................................... 121

A) SDK 集成步骤： .......................................................................................................................................... 121

B) WEBVIEW 支付调用 ....................................................................................................................................... 123

C) 直接支付调用 ............................................................................................................................................. 124

D) 分期支付调用 ............................................................................................................................................. 126

E) 计划支付 ..................................................................................................................................................... 126

F) 会员支付 ..................................................................................................................................................... 126

G) 促销支付 .................................................................................................................................................... 127

H) ALIPAY 全球支付调用 .................................................................................................................................... 127

I) ALIPAY 香港支付调用 ...................................................................................................................................... 128

J) ALIPAY 中国支付调用 ..................................................................................................................................... 129

K) 3DS 2.0 支付调用 ......................................................................................................................................... 130

10 疑难排解 ........................................................................................................................................................ 137

系统安装 ......................................................................................................................................................... 137

常见问题 ......................................................................................................................................................... 137

返回链接 ......................................................................................................................................................... 137

3D 安全认证 ................................................................................................................................................... 138

数据安全 ......................................................................................................................................................... 139

技术支持 ......................................................................................................................................................... 139

附录 A ................................................................................................................................................................. 140

传款易付款响应代码 ...................................................................................................................................... 140

1. 主要响应代码 (PRC) ....................................................................................................................................................................... 140

2. 次要响应代码 (SRC)........................................................................................................................................................................ 141

响应代码列表 .................................................................................................................................................. 141

银行的响应代码 ...................................................................................................................................................................................... 141

传款易响应代码 ...................................................................................................................................................................................... 142

其它响应代码 .......................................................................................................................................................................................... 144

国家编码列表 .................................................................................................................................................. 144


1 概述

介绍

PayDollar PayGate 是一个功能强大的基于网页的在线支付服务平台，提供安全、多渠道、多语言、多

货币的支付服务。许多著名的公司和组织在使用它。

本技术规范文件描述了电子商务网站与 PayDollar 电子商务服务以及在线支付服务（联款通（香港）有

限公司提供，各商家订购使用）进行集成的各组成规范部分。创建本文档的目的是确保所有的技术规范

都包含足够的技术信息，供商家设计并修改现有在线购物架构或软件的代码，以保证支付服务的成功使

用。它也提供了一份清单供规范的的审查着对集成功能进行测试。

每种连接方法下都有一个额外的参数部分。该部分专为 3DS 2.0（Three Domain Secure 2.0）而设计。 3DS

身份验证是无卡交易的附加安全层。3DS 2.0 旨在获得更好，更强大的欺诈检测。

PayDollar PayGate 使商家连接我们的网站更方便，更灵活。商家可以选择以下集成方法之一，将在文

档中进行详细说明。

- 客户端通过浏览器 Post （如购物车）（Client Post Through Browser）

- 客户端直接连接（Direct Client Side Connection）

- 服务器直接连接（如 IVR 系统, 手机 APP）（Server Side Direct Connection）

此外，后面将详细说明更多商家 API 功能。


2 连接方法

2.1 客户端通过浏览器提交 POST (Client Post Through Browser)

这是各商家最常用的方法。这种连接方法的优点是简便快速。另一方面，可使用支付交易流。仅通过小

型集成，商家就能运行一个实时网站。

范围和兼容性

此连接针对的是配有在线购物车系统的商家。此程序基于 HTML 格式，由 Javascript 语言编写，并广泛

适用于此档中没有说明的技术规范和种类的在线购物车软件和架构。购物车软件的整合方法，不包含在

此文档中。

软件代码的兼容版本如下：

软件代码版本

HTML 4.0

Javascript 1.3

常用浏览器与软件代码的版本兼容性如下：

浏览器版本

Microsoft Internet Explorer 11或更高版本

Mozilla Firefox 27或更高版本

Google Chrome 30或更高版本

Safari 7或更高版本


信用卡支付流程

PayDollar 的支付连接页面

PayDollar 的支付输入表

（信用卡信息)

JavaScript 支付确认

Confirmation (for customer to confirm)

连接至银行

PayDollar 的支付失败页面 PayDollar 的支付成功页面

提交/取消?

确认/取消?

支付是否成功?

打印/继续?

3D 卡是否登记?

?

3D 认证过程

认证是否成功?

返回链接 (可选)

任选-如果您需要实时采取行动

real time

商家购物车

(e.g. shopCart.jsp)

商家的交易取消页面

商家接收返回链接的页面

(不同于 successUrl, failUrl &

cancelUrl)

商家的交易失败页面商家的交易成功页面

目录服务器

(VISA/ MasterCard/

JCB)

发卡行

重试/关闭? 收据

成功

提交

取消

确认

否

是

成功失败

失败

关闭

重试

继续

打印

取消

继续

商家的页面

PayDollar 的页面

协力厂商

判定框

报表

MPS 处理 (可选)

汇率提供商


信用卡分期付款流程


JavaScript 支付确认

Confirmation (for customer to confirm)

连接银行

PayDollar 的支付失败页面

PayDollar 的支付成功页面

提交/取消?

确认/取消?

支付是否成功?

打印/继续?

3D 卡是否登记? 3D 认证过程

认证是否成功

Success?



real time

商家购物车

(e.g. shopCart.jsp)



(不同于 successUrl, failUrl &

cancelUrl)

商家的交易失败页面

商家的交易成功页面

目录服务器

(VISA/ MasterCard/

JCB)

发卡行

重试/关闭?

收据

成功

提交

取消 Cancel

确认

否

是

成功

失败

失败

关闭

重试

继续

打印

取消

继续

商家页面

PayDollar 页面

协力厂商

判定框

报表

MPS 流程(可选)

汇率提供商

PayDollar 的支付输入表

（信用卡信息)

PayDollar 分期付款页面

确认

取消


99BILL, ALIPAY, CHINAPAY, PAYPAL, PPS, TENPAY, SCB, BAY, KTB, UOB, TMB, BBL iBanking,

UPOP, M2U, CIMBCLICK, OCTOPUS, WECHAT, ONEPAY 支付流程





(不同于 successUrl, failUrl & cancelUrl)

商家页面

PayDollar 页面

协力厂商

判定框

报表


PayDollar 的支付确认

(for customer to confirm)

PayDollar 的支付失败页面 PayDollar 的支付成功页面

Payment Success

ul Page

确认/ 取消?

an (VISA/

Mas

rCard/ JCB)

celt?

支付是否成功?

打印/继续?

商家购物车

(e.g. shopCart.jsp)

商家的交易失败页面商家交易成功页面

转到

PPS 或 PAYPAL 或 CHINAPAY 或 ALIPAY 或

TENPAY 或 99BILL 或 UPOP 或 OCTOPUS

关闭? 收据

取消

Confirm

成功失败

关闭继续

打印

PPS / PAYPAL / CHINAPAY/ALIPAY/TENPAY/99BILL/UPOP/M2U/CIMBCLICK

PayDollar 接收支付结果

MPS 处理 (可选)

汇率提供商


账单支付流程 (BPM)

商家交易取消页面





商家页面

SiamPay 页面

判定框

报表

SiamPay 的支付连接页面

SiamPay 的支付确认

(for customer to confirm)

确认/取消 ?

an (VISA/

Mas

rCard/ JCB)

celt?

打印/关闭?

商家购物车

(e.g. shopCart.jsp)

商家交易成功页面

生成 Siampa 付款单(Payin)

关闭

打印付款单

通过 Counter/ATM/Phone 支付

取消

确认

打印

BPM


Permata, BII 和 BCA 虚拟账户(VA)支付流程

Step 1: 客户在线生成虚拟账户

Step 2: 客户在有效期之前离线支付至虚拟账户

值得注意的是支付程序的软件代码（见示例）应嵌入集成页面（如上，可根据使用者以前的购物交易生

成购买总金额）。系统将支付流的后续各部分导引至系统架构，在架构中使用者提交详细的支付内容，并

且系统对支付内容进行处理以供结算和清算。

返回链接 (可选) – “Pending_feedback”

任选 – 如果您需要实时采取措施



商家页面

PayDollar 页面

协力厂商

判定框

报表 PayDollar 的付款选择页面

PayDollar 待付款页面

商家购物车

(e.g. shopCart.jsp)

商家交易待处理页面

转到

FasPay 和 Bank

生成并显 VA号码

是否关闭?

关闭

选择 VA

PayDollar 收到付款结果

（后端通知）

返回链接 (可选) – “Accepted”

任选 – 如果您需要实时采取措施



FasPay

PayDollar 收到支付结果

(后端通知)

客户点击返回商家按钮


集成页中参数的定义

以下是供集成用的参数。PayDollar PayGate 区分大小写。要确保字体正确。结束交易时，系统将向客户

返回一条支付信息。商家可创建静态 HTML 页面来显示信息。如果商家网站支持返回链接，系统可返回

下表所示的支付信息。

参数数据类型描述

连接到支付页面所需的参数( 使用 UTF-8 编码 )

orderRef Text (35) 商家的订单参考号

currCode Text (3) 支付货币种类：

“344” – HKD “840” – USD “702” – SGD

“156” – CNY (RMB) “392” – JPY “901” – TWD

“036” – AUD “978” – EUR “826” – GBP

“124” – CAD “446” – MOP “608” – PHP

“764” – THB “458” – MYR “360” – IDR

“410” – KRW “682” – SAR “554” – NZD

“784” – AED “096” – BND “704” – VND

“356” – INR

备注：

mpsMode = SCP, currCode 值应为外币

mpsMode = MCP, currCode 值应为基础货币

amount Number (12,2) 要向客户收取所提供货币的总金额

备注：

mpsMode = SCP, 金额应以外币计算。

mpsMode = MCP, 金额应以基本货币计算。

lang Text (1) 支付页面的语言

“E” – 英语 “C” – 繁体中文

“X” – 简体中文 “J” – 日语

“T” – 泰国语 “F” – 法语

“G” – 德语 “R” – 俄语

“S” – 西班牙语 “V” – 越南语

cancelUrl Text (300) 您希望我们在您的客户取消交易时去往的网页地址

(仅用于显示目的，请勿使用此 URL 更新系统。请使用

DataFeed。)

failUrl Text (300) 您希望我们在交易被拒绝后去往的网页地址


DataFeed。)

successUrl Text (300) 您希望我们在交易被接受后去往的网页地址



DataFeed。)

merchantId Number 我们向您提供的商家代号

payType Text(1)

(“N”, ”H”)

支付类型:

”N” –消费交易

”H” –预授权交易

使用预授权交易的商户，对于有效的交易请注意执行“预授权”

操作.一旦预授权,客户的信用卡中的金额将会在下次银行结算

中扣除.如果商户不执行预授权/授权冲正操作，则超过 14 日

的授权交易，将由发卡银行将释放持卡人的信用额度。

商户执行预授权/授权冲正操作，可以在

商户管理后台 > 运作 > 交易明细

备注：使用 99BILL, ALIPAY, CHIANPAY, PAYPAL, PPS, TENPAY,

WECHAT, MEPS,OCTOPUS 不能进行预授权支付

payMethod Text

支付方式：

“ALL” – 所有有效支付方式

“CC” – 信用卡支付

“VISA” – Visa 卡支付

“Master” – Master 卡支付

“JCB” – JCB 支付

“AMEX” – AMEX 支付

“Diners” – Diners Club 支付

“PPS” – PPS 通过 PayDollar 支付

“PAYPAL” – PayPal 通过 PayDollar 支付

“CHINAPAY” – China UnionPay 通过 PayDollar 支付

“ALIPAY” – ALIPAY 通过 PayDollar 支付

“TENPAY” – TENPAY 通过 PayDollar 支付

“99BILL” – 99BILL 通过 PayDollar 支付

“MEPS” – MEPS 通过 PayDollar 支付

“SCB” – SCB (SCB Easy) 通过 PayDollar 支付

“BPM” – Bill Payment 通过 PayDollar 支付

“KTB” – Krung thai 银行 (KTB 在线) 通过 PayDollar 支付

“UOB” – United Oversea 银行通过 PayDollar 支付

“KRUNGSRIONLINE” –Ayudhya 银行(KRUNGSRIONLINE)通过

PayDollar 支付


“TMB” –TMB Bank 通过 PayDollar 支付

“IBANKING” – Bangkok iBanking 银行通过 PayDollar 支付

“UPOP” – UPOP 通过 PayDollar 支付

“M2U” – M2U 通过 PayDollar Payment

“CIMBCLICK” – CIMBCLICK 通过 PayDollar 支付

“OCTOPUS” – OCTOPUS 通过 PayDollar 支付

“WECHAT” – WECHAT 通过 PayDollar 支付

“ONEPAY” – ONEPAY 通过 PayDollar 支付

“VCO” – VISA Checkout 支付

“MP” – MasterPass 支付

“WELEND” – WELEND 通过 PayDollar 支付

“MOMOPAY” – MoMo eWallet 支付

“SAMSUNG” – Samsung Pay 支付

分期付款的可选参数

installment_service Text (1)

(“T”,”F”)

分期付款服务指标

installment_period Text (20) 分期期数

*不提供将在付款期间启用分期付款选择

*以分隔符“|”表示的多个周期，仅用于支付方式“WELEND”

installOnly Text (1)

(“T”,”F”)

控制分期付款的强制性

航空公司数据的可选参数

airline_service Text (1)

(“T”,”F”)

分期付款服务指标

airline_ticketNumber Text (13) 机票号码

多币种计价的可选参数(MCP)

mpsMode Text(3) 多币种处理服务（MPS）模式：

“NIL”或不提供 – 禁用 MPS（商家不使用 MPS）

“SCP” – 启用 MPS ‘简单货币转换’

“DCC” – 启用 DCC ‘动态货币转换’

“MCP” – 启用 MCP ‘多货币计价’

适用于应用 MPS 功能的商家

multiRateID Text (12) 汇率 ID

*从 API 函数“MCPMultiRateEnquiry”返回

mpsExRate Number (10,4) 商家的基本货币与外币之间的汇率



foreignCurrCode Text (3) 外币代码

foreignAmount Number (12,2) 计算外币金额

*外币金额应由最低金额 HKD10 / MOP10 的基础金额转换，以

避免公差检查失败。

促销的可选参数

promotion Text(1);

(“T” or “F”)

启用/禁用促销

promotionCode Text(8); 促销活动代码

promotionRuleCode Text(8); 促销规则代码

promotionOriginalAmt Number (12,2) 促销原始金额

连接到支付页面的可选参数

remark Text (200) 备注域，用来存储商家没有显示在交易网页上的附加数据

redirect Number 自动跳转到商家网站的秒数，在 PayDollar 的“付款成功/失败”

页面上进行

oriCountry Number(3) 源国家编码

例如：

344– “HK”

840 – “US”

destCountry Number(3) 目的国家编码：

例如：

344 – “HK”

840 – “US”

secureHash Text (40) secureHash 用于验证商户的身份以及交易信息的完整性。

secureHash 是通过将交易参数以及 secureHashSecret 组合起来

进行散列运算获得的。

*只提供给注册了该功能的商户使用。详见章节 4。

print Text(2) ; (“no”) 在支付结果页面,关闭打印功能

failRetry Text(2) ; (“no”) 当交易被拒绝,关闭重试功能

timeoutValue Number 超时值，以秒为单位，仅适用于 OCTOPUS 付款，范围为 180

到 7200。

hiddenAmount Text (1)

(“T”,”F”)

用于控制金额是否显示。 “ T”表示显示金额，“ F”表示不显示

金额。 *仅适用于批准的商家

expDateCheck Number 用于控制到期日期检查的值。例如。如果提交“ 1”，则该卡

的有效期不得在一个月内到期。仅允许整数，最小值为“ 1”，

最大值为“ 192”。 *仅适用于批准的商家。

payMode Text(2) 付款模式


“EC” – 电商（Electronic Commerce）（默认)

“MO” – 邮购（Mail Order）

“RC” – 定期（Recurring）

orderPhoneNo Text(30) 订单电话

支持 3DS 2.0 的参数

以下是专门用于 3DS 2.0 的参数。商家应满足开始使用 3DS 2.0 的参数要求。参数区分大小写，并且应

采用 UTF-8 编码。

参数数据类型强制性描述

基本参数

threeDSTransType Text (2) No 交易类型（选择最合适的一个）：

“01” – 商品/服务购买（Goods/ Service

Purchase）

*如果未提供 threeDSTransType，则为默

认值

“03” – 支票确认

“10” – 账户资金

“11” – Quasi-Cash 交易

“28” – 激活及加载预付费服务

threeDSCustomerEmail Text (254) No 客户的电子邮件地址，如果有请提供

，强烈建议提供。

应符合IETF RFC 5322第3.4条的要

求。

threeDSMobilePhoneCountryCode Text (3) No 客户的手机号码国家/地区代码，如果有

请提供。

如果提供

“threeDSMobilePhoneCountryCode” ，则还应

该提供“threeDSMobilePhoneNumber” 。

示例： “852” – Hong Kong

threeDSMobilePhoneNumber Text (15) No 客户的手机号码，如果有请提供。

如果提供 “threeDSMobilePhoneNumber”，则

还应该提供

“threeDSMobilePhoneCountryCode” 。

threeDSHomePhoneCountryCode Text (3) No 客户的住宅电话号码国家/地区代码，如

果有请提供。

如果提供

“threeDSHomePhoneCountryCode”，则还应该

提供 “threeDSHomePhoneNumber” 。



threeDSHomePhoneNumber Text (15) No 客户的家庭电话号码，如果有请提供。

如果提供 “threeDSHomePhoneNumber”，则

还应该提供

“threeDSHomePhoneCountryCode” 。

threeDSWorkPhoneCountryCode Text (3) No 客户的工作电话号码国家/地区代码，如

果有请提供。

如果提供“threeDSWorkPhoneCountryCode”，

则还应该提供

“threeDSWorkPhoneNumber” 。


threeDSWorkPhoneNumber Text (15) No 客户的工作电话号码，如果有请提供。

如果提供“threeDSWorkPhoneNumber”，则还

需要提供“threeDSWorkPhoneCountryCode” 。

threeDSIsFirstTimeItemOrder Text (1) No 标记以显示客户是否正在重新订购商品/

产品。即购买相同的商品。

仅在付款与购买项目/产品有关时才提

供。

“T” – 这是客户第一次购买此商品；

“F” – 这不是客户第一次够买此商品。

threeDSChallengePreference Text(2) No 指示是否为此交易请求挑战（challenge）：

“01” – 无偏好

* 如果未提供

threeDSChallengePreference，则为默认

值。.

“02” – 不要求挑战 *

“03” – 要求挑战（商家倾向）

“04” – 要求挑战（授权）

“05” – 不要求挑战（已经进行交易风险分

析）*

“06” – 不要求挑战（仅数据共享）*

“07” – 不要求挑战（已经执行了强大的消

费者身份验证）*

“08” – 不要求挑战（如果不需要挑战，请

使用白名单豁免）*

“09” – 请求挑战（如果需要挑战，则要求

白名单提示）

** 如果选择了“不要求挑战” 选项，则退


款责任转移给商家。

定期/分期支付相关（仅在定期/分期付款时提供）

threeDSRecurringFrequency Text (4) Yes (只适

用于定期

/分期付

款)

两次付款之间的最短天数。

例如 “ 30” –付款之间隔 30 天。

threeDSRecurringExpiry Text (8) Yes (只适

用于定期

/分期付

款)

不可以再付款的日期

格式：YYYYMMDD

示例：“20190401”

账单地址相关（仅在帐单地址可用时提供）

threeDSBillingCountryCode Text (3) Yes （仅

在帐单地

址可用

时）

付款持卡人开票国家/地区，

应为 ISO 3166-1 数字三位数国家/地区代

码。

示例：“344” – Hong Kong，“840” – US。

threeDSBillingState Text (3) No 付款持卡人帐单状态，

应为 ISO 3166-2 中定义的国家/地区细分

代码，如果有请提供。

因为某些国家/地区没有细分代码。

示例：“PE” – Prince Edward Island of

California

threeDSBillingCity Text (50) Yes（仅在

帐单地址

可用时）

付款持卡人计费城市

示例：“Hong Kong”

threeDSBillingLine1

Text (50) Yes（仅在

帐单地址

可用时）

付款持卡人账单地址行 1

threeDSBillingLine2 Text (50) No 付款持卡人账单地址行 2，如果有请提供


threeDSBillingPostalCode Text (16) No 付款持卡人账单地址行 4，如果有请提供

运输/交付相关（仅在付款要求运输/交付时才提供）

threeDSDeliveryTime Text (2) No 此购买的交货时间：

“01” – 电子传递；

“02” – 当天发货；

“03” – 隔夜运送；

“04” – 为期两天或以上的运送；

threeDSDeliveryEmail Text (254) No 购买产品的电子邮件收件人。

仅在购买的产品使用电子交付时才提供。


threeDSShippingDetails Text (2) No 运送详细信息/类型（选择最合适的一

个）：

“01” – 寄至持卡人的帐单地址；

“02” – 运送到商家中存储的另一个经过

验证的地址；

“03” – 运送到与持卡人的帐单地址不同

的地址；

“04” – 运送到本地商店/在本地商店取货

（商店地址应填写在运送地址字段中）；

“05” – 数字商品（包括在线服务，电子礼

品卡和兑换代码）；

“06” – 旅行和活动门票，未发货；

“07” – 其他（例如：游戏、未提供的数字

服务、电子媒体订阅等）；

threeDSShippingCountryCode Text (3)

No 运送/送货国家，


码。

示例：“344” – Hong Kong, “840” – US

threeDSShippingState Text (3)

No 运送/交付状态，

应该是 ISO 3166-2 中定义的国家/地区细

分代码。

示例：“PE” – Prince Edward Island of California

threeDSShippingCity Text (50) No 送货/送货城市


threeDSShippingLine1 Text (50) No 送货地址 1

threeDSShippingLine2 Text (50) No 送货地址 2，如果有请提供。


threeDSShippingPostalCode Text (16) No 送货/邮递区号，如果有请提供。

threeDSIsAddrMatch Text (1) No 用于比较帐单邮寄地址和送货地址的标

志。

如果有请提供。

“T” –送货地址与帐单地址匹配，

“F” –送货地址与帐单地址不符。

礼品卡/预付卡购买相关（仅在与礼品卡/预付卡购买相关的情况下提供）

threeDSGiftCardAmount Text (15) No 礼品卡/预付卡购买金额

threeDSGiftCardCurr Text (3) No 礼品卡/预付卡购买货币，

ISO 4217三位数货币代码。

示例：“344” – HKD


threeDSGiftCardCount Text (2) No 礼品卡/预付卡购买数量。

示例： “12” – 购买 12 张礼品卡

预购相关（仅当付款与预购相关时才提供）

threeDSPreOrderReason Text (2) No 预订原因：.

“01” –预购是由于商人的库存状况，即由

于商人的库存不足而无法购买产品；

“02” –预定用于将来发布的产品，即购买

产品将在将来的日期发布。

threeDSPreOrderReadyDate Text (8) No 预购的预计准备日期

格式: YYYYMMDD

示例：“20190401”

帐户信息相关（仅在商家中有用户帐户时提供）

threeDSAcctCreateDate Text(8) No 持卡人开设帐户的日期

格式: YYYYMMDD

示例：“20190401”

threeDSAcctAgeInd Text(2) No 持卡人拥有帐户的时间长度：

• 01 =没有帐户(guest check-out)；

• 02 =在此交易期间创建；

• 03 =少于 30 天；；

• 04 =30-60 天；

• 05 =超过 60 天。

threeDSAcctLastChangeDate Text(8) No 持卡人帐户的最后更改日期，包括帐单或

送货地址，新的付款帐户或添加的新用

户。

格式：YYYYMMDD

示例：“20190401”

threeDSAcctLastChangeInd Text(2) No 自上次更改持卡人帐户信息（包括帐单或

送货地址、新付款帐户或添加的新用户）

以来的时间长度：

• 01 = 在本次交易中发生变化；

• 02 = 少于 30 天；

• 03 = 30-60 天；

• 04 = 60 天以上。

threeDSAcctPwChangeDate Text(8) No 持卡人的帐户更改密码或重置帐户的日

期。

格式：YYYYMMDD

示例：“20190401”

threeDSAcctPwChangeInd Text(2) No 表示自持卡人的帐户更改密码或重置帐


户以来的时间：

• 01 = 不变；

• 02 = 在此交易期间更改；

• 03 = 少于 30 天

• 04 = 30-60 天；

• 05 = 超过 60 天。

threeDSAcctPurchaseCount Text(4) No 过去六个月内使用此持卡人帐户进行的

购买次数。

示例： “13” –在过去六个月中购买了 13

次

threeDSAcctCardProvisionAttempt Text(3) No 最近 24 小时内尝试添加卡的次数

示例：“2” – 尝试添加两次卡

threeDSAcctNumTransDay Text(3) No 该持卡人帐户在过去 24 小时内在所有付

款帐户中进行的交易（成功和放弃）的次

数。.

示例：“2” –已处理 2 笔交易

threeDSAcctNumTransYear Text(3) No 该持卡人帐户在上一年所有付款帐户中

的交易（成功和放弃）的次数。


threeDSAcctPaymentAcctDate Text(8) No 付款帐户在持卡人的帐户中注册的日期

格式: YYYYMMDD

示例：“20190401”

threeDSAcctPaymentAcctInd Text(2) No 指示付款帐户在持卡人的帐户中注册的

时间长度：

• 01 = 没有帐户 (guest check-out)；

• 02 = 在此交易期间；

• 03 = 少于 30 天；

• 04 = 30-60 天；

• 05 = 超过 60 天。

threeDSAcctShippingAddrLastChangeDate Text(8) No 首次使用该交易的送货地址的日期

格式: YYYYMMDD

示例：“20190401”

threeDSAcctShippingAddrLastChangeInd Text(2) No 指示何时首次使用此交易使用的送货地

址：

• 01 = 这次交易

• 02 = 少于 30 天；

• 03 = 30-60 天；

• 04 = 超过 60 天。


threeDSAcctIsShippingAcctNameSame Text(1) No 指示帐户上的持卡人姓名是否与此交易

使用的运送姓名相同：

“T” – 帐户名称与运输名称相同；

“F” – 帐户名称与运输名称不同。

threeDSAcctIsSuspiciousAcct Text(1) No 指示持卡人帐户是否经历过可疑活动（包

括先前的欺诈行为）：

“T” – 观察到可疑活动；

“F” – 未观察到可疑活动。

帐户身份验证信息相关（仅在商家中有用户帐户时提供）

threeDSAcctAuthMethod Text(2) No 持卡人用于认证的机制：

•01 = 未进行身份验证（即持卡人以访客

身份“登录”）；

•02 = 使用商家自己的凭证登录到商家

系统上的持卡人帐户；

•03 = 使用联合 ID 登录商人系统上的持

卡人帐户；

•04 = 使用发行者凭证登录商户系统的

持卡人帐户；

•05 = 使用第三方身份验证登录商人系

统的持卡人帐户；

•06 = 使用 FIDO Authenticator 在商家系

统上登录持卡人帐户。

threeDSAcctAuthTimestamp Text(8) No 持卡人认证的 UTC 日期和时间。

格式：YYYYMMDD

例如“20190401”

支付令牌相关（仅在从支付令牌中取消了卡信息的令牌时才提供）

threeDSPayTokenInd Text(1) No 表示交易已取消令牌。

*仅在解除令牌时提供

“T”–卡信息从支付令牌中删除了令牌

重定向 URL（successUrl，failUrl 和 cancelUrl）输出

Ref Text 商家的订单参考号（仅用于显示目的。请勿使

用此 URL 更新系统。请使用 DataFeed。）

客户端 Post 方法示例 (源代码)

以下为购物车集成 PayDollar 的 HTML 示例。需要注意的是，粗体字部份为强制整合内容。

以下窗体示例中, hidden 字段用于保存值:


...

<form name="payFormCcard" method="post" action="

https://test.paydollar.com/b2cDemo/eng/payment/payForm.jsp">

<input type="hidden" name="merchantId" value="1">

<input type="hidden" name="amount" value="3000" >

<input type="hidden" name="orderRef" value="000000000014">

<input type="hidden" name="currCode" value="344" >

<input type="hidden" name="mpsMode" value="NIL" >

<input type="hidden" name="successUrl"

value="http://www.yourdomain.com/Success.html">

<input type="hidden" name="failUrl" value="http://www.yourdomain.com/Fail.html">

<input type="hidden" name="cancelUrl" value="http://www.yourdomain.com/Cancel.html">

<input type="hidden" name="payType" value="N">

<input type="hidden" name="lang" value="E">

<input type="hidden" name="payMethod" value="CC">

<input type="hidden" name="secureHash"

value="44f3760c201d3688440f62497736bfa2aadd1bc0">

<input type="submit" name="submit">

</form>

...

启用

集成完成后，就可以启动您的电子商务网站来服务您的客户了。如果你正在使用测试环境，请使用以下

的 URL：

https://test.paydollar.com/b2cDemo/eng/payment/payForm.jsp

如果是正式使用，请使用以下的 URL：

https://www.paydollar.com/b2c2/eng/payment/payForm.jsp


2.2 客户端直接连接（Direct Client Side Connection）

如果商家想要从其网页自己网页上完成信用卡信息的预授权而不是使用我们的标准付款页面，则可使用

此方法。使用此方法的要求是将 SSL 证书安装到您的域中，以保护客户的信用卡信息。

此外，如果客户使用的信用卡已登记 3D 验证服务，将要求客户提供个人密码以验证付款人的身份。“3D

认证”是一个 VISA、MasterCard、JCB 以及 AMEX 实施的信用卡授权程序（信用卡授权程序分别命名为“Visa

验证服务”、“万事达卡安全代码”、“J/Secure”和“AMEX SafeKey”），目的是通过验证在线交易期间购物者

的身份来减少欺诈交易。 PayDollar 将说明如何执行此过程，及客户通过 PayDollar 查看下文所示的 3D

处理页面。

由于 3D 协议适用于所有品牌类型，包括 VISA 验证，万事达卡 SecureCode，JCB J / Secure 和 AMEX

SafeKey。在本文档中，我们以“ VISA 验证”为例来详细说明流程。

对于选择这种连接方式的商户，必须安装 128 位 SSL 服务器证书以进行数据加密。系统不接受未加密的

数据。

PayDollar 使用扩展验证也能挣(Extended Validation (EV) SSL Certificate) 以确保您的系统功能正常。请检

查您的凭证储存区可以识别 VeriSign Intermediate CA 证书 - Secure Site Pro / Managed PKI for SSL

Premium with EV Certificates。如果沒有，则需要在您的凭证储存区安装 VeriSign Intermediate CA 证书。

请从以下链接中下载初级和中级的 VerSign EV SSL Intermediate CA 证书，然后导入两个证书到你的密钥

库环境 http://www.verisign.com/support/verisign-intermediate-ca/extended-validation-pro/index.html

（请选取“发表于 2009 年 5 月 17 日后”）。


VISA, Master, Diners, JCB, AMEX 信用卡与借记卡支付流程

商家页面

PayDollar 页面

协力厂商

判定框


连接至银行

支付是否成功?

3D 卡是否登记? 3D 认证过程

认证是否成功

Success?


任选 –如果您需要实时采取行动

商家的采购车

(e.g. shopCart.jsp)

商家的返回链接接收页面

(不同于 successUrl、failUrl 和

cancelUrl)

商家交易失败页面商家交易成功页面

目录服务器

(VISA/ MasterCard/

JCB)

发卡行

成功

否

是

成功失败

Fail

商家的支付页面

(Credit Card Information)


其他支付流程

返回链接(可选)

任选 –如果您需要实时采取行动

商家的返回链接接收页面

(不同于 successUrl、failUrl 和 cancelUrl)

商家页面

PayDollar 页面

协力厂商

判定框

票据 PayDollar 支付连接页面

PayDollar 支付失败页面 PayDollar 支付成功页面

ul Page

支付是否成功?

打印/继续?

商家购物车

(e.g. shopCart.jsp)

商家失败页面

商家成功页面

转至

PPS或PAYPAL或CHINAPAY或ALIPAY或TENPAY或99BILL或MEPS

或 OCTOPUS 或 NOVAPAY 或 ENETS 或 MYCLEAR 或 POLI 或 UPOP

或 UPOP-GNETE 或 UPOP-DNA 或 FUIOU 或 SCB 或

KRUNGSRIONLINE 或 KTB 或 UOB 或 TMB 或 IBANKING 或 BPM 或

GCash 或 BancNet 或 SMARTMONEY 或 WECHAT 或 ONEPAY

是否关闭? 收据

成功失败

关闭继续

打印

PayDollar 收到付款结果

MPS 处理(可选)

汇率提供商


非 3D 认证交易

客户的浏览器将从您的站点跳转到我们的付款页面，然后在完成交易后，我们会将页面跳转到您的成功/

失败页面。

3D 认证交易

3D 认证要求客户输入自己信用卡的密码，客户的浏览器将跳转至一个 3D 通知网页，目的是通知客户他

们需要在快显窗口中输入密码来完成 3D 认证。以下是“Visa 验证服务”的举例页面。

图 1.1 通知页举例


图 1.2 发证银行验证页面举例

认证后，认证结果将转发至我方系统，并且我方收单银行根据认证结果继续完成此交易过程。


集成步骤

若要连接至我方系统，你方需要将所需参数发送至我方参数页面 URL 上，然后通过使用返回链接返回结

果。


在已生成购买金额的集成目标页面中，应添加以下字段（隐藏或文本）：


请求参数(使用 UTF-8 编码)用于连接我们的支付页面

orderRef Text (35) 商家订单参考编号

amount Number (12,2) 您要向客户收取的总金额（最多 2 个小数位）

备注:

mpsMode = MCP, 该金额应以基本货币计算。

currCode Text (3) 付款货币：

“344” – HKD “840” – USD “702” – SGD

“156” – CNY (RMB) “392” – JPY “901” – TWD

“036” – AUD “978” – EUR “826” – GBP

“124” – CAD “446” – MOP “608” – PHP

“764” – THB “458” – MYR “360” – IDR

“410” – KRW “682” – SAR “554” – NZD

“784” – AED “096” – BND “704” – VND

“356” – INR

备注：


lang Text (1) 付款页面的语言：

“E” – 英语 “C” – 繁体中文

“X” – 简体中文 “J” – 日语

“T” – 泰国语 “F” – 法语

“G” – 德语 “R” – 俄语

“S” – 西班牙语 “V” – 越南

merchantId Number 我们提供给您的商户代号

pMethod Text 付款方式

(“VISA”, “Master”, ”Diners”, ”JCB”, “AMEX”, PPS", "PAYPAL", "CHINAPAY",

"ALIPAY", "TENPAY", "99BILL", "MEPS", "OCTOPUS", "NOVAPAY",

"ENETS", "MYCLEAR", "POLI", “UPOP”, “UPOP-GNETE” ,"UPOP-DNA",

"FUIOU", "SCB", "KRUNGSRIONLINE", "KTB", "UOB", "TMB",


"IBANKING", "BPM", "GCash", "BancNet", "SMARTMONEY, “M2U”,

“CIMBCLICK”, “WECHAT”, “ONEPAY”, “VCO”, “WELEND”)

epMonth Number(2) 信用卡有效期月份（卡付款强制）

epYear Number(4) 信用卡有效期年份（卡付款强制）

cardNo Text (16) 信用卡号（卡付款强制）

securityCode Text (4) 信用卡验证码（卡付款强制）

- VISA: CVV2 （三位数）

- MasterCard: CVC2 （三位数）

- JCB: CAV2 （三位数）

- American Express: 4DBC（四位数）

cardHolder Text (20) 信用卡持有人姓名（卡付款强制）

failUrl Text (300) 您希望我们在交易被拒绝后跳转的网页地址（仅用于显示目的。

请勿使用此 URL 更新系统。请使用 DataFeed。）

successUrl Text (300) 您希望我们在交易被接受后跳转的网页地址（仅用于显示目的。

请勿使用此 URL 更新系统。请使用 DataFeed。）

errorUrl Text (300) 当发生意外错误（例如参数不正确）时，您希望我们重定向的网

页地址（仅用于显示目的。请勿使用此 URL 更新系统。请使用

DataFeed。）

payType Text (1)

(“N”,”H”)

支付类型：

“N” – 消费交易

“H” – 预授权交易

使用预授权交易的商户，对于有效的交易请注意执行“预授权”操

作.一旦预授权,客户的信用卡中的金额将会在下次银行结算中扣

除.如果商户不执行预授权/授权冲正操作，则超过 14 日的授权

交易，将由发卡银行将释放持卡人的信用额度。



备注：使用 PPS, PAYPAL, CHINAPAY, ALIPAY, TENPAY, 99BILL, MEPS,

OCTOPUS, NOVAPAY, ENETS, MYCLEAR, POLI, UPOP, UPOP-GNETE,

UPOP-DNA, FUIOU, SCB, KRUNGSRIONLINE, KTB, UOB, TMB,

IBANKING, BPM, GCash, BancNet, SMARTMONEY, M2U, CIMBCLICK,

WECHAT 不能进行预授权交易


installment_service Text (1) (“T”,”F”) 分期付款服务指标

installment_period Text (20) 分期期数


*以分隔符“|”表示的多个周期，仅用于支付方式“WELEND”


airline_service Text (1) (“T”,”F”) 分期付款服务指标


帐单信息的可选参数

billingFirstName Text(60) 客户名字

billingLastName Text(60) 客户姓氏

billingStreet1 Text(40) 客户地址

billingStreet2 Text(40) 客户地址，如果地址超过 40，则为必填项

billingCity Text(50) 市

billingState Text(2) 如果客户所在的国家是美国或加拿大，则必须提供

billingPostalCode Text(10) 如果客户所在的国家是美国或加拿大，则必须提供

billingCountry Text(2) 示例：HK

billingEmail Text(255) 电子邮件地址

custIPAddress Text(15) 192.168.180.100


remark Text 确认邮件和交易明细报告中将显示一个附加的备注字段，以帮助

您参考订单

oriCountry Number(3) 源国家编码

例如：

344 – “HK” 840 – “US”

destCountry Number(3) 目的地国家/地区代码

例：

344 – “HK” 840 – “US”


secureHash 是通过将交易参数以及 secureHashSecret 组合起来

进行散列运算获得的。


timeoutValue Number 超时值，以秒为单位，仅适用于 OCTOPUS 付款，范围为 180 到

7200。

payMode Text(2) 付款模式：



“RC” – 定期（Recurring

orderPhoneNo Text(30) 订单电话号码


mpsMode Text(3) 多币种处理服务（MPS）模式：


“ MCP” –通过“多种货币定价”启用 MPS








*外币金额应由最低金额 HKD10 / MOP10 的基础金额转换，以

避免公差检查失败。

使用第三方电子钱包的可选参数

eWalletService Text

(“T”,”F”)

EWallet 服务指示灯

eWalletBrand Text (10) “eWalletBrand”的值：

“MP” – MasterPass

“VCO” – VISA Checkout

“ECO” – AMEX ExpressCheckout


eWalletInd Text MasterPass EWalle Text(3)，钱包指示符由钱包平台仅返回，并且

必须在金融授权交易中将其传递给付款处理者/收款人。

vcoCallid Text 从 VISA Checkout 返回的“callid”值

*仅适用于“ VISA Checkout 直接集成”

卡数据加密的可选参数

encryptMode Text 加密方式：

“ WEB” –用于在线交易

encryptAlgo Text 加密算法：

-“ WEB”的“ AES / CBC / PKCS5Padding”

encryptedData Text

其他自定义的加密数据（仅适用于合作伙伴）

如果 encrytedMode 为“ WEB”，请在加密前遵循以下格式

cardNo | expDate | cardHolder | securityCode





基本参数

threeDSTransType Text (2) No 交易类型（选择最合适的一个）：

“01” – 商品/服务购买（Goods/ Service

Purchase）；


*如果未提供 threeDSTransType，则为默

认值。

“03” – 检查验收；

“10” – 支票确认；

“11” – Quasi-Cash 交易；

“28” – 激活及加载预付费服务。

threeDSCustomerEmail Text (254) No 客户的电子邮件地址，如果有请提供

，强烈建议提供。

应符合IETF RFC 5322第3.4条的要

求。

threeDSMobilePhoneCountryCode Text (3) No 客户的手机号码国家/地区代码，如果有

请提供。

如果提供

“threeDSMobilePhoneCountryCode” ，则还应

该提供“threeDSMobilePhoneNumber” 。


threeDSMobilePhoneNumber Text (15) No 客户的手机号码，如果有请提供。

如果提供 “threeDSMobilePhoneNumber”，则

还应该提供

“threeDSMobilePhoneCountryCode” 。

threeDSHomePhoneCountryCode Text (3) No 客户的住宅电话号码国家/地区代码，如

果有请提供。

如果提供

“threeDSHomePhoneCountryCode”，则还应该

提供 “threeDSHomePhoneNumber” 。


threeDSHomePhoneNumber Text (15) No 客户的家庭电话号码，如果有请提供。

如果提供 “threeDSHomePhoneNumber”，则

还应该提供

“threeDSHomePhoneCountryCode”

threeDSWorkPhoneCountryCode Text (3) No 客户的工作电话号码国家/地区代码，如

果有请提供。

如果提供“threeDSWorkPhoneCountryCode”，

则还应该提供

“threeDSWorkPhoneNumber” 。


threeDSWorkPhoneNumber Text (15) No 客户的工作电话号码，如果有请提供。

如果提供“threeDSWorkPhoneNumber”，则还


需要提供“threeDSWorkPhoneCountryCode”

threeDSIsFirstTimeItemOrder Text (1) No 标记以显示客户是否正在重新订购商品/

产品。即购买相同的商品。

仅在付款与购买项目/产品有关时才提

供。

“T” – 这是客户第一次购买此商品；

“F” – 这不是客户第一次够买此商品。

threeDSChallengePreference Text(2) No 指示是否为此交易请求挑战（challenge）：

“01” – 无偏好

* 如果未提供

threeDSChallengePreference，则为默认

值。.

“02” – 不要求挑战 *

“03” – 要求挑战（商家倾向）

“04” – 要求挑战（授权）

“05” – 不要求挑战（已经进行交易风险分

析）*

“06” – 不要求挑战（仅数据共享）*

“07” – 不要求挑战（已经执行了强大的消

费者身份验证）*

“08” – 不要求挑战（如果不需要挑战，请

使用白名单豁免）*

“09” – 请求挑战（如果需要挑战，则要求

白名单提示）

** 如果选择了“不要求挑战” 选项，则退

款责任转移给商家。

定期/分期支付相关（仅在定期/分期付款时提供）

threeDSRecurringFrequency Text (4) Yes (只适

用于定期

/分期付

款)

两次付款之间的最短天数。

例如 “ 30” –付款之间隔 30 天。

threeDSRecurringExpiry Text (8) Yes (只适

用于定期

/分期付

款)

不可以再付款的日期

格式：YYYYMMDD

示例：“20190401”

账单地址相关（仅在帐单地址可用时提供）

threeDSBillingCountryCode Text (3) Yes （仅

在帐单地

付款持卡人开票国家/地区，



址可用

时）

码。

示例：“344” – Hong Kong，“840” – US。

threeDSBillingState Text (3) No 付款持卡人帐单状态，

应为 ISO 3166-2 中定义的国家/地区细分

代码，如果有请提供。

因为某些国家/地区没有细分代码。

示例：“PE” –加利福尼亚爱德华王子岛

threeDSBillingCity Text (50) Yes（仅在

帐单地址

可用时）

付款持卡人计费城市


threeDSBillingLine1

Text (50) Yes （仅

在帐单地

址可用

时）

付款持卡人账单地址行 1



threeDSBillingPostalCode Text (16) No 付款持卡人账单地址行 4，如果有请提供

运输/交付相关（仅在付款要求运输/交付时才提供）

threeDSDeliveryTime Text (2) No 此购买的交货时间：

“01” – 电子传递；

“02” – 当天发货；

“03” – 隔夜运送；

“04” – 为期两天或以上的运送；

threeDSDeliveryEmail Text (254) No 购买产品的电子邮件收件人。

仅在购买的产品使用电子交付时才提供。

threeDSShippingDetails Text (2) No 运送详细信息/类型（选择最合适的一

个）：

“01” – 寄至持卡人的帐单地址；

“02” – 运送到商家中存储的另一个经过

验证的地址；

“03” – 运送到与持卡人的帐单地址不同

的地址；

“04” – 运送到本地商店/在本地商店取货

（商店地址应填写在运送地址字段中）；

“05” – 数字商品（包括在线服务，电子礼

品卡和兑换代码）；

“06” – 旅行和活动门票，未发货；

“07” – 其他（例如：游戏、未提供的数字


服务、电子媒体订阅等）；

threeDSShippingCountryCode Text (3)

No 运送/送货国家，


码。

示例：“344” – Hong Kong, “840” – US

threeDSShippingState Text (3)

No 运送/交付状态，

应该是 ISO 3166-2 中定义的国家/地区细

分代码。

示例：“PE” –加利福尼亚爱德华王子岛

threeDSShippingCity Text (50) No 送货/送货城市


threeDSShippingLine1 Text (50) No 送货地址 1



threeDSShippingPostalCode Text (16) No 送货/邮递区号，如果有请提供。

threeDSIsAddrMatch Text (1) No 用于比较帐单邮寄地址和送货地址的标

志。

如果有请提供。

“T” –送货地址与帐单地址匹配，

“F” –送货地址与帐单地址不符。

礼品卡/预付卡购买相关（仅在与礼品卡/预付卡购买相关的情况下提供）

threeDSGiftCardAmount Text (15) No 礼品卡/预付卡购买金额

threeDSGiftCardCurr Text (3) No 礼品卡/预付卡购买货币，

ISO 4217三位数货币代码。

示例：“344” – HKD

threeDSGiftCardCount Text (2) No 礼品卡/预付卡购买数量。

示例： “12” – 购买 12 张礼品卡

预购相关（仅当付款与预购相关时才提供）

threeDSPreOrderReason Text (2) No 预订原因：.

“01” –预购是由于商人的库存状况，即由

于商人的库存不足而无法购买产品；

“02” –预定用于将来发布的产品，即购买

产品将在将来的日期发布。

threeDSPreOrderReadyDate Text (8) No 预购的预计准备日期

格式: YYYYMMDD

示例：“20190401”

帐户信息相关（仅在商家中有用户帐户时提供）

threeDSAcctCreateDate Text(8) No 持卡人开设帐户的日期


格式: YYYYMMDD

示例：“20190401”

threeDSAcctAgeInd Text(2) No 持卡人拥有帐户的时间长度：

• 01 =没有帐户(guest check-out)；

• 02 =在此交易期间创建；

• 03 =少于 30 天；；

• 04 =30-60 天；

• 05 =超过 60 天。

threeDSAcctLastChangeDate Text(8) No 持卡人帐户的最后更改日期，包括帐单或

送货地址，新的付款帐户或添加的新用

户。

格式：YYYYMMDD

示例：“20190401”

threeDSAcctLastChangeInd Text(2) No 自上次更改持卡人帐户信息（包括帐单或

送货地址、新付款帐户或添加的新用户）

以来的时间长度：

• 01 = 在本次交易中发生变化；

• 02 = 少于 30 天；

• 03 = 30-60 天；

• 04 = 60 天以上。

threeDSAcctPwChangeDate Text(8) No 持卡人的帐户更改密码或重置帐户的日

期。

格式：YYYYMMDD

示例：“20190401”

threeDSAcctPwChangeInd Text(2) No 表示自持卡人的帐户更改密码或重置帐

户以来的时间：

• 01 = 不变；

• 02 = 在此交易期间更改；

• 03 = 少于 30 天

• 04 = 30-60 天；

• 05 = 超过 60 天。

threeDSAcctPurchaseCount Text(4) No 过去六个月内使用此持卡人帐户进行的

购买次数。

示例： “13” –在过去六个月中购买了 13

次

threeDSAcctCardProvisionAttempt Text(3) No 最近 24 小时内尝试添加卡的次数

示例：“2” – 尝试添加两次卡

threeDSAcctNumTransDay Text(3) No 该持卡人帐户在过去 24 小时内在所有付


款帐户中进行的交易（成功和放弃）的次

数。


threeDSAcctNumTransYear Text(3) No 该持卡人帐户在上一年所有付款帐户中

的交易（成功和放弃）的次数。


threeDSAcctPaymentAcctDate Text(8) No 付款帐户在持卡人的帐户中注册的日期

格式: YYYYMMDD

示例：“20190401”

threeDSAcctPaymentAcctInd Text(2) No 指示付款帐户在持卡人的帐户中注册的

时间长度：

• 01 = 没有帐户 (guest check-out)；

• 02 = 在此交易期间；

• 03 = 少于 30 天；

• 04 = 30-60 天；

• 05 = 超过 60 天。

threeDSAcctShippingAddrLastChangeDate Text(8) No 首次使用该交易的送货地址的日期

格式: YYYYMMDD

示例：“20190401”

threeDSAcctShippingAddrLastChangeInd Text(2) No 指示何时首次使用此交易使用的送货地

址：

• 01 = 这次交易

• 02 = 少于 30 天；

• 03 = 30-60 天；

• 04 = 超过 60 天。

threeDSAcctIsShippingAcctNameSame Text(1) No 指示帐户上的持卡人姓名是否与此交易

使用的运送姓名相同：

“T” – 帐户名称与运输名称相同；

“F” – 帐户名称与运输名称不同。

threeDSAcctIsSuspiciousAcct Text(1) No 指示持卡人帐户是否经历过可疑活动（包

括先前的欺诈行为）：

“T” – 观察到可疑活动；

“F” – 未观察到可疑活动。

帐户身份验证信息相关（仅在商家中有用户帐户时提供）

threeDSAcctAuthMethod Text(2) No 持卡人用于认证的机制：

•01 = 未进行身份验证（即持卡人以访客

身份“登录”）；

•02 = 使用商家自己的凭证登录到商家


系统上的持卡人帐户；

•03 = 使用联合 ID 登录商人系统上的持

卡人帐户；

•04 = 使用发行者凭证登录商户系统的

持卡人帐户；

•05 = 使用第三方身份验证登录商人系

统的持卡人帐户；

•06 = 使用 FIDO Authenticator 在商家系

统上登录持卡人帐户。

threeDSAcctAuthTimestamp Text(8) No 持卡人认证的 UTC 日期和时间。

格式：YYYYMMDD

例如“20190401”

支付令牌相关（仅在从支付令牌中取消了卡信息的令牌时才提供）

threeDSPayTokenInd Text(1) No 表示交易已取消令牌。

*仅在解除令牌时提供

“T”–卡信息从支付令牌中删除了令牌


连接我们网关的示例 (客户端直接连接)

由于不同类型的编程语言具有不同的语法。因此，下面的示例代码是用 HTML 代码编写的，要求是将所

有必需的参数发布到我们的安全 API 中，并以黄色突出显示。

示例代码:

. . .

<form name="payForm" method="post" action="https://test.paydollar.com/b2cDemo/eng/dPayment/payComp.jsp">

<input type="hidden" name="merchantId" value="1">

<input type="hidden" name="amount" value="3000" >

<input type="hidden" name="orderRef" value="000000000006">

<input type="hidden" name="currCode" value="344" >

<input type="hidden" name="pMethod" value="VISA" >

<input type="hidden" name="cardNo" value="4918914107195005" >

<input type="hidden" name="securityCode" value="123" >

<input type="hidden" name="cardHolder" value="Testing" >

<input type="hidden" name="epMonth" value="07" >

<input type="hidden" name="epYear" value="2015" >

<input type="hidden" name="payType” value="N" >

<input type="hidden" name="successUrl" value="http://www.yourwebsite.com/pSuccess.jsp">

<input type="hidden" name="failUrl" value="http://www.yourwebsite.com/pFail.jsp">

<input type="hidden" name="errorUrl" value="http://www.yourwebsite.com/pError.jsp">

<input type="hidden" name="lang" value="E">

<input type=”hidden” name="secureHash" value="44f3760c201d3688440f62497736bfa2aadd1bc0">

<input type="submit" value="Pay Now">

</form>

. . .

* 本文档中的所有原始程序代码归联款通（香港）有限公司所有。任何使用、修改和改编代码的行为应

上报联款通（香港）有限公司并经联款通（香港）有限公司批准。联款通（香港）有限公司对使用原始

程序代码造成的另一方损失不负任何责任。

启用

集成结束后，你方的电子商务网页就可以运行供客户使用了。

如果你正在使用测试环境，请使用以下的 URL：

https://test.paydollar.com/b2cDemo/eng/dPayment/payComp.jsp


https://www.paydollar.com/b2c2/eng/dPayment/payComp.jsp


2.3 服务器端直接连接（Server Side Direct Connection）

这种连接方式是商家通过 PayDollar PayGate 系统直接向银行请求付款授权，并需要获得收单银行的批准。

例如，商家的 IVR 系统或移动应用程序可以直接与我们集成。因此，商家需要建立自己的付款信息收集

页面以收集付款信息，例如信用卡号，过期数据，持有人的姓名等。然后，付款信息将会发送到银行提

供的 URL 地址。因此，商家的客户将看不到任何银行的付款页面。

选择此种连接的商户，必须安装 128-bit SSL 加密程序。系统不接受没有加密的数据。

PayDollar 使用扩展验证也能挣(Extended Validation (EV) SSL Certificate) 以确保您的系统功能正常。请检

查您的凭证储存区可以识别 VeriSign Intermediate CA 证书 - Secure Site Pro / Managed PKI for SSL

Premium with EV Certificates。如果沒有，则需要在您的凭证储存区安装 VeriSign Intermediate CA 证书。

请从以下链接中下载初级和中级的 VerSign EV SSL Intermediate CA 证书，然后导入两个证书到你的密钥

库环境 http://www.verisign.com/support/verisign-intermediate-ca/extended-validation-pro/index.html

（请选取“发表于 2009 年 5 月 17 日后”）

Client's Online

Shop

Store selected

items in

Shopping Cart

Calculate

the total amount

Customer

Request

payment

authorization

from bank

PayDollar Domain

Merchant Domain

Collect payment

information

Message

to customer

Process under PayDollar

Domain is hidden from

customer.

Server Post

Return

payment

message



以下是用于集成的参数， PayDollar 支付网关区分大小写，确保字体正确。交易完成后，系统将在商家

制定的页面上返回客户付款消息。


请求参数(使用 UTF-8 编码)用于连接我们的支付页面


amount Number (12,2) 您要向客户收取的总金额（最多 2 个小数位）

备注:


currCode Text (3) 付款货币：

“344” – HKD “840” – USD “702” – SGD

“156” – CNY (RMB) “392” – JPY “901” – TWD

“036” – AUD “978” – EUR “826” – GBP

“124” – CAD “446” – MOP “608” – PHP

“764” – THB “458” – MYR “360” – IDR

“410” – KRW “682” – SAR “554” – NZD

“784” – AED “096” – BND “704” – VND

“356” – INR

备注：


lang Text (1) 付款页面的语言：

“E” - 英语

merchantId Number 我们提供给您的商户代号

pMethod Text

(“VISA”,

“Master”, ”Diner

s”,

”JCB”, ”AMEX”,

”VCO”)

支付卡类型：


epMonth Number(2) 信用卡到期月份

epYear Number(4) 信用卡到期年份

cardNo Text (16) 信用卡号

cardHolder Text (20) Credit card holder name

securityCode Text (4) 信用卡验证码：

- VISA: CVV2（三位数）

- MasterCard: CVC2（三位数）


- JCB: CAV2（三位数）

- American Express: 4DBC（四位数）

payType Text (1)

(“N”,”H”)

支付类型：

“N” – 消费交易

“H” – 预授权交易

使用预授权交易的商户，对于有效的交易请注意执行“预授权”操作.

一旦预授权,客户的信用卡中的金额将会在下次银行结算中扣除.如

果商户不执行预授权/授权冲正操作，则超过 14 日的授权交易，

将由发卡银行将释放持卡人的信用额度。



备注：使用 PPS, PAYPAL, CHINAPAY, ALIPAY, TENPAY, 99BILL, MEPS,

OCTOPUS, NOVAPAY, ENETS, MYCLEAR, POLI, UPOP, UPOP-GNETE,

UPOP-DNA, FUIOU, SCB, KRUNGSRIONLINE, KTB, UOB, TMB, IBANKING,

BPM, GCash, BancNet, SMARTMONEY, M2U, CIMBCLICK, WECHAT,

ONEPAY 不能进行预授权交易


installment_service Text (1) (“T”,”F”) 分期付款服务指标

installment_period Number 分期期数


airline_service Text (1) (“T”,”F”) 分期付款服务指标


帐单信息的可选参数

billingFirstName Text(60) 客户名字

billingLastName Text(60) 客户姓氏

billingStreet1 Text(40) 客户地址

billingStreet2 Text(40) 客户地址，如果地址超过 40，则为必填项

billingCity Text(50) 市

billingState Text(2) 如果客户所在的国家是美国或加拿大，则必须提供

billingPostalCode Text(10) 如果客户所在的国家是美国或加拿大，则必须提供

billingCountry Text(2) 示例：HK

billingEmail Text(255) 电子邮件地址

custIPAddress Text(15) 192.168.180.100



remark Text 确认邮件和交易明细报告中将显示一个附加的备注字段，以帮助您

参考订单


secureHash 是通过将交易参数以及 secureHashSecret 组合起来进行

散列运算获得的。


payMode Text(2) 付款模式：



“RC” - 定期（Recurring）

“RT” – 零售（Retail）

orderPhoneNo Text(30) 订单电话号码

3D 交易参数（需要在商家网站上安装 MPI 服务器软件）

vbvTransaction Text

(“T”,”F”)

3D 交易 (即通过 VISA, MasterCard SecureCode, J/Secure, AMEX

SafeKey 验证)

“T” – True: 交易已通过 VE / PA 流程或已执行 3DS 2.0 身份验证。

“F” – False: 未经 VE / PA 流程的非 3D 交易

[除了 vbvTransECI 以外，无需发送其他 3D 参数]

*注意：

非 3D 交易需要获得银行的批准，请与我们联系以获取更多详细信

息。

vbvCHReturnCode Number - 验证注册返回码：

- 如果在 MPI VE 响应消息中获得的注册值为“ Y”，则设置为“0”；

- 如果在 MPI VE 响应消息中获得的注册值为“ N”，则设置为

“1001”；

- 如果注册值在 MPI VE 响应消息中不可用，则设置为“-1”；

- 如果使用 3DS 2.0，则保留为空/ null。

vbvPAReturnCode Number - 付款人验证返回码：

- 如果在 MPI VE 响应消息中获得的状态值为“Y”，则设置为“0”；

- 如果在 MPI VE 响应消息中获得的状态值为“A”，则设置为

“1000”；

- 如果在 MPI VE 响应消息中获得的状态值为“N”，则设置为 1003”；

- 否则设置为“-1”；

- 如果使用 3DS 2.0，则保留为空/ null。

vbvTransTime Text in format

(YYYYMMDD

HH:MM:SS)

事务时间，时间，MPI PA 响应消息。

如果使用 3DS 2.0，则为“身份验证响应/结果请求”的接收时间。


vbvTransAuth Text (28) MPI PA 响应消息中的持卡人身份验证验证值，CAVV 值[必须采用

Base64 编码格式]

如果使用 3DS 2.0，则“身份验证响应/结果请求”中的“身份验证值”。

vbvTransECI Text (2) MPI PA 响应消息中的电子商务指标 ECI 值：

对于 VISA & JCB 卡支付：

- 对于已登记的 3D VISA 卡

[ enrolled = Y ]

- 将其设置为从 MPI PA 响应消息获得的 ECI 值

- 如果 MPI PA 响应消息中没有 ECI 值，则将其设置为“ 07”

- 对于未登记的 3D VISA 卡

[ enrolled = N ]

- 将其设置为 “06”

- 否则将其设置为 “07”

- Master 卡付款：

- 适用于已登记的 3D Master 卡

- [ enrolled = Y ]

- 将其设置为从 MPI PA 响应消息获得的 ECI 值

- 如果 MPI PA 响应消息中没有 ECI 值，则将其设置为“00”

- 适用于未登记的 3D Master 卡

[ enrolled = N ]

- 将其设置为“01”

- -否则，将其设置为“00“

对于其他信用卡付款，将其设置为“07”

如果使用 3DS 2.0，则“身份验证响应/结果请求”中的 ECI 值。

vbvCAVVAlgo Text MPI PA 响应消息中的 CAVV 算法 cavvAlgorithm

如果使用 3DS 2.0，则保留为空/ null。

vbvXID Text(20) MPI PA 响应消息中的事务标识符 xid [必须包含 20 个字符]

如果使用 3DS 2.0，则保留为空/ null。

vbvMerchantID Text MPI PA 响应消息中的获取方定义的商家标识符 merID

如果使用 3DS 2.0，则为身份验证请求的“获取方商户 ID”。

vbvAcquirerBin Text Acquirer BIN, acqBIN, in MPI PA Response Message

If using 3DS 2.0, the “Acquirer BIN” of Authentication Request.

vbvTransStatus Text(1) MPI PA 响应消息中的事务状态：

- 将其设置为从 MPI PA 响应消息获得的状态值；

- 如果 MPI PA 响应中的状态值不可用，则将其设置为“U”；


- 如果使用 3DS 2.0，请将其设置为“身份验证响应”中返回的“交

易状态”。


mpsMode Text(3) 多币种处理服务（MPS）模式

“MCP” –通过“多种货币定价”启用 MPS








*外币金额应由最低金额 HKD10 / MOP10 的基础金额转换，以避免

公差检查失败。

使用第三方电子钱包的可选参数

eWalletService Text

(“T”,”F”)

EWallet 服务指示灯

eWalletBrand Text (10) “eWalletBrand”的值：

“MP” – MasterPass



“SAMSUNG” – Samsung Pay

eWalletPaymentData Text 检索到的具有 Base64 格式的 EWallet 数据

*用于 Samsung Pay

eWalletInd Text MasterPass EWalle Text(3)，钱包指示符由钱包平台返回，并且必须

在金融授权交易中将其传递给付款处理者/收款人。

vcoCallid Text 从 VISA Checkout 返回的“ callid”值

*仅适用于“ VISA Checkout 直接集成”

卡数据加密的可选参数

encryptMode Text 加密方式

“WEB” – 用于在线交易

“POS” – 用于 POS 卡当面交易

encryptAlgo Text Encrypted Algorithm:

-“DEsede/CBC/PKCS5Padding” For “POS”

-“AES/CBC/PKCS5Padding” For “WEB”

encryptedTrack1Data Text

加密卡轨道1数据

格式：初始化向量IV（16）+ 加密的轨道1数据

注意：Track1数据的最大记录长度为79个字母数字字符。加密之前


以纯文本形式采样Track1数据：

“％B4111111111111111 ^ MR TEST C ABCDE

^ 18091019681143300001 840 ?;”

encryptedTrack2Data Text

加密卡轨道 2 数据

格式：初始化向量 IV（16）+加密的轨道 2 数据

注意：Track2 数据的最大记录长度为 40 个字母数字字符。加密之

前以纯文本形式采样 Track2 数

据：”;4111111111111111=18091019681143384001?”

encryptedEmvData Text

通过 EMV 卡上的芯片读取的加密卡 EMV 数据

格式：初始化向量 IV（16）+加密的 EMV 数据

encryptedData Text

其他自定义的加密数据（仅适用于合作伙伴）

如果 encrytedMode 为“ WEB”，请在加密前遵循以下格式 cardNo |

expDate | cardHolder | securityCode





基本参数

threeDSVersion Text (10) No 如果在此付款中处理了 3D-Secure，请指明 3DS

版本。

*如果“vbvTransaction”为“ T”，则应提供。

“ 1.0” –使用 3DS 1.0

“ 2.1.0” /“ 2.2.0” –使用 3DS 2.0（取决于 3DS 2.0 消

息中使用的实际消息版本）

threeDSCustomerIP Text (45) No 客户输入的 IPv4 / IPv6 标准的 IP。

*建议提供所有交易（如果有）。

例如 “1.12.123.255”/“ 2011：0db8：85a3：0101：

0101：8a2e：0370：7334”

threeDSDsTransId Text (36) No (如果

使用 3DS

2.0)

如果使用 3DS 2.0，请提供 DS Transaction ID（如

果有）。

threeDSServerTransId Text (36) No 如果使用 3DS 2.0，请提供 3DS 服务交易 ID（如果

有）。

threeDSAcsTransId Text (36) No 如果使用 3DS 2.0，请提供 ACS 交易 ID（如果有）。

threeDSSdkTransId Text (36) No 如果使用 3DS 2.0，请提供 SDK 交易 ID（如果有）。


返回参数

src Number 返回银行主机状态码

prc Number 返回银行主机状态码

Ord Number 银行参考号

Holder Text 付款帐户的持有人名称

successcode Number 交易状态：

0 – 交易成功

1 – 交易失败

Ref Text 商家订单参考编号

PayRef Number PayDollar 付款参考号

Amt Number (12,2) 交易金额

Cur Number (3) 交易货币，示例：“344”-港币

AuthId Text 批准代码

TxTime Text

(YYYY-MM-DD

HH:MI:SS.0)

交易时间

errMsg Text 错误信息

encryptedEmvResponse Text EMV 数据响应仅适用于 EMV 交易。

初始化向量 IV（16）+加密的 EMV 响应数据

所有的返回参数将以 html 请求格式连接，并以＆分隔。

样本返回字符串：

successcode=0&Ref=Test&PayRef=4780&Amt=1.0&Cur=344&prc=0&src=0&Ord=6697090&

Holder=edward&AuthId=123456&TxTime=2003-10-07 17:48:02.0&errMsg=Transaction

completed


源代码示例

由于不同的语言有不同的语法, 所以我们只提出方法连接我们的支付页面.我们建议你使用服务器端连

接。

使用Java的服务器端代码：

// 建立 post 数据

String postData =

"merchantId=1&orderRef=test&amount=1&currCode=344&pMethod=VISA&epMonth=01&epYear=20

02&cardNo=4123412341234123&cardholder=Edward&remark=test”;

// Post 到支付页面

strResult = ServerPost.post(postData,

https://www.paydollar.com/b2c2/eng/directPay/payComp.jsp );

// 从 strResult 提取数据

...

// 完成

************************************************************************

public class ServerPost

{

static public String post( String ip_postData, String ip_pageUrl)

{

try

{

String strResult = "";

URL url = new URL(ip_pageUrl);

URLConnection con = url.openConnection(); //from secure site

if(con instanceof com.sun.net.ssl.HttpsURLConnection){

((com.sun.net.ssl.HttpsURLConnection)con).setSSLSocketFactory

(SSLSocketFactory)SSLSocketFactory.getDefault());

}

con.setDoOutput(true);

con.setDoInput(true);

// 设置 request headers 的 content 类型和长度

con.setRequestProperty(

"Content-type",

"application/x-www-form-urlencoded");


"Content-length",

String.valueOf(ip_postData.length()));

// 发出 post 请求

OutputStream outStream = con.getOutputStream();

outStream.write(ip_postData.getBytes());

outStream.flush();


// 读取响应

InputStream inStream = con.getInputStream();

while (true)

{

int c = inStream.read();

if (c == -1)

break;

strResult = strResult + String.valueOf((char)c);

}

inStream.close();

outStream.close();

return strResult;

}

catch (Exception e)

{

System.out.print(e.toString());

return null;

}

}

}

*此档中的所有原始程序代码归联款通（香港）有限公司所有。任何使用、修改和改编代码的行为应上报

联款通（香港）有限公司并经联款通（香港）有限公司批准。联款通（香港）有限公司对使用原始程序

代码造成的另一方损失不负任何责任。

启用

集成结束后，你方的电子商务网页就可以运行供客户使用了。

如果你正在使用测试环境，请使用以下的 URL：

https://test.paydollar.com/b2cDemo/eng/directPay/payComp.jsp


https://www.paydollar.com/b2c2/eng/directPay/payComp.jsp


3 返回链接处理

要使用返回链接功能 , 商户必须建立返回链接页面并告知 PayDollar 你的页面位置（例如：

http://www.yourdomain.com/datafeed.jsp)。商户可以在商户管理后台开启或关闭这个功能。

返回链接输出中的参数定义


返回链接输出

src Number 返回银行主机状态码（次），详细请参考附录 A

prc Number 返回银行主机状态码（主），详细请参考附录 A

Ord Text (40) 银行参考订单号

Holder Text 支付账号的持有人姓名

successcode Number 0- 成功，1-失败，其它 –错误

Ref Text 商家的订单参考号

PayRef Number PayDollar 的支付参考号

Amt Number (12,2) 交易金额

Cur Text (3) 交易货币种类即

“344” – HKD “840” – USD “702” – SGD

“156” – CNY (RMB) “392” – JPY “901” – TWD

“036” – AUD “978” – EUR “826” – GBP

“124” – CAD “446” – MOP “608” – PHP

“764” – THB “458” – MYR “360” – IDR

“410” – KRW “682” – SAR “554” – NZD

“784” – AED “096” – BND “704” – VND

“356” – INR

remark Text (200) 一个备注字段，供您存储不会在交易网页上显示的其他数据

AuthId Text 批准代码

eci Text (2) ECI 值(适用于启用３Ｄ的商家)

VISA / JCB / AMEX

ECI 值定义

05 持卡人和发卡行均已启用 3D。 3D 卡

认证成功

06 持卡人或发卡银行均未注册 3D。 3D

卡身份验证失败，在以下示例情况下：

1.未注册 3D 持卡人

2.发卡银行尚未准备好 3D 安全

http://www.yourdomain.com/datafeed.jsp


07 身份验证失败或未尝试。信用卡是非

3D 卡，或者发卡银行未将其作为 3D

交易处理

MasterCard

ECI 值定义



交易处理






认证成功

备注：当 PayDollar PayAlert 拒绝交易时，将发送空字符串。

payerAuth Text (1) 付款人身份验证状态:

Y - 卡已进行 3-D 安全注册，身份验证成功。

N - 卡已进行 3D 安全注册，但身份验证失败。

P - 3-D 安全检查正待处理

A - 卡尚未进行 3D 安全注册

U - 不处理 3D 安全检查。

sourceIp Text (15) 付款人的 IP 地址

ipCountry Text (3) 付款人所在的国家/地区（例如香港）

-如果国家/地区位于高风险国家/地区列表中，则会显示星号

（例如 MY *）

payMethod Text (10) 付款方式（例如 VISA，Master，Diners，JCB，AMEX）

cardIssuingCountry Text (3) 发卡国家代码（例如香港）

-如果国家/地区位于高风险国家/地区列表中，则会显示星号

（例如 MY *）

-如果未定义信用卡的发卡国家/地区，

将显示“--”。

详细信息请参考附录 A“国家代码清单”

channelType Text (3) 通道类型：

SPC –通过浏览器Post

DPC –直接客户端连接

DPS –服务器端直接连接

SCH –定期付款

DPL –直接付款链接连接

MOT – Moto连接

RTL – RetailPay连接

BPP –批量付款流程


MOB –移动支付连接


secureHash 是通过将交易参数以及 secureHashSecret 组合起

来进行散列运算获得的。

*只提供给注册了该功能的商户使用。详见章节 4

AlertCode Text (50) 警报代码

例如 R14 –IP 国家与签发国不匹配

R 9-在高风险国家清单中

MerchantId Number 商家编号

airline_ticketNumber Text 机票号码

TxTime Text (YYYY-MM-DD

HH:MI:SS.0)

交易时间

卡信息的附加输出参数

expMonth Text (MM) 卡的有效期月份

*仅返回批准的商家

expYear Text (YYYY) 卡的有效期年份


panFull Text 带有 AES256 加密的加密 PAN


panFirst6 Text (6) 卡的前 6 位




panLast4 Text (4) 卡的最后 4 位数字


accountHash Text 卡的哈希值


accountHashAlgo Text 卡的哈希功能：

SHA-1


使用 MPS VAS 进行交易处理的其他输出参数

mpsAmt Number (12,2) MPS 交易金额

备注：仅适用于已启用 MPS。

mpsCur Text (3) MPS 交易货币


mpsForeignAmt Number (12,2) MPS 交易国外金额



mpsForeignCur Text (3) MPS 交易外币


mpsRate Number (12,4) MPS 汇率：（外币/基础）

例如美元/港元= 7.77


使用 SchedulePay VAS 进行交易处理的其他输出参数

mSchPayId Number 主要定期付款 ID

*仅适用于计划付款交易

dSchPayId Number 次要定期付款 ID


使用 MemberPay VAS 进行交易处理的其他输出参数

mpMemberId Text 会员 ID，如果商家使用 memberPay

mpLatestStaticToken Text 加密的静态令牌，如果商家使用 MemberPay 的静态令牌模式

通过第三方电子钱包进行交易处理的其他输出参数

isEwallet Text(1) “ T” – 这是具有 Ewallet 功能的交易

eWalletBrand Text ECO - AMEX Express checkout

MP – MasterPass

VCO – VISA Checkout

eWalletInd Text MasterPass EWalle 文本长度为 3，钱包指示符由钱包平台仅

返回，并且必须在金融授权交易中将其传递给付款处理者/收

款人。

使用 Promopay VAS 处理交易的附加输出参数

promotionCode Text(8); 促销活动的交易代码

*仅限促销交易

promotionRuleCode Text(8); 交易促销规则代码

*仅限促销交易

promotionOriginalAmt Number (12,2)

原价促销

*仅限促销交易

分期付款交易的其他输出参数

period Number 分期付款（以月数计）

installmentProvider Text 分期付款的开证行或提供方

“ HASE” – 恒生银行（香港）

“BOCIHK” – 中国银行（香港）

“ BCA”- 中亚银行（印度尼西亚）

“ WELEND” – WeLend（香港）

firstPayAmt Number 第一期的交易金额

*仅当分期付款银行提供此信息时返回

eachPayAmt Number 每个分期的交易金额



lastPayAmt Number 上一期的交易金额


使用奖励计划处理的交易的其他输出参数（例如：Hang Seng Cash Dollar）

netAmtAfterRewards Number(12,2) 兑换奖励计划后的总净额

rewardsRedeemTotalAmt Number(12,2) 积分兑换总额

rewardsRedeemType Text 奖励兑换类型

“HASE” –Hang Seng Cash Dollar

rewardsRedeemProgram Number 兑换程序数量

返回值为 1,2 或 3

rewardsRedeemCode1 Text 首次奖励计划兑换计划代码

*仅当 rewardsRedeemProgram 返回值为 1,2 或 3 时返回

rewardsRedeemLabel1 Text 首次奖励计划兑换计划标签


rewardsRedeemAmt1 Number(12,2) 首次奖励计划兑换金额


rewardsBalance1 Text 首次奖励计划余额

格式

过期奖励余额过期日期–过期余额金额 | 奖励余额过期日期

-奖励余额金额

例如：0115-20.00 | 0120-30.00


rewardsRedeemCode2 Text 第二奖励计划兑换计划代码

*仅当 rewardsRedeemProgram 返回值为 2 或 3 时返回

rewardsRedeemLabel2 Text 第二奖励计划兑换计划标签


rewardsRedeemAmt2 Number (12,2) 第二奖赏计划兑换金额


rewardsBalance2 Text 第二奖励计划余额

格式

过期奖励余额过期日期–过期余额金额| 奖励余额过期日期-

奖励余额金额

例如：0115-20.00 | 0120-30.00


rewardsRedeemCode3 Text 第三奖励计划兑换计划代码

*仅当 rewardsRedeemProgram 返回值为 3 时返回

rewardsRedeemLabel3 Text 第三奖励计划兑换计划标签



rewardsRedeemAmt3 Number(12,2) 第三奖赏计划兑换金额


rewardsBalance3 Text 第三奖励计划余额

格式

过期奖励余额过期日期–过期余额金额| 奖励余额过期日期-

奖励余额金额

例如：0115-20.00 | 0120-30.00


3DS 2.0 的其他输出参数

threeDSVersion Text (10) 如果在此付款中处理了 3D-Secure，请指明 3DS 版本。

*如果“vbvTransaction”为“ T”，则应提供。

“ 1.0” –使用 3DS 1.0

“ 2.1.0” /“ 2.2.0” –使用 3DS 2.0（取决于 3DS 2.0 消息中使用

的实际消息版本）

返回链接页必须满足以下要求：

- 当数据的预授权完成时在 HTML 中打印“OK”（ACK 消息）

- 确保先打印“ＯＫ”以确认我们的系统，然后再进行其余的系统过程，如果系统过程出现问题（例如，

下载照片，铃声问题），您可以向我们的系统发送无效请求，以便更多详细信息，请参阅我们的 API

指南并联系我们的技术人员。

请注意，系统仅将端口 80（HTTP）或 443（HTTPS）用于返回链接页面位置。并确保可以从外部访问

返回链接页面的位置，以便我们的服务器可以调用返回链接页面。

*由于系统将从返回链接页面上读取单词“OK”来确定是否传送了（返回链接）消息，因此，如果该单词未

成功返回，则系统将假定返回链接丢失。


返回链接设置

商家可以在商家管理站点>配置文件>付款选项中启用或禁用返回链接功能。

返回链接页面示例

以下是返回链接页的 JSP 示例

<%@ page language="java" %>

<%

String successCode = request.getParameter("successcode");

String payRef = request.getParameter("PayRef");

String Ref = request.getParameter("Ref");

// 打印'OK'来通知我们，您已经成功接受付款结果

out.print("OK");

if ( successCode.equals("0") )

{

// 交易成功

// *** 在这里增加安全验证代码，从数据库中根据商户订单引用编号检查货币、金额

// *** 根据数据库中商家的订单参考，如果订单存在，则

// *** 接受，否则拒绝交易。

// 交易成功，更新您的数据库。并发送电子邮件或通知您的客户

....

// 假如你的数据库或者你的系统出现问题，你可以发送一个无效的交易请求,详情请参考 API 指南。

}

else

{

// 拒绝交易

// 拒绝交易，更新你的数据库

.....

}

%>


以下是 ASP 中的示例返回链接页面：

<%@ Language = "VBScript" %>

<%

Dim successCode

Dim payRef

Dim Ref

successCode = Request.Form("successcode")

payRef = Request.Form("PayRef")

Ref = Request.Form("Ref")

' 打印“OK”以通知我们您已收到付款结果

Response.write("OK")

If successCode = "0" Then

' 交易成功

' *** 在这里增加安全验证代码, 从数据库中根据商户订单引用编号检查货币,金额。

' *** 根据数据库中商家的订单参考，如果订单存在，则

' *** 接受，否则拒绝交易。

' 交易成功，更新您的数据库。并发送电子邮件或通知您的客户。

....

' 如果您的数据库或系统出现问题，可以发送一个无效的交易请求。

' 有关更多详细信息，请参见 API 指南。

Else

' 交易失败

' 拒绝交易，更新您的数据库。

.....

End If

%>


4 哈希码安全交易

简介

使用哈希码安全验证功能是为了提高商户端与 PayDollar 之间传输交易信息的安全性。通过采用该技术，

商户方的签署以及交易信息的完整性将通过行业标准进行验证。

哈希码安全验证流程

Transaction information

(Merchant Id, Currency

Code, Amount, Secure

Hash Secret, etc)

Message Digest

SHA-1


Pass to

PayDollar


Message Digest

(Re-calculated)

Message Digest

(Original)

SHA-1

=?

Verified Transaction

information

Y

Merchant Site PayDollar

Message Digest

1. 对于所有从商户端发送到 PayDollar 的交易请求, 都必须将经过计算的哈希码添加到交易请求中以验

证商户身份和交易信息的完整性。

2. 哈希码安全验证是通过使用 SHA-1(行业标准中的一种加密哈希码算法)将以下的参数进行运算得出

的。

- 商家 ID

- 商家订单参考编码

- 交易货币

- 交易金额

- 支付种类

- 哈希码密钥 – 由 PayDollar 指派给商户

3. 当收到交易请求，PayDollar 将比对商户提交的哈希码以及将其他参数进行运算得出的哈希码来核实

交易。如果两个值相同，当前的交易流将继续。否则，交易请求将被丢弃。与此同时 PayDollar 将发

送一封邮件到操作聯絡人提醒商户。

4. 交易完成之后, PayDollar 会向商户端发送一个 datafeed。其中将会附带一个通过 SHA-1 将以下参数


进行运算获得的哈希码。

- 返回银行主机状态码（次）

- 返回银行主机状态码（主）

- 交易结果

- 商户订单参考编号

- PayDollar 的支付参考号

- 交易货币

- 交易金额

- 付款人认证状态

- 哈希码密钥

5. 商户收到返回链接之后，我们强烈建议您比对 PayDollar 发送的哈希码和通过将其他参数进行运算获

得的哈希码来核实信息。如果两个值不匹配，则 datafeed 很有可能在重定向发送的过程中被篡改，

请您在确认订单之前先进行进一步的调查。

PayDollar 提供的客户端库文件

PayDollar 提供了客户端库，以促进安全的哈希生成和验证过程。它支持常见的编程语言，包括 Java，

PHP，ASP，ASP.NET。支持以下函数调用。

功能参数描述

generateSecureHash Input

- Merchant ID

- Merchant Reference Number

- Currency Code

- Amount

- Payment Type

- Secure Hash Secret

Output

- Secure Hash String

通过将输入的参数及哈希码密钥

(Secure Hash Secret)进行运算获

得一个哈希码。

(得到的哈希码必须被包含在交

易参数中发送到 PayDollar。)

verifyDatafeed Input

- Src

- Prc

- Success Code

- Merchant Reference Number

- PayDollar Reference Number

- Currency Code

通过输入参数和哈希码密钥核实

从 PayDollar 传输过来的参数。

(如果输出的结果为 true，则可以

确定这些参数是由 PayDollar 发

送并且是值得信任的。)


- Amount

- Payer Authentication Status

- Secure Hash Secret

- Secure Hash from PayDollar

Output

- True/False

*请登录到 PayDollar 商户管理系统并在“支援中心→开发者园地”页面下载客户端库文件及代码样式。

手动生成和验证哈希码

商户也可以手动生成和验证哈希码，而不使用 PayDollar 提供的客户端库文件。下面的图表列出了详确的

算法。

生成哈希码（Secure Hash）

1. 生成签名数据字符串

Signing data string = Merchant ID + “|” + Merchant Reference + “|” + Currency Code + “|” +

Amount + “|” + Payment Type + “|” + Secure Hash Secret

2. Secure Hash = SHA-1(Signing data string)

*SHA-1 是原始的 160-bit 函数

Secure Hash Secret 例子

gMAVIEGVpqHvxoNEqbrZRuBDFT1B0icW

Signing data string 例子

56100908|1280204670187|344|10|N|gMAVIEGVpqHvxoNEqbrZRuBDFT1B0icW

Secure Hash 例子

13068c0ef09139ea711d36bde16785a2d30b9a30


从 PayDollar 返回链接验证哈希码

1. 生成核实数据字符串

Verify data string = Src + “|” + Prc + “|” + Success Code + “|” + Merchant Reference Number + “|”

+ PayDollar Reference Number + “|” + Currency Code + “|” + Amount + “|” + Payer

Authentication Status + “|” + Secure Hash Secret

2. Verify Secure Hash = SHA-1 (Verify data string)

3. 提取 PayDollar 返回链接中的哈希码.

4. 对比 step 2 和 step 3 的输出. 如果相同则返回 True 否则返回 False。

*SHA-1 是原始 160-bit 哈希码函数。

开通商户账号的哈希码安全验证

a) 请联系 PayDollar 客服部门([email protected]) 开通商户账号的哈希码安全验证功能。

b) 您可以通过访问商户管理界面“配置文件” > “付款信息”来检索商户帐户的“哈希码密钥”。必须安全

保存“安全哈希密钥”才能使该功能有效。

c) 哈希码密钥会每两年更换一次以提高安全等级

d) 开通此功能之后，所有的交易请求中都必须包含一个有效的哈希码。不包含有效哈希码的交易请求

都将被 PayDollar 丢弃。

e) 您可以在以下的页面中下载到客户端库文件及代码样式，

PayDollar 商户管理系统 → 支援中心 → 开发者园地。

mailto:[email protected]


5 多币种处理服务

简介

PayDollar 多货币处理服务(MPS) 是一个综合性的电子支付服务。MPS 可以让各种规模的网上业务，安

全，实时地接收外国持卡人使用信用卡支付，并提供他们购买商品和服务时选择结算货币的同时，商家

使用已设定的基础货币进行结算。

多货币处理服务 (MPS) 提供如下的三种模式:

◼ 简单货币转换 (SCP)

◼ 多货币计价 (MCP)

◼ 动态货币转换 (DCC)

多货币处理服务 (MPS)使商户更方便，更灵活地连接我们的网络.

商户可以选择以下的集成方法.

- 客户端通过浏览器发送 (例如. 购物车)

定义:

“外币” 指的是那些商户不时提供和支持给 AsiaPay 的非基础货币。

“基础货币” 指的是商户设置用于支付交易的结算货币。

“汇率“ 指的是由认可供货商提供的外币汇率。


简单货币转换(SCP)

简单货币转换 (SCP) 是一个增值的电子支付处理服务，可以使你的网上业务，安全地，实时地接收国外

顾客使用外币购物商品和服务的同时，以你基础的货币作为结算。而且，你的企业可以继续以基础货币

作为结算。

简单货币转换 (SCP) 将会由我们的汇率提供商把国外国币与商户的基础货币进行转换。此后,国外金额

基础金额和汇率都将会显示在 Paydollar 的支付输入页面。

交易流程

PayDollar (MPS-SCP)

转换外币价格为基础货币

例如. USD -> RMB

商户

商户网站的外币定价

例如. USD

收单银行

用基础货币进行处理

例如. RMB

商户

商户给予基础货币结算

例如. RMB

汇率提供商

提供汇率

例如. USD/RMB


简单货币转换 (SCP) 样板交易示例

付款金额转换和账户输入页 :


支付结果页：


多货币计价 (MCP)

多币种定价(MCP)是一种增值电子支付处理服务，让您的在线业务可以安全地接受来自海外客户的实时信

用卡支付，同时让他们选择以商户基础货币或其他全球货币(如美元)支付商品和服务。而且，您的业务可

以像往常一样继续收取以当地货币结算的款项。

多币种计价(MCP)将根据汇率将商户发布的基本货币转换为全球货币。之后，客户可以选择其中一种货币

进行支付。

交易流程

PayDollar

(MPS-MCP)

商户

客户

信用卡组织

收单银行

3. 客户使用外币结帐

例如：SGD17.05

1. 客户选择购物首选货币

例如：

基础货币：港币

选择的货币：SGD

2. 商家网站通过 MPS 汇率查

询 API 获取所选货币的汇率

和外币价格

例如 1 HKD = 0.1705 SGD

5. 处理外币付款

例如 SGD 17.05

银行汇率

6. 处理以外币支付的信用卡

组织

例如 SGD 17.05

7. 银行以基本货币向商人结算

交易.

示例： HKD

4. 商家提交支付

例如

基本金额：港币 100 元

外币金额：SGD17.05

汇率：

1 港元= 0.1705 新加坡元


MCP 计算

PayDollar 将向商家提供 API，以与他们的 Web 服务器集成。该 MPS 汇率查询 API 用于查询汇率和 MCP

国外金额的计算。 MCP 金额的计算将基于 PayDollar 上存储的汇率；将提供该货币的正确小单位。

舍入

汇率响应消息包含带有四个小数位的保证金汇率。商家将使用此汇率来计算 MCP 金额。商家在计算

MCP 金额时会考虑每种货币正确的较小单位。将采用四舍五入。

.

- 示例：两种小单位货币

汇率 1HKD=0.0960EUR

HKD 376 = EUR 36.10 (四舍五入前, EUR 36.096)

汇率 1HKD=0.1394CAD

HKD 345 = CAD 48.09 (四舍五入前, CAD 48.093)

- 示例: 货币次要单位为 0

汇率 1HKD=132.3400KRW

HKD 100 = KRW 13234

费率到期

费率响应消息包含到期时间。价格仅在此到期时间之前有效。如果 MCP 汇率已过期，该交易将被

PayDollar 拒绝。因此，商家应在每个新客户浏览会话中每次进行价格查询，而不是在本地存储价格。

公差检查

PayDollar 会对每笔 MCP 交易进行费率公差检查，以确保所有 MCP 交易都只能在商定的公差水平内与银

行以最新保证金汇率进行处理。如果公差检查失败，该交易将被 PayDollar 拒绝。


多货币计价（MCP）样板交易示例

支付方式选择页面：

付款账户输入页面：付款结果页面：


动态货币转换（DCC）

动态货币转换(DCC)是一种增值电子支付处理服务，让您的在线业务可以安全地接受来自海外客户的实时

信用卡支付，同时让他们可以选择用商户基本货币或持卡人的本国货币支付商品和服务。这个支付过程

允许商户以持卡人的本国货币显示交易的价格。

动态货币转换 (DCC) 将会按照汇率将持卡人本国货币转换为基础货币。然后,客户可以选择一种货币用

来支付 .

交易流程

PayDollar (DCC)

从基础货币转换为持卡人本国

货币

例如. RMB -> USD

商户

商户页面基础货币价格

例如. RMB

收单银行

收单银行处理过程中持卡人本

国货币

例如. USD

商户

商户以基础货币结算

例如. RMB

客户选择已支持的货币支付(RMB (base) 或 USD )

例如. 客户使用其国家 USD

汇率提供者

提供汇率

例如. RMB/USD

PayDollar 汇率


动态货币转换（DCC）样板交易示例

DCC 选择页面：

支付结果页面：


6 商家 API 功能

API 功能简介

总共提供四个功能:

- 预授权完成

- 撤销已经接受的支付

- 对已接受的支付请求退款

- 查询交易状态

要连接到我们系统, 你需要从 HTML 窗体 POST 请求参数到我们的商户 API 网页，然后取回从该网页处

理结果. 你可以通过服务器端的 HTML 发布.

- 测试环境的网址:

https://test.paydollar.com/b2cDemo/eng/merchant/api/orderApi.jsp

- 生产环境的网址:

https://www.paydollar.com/b2c2/eng/merchant/api/orderApi.jsp

另外会有一组登陆 ID 和密码分配到你的商户账号用于访问 API 功能。你可以通过发送电子邮件或者直

接联系我们取得它。

https://test.paydollar.com/b2cDemo/eng/merchant/api/orderApi.jsp

https://www.paydollar.com/b2c2/eng/merchant/api/orderApi.jsp


预授权支付

此功能的目的是完成预授权付款


输入/返

回

参数（粗体为必填字

段）

*区分大小写

数据类型默认值描述

输入 merchantId Number 我们向您提供的商家代号

loginId Text (30)

loginId 用于商户 API

password Text (15) Password 用于商户 API

actionType “Capture” 动作类型

payRef Text (35) 付款参考编号

amount Number

(12,2)

您完成预授权的交易金额 (必须小

于或等于原始金额，以小数点后两

位数表示)

返回

resultCode Number {“0”,”-1”} 0 – 请求成功

-1 – 请求失败

orderStatus Text(20) 成功后新的订单状态

ref Text 商户订单引用参考编号

payRef Number PayDollar 交易参考

amt Number

(12,2)

交易金额

cur Number (3) 交易货币

“344” – HKD “840” – USD

“156” – CNY (RMB) “392” – JPY

“036” – AUD “978” – EUR

“124” – CAD “446” – MOP

“764” – THB “458” – MYR

“410” – KRW “682” – SAR

“784” – AED “096” – BND

“356” – INR “702” – SGD

“826” – GBP “901” – TWD

“608” – PHP “360” – IDR

“554” – NZD “704” – VND



使用奖励计划处理的交易的其他输出参数(例如： Hang Seng Cash Dollar)

netAmtAfterRewards Number(12,

2)

兑换奖励计划后的总净额

rewardsRedeemTotalAmt Number(12,

2)

积分兑换总额


“HASE” – Hang Seng Cash Dollar




*仅当 rewardsRedeemProgram 返回

值为 1,2 或 3 时返回




rewardsRedeemAmt1 Number(12,

2)

首次奖励计划兑换金额




格式

过期奖励余额过期日期–过期余额

金额 | 奖励余额过期日期-奖励余

额金额

例如：0115-20.00 | 0120-30.00





值为 2 或 3 时返回




rewardsRedeemAmt2 Number

(12,2)

第二奖赏计划兑换金额





格式


金额| 奖励余额过期日期-奖励余额

金额

例如：0115-20.00 | 0120-30.00





值为 3 时返回



值为 3 时返回


2)

第三奖赏计划兑换金额


值为 3 时返回


格式


金额| 奖励余额过期日期-奖励余额

金额

例如：0115-20.00 | 0120-30.00


值为 3 时返回



resultCode=0&orderStatus=Accepted&ref=Test&payRef=4780&amt=1.0&cur=344&errM

sg=Capture Successfully.

撤销已经接受的支付

此功能的目的是在结算之前撤销已经接受的支付。它只能在结算时间之前使用。


输入/返

回

参数参数（粗体为

必填字段）

*区分大小写




loginId Text (30) loginId 用于商户 API


actionType “Void” 动作类型


返回


-1 – 请求失败




amt Number (12,2) 交易金额


“344” – HKD “840” – USD

“156” – CNY (RMB) “392” – JPY

“036” – AUD “978” – EUR

“124” – CAD “446” – MOP

“764” – THB “458” – MYR

“410” – KRW “682” – SAR

“784” – AED “096” – BND

“356” – INR “702” – SGD

“826” – GBP “901” – TWD

“608” – PHP “360” – IDR

“554” – NZD “704” – VND


所有的返回参数将以 html 请求格式连接，并以＆分隔


resultCode=0&orderStatus=Voided&ref=Test&payRef=4780&amt=1.0&cur=344&errMsg

=Void Successfully.

对已经接受的支付请求退款

此功能的目的是在交易 14 天内对已接受的支付请求退款


输入/返

回

参数(必填字

体是黑体) *区分大小写

参数类型默认值描述





actionType “RequestRefund” 动作类型


(可选输

入)

amount Number (12,2) 您完成预授权的交易金额 (必须小于

或等于原始金额，以小数点后两位数

表示)

返回


-1 – 请求失败






“344” – HKD “840” – USD

“156” – CNY (RMB) “392” – JPY

“036” – AUD “978” – EUR

“124” – CAD “446” – MOP

“764” – THB “458” – MYR

“410” – KRW “682” – SAR

“784” – AED “096” – BND

“356” – INR “702” – SGD

“826” – GBP “901” – TWD

“608” – PHP “360” – IDR

“554” – NZD “704” – VND


所有的返回参数将以 html 请求格式连接，并以＆分隔


resultCode=0&orderStatus=RequestRefund&ref=Test&payRef=4780&amt=1.0&cur=344

&errMsg=Request successfully and we will process it later.

查询付款状态

此功能的目的是用 XML 根据商户参考编号或者付款参考编号查询付款状态


输入 / 参数数据类型默认值描述


返回 (粗体为必填字段) *区分大小写




actionType “Query” 动作类型



返回 orderStatus Text(20) 成功后新的订单状态



mpsMode Text(3) 多货币处理服务 (MPS)

模式:

“NIL” 或不提供 – 关闭 MPS (没有货币转换)

“SCP” – 启用 MPS

‘简单货币转换’

“DCC” – 启用 MPS

‘动态货币转换’

“MCP” – 启用 MPS

‘多货币计价’

amt Number

(12,2)

交易金额


“344” – HKD “840” – USD

“156” – CNY (RMB) “392” – JPY

“036” – AUD “978” – EUR

“124” – CAD “446” – MOP

“764” – THB “458” – MYR

“410” – KRW “682” – SAR

“784” – AED “096” – BND

“356” – INR “702” – SGD

“826” – GBP “901” – TWD

“608” – PHP “360” – IDR

“554” – NZD “704” – VND

prc Number 主要响应码

src Number 次要响应码

ord Number 银行参考– 订单号


holder Text 支付账号的持有人姓名

sourceIp Text (15) 付款人的 IP 地址

ipCountry Text (3) 付款人的国家( 如香港)

-如果付款人所在国家在高风险国家列表中, 应标

上星号(如 MY*)

payMethod Text (10) 付款方式

(例如 VISA, Master, JCB, Diners, AMEX)

cardIssuingCountry Text (3) 发卡国家编码 ( 例如 HK)

-如果国家在高危国家列表中存在,会有

* 作为显示 (例如 MY*)

-如果发卡国家没定义，则会显示 “- -“

详情请参考附录 A “国家编码列表”

airline_ticketNumber Text 机票号码


txTime Text

(YYYY-MM-

DD

HH:MI:SS.0

)

交易时间

successcode Number 0- 成功, 1- 失败, 其他– 错误

*仅返回订单状态为“已接受”，“已授权”，“已拒绝”

remark Text (200) 一个备注字段，供您存储不会在交易网页上显示的

其他数据

authId Text 批准代码

eci Text (2) ECI 值(适用于启用３Ｄ的商家)

VISA / JCB / AMEX

ECI 值定义


认证成功







交易处理

MasterCard

ECI 值定义



交易处理







认证成功

备注：当交易被 PayDollar PayAlert 拒绝或交易不

具有 ECI 值时，将发送字符串值“null”。

payerAuth Text (1) 付款人身份验证状态:

Y - 卡已进行 3-D 安全注册，身份验证成功。

N - 卡已进行 3D 安全注册，但身份验证失败。

P - 3-D 安全检查正待处理

A - 卡尚未进行 3D 安全注册

U - 不处理 3D 安全检查。

channelType Text (3) 通道类型：

SPC –通过浏览器Post

DPC –直接客户端连接

DPS –服务器端直接连接

SCH –定期付款

DPL –直接付款链接连接

MOT – Moto连接

RTL – RetailPay连接

BPP –批量付款流程

MOB –移动支付连接

MerchantId Number 交易商编号

alertCode Text (50) 警报代码

例如 R14 –IP 国家与签发国不匹配

R 9-在高风险国家清单中

卡信息的附加输出参数

expMonth Text (MM) 卡的有效期月份


expYear Text (YYYY) 卡的有效期年份




panFull Text 带有 AES256 加密的加密 PAN







panLast4 Text (4) 卡的最后 4 位数字


accountHash Text 卡的哈希值


accountHashAlgo Text 卡的哈希功能：

SHA-1


使用 MPS VAS 进行交易处理的其他输出参数

mpsAmt Number

(12,2)

MPS 交易金额


mpsCur Text (3) MPS 交易货币


mpsForeignAmt Number

(12,2)

MPS 交易国外金额


mpsForeignCur Text (3) MPS 交易外币


mpsRate Number

(12,4)

MPS 汇率：（外币/基础）

例如美元/港元= 7.77


使用 SchedulePay VAS 进行交易处理的其他输出参数

mSchPayId Number 主要定期付款 ID


dSchPayId Number 次要定期付款 ID


使用 MemberPay VAS 进行交易处理的其他输出参数

mpMemberId Text 会员 ID，如果商家使用 memberPay

通过第三方电子钱包进行交易处理的其他输出参数

isEwallet Text(1) “T” – 这是具有 Ewallet 功能的交易

eWalletBrand Text ECO - AMEX Express checkout

MP – MasterPass

VCO – VISA Checkout

使用 Promopay VAS 处理交易的附加输出参数

promotionCode Text(8); 促销活动的交易代码

*仅限促销交易

promotionRuleCode Text(8); 交易促销规则代码

*仅限促销交易


promotionOriginalAmt Number

(12,2)

原价促销

*仅限促销交易

分期付款交易的其他输出参数

installment_period Number 分期付款（以月数计）

installment_provider Text 分期付款的开证行或提供方

“ HASE” – 恒生银行（香港）

“BOCIHK” – 中国银行（香港）

“ BCA”- 中亚银行（印度尼西亚）

“ WELEND” – WeLend（香港）

installment_firstPayAmt Number 第一期的交易金额


installment_eachPayAmt Number 每个分期的交易金额


installment_lastPayAmt Number 上一期的交易金额


使用奖励计划处理的交易的其他输出参数（例如：Hang Seng Cash Dollar）

netAmtAfterRewards Number(12,

2)

兑换奖励计划后的总净额

rewardsRedeemTotalAmt Number(12,

2)

积分兑换总额


“HASE” –Hang Seng Cash Dollar




*仅当 rewardsRedeemProgram 返回值为 1,2 或 3

时返回



时返回


2)

首次奖励计划兑换金额


时返回


格式

过期奖励余额过期日期–过期余额金额 | 奖励余额

过期日期-奖励余额金额


例如：0115-20.00 | 0120-30.00


时返回


*仅当 rewardsRedeemProgram 返回值为 2 或 3 时

返回



返回

rewardsRedeemAmt2 Number

(12,2)

第二奖赏计划兑换金额


返回


格式

过期奖励余额过期日期–过期余额金额| 奖励余额


例如：0115-20.00 | 0120-30.00


返回






2)

第三奖赏计划兑换金额



格式

过期奖励余额过期日期–过期余额金额| 奖励余额


例如：0115-20.00 | 0120-30.00


所有返回参数将为 XML 格式

返回 XML 文件示例：

<records>

<record>

<orderStatus>Accepted</orderStatus>


<ref>Test</ref>

<payRef>1390545</payRef>

<mpsMode>NIL</mpsMode>

<amt>1</amt>

<cur>344</cur>

<prc>0</prc>

<src>0</src>

<ord>00004295104</ord>

<holder>Holder Name</holder>

<authId>123456</authId>

<alertCode>R14</alertCode>

<remark>Test</remark>

<eci>05</eci>

<payerAuth>Y</payerAuth>

<sourceIp>202.65.133.23</sourceIp>

<ipCountry>HK</ipCountry>

<payMethod>VISA</payMethod>

<panFull>4918914107195005</panFull> or

<panFirst4>4918</panFirst4>

<panLast4>5005</panLast4>

<expMonth>07</expMonth>

<expYear>2015</expYear>

<cardIssuingCountry>HK</cardIssuingCountry>

<channelType>SPN</channelType>

<txTime>2014-07-01 00:00:00.0</txTime>

<accountHash></accountHash>

<accountHashAlgo></accountHashAlgo>

<mpsAmt></mpsAmt>

<mpsCur></mpsCur>

<mpsForeignAmt></mpsForeignAmt>

<mpsForeignCur></mpsForeignCur>

<mpsRate></mpsRate>

<installment_period></installment_period>

<installment_provider></installment_provider>

<installment_firstPayAmt></installment_firstPayAmt>

<installment_eachPayAmt></installment_eachPayAmt>

<installment_lastPayAmt></installment_lastPayAmt>

<airline_ticketNumber></airline_ticketNumber>

<successcode>0</successcode>

<mSchPayId></mSchPayId>

<dSchPayId></dSchPayId>

<MerchantId>123456</MerchantId>

<promotionCode></promotionCode>

<promotionRuleCode></promotionRuleCode>

<promotionOriginalAmt></promotionOriginalAmt>

<mpMemberId></mpMemberId>

<isEWallet>T</isEWallet>

<eWalletBrand>EOC</eWalletBrand>

<panFirst6></panFirst6>

<errMsg>Query Successfully</errMsg>

</record>



</records>


查询请求日志

此功能的目的是查询付款请求日志。


输入/返

回

参数参数（粗体为

必填字段）

*区分大小写



loginId Text (30)



actionType “QueryRequ

estLog”

动作类型

(可选输

入)


(可选输

入)

periodType Text (1) 周期类型：

M – 按月查询

D – 按天查询

(可选输

入)

queryDate Number(8) 查询时间格式：

MMYYYY - 周期类型为月

DDMMYYYY – 周期类型为天

返回 requestDate Date 交易请求日期

sessionId Number 交易的 sessionID

ref Number(15) 商户参考编号

cur Number (3) 交易货币：

“344” – HKD “840” – USD

“156” – CNY (RMB) “392” – JPY

“036” – AUD “978” – EUR

“124” – CAD “446” – MOP

“764” – THB “458” – MYR

“410” – KRW “682” – SAR

“784” – AED “096” – BND

“356” – INR “702” – SGD

“826” – GBP “901” – TWD

“608” – PHP “360” – IDR

“554” – NZD “704” – VND



payerIp Text(15) 付款人的 IP 地址

ipCountry Text(3) 付款人所在的国家/地区（例如香港）

-如果国家/地区位于高风险国家/地

区列表中，则会显示星号（例如 MY *）

deviceBrowser Text(50) 设备浏览器

deviceOS Text(50) 设备操作系统

deviceMoblie Text(1) 设备移动

channelType Text(5) 通道类型

SPN-通过浏览器发布客户

SPV-通过浏览器发布客户

DPS-直接服务器端

DPC-直接客户端

pageCode Text(10) page 付款页面的代码

CPF-付款选择页

CPF2-信用卡输入页面

CPV-3D 验证页面

CPVR-3D 验证结果页面

CPC-结果页

DPC-付款处理

DPR-结果跳转页面

CPFD-DCC 选择页面

全部参数将会以 XML 格式返回

返回 XML 文件示例：

<records>

<record>

<requestDate>2016-01-20 10:17:19</requestDate>

<sessionId>1135335</sessionId>

<ref>Test</ref>

<cur>344</cur>

<amt>1</amt>

<payerIp>192.168.77.28</payerIp>

<ipCountry/>

<deviceBrowser>Chrome</deviceBrowser>

<deviceOS/>

<deviceMoblie>F</deviceMoblie>


取消支付

该功能的目的是取消“ Pending_feedback”中交易状态的付款。此功能仅支持以下付款方式。

支持“取消”操作的付款方式：

BCA-KLIKPAY, BCA-VA, BRI-EPAY, CIMB-CLICKS, MANDIRI-CLICKPAY 和 PERMATA-VA


输入/返

回

参数（粗体为必填

字段）

*区分大小写





actionType “Cancel” 动作类型


返回


-1 – 请求失败

orderStatus Text (20) 成功后新的订单状态




cur Number (3) 交易货币：

“344” – HKD “840” – USD

“156” – CNY (RMB) “392” – JPY

“036” – AUD “978” – EUR

“124” – CAD “446” – MOP

“764” – THB “458” – MYR

“410” – KRW “682” – SAR

“784” – AED “096” – BND

“356” – INR “702” – SGD

“826” – GBP “901” – TWD

“608” – PHP “360” – IDR

“554” – NZD “704” – VND



返回字符串样本：


resultCode=0&orderStatus=Rejected&ref=Test&payRef=4888&amt=1.0&cur=344&errM

sg=Cancel Successfully.


结算报告请求

此功能的目的是生成结算报告


输入/返

回

参数（粗体为必填

字段）

*区分大小写



loginId Text (30)



startDate Number(14) DDMMYYYY

hhmmss

报告开始时间

endDate Number(14) DDMMYYYY

hhmmss

报告结束时间

(可选输

入)

queryType Text(1) O/S 报告类型：

O-使用授权或销售交易的日期/时间

来生成报告（默认）

S-使用结算交易的日期/时间来生成

报告，并且仅查询结算标志为 T

的交易

返回

authdate Number(14) 授权或销售交易的日期/时间

capturedate Number(14) 预（授权后）交易的日期/时间

batchid Number(15) 结算批次编号

settledate Number(14) 结算交易的日期/时间

payref Number (14) 付款平台中的唯一编号

merref Text(30) 商户参考编号

authid Text(6) 批准码

cur Number 银行返回的状态码 2

amt Number(12,2) 交易金额

orderstatus Text 付款帐户的持有人名称

terminal Text(100) 银行终端机 ID

bankmid Text(100) 银行商户编号

settleflag boolean {“T”,”F”} 是否解决

src Text 次要响应码

prc Text 主要响应码

bank Text 示例：CITIBANK,PPS

bankref Text 银行参考号

traceno Text 系统跟踪号

currency Text 订单币种

remark Text 订单备注


originalamt Number(12,2) 原始交易金额

测试平台 URL:

https://test.paydollar.com/b2cDemo/GenTxnXML

生产平台 URL:

https://www.paydollar.com/b2c2/GenTxnXML

所有返回参数将为 XML 格式

返回 XML 文件样本：

<?xml version=”1.0” encoding=’UTF-8”?>

<reports>

<report>

<authdate>24092005223000</authdate>

<capturedate>24092005230000</capturedate>

<batchid>123456</batchid>



</report>



</reports>

https://test.paydollar.com/b2cDemo/GenTxnXML

https://www.paydollar.com/b2c2/GenTxnXML


服务器端 JAVA 编写的 HTML 示例源代码

由于不同的语言有不同的语法, 所以我们只提出方法连接我们的支付页面.我们建议你使用服务器端连

接。

使用Java的服务器端代码：

// 建立 POST 数据

String postData =

"merchantId=1&loginId=testing&password=pwd&payRef=123456&actionType=Capture&amount=

1&”;

// POST 到支付页面

strResult = ServerPost.post(postData,

http://test.paydollar.com:8080/b2cDemo/eng/merchant/api/orderApi.jsp );

// 从 STRRESULT 提取付款状态

………

// 完成

************************************************************************

public class ServerPost

{

static public String post( String ip_postData, String ip_pageUrl)

{

try

{

String strResult = "";

URL url = new URL(ip_pageUrl);

URLConnection con = url.openConnection(); //from secure site

if(con instanceof com.sun.net.ssl.HttpsURLConnection){

((com.sun.net.ssl.HttpsURLConnection)con).setSSLSocketFactory

((SSLSocketFactory)SSLSocketFactory.getDefault());

}

con.setDoOutput(true);

con.setDoInput(true);

// 设置 request headers content 类型和长度


"Content-type",

"application/x-www-form-urlencoded");



"Content-length",

String.valueOf(ip_postData.length()));

// 发出 Post 请求

OutputStream outStream = con.getOutputStream();

outStream.write(ip_postData.getBytes());

outStream.flush();

//读取应答

InputStream inStream = con.getInputStream();

while (true)

{

int c = inStream.read();

if (c == -1)

break;

strResult = strResult + String.valueOf((char)c);

}

inStream.close();

outStream.close();

return strResult;

}

catch (Exception e)

{

System.out.print(e.toString());

return null;

}

}

}

*此文档中的所有原始程序代码归联款通（香港）有限公司所有。任何使用、修改和改编代码的行

为应上报联款通（香港）有限公司并经联款通（香港）有限公司批准。联款通（香港）有限公司对

使用原始程序代码造成的另一方损失不负任何责任。


7 异常交易处理

除了成功的交易以外，本部分还说明了可能发生的其它各种交易。

A) 返回链接失败

可能的原因是：

1.返回链接 URL 安装错误;

2. PayDollar 与商家服务器之间断开连接 ;

3.任何一方的服务器不能正确处理返回链接。

既然银行已确定交易状态，交易结束。商家可通过以下两方面确认交易状态：

1. 登录“商家管理”服务器并在“交易明细报表”中取回相应的交易数据；

2. 通过使用商家 API 询问交易状态。

B) 跳转至 successUrl / failUrl / cancelUrl 失败


1. 集成中设置了错误 /不合理的被返回 URL;

2. 客户与商家的服务器之间断开连接 ;

3. 客户的计算机死机/重启/断电.

既然银行已确定交易状态，交易结束。商家应告知客户当此类事情发生时与商家联系并确认交易状态。

C) 客户进行的不完整 3D 认证交易


1. 当要求客户在发卡银行网页上输入 3D 认证信息时，客户关闭了浏览器;

2. 由于各种原因，客户不能进入发卡银行的 3D 认证页面，如关闭 cookie 功能。

交易状态保持在“Pending_3D”，且付款人认证状态保持在“P”。在 PayDollar 产品中，安装了一项调度功

能，其能不时的将状态从“Pending_3D”改变为“Rejected”。PRC / SRC 相对地被更新到 3 / 9999。调度功

能还可以为这些失败的交易发送返回链接。

有时，客户可能通过按下浏览器的“返回”按钮返回 PayDollar 支付页面重试。这些重试交易使用的是相

同的商家参考号。这样，商家会收到多个具有相同商家参考号的交易的返回链接，但是只有一个成功，

后面的交易都会失败。一旦系统处理了一个成功的交易之后，商家可选择忽略那些具有相同商家参考号

的失败交易。

D) 客户进行的不完整的 99BILL / ALIPAY / CHINAPAY / PPS / TENPAY / SCB / BAY /


KTB / UOB / TMB / BBL iBanking / UPOP / M2U / CIMBCLICK / WECHAT 交易

可能的原因是

1. 当要求客户在各自网站上输入 99BILL / ALIPAY / CHINAPAY / PPS / TENPAY / WECHAT 账号信息

时，客户关闭了浏览器;

2. 由于各种原因，客户不能进入 99BILL / ALIPAY / CHINAPAY / PPS / TENPAY / WECHAT / SCB / BAY /

KTB / UOB / TMB / BBL iBanking / UPOP 页面, 如 cookies 失效或 99BILL / ALIPAY / CHINAPAY /

PPS / TENPAY / SCB / BAY / KTB / UOB / TMB / BBL iBanking / UPOP 主机出现网络故障。

交易状态保持在“Pending”。在生成环境中，一项调度功能安装在我方服务器中，可不时的将状态从

“Pending”改变为“Rejected”。调度功能还可以为这些失败的交易发送返回链接。

有时，客户可能通过按下浏览器的“返回”按钮返回 PayDollar 支付页面重试。这些重试交易使用的是相

同的商家参考号。

这样，商家会收到多个具有相同商家参考号的交易的返回链接，但是只有一个成功，后面的交易都会失

败。一旦系统处理了一个成功的交易之后，商家可选择忽略那些具有相同商家参考号的失败交易。


8 PaySDK iOS 移动端 SDK

本节说明 PaySDK iOS SDK 在商户 iOS 移动应用程序中的集成。商家必须向 AsiaPay 提供 Apple AppSD

包 ID 和 android 应用程序 ID。 PaySDK 将共享与商家相关的唯一 RSA 公钥。

A) SDK 集成步骤：

SDK 要求

Swift 版本: 4.0

iOS 版本: 10.0

SDK 配置

将 AP_PaySDK.framework 文件添加到您的项目中，在构建阶段添加依赖项/使用库链接二进制文件:

添加 “AP_PaySDK” 框架

或者

CocoaPods 是 Cocoa 项目的依赖项管理器。有关使用和安装说明，请访问其网站。要使用 CocoaPods

将 PaySDK 集成到 Xcode 项目中，请在 Podfile 中指定它：

pod ‘AP_PaySDK’

SDK 初始化

使用以下属性在应用程序中创建 paysdk.plist 文件 RSA 公钥（SDK_RSA_Publickey）：在这里，您需

要指定不带头和尾的 RSA 公钥。该值将在商家应用 SDK 服务时提供。

示例

注意：属性文件及其属性的命名必须相同。

1. 将 SDK 导入类

导入 AP_PaySDK

注意-由于 iOS9.0中 http 上的 App Transport Security（ATS）的限制，我们需要在以下位置为

paydollar.com，xecure3d.com，pesopay.com，siampay.com，alipay.com，alipayobjects.com 添加额

外信息清单


<key>NSAppTransportSecurity</key>

<dict>

<key>NSExceptionDomains</key>

<dict>

<key>paydollar.com</key>

<dict>

<key>NSIncludesSubdomains</key>

<true/>

<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>

<true/>

<key>NSTemporaryExceptionMinimumTLSVersion</key>

<string>TLSv1.0</string>

<key>NSTemporaryExceptionRequiresForwardSecrecy</key>

<false/>

</dict>

<key>xecure3d.com</key>

<dict>


<true/>


<true/>




<false/>

</dict>

<key>pesopay.com</key>

<dict>


<true/>


<true/>




<false/>

</dict>

<key>siampay.com</key>


<dict>


<true/>


<true/>




<false/>

</dict>

<key>alipay.com</key>

<dict>


<true/>


<true/>




<false/>

</dict>

<key>alipayobjects.com</key>

<dict>


<true/>


<true/>




<false/>

</dict>

</dict>

</dict>

或商家可以通过以下方式禁用 ATS

<key>NSAppTransportSecurity</key>


<dict>

<key>NSAllowsArbitraryLoads</key><true/>

</dict>

2. 添加 PaySDK 协议的实现–

class ViewController: UIViewController , PaySDKDelegate

3. 实例化 PaySDK 类

var paySDK = PaySDK.shared

4. 设置 paySDK 委托

paySDK.delegate = self

B) WebView 支付调用

准备支付调用：

初始化 PayData 类，并为交易准备付款明细。

paySDK.paymentDetails = PayData(

channelType: PayChannel.WEBVIEW,

payGate: PayGate.PAYDOLLAR,

envType: EnvType.SANDBOX,

merchantId: "1",

payType: payType.NORMAL_PAYMENT,

orderRef: "2018102409220001",

payMethod: "VISA",

lang: Language.ENGLISH,

currCode: Currency.HKD,

amount: 10,

remark: "",

extraData: [:])

触发付款：

调用 SDK 触发付款过程。对于 WebView 流，它将显示用于付款的应用程序内 Webview。

paySDK.process()

准备响应处理程序：

初始化付款事件处理程序以捕获付款响应和结果。

func paymentResult(result: PayResult) {


}

WebView 例子:

C) 直接支付调用


初始化 PayData 类和卡详细信息，然后为交易准备支付详细信息。


channelType: PayChannel.DIRECT,


amount : “10”,


currCode: currencyCode.HKD,


orderRef: "2018102409220001”,

payMethod: "VISA",


merchantId: "1",


remark: "",

extraData :[:])

paySDK. paymentDetails.cardDetails = CardDetails(

cardHolderName: “abc abc”,

cardNo: "4918914107195011”,

expMonth: “11”,

expYear: “2011”,

securityCode: “123”)

触发支付：


paySDK.process()




}

D) 分期支付调用


对于分期付款，请初始化 PayData 类，并与 Webview 和 Direct Payment Call 中一样，为交易准备付款明

细，并添加以下参数。

extraData: [

"installment_service " : "T",

"installment_period": 3,

"installOnly": "T"]

E) 计划支付调用

对于计划支付，请初始化 PayData 类，并与 Webview 和 Direct Payment Call 中一样，为交易准备付款明

细，并添加以下参数。

extraData: [


"appId" : "SP",

"appRef" : "2018102409220001",

"schType" : "Day",

"schStatus" : "Active",

"nSch" : "1",

"sMonth" : "4",

"sDay" : "26",

"sYear" : "2019",

"eMonth" : "",

"eDay" : "",

"eYear" : "",

"name" : "Name",

"email" : "[email protected]"]

F) 会员支付调用

对于新会员：

对于会员支付付款，初始化 PayDATA 类，并准备交易的支付细节，与 WebVIEW 和直接支付调用相同，

并添加下面的参数。添加参数 AdvEngEnter。如果商家第一次付款，那么值应该为 true。

extraData: [

"addNewMember": true,

"memberPay_service": "T",

"memberPay_memberId": "MPTEST_1",

"memberId":"MPTEST_1”]

对于老会员：

对于会员付款，请初始化 PayData 类，并与 Webview 和 Direct Payment Call 中一样，为交易准备付款细

节，并添加以下参数。添加参数 addNewMember。如果商家不是第一次付款，则值应为 false，以下

为额外参数。

extraData: [

"addNewMember": false,

"memberPay_service": "T",

"memberPay_memberId": "MPTEST_1",


"memberId":"MPTEST_1",

"token":"8de18f7b17fabe5bb682e792e319c0e411b528f58926"]

G) 促销支付

对于 Promo Pay Payment，与 Webview 和 Direct Payment Call 中一样，初始化 PayData 类并为交易准备

付款细节，并添加以下参数。

extraData: [

"promotion ": "T",

"promotionCode ": "TEST1",

"promotionRuleCode " : " TESTR25",

"promotionOriginalAmt ":""]

H) Alipay 全球支付调用

初始化步骤：

1. 在 info.plist 文件中添加 url 类型

2. 在 appdelegate 文件中添加

var paySDK = PaySDKClass.shared

And

func application(_ app: UIApplication, open url: URL, options:

[UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {

paySDK.processOrder(url: url)

return true;

}

准备付款调用：

初始化PayDATA类并准备交易的支付细节。





amount: 0.1,




orderRef: "2018102409220001",

payMethod: "ALIPAYAPP",


merchantId: "1",

remark: "test",

extraData : [:])

触发付款:

调用 SDK 触发付款过程

paySDK.process()

如果应用程序安装在设备上，则在 appdelegate openurl 函数中获取响应




return true;

}


初始化支付事件处理程序以捕获支付响应和结果。


}

I) Alipay 香港支付调用

初始化步骤：





And




return true;

}






amount: 0.1,




orderRef: "2018102409220001",

payMethod: "ALIPAYHKAPP",


merchantId: "1",

remark: "test",

extraData : [:])

触发付款:

调用 SDK 触发支付过程。

paySDK.process()

如果 app 安装在设备上，则在 AppDelegate openurl 函数中获取响应。




return true;

}





}

此方法返回 PayResult 类的对象。

J) Alipay 中国支付调用

初始化步骤：




And




return true

}

准备付款通知：





amount: 0.1,




orderRef: "2018102409220001",

payMethod: "ALIPAYCNAPP",



merchantId: "1",

remark: "test",

extraData : [:])

触发付款:

调用 SDK 触发支付过程。

paySDK.process()

如果 app 安装在设备上，则在 AppDelegate openurl 函数中获取响应。




return true;

}




}


K) 3DS 2.0 支付调用






amount : “10”,




orderRef: "2018102409220001”,

payMethod: "3DS2.0",


merchantId: "1",

remark: "",

extraData :[:])

paySDK. paymentDetails.cardDetails = CardDetails(

cardHolderName: “abc abc”,

cardNo: "4918914107195011”,

expMonth: “11”,

expYear: “2011”,

securityCode: “123”)

var threeDSParams = ThreeDSParams()

threeDSParams.apiUsername = "username"

threeDSParams.apiPassword = "password"

.

.

.

.

.

.

.

.

.

paySDK.paymentDetails.threeDSParams = threeDSParams


触发付款:


paySDK.process()




}

List of Parameters merchant can set

apiUsername threeDSAcctCreateDate

apiPassword threeDSAcctAgeInd

threeDSCustomerEmail threeDSAcctLastChangeDate

threeDSDeliveryEmail threeDSAcctLastChangeInd

threeDSMobilePhoneCountryCode threeDSAcctPwChangeDate

threeDSMobilePhoneNumber threeDSAcctPwChangeInd

threeDSHomePhoneCountryCode threeDSAcctPurchaseCount

threeDSHomePhoneNumber threeDSAcctCardProvisionAttempt

threeDSWorkPhoneCountryCode threeDSAcctNumTransDay

threeDSWorkPhoneNumber threeDSAcctNumTransYear

threeDSBillingCountryCode threeDSAcctPaymentAcctDate

threeDSBillingState threeDSAcctPaymentAcctInd

threeDSBillingCity threeDSAcctShippingAddrLastChangeDate

threeDSBillingLine1 threeDSAcctShippingAddrLastChangeInd

threeDSBillingLine2 threeDSAcctIsShippingAcctNameSame

threeDSBillingLine3 threeDSAcctIsSuspiciousAcct

threeDSBillingPostalCode threeDSAcctAuthMethod

threeDSShippingDetails threeDSAcctAuthTimestamp

threeDSShippingCountryCode threeDSDeliveryTime

threeDSShippingState threeDSPreOrderReason

threeDSShippingCity threeDSPreOrderReadyDate

threeDSShippingLine1 threeDSGiftCardAmount

threeDSShippingLine2 threeDSGiftCardCurr

threeDSShippingLine3 threeDSGiftCardCount


通过3DS 2.0付款的挑战类型

• 挑战信息文本框

• 单选和多选字段

• Out of Band

• HTML

UI-定制商人挑战视图

UI 的 paySDK 自定义

商家可以在 paySDK 初始化过程中添加 UiCustomization。

let customization = UiCustomization()

let submitButtonCustomization = ButtonCustomization.init("Courier", "#FF0000", 15,

"#d3d3d3", 4)

let resendButtonCustomization = ButtonCustomization.init("Courier", "#FF0000", 15,

"#d3d3d3", 4)

let cancelButtonCustomization = ButtonCustomization.init("Courier", "#FF0000", 15,

"#d3d3d3", 4)

let nextButtonCustomization = ButtonCustomization.init("Courier", "#FF0000", 15,

"#d3d3d3", 4)

工具栏自定义

标签自定义-标头

标签定制

自定义文本框

按钮自定义-提交

按钮自定义-重新发送

按钮自定义-取消


let continueButtonCustomization = ButtonCustomization.init("Courier", "#FF0000", 15,

"#d3d3d3", 4)

let labelCustomization = LabelCustomization.init("Courier", "FF0000", 14, "FF0000",

"Courier", 20)

let textboxCustomization = TextBoxCustomization.init("Courier", "#FF0000", 14, 5,

"#d3d3d3", 4)

let toolBarCustomization = ToolbarCustomization.init("Courier", "#FF0000", 12,

"#d3d3d3", "HEADER_LABEL")

try! customization.setButtonCustomization(submitButtonCustomization, .SUBMIT)

try! customization.setButtonCustomization(resendButtonCustomization, .RESEND)

try! customization.setButtonCustomization(cancelButtonCustomization, .CANCEL)

try! customization.setButtonCustomization(nextButtonCustomization, .NEXT)

try! customization.setButtonCustomization(continueButtonCustomization, .CONTINUE)

try! customization.setLabelCustomization(labelCustomization)

try! customization.setTextBoxCustomization(textboxCustomization)

try! customization.setToolbarCustomization(toolBarCustomization)

paySDK.customization = customization


类 PayData 属性的详细信息：

输入参数期望值和说明

channelType 通道类型 (PayChannel) – WebView

payGate 支付网关的名字即 Paydollar 或 Pesopay 或 Siampay

envType 生产或沙盒

merchantId 在 Asiapay 商家门户上注册后收到的 ID

payType 付款方式 (Normal / Hold)

orderRef 商家要附加到交易的参考号

payMethod 付款方式 ID-有关详细值，请参阅《集成指南》

lang 付款页面语言

currency 交易货币，例如 HKD, INR 等

amount 交易金额

remark 有关标记交易的更多详细信息。这是可选的。

extraData 额外参数

对于分期支付

installment_service –分期付款服务指示器，即 T / F

installment_period –月数

installOnly –控制分期付款的强制性，即 T / F

对于计划支付

appId-应用程序 ID

appRef-appref 是整个计划工资的参考，仅可用于一张时间卡。Holder-卡上可用的名称

schType-计划类型，例如日月年

schStatus-计划状态，例如 Active / Suspended

nSch-时间表数

sMonth-计划开始月份

sDay-计划开始日期

sYear-计划开始年

eMonth-计划结束月

eDay-计划结束日期

eYear-计划结束年度

对于会员付费

addNewMember – false 或 true

memberPay_service-T 或 F


memberPay_memberId-会员编号

actionType-生成令牌

memberId-会员 ID

memberPay_Token –静态令牌

对于促销支付

促销–促销服务指标，即 T 或 F

PromotionCode –促销活动代码

PromotionRuleCode-促销规则代码（可选）

PromotionOriginalAmt-促销原始金额（可选）

EnvBase 类的值详细信息：

EnvBase 参数值和说明

PayChannel SDK 支付渠道

WEBVIEW: WebView 重定向付款

DIRECT: 直接服务器付款

PayGate SDK 支持的支付网关

PAYDOLLAR: PayDollar

SIAMPAY: SiamPay

PESOPAY: PesoPay

EnvType SDK 环境配置

PRODUCTION: 生产环境

SANDBOX:沙箱测试环境

PayType SDK 付款类型

NORMAL_PAYMENT:销售付款

HOLD_PAYMENT: 授权付款

Currency SDK 支持的货币列表

HKD, USD, SGD, RMB, JPY, TWD, AUD, EUR, GBP, CAD, MOP, PHP, THB, MYR, IDR, KRW, BND, NZD,

SAR, AED, BRL, INR, TRY, ZAR, VND, DKK, ILS, NOK, RUB, SEK, CHF, ARS, CLP, COP, CZK, EGP,

HUF, KZT, LBP, MXN, NGN, PKR, PEN, PLN, QAR, RON, UAH, VEF, LKR, KWD


类 PayResult 属性的详细信息：

PayResult 输出属性

参数

描述

successcode 交易状态。

channel 通道类型（EnvBase.PayChannel）– WebView，Direct

resultCode 交易状态码。

resultMsg 消息，用于描述有关交易状态的更多信息。如果事务状态为“Success”，则该消息可能

为空白。

orderID AsiaPay 系统生成的订单 ID

orderRef 在初始化 PayData 对象中的付款呼叫之前设置的订单参考号。

bankRef 银行订单参考编号

prc 主要回应码，请参阅《集成指南》附录 A (PRC)

src 次要回应码，请参阅《集成指南》附录 A (SRC)

txTime 交易时间

amount 交易金额

currency 交易货币，例如 HKD, INR 等

extraData 额外响应数据


9 PaySDK Android 移动端 SDK

本节介绍 PaySDK 与 iOS SDK 在商家 android 移动应用程序中的集成。

A) SDK 集成步骤：

SDK 要求

JAVA SDK 版本:：1.8

Android SDK 版本：19 (Minimum), 28 (Target)

SDK 配置

• 将 PaySDK-1.0.0.aar 复制到 libs 文件夹。

• 在项目的 gradle 文件中添加以下行：

repositories {

flatDir {

dirs 'libs'

}

}

• 在依赖项的下面添加以下行到项目的 gradle 文件中：

implementation(name: 'PaySDK-1.0.0', ext: 'aar')

• 添加以下库

implementation fileTree(dir: 'libs', include: ['*.jar'])

implementation 'com.google.code.gson:gson:2.3.1'

implementation 'org.bouncycastle:bcprov-jdk15on:1.60'

implementation 'com.android.volley:volley:1.1.1'

implementation 'com.fasterxml.jackson.core:jackson-core:2.7.3'

implementation 'com.fasterxml.jackson.core:jackson-annotations:2.7.3'

implementation 'com.fasterxml.jackson.core:jackson-databind:2.7.3'

implementation 'org.greenrobot:eventbus:3.0.0'

SDK 初始化:

使用以下属性在 assets 文件夹中创建 paysdk.properties 文件

RSA 公钥（SDK）：-在这里，您需要通过删除公钥的头和尾来指定 RSA 公钥值。该值将在商家应用 SDK

服务时提供。


示例：

sdk_rsa_publickey=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA3hOz7Ekyf9YLDJ

RzUxJSeFfAxjIW/8Kd8v+tKK/Tc+3KyOHADlV7NYtlGDyoH5dCApUGHrxaYbzV6VzhC+kgQIaL7m

jzMXX2uK03QT8Gmcef4C20fUMpy3hrIRH5MR32THNI3IiQG7upkuKhwQSwvEz0PxTeIznCBvSY/7

wgCC6CUhHt+INZYaYpNRiozy39+yHXvgJu4N+I7VQpXJ6b4QjARk6nq6dBlUge4HokZgQzfKL86P

JfzOjIDDKABkbZcZ96AL48E1jvgXlqV0ZA2k81IEVQzJxEiuERcPpSTXzB9H3f8+sx8DWxUO/CDI

iNI+XOt54sBMelPEFQgEjkCQIDAQAB

注意：属性文件及其属性的命名必须相同。

1. 声明 SDK 的对象

PaySDK paySDK;

2. 在除主 UI 线程之外的后台任务中初始化 SDK。为此，创建一个 asyn 任务。对于3D Secure 2.0

事务，在某些情况下 ACS 可以要求提供更多详细信息以验证用户身份。因此，根据从 ACS 接

收到的数据，SDK 启动一个屏幕来处理向用户的质询用户界面。

商家可以通过将与 UI 相关的信息（如文本–字体大小，字体名称等）放入 UiCustomisation 对象

中来自定义此 UI。

private class initaliseSDK extends AsyncTask<String, Void, String> {

@Override

protected String doInBackground(String... params) {

Factory factory = new com.asiapay.sdk.integration.xecure3ds.Factory();

paySDK = new PaySDK(getApplicationContext());

return "";

}

@Override

protected void onPostExecute(String result) {

//Cancel ProgressDialog if displayed before initializing sdk

}

@Override

protected void onPreExecute() {

//show progress dialog if want

}

@Override

protected void onProgressUpdate(Void... values) {

}

}


3. 调用上述异步任务:

new initaliseSDK().execute("");

B) WebView 支付调用



PayData payData = new PayData();

payData.setChannel(EnvBase.PayChannel.WEBVIEW);

payData.setEnvType(EnvBase.EnvType.SANDBOX);

payData.setAmount("10");

payData.setPayGate(EnvBase.PayGate.PAYDOLLAR);

payData.setCurrCode(EnvBase.Currency.HKD);

payData.setPayType(EnvBase.PayType.NORMAL_PAYMENT);

payData.setOrderRef("2018102409220001");

payData.setPayMethod("VISA");

payData.setMerchantId("1");

payData.setRemark("");

payData.setLang(EnvBase.Language.ENGLISH);

paySDK.setRequestData(payData);



paySDK.responseHandler(new PaymentResponse() {

@Override

public void getResponse(PayResult payResult) {

}

@Override

public void onError() {

}

});

触发付款：


paySDK.process();


WebView 例子:

避免内存泄漏：

在这里，所有未使用的对象都将设置为 null 并清理 payData 和 payResult 对象。

paySDK.cleanMemory();

C) 直接支付调用



初始化 PayData 类和卡详细信息，然后为交易准备支付详细信息。

payData = new PayData();

payData.setChannel(EnvBase.PayChannel.DIRECT);







payData.setPayMethod("VISA");



payData.setRemark(" ");

CardDetails cardDetails=new CardDetails();

cardDetails.setCardNo("4548890133258926");

cardDetails.setEpMonth("08");

cardDetails.setEpYear("2020");

cardDetails.setSecurityCode("123");

cardDetails.setCardHolder("test Card");

payData.setCardDetails(cardDetails);





@Override


}

@Override


}

});

触发支付：

调用 SDK 触发付款过程。


paySDK.process();

D) 分期支付调用

对于使用 Webview 和直接付款调用进行的分期付款，请按照（1.1 和 1.2）重复相同的过程。并在下面

添加额外的参数。

extraData.put("installment_service","T");

extraData.put("installment_period","6");

extraData.put("installOnly","T");

E) 计划支付

对于使用 Webview 和直接付款调用进行的计划付款，请遵循相同的过程（1.1 和 1.2）。并在下面添加

额外的参数

extraData.put("schType","Day"); // Value could be Day/Month/Year

extraData.put("schStatus","Active"); // Value could be Active/Suspend

extraData.put("nSch","1");

extraData.put("sMonth","4");

extraData.put("sDay","26");

extraData.put("sYear","2019");

extraData.put("eMonth","");

extraData.put("eDay","");

extraData.put("eYear","");

extraData.put("name","Name");

extraData.put("email","[email protected]");

extraData.put("appId","SP");

extraData.put("appRef","2018102409220001"); //appRef should be used only once

F) 会员支付

对于新会员:

对于会员付款，请初始化 PayData 类，并与 Webview 和 Direct Payment Call 中一样，为交易准备付款

细节，并添加以下参数。添加参数 addNewMember。如果商家是第一次付款，则该值应为 true


extraData.put("memberPay_service","T");

extraData.put("memberPay_memberId","member03");

extraData.put("addNewMember","True");

对于老会员:

对于会员付款，请初始化 PayData 类，并与 Webview 和 Direct Payment Call 中一样，为交易准备付款细

节，并添加以下参数。添加参数 addNewMember。如果商家不是第一次付款，则值应为 false，以下

为额外参数。

extraData.put("memberPay_service","T");

extraData.put("memberPay_memberId","member03");

extraData.put("addNewMember","False");

extraData.put("memberPay_token","7ff6c7cc1f03fd9889b000843a77e8f43e4467578926");

G) 促销支付

对于使用 Webview Call 的 Promo Pay 付款，请遵循（1.1）的相同过程并添加以下额外参数。

extraData.put("promotion","T");

extraData.put("promotionCode","TEST1");

extraData.put("promotionRuleCode","TESTR25");

extraData.put("promotionOriginalAmt","");

H) Alipay 全球支付调用

SDK 整合步骤：

1) 将 alipaySdk-15.5.9-20181123210601.aar 复制到 lib 文件夹中。

2) 在 app 的 gradle 文件中添加如下依赖项:

implementation(name: 'alipaySdk-15.5.9-20181123210601', ext: 'aar')

implementation "com.squareup.okhttp3:okhttp:3.12.0"

发起 Alipay 订单付款：

要启动订单付款，我们需要实例化 PayReq 类并通过将与付款相关的数据传递给此方法来调用公共方法

pay（）。

Step 1: 准备包含详细信息以初始化付款的对象。










payData.setPayMethod("ALIPAYAPP");



payData.setRemark("payment remark");

payData.setActivity(MainActivity.this);





@Override


}

@Override


}

});


触发付款：


paySDK.process();

I) Alipay 香港支付调用












payData.setPayMethod("ALIPAYHKAPP");









@Override


}

@Override


}

});


触发付款：


paySDK.process();

J) Alipay 中国支付调用








payData.setCurrCode(EnvBase.Currency.RMB);




payData.setPayMethod("ALIPAYCNAPP");









@Override


}

@Override


}

});


触发付款：


paySDK.process();

K) 3DS 2.0 支付调用




payData = new PayData();








payData.setPayMethod("3DS2.0");



payData.setRemark(" ");

CardDetails cardDetails=new CardDetails();

cardDetails.setCardNo("4548890133258926");

cardDetails.setEpMonth("08");

cardDetails.setEpYear("2020");

cardDetails.setSecurityCode("123");

cardDetails.setCardHolder("test Card");

payData.setCardDetails(cardDetails);

ThreeDSParams threeDSParams = new ThreeDSParams();

threeDSParams.setUsername(“username”);

threeDSParams.setUsername(“password”);

.

.

.

.

.

.

.

payData.setThreeDSParams(threeDSParams);





@Override



}

@Override


}

});

触发付款：


paySDK.process();

List of Parameters merchant can set

apiUsername threeDSAcctCreateDate

apiPassword threeDSAcctAgeInd

threeDSCustomerEmail threeDSAcctLastChangeDate

threeDSDeliveryEmail threeDSAcctLastChangeInd

threeDSMobilePhoneCountryCode threeDSAcctPwChangeDate

threeDSMobilePhoneNumber threeDSAcctPwChangeInd

threeDSHomePhoneCountryCode threeDSAcctPurchaseCount

threeDSHomePhoneNumber threeDSAcctCardProvisionAttempt

threeDSWorkPhoneCountryCode threeDSAcctNumTransDay

threeDSWorkPhoneNumber threeDSAcctNumTransYear

threeDSBillingCountryCode threeDSAcctPaymentAcctDate

threeDSBillingState threeDSAcctPaymentAcctInd

threeDSBillingCity threeDSAcctShippingAddrLastChangeDate

threeDSBillingLine1 threeDSAcctShippingAddrLastChangeInd

threeDSBillingLine2 threeDSAcctIsShippingAcctNameSame

threeDSBillingLine3 threeDSAcctIsSuspiciousAcct

threeDSBillingPostalCode threeDSAcctAuthMethod

threeDSShippingDetails threeDSAcctAuthTimestamp

threeDSShippingCountryCode threeDSDeliveryTime

threeDSShippingState threeDSPreOrderReason

threeDSShippingCity threeDSPreOrderReadyDate

threeDSShippingLine1 threeDSGiftCardAmount

threeDSShippingLine2 threeDSGiftCardCurr

threeDSShippingLine3 threeDSGiftCardCount

通过3DS 2.0付款的挑战类型


• 挑战信息文本框

• 单选和多选字段

• Out of Band

• HTML

UI-定制商人挑战视图

UI 的 paySDK 自定义

商家可以在 paySDK 初始化过程中添加 UiCustomization。

private class initaliseSDK extends AsyncTask<String, Void, String> {

@Override

protected String doInBackground(String... params) {

Factory factory = new com.asiapay.sdk.integration.xecure3ds.Factory();

ConfigParameters configParameters = factory.newConfigParameters();

UiCustomization uiCustomization = factory.newUiCustomization();

paySDK = new PaySDK(AuthActivity.this, configParameters, uiCustomization);

return "";

}

}

工具栏自定义

标签自定义-标头

标签定制

自定义文本框

按钮自定义-提交

按钮自定义-重新发送

按钮自定义-取消


类 PayData 属性的详细信息：

输入参数值和说明

setChannel 通道类型 (EnvBase.PayChannel) – WebView, Direct

setPayGate 支付网关的名字即 Paydollar 或 Pesopay 或 Siampay

setEnvType 生产或沙盒

setMerchantID 在 Asiapay 商家门户上注册后收到的 ID

setPayType 付款方式 (Normal / Hold)

setOrderRef 商家要附加到交易的参考号

setPayMethod 付款方式 ID-有关详细值，请参阅《集成指南》

setLang 付款页面语言

setCurrency 交易货币，例如港元，印度卢比等

setAmount 交易金额

setAddNewMember 如果商家是第一次付款，则值应为 true，否则为 false

setActivity 调用支付宝的 Activity 类的引用。

setRemark 有关标记交易的更多详细信息。这是可选的。

setExtraData 额外参数

对于分期支付

installment_service –分期付款服务指示器，即 T / F

installment_period-月数

installOnly-控制分期付款的强制性，即 T / F

对于计划支付

对于会员支付

memberPay_service – MemberPay 服务指标，即 T / F

memberPay_memberId –会员 ID

addNewMember –true/false

对于促销支付

促销–促销服务指标，即 T / F

PromotionCode –促销活动代码

PromotionRuleCode-促销规则代码（可选）

PromotionOriginalAmt-促销原始金额（可选）

附表工资

appId-应用程序 ID


appRef-appref 是整个计划工资的参考，将仅使用一次

schType-日程安排类型可以是日/月/年

schStatus-计划状态可以为 Active/Suspend

nSch-时间表数

sMonth-计划开始月份

sDay-计划开始日期

sYear-计划开始年

eMonth-计划结束月

eDay-计划结束日期

eYear-计划结束年度

EnvBase 类的值详细信息：

EnvBase 参数值和说明

PayChannel SDK 支付渠道

WEBVIEW: WebView 重定向付款

DIRECT: 直接服务器付款

PayGate SDK 支持的支付网关

PAYDOLLAR: PayDollar

SIAMPAY: SiamPay

PESOPAY: PesoPay

EnvType SDK 环境配置

PRODUCTION: 生产环境

SANDBOX:沙箱测试环境

PayType SDK 付款类型

NORMAL_PAYMENT:销售付款

HOLD_PAYMENT: 授权付款

Currency SDK 支持的货币列表

HKD, USD, SGD, RMB, JPY, TWD, AUD, EUR, GBP, CAD, MOP, PHP, THB, MYR, IDR, KRW, BND, NZD,

SAR, AED, BRL, INR, TRY, ZAR, VND, DKK, ILS, NOK, RUB, SEK, CHF, ARS, CLP, COP, CZK, EGP,

HUF, KZT, LBP, MXN, NGN, PKR, PEN, PLN, QAR, RON, UAH, VEF, LKR, KWD


类 PayResult 属性的详细信息：

PayResult 输出属性

参数

描述

getSuccesscode 交易状态。

getChannel 通道类型（EnvBase.PayChannel）– WebView，Direct

getResultCode 交易状态码。

getResultMsg 消息，用于描述有关交易状态的更多信息。如果事务状态为“Success”，则该消息可能

为空白。

getOrderID AsiaPay 系统生成的订单 ID

getOrderRef 在初始化 PayData 对象中的付款呼叫之前设置的订单参考号。

getBankRef 银行订单参考编号

getPrc 主要回应码，请参阅《集成指南》附录 A (PRC)

getSrc 次要回应码，请参阅《集成指南》附录 A (SRC)

getTxTime 交易时间

getAmount 交易金额

getCurrency 交易货币，例如 HKD, INR 等

getExtraData 额外响应数据

getOutTradeNo 支付宝的交易号，以供参考。


10 疑难排解

系统安装

1. 在此集成中支持哪些编程语言?

HTML, ASP, PHP, JSP / Servlet, 以及支持 HTTP 协议的任何其它的服务器端指令码语言.

2. 商家服务器端的防火墙有什么需要考虑的问题吗?

商家必须打开 HTTP 端口以处理返回链接，即端口 80（HTTP）/端口 443（HTTPS）。

3. PayDollar PayGate 支持所有购物车软件吗?

技术上来说，可以。可是，需要您知道如何配置购物车软件满足自己的需要。示例包括

OSCommerce。

常见问题

4. 系统整合期间，我遇见了错误提示信息 “您的支付服务未启动.”

确定是否您使用的商家代号和集成 URL 相对应。

如果您正在使用 TESTING URL (test.paydollar.com)，应使用 6 位数或 8 位数的 TESTING 商家代号。

如果您正在使用 PRODUCTION URL (www.paydollar.com)，应使用 PRODUCTION 商家代号，通常

来说它是 4 位数或 8 位数。

5. 系统整合期间，我遇见了错误提示信息 “CurrCode 不正确.”

一个 PayDollar 商家代号只允许使用一种货币。确定您正在使用与商家代号相对应的货币种类

（HTML 格式）。若要使用多种货币，请联系我们的销售人员，申请额外的商家账户。

6. 我能自己调用 successUrl / failUrl / cancelUrl 来测定交易状态吗?

客户可能调用浏览器中的 successUrl / failUrl / cancelUrl (附有商家参考号) 并假设交易完成。这样，

我们建议商家使用返回链接来测定交易状态。因为只有 PayDollar 方和商家知道返回链接 URL，所

以使用返回链接系统来测定状态是很安全的。

7. Ref (orderRef)、PayRef 和 Ord 三个参数有什么不同?

Ref (orderRef)是商家自己的订单参考号。它来自于商家的数据库或发票。

PayRef 是 PayDollar 的订单参考号。它是 PayDollar 系统中每个商家每份订单独有的号码.

Ord 是银行的订单参考号。它由收单银行给出。

如果要寻求交易说明，请向我们提供 PayRef (优先) 或 Ref。

返回链接

8. 如何使用返回链接系统?

您可以利用返回链接系统中 PayDollar 传递的数据来更新关于交易的数据库记录。因为商家参考号

可从返回链接系统中取回，所以您可以利用这一点来更新您系统的相应交易记录。

9. 如何在我的商家账户中安装返回链接系统?

您可以在商户管理后台>商户资料>支付选项打开或者关闭返回链接功能.

http://www.oscommerce.com/

http://www.paydollar.com/


10. 我如何知道是否已正确安装了返回链接系统?

您可以去查看商家管理网站的详细交易内容，选择输出栏“返回链接指示符“以及“返回链接返回”并

查看交易记录。如果返回链接指示符为“T”，返回链接系统安装正确。但是，如果指示符为“F”，您

可以查看“返回链接返回”一栏，看看出现什么错误。当进行返回链接系统安装时，您可以求助于我

们的技术人员。

除此之外，您能启用商家管理网站 > 简介 > 支付选项中的“电子邮件发送返回链接故障告警”。当

启用它时，如果调用商家的返回链接系统出现故障，向商家的技术服务联系电子邮件账户发送电子

邮件。

11. 书写返回链接页面时用何种程序设计语言?

任何可处理 HTTP Post 请求参数的程序设计语言都可以用。

12. 我如何书写返回链接页面? 返回链接页面应该在屏上什么都显示吗？

返回链接页面包括 3 部分，接收 HTTP 参数，打印‘OK’以及您自己的后端处理 (如升级数据库、向

客户发送电子邮件等。)。

可在后端调用返回链接页面。它不会显示什么，即无 HTML 代码。但是它会对“OK”进行应答，

让我们的服务器知道您已经成功接收了返回链接。

13. 我如何确定正在从 PayDollar 调用返回链接系统?

您可以检查是否正在从这些 IP 地址范围中调用返回链接 HTTP 请求。

测试环境: 202.64.244.236 – 202.64.244.237

正式使用环境: 203.105.16.160 – 203.105.16.191

14. 出现返回链接错误返回

“javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException:

No trusted certificate found”

我们的服务器不能识别您的 SSL 证书供货商。请联系我们的技术人员解决这些问题。如果有必要，

会要求您提供您的认证中心根证书。

15. 返回链接自动重试失败

（适用于已注册返回链接链接和重试功能的商家）

有时，由于互联网连接问题，使用的返回链接 URL 错误等原因，您可能无法接收返回链接响应。

启用“失败的返回链接自动重试”后，将重新发送返回链接：

（1）在原始尝试失败之后立即进行；

（2）如果（1）也失败，则在 15 分钟后进行。

3D 安全认证

16. 在设计我们自己的网站时，我能使用 FRAMES 吗?

当在其 3D 认证页面上输入时，一些发卡银行要求有 Cookie。这种情况下需要整个页面( 即无边框)。

而且，SSL 指示符应显示在浏览器窗口的某处，让客户知道此网站很安全，可以输入保密性信息，


如信用卡卡号。当使用 FRAMES 时，如果页面所需 SSL 在边框窗口内部，SSL 指示符不会出现。

因此，建议将 HTML 表格提交给 PayDollar 之后，不要使用 FRAMES。您可以考虑打开另一个浏览

器窗口处理各个支付交易。

17. 我能为自己的交易关闭“3D-认证”功能吗?

这由银行单独做出决定。可能您需要提供营业信息，目的是说明银行风险管理小组在特殊审批之前

对您公司的情况进行评估。但是，您应该清楚地了解欺诈性非 3D 交易的严重后果。

数据安全

18. 我可以储存客户的信用卡信息吗?

我们建议商家“不要“储存信用卡信息，尤其是信用卡卡号、有效日期以及 CVV2 / CVC2。即使绝对

需要，也请确保根据 Visa A.I.S. (账户信息安全)的要求进行数据加密。您可以参考以下的网页:

http://www.visa-asia.com/ap/sea/merchants/riskmgmt/ais_what.shtml. 储存在 PayDollar 中

的信用卡信息均符合 Visa A.I.S.和 MasterCard SDP 的要求。

技术支持

19. 在软件测试和生成期间，如果遇到问题，我们如何联系?

您可以通过下列任何一种方式联系我们的技术人员：

a. 电子邮件：[email protected]

b. 技术热线：(852) – 82267981 (852) – 31731990

http://www.visa-asia.com/ap/sea/merchants/riskmgmt/ais_what.shtml

mailto:[email protected]


附录 A

传款易付款响应代码

传款易付款响应代码由下列部份组成 :

1. 主要响应代码 (PRC)

主要响应代码是用于识别支付交易的授权状态的主要响应代码。

下表提供了可能返回的所有响应代码的摘要：

PRC Description

0 成功

1 被付款银行拒绝

3 付款人认证失败 (3D)

-1 参数传输不正确

-2 服务器访问错误

-8 被传款易内部/防欺诈检查拒绝

-9 主机访问错误


2. 次要响应代码 (SRC)

次要响应代码为主要响应代码提供详细的描述,与主要响应代码相对应.

响应代码列表

银行的响应代码

PRC SRC 描述

1 01 被银行拒绝


1 03 其它

1 04 其它


1 12 其它

1 13 其它

1 14 输入错误

1 19 其它

1 25 其它

1 30 其它

1 31 其它

1 41 报失卡/被盗卡

1 43 报失卡/被盗卡


1 54 输入错误

1 55 其它

1 58 其它

1 76 其它

1 77 其它

1 78 其它

1 80 其它

1 89 其它

1 91 其它

1 94 其它

1 95 其它

1 96 其它

1 99 其它

1 2000 其它


传款易响应代码

PRC SRC 描述

-8 999 其它

-8 1000 跳过交易

-8 2000 黑名单错误

-8 2001 系统的黑名单卡

-8 2002 商户的黑名单卡

-8 2003 系统的黑 IP

-8 2004 商户的黑 IP

-8 2005 无效的持卡人姓名

-8 2006 同一张卡一天使用 6 次以上

-8 2007 重复的商户参考编号

-8 2008 商户参考编号为空

-8 2011 其它

-8 2012 卡验证失败

-8 2013 卡已经注册

-8 2014 高危国家

-8 2016 同一天同一个付款 IP 超过预定次数.

-8 2017 卡号码不正确

-8 2018 多卡尝试

-8 2019 发卡行不匹配

-8 2020 超过单笔交易限制

-8 2021 超过日交易限制

-8 2022 超过月交易限制

-8 2023 无效的通道类型

-8 2099 非测试卡

-8 2031 系统拒绝(TN)

-8 2032 系统拒绝(TA)

-8 2033 系统拒绝(TR)

-8 2035 商家定义的黑名单付款卡国家/地区

-8 2037 商家定义的黑名单付款人国家/地区

-8 2039 商家要求的特殊国家限制

-8 2041 分期无效

-8 2043 未验证成员

-8 2045 优惠券代码无效

-8 2047 被用户取消

-8 2049 由于未完成 EWallet 流程而拒绝

-8 2050 分期付款卡无效


-8 2051 无效的到期日期

-8 2053 取消交易

-8 2054 被 3D 设置拒绝

-8 2055 发卡和付款人 IP 国家/地区不匹配

RC Description


其它响应代码

PRC SRC 描述

0 0 成功

3 任何号码付款人认证失败

-1 -1 输入参数错误

-2 -2 服务器访问出错

-9 -9 主机访问出错

国家编码列表

下列列表展示个别国家名称和其危险级别.

Country Code Country Name High risk

A2 卫星电视供货商

AD 安道尔

AE 阿拉伯联合酋长国

AF 阿富汗

AG 安提瓜和巴布达

AI 安圭拉

AL 阿尔巴尼亚

AM 亚美尼亚

AN 荷属安的列斯

AO 安哥拉

AP 亚洲/太平洋地区

AQ 南极洲

AR 阿根廷

AS 美属萨摩亚

AT 奥地利

AU 澳大利亚

AW 阿鲁巴

AZ 阿塞拜疆

BA 波斯尼亚和黑塞哥维那

BB 巴巴多斯

BD 孟加拉国国

BE 比利时


BF 布基那法索

BG 保加利亚 **

BH 巴林

BI 布隆迪

BJ 贝宁

BM 百慕达

BN 文莱

BO 玻利维亚

BR 巴西

BS 巴哈马

BT 不丹

BV 布维岛

BW 博茨瓦纳

BY 白俄罗斯

BZ 伯利兹

CA 加拿大

CD 刚果

CF 中非共和国

CG 刚果

CH 瑞士

CI 科特迪瓦

CK 库克群岛

CL 智利

CM 喀麦隆 **

CN 中国

CO 哥伦比亚

CR 哥斯达黎加

CU 古巴

CV 佛得角

CY 塞浦路斯

CZ 捷克共和国

DE 德国

DJ 吉布提

DK 丹麦

DM 多米尼加

DO 多米尼加共和国

DZ 阿尔及利亚


EC 厄瓜多尔

EE 爱沙尼亚

EG 埃及 **

ER 厄立特里亚

ES 西班牙

ET 埃塞俄比亚

EU 欧洲

FI 芬兰

FJ 斐济

FK 福克兰群岛（马尔维纳斯）

FM 密克罗尼西亚

FO 法罗群岛

FR 法国

GA 加蓬

GB 联合王国

GD 格林纳达

GE 格鲁吉亚

GF 法属圭亚那

GH 加纳 **

GI 直布罗陀

GL 格陵兰

GM 冈比亚 **

GN 几内亚

GP 瓜德罗普岛

GQ 赤道几内亚

GR 希腊

GT 危地马拉

GU 关岛

GW 几内亚比绍

GY 圭亚那

HK 香港

HM 赫德岛和麦当劳群岛

HN 洪都拉斯

HR 克罗地亚

HT 海地

HU 匈牙利

ID 印度尼西亚 **


IE 爱尔兰

IL 以色列 **

IN 印度

IO 英属印度洋领地

IQ 伊拉克

IR 伊朗 **

IS 冰岛

IT 意大利

JM 牙买加

JO 约旦

JP 日本

KE 肯尼亚

KG 吉尔吉斯斯坦

KH 柬埔寨

KI 基里巴斯

KM 科摩罗

KN 圣基茨和尼维斯

KP 朝鲜

KR 韩国

KW 科威特

KY 开曼群岛

KZ 哈萨克斯坦

LA 老挝人民民主共和国

LB 黎巴嫩

LC 圣卢西亚

LI 列支敦士登

LK 斯里兰卡

LR 利比里亚

LS 莱索托

LT 立陶宛 **

LU 卢森堡

LV 拉脱维亚

LY 阿拉伯利比亚民众国

MA 摩洛哥 **

MC 摩纳哥

MD 摩尔多瓦

MG 马达加斯加


MH 马绍尔群岛

MK 马其顿

ML 马里

MM 缅甸

MN 蒙古

MO 澳门

MP 北马里亚纳群岛

MQ 马提尼克岛

MR 毛里塔尼亚

MS 蒙特塞拉特

MT 马耳他

MU 毛里求斯

MV 马尔代夫

MW 马拉维

MX 墨西哥

MY 马来西亚 **

MZ 莫桑比克

NA 纳米比亚

NC 新喀里多尼亚

NE 尼日尔

NF 诺福克岛

NG 尼日利亚 **

NI 尼加拉瓜

NL 荷兰

NO 挪威

NP 尼泊尔

NR 瑙鲁

NZ 新西兰

OM 阿曼

PA 巴拿马

PE 秘鲁

PF 法属波利尼西亚

PG 巴布亚新几内亚

PH 菲律宾

PK 巴基斯坦 **

PL 波兰

PR 波多黎各


PS 巴勒斯坦领土

PT 葡萄牙

PW 帕劳

PY 巴拉圭

QA 卡塔尔

RE 留尼汪

RO 罗马尼亚 **

RU 俄罗斯联邦 **

RW 卢旺达

SA 沙特阿拉伯

SB 所罗门群岛

SC 塞舌尔

SD 苏丹

SE 瑞典

SG 新加坡

SI 斯洛文尼亚

SK 斯洛伐克

SL 塞拉利昂

SM 圣马力诺

SN 塞内加尔

SO 索马里

SR 苏里南

ST 圣多美和普林西

SV 萨尔瓦多

SY 阿拉伯叙利亚共和国

SZ 斯威士兰

TC 特克斯和凯科斯群岛

TD 乍得

TF 法国南部领土

TG 多哥

TH 泰国

TJ 塔吉克斯坦

TK 托克劳

TM 土库曼斯坦

TN 突尼斯

TO 汤加

TR 土耳其 **


TT 特里尼达和多巴哥

TV 图瓦卢

TW 台湾

TZ 坦桑尼亚

UA 乌克兰 **

UG 乌干达

UM 美国本土外小岛屿

US 美国

UY 乌拉圭

UZ 乌兹别克斯坦

VA 罗马教廷（梵蒂冈城国）

VC 圣文森特和格林纳丁斯

VE 委内瑞拉

VG 维京群岛

VI 维京群岛

VN 越南 **

VU 瓦努阿图

WF 瓦利斯和富图纳群岛

WS 萨摩亚

YE 也门

YT 马约特岛

YU 南斯拉夫 **

ZA 南非

ZM 赞比亚

ZW 津巴布韦

- 完结 -

paydollar paygate administrator user guide · 2020. 7. 13. · paydollar paygate integration guide...

Documents