POST api/UnPos/3Pay/DirectComplete/ForBusi12345
直接写入第三方支付结果并转换单据状态的API接口。 农行POS机支付的设计是:POS机刷卡、数据人民币收款,收款过程是旁路过程,本接口用于在POS收款成功之后,向系统中直接记录一个收款成功的第三方支付记录。在客户端本身没有为POS机设计退款过程,全部依赖这些记录进行“无卡退款”操作。 交易ID的拼合方式: 支付方式|票据号|授权号|凭证号|批次号|参考号|扫码支付订单号 备注字段的拼合: 优惠,银行名
Request Information
URI Parameters
None.
Body Parameters
Direct3PayCompleteParmName | Description | Type | Additional information |
---|---|---|---|
DH |
游宝星业务系统单据单号。 |
string |
Required Max length: 20 |
PaymentChannelName |
支付渠道的名称,在此应用中,可以使用“农行POS机”之类的名称。 |
string |
Required Max length: 20 |
PaymentChannelId |
支付渠道ID,在此应用中,可以使用“#”表示一个额外的支付渠道。 |
string |
Required Max length: 1 |
PaymentTypeId |
付款方式ID。 |
string |
Required Max length: 2 |
BusiType |
订单类型 1-景区系统 2-Pos系统 3-租车系统 4-环保车系统,5-装备租赁业务,6-联营零售业务 因为不同的系统回调页面不一致,保存收款的表也不一致。 |
ESysBusinessType |
Required |
BankCardCode |
银行卡号。 |
string |
Max length: 20 |
Summary |
实收 |
decimal number |
Required |
FreeSummary |
优惠金额,此优惠金额不是指供应商(景区)优惠的金额,而是在支付过程中,收单方对支付者的优惠金额。单位元。 |
decimal number |
Required |
TradeTime |
交易时间,YYYYMMDDHHMMSS。 |
string |
Required Max length: 14 Min length: 14 |
BatchNo |
批次号 |
string |
Max length: 20 |
BillNum |
票据号 |
string |
Max length: 20 |
BusiTradeNo |
凭证号 |
string |
Max length: 20 |
MerchantCode |
商户号 |
string |
Max length: 20 |
AuthCode |
授权码 |
string |
Max length: 20 |
RefrenceCode |
参考号。 |
string |
Max length: 20 |
DeviceId |
终端号 |
string |
Max length: 20 |
PaymentSubType |
子付款方式号,如001表示银行卡。 |
string |
Max length: 6 |
PaymentSubTypeName |
子付款方式名。 |
string |
Max length: 20 |
ScanCodeBillNum |
扫码支付订单号 ASCII 46 扫码支付交易订单号,扫码类交易该值有效 |
string |
Max length: 50 |
SacnCodeBankBillNum |
扫码支付银行订单号 ASCII 46 扫码支付银行订单号(缺省为空格) |
string |
Max length: 50 |
GivenCardBandCode |
发卡行代码。 |
string |
Max length: 10 |
GivenCardBankName |
发卡行名。 |
string |
Max length: 40 |
Request Formats
application/json, text/json
{ "DH": "sample string 1", "PaymentChannelName": "sample string 2", "PaymentChannelId": "sample string 3", "PaymentTypeId": "sample string 4", "BusiType": 1, "BankCardCode": "sample string 5", "Summary": 6.0, "FreeSummary": 7.0, "TradeTime": "sample string 8", "BatchNo": "sample string 9", "BillNum": "sample string 10", "BusiTradeNo": "sample string 11", "MerchantCode": "sample string 12", "AuthCode": "sample string 13", "RefrenceCode": "sample string 14", "DeviceId": "sample string 15", "PaymentSubType": "sample string 16", "PaymentSubTypeName": "sample string 17", "ScanCodeBillNum": "sample string 18", "SacnCodeBankBillNum": "sample string 19", "GivenCardBandCode": "sample string 20", "GivenCardBankName": "sample string 21" }
application/xml, text/xml
<Direct3PayCompleteParm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm.Pay"> <AuthCode>sample string 13</AuthCode> <BankCardCode>sample string 5</BankCardCode> <BatchNo>sample string 9</BatchNo> <BillNum>sample string 10</BillNum> <BusiTradeNo>sample string 11</BusiTradeNo> <BusiType>ToursimOrTheatreTicketBusiness</BusiType> <DH>sample string 1</DH> <DeviceId>sample string 15</DeviceId> <FreeSummary>7</FreeSummary> <GivenCardBandCode>sample string 20</GivenCardBandCode> <GivenCardBankName>sample string 21</GivenCardBankName> <MerchantCode>sample string 12</MerchantCode> <PaymentChannelId>sample string 3</PaymentChannelId> <PaymentChannelName>sample string 2</PaymentChannelName> <PaymentSubType>sample string 16</PaymentSubType> <PaymentSubTypeName>sample string 17</PaymentSubTypeName> <PaymentTypeId>sample string 4</PaymentTypeId> <RefrenceCode>sample string 14</RefrenceCode> <SacnCodeBankBillNum>sample string 19</SacnCodeBankBillNum> <ScanCodeBillNum>sample string 18</ScanCodeBillNum> <Summary>6</Summary> <TradeTime>sample string 8</TradeTime> </Direct3PayCompleteParm>
application/x-www-form-urlencoded
Sample not available.
application/bson
Binary JSON content. See http://bsonspec.org for details.
Response Information
Resource Description
直接写入第三方支付结果并转换单据状态的API接口。 农行POS机支付的设计是:POS机刷卡、数据人民币收款,收款过程是旁路过程,本接口用于在POS收款成功之后,向系统中直接记录一个收款成功的第三方支付记录。在客户端本身没有为POS机设计退款过程,全部依赖这些记录进行“无卡退款”操作。 交易ID的拼合方式: 支付方式|票据号|授权号|凭证号|批次号|参考号|扫码支付订单号 备注字段的拼合: 优惠,银行名
CommonOperationResultWithTagOfPayDirectCompleteApplyResultName | Description | Type | Additional information |
---|---|---|---|
errcode | integer |
None. |
|
errmsg | string |
None. |
|
tag | PayDirectCompleteApplyResult |
None. |
Response Formats
application/json, text/json
{ "errcode": 1, "errmsg": "sample string 2", "tag": { "RecevieRecordId": "sample string 1", "BillPayState": "sample string 2" } }
application/xml, text/xml
<CommonOperationResultWithTagOfPayDirectCompleteApplyResultKp9g8rEY xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer"> <errcode>1</errcode> <errmsg>sample string 2</errmsg> <tag xmlns:d2p1="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result.Pay"> <d2p1:BillPayState>sample string 2</d2p1:BillPayState> <d2p1:RecevieRecordId>sample string 1</d2p1:RecevieRecordId> </tag> </CommonOperationResultWithTagOfPayDirectCompleteApplyResultKp9g8rEY>
application/bson
Binary JSON content. See http://bsonspec.org for details.