接收付款通知

能力概览

Payout 结果通知

通知规则

接入方通知 URL 需要配置在接入方后台，否则不会发送结果通知，可配置通知结果的事件：payout.success、payout.fail
响应处理状态码为 200，代表通知接受成功，平台不会继续发送推送通知
通知如果接入方没有被正确响应，则平台会多次推送调用，规则如下：如果接入方未响应通知，则每隔 5 分钟推送 1 次，总共重试 5 次推送。

通知地址

接入方通知地址

通知参数

body

字段	数据类型	业务含义
callbackNo	String	平台生成的本次异步通知流水号
merchantId	String	接收通知的接入方标识
callbackBusi	String	通知所属业务类型，固定为 `online_payout`
callbackEvent	String	付款结果事件类型：`payout.success`/`payout.fail`
code	Int	本次通知对应的业务响应码
message	String	响应码对应的说明文案
data	`Object`	付款结果明细对象

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	用户联系地址或居住地址

推送示例

json

{
    "callbackNo": "OUT260509112601208845321_1",
    "merchantId": "MER74021658",
    "callbackBusi": "online_payout",
    "callbackEvent": "payout.success",
    "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"
        }
    }
}

接收付款通知 ​

能力概览 ​

通知规则 ​

通知地址 ​

通知参数 ​

推送示例 ​

接收付款通知

能力概览

通知规则

通知地址

通知参数

推送示例