A+ Mall 商戶開發者文檔

幣別 TWD（新台幣） · Base URL https://api.aplusmall.cash

所有介面支援 POST / GET，Content-Type: application/x-www-form-urlencoded。請先向我方取得商戶號 cus_code 與密鑰 secret_key。 回調來源 IP 54.199.155.234 請務必放行，否則收不到回調。

一、介面地址

用途	地址
代收提交	`POST /api/payment/deposit`
代收查詢	`POST /api/payment/info`
代付提交	`POST /api/charge/receive`
代付查詢	`POST /api/charge/info`
餘額查詢	`POST /api/inquire/account/info`

二、簽名規則

取所有請求參數（排除 sign 與空值），按參數名 ASCII 升序排列。
拼接 key1=value1&key2=value2&...，末尾追加 &key=<secret_key>。
對整串做 MD5、轉小寫，得到 sign。

⚠️ 金額固定兩位小數（如 2000.00）；value 做 URL-encode，空格編碼為 %20（非 +）。

範例

參數：cus_code=MCH001, cus_order_sn=T20260916001, payment_flag=bank_twd, amount=2000.00
待簽字串（ASCII 升序）：
amount=2000.00&cus_code=MCH001&cus_order_sn=T20260916001&payment_flag=bank_twd&key=你的密鑰
sign = md5(上面整串) 轉小寫

三、代收下單 `/api/payment/deposit`

參數	必填	說明
`cus_code`	✓	商戶號
`cus_order_sn`	✓	貴司訂單號（唯一）
`payment_flag`	✓	`bank_twd`（銀行卡）
`amount`	✓	金額，兩位小數字串（如 `2000.00`）
`notify_url`	選	非同步回調地址
`redirect_url`	選	付款完成跳轉
`payer_name`	選	付款人姓名
`sign`	✓	見第二節

回應

{
  "result": 1, "status": "200", "message": "Success",
  "order_info": {
    "order_sn": "AP...",           // 我方訂單號
    "cus_order_sn": "T20260916001",
    "currency_type": "TWD",
    "order_amount": "2000.00",
    "payment_uri": "https://cashier.aplusmall.cash/pay/xxxx",  // 收銀台，交付款人
    "order_status": "pending",
    "expired_at": "...", "created_at": "..."
  }
}

四、代付下單 `/api/charge/receive`

參數	必填	說明
`cus_code` / `cus_order_sn` / `amount` / `sign`	✓	同代收
`payment_flag`	✓	`pay_bank_twd`
`account_name`	✓	收款人姓名
`bank_account`	✓	收款銀行帳號
`bank_name` / `bank_code`	✓	收款銀行名稱 / 代碼
`bank_branch` / `province` / `city`	選	分行 / 省 / 市
`notify_url` / `attach_data`	選	回調地址 / 附加資料（原樣回傳）

五、查詢介面

代收查詢 /api/payment/info、代付查詢 /api/charge/info、餘額查詢 /api/inquire/account/info。

查詢參數：cus_code + order_sn（我方訂單號）+ sign。

六、非同步回調（notify_url）

我方以 POST 推送支付結果到貴司 notify_url（來源 IP 54.199.155.234）。驗簽方式與下單一致。貴司處理成功後須回傳純文字 success，否則我方會重試。

欄位	說明
`order_sn` / `cus_order_sn`	我方 / 貴司訂單號
`currency_type`	`TWD`
`original_amount` / `order_amount`	原始 / 訂單金額（兩位小數字串）
`status`	`success` / `fail` / 其他
`message`	結果說明
`receive_amount` / `fee_amount`	實際到帳 / 手續費
`bank_name` / `bank_account` / `account_name`	代付收款資訊（代付回調）
`attach_data`	下單時的附加資料，原樣回傳
`sign`	驗簽用

七、訂單狀態

狀態	說明
`pending`	待付款 / 處理中
`success`	成功（入帳）
`fail`	失敗
`cancel`	取消
`expired`	逾時未付款

八、對接流程

貴司放行回調 IP 54.199.155.234、提供 notify_url。
我方開通商戶號，回傳 cus_code + secret_key。
先代收／代付各一筆小額測試單，確認回調與驗簽通過後上量。

A+ Mall · api.aplusmall.cash · 本文件為對接技術規範