四方仙域传送阵 分享页面        

交易回調

POSTcallbackUrl

開發者消費請求填寫了callbackUrl參數，則可以在KPOS支付、撤銷成功後收到異步通知，開發者需要處理完業務後響應KPOS指定數據。如沒有成功響應KPOS，KPOS會按照一定規則進行重試，重試次數達到3次後，不再通知。需要獲取交易結果，可以調用查詢接口進行查詢。

請求頭信息

signature String REQUIRED
簽名字符串。

timestamp Long REQUIRED
當前時間戳，精確到毫秒。

nonceStr String REQUIRED
32位隨機字符串，例：BlW41Z20zy801bcjBbBx7fQVYkHNoAm7

請求數據

outTradeNO String (1,32) REQUIRED
商戶訂單號

transactionNo String (1,32) REQUIRED
KPay商戶訂單號（二維碼類交易返回）

refNo String (1,32) REQUIRED
KPay商戶交易參考號（卡類交易返回）

description String (1,128)
商品描述

payAmount String (12) REQUIRED
⽀付⾦額，格式000000000100，單位：最小貨幣單位

tipsAmount String (12) REQUIRED
小費金額，格式000000000100，單位：最小貨幣單位

payCurrency String (1,4) REQUIRED
支付貨幣代碼，當前僅支持344（HKD）

memberCode String (1,32)
會員編號

reason String (1,128)
原因說明

payMethod Long REQUIRED
支付方式（1：Visa，2：Mastercard，3：中國銀聯，4：微信，5：支付寶，6：American Express，7：Diners Club，8：JCB，9：銀聯雲閃付，11：八達通，12：Payme）

transactionType Long REQUIRED
交易類型（1：消費，2：退貨，3：冲正，4：預授權，5：預授權完成，6：消費撤銷，7：小費調整，8：小費撤銷，9：預授權撤銷，10：預授權完成撤銷）

payResult Integer REQUIRED
支付結果（-1：超时，1：待處理，2：處理成功，3：處理失敗，4：已退貨，5：已撤銷，6：交易取消）

needSignature Boolean
小票是否需要簽名

以下為KPay小票數據，僅 includeReceipt 為true時返回

kpayMerchantNo String REQUIRED
KPay商戶號（15位）

kpayMerchantNameZH String (1,36) REQUIRED
KPay商戶門店中文名

kpayMerchantNameEN String (1,100) REQUIRED
KPay商戶門店英文名

kpayMerchantAddress String (1,100) REQUIRED
KPay商戶門店地址

cardNo String (1,19)
銀行卡號（已脫敏）

cardInputCode String (1)
卡數據獲取方式（S:刷卡，I:插卡，C:拍卡，F:芯片降級交易，M:手動輸入）

batchNo String (6)
KPay批次號

traceNo String (6)
KPay流水號

orgTraceNo String (6)
KPay原交易流水號

orgTransactionNo String (1,32)
KPay原商戶訂單號（二維碼類交易返回）

kpayMemberNo String (1,32)
KPay會員編號

authCode String (1,16)
授權碼 (銀行卡類交易返回)

paymentId String (1,32)
支付機構交易號（二維碼類交易返回）

commitTime Long
交易提交時間（時間戳）

aid String (1,32)
卡應用ID (卡類EMV交易時返回)

aidLabel String (1,32)
卡應用名稱 (卡類EMV交易時返回)

pinVerified String (1,32)
是否脫機PIN驗證通過（當cardInputCode為 I 時，此字段才有效）

oemRefNo String (1,32)
八達通交易參考號（僅八達通交易時返回）

balance String (1,16)
八達通卡餘額（僅八達通卡交易且有餘額時返回）

tc String (1,32)
卡交易應用密文（TC）（僅卡類EMV交易時返回）

appVersion String (1,16)
KPay POS 版本號

terminalType String (1,16)
設備型號

receiptNoSignatureZH String
交易小票免簽名提示語（繁中）

receiptNoSignatureEN String
交易小票免簽名提示語（英文）

receiptSignatureZH String
交易小票簽名提示語（繁中）

receiptSignatureEN String
交易小票簽名提示語（英文）

receiptSignatureConfirmZH String
交易小票入賬確認提示語（繁中）

receiptSignatureConfirmEN String
交易小票入賬確認提示語（英文）

receiptDisclaimersZH String
交易小票免責提示語（英文）

receiptDisclaimersEN String
交易小票免責提示語（英文）