核验付款业务单据

能力概览

• Payout 业务单据核验

调用地址

• /pay/payout/orderDetail

请求参数

• body

字段	提交要求	数据类型	长度限制	业务含义
merchantId	是	String	32	平台分配给接入方的唯一商户标识
orderId	否	String	64	平台生成的付款业务订单号，与 merOrderId 二选一提交
merOrderId	是	String	64	接入方侧付款订单号，与 orderId 二选一提交

请求示例

{
  "merchantId": "MER74021658",
  "orderId": "OUT260509112601208845321"
}

响应参数

• data

字段	数据类型	业务含义
merchantId	String	当前付款订单所属的接入方标识
orderId	String	平台生成的付款业务订单号
paymentOrderId	String	平台付款处理流水号；人工付款场景返回为空
merOrderId	String	接入方提交的付款订单号
subMerId	String	二级接入方标识
orderType	String	订单所属的交易类型
paymentType	String	实际付款通道： stcpay：STCPay 付款 cardpay：银行卡付款
orderPaymentType	String	付款处理模式： standard：标准付款 rapid：快捷付款
orderStatus	Int	付款订单当前处理状态： 0：未付款 2：付款中 10：付款成功 20：付款失败
orderStatusDesc	String	付款状态说明文本
remarks	String	付款订单备注信息
paymentCreateTime	String	付款订单在平台创建的时间
paymentCompleteTime	String	付款订单处理完成的时间
amountInfo	Object	付款金额明细对象，结构见 Object:amountInfo
feeInfo	Object	手续费及扣款明细对象，结构见 Object:feeInfo
accountInfo	Object	收款账户资料对象，结构见 Object:accountInfo
customerInfo	Object	收款用户资料对象，结构见 Object:customerInfo

• Object:amountInfo

字段	数据类型	业务含义
orderCurrency	String	接入方提交的付款订单币种
orderAmt	String	接入方提交的付款订单金额
exchangeRate	String	订单币种与实际付款币种之间的换算汇率
paymentCurrency	String	换汇后用于执行付款的币种
paymentOrderAmt	String	换汇后对应的付款订单金额
paymentAmt	String	实际执行付款的金额

• Object:feeInfo

字段	数据类型	业务含义
feeType	Int	手续费扣收主体： 0：用户承担 1：接入方承担
feeCurrency	String	手续费计价币种
feeAmt	String	本笔付款产生的手续费金额
deductionCurrency	String	平台账户实际扣款币种
deductionAmt	String	平台账户实际扣减金额

• Object:accountInfo

字段	数据类型	业务含义
type	Int	收款账户类别： 0：未知 1：银行账户 2：STCPay 账户
account	String	收款账户标识，可能为 STCPay 账号或银行卡号
bankCode	String	平台银行编码；STCPay 付款场景返回为空
iban	String	用户 IBAN 账号；STCPay 付款场景返回为空
swiftCode	String	用户开户银行 Swift Code；STCPay 付款场景返回为空
bankAddress	String	用户开户银行地址；STCPay 付款场景返回为空

• Object:customerInfo

字段	数据类型	业务含义
merCustomerId	String	接入方系统内的用户标识
enFirstName	String	用户英文名的 first name
enMiddleName	String	用户英文名的 middle name
enLastName	String	用户英文名的 last name
arFirstName	String	用户阿拉伯文姓名的 first name
arMiddleName	String	用户阿拉伯文姓名的 middle name
arLastName	String	用户阿拉伯文姓名的 last name
idNumber	String	用户身份证件号码
idPhoto	String	用户身份证件照片访问地址
signedPhoto	String	用户签名照片访问地址
mobile	String	用户沙特手机号
email	String	用户邮箱地址
address	String	用户联系地址或居住地址

响应示例

{
  "code": 10000,
  "message": "success",
  "data": {
    "merchantId": "MER74021658",
    "orderId": "OUT260509112601208845321",
    "paymentOrderId": "PYT260509113029309732114",
    "merOrderId": "PO202605090001",
    "subMerId": "SME81573042",
    "orderType": "online_payout",
    "paymentType": "cardpay",
    "orderPaymentType": "standard",
    "orderStatus": 10,
    "orderStatusDesc": "Payment successful",
    "remarks": "Supplier settlement batch A",
    "paymentCreateTime": "2026-05-09 11:26:01",
    "paymentCompleteTime": "2026-05-09 11:31:40",
    "amountInfo": {
      "orderCurrency": "SAR",
      "orderAmt": "258.75",
      "exchangeRate": "1",
      "paymentCurrency": "SAR",
      "paymentOrderAmt": "258.75",
      "paymentAmt": "258.75"
    },
    "feeInfo": {
      "feeType": 1,
      "feeCurrency": "SAR",
      "feeAmt": "2.50",
      "deductionCurrency": "SAR",
      "deductionAmt": "261.25"
    },
    "accountInfo": {
      "type": 1,
      "account": "4111111111112222",
      "bankCode": "SAU0009",
      "iban": "SA0380000000608010167519",
      "swiftCode": "RJHISARI",
      "bankAddress": "Al Rajhi Bank, Riyadh"
    },
    "customerInfo": {
      "merCustomerId": "CUS20260509001",
      "enFirstName": "Fahad",
      "enMiddleName": "Omar",
      "enLastName": "Saleh",
      "arFirstName": "فهد",
      "arMiddleName": "عمر",
      "arLastName": "صالح",
      "idNumber": "1098765432",
      "idPhoto": "https://cdn.example.com/images/customer/20260509/8b63f1a42d7e4c9aa12d87f30e61c5b2.jpg",
      "signedPhoto": "https://cdn.example.com/images/customer/20260509/3f24d9b7a5e84c11b9804a6552f8d731.png",
      "mobile": "0559876543",
      "email": "fahad.saleh@example.com",
      "address": "King Fahd Road, Riyadh"
    }
  }
}