查询接口

功能概述

商户通过单笔订单查询接口查询首信易支付平台的订单状态

接口地址

https://apis.5upay.com/foreignExchange/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
requestId 订单号 varchar(50) 下单接口传入的订单号requestId M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "100000050", "requestId": "1493799454674", "hmac": "UZYjA/bik4TNL9aYSHajULOJxDSJkFyYfDNFxJxYCG1Zyi 9s16uvSRmj07M3ax76JG6STpWc/kyb36mWmg8X8gduvd39NupWK/zJEr bgYffOmOd6YpmrvTQhbPioxLN8Ras9J9zkL7uQ3cTOaLAHOeAQh7Aps3E FJ8MMh+sY4UwIl25h3PEkbBy2sBoug+ZpgLYDXTULrBY7OQ7cLTczfe5D OxJHLGSMpinHaVFOvQaodR8yZdAygDyfDPm16mKDBBV9NsRsGc0pNXZq +gz0hvTq1dLw+WygTVH8VPFN01bPVHQjxJd3M041kE9ABF/vAP1ExXtSN CevRrAjyyRi4Q==" }

订单查询返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
serialNumber 交易流水号 首信易系统交易流水号
totalRefundCount 已退款次数 已退款次数
totalRefundAmount 已退款金额 已退款金额
orderCurrency 订单币种 见货币列表
orderAmount 订单金额 订单金额,单位为分
remark 备注 下单接口提交的备注信息
payment 支付信息 JSON 见下表,支付信息, 注:支付成功后返回此参数。
foreignExchange 购汇信息 JSON 见下表,购汇信息,注:购汇成功后返回此参数。
clearingOrg 清算机构 NUCC 网联
UNION_PAY 银联
paymentModeAlias 支付方式 B2C 个人网银
B2B 企业网银
UNION_SCANCODE_PAY 银联扫码
EXPRESS_PAY 快捷支付
CREDIT_EXPRESS_PAY 信用卡快捷支付
DEBIT_EXPRESS_PAY 借记卡快捷支付
ALI_SCANCODE_PAY 支付宝扫码支付
WEIXIN_SCANCODE_PAY 微信扫码支付
WEIXIN_OFFICIAL_PAY微信-公众号支付
APPLE_PAY 苹果支付
ALIPAY_WAP_PAY 支付宝-WAP
APP_ALIPAY APP支付宝支付
OFFLINE-P2P 线下银行汇款
realBankSerialNumber 银行流水号 银行流水号
needReview 是否需要审核 true 是 false 否
reviewStatus 审核状态 INIT 待上传
UPLOADED 待审核
CANCEL 取消
SUCCESS 审核通过
REFUSE 审核拒绝
reviewRemark 审核说明 审核拒绝时返回
subOrders 子订单 见子订单表
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

返回参数(payment,支付信息)

参数名称 参数中文名称 参数说明
amount 支付金额 单位:分,1 元=100 分
currency 支付币种 见货币列表
status 支付状态 SUCCESS 成功
FAILED 失败
ERROR 错误
completeDateTime 支付完成时间 支付完成时间
bindCardId 绑卡id 首信易返给商户的绑卡唯一标识

返回参数(foreignExchange,购汇信息)

参数名称 参数中文名称 参数说明
amount 购汇金额 单位:分,1 元=100 分
currency 购汇币种 见货币列表
status 购汇状态 SUCCESS 成功
FAILED 失败
ERROR 错误
listprice 交易牌价 商户牌价
deductionAmount 购汇扣减额 单位:分,1 元=100 分
completeDate Time 购汇完成时间 购汇完成时间

返回参数(subOrders,子订单)

参数名称 参数中文名称 参数说明
requestId 子订单号 子订单号
orderAmount 订单金额 子订单金额,单位:分
serialNumber 子订单流水号 子订单流水号

示例

{ "merchantId": "100000050", "requestId": "1487151097417", "serialNumber": "ba3567eef3f743b2a5282c37b6250bb9", "totalRefundCount": "0", "totalRefundAmount": "0", "orderCurrency": "CNY", "orderAmount": "100", "remark": " 备 注 ", "payment": { "amount": "100", "currency": "CNY", "status": "SUCCESS", "completeDateTime": "2018-05-15 17:40:07" }, "foreignExchange": { "amount": "10", "currency": "USD", "status": "SUCCESS", "listprice": "68916", "deductionAmount": "69", "completeDateTime": "2018-05-15 17:59:31" }, "hmac":"UZYjA/bik4TNL9aYSHajULOJxDSJkFyYfDNFxJxYCG1Zyi9s16uvSRmj07M3ax 76JG6STpWc/kyb36mWmg8X8gduvd39NupWK/zJErbgYffOmOd6YpmrvTQhbPioxLN8Ras9 J9zkL7uQ3cTOaLAHOeAQh7Aps3EFJ8MMh+sY4UwIl25h3PEkbBy2sBoug+ZpgLYDXTULrB Y7OQ7cLTczfe5DOxJHLGSMpinHaVFOvQaodR8yZdAygDyfDPm16mKDBBV9NsRsGc0pNXZq +gz0hvTq1dLw+WygTVH8VPFN01bPVHQjxJd3M041kE9ABF/vAP1ExXtSNCevRrAjyyRi4Q==" }