PayKKa Docs for Payments
v1.0 🇨🇳 (Release)
  • v1.2 🇨🇳 (Current Release)
  • v1.0 🇨🇳 (Release)
  1. 前端接入
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. 前端接入

PayKKa Radar SDK 使用文档

引入#

npm#

若您使用了我们的收银台组件,则不需要手动导入,组件本身已经集成了 SDK,您可直接跳到下一步:使用(npm)。
收银台组件引入方式参考:PayKKa Checkout UI Component 使用文档

API 模式#

若您是接入的 API 支付,可以通过 CDN 的形式单独引入 Radar SDK。
下面是香港和欧洲商户引入 SDK 的方式:
在您成功引入 SDK 后,就可以进行使用(CDN)了。

使用#

不同环境(香港/欧洲)下接入 Radar 的配置是不同的,因此您需要配置对应环境。
目前支持的环境如下:
环境描述
eu默认值,欧洲商户可用
hk香港商户可用
us美国商户可用,目前暂未开通

npm#

若您使用了我们的收银台组件,您可以直接在 npm 包中设置环境。
如果您是欧洲商户,则无需任何操作。
如果您是其他地区的商户,您需且仅需一开始就设置好 Radar 的环境即可。
调用 setRadarEnv 去设置环境,具体支持环境可见支持环境列表:

CDN#

若您是接入的 API 支付,在成功引入并加载 SDK 链接后,会暴露出变量 PayKKaRadar。
与 npm 同理,一开始您需要设置好环境,具体支持环境可见支持环境列表:
PayKKaRadar 是单例,因此多次调用返回的是同一个实例,您无需担心会产生重复请求。

createPayKKaRadar#

您需要调用 PayKKaRadar.createPayKKaRadar() 创建 Radar,此时内部会开始进行初始化并请求 Radar ID,该方法会缓存请求到的 Radar ID,因此多次调用不会刷新 Radar ID。

radarId#

您可以通过 radarId 属性获取到 Radar ID,Radar ID 经过 base64 编码,其原结构为 { s: 'xxx' },其中 s 存放的就是请求到的结果。
请求 Radar ID 需要一些时间,不过您不需要等到 Radar ID 请求完成也可以发起支付,无论 RadarID 是否为空,直接传递即可。

示例#

下面是示例代码:
修改于 2025-01-13 03:24:23
上一页
退款结果通知
下一页
PayKKa Checkout UI Component 使用文档
Built with