入门

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 从订单创建当天起按周一至周五计算,不含元旦、阵亡将士纪念日、独立日、劳动节、感恩节和圣诞节。