消息通知
## 消息通知
1.1 功能说明
以http post请求方式向合作方发送消息通知,共8 次通知,除了第一次是实时通知,后续的每次重试都会间隔一段时间,间隔频率一般是:2m、2m、5m、10m、30m、1h、2h(第二次通知发送是在第一次发送失败后的 2 分钟;第三次通知是在第二次投递失败后的 2 分钟,以此类推)。
1.2 使用说明
- 联系平台技术人员配置通知地址,http(s)形式
- 合作方收到通知后,**使用平台提供的公钥进行验签**,通过则进一步进行自身业务处理,**并输出"success"(不含双引号)** 表明已成功收到通知,否则平台将视为通知处理失败将进行重试机制。
平台通知验签公钥:
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsTXKrNVHT3Fmgyb8HP+hT0GlLDbAcwYUqZqusK6VOHZIKd69l4VpcyqVO9B2v/O5tGDNBYpOt2mlcXUP710Mnb402LBz2LV/70AMgFlxMoMtFK3U1nieGUcPwG/VjBnowZB2XwbIGYbBL2ESpTI98cM766nSs7hT50119m16pUzAAPVsXhK2ViGEYe5xryOvBuVzuaR34ct8eC4V6prBxafd7CRnyNExUbd/VV3F2DQMnIeOuRIV7r6pYoTdEPySNQBVTC3Qmlo54QN6hyVJ7HFHgFHRG73ElCA7fWbj8dPcuw31x43bByCrH2aniU76751QqriEYPoQ/P3iTak3XwIDAQAB
1.3 公共请求参数
|参数|类型(长度)|是否必填|描述|示例值|
|-|-|-|-|-|
|version|String(5)|不可空|接口版本,设置为1.0|1.0|
|partner_id|String(32)|不可空|平台分配给合作方唯一ID|2088846548420055|
|charset|String(10)|不可空|编码格式,设置为utf-8|utf-8|
|sign|String(256)|不可空|签名||
|sign_type|String(10)|不可空|签名方式只支持RSA||
1.4 业务请求参数
|参数|类型(长度)|是否必填|描述|示例值|
|-|-|-|-|-|
|notify_id|String(32)|不可空|通知id|1649240248731217921|
|notify_type|String(32)|不可空|通知类型,可选值有<br/>ACCOUNT_INCOME:来账通知|ACCOUNT_INCOME|
|notify_data|String(32)|不可空|通知内容,具体字段随通知类型变化,详见下表||
|notify_time|String(32)|不可空|通知发送的时间,yyyyMMddHHmmss格式|20230420143613|
1.5 响应参数
success
### 来账通知
|参数|类型(长度)|是否必填|描述|示例值|
|-|-|-|-|-|
|trans_no|String(64)|不可空| 入账流水号||
|payer_bank_org_id|String(64)|不可空|付款方银行机构号||
|payer_card_name|String(128)|不可空|付款方户名||
|payer_card_no|String(32)|不可空|付款方卡号||
|payee_card_name|String(128)|不可空|收款方户名||
|payee_card_no|String(32)|不可空|收款方卡号||
|transfer_amount|String(32)|不可空| 转账金额 **(单位:分)**|1000|
|transfer_date|String(32)|不可空|转账时间,yyyyMMddHHmmss格式|20230420143613|
|memo|String(32)|可空|备注||
来账通知示例
```json
{
"charset": "UTF-8",
"notify_data": "{\"memo\":\"这是备注\",\"payee_card_name\":\"测试收款方户名\",\"payee_card_no\":\"99999999999999999\",\"payer_bank_org_id\":\"302100022654\",\"payer_card_name\":\"测试付款方户名\",\"payer_card_no\":\"123456789\",\"trans_no\":\"SP2023041812120590019001750006416865\",\"transfer_amount\":\"1000\",\"transfer_date\":\"20230420161447\"}",
"notify_id": "1649240248731217921",
"notify_time": "20230421103501",
"notify_type": "ACCOUNT_INCOME",
"partner_id": "2266100000873268723",
"sign": "ajmpsFrjFPwsccd4IBJNBWGEXErdVIkM4/WCJQboplrKqVfD0qhgGnYWvvzMZ1Ip/zwCowJwENUBWskmFf9XCOwICrpyhn2c/T9xwUj2MPeBk3G9mtA5xewc0UuEQc0t1s/lSZCu51GZT/PSWPTwvhjdUQdhQ9q0neAOO3XCvLQegZbxsLhzJMOZG6moQKwryybsreyO3fxBxiLWe05UXzWByrICCjdNihY+s2mNlP3swpnaMMUy3jz3nws+4f0pmvWtOXrN25tcwjZW3B+ZhxJfitRliEoDvpQeEO40zg9VTfdMRznkP8c7KtdNT9DCaFgzzf2dRCaJXXJtq4n6WQ==",
"sign_type": "RSA",
"version": "1.0"
}
```