POST api/3Pay/DirectComplete/ForBusi12345

直接写入第三方支付结果并转换单据状态的API接口。农行POS机支付的设计是：POS机刷卡、数据人民币收款，收款过程是旁路过程，本接口用于在POS收款成功之后，向系统中直接记录一个收款成功的第三方支付记录。在客户端本身没有为POS机设计退款过程，全部依赖这些记录进行“无卡退款”操作。交易ID的拼合方式：支付方式|票据号|授权号|凭证号|批次号|参考号|扫码支付订单号备注字段的拼合：优惠，银行名

Request Information

URI Parameters

None.

Body Parameters

Direct3PayCompleteParm

Name	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

Sample:

{
  "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

Sample:

<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:

Sample not available.

application/bson

Sample:

Binary JSON content. See http://bsonspec.org for details.

Response Information

Resource Description

CommonOperationResultWithTagOfPayDirectCompleteApplyResult

Name	Type	Additional information
errcode	integer	None.
errmsg	string	None.
tag	PayDirectCompleteApplyResult	None.

Response Formats

application/json, text/json

Sample:

{
  "errcode": 1,
  "errmsg": "sample string 2",
  "tag": {
    "RecevieRecordId": "sample string 1",
    "BillPayState": "sample string 2"
  }
}

application/xml, text/xml

Sample:

<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

Sample:

Binary JSON content. See http://bsonspec.org for details.