網站整合 PayPal 付款：自訂表單建立與 IPN 非同步通知處理

核心概念

PayPal 提供「傻瓜式按鈕建立」，但實務上需根據訂單動態產生表單。關鍵在於 IPN (Instant Payment Notification)：付款完成後，PayPal 主動 POST 交易資料到你的 notify_url，伺服器端驗證後更新訂單狀態。

最小必要表單

<form action="https://www.sandbox.paypal.com/cgi-bin/webscr" method="post">
  <input type="hidden" name="cmd" value="_xclick">
  <input type="hidden" name="business" value="merchant@example.com">
  <input type="hidden" name="item_name" value="商品名稱">
  <input type="hidden" name="amount" value="5.95">
  <input type="hidden" name="currency_code" value="USD">
  <input type="hidden" name="return" value="https://yoursite.com/payment/success">
  <input type="hidden" name="cancel_return" value="https://yoursite.com/payment/cancel">
  <input type="hidden" name="notify_url" value="https://yoursite.com/payment/ipn">
  <input type="hidden" name="custom" value="ORDER_20240101_001">
  <input type="hidden" name="rm" value="2">
  <input type="image" src="https://www.sandbox.paypal.com/en_US/i/btn/btn_buynowCC_LG.gif" border="0" alt="PayPal 付款">
</form>

IPN 處理頁面 (ipn.php) 關鍵邏輯

1. 接收 $_POST 所有參數
2. 原樣加上 cmd=_notify-validate POST 回 PayPal
3. 判斷回應：VERIFIED / INVALID
4. VERIFIED 時必須四檢：
   • payment_status == 'Completed'
   • txn_id 未處理過（防重放）
   • receiver_email 為己方商家信箱
   • 金額、幣別、商品編號與訂單一致
5. 通過則更新訂單、發貨、送通知

設定 IPN URL

PayPal 後台 → Profile → My selling tools → Instant payment notifications → Update → 選擇「Receive IPN messages」→ 填入你的 https://yoursite.com/payment/ipn。

常見坑與對策