通过 Adyen 使用支付宝

支付宝是中国领先的数字支付平台，支持安全便捷的在线支付。通过 Adyen 的集成，您可以接受来自全球客户的支付宝支付。

设置

请按照通用的 Adyen 说明 来设置 Adyen。接下来，确保在您配置的账户上启用支付宝作为支付方式。

集成

API 请求

curl --request POST \
  --url https://api.efundpay.com/v4/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'x-merchant-account-id: <x-merchant-account-id>' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 10000,
    "currency": "CNY",
    "payment_method": {
      "method": "adyen",
      "payment_method_data": {
        "type": "alipay",
        "returnUrl": "https://yourdomain.com/return"
      }
    },
    "external_identifier": "order-12345"
  }'

支付流程

1. 初始化支付 - 通过 EFundPay 创建支付请求
2. 重定向到支付宝 - 客户被重定向到支付宝支付页面
3. 支付处理 - 客户在支付宝上完成支付
4. 返回商户 - 客户返回您的网站
5. Webhook 通知 - 通过 webhook 接收支付状态

配置

必需参数

• amount - 最小货币单位的支付金额（人民币以分为单位）
• currency - 货币代码（CNY 表示人民币）
• payment_method_data.type - 设置为 "alipay"
• returnUrl - 支付后重定向客户的 URL

可选参数

• billing_address - 客户账单地址
• shipping_address - 客户配送地址
• merchant_order_id - 您的内部订单参考

响应处理

成功响应

{
  "type": "transaction",
  "id": "txn_123456789",
  "status": "processing",
  "payment_url": "https://checkoutshopper-test.adyen.com/checkoutshopper/...",
  "external_identifier": "order-12345"
}

Webhook 通知

{
  "ll_transaction_id": "2022012601122644",
  "merchant_transaction_id": "order-12345",
  "payment_data": {
    "payment_status": "SUCCEEDED",
    "payment_amount": "100.00",
    "payment_currency_code": "CNY",
    "payment_time": "20220126141430",
    "adyen_psp_reference": "8535296650153317",
    "result_code": "Authorised"
  }
}

客户端集成

重定向到支付

// 重定向客户到支付宝支付页面
function redirectToAlipay(paymentUrl) {
  window.location.href = paymentUrl;
}

// 处理支付返回
function handlePaymentReturn() {
  const urlParams = new URLSearchParams(window.location.search);
  const resultCode = urlParams.get('resultCode');
  
  if (resultCode === 'Authorised') {
    showSuccessMessage('支付成功！');
  } else {
    showErrorMessage('支付失败，请重试。');
  }
}

测试

Adyen 有关于如何测试支付宝的说明。您可以使用以下测试场景：

• 成功支付 - 成功完成支付流程
• 支付取消 - 客户取消支付
• 支付失败 - 由于余额不足或其他原因导致支付失败

测试环境

• 使用 Adyen 的沙盒环境进行测试
• 使用各种金额和货币进行测试
• 验证 webhook 通知
• 测试返回 URL 处理

安全考虑

• 所有通信始终使用 HTTPS
• 验证 webhook 签名
• 实施适当的会话管理
• 遵循支付宝的安全指南

最佳实践

用户体验

• 用中文提供清晰的支付说明
• 显示支付进度指示器
• 优雅地处理错误
• 针对移动设备进行优化

技术实施

• 实施适当的错误处理
• 使用 webhook 进行实时更新
• 存储交易参考
• 优雅地处理网络故障

常见问题

支付失败

• 无效金额 - 确保金额格式正确
• 货币问题 - 检查货币设置
• 返回 URL 问题 - 验证返回 URL 配置

集成问题

• 未收到 Webhook - 检查 webhook 端点和签名
• 支付页面错误 - 验证支付 URL 生成
• 身份验证问题 - 检查 API 凭据

支持

如需通过 Adyen 集成支付宝的技术支持：

• EFundPay 支持 - 联系我们的技术团队
• Adyen 支持 - 使用 Adyen 的支持资源
• 支付宝文档 - 全面的集成指南

相关文档

• Adyen 概述
• 通过 Adyen 使用卡支付