這是歐付寶 API 的 Ruby 包裝，更多資訊參考他們的官方文件。
- 這不是 Rails 插件，只是個 API 包裝。
- 使用時只需要傳送需要的參數即可，不用產生檢查碼，
allpay_client會自己產生。 - 錯誤代碼太多且會不斷增加，筆者不另行撰寫，官方也建議查網站上的代碼清單。
gem install allpay_clienttest_client = Allpay::Client.new(mode: :test)
production_client = Allpay::Client.new({
merchant_id: 'MERCHANT_ID',
hash_key: 'HASH_KEY',
hash_iv: 'HASH_IV'
})
test_client.request '/Cashier/QueryTradeInfo',
MerchantTradeNo: '0457ce27',
TimeStamp: Time.now.to_i歐付寶共有 5 個 API：
- /Cashier/AioCheckOut
- /Cashier/QueryTradeInfo
- /Cashier/QueryPeriodCreditCardTradeInfo
- /CreditDetail/DoAction
- /Cashier/AioChargeback
每個 API 有哪些參數建議直接參考歐付寶文件，注意幾點：
- 使用時不用煩惱
MerchantID與CheckMacValue，正如上述範例一樣。 /Cashier/AioCheckOut回傳的內容是 HTML，這個請求應該是交給瀏覽器發送的，所以不應該寫出client.request '/Cashier/AioCheckOut'這樣的程式碼。
| 實體方法 | 回傳 | 說明 |
|---|---|---|
request(path, **params) |
Net::HTTPResponse |
發送 API 請求 |
make_mac(**params) |
String |
用於產生 CheckMacValue，單純做加密，params 需要完整包含到 MerchantID |
verify_mac(**params) |
Boolean |
用於檢查收到的參數，其檢查碼是否正確，這用在歐付寶物的 ReturnURL 與 PeriodReturnURL 參數上。 |
query_trade_info(merchant_trade_number, platform = nil) |
Hash |
/Cashier/QueryTradeInfo 的捷徑方法，將 TimeStamp 設定為當前時間 |
query_period_credit_card_trade_info(merchant_trade_number) |
Hash |
/Cashier/QueryPeriodCreditCardTradeInfo 的捷徑方法，將 TimeStamp 設定為當前時間 |
generate_checkout_params |
Hash |
用於產生 /Cashier/AioCheckOut 表單需要的參數，MerchantTradeDate、MerchantTradeNo、PaymentType，可省略。 |
git clone [email protected]:tonytonyjan/allpay.git
cd allpay
bundle install
ruby examples/server.rb
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent