模擬串接服務 - 收款帳戶設定

經銷商『收款帳戶設定』請求欄位
Id Name Description Type Additional Information
1 agent_uid 經銷商商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "ocp", "cmd": "api\/payoffbeneficiary" }
JSON格式,AES256加密資料
3 encry_data 『收款帳戶設定』欄位資料 string 必填
『收款帳戶設定』欄位參考
JSON格式,AES256加密資料
特約商店『收款帳戶設定』請求欄位
Id Name Description Type Additional Information
1 store_uid 特約商店商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "ocp", "cmd": "api\/payoffbeneficiary" }
JSON格式,AES256加密資料
3 encry_data 『收款帳戶設定』欄位資料 string 必填
『收款帳戶設定』欄位參考
JSON格式,AES256加密資料
收款帳戶設定』欄位
Id Name Description Type Additional Information
1 store_uid 特約商店商務代號 string 必填
2 user_data 收款人資訊 object 必填
『收款人資訊』欄位參考
3 success_returl 設定成功導頁連結 string
4 failure_returl 設定失敗導頁連結 string
5 homepage_url 返回首頁連結 string
6 return_url 收款帳戶設定完成後結果通知網址 string
收款帳戶設定』回傳欄位
Id Name Description Type Additional Information
1 code 執行狀態碼 string 『Pay Off 執行狀態碼』值參考
2 msg 執行狀態訊息 string
3 url 設定網址 string
4 uid UID(完成設定回報通知時驗證用) string
5 key 驗証碼(完成設定回報通知時驗證用) string
接收回報方式說明

接收到資料時,請主動回傳字串【8888】四個字元,確認完成。若貴司沒有回傳,系統會間隔十五分鐘傳送一次持續四次,若仍未接受到貴司回傳確認字串,系統即會停止傳送。

回報使用 HTTP Protocol的Post方式,內容格式為 application/x-www-form-urlencoded。

收款帳戶設定通知』回報欄位
Id Name Description Type Additional Information
1 uid UID string
2 key 驗証碼 string
3 code 狀態碼 string 『處理狀態碼』值參考
4 msg 狀態碼說明 string
5 finished_date 收款帳戶設定完成時間(格式:yyyyMMddHHmmss) string
6 store_uid 特約商店商務代號 string
7 user_id 收款人帳號 string
收款人資訊』欄位
Id Name Description Type Additional Information
1 user_id 收款人帳號 string 必填
2 user_real_name 收款人真實姓名 string
3 user_sn_type 1:身分證,2:統一證號,3:護照號碼 付款人為本國人為1,外國人2 or 3 int 『證號類型』值參考
4 user_sn 收款人身分證/統一證號/護照號碼 string
5 user_cellphone_code 收款人行動電話國碼 string
6 user_cellphone 收款人行動電話 string
7 user_email 收款人 E-Mail string
8 bank_code 收款人銀行帳戶:銀行代碼 string
9 bank_branch_code 收款人銀行帳戶: 分行代碼 string
10 bank_account_number 收款人銀行帳戶:銀行帳號 string
Pay Off 執行狀態碼』 值內容
Value Description Type Additional Information
100 資料不正確 string
400 系統錯誤 string
B200 執行成功 string
B500 執行失敗 string
處理狀態碼』 值內容
Value Description Type Additional Information
200 資料正確 string
A0002 未完成設定 string
250 設定成功 string
300 設定失敗 string
證號類型』 值內容
Value Description Type Additional Information
1 身份證字號(預設) integer
2 統一證號 integer
3 護照號碼 integer
AES256資料加密方式說明

1、所有的API送出HTTPs請求之欄位中,service 和 encry_data 欄位皆進行 AES256+BASE64 加密處理。
2、AES加密,格式為CBC,長度為256bits,金鑰長度32,IV長度16,傳遞內文為加密後組合IV並經過Base64轉換後傳出。

方式:
使用自訂的AES256函式將JSON資料加密後,再將IV資料和此AES256加密後的JSON資料串聯後,使用base64再進行加密成ASCII字串即可完成加密。

    PHP加密示意:
    AesEncrypt -> base64_ecode($IV . $JSON)

    C#加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> toBase64

    Java加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> toBase64

    Node.js加密示意:
    AesEncrypt -> concat([IV,JSON], [IV_SIZE,JSON_SIZE]) -> toString('base64')
    Python加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> base64.b64encode

範例程式碼