收款（Pay-in）

信用卡维度 收款 API（USD / EUR）。响应与回调中的卡组织取值见 支付方式。

精简入参

请勿在收款 API 中传入卡号、CVV、有效期或账单地址。信用卡代收统一返回平台收银台 paymentUrl，由用户在 SmilePayZ 收银台填写卡信息与账单信息。

请求

POST/v2.0/transaction/pay-in

请求地址：

沙盒：https://sandbox-gateway.smilepayz.com/v2.0/transaction/pay-in
生产：https://gateway.smilepayz.com/v2.0/transaction/pay-in

请求头

字段	必填	类型	说明
Content-Type	M	String	application/json
X-TIMESTAMP	M	String	格式：yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	请求体签名，见 签名说明
X-PARTNER-ID	M	String	商户 merchantId

请求体

字段	必填	类型	说明
orderNo	M	String(32)	商户唯一订单号
purpose	M	String(64)	付款备注
merchant	M	Object	商户信息
merchantId	M	String	商户 ID
merchantName	O	String	商户名称
subMerchantId	O	String	子商户 ID
subMerchantName	O	String	子商户名称
money	M	Object	金额
currency	M	String	USD（地区码 40）或 EUR（地区码 41）
amount	M	Number	金额（最多 2 位小数）。小数位见 金额 Money
payer	O	Object	可选付款人信息，见 Payer 模型，不含卡字段
name / phone / email	O	String	若已知可预先传入
productDetail	O	String(128)	商品描述
expiryPeriod	O	Number	订单有效期（秒），默认 3600
redirectUrl	O	String(256)	支付完成跳转 URL（HTTPS）
callbackUrl	O	String(256)	异步回调 URL（HTTPS）

不在收款 API 中传递

以下字段在平台收银台采集：cardNo、cardType、cardCcv、cardExpMonth、cardExpYear、firstName、lastName、country、city、address、state、postcode 等。

---

请求示例

{
    "orderNo": "cc-order-202604090001",
    "purpose": "在线购物",
    "merchant": {
        "merchantId": "20001",
        "merchantName": "Smilepayz Demo Store"
    },
    "money": {
        "currency": "USD",
        "amount": 100.00
    },
    "redirectUrl": "https://docs.smilepayz.com/zh/",
    "callbackUrl": "https://merchant.example.com/callback"
}

{
    "orderNo": "cc-order-202604090002",
    "purpose": "订阅费用",
    "merchant": {
        "merchantId": "20001"
    },
    "money": {
        "currency": "EUR",
        "amount": 50.00
    },
    "redirectUrl": "https://docs.smilepayz.com/zh/"
}

响应

字段	必填	类型	说明
code	M	String	00 成功
orderNo	M	String	商户订单号
tradeNo	O	String	平台交易号
money.currency	M	String	USD 或 EUR
channel.paymentUrl	M	String	平台收银台 URL，引导用户打开并完成支付
status	O	String	通常为 INIT，待用户在收银台完成支付

集成说明

保存 tradeNo，将用户引导至 channel.paymentUrl。响应中不会返回 vaNumber、qrString 或卡信息。

响应示例

{
    "code": "00",
    "message": "Successful",
    "orderNo": "cc-order-202604090001",
    "tradeNo": "111200412406111311517153",
    "merchant": {
        "merchantId": "20001",
        "merchantName": "Smilepayz Demo Store",
        "accountNo": "11120001202406101410"
    },
    "money": {
        "currency": "USD",
        "amount": 100.00
    },
    "transactionTime": "2026-04-09T12:00:00+00:00",
    "channel": {
        "paymentMethod": "VISA",
        "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=111200412406111311517153"
    },
    "status": "INIT"
}

回调

回调签名 ≠ 请求签名

回调里的 X-SIGNATURE 不能拿发请求那套去验。规则见 回调验签。

回调格式与其他地区代收一致，响应字符串 SUCCESS。money.currency 为 USD 或 EUR；paymentMethod 为 VISA 或 MASTERCARD。验签见 回调说明。