Integrate PX QRCode Pay

Description

PX Pay 條碼支付。
PX Pay 金流參數：加密金鑰、特店門市代號、特店英文名稱
情境：

• 依廠商金流參數設定進行付款：金流參數為必填、門市代碼不需要填
• 依全通路金流參數設定進行付款：門市代碼為必填、金流參數不需要填

Resource

POST /v1/payment/integrate/pay

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。

Request Body Parameters

Name	Type	Description
type	string	付款方式，請輸入 PX_QRCODE_PAY
request	Request	請求參數
store_id	string	門市代碼 (optional)
is_test	boolean	是否為測試環境 在全通路正式環境預設為false 在全通路測試環境預設為true (optional)

Request Body Parameters - Request

Name	Type	Description
verify_code	string	加密金鑰 (optional)
store_id	string	特店門市代號 (optional)
store_english_name	string	特店英文名稱 (optional)
store_name	string	特店門市名稱
pos_id	string	特店 POS 機號
pos_trade_time	string	特店 POS 機交易時間(yyyyMMddHHmmss) ex：20210101120901
mer_trade_no	string	特店交易序號，支援英數字 需為系統唯一值
gate_trade_no	string	Gateway 平台交易序號 若交易透過 Gateway 平台，此欄位必填 需為系統唯一值 (optional)
pay_token	string	全支付或錢包支付碼
trans_id	string	交易識別碼 特店若整合會員請填入「會員資料查詢」回覆的 trans_id (optional)
amount	integer	訂單金額，無號正整數
none_discount_amount	integer	不可使用 PXPoint 或錢包點數折抵金額，「無」不可折抵金額請填 0 ex：菸品
none_feedback_amount	integer	不可回饋金額，「無」不可回饋金額請填 0 用以計算 PXPoint 回饋時使用 ex：遊戲點數(實際不可回饋金額由特店及全支付或錢包另行約定)
req_time	string	發送日期時間(yyyyMMddHHmmss) ex：20210101120901
remark1	string	預留欄位 (optional)
remark2	string	預留欄位 (optional)
remark3	string	預留欄位 (optional)
marketing	Marketing	共同行銷活動
products	Product	購買商品

Request Body Parameters - Marketing

Name	Type	Description
marketing_code	string	共同行銷活動代碼 (optional)
amount	integer	商品金額 (optional)
qty	integer	數量 (optional)

Request Body Parameters - Product

Name	Type	Description
name	string	商品名稱 (optional)
amount	integer	商品金額 (optional)
qty	integer	數量 (optional)

Request

{
  "type": "PX_QRCODE_PAY",
  "request": {
    "verify_code": "0BD5507B08D44058AA9E560F859B98E8CED0C5AF2F9D4A6AB22EAAAEDB4755C0",
    "store_id": "M0000043",
    "store_english_name": "lafresh",
    "store_name": "忠孝店",
    "pos_id": "01",
    "pos_trade_time": "20210101093922",
    "mer_trade_no": "202101230000001",
    "gate_trade_no": null,
    "pay_token": "PX2039823892398382",
    "trans_id": "1234567890",
    "amount": "300",
    "none_discount_amount": 0,
    "none_feedback_amount": 0,
    "req_time": "20180301230111",
    "remark1": "",
    "remark2": "",
    "remark3": "",
    "marketing": [
      {
        "marketing_code": "aaaaaabbbbbbcccccc"
      },
      {
        "marketing_code": "aaaaaabbbbbbcccccc"
      },
      {
        "marketing_code": "ffffff777777dddddd"
      }
    ],
    "products": [
      {
        "name": "洗衣粉",
        "amount": 100,
        "qty": 2
      },
      {
        "name": "可樂",
        "amount": 30,
        "qty": 1
      },
      {
        "name": "餅乾",
        "amount": 70,
        "qty": 1
      }
    ]
  },
  "store_id": "0",
  "is_test": false
}

Response Body Parameters

Name	Type	Description
mer_trade_no	string	付款特店序號
gate_trade_no	string	付款 Gateway 平台序號
px_trade_no	string	全支付或錢包交易序號
status_code	string	交易結果代碼 0000：成功 其它：失敗
status_message	string	交易結果訊息
amount	integer	訂單金額
trade_amount	integer	支付金額 訂單金額扣除折抵金額後之金額
discount_amount	integer	折抵金額 無折抵回覆 0
px_trade_time	string	全支付交易日期時間(yyyyMMddHHmmss)
invo_carrier	string	手機條碼載具，若會員於全支付或錢包綁定條碼載具必回覆 (optional)
mem_card_no	string	特店會員 token 若全支付會員未綁定商戶會員此欄位回覆空值 (optional)
pay_tool_info	Pay Tool Info	付款工具資訊
marketing	Marketing	共同行銷活動折抵

Response Body Parameters - Pay Tool Info

Name	Type	Description
pay_tool	integer	支付工具 ALLOWED VALUES: 1：信用卡 2：AccountLink 4：全支付或錢包儲值帳戶
tool_name	string	支付工具名稱
identity	string	支付工具識別碼 (optional)

Response Body Parameters - Marketing

Name	Type	Description
marketing_code	string	共同行銷活動代碼 (optional)
discount	integer	折扣金額 若活動定義為折數折扣，計算結果四捨五入至整數，此金額需於發票金額中扣除。 (optional)

Response

{
  "mer_trade_no": "202101230000001",
  "gate_trade_no": null,
  "px_trade_no": "PXO023892398239",
  "status_code": "0000",
  "status_message": "交易成功",
  "amount": 300,
  "trade_amount": 277,
  "discount_amount": 10,
  "px_trade_time": "20210710143259",
  "invo_carrier": "/NFVIAZP",
  "mem_card_no": "wisjnf3282o102",
  "pay_tool_info": {
    "pay_tool": 1,
    "tool_name ": "華泰銀行",
    "identity": "123456******7890"
  },
  "marketing": [
    {
      "marketing_code": "aaaaaabbbbbbcccccc",
      "discount": 10
    },
    {
      "marketing_code": "aaaaaabbbbbbcccccc",
      "discount": 0
    },
    {
      "marketing_code": "ffffff777777dddddd",
      "discount": 3
    }
  ]
}