付款
方法 GETURL
https://xxx.finexusgroup.com/upp/faces/duitnowpaypayment.xhtml?
发送付款请求前，请先从 银行列表 响应中获取 f256_FICode 和 f352_AcqBank。
- 请求参数
- 响应参数
必填字段
| 字段名 | 类型 | 长度 | 描述 | 示例 |
|---|---|---|---|---|
h001_MTI | String | 4 | 消息类型标识符。 | 0880 |
h002_VNO | String | 2 | 版本号。 | 06 |
h003_TDT | String | 8 | 传输日期（YYYYMMDD）。 | 20260824 |
h004_TTM | String | 8 | 传输时间。 | 12432905 |
f001_MID | String | 15 | 商户编号（MID）。 | 120567801561128 |
f003_ProcCode | String | 6 | 处理代码。 | 000000 |
f006_TxnDtTm | String | 14 | 交易日期和时间（YYYYMMDDhhmmss）。 | 20010831124329 |
f007_TxnAmt | String | 12 | 交易金额。 | 000000057080 |
f010_CurrCode | String | 3 | 货币代码。 | 458 |
f019_ExpTxnAmt | String | 1 | 交易金额指数。 | 2 |
f249_TxnCh | String | 3 | 交易渠道。 | WEB |
f253_CntyCode | String | 2 | 国家代码。 | MY |
f256_FICode | String | 20 | 来自银行列表的金融机构代码。 | "RPP" |
f260_ServID | String | 3 | 服务 ID。 | FNX |
f263_MRN | String | 1–40 | 商户参考号。 | 2012121912345 |
f264_Locale | String | 2–5 | 语言区域设置。 | en |
f268_CHName | String | 1–100 | 客户姓名。 | Thomson |
t001_SHT | String | 3 | 安全哈希算法类型。 | SH2 |
t002_SHV | String | 64 | 安全哈希值。附录 1 | E036CA5001C6FA93C827D5EAD5928241 |
可选字段
| 字段名 | 类型 | 长度 | 描述 | 示例 |
|---|---|---|---|---|
f247_OrgTxnAmt | String | 12 | 可选。原始交易金额。若存在 f248_OrgCurrCode 则必填。 | 000000019026 |
f248_OrgCurrCode | String | 3 | 可选。原始货币代码。若存在 f247_OrgTxnAmt 则必填。 | 840 |
f261_HostID | String | 8 | 可选。商户主机 ID。 | AAMWEB02 |
f262_SessID | String | 1–256 | 可选。商户会话 ID。 | 2012121956789 |
f270_ORN | String | 2–34 | 可选。订单参考号。 | ECT01-20010830-00380 |
f271_ODesc | String | 1–256 | 可选。订单描述。 | Digital |
f275_RURL_DD | String | 1–512 | 可选。DD 返回 URL。若省略，响应将返回到同一会话。 | https://xxx/done.jsp |
f276_URL_VMPS | String | 1–512 | 可选。查看商户支付状态 URL。 | https://xxx/view.jsp |
f278_EMailAddr | String | 1–256 | 可选。客户邮箱。 | thomson8899@yahoo.com |
f279_HP | String | 1–20 | 可选。客户手机号。 | 60128888888 |
f285_IPAddr | String | 7–39 | 条件字段。客户 IP 地址（视支付提供方要求而定）。 | 11.11.88.88 |
f287_ExpOrgTxnAmt | String | 1 | 条件字段。原始金额指数。若存在 f247_OrgTxnAmt 则必填。 | 2 |
f352_AcqBank | String | 1–20 | 可选。来自银行列表的收单银行（无缝渠道）。 | "FNXSMYNB" |
f400_AddData | String | 1–400 | 可选。附加数据（使用前需加密；详见网关附录）。 | 1011306170000506|201907 |
f340_MercPromoCde | String | 105 | 可选。商户促销代码。 | CYBERSALES|GIVEME |
f341_MercPromoAmt | String | 65 | 可选。商户促销金额。 | 000000000190|000000000299 |
f342_PromoAmtAcqCst | String | 65 | 可选。促销金额（收单方成本）。 | 000000000100|000000000160 |
f343_PromoAmtMercCst | String | 65 | 可选。促销金额（商户成本）。 | 000000000090|000000000139 |
f363_InvNum | String | 50 | 可选。发票号。 | 123456 |
f364_Fee | String | 257 | 可选。费用（TLV）。 | 017F00103200F0020250 |
必填字段
| 字段名 | 类型 | 长度 | 描述 | 示例 |
|---|---|---|---|---|
h001_MTI | String | 4 | 消息类型标识符。 | 0890 |
h002_VNO | String | 2 | 版本号。 | 06 |
h003_TDT | String | 8 | 传输日期。 | 20260824 |
h004_TTM | String | 8 | 传输时间。 | 12432905 |
f001_MID | String | 15 | 商户编号（与请求相同）。 | 120567801561128 |
f003_ProcCode | String | 6 | 处理代码（与请求相同）。 | 000000 |
f006_TxnDtTm | String | 14 | 交易日期和时间。 | 20120831124329 |
f007_TxnAmt | String | 12 | 交易金额。 | 000000057080 |
f010_CurrCode | String | 3 | 货币代码。 | 458 |
f019_ExpTxnAmt | String | 1 | 交易金额指数。 | 2 |
f254_DDRespCode | String | 2 | 直接借记响应代码。请据此判断结果。 | 00 |
f256_FICode | String | 20 | 金融机构代码。 | PUBLICBANK |
f257_PGRN | String | 20 | 条件字段。支付网关参考号。 | AJ789EG07S0012012022 |
f258_TxnStatDetCde | String | 4 | 交易状态详细代码。 | 0000 |
f260_ServID | String | 3 | 服务 ID。 | FNX |
f263_MRN | String | 1–40 | 商户参考号。 | 2012121912345 |
f270_ORN | String | 2–34 | 条件字段。订单参考号。 | ECT-01-20010830-00380 |
f277_DDRN | String | 30 | 条件字段。直接借记参考号。 | DD200108301234 |
f286_OrgDDRespCode | String | 1–8 | 条件字段。来自金融机构的原始 DD 响应代码。 | 00 |
f407_PayerAccType | String | 10 | 付款人账户类型。 | TBH |
t001_SHT | String | 3 | 安全哈希算法类型。 | SH2 |
t002_SHV | String | 64 | 安全哈希值。附录 1 | ... |
可选字段
| 字段名 | 类型 | 长度 | 描述 | 示例 |
|---|---|---|---|---|
f259_TxnStatMsg | String | 1–256 | 交易状态消息。 | OK |
f261_HostID | String | 8 | 商户主机 ID。 | AAMWEB02 |
f262_SessID | String | 1–256 | 商户会话 ID。 | 2012121956789 |
f269_IssName | String | 1–150 | 捕获的发卡银行名称。 | CITIBANK |
示例消息
- 请求
- 响应
DuitNow Pay 付款请求
curl -X GET \
"https://xxx.finexusgroup.com/upp/faces/duitnowpaypayment.xhtml?h001_MTI=0880&h002_VNO=06&h003_TDT=20260824&h004_TTM=12432905&f001_MID=120567801561128&f003_ProcCode=000000&f006_TxnDtTm=20010831124329&f007_TxnAmt=000000057080&f010_CurrCode=458&f019_ExpTxnAmt=2&f249_TxnCh=WEB&f253_CntyCode=MY&f256_FICode=RPP&f260_ServID=FNX&f263_MRN=2012121912345&f264_Locale=en&f268_CHName=Thomson&f275_RURL_DD=https%3A%2F%2Fwww.megastore.com%2Fdd%2Fdone.jsp&f278_EMailAddr=thomson8899%40yahoo.com&f279_HP=60128888888&f285_IPAddr=11.11.88.88&f352_AcqBank=FNXSMYNB&t001_SHT=SH2&t002_SHV=E036CA5001C6FA93C827D5EAD5928241"
DuitNow Pay 付款响应
https://xxx/done.jsp?h001_MTI=0890&h002_VNO=06&h003_TDT=20260824&h004_TTM=12432905&f001_MID=120567801561128&f003_ProcCode=000000&f006_TxnDtTm=20120831124329&f007_TxnAmt=000000057080&f010_CurrCode=458&f019_ExpTxnAmt=2&f254_DDRespCode=00&f256_FICode=RPP&f257_PGRN=AJ789EG07S0012012022&f258_TxnStatDetCde=0000&f259_TxnStatMsg=OK&f260_ServID=FNX&f263_MRN=2012121912345&f277_DDRN=DD200108301234&f286_OrgDDRespCode=00&f407_PayerAccType=TBH&t001_SHT=SH2&t002_SHV=...