快速开始

请求 HOST

详见开户信息或咨询工作人员。

请求结构

通过向 Starpago API 的服务端地址发送 HTTP POST 请求，并按照请求结构 在 HTTP body 中加入相应请求参数来完成，Starpago 系统根据请求参数 来响应返回参数 。

通信协议

为了更高的安全性，Starpago API 接口仅支持通过 HTTPS 通道进行请求通信。 在调用 Starpago 系统 API 时， 需要遵循以下安全要求：

所有的请求必须使用 SSL，否则请求将被拒绝 仅支持 TLS 1.2 or TLS 1.1， SSLv3 and TLS 1.0 不被支持

字符编码

请求及返回结果都使用 UTF-8 字符集进行编码。

参数格式

请求参数及返回参数均使用 JSON 格式 。

Content-Type: application/json;charset=utf-8

返回参数

字段	名称	说明
code	状态码	http 状态码，此字段值只表明接口请求情况，不能说明业务参数无异常
msg	状态描述	接口调用结果描述
error	错误信息	异常信息
data	业务返回值	描述业务调用情况的返回值，具体请参照业务接口中每个接口的 data 值

通知机制

通知分为两种通知方式，因同步回调可能出现用户模拟操作，或在同步通知未进行跳转时，用户手动关闭浏览器等不可控情况，导致商户造成损失，我们强烈建议商户以异步通知结果来确认订单的支付结果。

同步回调

在用户支付成功，或者取消支付时，Starpago 会将消费者的浏览器重定向到商户提供的 returnurl 上，并携带相关参数。 同步回调采用 get 方式跳转，相应的拼接参数，会对每个参数的值进行编码为 UTF-8 的 URLencode 处理，随后进行跳转。

异步回调

Starpago 会将消费者支付结果的消息通过服务器端发送到商户提供的 notifyurl 上，并携带相关参数，以 post 形式提交。商户需要对结果中的订单状态做判断，以确定订单状态。

商户服务器接到请求后必须 http 响应 200，并且打印输出 success 或者 ok。如果商户反馈给 Starpago 的字符不是 success 这 7 个字符或者 ok 这 2 个字符，Starpago 服务器会不断重发通知，直到超过 24 小时 47 分钟。一般情 况下，25 小时以内完成 9 次重发通知（通知的间隔频率一般是：30s,2m,4m,10m,30m,1h,2h,6h,15h）。 某些情况下，商户的一笔订单可能会收到 Starpago 的多次通知，商户需对自己的逻辑进行检查，对于可能收到重复的成功或失败状态的订单通知能够进行唯一的业务处理。