支付寶掃碼支付平臺接入

1、當面付平臺對接版本修訂信息版本號完成日期擬稿和修改人發(fā)布日期變更說明1.0.02015.3.3黃曉瑜1.1.02015.4.11遲景陽2.0.02015.5.7遲景陽目錄版本修訂信息2目錄2統(tǒng)一支付接口規(guī)范3消息格式說明：3一、消息格式3二、數(shù)據(jù)類型3三、交易類型4四、數(shù)據(jù)元名稱及其定義5管理類交易6一、簽到（平臺重置密鑰）6消費類交易7一、下單并支付接口7二、查詢接口9三、撤銷接口10四、退貨接口11五、交易狀態(tài)（訂單狀態(tài)查詢）12六、下單并支付響應碼13七、查詢、撤銷和退款響應碼13終端程序菜單說明13交易流程說明14統(tǒng)一支付接口規(guī)范消息格式說明：一、消息格式消息格式包含報文長度、報文頭、

2、TPDU和應用數(shù)據(jù)四部分。報文長度報文頭TPDU應用數(shù)據(jù)ISO8583 Msg報文長度應用類別定義軟件版本號終端狀態(tài)處理要求保留使用ID目的地址源地址交易數(shù)據(jù)N2N2N2N1N1N660HNN NNNN NN不定長度-報文長度說明：2字節(jié)表示報文長度-報文頭說明：總長度為12字節(jié)，壓縮為BCD后為6字節(jié)，目前報文頭暫時不做要求。-TPDU說明：長度為5個字節(jié)樣例：報文長度報文頭TPDU00 6C60 31 00 31 29 1660 00 77 00 00-應用數(shù)據(jù)說明：符合ISO8583的金融交換信息格式的交易數(shù)據(jù)，下文將定義各種交易的報文格式。二、數(shù)據(jù)類型平臺間交換消息中，各數(shù)據(jù)元類型如下

3、所列：A：字母向左靠，右部多余部分填空格。AN：字母和/或數(shù)字，左靠，右部多余部分填空格。ANS：字母、數(shù)字和/或特殊符號，左靠，右部多余部分填空格。AS：字母和/或特殊符號，左靠，右部多余部分填空格。B：二進制bit位。LL：可變長域的長度值(二位數(shù))。LLL：可變長域的長度值(三位數(shù))。MM：月。DD：日。mm：分hh：時。S：特殊符號。ss：秒。N：數(shù)值，右靠，首位有效數(shù)字前充零。若表示金額，則最右二位為角分。VAR：可變長域。X：借貸符號，在數(shù)值之前，D表示借，C表示貸。YY：年。Z：由ISO 7811和ISO 7813制定的磁卡第二、三磁道的數(shù)據(jù)類型。CN： BCD壓縮編碼數(shù)值對可變

4、長數(shù)據(jù)元，以下例說明：變量XYZ的數(shù)據(jù)類型為ANS.999(LLLVAR)，則表示：該變量中可含字母、數(shù)字和特殊符號，最長不超過999個字符，長度由三位數(shù)字確定。變量XYZ的數(shù)據(jù)類型為N.999（LLLVAR），則在壓縮時，其長度位用右靠的BCD碼壓縮，而其后緊隨的數(shù)字內(nèi)容用左靠的BCD碼壓縮。這是為了保證有效內(nèi)容和其位數(shù)中間無缺省填充值。若不為偶數(shù)位，左靠的數(shù)字內(nèi)容后補零。由于有長度位表征該域有效內(nèi)容的長度，因此后補零不會改變該域的真實值。三、交易類型線下交易前置是根據(jù)消息類型和交易處理碼來確定交易類型：交易類型消息類型（請求/應答）處理碼(3 域)服務點條件碼(25 域)交易類型碼（60.

5、1域）管理類交易簽到0800/0810無無支付寶交易查詢訂單狀態(tài)0200/02103800000001消費0200/02105500000000消費撤銷0200/02105600000000退貨0220/02305600000000四、數(shù)據(jù)元名稱及其定義域域名稱域?qū)傩愿袷秸f明2主賬號N.19(LLVAR)3交易處理碼N64交易金額N12上送、返回都需要6折扣金額N1210交易名稱中文ANS.20(LLVAR)11系統(tǒng)跟蹤號N6終端流水號，沖正送原流水12終端時間N6hhmmss13終端日期N4MMDD14卡有效期N4YYMM15清算日期N422服務點輸入方式N325服務點條件碼N226PIN獲

6、取碼N231門店代碼ANS.8(LLVAR)門店代碼32代理機構(gòu)標識碼N.15(LLVAR)渠道代碼33發(fā)送機構(gòu)標識碼ANS.8(LLVAR)發(fā)卡方代碼35二磁道數(shù)據(jù)Z.40(LLVAR)37檢索參考號AN12撤銷、退貨必填38授權(quán)碼AN639應答碼AN241終端標識碼ANS8終端號42受卡方標識碼ANS15商戶號43子賬戶數(shù)據(jù)ANS242(LLLVAR)子賬戶信息/應答時為中文應答碼44附加響應數(shù)據(jù)ANS262(LLVAR)贈品信息48附加數(shù)據(jù)-私有ANS.60(LLLVAR)結(jié)算匯總/卡卡轉(zhuǎn)賬的轉(zhuǎn)入卡號49幣種代碼AN352個人標識碼B64PIN53個人標識碼B64PIN（新密碼）54交易

