接入步骤
按照指引,只需五步即可从零开始完成您的第一笔稳定币收款。
1
成为 Paydify 合作伙伴
明确业务场景
2
3
配置接口参数
创建第一次接口请求
4
5
完成 Golive 上线
1. 成为 Paydify 合作伙伴
联系我们的商务团队,完成 KYC 认证,获得你的身份标识:
- PartnerID 是您在 Paydify 唯一身份标识,我们销售/运营团队将根据此 PartnerID(PID)为你提供全方位服务;
- MerchantID 是您旗下发起交易的商户,您可能存在一个或多个 MerchantID(MID);现阶段 PID/MID 皆由我们商务 BD 为你创建添加。
2. 明确您的业务场景
明确您的业务场景,需要 Paydify 为您提供/开通的 Payin、Payout 或 Custodian 资金托管产品权限:
- 不同产品对接的接口不同,此过程仍会在 KYC 阶段,我们的商户 BD 会与您沟通确认;
- 可通过场景能力快速了解每个产品适配场景差异及案例。
3. 登录商户 Portal 配置接口参数
登录商户 Portal - 开发者中心创建接口调用凭证,建议区分 Sandbox / Production Environment。
- x-api-key 配套对应 x-api-secret,负责接口加验签。
4. 创建您的第一次接口请求
POST /payin/v1/createPayment
最小可行集成(Minimal Viable Integration)只需 4 个动作就能验证主链路:
- 用沙箱 x-api-key + x-api-secret 加签调用
POST /payin/v1/createPayment; - 拿到响应中的
httplink,在浏览器打开,跳转到指定钱包支付; - 在
notificationUrl监听异步回调; - 看到回调
state = PAID,并主动调getPaymentStatus二次确认。
详细字段、签名规则、回调处理见 CKP 收银台集成。
5. 完成 Golive 生产环境上线
当你完成沙箱环境接口对接后,向 BD 提交以下材料申请生产环境:
- 沙箱测试用例报告;
- 您的回调出口 IP 白名单;
- 您的回调域名 HTTPS 证书有效证明(生产强制 HTTPS)。