国际信用卡支付

创建订单

接口地址：/global/pay/credit

请求参数

参数名	类型	是否必填	说明
mchid	string	是	商户号
appid	string	是	应用ID
amount	string	是	订单金额，单位：根据货币类型而定，精确到小数点后两位
subject	string	是	订单标题
body	string	是	订单描述
callback_url	string	否	同步跳转地址，用户支付完成后跳转的页面
user_id	string	是	用户ID
client_ip	string	是	客户端IP
phone_number	string	是	用户手机号
currency	string	是	货币类型，如：USD等
customer_name	string	是	客户姓名
region	string	是	地区/国家
mch_order_no	string	是	商户订单号，需保证唯一性
email	string	否	用户邮箱
notify_url	string	是	异步通知地址，支付系统会在此地址通知商户支付结果
first_name	string	否	用户姓
last_name	string	否	用户名
card_no	string	否	卡号
cvc	string	否	卡片cvc/cvv
expiry_year	string	否	卡片有效期，年份
expiry_month	string	否	卡片有效期，月份
trigger_mode	string	否	默认不填，周期扣款需要填充，如：RECURRING
sign	string	是	签名，用于验证请求的合法性

业务返回参数（result对象）

当success为true时，返回以下参数：

参数名	类型	说明
appid	string	应用ID
mchid	string	商户号
amount	string	订单金额
order_id	string	支付系统订单号
mch_order_no	string	商户订单号
pay_type	string	支付类型，如：GLOBAL_CREDIT
user_id	string	用户ID
sign	string	签名，用于验证返回数据的合法性
pay_info	string	支付信息，如支付页面URL或支付参数

请求示例

{
  "amount": "2",
  "mchid": "2002340435",
  "subject": "test",
  "sign": "9020db3f78bf1dd9b3e96fe064631240",
  "notify_url": "https://www.baidu.com",
  "body": "test",
  "callback_url": "https://www.baidu.com",
  "user_id": "sdfsdfsg",
  "appid": "4110",
  "client_ip": "10.99.34.122",
  "phone_number": "18801552245",
  "currency": "USD",
  "customer_name": "jeak musk",
  "region": "USA",
  "mch_order_no": "1749700733673",
  "email": "1SDFSDF@qq.com"
}

返回示例

{
  "code": "0",
  "message": "success",
  "success": true,
  "result": {
    "appid": "4110",
    "mchid": "2002340435",
    "amount": "2",
    "order_id": "1627167620048407552",
    "mch_order_no": "1749700733673",
    "pay_type": "GLOBAL_CREDIT",
    "user_id": "sdfsdfsg",
    "sign": "c8e022157e7053778fe5eaa71eddbd67",
    "pay_info": "https://uat-cashier-api.haipay.top/payment/6bgjfppe6n1s"
  }
}

---

查询订单

接口地址：/global/order/query

请求参数

参数名	类型	是否必填	说明
mchid	string	是	商户号
appid	string	是	应用ID
sign	string	是	签名，用于验证请求的合法性
order_id	string	否	支付系统订单号，与mch_order_no二选一
mch_order_no	string	否	商户订单号，与order_id二选一

业务返回参数（result对象）

当success为true时，返回以下参数：

参数名	类型	说明
mchid	string	商户号
appid	string	应用ID
amount	string	订单金额
order_id	string	支付系统订单号
mch_order_no	string	商户订单号
third_order_no	string	第三方支付系统订单号（如有）
status	string	订单状态，如：nopay（未支付）、success（已支付）、closed（已关闭）、fail(失败)
pay_type	string	支付类型，如：GLOBAL_CREDIT
user_id	string	用户ID
consent_id	string	订单确认ID
sign	string	签名，用于验证返回数据的合法性

请求示例

{
  "mchid": "2002340435",
  "appid": "4110",
  "sign": "357a7a41cd8221e1c49efe0690524a9e",
  "order_id": "1627167620048407552",
  "mch_order_no": "1749641160521"
}

返回示例

{
  "code": "0",
  "message": "success",
  "success": true,
  "result": {
    "mchid": "2002340435",
    "appid": "4110",
    "amount": "2.00",
    "order_id": "1627167620048407552",
    "mch_order_no": "1749700733673",
    "third_order_no": "2025061211583213057",
    "status": "nopay",
    "pay_type": "GLOBAL_CREDIT",
    "user_id": "sdfsdfsg",
    "sign": "84a23f28a3a54cec97d61cd22a7bf4c2"
  }
}

---

订单退款

请求地址： /global/refund

请求参数

参数名	类型	是否必填	说明
mchid	string	是	商户号
appid	string	是	应用ID
sign	string	是	签名，用于验证请求的合法性
mch_refund_no	string	是	商户退款单号，需保证唯一性
order_id	string	是	支付系统订单号
refund_amount	string	否	退款金额（若不填，默认全额退款）

业务返回参数（result对象）

当success为true时，返回以下参数：

参数名	类型	说明
appid	string	应用ID
mchid	string	商户号
refund_id	string	支付系统退款单号
mch_refund_no	string	商户退款单号
order_id	string	支付系统订单号
status	string	退款状态，如：processing（处理中）、success（成功）、fail（失败）
error	string	错误描述（当状态为failed时返回）
refund_amount	string	实际退款金额
sign	string	签名，用于验证返回数据的合法性

请求示例

{
  "mchid": "2002340435",
  "appid": "4110",
  "sign": "314fe13a2bf1dbc9f838deb77459a457",
  "mch_refund_no": "1749705609092",
  "order_id": "1627167620048407552"
}

响应示例

{
  "code": "0",
  "message": "success",
  "success": true,
  "result": {
    "appid": "4110",
    "mchid": "2002340435",
    "refund_id": "1627188070384192512",
    "mch_refund_no": "1749705609092",
    "order_id": "1627167620048407552",
    "status": "processing",
    "error": "退款已提交",
    "refund_amount": "2.00",
    "sign": "4277e9cd0ea7410ab44cb52e51de8cb0"
  }
}

---

异步通知

通知路径: 由商户在下单时指定（需支持 POST 请求，HTTPS/HTTP 协议）

参数名	类型	说明
amount	string	支付金额
appid	string	应用ID
complete_time	string	支付完成时间（格式：YYYY-MM-DD HH:mm:ss）
mch_order_no	string	商户订单号
mchid	string	商户号
order_id	string	支付系统订单号
pay_type	string	支付方式（如：GLOBAL_CREDIT）
sign	string	签名，用于验证通知数据的合法性
status	string	支付状态（如：nopay、success、fail、cancel）
user_id	string	用户ID
consent_id	string	订单确认ID

商户收到通知后，需返回success文本响应，表示收到通知成功。

异步通知示例

{
  "amount": "2.00",
  "appid": "4110",
  "complete_time": "2025-06-11 07:12:18",
  "mch_order_no": "1749640314670",
  "mchid": "34545451",
  "order_id": "1626914205565242368",
  "pay_type": "GLOBAL_CREDIT",
  "sign": "4894dfd8fa1eda17a1bc4b203412228b",
  "status": "nopay",
  "user_id": "qjharlpye",
  "consent_id": "98782249e7558da3"
}