Request ID
每个请求都必须具有唯一标识符。- 格式:带连字符的字母数字组合(例如
refuel-12345)。 - 上下文:在 ID 中包含业务逻辑,以便日志更易读取。
金额处理
VPOS 使用最小货币单位,以避免浮点数误差。- 如果
decimalPlace为 2,则 $1.00 会以100的形式发送。 - 如果
decimalPlace为 3,则 $1.00 会以1000的形式发送。
常规超时时间
客户端系统应管理超时时间,以确保终端不会无限期挂起:错误处理
- 日志记录:请务必存储
errorCode和errorMessage。 - 重试:请勿重试被拒绝(DECLINED)的交易。拒绝是银行给出的最终响应;用户必须提供其他支付方式。