接入准备
接入准备
新建应用
要新建一个应用，请按照以下步骤操作:
- 访问应用创建页面：
- 商户平台创建应用页面地址：https://console.paynicorn.com/#/app/apply
- 路径: 商户平台 > 应用 > 应用申请
- 填写应用信息：填写应用申请页面中的基础信息和业务信息，然后提交。
创建应用
商户应用
商户应用可以是注册商户的一个安卓应用，iOS 应用或者一个 web 应用。
用浏览器打开商户后台，使用第一步注册的账号登陆。
应用创建后会处在测试模式，在测试模式下，您可以使用该应用进行系统的集成和测试工作，该模式下拥有 MOCK 支付方式可以供开发者完成整个支付流程的模拟工作，测试模式下的应用交易有一定限制，当数量耗尽后，您可以在应用详情中重置测试请求数，以便进行进一步测试。
完成测试后，可以将该应用设置成为生产模式，用于发起正式的交易。
填写说明
| 字段名 | 是否必填 | 字段说明 |
|---|---|---|
| 应用名称 | 是 | 商品或服务名称，填写后会在 Paynicorn 收银台上显示相应的名称，用于提示用户购买该商品或服务 |
| 应用类别 | 是 | Paynicorn 使用该字段判断商户提供的商品或服务的类型 |
| 交易支持类型 | 是 | 默认开通收款交易，如业务需要支持退款，授权支付，代付交易，请邮件联系 kailan.ruan@transsion.com |
| 服务端回调地址 | 是 | 服务端后台回调地址，商户的订单状态发生改变后， Paynicorn 会向该地址发送订单的最新状态，商户服务端收到该地址后，需要调用交易查询接口确认下订单的状态 |
| 预计月流水 | 是 | 商户预估的业务月流水金额 |
| 预计对接时间 | 是 | 商户预估的技术对接时间窗口， Paynicorn 会安排专门的技术支持人员协助商户解决对接技术问题 |
| 客户端跳转地址 | 否 | 商户的前端页面地址，提供后， Paynicorn 支付流程完成后，会将浏览器页面重定向到这个地址 |
| 应用ICON | 否 | 商户的产品或服务图标，上传后会在 Paynicorn 收银台上显示相应的图片，用于提示用户购买该商品或服务 |
| GP链接 | 否 | 用户的 Android 应用在 Google Play 上上架的链接，可以加速 Paynicorn 审核过程 |
| Enable Direct Carrier Billing | 否 | 用于打开手机话费支付，默认关闭 |
警告：
Direct Carrier Billing 的渠道费用一般会占到用户支付费用的 30%-70% 左右，这取决于具体的国家和运营商，一般此种支付方式仅用于游戏内的虚拟道具的售卖，对于其他支付场景，打开该支付方式有可能造成资金损失，请谨慎处理！
查看已创建的应用
在你成功提交所填写的信息后，你可以进入“应用列表”来查看你的应用详情。
详细说明
图标 (Icon): 这是你在创建应用时上传的图标。我们推荐你使用你的 app 或 web 应用的 logo。
应用密钥 (appKey): 它是你的 app 或 web 应用在我们平台上的唯一标识，你将需要它来进行交易。
功能: Paynicorn 提供了多种功能，包括收款、退款和代付功能。在创建应用时，建议你根据需求选择相应的功能，未选择的功能将不可使用。
应用状态: 初始状态为“测试模式”，此模式下只能在 Paynicorn 的测试环境中使用。一旦接口对接完成，你可以通过“操作列”中的选项来切换至“生产模式”。切换过程中，不会影响已有的 appkey 和其他配置信息。如果需要变更回调地址，请点击“编辑”按钮。
设置应用回调地址
访问 商户平台应用列表页面 通过以下路径进入：
商户平台 > 应用 > 应用列表
在应用列表中，找到你的应用并进行编辑，进行以下操作：
- 点击 “业务信息” 选项.
- 配置“服务端回调地址”。这个地址是用来接收订单成功状态的通知。订单失败没有回调通知，商户可主动通过交易和充值查询接口获取最终结果。
- 一旦收到后台通知，商户服务端需要先验证回调签名的合法性。
- 签名验证通过后，调用查询交易结果接口来确认订单状态。
获取应用 appkey
appkey 是商户应用的唯一标识符。在调用 Paynicorn API 时，您将需要使用 appkey 来标识您的应用。
请按照以下步骤操作：
- 访问 商户平台应用列表页面.
- 依次点击：商户平台 > 应用 > 应用列表.
- 在应用列表中找到您的应用，然后点击修改。
- 在 “基础信息” 下找到 “appkey” 部分，您可以在此获取到您的
appkey。注意，appkey是用于在 API 调用过程中向 Paynicorn 传递的，它唯一标识了您的应用。
API 接口 IP 地址白名单
访问 商户平台开发者页面 来配置 IP 地址白名单，具体步骤如下：
- 进入商户平台。
- 选择 开发者 菜单。
- 点击 IP地址白名单。
请注意，付款和退款 API 请求将限制可以发起请求的商户服务器 IP 地址。如果您计划接入付款和退款 API 功能，您需要在商户平台开发者页面的 IP 地址白名单中分别设置发起付款和退款的服务器 IP 地址。
获取商户密钥
商户密钥 merchant secret 是 Paynicorn 用于验证商户身份合法性的密钥。每个商户只有一个 merchant secret，在与 Paynicorn 进行 API 调用时，商户服务器需使用该密钥进行请求数据的签名。
警告：
如果您的 merchant secret 被泄露，您应立即在商户平台进行密钥重置。重置后，请更新商户服务端程序所使用的密钥为新的密钥。
访问 商户平台开发者页面 来获取 merchant secret，步骤如下：
- 登录商户平台。
- 点击 开发者 选项。
- 选择 商户密钥 选项。
- 在商户密钥部分找到
merchant secret。