logo

搜索...

⌘ K

中文

产品文档
接口文档
资源下载
帮助中心

开始使用

总体概览

场景能力

接入步骤

收款能力

CKP 集成收银台页面

交互示意

集成准备

集成步骤

Deeplink 直跳方式

交互示意

集成准备

集成步骤

QRCode 展示二维码

交互示意

集成准备

集成步骤

付款能力

能力概述

充值入金

发起 U 提现/付款

发起法币提现

接收付款结果

支持的链和币种

支持的链

支持的币种

附录

钱包/币种/链

交易状态枚举值

支付状态

退款状态

提现状态

批量提现状态

错误码说明

签名算法

接入步骤

按照指引,只需五步即可从零开始完成您的第一笔稳定币收款。

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 个动作就能验证主链路:

  1. 用沙箱 x-api-key + x-api-secret 加签调用 POST /payin/v1/createPayment;
  2. 拿到响应中的 httplink,在浏览器打开,跳转到指定钱包支付;
  3. 在 notificationUrl 监听异步回调;
  4. 看到回调 state = PAID,并主动调 getPaymentStatus 二次确认。

详细字段、签名规则、回调处理见 CKP 收银台集成。

5. 完成 Golive 生产环境上线

当你完成沙箱环境接口对接后,向 BD 提交以下材料申请生产环境:

  • 沙箱测试用例报告;
  • 您的回调出口 IP 白名单;
  • 您的回调域名 HTTPS 证书有效证明(生产强制 HTTPS)。

下一步

目录