需配置Apple签发的证书密钥、验证并解析JWT格式PaymentRequestToken、用ECDH解密paymentData、调用Apple API提交交易、处理Webhook通知或轮询状态。

如果您正在开发支持苹果支付企业版(Apple Pay for Business)的PHP后端服务,则需要完成证书配置、支付请求验证、签名生成及与Apple Pay API的安全通信。以下是实现该对接的具体步骤:
Apple Pay企业版要求使用由Apple签发的专用证书(.pem格式)和私钥,用于签名交易请求并验证响应。这些凭证必须通过Apple Developer Portal申请并下载,且需严格保密。
1、登录Apple Developer Account,进入Certificates, Identifiers & Profiles → Certificates → + → Apple Pay for Business Certificate。
2、使用本地OpenSSL生成CSR文件,并在Apple页面上传该CSR以获取签名后的证书(applepay-merchantid.pem)。
立即学习“PHP免费学习笔记(深入)”;
3、将下载的证书与私钥(通常为.key文件)合并为一个PKCS#12格式文件,再转换为PEM格式供PHP OpenSSL扩展使用。
4、将最终的applepay-cert.pem和applepay-key.pem存放在Web服务器安全目录中,确保PHP进程可读但不可通过HTTP直接访问。
客户端(iOS App或网页)会生成PaymentRequestToken(JWT格式),PHP后端需验证其签名有效性,并提取其中的paymentData、header、signature等字段。验证依赖Apple提供的根证书链及商户证书。
1、从HTTP请求头或JSON body中提取paymentToken字段值(Base64URL编码的JWT字符串)。
2、使用OpenSSL加载Apple根证书(AppleRootCA-G3.pem)和商户证书,调用openssl_verify()验证JWT签名是否由Apple签发。
3、解析JWT payload,确认header.ephemeralPublicKey存在且符合SECP256R1曲线格式,payload.paymentData.version为"EC_v1"。
4、提取header.transactionId并校验其长度为32字节十六进制字符串,确保未被篡改。
Apple Pay企业版使用ECDH密钥交换机制对paymentData进行加密,PHP需使用商户私钥解密出原始支付数据(含卡号、有效期等)。该过程依赖OpenSSL的EVP_PKEY_derive接口模拟密钥派生。
1、从JWT payload中取出paymentData.data(Base64编码的密文)、paymentData.header.ephemeralPublicKey(X.509格式公钥)及paymentData.header.applicationData(32字节随机盐值)。
2、使用openssl_pkey_get_private()加载商户私钥,调用openssl_pkey_derive()计算共享密钥(ECDH shared secret)。
3、将共享密钥与applicationData进行HKDF-SHA256派生,生成32字节AES-GCM密钥和12字节IV。
4、使用openssl_decrypt()以AES-256-GCM模式解密paymentData.data,传入认证标签(paymentData.header.encryptedKey末尾16字节)完成完整性校验。
解密获得原始支付信息后,需向Apple指定的生产或沙盒端点(如https://api.apple.com/payments/v1/transactions)发起POST请求,携带授权头、JSON payload及TLS客户端证书。
1、构建JSON请求体,包含merchantIdentifier、transactionIdentifier(来自paymentData.header)、paymentData(明文解密结果)、currencyCode和amount字段。
2、设置cURL选项:启用CURLOPT_SSLCERT指向applepay-cert.pem,CURLOPT_SSLKEY指向applepay-key.pem,并指定CURLOPT_CAINFO为Apple G3根证书路径。
3、添加HTTP头Authorization: Bearer {JWT},其中JWT由商户ID、时间戳、随机nonce及Apple私钥签名生成,算法为ES256。
4、发送请求后检查HTTP状态码是否为201 Created,响应体中transactionStatus字段应为"AUTHORIZED"或"PROCESSED"。
Apple Pay企业版不保证实时同步返回最终交易结果,部分场景(如延迟清算、风控审核)需通过Webhook接收事件通知,或主动轮询交易状态接口。
1、在Apple Developer Portal配置Webhook URL,启用payments.transaction.updated事件类型,并确保该URL支持HTTPS及application/json解析。
2、收到通知时,验证X-Apple-Pay-Signature头内容:使用Apple公钥解密签名,比对请求体SHA-256哈希值。
3、若未启用Webhook或收到transactionStatus: "PENDING",则调用GET /payments/v1/transactions/{id}接口查询最新状态,间隔不少于30秒,最多重试5次。
4、解析响应中statusDetails.reasonCode字段,当值为"CARD_DECLINED"或"INSUFFICIENT_FUNDS"时,记录错误日志并返回对应错误码至前端。
以上就是PHP如何对接苹果支付企业版_苹果支付企业版PHP对接教程【步骤】的详细内容,更多请关注php中文网其它相关文章!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号