智付通API

簡化實作智付通付款流程與相關功能串接

已實作功能

• MPG API (v1.2)
• Periodical API (v1.0)
• CreditCard Collect Refund API (v1.0)
• CreditCard DeAuthorize API (v1.0)
• Transaction API

範例

MPG Service

• 付款(建立付款表單)

const SpGateway = require("spgateway-api");

const spgateway = new SpGateway(
    true, //(true for a dry run)
    your MerchantID,
    your HashKey,
    your HashIV,
    true // if you want to print info in console to debug. default is false
);

const mpgService = spgateway.createMpgService();

// crate payModel
let payModel = mpgService.createMpgPayModel();
// set properties
payModel.MerchantOrderNo = "myordernohere";
payModel.NotifyURL = "http://mysite.com/api/spgateway/notify";
payModel.ReturnURL = "http://mysite.com/api/spgateway/return";
payModel.ClientBackURL = "http://mysite.com/shop";
payModel.Amt = 928;
payModel.ItemDesc = "ProductX";

// create payform
let payFormHtml = mpgService.getAutoPayForm(payModel);

• 接收通知(notify & return)

// take express request as example
let JSONData = request.body.JSONData;

mpgService
  .parseNotification(JSONData)
  .then((notify) => {
      // update your order here
  })
  .catch((err) => {
      // exception or checkCode validation fails
  })

Period Service (定期定額)

• 付款(建立付款表單)

let periodService = spgateway.createPeriodicalService();
let payModel = periodService.createPeriodicalPayModel();

// set properties
payModel.PeriodAmt = 829;

// create pay form html
let payFormHtml = periodService.getAutoPayForm(payModel);

• 接收通知(notify & return)

// take express request as example
let body = request.body; // it would be { "Period": "xxxxx..." }

periodService
  .parseNotification(body)
  .then((notify) => {
      // update your order here
  })
  .catch((err) => {
      // exception or checkCode validation fails
  })

交易查詢

let tradeInfoService = spgateway.createTradeInfoService();

tradeInfoService.queryOrder("yourOrderNoHere", 200)
  .then((model) => {
    // success

  })
  .catch((err) => {
    // if check value validation fails or exception
  })
  

信用卡取消授權

let cardCancelService = spgateway.createCreditCardCancelService();

cardCancelService
  .CancelTransaction("yourOrderNoHere", 200)
  .then((model) => {
      // success
      
  })
  .catch((err) => {
     // if status !== success or exception
  })
  

信用卡請/退款

let cardloseService = spgateway.createCreditCardCloseService();

// 請款
cardloseService
  .requestPayment("yourOrderNoHere", 200)
  .then((model) => {
    
  })
  .catch((err) => {
    
  })
  
// 退款
cardloseService
  .refund("yourOrderNoHere", 200)
  .then((model) => {
    
  })
  .catch((err) => {
    
  })
  

Debug Logger

const spgateway = new SpGateway(
        true, //(true for a dry run)
        your MerchantID,
        your HashKey,
        your HashIV,
        true // if you want to print info to debug, default is false
    );
        

關於

歡迎 fork & pull request