入门
English重要说明
现有对接自身无法察觉的 HansaPay 行为。接入前请先阅读。
本文档中的请求与响应格式没有变化,现有对接无需修改代码即可继续使用。以下行为是现有对接自身无法察觉的:
- 金额可能向下取整到价位。 Apple Pay、Google Pay 及部分卡通道只按固定价位收款。HansaPay 会把金额向下取整到最接近的价位(最多 5%):
trans_amount为实收金额,requested_amount为你传入的金额。见 钱包支付直连。请按order_no/merchant_order_no对账,不要按金额对账。 - 通知返回实收的美元金额。 对于其他币种的订单,API 响应返回你传入的币种与金额,而
payment.updated与refund.updated通知返回实收或实退的美元金额。 - 拒付不发通知。 拒付会从你的余额中扣除,仅在商户后台展示。不发送通知,支付状态保持
SUCCESS。 - 卡类退款为全额退款且需审核。 卡、Apple Pay 与 Google Pay 支付只能退款一次,且须全额。退款初始为
PENDING,审核后才完成。见 创建退款。 - 已停用的账户不能收款。
/payments/create与/payments/checkout返回code=1001。查询、退款与结算不受影响。 PAYPAL与PIX目前不可用。 它们能通过参数校验,随后以code=3003拒绝。代付目前不可用:所有/payouts/create均返回code=5007。- 通知必须以
success应答。 其他任何应答都会重试,约 90 分钟内最多 9 次。同一通知可能到达多次。见 商户回调响应要求。 - 结算按美国工作日计算。
T+N从订单创建当天起按周一至周五计算,不含元旦、阵亡将士纪念日、独立日、劳动节、感恩节和圣诞节。
