规范概述

范围

本文档对接入币趣支付报文交换技术规范及安全规范进行说明，供商户/渠道合作伙伴的系统分析人员、系统设计人员、系统开发人员及测试人员使用。

本文档分别从接入准备、通讯方式、安全要求、报文结构等角度详细介绍了币趣支付开放 API 接口的工作方式和开发过程，可以帮助开发人员快速接入币趣支付系统，同时也可以作为后续接口参数以及参数类型的速查手册。

本文档版权归币趣支付所有。作为本系统的最终用户，可以拥有该份文档的使用权，但未征得本公司的书面批准，不得向第三方借阅、出让、出版该文档。

1）成为商户

在您注册成为商户之前，需首先确保己注册为币趣钱包用户，并己通过高级认证，否则申请将无法继续。商户申请提交后，等待币趣支付运营人员对商户资质进行审核，确认可信无误后，将为商户开通币趣支付商户权限。

2）技术对接

可以参照币趣支付提供的 API/SDK 及 DEMO 示例完成接口开发，现仅提供 JAVA 版本，其他语言可按照需求自行对接。

3）联调测试

商户联系相关对接人员获取测试相关参数、密钥等，在测试环境进行相关接口联调。

4）正式使用

商户测试完毕确认代码编写无误后，联系币趣支付相关人员获取正式商户编号、配置密钥、接口地址等生产参数，然后约定投产投产时间进行生产验证。

有关币趣支付对接、测试、投产等任何问题，请联系网站客服-技术支持部门。

通过互联网通信，协议为标准 HTTPS 协议，以 POST 方式请求币趣支付网关。HTTPS 使用 HTTP/2 协议，不支持 HTTP/1.1 和 HTTP/1.0 。

1）通过 POST 方式进行提交，除收银台支付外(收银台支付为前台交易，采用表单提交的方式自动跳转到币趣收银台页面)，其他交易报文均使用 JSON 格式（包括异步通知），Content-Type 设置为 application/json；

2）接口中的参数名称和参数说明中规定的固定值必须与接口规范中完全一致（大小写敏感）；

3）提交数据中的空格将被认为是有效字符被接收，请商户开发时注意对多余空格的控制；

4）报文中采用 HMAC-SHA512 签名方式对交易数据进行签名验签，商户需前往商户平台获取及配置密钥。