支付寶掃碼支付平臺(tái)接入

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

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

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

4、長(zhǎng)數(shù)據(jù)元，以下例說(shuō)明：變量XYZ的數(shù)據(jù)類型為ANS.999(LLLVAR)，則表示：該變量中可含字母、數(shù)字和特殊符號(hào)，最長(zhǎng)不超過(guò)999個(gè)字符，長(zhǎng)度由三位數(shù)字確定。變量XYZ的數(shù)據(jù)類型為N.999（LLLVAR），則在壓縮時(shí)，其長(zhǎng)度位用右靠的BCD碼壓縮，而其后緊隨的數(shù)字內(nèi)容用左靠的BCD碼壓縮。這是為了保證有效內(nèi)容和其位數(shù)中間無(wú)缺省填充值。若不為偶數(shù)位，左靠的數(shù)字內(nèi)容后補(bǔ)零。由于有長(zhǎng)度位表征該域有效內(nèi)容的長(zhǎng)度，因此后補(bǔ)零不會(huì)改變?cè)撚虻恼鎸?shí)值。三、交易類型線下交易前置是根據(jù)消息類型和交易處理碼來(lái)確定交易類型：交易類型消息類型（請(qǐng)求/應(yīng)答）處理碼(3 域)服務(wù)點(diǎn)條件碼(25 域)交易類型碼（60.

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

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

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

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

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

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

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

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

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

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

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

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

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

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