Cards

介绍

PayKKa 平台通过通用统一的集成方式支持大多数全球和本地卡支付方式。

您可以使用我们的符合 PCI 认证的支付产品来安全地收集消费者加密卡信息; 若您拥有 PCI-DSS 资质，您也可以直接收集并传输明文卡数据给我们。

若您收集并传输明文卡数据，需向我们提交相关 PCI-AOC 文件。详情参阅 pcisecuritystandards

请款方式: 默认一般会自动请款，您也可以通过参数 capture_method 来改变请款方式，支持手动或者延迟请款。

3DS: 对于支持 3DS 卡片的付款，卡组会根据环境，风险，法规等因素要求进行 3DS 认证，因此部分交易可能需要持卡人输入密码或验证码完成3DS验证。

欧洲经济区(EEA) 和英国，根据当地法律(PSD2)规定，要求所有电子支付(银行卡支付/银行转账)都需要进行强客户认证(SCA)，除非可以适用豁免或超出范围。

适用于商家和持卡人的银行都位于欧洲经济区 (EEA) 的交易

集成方式

前端接入

接入 Encrypted Card

参考 Encrypted Card

接入 PayKKa 收银台

参考 PayKKa Checkout UI Component

API Only

明文卡交易

请求示例

{
  "merchant_id": "18356675194960",
  "payment_type": "PURCHASE",
  "authorisation_type": "FINAL_AUTH",
  "capture_method": "AUTOMATIC",
  "trans_id": "m1721xxx938999",
  "timestamp": 1742816738605,
  "currency": "USD",
  "amount": "300",
  "notify_url": "https://notify_url",
  "return_url": "https://notify_url",
  "payment": {
    "payment_method": "BANKCARD",
    "shopper_reference": "myuserid001",
    "card_no": "4242424242424242",
    "exp_year": "2031",
    "exp_month": "07",
    "cvv": "123",
    "holder_name": "lisa"
  },
  "authentication": {
    "challenge_indicator": "AUTO"
  }
}

卡信息加密组件

接入组件流程见 Encrypted Card

请求示例Initiate Transaction

{
    ...
    "payment": {
        "payment_method": "BANKCARD",
        "shopper_reference": "myuserid001",
        "encrypted_card_no": "MTc0MjczNjg1Nxxxx",
        "encrypted_exp_year": "Wt938LfJ2Pxxxxx",
        "encrypted_exp_month": "WfRto3qWfidnxxx",
        "encrypted_cvv": "MEal81oshxxx",
        "holder_name": "lisa"
    },
    ...
}

通过收银台方式接入

请求示例Create Session

{
  "merchant_id": "18356675194960",
  "payment_type": "PURCHASE",
  "trans_id": "t202311081113",
  "timestamp": 1700805506000,
  "currency": "USD",
  "amount": 1250,
  "session_mode": "HOSTED",
  "display_merchant_name": "PayKKa Merchant",
  "display_locale": "zh-CN",
  "allowed_payment_methods": ["BANKCARD"]
}