POST api/WebInterface/ValueCard/Regist/Single

办理一张储值卡时使用的API。

Request Information

URI Parameters

None.

Body Parameters

办理储值卡时使用的参数。

ValueCardRegistParm
NameDescriptionTypeAdditional information
CardNo

卡号(一般指列印在卡片表面的卡号,是一个逻辑编号)。

string

Required

Max length: 20

MemberId

会员ID,可以为空,空或零表示没有绑定给某个会员。 此处的会与员互联网的个人会员是同一个会员。

integer

None.

OwnerName

持卡人姓名。

string

Max length: 50

IdentityCardType

证件类型,1"身份证 2"军官证(士兵证) 3护照 4其它等,取值同售票明细中的证件类型。

string

Max length: 1

IdentityNo

证件号码。

string

Max length: 20

Mobile

手机号码。

string

Max length: 20

Code

验证码。

string

Max length: 6

CardType

介质类型,同门票的介质类型(P,B的含义相同)。 "P", "纸带"; "B", "条码卡" ; "I", "接触式IC卡" ; "U", "非接触式IC卡" 。

string

Required

Max length: 1

Min length: 1

SerialId

介质ID NN,UN 如果是IC卡,则为序列号,如果是其他卡,则同卡号。

string

Required

Max length: 20

PayByPwd

是否凭密支付 NN 1是,其他值否。

string

Required

Max length: 1

Min length: 1

Range: inclusive between 0 and 1

PayPwd

支付密码。 UPPER(MD5(支付密码)),输入之前,要进行加密。 这个值会直接存储数据库,因此,需要在客户端执行好加密。

string

Max length: 64

Status

初始状态。0待激活,1 正常。 当新办的储值卡处于状态零时,需要再在前台或手机上执行“激活”才能进行使用。

string

Required

Range: inclusive between 0 and 1

ChargeSummary

充值金额。 新办储值卡时,同时执行的充值的金额。

decimal number

Required

Memory

备注。

string

Max length: 50

TradeFrom

业务来源。1-前台,2互联网

string

Required

Max length: 1

Request Formats

application/json, text/json

Sample:
{
  "CardNo": "sample string 1",
  "MemberId": 2,
  "OwnerName": "sample string 3",
  "IdentityCardType": "sample string 4",
  "IdentityNo": "sample string 5",
  "Mobile": "sample string 6",
  "Code": "sample string 7",
  "CardType": "sample string 8",
  "SerialId": "sample string 9",
  "PayByPwd": "sample string 10",
  "PayPwd": "sample string 11",
  "Status": "sample string 12",
  "ChargeSummary": 13.0,
  "Memory": "sample string 14",
  "TradeFrom": "sample string 15"
}

application/xml, text/xml

Sample:
<ValueCardRegistParm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm.ValueCard">
  <CardNo>sample string 1</CardNo>
  <CardType>sample string 8</CardType>
  <ChargeSummary>13</ChargeSummary>
  <Code>sample string 7</Code>
  <IdentityCardType>sample string 4</IdentityCardType>
  <IdentityNo>sample string 5</IdentityNo>
  <MemberId>2</MemberId>
  <Memory>sample string 14</Memory>
  <Mobile>sample string 6</Mobile>
  <OwnerName>sample string 3</OwnerName>
  <PayByPwd>sample string 10</PayByPwd>
  <PayPwd>sample string 11</PayPwd>
  <SerialId>sample string 9</SerialId>
  <Status>sample string 12</Status>
  <TradeFrom>sample string 15</TradeFrom>
</ValueCardRegistParm>

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

办理一张储值卡时使用的API。

CommonOperationResult
NameDescriptionTypeAdditional information
errcode

错误代码,通常0表示成功,其他值表示错误。

integer

None.

errmsg

错误描述,当errcode不为零时,此值可以用于呈现给用户。

string

None.

tag

操作同时,服务器端需要返回的其他值。

string

None.

Response Formats

application/json, text/json

Sample:
{
  "errcode": 1,
  "errmsg": "sample string 2",
  "tag": "sample string 3"
}

application/xml, text/xml

Sample:
<CommonOperationResult 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>sample string 3</tag>
</CommonOperationResult>

application/bson

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