支付模块
Du kan inte välja fler än 25 ämnen Ämnen måste starta med en bokstav eller siffra, kan innehålla bindestreck ('-') och vara max 35 tecken långa.

boc.go 11 KiB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. package md
  2. type MacaoBOCPublicParameter struct {
  3. RequestId string `json:"requestId" name:"商戶系統請求流水號" label:"建議同一商户每次請求保持唯一,作為技術核實問題的快捷要素"`
  4. Service string `json:"service" name:"接口類型" label:"原樣返回請求參數頭中的service"`
  5. Version string `json:"version" name:"接口版本" label:"當前文檔接口版本送值:2.0"`
  6. IpAddress string `json:"ipAddress" name:"用戶瀏覽器IP地址" label:"非必传"`
  7. SignType string `json:"signType" name:"固定值RSA2" label:"當前僅支持RSA2"`
  8. MerchantId string `json:"merchantId" name:"合作商戶編號" label:"中銀智慧付給合作商戶分配的唯一標識"`
  9. TerminalNo string `json:"terminalNo" name:"終端號" label:"長度8位數字,進件時生成終端號。可在商戶管理端的“商戶管理”模塊查詢。"`
  10. MerchantSign string `json:"merchantSign" name:"簽名串" label:"簽名機制詳見2.1"`
  11. }
  12. //注:交易的成功與否不用根據returnCode判斷,請根據返回參數中result判斷,result爲空就是交易失敗,returnMessage是對應失敗的原因。result返回A,Z,需發起查詢判斷具體交易狀態。
  13. // 若接口報文頭應答參數中的【returnCode】欄位返回值爲【888888】表示中銀智慧付系統在進行升級維護,
  14. //此時中銀智慧付系統無法提供支付能力。商戶系統需要在合適的位置展示【returnMessage】
  15. //欄位中的信息友好的告知用戶此項功能暫不可用。
  16. type MacaoBOCPublicResponse struct {
  17. RequestId string `json:"requestId" name:"商戶系統請求流水號" label:"建議同一商户每次請求保持唯一,作為技術核實問題的快捷要素"`
  18. Service string `json:"service" name:"接口類型" label:"原樣返回請求參數頭中的service"`
  19. Version string `json:"version" name:"接口版本" label:"當前文檔接口版本送值:2.0"`
  20. SignType string `json:"signType" name:"固定值RSA2" label:"當前僅支持RSA2"`
  21. MerchantId string `json:"merchantId" name:"合作商戶編號" label:"中銀智慧付給合作商戶分配的唯一標識"`
  22. TerminalNo string `json:"terminalNo" name:"終端號" label:"長度8位數字,進件時生成終端號。可在商戶管理端的“商戶管理”模塊查詢。"`
  23. ReturnCode string `json:"returnCode" name:"返回信息碼" label:"000000-成功。返回碼請參照附錄"`
  24. ReturnMessage string `json:"returnMessage" name:"返回信息碼描述" label:"返回信息提示。"`
  25. ServerSign string `json:"serverSign" name:"簽名串" label:"簽名機制詳見2.1"`
  26. }
  27. type CreateBocPayAppTradeReq struct {
  28. MacaoBOCPublicParameter
  29. Amount string `json:"amount" name:"订单金額" label:"以分爲單位,如1元表示爲100"`
  30. OriginalAmount string `json:"originalAmount" name:"原订单金额" label:"以分爲單位,如1元表示爲100若无优惠请跟订单金额【amount】一致"`
  31. MerchantPreferentialCnName string `json:"merchantPreferentialCnName" name:"商户系统优惠活动中文名称" label:"非必传"`
  32. MerchantPreferentialEnName string `json:"merchantPreferentialEnName" name:"商户系统优惠活动英文名称" label:"非必传"`
  33. Subject string `json:"subject" name:"訂單標題" label:"非必传,用戶支付完成後顯示在手機上的訂單名稱"`
  34. ProductDesc string `json:"productDesc" name:"商品描述" label:"非必传,對一筆交易的具體描述信息,如果是多種商品,請將商品描述字符串累加傳給body。特殊字符不支持"`
  35. MercOrderNo string `json:"mercOrderNo" name:"商戶系統消費訂單號" label:"商戶系統必須確保該訂單號在商戶系統是唯一的不能包含單引號“’”、尖括號“<”“>”和逗號“,”"`
  36. OrderDate string `json:"orderDate" name:"訂單創建日期" label:"格式:yyyyMMdd"`
  37. OrderTime string `json:"orderTime" name:"訂單創建時間" label:"格式:HHmmss"`
  38. ValidNumber string `json:"validNumber" name:"有效期" label:"單位:秒 默認值1200"`
  39. NotifyUrl string `json:"notifyUrl" name:"支付結果後台通知地址" label:"支付通知地址(后缀),商户在商戶服務管理後台配置好通知地址(域名)后,聚合平台会将域名和后缀拼接组成完整的通知地址,并在订单支付成后向此通知地址发送支付结果通知。"`
  40. Reserved1 string `json:"reserved1" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  41. Reserved2 string `json:"reserved2" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  42. Reserved3 string `json:"reserved3" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  43. }
  44. type CreateWeChatTradeReq struct {
  45. MacaoBOCPublicParameter
  46. Amount string `json:"amount" name:"订单金額" label:"以分爲單位,如1元表示爲100"`
  47. OriginalAmount string `json:"originalAmount" name:"原订单金额" label:"以分爲單位,如1元表示爲100若无优惠请跟订单金额【amount】一致"`
  48. MerchantPreferentialCnName string `json:"merchantPreferentialCnName" name:"商户系统优惠活动中文名称" label:"非必传"`
  49. MerchantPreferentialEnName string `json:"merchantPreferentialEnName" name:"商户系统优惠活动英文名称" label:"非必传"`
  50. Subject string `json:"subject" name:"訂單標題" label:"非必传,用戶支付完成後顯示在手機上的訂單名稱"`
  51. ProductDesc string `json:"productDesc" name:"商品描述" label:"非必传,對一筆交易的具體描述信息,如果是多種商品,請將商品描述字符串累加傳給body。特殊字符不支持"`
  52. MercOrderNo string `json:"mercOrderNo" name:"商戶系統消費訂單號" label:"商戶系統必須確保該訂單號在商戶系統是唯一的不能包含單引號“’”、尖括號“<”“>”和逗號“,”"`
  53. OrderDate string `json:"orderDate" name:"訂單創建日期" label:"格式:yyyyMMdd"`
  54. OrderTime string `json:"orderTime" name:"訂單創建時間" label:"格式:HHmmss"`
  55. ValidNumber string `json:"validNumber" name:"有效期" label:"單位:秒 默認值1200"`
  56. NotifyUrl string `json:"notifyUrl" name:"支付結果後台通知地址" label:"支付通知地址(后缀),商户在商戶服務管理後台配置好通知地址(域名)后,聚合平台会将域名和后缀拼接组成完整的通知地址,并在订单支付成后向此通知地址发送支付结果通知。"`
  57. SubAppId string `json:"subAppId" name:"子商戶AppId" label:"微信分配的子商户公众账号或小程序Id。"`
  58. SubOpenId string `json:"subOpenId" name:"子商戶用戶唯一Id" label:"用戶在子商戶appId下的唯一標識。下單前商戶需要調用微信【網頁授權獲取用戶信息】接口獲取到用戶的OpenId。詳情查看附錄5.5.1章節"`
  59. TransWay string `json:"transWay" name:"交易方式" label:"B3-公众号支付B4-小程序支付"`
  60. Reserved1 string `json:"reserved1" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  61. Reserved2 string `json:"reserved2" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  62. Reserved3 string `json:"reserved3" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  63. }
  64. type CreateQRTradeReq struct {
  65. MacaoBOCPublicParameter
  66. Amount string `json:"amount" name:"订单金額" label:"以分爲單位,如1元表示爲100"`
  67. OriginalAmount string `json:"originalAmount" name:"原订单金额" label:"以分爲單位,如1元表示爲100若无优惠请跟订单金额【amount】一致"`
  68. MerchantPreferentialCnName string `json:"merchantPreferentialCnName" name:"商户系统优惠活动中文名称" label:"非必传"`
  69. MerchantPreferentialEnName string `json:"merchantPreferentialEnName" name:"商户系统优惠活动英文名称" label:"非必传"`
  70. Subject string `json:"subject" name:"訂單標題" label:"非必传,用戶支付完成後顯示在手機上的訂單名稱"`
  71. ProductDesc string `json:"productDesc" name:"商品描述" label:"非必传,對一筆交易的具體描述信息,如果是多種商品,請將商品描述字符串累加傳給body。特殊字符不支持"`
  72. PayChannel string `json:"payChannel" name:"支付方式" label:"BOCPAY - 澳门中银手机银行ALIPAY - 支付宝WECHATPAY - 微信支付TAIFUNGPAY - 豐付寶ICBCEPAY - 工銀E支付MPAY - 澳門通LUSOPAY - 國際銀行UEPAY - 極易付CGBPAY - 廣發MPGS - 銀行卡支付網關UNIONPAYQR - 雲閃付ALL -以上渠道聚合码支持多選使用|分割注:當本接口上送的productCode為MOBILEWEB時,payChannel只能單選,且不能上送ALL"`
  73. ProductCode string `json:"productCode" name:"產品渠道编码" label:"PCWEB網站支付MOBILEWEB-移動支付AUTO-根据UA信息自动识别"`
  74. MercOrderNo string `json:"mercOrderNo" name:"商戶系統消費訂單號" label:"商戶系統必須確保該訂單號在商戶系統是唯一的不能包含單引號“’”、尖括號“<”“>”和逗號“,”"`
  75. OrderDate string `json:"orderDate" name:"訂單創建日期" label:"格式:yyyyMMdd"`
  76. OrderTime string `json:"orderTime" name:"訂單創建時間" label:"格式:HHmmss"`
  77. ValidNumber string `json:"validNumber" name:"有效期" label:"單位:秒 默認值1200"`
  78. NotifyUrl string `json:"notifyUrl" name:"支付結果後台通知地址" label:"支付通知地址(后缀),商户在商戶服務管理後台配置好通知地址(域名)后,聚合平台会将域名和后缀拼接组成完整的通知地址,并在订单支付成后向此通知地址发送支付结果通知。"`
  79. Reserved1 string `json:"reserved1" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  80. Reserved2 string `json:"reserved2" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  81. Reserved3 string `json:"reserved3" name:"商戶備用字段" label:"交易成功后原樣返回給商戶"`
  82. Supplier string `json:"supplier" name:"供貨商名字" label:"非必传,顯示供貨商名字"`
  83. ReferUrl string `json:"referUrl" name:"二級商戶網址" label:""`
  84. BusinessType string `json:"businessType" name:"業務類型" label:"業務類型。該欄位僅支持以下5類入參:
  85. 1:飯店
  86. 2:航空
  87. 3:留學
  88. 4:貿易
  89. 5:其他,包含所有不屬於前四類的其他業務類型。例如,流量充值,機場接機服務等。若業務類型超過一種,則傳入多個且用分隔號(|)分隔。"`
  90. GoodsInfo string `json:"goodsInfo" name:"商品信息" label:"包含商品的SKU名和相应的数量,格式为 SKU_名^数量。若存在超过一件商品,用竖线(|)分隔。备注:仅在businessType字段值为4时,本字段为必填。"`
  91. TotalQuantity string `json:"totalQuantity" name:"備註:僅在businessType欄位值為4時,本欄位為必填"`
  92. }