7、后賬戶余額AN.20(LLLVAR)余額數(shù)據(jù)58卡片等級AN160第三方標識N.40(LLLVAR)6位批次號60.1交易類型碼N260.2批次號N660.3網(wǎng)絡管理碼N3有后續(xù)子域時本域才出現(xiàn)。非網(wǎng)絡管理類交易本域以缺省值“000”填充60.4終端讀取能力N1僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。上述各類情況中該域都填 5。60.5基于 PBOC借/貸記標準的 IC卡條件代碼N1僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。IC卡交易、Fall Back 交易根據(jù)實際情況填寫。純磁條卡交易碼發(fā)生在 IC卡終端上填

8、 0。61原交易信息N.16(LLLVAR)退貨、撤銷，原終端批次+流水61.1原批次號N661.2原流水號N662自定義域(密鑰)ANSB.512(LLLVAR)63自定義域ANS163(LLLVAR)收銀員代碼6+主管操作員664消息鑒別碼B64MAC管理類交易一、簽到（平臺重置密鑰）位域名定義請求響應備 注消息類型02000210MSG-TYPE-ID位元表MMBIT MAP11憑證號MM終端流水號41受卡機終端標識碼MM終端代碼42受卡方標識碼MM商戶代碼60自定義域MM60.1交易類型碼MM0060.2批次號MM60.3網(wǎng)絡管理碼CC有后續(xù)子域時本域才出現(xiàn)。非網(wǎng)絡管理類交易本域以缺省

9、值“000”填充60.4終端讀取能力CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。上述各類情況中該域都填 5。60.5基于 PBOC借/貸記標準的 IC卡條件代碼CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。IC卡交易、Fall Back 交易根據(jù)實際情況填寫。純磁條卡交易碼發(fā)生在 IC卡終端上填 0。62硬件序列號MM應答為工作密鑰63操作員編號MM消費類交易一、 下單并支付接口1234566.16.26.2.11234566.16.26.2.16.2.1.1請求報文位域名定義請求響應備注消息類型02000210

10、MSG-TYPE-ID位元表MMBIT MAP2主賬號CC3交易處理碼MM5500004交易金額MM11受卡方系統(tǒng)跟蹤號MM終端流水號12受卡方所在地時間MM13受卡方所在地日期MM29業(yè)務數(shù)據(jù)MMASCII，字段之間以|分隔，字段沒有則填空值請求：createandpay|家支付寶用戶號|買家支付寶賬號動態(tài)ID類型（于63.2域相同）|動態(tài)ID返回：createandpay|支付寶交易號|商戶網(wǎng)站訂單號買家支付寶用戶號|買家支付寶賬號|交易金額|交易付款時間|詳細錯誤碼|詳細錯誤描述說明：請求時，買家支付寶用戶號與 動態(tài)ID不能同時為空37檢索參考號MPOS中心系統(tǒng)流水號39應答碼M41受卡

11、機終端標識碼MM終端代碼42受卡方標識碼MM商戶代碼43子賬戶數(shù)據(jù)CM返回時為應答中文碼49交易貨幣代碼MM52個人標識碼數(shù)據(jù)C密碼60自定義域MM60.1交易類型碼MM0060.2批次號MM60.3網(wǎng)絡管理碼CC有后續(xù)子域時本域才出現(xiàn)。非網(wǎng)絡管理類交易本域以缺省值“000”填充60.4終端讀取能力CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。上述各類情況中該域都填 5。60.5基于 PBOC借/貸記標準的 IC卡條件代碼CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。IC卡交易、Fall Back 交易根據(jù)實際情況

12、填寫。純磁條卡交易碼發(fā)生在 IC卡終端上填 0。63.1自定義域MM收銀員代碼（6位）63.2自定義域MM訂單業(yè)務類型（1位，0-聲波，1-二維碼，2-條碼）64MACMC6.2.1.16.2.1.2二、 查詢接口位域名定義請求響應備注消息類型02000210MSG-TYPE-ID位元表MMBIT MAP2主賬號MM3交易處理碼MM38000011受卡方系統(tǒng)跟蹤號MMPOS終端交易流水12受卡方所在地時間M13受卡方所在地日期M29業(yè)務數(shù)據(jù)CMASCII，字段之間以|分隔，字段沒有則填空值請求：query|商戶網(wǎng)站唯一訂單號| 支付寶交易號返回：query|支付寶交易號|商戶網(wǎng)站訂單號|買家支

