# Cards

## 介绍

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

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

若您收集并传输明文卡数据，需向我们提交相关 PCI-AOC 文件。
详情参阅 [pcisecuritystandards](https://www.pcisecuritystandards.org/)

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

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

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

适用于商家和持卡人的银行都位于[欧洲经济区 (EEA)](https://www.gov.uk/eu-eea) 的交易

## 集成方式

### 前端接入

#### 接入 Encrypted Card

参考 [Encrypted Card](/zh-hans/payments/docs/others/encrypted-card)

#### 接入 PayKKa 收银台

参考 [PayKKa Checkout UI Component](/zh-hans/payments/docs/developer-resources/checkout-ui-component)

### API Only

### 明文卡交易

#### 请求示例


```json
{
  "merchant_id": "18356675194960",
  "payment_type": "PURCHASE",
  "authorisation_type": "FINAL_AUTH",
  "capture_method": "AUTOMATIC",
  "trans_id": "m1721xxx938999",
  "timestamp": 1742816738605,
  "currency": "USD",
  "amount": "300",
  "return_url": "https://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"
  }
}
```

### 卡信息加密组件

1. 接入组件流程见 [Encrypted Card](/zh-hans/payments/docs/others/encrypted-card)


#### 请求示例[Initiate Transaction](/zh-hans/payments/apis/payments/openapi/交易/payments-opl_1)


```json
{
    ...
    "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](/zh-hans/payments/apis/payments/openapi/收银台/session-opl_1)


```json
{
  "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"]
}
```