rfc3106.txt
来自「RFC 的详细文档！」· 文本 代码 · 共 1,124 行 · 第 1/3 页
TXT
1,124 行
( 2) May also be used for middle initial.
( 3) For example: Ph.D., Jr. (Junior), 3rd, Esq. (Esquire). This
field is commonly not used.
( 4) Address lines must be filled in the order line1, then line2, and
last line3.
( 5) 2 characters are the minimum for the US and Canada, other
countries may require longer fields. For the US use 2 character US
Postal state abbreviation.
Eastlake & Goldstein Informational [Page 7]
RFC 3106 ECom Field Names April 2001
( 6) Minimum field lengths for Postal Code will vary based on
international market served. Use 5 character or 5+4 ZIP for the US
and 6 character postal code for Canada. The size given, 14, is
believed to be the maximum required anywhere in the world.
( 7) Use [ISO 3166] standard two letter codes. See
<http://www.din.de/gremien/nas/nabd/iso3166ma/index.html> for country
names.
( 8) 10 digits are the minimum for numbers local to the North
American Numbering Plan (<http://www.nanpa.com>: US, Canada and a
number of smaller Caribbean and Pacific nations (but not Cuba)),
other countries may require longer fields. Telephone numbers are
complicated by differing international access codes, variant
punctuation of area/city codes within countries, confusion caused by
the fact that the international access code in the NANP region is
usually the same as the "country code" for that area (1), etc. It
will probably be necessary to use heuristics or human examination
based on the telephone number and addresses given to figure out how
to actually call a customer. It is recommend that an "x" be placed
before extension numbers.
( 9) For example: jsmith@example.com
(10) The name of the cardholder.
(11) Use the first 4 letters of the association name:
AMER American Express
BANK Bankcard (Australia)
DC DC (Japan)
DINE Diners Club
DISC Discover
JCB JCB
MAST Mastercard
NIKO Nikos (Japan)
SAIS Saison (Japan)
UC UC (Japan)
UCAR UCard (Taiwan)
VISA Visa
(12) Includes the check digit at end but no spaces or hyphens [ISO
7812]. The Min given, 19, is the longest number permitted under the
ISO standard.
(13) An additional cardholder verification number printed on the card
(but not embossed or recorded on the magnetic stripe) such as
American Express' CIV, MasterCard's CVC2, and Visa's CVV2 values.
Eastlake & Goldstein Informational [Page 8]
RFC 3106 ECom Field Names April 2001
(14) The day of the month. Values: 1-31. A leading zero is ignored
so, for example, 07 is valid for the seventh day of the month.
(15) The month of the year. Jan - 1, Feb - 2, March - 3, etc.;
Values: 1-12. A leading zero is ignored so, for example, 07 is valid
for July.
(16) The value in the wallet cell is always four digits, e.g., 1999,
2000, 2001, ...
(17) A space separated list of protocols available in connection with
the specified card. Initial list of case insensitive tokens:
none
set
setcert
iotp
echeck
simcard
phoneid
"Set" indicates usable with SET protocol (i.e., is in a SET wallet)
but does not have a SET certificate. "Setcert" indicates same but
does have a set certificate. "iotp" indicates the IOTP protocol [RFC
2801] is supported at the customer. "echeck" indicates that the
eCheck protocol [eCheck] is supported at the customer. "simcard"
indicates use the transaction instrument built into a Cellphone
subscriber for identification. "phoneid" indicates use the
transaction instrument of a phone bill instrument. "None" indicates
that automatic field fill is operating but there is no SET wallet or
the card is not entered in any SET wallet.
(18) A unique order ID generated by the consumer software.
(19) The user ID and password fields are used in cases where the user
has a pre-established account with the merchant.
(20) URI indicating version of this set of fields. Usually a hidden
field. Equal to "http://www.ecml.org/version/1.1" for this version.
(21) A string to identify the source and version of the form fill
software that is acting on behalf of the user. Should contain
company and/or product name and version. Example "Wallets Inc.,
SuperFill, v42.7". Usually a hidden field.
(22) A flag to indicate that this web-page/aggregate is the final one
for this transaction. Usually a hidden field.
Eastlake & Goldstein Informational [Page 9]
RFC 3106 ECom Field Names April 2001
(23) Merchant domain name such as www.merchant.example. This is
usually a hidden field.
(24) Gateway transaction processor who is actually accepting the
payment on behalf of the merchant in home domain such as
www.processor.example. This is usually a hidden field.
(25) A Transaction identification string whose format is specific to
the processor. This is usually a hidden field.
(26) A URL that can be invoke to inquire about the transaction. This
is usually a hidden field.
(27) The amount of the transaction in ISO currency format. This is
two integer numbers with a period in between but no other currency
marks (such as a $ dollar sign). This is usually a hidden field.
(28) This is the three letter ISO currency code. For example, for US
dollars it is USD. This is usually a hidden field.
(29) ISO Transaction date. This is usually a hidden field.
(30) The type of the transaction (either debit or credit) if known.
This is usually a hidden field.
(31) The signature of the encoded certificate. This is usually a
hidden field.
(32) The Receipt To fields are used when the Bill To entity,
location, or address and the Receipto entity, location, or address
are different. For example, when using some forms of Corporate
Purchasing Cards or Agent Purchasing Cards, the individual card
holder would be in the Receipt To fields and the corporate or other
owner would be in the Bill To fields.
2.2 Use in HTML
The normal use of ECML in HTML is as a form with input field names
identical to those given in section 2.1 above. In general, <INPUT>
tags with type text, hidden, and password must be supported as must
<SELECT> tags.
Internationalization in HTML is limited. The information available
with the HTML form Method as to character set and language SHOULD be
used.
Eastlake & Goldstein Informational [Page 10]
RFC 3106 ECom Field Names April 2001
2.3 An ECML 1.1 XML DTD
Below is an XML DTD that can be used for the XML encoding of ECML
v1.1 Fields.
For internationalization of [XML] ECML, use the general XML character
encoding provisions, which mandate support of UTF-8 and UTF-16 and
permit support of other character sets, and the xml:lang attribute
which may be used to specify language information.
<!-- Electronic Commerce Modeling Language 1.1 -->
<!ELEMENT Ecom ( #PCDATA | ShipTo | BillTo | ReceiptTo | Payment |
User | Transaction | TransactionComplete )* >
<!ATTLIST Ecom
id ID #IMPLIED
ConsumerOrderID CDATA #IMPLIED
Merchant CDATA #IMPLIED
Processor CDATA #IMPLIED
SchemaVersion ( "http://www.ecml.org/version/1.0" |
"http://www.ecml.org/version/1.1" )
#IMPLIED
WalletID CDATA #IMPLIED >
<!ELEMENT ShipTo ( #PCDATA | Postal | Telecom | Online )* >
<!ATTLIST ShipTo
id ID #IMPLIED >
<!ELEMENT BillTo ( #PCDATA | Postal | Telecom | Online )* >
<!ATTLIST BillTo
id ID #IMPLIED >
<!ELEMENT ReceiptTo ( #PCDATA | Postal | Telecom | Online )* >
<!ATTLIST ReceiptTo
id ID #IMPLIED >
<!ELEMENT Postal ( #PCDATA | Name | Company |
Street | City | StateProv )* >
<!ATTLIST Postal
id ID #IMPLIED
PostalCode NMTOKEN #IMPLIED
CountryCode NMTOKEN #IMPLIED >
<!ELEMENT Name EMPTY >
<!ATTLIST Name
id ID #IMPLIED
Prefix NMTOKEN #IMPLIED
First NMTOKEN #IMPLIED
Eastlake & Goldstein Informational [Page 11]
RFC 3106 ECom Field Names April 2001
Middle NMTOKEN #IMPLIED
Last NMTOKEN #IMPLIED
Suffix NMTOKEN #IMPLIED >
<!ELEMENT Street EMPTY >
<!ATTLIST Street
id ID #IMPLIED
Line1 CDATA #REQUIRED
Line2 CDATA #IMPLIED
Line3 CDATA #IMPLIED >
<!ELEMENT Company #PCDATA >
<!ELEMENT City #PCDATA >
<!ELEMENT StateProv #PCDATA >
<!ELEMENT Telecom ( #PCDATA | Phone )* >
<!ELEMENT Phone EMPTY >
<!ATTLIST Phone
id ID #IMPLIED
Number CDATA #REQUIRED >
<!ELEMENT Online ( #PCDATA | Email )* >
<!ELEMENT Email EMPTY >
<!ATTLIST Email
id ID #IMPLIED
Address CDATA #REQUIRED >
<!ELEMENT Payment Card>
<!ELEMENT Card ExpDate >
<!ATTLIST Card
id ID #IMPLIED
Name CDATA #IMPLIED
Type NMTOKEN #IMPLIED
Number NMTOKEN #REQUIRED
Protocols NMTOKENS #IMPLIED
Verification NMTOKEN #IMPLIED >
<!ELEMENT ExpDate EMPTY >
<!ATTLIST ExpDate
id ID #IMPLIED
Day NMTOKEN #IMPLIED
Month NMTOKEN #REQUIRED
Year NMTOKEN #REQUIRED >
Eastlake & Goldstein Informational [Page 12]
RFC 3106 ECom Field Names April 2001
<!ELEMENT User ( #PCDATA | UserID | Password )* >
<!ATTLIST User
id ID #IMPLIED >
<!ELEMENT UserID #PCDATA >
<!ELEMENT Password #PCDATA >
<!ELEMENT Transaction ( #PCDATA | TransactionID | Inquiry |
TransDate | Signature )* >
<!ATTLIST Transaction
id ID #IMPLIED
Amount CDATA #IMPLIED
Currency NMTOKEN #IMPLIED
Type NMTOKEN #IMPLIED >
<!ELEMENT TransactionComplete EMPTY>
3. Using The Fields
To conform to this document, the field names must be structured and
named as close to the structure and naming listed in Section 2 above
as permitted by the transaction protocol in use. Note: this does not
impose any restriction on the user visible labeling of fields, just
on their names as used in communication.
3.1 Presentation of the Fields
There is no necessary implication as to the order or manner of
presentation. Some merchants may wish to ask for more information,
some less by omitting fields. Some merchants may ask for the
information they want in one interaction or web page, others may ask
for parts of the information at different times in multiple
interactions or different web pages. For example, it is common to
ask for "ship to" information earlier, so shipping cost can be
computed, before the payment method information. Some merchants may
require that all the information they request be provided while other
make much information optional. Etc.
There is no way with Version 1.0 or 1.1 of ECML to indicate what
fields the merchant considers mandatory. From the point of view of
customer software, all fields are optional to complete. However, the
merchant may give an error or re-present a request for information if
some field it requires is not completed, just as it may if a field is
completed in a manner it considers erroneous.
It is entirely up to the merchant when and which, if any, of the
merchant to consumer fields it presents.
Eastlake & Goldstein Informational [Page 13]
RFC 3106 ECom Field Names April 2001
3.2 Methods and Flow of Setting the Fields
There are a variety of methods of communication possible between the
customer and the merchant by which the merchant can indicate what
fields they want that the consumer can provide. Probably the easiest
to use for currently deployed software is as fields in an [HTML] form
(see section 2.2). Other possibilities are to use the IOTP
Authenticate transaction [RFC 2801], an [XML] exchange, or
proprietary protocols.
User action or the appearance of the Ecom_SchemaVersion field are
examples of triggers that could be used to initiate a facility
capable of filling in fields. Because some wallets may require user
activation, there should be at least one user visible Ecom field on
every page with any Ecom fields present that are to be filled in. It
is also REQUIRED that the Ecom_SchemaVersion field, which is usually
⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?