API 支付

产品介绍

由商户发送付款参数（如金额,货币,国家/地区和支付方式）以及从消费者那里收集的其他必要支付数据和消费者信息。支持多种支付方式, 见[支付方式]

对于使用API支付, 我们接受下面两种卡支付的方案

使用我们的[EncryptedCard]组件安全的收集并加密卡信息, 最终通过API支付接口发起支付; 这样有助于确保您的PCI合规, 减少接触敏感信息的风险, 支持一定的定制化

您直接收集消费者原始卡信息, 并通过API支付接口发起支付; 该方式需要PayKKa评估您的PCI合规性(请联系PayKKa业务人员了解详情)

业务流程

获取您的交易密钥

获取您的ClientKey (针对EncryptedCard接入需要)

接入EncryptedCard需要提供您的域名解除跨域限制

准备接入的通知地址webhook, 提供到请求参数中

接口调用流程

原始卡交易流程

接入EncryptedCard交易流程

接入[EncryptedCard]组件流程见 [前端接入/EncryptedCard使用文档]

是否需要3DS可根据支付或者查询接口的响应字段authentication_result.authentication_url, 返回代表正在等待消费者进行3DS认证

EncryptedCard需要商户尽量接入组件事件, 可以让消费者体验更丝滑

支付方式示例

原始卡支付

{
	"version": "v1.2",
	"sign_type": "RSA256",
	"merchant_id": "1800000000000",
	"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"
	},
	"browser": {
		// 消费者终端信息
	},
	"goods": [
                // 商品信息
	],
	"bill": {
		// 账单信息
	},
	"shipping": {
		// 收货信息, 实物贸易必填
	},
	"customer": {
		// 消费者/客户信息
	}
}

加密卡支付

{
	...
	"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"
	},
        ...
}

ApplePay

{
	...
	"payment": {  // 商户解密卡信息
		"payment_method": "APPLE_PAY",
		"shopper_reference": "myuserid001",
                "card_no": "4242424242424242",
		"exp_year": "2031",
		"exp_month": "07",
		"cvv": "123",
		"holder_name": "lisa"
	},
        ...
        "payment": {  // PayKKa解密卡信息
		"payment_method": "APPLE_PAY",
		"shopper_reference": "myuserid001",
                "token_data": "token from ApplePay SDK"
	},
        ...
}

ApplePay目前支持两种接入方式
1.1. 商户接入ApplePay解密卡信息, 则可以发送原始卡信息给PayKKa
1.2. 商户不解密, 则商家需要接入[获取ApplePay会话]接口以加载ApplePay组件, 并最终发送ApplePay组件生成的支付token(json字符串)给PayKKa做解密并交易

接入ApplePay详细流程见 [支付方式/Apple Pay]

GooglePay

{
	...
	"payment": {
		"payment_method": "GOOGLE_PAY",
		"shopper_reference": "myuserid001",
                "card_no": "4242424242424242",
		"exp_year": "2031",
		"exp_month": "07",
		"cvv": "123",
		"holder_name": "lisa"
	},
        ...
        "payment": {
		"payment_method": "GOOGLE_PAY",
		"shopper_reference": "myuserid001",
                "token_data": "token from GooglePay SDK"
	},
        ...
}

GooglePay目前支持两种接入方式
1.1. 商户接入GooglePay解密卡信息, 则可以发送原始卡信息给PayKKa
1.2. 商户不解密, 则可以发送GooglePay组件生成的支付token(json字符串)给PayKKa做解密并交易

接入GooglePay详细流程见 [支付方式/Google Pay]

注意事项

暂无

产品介绍#

业务流程#

接口调用流程#

原始卡交易流程#

接入EncryptedCard交易流程#

支付方式示例#

原始卡支付#

加密卡支付#

ApplePay#

GooglePay#

注意事项#