发起支付
/payin/v1/createPayment
请求
请求头参数
content-type
string
REQUIRED
固定值：application/json
x-api-key
string
REQUIRED
Paydify提供，跟appId相同
x-api-timestamp
string
REQUIRED
时间戳，单位毫秒
x-api-signature
string
REQUIRED
签名，具体参看 签名算法
请求体
mchTxnId
string
REQUIRED
商户侧订单ID，最长60位
txnAmount
string
REQUIRED
订单金额，如100.23
currency
string
REQUIRED
订单金额（txnAmount）的计价币种，可传范围由 app 产品类型决定（开通时二选一，传错会被拒单、不自动折算）：稳定币收单 app 传 USDT/USDC，用户按此金额直接支付；法币收单 app 传 USD/SGD，按实时汇率折算为稳定币（见 paymentCurrency）。完整列表参看 支持的币种及其对应链
paymentCurrency
string
法币收单专用：指定法币金额折算成哪种稳定币（USDT/USDC），用户即以该稳定币付款，缺省取 app 配置的默认稳定币；稳定币收单 app 无需传。支持的币种参看 支持的币种及其对应链
checkoutMode
string
REQUIRED
收银台模式，固定值：MERCHANT
payMethod1
string
支付使用的钱包，枚举值参看 支持的钱包及枚举值
payMethod2
string
支付使用的链，枚举值参看 支持的链及其枚举值
notificationUrl
string
服务端支付结果回调通知 URL 地址，仅支持 https。非必传，不传时默认取商户 Portal - 开发者 - Webhook 通知地址的配置。最长 300 字符
successReturnUrl
string
支付成功后跳转的地址
failReturnUrl
string
支付失败后跳转的地址
pendingReturnUrl
string
支付中跳转的地址
source
string
订单来源标签
txnTitle
string
支付标题
txnDesc
string
支付描述信息
accountInfo
array
toAddress
string
REQUIRED
商户收款地址；列表元素存在时必填且非空
network
string
目标链网络（如 ETH / BSC / SOL / TRX / BASE / KAIA 等），与 toAddress 配对；未传则回退到外层 payMethod2。仅在 toAddress 非空时参与网络解析。枚举值参看 支持的链及其枚举值
payerInfo
object
uid
string
商户侧用户 ID
mchExtInfo
string
商户扩展信息，JSON字符串，该字段仅进行透传，将在回调中被带回
lifetime
integer
订单超时周期，单位毫秒，默认30分钟
merchantId
string
服务商下存在多个子商户时，需上传指定 MerchantID；可在商户 Portal - 商户管理查看具体 MerchantID。最长 60 字符
merchantAppId
string
服务商下存在多个子商户且开立多个应用 ID 时，需上传指定 MerchantAppID。最长 64 字符
响应
响应体
code
string
响应码，SYS_SUCCESS表示成功
message
string
响应消息
messageDetail
string
响应消息详情
success
boolean
是否成功
data
object
txnId
string
Paydify侧的订单ID
mchTxnId
string
商户侧订单ID
state
string
支付状态
errorMsg
string
支付失败原因说明
qrCode
string
支付链接二维码base64数据
deeplink
string
原生支付链接
httplink
string
HTTP支付链接
1
RESPONSE
Click the Send API Request button above and see the response here!