独立绑卡
适用市场:ZA 南非
不产生支付交易,仅零金额验证并绑定卡片,返回可用于后续支付的 cardToken。绑卡时将触发零金额授权 + 3DS 认证。
典型场景:MIT 递归扣款前置、一键支付预绑卡、钱包卡管理。
请求参数
是 必填 · 否 选填
返回值
示例
请求 / 响应
通知回调(Notification Callback)
绑卡流程(含 3DS 认证)完成后,PalmPay 会向商户在开放平台后台配置的通知地址发送 POST 请求,告知绑卡结果。
⚠️ 注意区分:
callBackUrl是 3DS 完成后浏览器跳转的前端地址;通知回调是 PalmPay 服务端 → 商户服务端的异步通知,两者用途不同。
请求方式
- Method: POST
- Content-Type:
application/json - countryCode:
ZA
通知参数
通知示例
验签说明
回调通知的 sign 字段使用与请求签名相同的算法生成,商户应使用 PalmPay 公钥 进行验签:
- 对
sign值做 URL Decode(值中含%2F=/、%2B=+,需完整 decode) - 将除
sign外的所有非空参数按 key ASCII 升序拼接key=value&key=value MD5(strA).toUpperCase()→ md5Str- 用 PalmPay 公钥
SHA1WithRSA验签 md5Str,与 decode 后的 sign 比对
⚠️ sign 编码注意:实际 sign 值中同时存在 URL 编码字符(
%2F、%2B)和未编码的/,decode 时需使用标准 URL decode(如 JavaURLDecoder.decode),不要手动替换。验签失败的通知应视为无效,不予处理。
重试机制
若商户未在规定时间内返回成功应答,PalmPay 将按策略自动重试通知。
商户应答要求
商户收到通知并完成处理后,应返回约定的成功应答,否则 PalmPay 将持续重试直至达到上限。