拉卡拉APP支付接口對接全攻略，APP內喚起支付
今天這篇關于APP支付API對接的東西，你要是正打算做，花五分鐘看完，能省你不少事情。
一：APP服務場景確認
好多人一上來就問我"接支付多少錢"，我說你先別問錢，你先告訴我你APP是干嘛的。商城賣貨？會員充值？還是那種O2O上門服務？不一樣。拉卡拉這邊APP支付主要分幾個場景：
APP內喚起支付：用戶在你們APP里點付款，跳拉起拉卡拉收銀臺（或直接彈支付窗口），輸密碼完事。這就是APP支付API的標準場景，也是用得最多的。
APP＋H5混合場景：你們APP里嵌了網頁，頁面里要付款。這種得走H5支付，別跟APP支付搞混了——接口參數不一樣，搞混了聯調聯一天都是白搭。
APP后臺代扣/免密：比如自動續費會員、分期還款。這個得單獨簽約，風控更嚴，審核也慢點，不是開了基礎支付就有的。
所以第一步就想清楚到底要哪種，別上來就說"我什么都接"，那你錢也得多花。
二：APP對接流程
| 環節 | 要干嘛 | 代理商血淚提醒 |
|---|---|---|
| 商戶入網 | 執照＋法人身份證＋開戶行許可證＋APP截圖＋ICP備案（如果有），提交到拉卡拉商戶后臺 | APP還沒上架？提供測試包也行。但有些接口要等APP上架才全開，提前問清楚 |
| 支付產品簽約 | 簽"移動支付"或"APP支付"產品協議，確定費率 | 費率可談！尤其是量大的，別傻乎乎默認簽。下面會講 |
| 技術聯調 | 拿到商戶號mchid、APIv3密鑰、證書，看文檔接入下單接口+支付回調接口 | 用POSTMAN先調通再寫代碼，別一上來就敲，浪費時間 |
| 測試驗證 | 測試環境跑全流程：下單→支付→回調→查單→退款 | 1分錢測完全部，別跳步。尤其退款接口，很多人上線了才想起沒測過 |
| 切生產上線 | 替換生產環境密鑰和證書，再做一輪生產驗證交易 | 記住了：測試密鑰和生產密鑰是兩套！多少人半夜上線才發現付不了 |
三：接口技術細節
拉卡拉支付API走的是HTTPS＋簽名驗證這套，跟微信支付寶的邏輯差不多，搞過支付開發的基本能無縫上手。
核心就三個接口你得搞定：統一下單（后端調、拿預支付憑證）、支付回調（異步通知、改訂單狀態）、訂單查詢（兜底用的，回調沒收到就來查一把）。退款接口也算一個，但那是后賬。
參數里sign簽名這塊是重災區。拉卡拉的簽名規則是：把參數按一定規則排序、拼接、加上密鑰、MD5/SHA256哈希。不難，但參數名大小寫、空值處理、編碼（UTF-8別搞成GBK）這種小地方，能卡你半天。建議直接用官方SDK，別自己手寫簽名算法——五年來我見過自己寫的沒有一個第一次就跑通的。
四：接口費率標準
APP支付標準費率一般0.38%上下。如果你的流水大，月交易額過百萬，可以談。0.3%甚至更低我都見過，前提是你量夠。
但注意——有些代理商會給你報很低然后偷偷加"年費""服務費"之類的。拉卡拉官方沒有這些亂七八糟的東西。凡是跟你收額外年費的，八成是中間商加碼。直接找一級代理商或者官方渠道，價格透明。
提現手續費單筆1元或按比例，單筆金額小的注意成本。另外，APP支付的結算周期一般是T+1，上午的款次日上午到，下午的款次日到。少數優質商戶能開D+1甚至D+0，但這得另簽協議。
五：常見的APP接口問題
回調地址配錯了。拉卡拉后臺填的回調URL，必須跟代碼里驗簽的那條一模一樣。多一個斜杠都不行。測試環境配的localhost，上線忘了改，然后回調全部404——錢是扣了，訂單不更新，客服電話被打爆。
證書過期了沒人管。API證書有有效期，到期了接口直接報錯。沒人盯著的話，哪天突然就"支付不可用"了。建議日歷上設個提醒，到期前一個月續。
訂單號重復。統一下單的商戶訂單號必須唯一。有人圖省事用時間戳，高并發下連著兩筆同一個號，后面那筆直接失敗。推薦用雪花算法或者UUID。
退款沒加白名單。退款IP要在拉卡拉后臺加白名單，不然調退款接口直接拒絕。這個不起眼但卡了好多人。