PayKKa Docs for Payments
v1.2 🇨🇳 (Current Release)
  • v1.2 🇨🇳 (Current Release)
  • v1.0 🇨🇳 (Release)
    PayKKa Docs for Payments
    v1.2 🇨🇳 (Current Release)
    • v1.2 🇨🇳 (Current Release)
    • v1.0 🇨🇳 (Release)
    • 接入流程
    • 变更记录
    • 支付产品
      • 支付方式
      • API 支付
      • 收银台
    • 支付方式
      • Google Pay™
      • Apple Pay
    • API 参考
      • 开始
      • API认证
      • 系统响应码
      • 交易错误码
      • 交易
        • 发起交易
        • 交易查询
        • 交易请款
        • 交易撤销
        • token查询
        • token删除
        • 循环交易协议取消
        • 获取ApplePay会话
      • 收银台
        • 收银台创建
        • 收银台查询
      • 退款
        • 退款
        • 退款查询
      • 通知Webhook
        • 交易结果通知
        • 退款结果通知
    • 前端接入
      • PayKKa Checkout UI Component 使用文档
      • Fraud Detection SDK 使用文档
      • Encrypted Card 使用
    • 数据模型
      • Schemas
        • 响应
        • QueryPayResultReqDto
        • CardEncryptRespDto
        • WebAuthRequest
        • QueryOpenidRequest
        • OrderPayQrcodeRequest
        • EntryPayQrcodeRequest
        • CheckoutIdDto
        • BillRespDto
        • PaymentInfoRespDto
        • PaymentMethodRespDto
        • PaymentMethodsRespDto
        • TokenRespDto
        • BillReqDto
        • BrowserReqDto
        • CheckoutPaymentsReqDto
        • PaymentInfoReqDto
        • CheckoutPaymentQueryDto
        • PaymentMethodsReqDto
        • TokenAuthenticationDto
        • BalanceRespInPaymentsQuery
        • BalanceRespInPayments
        • PaymentLinkSessionReqDto
        • PaymentLinkPaymentsReqDto
        • PaymentLinkPaymentQueryDto
        • PaymentLinkIdDto
        • PaymentLinkQueryRespDto
        • SessionAppleApyReqDto
        • TokenRemoveReqDto
        • QueryTokenReqDto
        • PaymentCardInfoDto
        • QueryTokenRespDto
        • GoodsReqDto
        • SessionCreateReqDto
        • SessionPaymentInfoReqDto
        • ShippingReqDto
        • SessionRespDto
        • SessionQueryReqDto
        • RefundReqDto
        • RefundRespDto
        • RecurringCancelReqDto
        • CardInfoRespDto
        • QueryAddressStyleRespDto
        • CheckoutBillReqDto
        • CheckoutPaymentInfoReqDto
        • PaymentLinkPaymentInfoReqDto
        • SessionAuthenticationReqDto
        • SessionBillReqDto
        • SessionGoodsReqDto
        • SessionShippingReqDto
        • QueryRefundReqDto
        • AuthenticationRecordRespDto
        • QueryPaymentsReqDto
        • CheckoutQueryRespDto
        • CheckoutPaymentsRespDto
        • PaymentLinkPaymentsRespDto
        • PaymentsReqDto
        • AuthenticationRecordDto
        • PaymentsRespDto
        • AuthenticationReqDto
        • RefundNotifyReqDto
        • PaymentsNotifyReqDto
        • PaymentsVoidReqDto
        • PaymentsCaptureReqDto
        • CheckoutBrowserReqDto
        • SessionQueryRespDto
        • PaymentsQueryRespDto
        • BalanceResp
        • QueryPayResultRespDto
        • QueryMerchRequest
        • QueryMerchResponse
        • WebAuthResponse
        • QueryOpenidResponse
        • EntryPayQrcodeResponse
        • CardOrgEnum
        • ChannelConfig
        • SessionField
        • CheckoutThemeRespDto
        • CountryEnum
        • GoodsRespDto
        • Money
        • PaymentMethodEnum
        • PaymentTypeEnum
        • SessionModeEnum
        • SessionStatusEnum
        • CheckoutAuthenticationRecordDto
        • SessionApplePayReqDto
        • FramesLoadReqDto
        • FramesLoadRespDto
        • SuperPaymentMethodsRespDto
        • CardEncryptReqDto
        • CardInfoRespInCard
        • AuthenticationRecordRespInPaymentsQuery
        • CardInfoRespInPaymentsQuery
        • PaymentInfoRespInPaymentsQuery
        • DeviceOsEnum
        • PaymentDeviceTypeEnum
        • AuthenticationRecordRespInPayments
        • CardInfoRespInPayments
        • PaymentInfoRespInPayments
        • TerminalTypeEnum
        • AuthenticationRecordInNotify
        • BalanceRespInNotify
        • CardInfoRespInNotify
        • SessionAuthenticationRecordDto
        • PaymentInfoRespInNotify
        • SessionOrderStatusEnum
        • 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
        • CurrencyEnum
        • RefundQueryReqDto
        • WechatCallbackRespDto
        • AlipayCallbackRespDto
        • Result
        • CardTokenUsageEnum
        • ChallengeIndicatorEnum
        • ApiPaymentMethodEnum
        • CustomerReqDto
        • ThreedSecureExemptionEnum
        • GatewayOrderStatusEnum
        • SessionCustomerReqDto
        • PaymentsQueryReqDto
        • GatewayRefundOrderStatusEnum
        • QueryRefundResultReqDto
        • QueryRefundResultRespDto
        • QueryTransResultReqDto
        • AddressStyleDto
        • ThreedSecureModeEnum
        • DataDictRespDto
        • PagedDataDictValueItem
        • DeviceSignInReqDto
        • DeviceSignInRespDto
        • PosCurrency
        • DeviceSignInRequestV2
        • DeviceSignInResponseV2
        • DeviceSignInRequest
        • DeviceSignInResponse

    接入流程

    请按照以下清单操作, 确保您与PayKKa进行了完整的支付接入

    一. 用户注册#

    1. 沙箱环境支付功能开通#

    Paykka账户体系由一个公司账户 + 一到多个商户组成,订单记录等由指定商户发起和处理,而账户和资金等则归集于公司账户下。因此对接前需要完成账户激活(实名认证)通过,并至少创建一个入网商户,审核通过后可正式发起交易。
    1.
    访问 https://mps-sandbox.aq.paykka.com/login,点击右上角“点击注册”按钮,按照提示完成帐号注册。
    2.
    收到邮件后可跳转设置初始密码,然后登录系统。
    3.
    实名认证:点击“实名认证”项目完成实名认证,激活账户。
    4.
    商户入网:点击“商户入网”项目完成商户入网,创建可交易商户。
    5.
    支付密码:点击“支付密码”项目设置支付密码,该密码用于退款前安全校验,请妥善保管。
    6.
    以上操作亦可联系 Paykka 对接人员协助完成。

    2. 设置交易密钥#

    设置交易密钥 (API 密钥) 以便在集成接入中进行安全校验。
    1.
    访问 https://mps-sandbox.aq.paykka.com/,登录后,点击右上角个人账户 -> 个人中心 -> 安全设置 -> 交易密钥,点击“设置”。
    2.
    可下载使用下方的工具生成一对 RSA2048 密钥对,将公钥输入“我的公钥”并保存,后续对接时使用该密钥对进行加签验签。
    3.
    交易密钥上方的 PayKKa 公钥可用于如下场景验签 1.接收交易通知,2.处理API响应
    4.
    注意:请妥善保护您的私钥,防止泄露。
    5.
    联系对接人员为您开通需要的支付方式。
    Key_Generation_Tool_Win.zip
    Key_Generation_Tool_Mac.zip

    二. 集成接入#

    1.
    构建您的客户端应用,根据您的业务需要接入对应的支付产品(见[API参考])。
    2.
    确保您接入后可以处理具体细节场景使支付实现最终一致; 场景包括: 错误和拒绝/3DS认证等。
    3.
    对各种支付方式和不同的交易类型进行充分的测试验证

    三. 上线#

    3.1. 生产用户注册#

    欧洲地区:https://mps.eu.paykka.com/
    亚太地区:https://mps.aq.paykka.com/

    3.2. 上线准备#

    1.
    在上线前,严格进行各项测试验证。
    2.
    请在 Paykka 生产环境完成相关的支付功能开通 并正确设置支付密码。
    3.
    在生产配置中设置正确的交易密钥。
    修改于 2025-03-24 12:36:50
    下一页
    变更记录
    Built with