PayKKa Docs for Payments
v1.0 🇨🇳 (Release)
  • v1.2 🇨🇳 (Current Release)
  • v1.0 🇨🇳 (Release)
  1. API 参考
PayKKa Docs for Payments
v1.0 🇨🇳 (Release)
  • v1.2 🇨🇳 (Current Release)
  • v1.0 🇨🇳 (Release)
  • 变更记录
  • 接入流程
  • API 参考
    • 开始
    • API认证
    • 系统响应码
    • 付款错误码
    • 付款
      • 交易
      • 交易查询
      • token删除
      • token查询
      • 循环交易协议取消
    • 收银台
      • 收银台创建
      • 收银台查询
    • 退款
      • 退款
      • 退款查询
    • 通知Webhook
      • 交易结果通知
      • 退款结果通知
  • 前端接入
    • PayKKa Radar SDK 使用文档
    • PayKKa Checkout UI Component 使用文档
  • 数据模型
    • Schemas
      • 响应
      • QueryPayResultReqDto
      • CheckoutQueryRespDto
      • CheckoutPaymentsRespDto
      • PaymentLinkPaymentsRespDto
      • PaymentsReqDto
      • AuthenticationRecordDto
      • PaymentsRespDto
      • AuthenticationReqDto
      • RefundNotifyReqDto
      • PaymentsNotifyReqDto
      • QueryPayResultRespDto
      • QueryMerchRequest
      • QueryMerchResponse
      • WebAuthRequest
      • WebAuthResponse
      • QueryOpenidRequest
      • QueryOpenidResponse
      • OrderPayQrcodeRequest
      • EntryPayQrcodeResponse
      • EntryPayQrcodeRequest
      • CheckoutIdDto
      • BillRespDto
      • CardOrgEnum
      • ChannelConfig
      • CheckoutThemeRespDto
      • CountryEnum
      • GoodsRespDto
      • Money
      • PaymentInfoRespDto
      • PaymentMethodEnum
      • PaymentMethodRespDto
      • PaymentMethodsRespDto
      • PaymentTypeEnum
      • SessionModeEnum
      • SessionStatusEnum
      • CheckoutAuthenticationRecordDto
      • TokenRespDto
      • BillReqDto
      • BrowserReqDto
      • CheckoutBillReqDto
      • CheckoutPaymentsReqDto
      • DeviceOsEnum
      • PaymentDeviceTypeEnum
      • PaymentInfoReqDto
      • CheckoutPaymentInfoReqDto
      • TerminalTypeEnum
      • SessionAuthenticationRecordDto
      • SessionOrderStatusEnum
      • CheckoutPaymentQueryDto
      • PaymentMethodsReqDto
      • PaymentModeEnum
      • ApplePaySessionRespDto
      • BatchQueryDictReqDto
      • BatchQueryDictRespDto
      • DataDictResp
      • DataDictValueItem
      • OldPlaceOrderQrcodeRequestV2
      • OldPlaceOrderQrcodeResponseV2
      • OldPosQueryOrderRequestV2
      • OldPosQueryOrderResponseV2
      • OldCollectPayQrcodeRequestV2
      • OldCollectPayQrcodeResponseV2
      • OldPlaceOrderQrcodeRequest
      • OldPlaceOrderQrcodeResponse
      • OldPosQueryOrderRequest
      • OldPosQueryOrderResponse
      • OldCollectPayQrcodeRequest
      • OldCollectPayQrcodeResponse
      • PlaceOrderQrcodeRequest
      • PlaceOrderQrcodeResponse
      • DeviceActivateRequestV2
      • DeviceActivateResponseV2
      • DeviceActivateRequest
      • DeviceActivateResponse
      • CollectPayQrcodeRequest
      • CollectPayQrcodeResponse
      • PaymentLinkSessionReqDto
      • PaymentLinkPaymentsReqDto
      • PaymentLinkPaymentQueryDto
      • PaymentLinkPaymentInfoReqDto
      • PaymentLinkIdDto
      • CurrencyEnum
      • PaymentLinkQueryRespDto
      • WechatCallbackRespDto
      • AlipayCallbackRespDto
      • TokenRemoveReqDto
      • QueryTokenReqDto
      • QueryTokenRespDto
      • Result
      • CardTokenUsageEnum
      • ChallengeIndicatorEnum
      • ApiPaymentMethodEnum
      • CustomerReqDto
      • QueryRefundReqDto
      • GoodsReqDto
      • SessionCreateReqDto
      • SessionPaymentInfoReqDto
      • ShippingReqDto
      • SessionAuthenticationReqDto
      • ThreedSecureExemptionEnum
      • SessionBillReqDto
      • GatewayOrderStatusEnum
      • SessionRespDto
      • SessionCustomerReqDto
      • SessionQueryReqDto
      • SessionGoodsReqDto
      • RefundReqDto
      • AuthenticationRecordRespDto
      • GatewayRefundOrderStatusEnum
      • SessionShippingReqDto
      • RefundRespDto
      • QueryRefundResultReqDto
      • QueryPaymentsReqDto
      • QueryRefundResultRespDto
      • RecurringCancelReqDto
      • CardInfoRespDto
      • QueryTransResultReqDto
      • AddressStyleDto
      • ThreedSecureModeEnum
      • QueryAddressStyleRespDto
      • DataDictRespDto
      • PagedDataDictValueItem
      • DeviceSignInReqDto
      • DeviceSignInRespDto
      • PosCurrency
      • DeviceSignInRequestV2
      • DeviceSignInResponseV2
      • DeviceSignInRequest
      • DeviceSignInResponse
  1. API 参考

API认证

必要参数#

请求头含义描述类型必填
signature请求签名String[1,500]Y
type签名类型, 固定传 RSA256String[1,10]Y
请求体含义描述类型必填
version版本号, 固定传String[1,10]Y
timestamp发起请求时间戳(单位毫秒)IntY
merchant_id商户号String[1,32]Y
响应头含义描述类型必填
signature响应签名String[1,500]Y
type签名类型, 固定传 RSA256String[1,10]Y
响应体含义描述类型必填
ret_code系统响应码 (详情见[系统响应码])StringY
ret_msg系统响应消息StringY
data响应业务数据ObjectN

计算签名#

1.
在您的 Java 代码中引入依赖:
<dependency>
  <groupId>commons-codec</groupId>
  <artifactId>commons-codec</artifactId>
  <version>{version}</version>
</dependency>
2.
从请求参数中依次组合 merchant_id、timestamp 和 请求体 requestBody 内容,拼接为字符串后,使用您的私钥进行 SHA256withRSA 算法生成签名:
3.
将签名设置到请求头 "signature" 中,并确保请求体和签名参数 requestBody 完全一致。
4.
设置请求头"type"为RAS256, 表示使用的签名方式
示例如下
修改于 2025-02-14 08:14:15
上一页
开始
下一页
系统响应码
Built with