简介
客户端支持
钱包
SDK
支付
数字货币
退款
Reference
Models

快速接入

只需 3 步,为你的业务快速接入 Payin 数字货币支付服务。

第一步,配置回调接口

你需要在业务服务器中建立一个用于接收支付结果回调的 webhook 接口。在客户完成支付,或者支付失败后,Payin 会通过这个接口通知支付结果。在你正式开发 webhook 业务流程前,可以通过在线工具 (如 requestcatcher.com )创建一个临时 webhook 地址,例如:

http://payin.requestcatcher.com/

在获得 webhook 地址后,通过配置接口设置回调设置。

设置回调接口
应用配置接口

以上示例中,paymentWebhookUrl 是支付回调接口的地址。除此以外,还可以通过配置接口,对 IP 白名单,支付完成重定向,退款回调地址等参数进行设置,详情请参考应用配置。注意,应用配置适用于该应用内的所有支付。

第二步,创建支付

通过调用创建支付 API,告诉 Payin 如何向客人进行收款。你需要提供一些基本信息,包括:收款的货币类型和收款的数量。

创建支付

以上示例中,paymentCurrency 是需要客户支付的货币类型。接口成功调用后,Payin 会返回一个支付对象。其中的 url 是用于向客户展示支付信息的地址。你可以通过网页弹窗或发送邮件等方式引导客户打开该 url。客户打开后,Payin 将引导客户完成支付流程。

你可以通过数字货币接口获取一定数量的测试货币,用于测试和业务调试。

在现实环境中,你可能需要在创建支付的时候提供订单号、重定向地址等更多信息。详细用法请看考创建支付请求部分。

第二步,处理支付结果

当用户完成支付后,Payin 将把支付结果通过 webhook 回传给业务系统。业务系统可根据支付结果引导用户完成业务流程。支付结果对象示例:

{
  "__v": 0,
  "_id": "5b4bf649a493ba002b5ffefa",
  "appId": "0e13a310-0319-4780-bf66-d10788e08d8b",
  "chain": "ETHEREUM",
  "closed": true,
  "confirmedPercentage": 0,
  "createdAt": "2018-07-16T01:35:05.744Z",
  "fullyPaid": false,
  "noRedirect": false,
  "paidAmountWithDecimals": "0",
  "paidPercentage": 0,
  "paymentAmount": 0.1,
  "paymentAmountWithDecimals": "100000000000000000",
  "paymentCurrency": "ETH",
  "requiredConfirmations": 8,
  "shortId": "JdRLp6UM",
  "startBlock": 3645984,
  "timeFrame": 600,
  "walletAddress": "0x96be9aa917f4be69ba707910d32489725de9ecf2",
  "walletReleased": false
}

如果你通过 requestcatcher.com 创建了临时 webhook,这时候在其提供的地址中应该能看到以上类似结果。可以通过其中的 fullyPaid 字段来判断客户是否已经完成支付。其他信息的详细说明请参考处理支付结果部分。


相关内容:

  • 如何获得 API Key
  • 如何获得测试货币
  • 如何设置客户支付完成后的重定向
  • Webhook 的安全性建议
  • 数字货币的支持列表
  • 汇率查询