用途:该技能面向 Alipay 全球/跨境产品 Antom(Cashier Payment / AMS)和 Alipay+ 的异步 Webhook 通知处理,通知类型包括 notifyPayment、notifyRefund、notifyCapture、notifyAuthorization、notifyDispute。
主要能力:接收并解析 Webhook 请求;验证请求头中的 Signature(RSA256 / SHA256withRSA);区分并分发通知类型(通过 body 中 notifyType 字段);对确认响应进行签名。
验证要点:签名内容为两行,格式为 <METHOD> <URI> 换行后接 <Client-Id>.<Request-Time>.<RawBody>,以单个句点连接。签名使用 base64URL 编码,线上可能再经百分号编码,需先 URL 解码再 base64 解码。验证必须使用原始请求体,不能先反序列化再重新序列化。公钥来自 Antom 后台。
确认响应:需返回 HTTP 200,响应体为 {"result":{"resultCode":"SUCCESS","resultStatus":"S","resultMessage":"Success"}},并附带签名后的响应头 Client-Id、Response-Time、Signature。若确认缺失或非 200,Antom 会在 24 小时内重试约 8 次(0s、2m、10m、10m、1h、2h、6h、15h),因此处理器需实现幂等。
环境变量:ALIPAY_CLIENT_ID、ALIPAY_PUBLIC_KEY(验证入站)、ALIPAY_MERCHANT_PRIVATE_KEY(签署确认)。通知 URL 通过 API 调用中的 paymentNotifyUrl / refundNotifyUrl 设置,无统一共享密钥。
适用场景:使用 Antom 或 Alipay+ 的跨境支付集成,需要处理支付、捕获、退款、授权与争议事件的开发场景。
限制:不覆盖旧版 Alipay openapi / MAPI(openapi.alipay.com、global.alipay.com,使用 sign + sign_type=RSA2 的表单编码方案)。文档未提供其他平台、收费或效果信息。本地开发可用 npx hookdeck-cli listen 3000 alipay --path /webhooks/alipay 建立隧道。