# 调用示例

## 整体接入步骤

第一步:先找运维解析域名

第二步:创建应用提交公钥并获取 app\_id/rsa\_saas\_pub, 配置回调地址;

第三步:用户授权注册, 获取三方商户code;

第四步:通过code获取开放平台访问token;

第五步:访问开放的资源:

## 准备工作 - 获取 appKey 和设置redirectUrl( 回调地址 )

开放平台是基于OAuth2.0协议标准构建的OAuth2.0授权登录系统。 在进行开放平台授权登录接入之前，需要通过管理后台准备以下接入材料:

1. appKey: 用于和开通开放平台的商户UID进行一对一绑定, 获取开放平台登陆权限的必要条件;
2. redirectUrl: 用于完成开放平台开通授权帐号成功后的跳转地址; 该地址根据实际业务需求填写, 如不清楚业务需求, 可默认填写交易所主页;

#### 登陆管理后台: 公共管理-- > 开放平台管理-- > 应用管理

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2FvMmLXldD34SozyW6vq2z%2Fimage.png?alt=media\&token=c4d9f291-32a7-493f-84cc-caed440c81b7)

根据红框中内容, 提交公钥

<figure><img src="https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2F4CTRVCCVk22l6Uuz7qMd%2Fimage.png?alt=media&#x26;token=c30753e7-7810-4b16-bd04-56a3a7b5130f" alt=""><figcaption></figcaption></figure>

#### 用户注册授权 - OAuth授权登录页

带上正确的appkey和redirectUrl点击注册

浏览器访问地址: [http://service.xxx.com/platform/login.html?appKey=xxx\&redirectUrl=https:xxxx](http://platform.apple.com/?appKey=apple_6746\&redirectUrl=https://www.chainup.com)

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2FA3JlgmJm9Hem7SrqSz6n%2Fimage.png?alt=media\&token=caa58015-ef36-4251-bbcf-a0a8bce083dc)

如果没有注册, 先进行注册; 如果已经是注册用户, 则直接点击上一张图片中的"确认授权" 按钮即可;

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2FqYiX0zNPaaFFuwHilKDG%2Fimage.png?alt=media\&token=421ed495-ee4b-49c5-89df-be2464b18070)

系统会发送验证码进行授权;

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2FksCwK3kRnmgBIilRPWyz%2Fimage.png?alt=media\&token=4131e401-b1c3-4b4a-b036-4477befc26b9)

#### 注册( 或登陆 )成功获取code

且在第一步中填写的注册回调地址为交易所首页; 则可以看到下述图片, 箭头处则为当前获取的Code

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2FG2yfGgaVXbAiwxddN7W9%2Fimage.png?alt=media\&token=6dbfc8d6-6c4f-4d5b-89c0-1afbe4ded5fa)

## 获取token - 使用code换取token、openId

#### 调用接口换取token或openId

接口地址: <http://servoce.xfnh.com/platformapi/chainup/open/auth/token>

接口调用成功后, 返回信息会携带token和openId

## 通过Token访问开放平台资源 - 创建订单/支付/查询订单

#### 创建支付订单

接口地址: <http://service.xfnh.fnhcom/platformapi/chainup/open/opay/createThirdOrder>

<mark style="color:red;">**注意!!!**</mark> <mark style="color:red;">**openId 和userId 只能存在一个,如果都同时存在 优先选择openId**</mark>

支付页面

接口地址: <http://service.xfnh.com/pay.html>

#### 获取请求参数:

登陆管理后台: 公共管理-- > 开放平台管理-- > 应用管理

根据图片所示获取请求参数中的userId

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2FyXLf7wmNN3pVchrZnuT0%2Fimage.png?alt=media\&token=86159676-477d-43ba-ac26-25d6ad959efa)

使用POSTMAN工具获取接口调用地址

拼装完参数后的接口调用地址: [https://service.xxx.com/pay.html?appKey=xxx\&openId=xxx\&token=xxx\&orderNum=xxx](https://platform.xxx.com/pay.html?appKey=xxx\&openId=xxx\&token=xxx\&orderNum=xxx)

如果熟悉GET请求的工程师可以直接按照参数拼装地址访问

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2Fhoa4oN2cC0cQyZBi6Sbn%2Fimage.png?alt=media\&token=58c3415d-fb6b-4e70-b6b8-7d7e5a853b63)

#### 调用请求支付页面:

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2F3PmUe0kJA27vFZxsN7xa%2Fimage.png?alt=media\&token=46daf9c8-eef4-4ed4-86b2-fe25736d3656)

#### 余额不足在管理平台充值增币 ( 如果余额充足可忽略该步 )

资产管理-- > 财务管理 -- > 赠币工具

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2FQRFzCpifEfjfikZwd33T%2Fimage.png?alt=media\&token=90fa9f02-f266-46d5-89e9-a29a82454309)

#### 支付成功后跳转的页面( 该页面为第一步配置的 redirectUrl )

![](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2Ft7cB4j3b9XsqlUCvc27w%2Fimage.png?alt=media\&token=a59727be-e2fc-4002-bcfa-2995ea9e43e9)

#### 查询支付订单

接口地址：<http://service.xfnh.com/platformapi/chainup/open/opay/orderDetail>

使用POSTMAN工具获取接口调用地址;

![返回结果即为查询成功后订单信息](https://1243490506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYi2EFgp9ZcuBqz2x3G6F%2Fuploads%2FZJK6xbDKM8IBatu0GCRq%2Fimage.png?alt=media\&token=036b996f-a3cd-442f-a2e3-fb150d9b1f52)
