辅助接口

对账单下载

商户可以通过该接口获取到对账单下载地址,通过该下载地址可以获取到历史支付、退款交易清单。 下载成功后,获取到zip压缩包,压缩包内包含支付、退款交易的csv文件,文件编码格式为UTF-8,若想使用Excel打开可能有乱码问题,解决方案请参考 Excel打开CSV文件

请求参数

参数

类型

必填

描述

bill_date

String(8)

Y

对账单的日期,格式:20180808

响应

参数

类型

必填

描述

prod_mode

String

Y

是否 prod模式,true 是 prod模式,false 是 mock模式

bill_download_url

String

N

对账单下载地址

status

String

Y

当前查询状态,参见 状态 说明

error_code

String

N

错误码,详见 错误

error_msg

String

N

错误描述,详见 错误

error_type

String

N

错误类型,详见 错误

invalid_param

String

N

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

调用示例

Java

Map<String, Object> downloadParam = new  HashMap<String, Object>(1);
downloadParam.put("bill_date", "20191012");
Map<String, Object> download = Bill.download(downloadParam, apikey);
  • 成功响应

{
    "bill_download_url":"http://jarvisfile.oss-cn-shanghai.aliyuncs.com/app-bdef1811-3bad-472f-b76c-90230ad840ed%2Fb0391558-00b2-11ea-a2ee-0242ac110005.zip?Expires=1573282894&OSSAccessKeyId=LTAI6Yzq9tIYS57h&Signature=X57wgKM89ipCs0yqLSVsvElV5b4%3D",
    "status":"succeeded",
    "prod_mode":"true"
}

获取银联云闪付用户标识

银联云闪付 H5 支付的前置接口。 商户在自己的平台上通过银联接口获取用户的授权码后,调用本接口同步换取对应用户在银联体系的用户唯一标识。发起银联云闪付 H5 支付时用户唯一标识 user_identity_id 是必填的请求参数。

请求参数

参数

类型

必填

描述

app_id

String(64)

Y

商户的应用 id

order_no

String(64)

Y

请求订单号,必须是英文、数字或者下划线,保证在商户应用id下唯一

user_auth_code

String(64)

Y

用户授权码

app_up_identifier

String(16)

Y

App 标识,通过用户请求的 userAgent 中 appUpIdentifier 截取获得,银联支付标识的格式为“UnionPay/<版本号> <App 标识>”例如 UnionPay/1.0 Cloudpay ,其中 Cloudpay 即为 App 标识

响应

参数

类型

必填

描述

app_id

String

Y

商户的应用 id

object

String

Y

银联云闪付用户标识,user_identity

prod_mode

String

Y

是否 prod模式,true 是 prod模式,false 是 mock模式

order_no

String

Y

请求订单号,必须是英文、数字或者下划线,保证在商户应用id下唯一

user_identity_id

String

Y

银联云闪付用户唯一标识

status

String

Y

当前查询状态,参见 状态 说明

error_code

String

N

错误码,详见 错误

error_msg

String

N

错误描述,详见 错误

error_type

String

N

错误类型,详见 错误

invalid_param

String

N

当发生参数错误时返回具体的参数名,便于定位错误原因,详见 错误

调用示例

Java

Map<String, Object> unionParam = new  HashMap<String, Object>(4);
unionParam.put("order_no", "20190912");
unionParam.put("app_id", "app_XXXXXXXXX");
unionParam.put("user_auth_code", "user_auth_code");
unionParam.put("app_up_identifier", "app_up_identifier");
Map<String, Object> result = AdapayTools.unionUserId(unionParam, merchantKey);
  • 成功响应

{
    "app_id": "app_XXXXXXXXX",
    "object": "user_identity",
    "order_no": "20190912",
    "prod_mode": "true",
    "user_identity_id": "V1fnnUx1UWSAVNUI+/JVyiF/6bueSTH3eK2cRl5MDUfHj/PzaAynYRg0XpFyBZLX",
    "status": "succeeded"
}