13、付寶用戶號|買家支付寶賬號|交易金額|本次交易打款給賣家的時間|詳細錯誤碼|詳細錯誤描述錯誤代碼|交易狀態(tài)39應答碼M41受卡機終端標識MM終端代碼42受卡方標識碼MM商戶代碼43子賬戶數(shù)據(jù)CM返回時為應答中文碼49交易貨幣代碼CC52個人標識碼數(shù)據(jù)C54賬戶余額C60自定義域MM60.1交易類型碼MM0160.2批次號MM60.3網(wǎng)絡管理碼CC有后續(xù)子域時本域才出現(xiàn)。非網(wǎng)絡管理類交易本域以缺省值“000”填充60.4終端讀取能力CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。上述各類情況中該域都填 5。60.5基于 PBOC借/貸記標準的 IC卡條件代碼

14、CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。IC卡交易、Fall Back 交易根據(jù)實際情況填寫。純磁條卡交易碼發(fā)生在 IC卡終端上填 0。61原交易信息MM查詢，原批次號+原終端流水+原日期63自定義域M收銀員代碼664MACMC三、 撤銷接口位域名定義請求響應備注消息類型02000210MSG-TYPE-ID位元表MMBIT MAP2主賬號CC3交易處理碼MM5600004交易金額MM11受卡方系統(tǒng)跟蹤號MM終端流水號12受卡方所在地時間MM13受卡方所在地日期MM29業(yè)務數(shù)據(jù)MMASCII，字段之間以|分隔，字段沒有則填空值請求：cancel|商

15、戶網(wǎng)站唯一訂單號| 支付寶交易號返回：cancel|響應碼|支付寶交易號|商戶網(wǎng)站訂單號|是否可重試標志|執(zhí)行撤銷的動作|詳細錯誤碼|詳細錯誤描述37檢索參考號MM請求時為原消費交易參考號39應答碼M41受卡機終端標識碼MM終端代碼同原交易42受卡方標識碼MM商戶代碼同原交易43子賬戶數(shù)據(jù)CM返回時為應答中文碼49交易貨幣代碼MM52個人標識碼數(shù)據(jù)C密碼60自定義域MM60.1交易類型碼MM0060.2批次號MM60.3網(wǎng)絡管理碼CC有后續(xù)子域時本域才出現(xiàn)。非網(wǎng)絡管理類交易本域以缺省值“000”填充60.4終端讀取能力CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情

16、況下出現(xiàn)。上述各類情況中該域都填 5。60.5基于 PBOC借/貸記標準的 IC卡條件代碼CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。IC卡交易、Fall Back 交易根據(jù)實際情況填寫。純磁條卡交易碼發(fā)生在 IC卡終端上填 0。61原交易信息MM撤銷，原批次號+原終端流水63自定義域M收銀員代碼664MACMC四、 退貨接口位域名定義請求響應備注消息類型02200230MSG-TYPE-ID位元表MMBIT MAP2主賬號MM3交易處理碼MM5600004交易金額MM11受卡方系統(tǒng)跟蹤號MM終端流水號12受卡方所在地時間MM13受卡方所在地日期MM2

17、9業(yè)務數(shù)據(jù)MMASCII，字段之間以|分隔，字段沒有則填空值請求：refund|商戶網(wǎng)站唯一訂單號| 支付寶交易號|退款金額|退款原因返回： refund|支付寶交易號|商戶網(wǎng)站訂單號|買家支付寶用戶號|買家支付寶賬號|本次退款請求是否發(fā)生資金變動|退款金額|退款時間|詳細錯誤碼|詳細錯誤描述37檢索參考號MM請求時為原消費交易參考號39應答碼M41受卡機終端標識碼MM終端代碼同原交易42受卡方標識碼MM商戶代碼同原交易43子賬戶數(shù)據(jù)M返回時為應答中文碼49交易貨幣代碼MM52個人標識碼數(shù)據(jù)C密碼60自定義域MM60.1交易類型碼MM0060.2批次號MM60.3網(wǎng)絡管理碼CC有后續(xù)子域時本域

18、才出現(xiàn)。非網(wǎng)絡管理類交易本域以缺省值“000”填充60.4終端讀取能力CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。上述各類情況中該域都填 5。60.5基于 PBOC借/貸記標準的 IC卡條件代碼CC僅在 IC卡交易、Fall Back、純磁條卡交易發(fā)生在 IC卡終端等情況下出現(xiàn)。IC卡交易、Fall Back 交易根據(jù)實際情況填寫。純磁條卡交易碼發(fā)生在 IC卡終端上填 0。61原交易信息MM退貨，原批次號+原終端流水+原日期63自定義域M收銀員代碼664MACMC五、 交易狀態(tài)（訂單狀態(tài)查詢）狀態(tài)碼說明B0交易創(chuàng)建，等待買家付款確認超時時間，或者沒有超時時間，異步通知訂單關閉-訂單15天有效B11、 在指定時間段內(nèi)未支付時關閉的交易2、 在交易完成全額退款成功時關閉的交易訂單關閉B2交易成功，且可對該交易做操作，如撤銷、退款等。交易成功B3等待賣家收款(買家付款后，如果賣家賬號被凍結(jié))不做任何操作，記錄異常訂單。聯(lián)系支付寶客服B4交易成功并結(jié)束，即不可再做操作交易成功并