跳到主要内容

快速接入

欢迎使用PingPong开放平台，以下是您接入服务的关键步骤。

第一步：确认签约产品​

您与PingPong销售取得联系并完成入网和产品

第二步: 应用授权接入​

Endpoints​

环境域名说明
testtest-gateway.pingpongx.com测试环境
sandboxsandbox-gateway.pingpongx.com沙箱环境
productiongateway.pingpongx.com生产环境

申请appId​

在开始使用前, 您首先需要在相关技术群或邮箱中联系PingPong发起API应用接入申请，来获得一个appId。

获取access token​

使用您获得的 appId 及 appSecret 获取 access_token

curl -L -X GET '{endpoint}/v2/token/get?app_id={your_app_id}&app_secret={your_app_secret}'

{
    "code": 0,
    "message": "ok",
    "data": {
        "access_token": "<access_token>",
        "expires_in": 7200
    }
}

token有有效期,默认单位为秒, 请注意及时刷新

携带token访问接口​

接下来, 您需要在调用您需要访问的接口时，携带 token

curl -L -X GET '{endpoint}/v2/httpbin/get' -H 'Authorization: Bearer <access_token>'

第三步：开发对接​

1.API对接​

1.1 了解业务逻辑

请在文档中心了解业务场景和模型，明确需要对接的具体接口。

1.2 查看API文档

了解API的请求地址、请求方式（POST/GET）、签名算法、请求参数、响应参数、平台错误码、业务错误码、异步通知接口。

2.对接结果通知​

为保证数据的一致性，PingPong开放系统会给商户发送订单操作终态的通知，通常情况下只有操作到终态(成功或失败) 的订单才会给商户发送异步通知。具体参见 结果通知机制

提示

请务必对接主动查单接口，并在合适的时间主动发起订单查询操作，避免异步通知失败情况下导致数据一致性问题。

其他说明​

IP白名单配置​

为了确保接口访问的安全性，需要合作伙伴提供给PingPong相应的出口IP列表，以便于加入IP白名单。

接口调用频率​

接口调用频率：同一个appId调用PingPong接口限制每秒不超过20次。超出将返回code码为429。如需要增加调用频率，请联系PingPong技术人员。

提示

批量拉取订单信息、查询各种订单结果状态等操作，注意频率问题，防止超频报错。