Build payments against a visible contract.

准备你网站的 HTTPS 返回页

例如 https://merchant.example/checkout/result。HuizhiPay 会把这个地址原样保存为订单 returnUrl，买家完成 HPP 后可返回该页面。

从外部网站服务端创建 USD 测试订单

先签发并激活 hzp_test_...，再登记并验证该商户的返回 Origin。外部网站服务端调用 Test Payment API；不要把 Key 或登录 Cookie 发送到浏览器。

const response = await fetch('http://127.0.0.1:8080/api/v1/test/payments', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-HuizhiPay-Api-Key': process.env.HUIZHIPAY_TEST_API_KEY
  },
  body: JSON.stringify({
    merchantOrderNo: 'SHOP-20260916-001',
    amount: 10.00,
    currency: 'USD',
    productName: 'Test product',
    successRedirectUrl: 'https://merchant.example/checkout/result?state=success',
    failureRedirectUrl: 'https://merchant.example/checkout/result?state=failed'
  })
});
const { data: order } = await response.json();

把买家送到返回的 paymentUrl

打开订单响应中的 paymentUrl，买家在 HPP 选择 Sandbox 成功或失败。之后检查订单状态和 returnUrl 返回行为，确认你的网站能恢复自己的 checkout 上下文。