| rfc8748xml2.original.xml | rfc8748.xml | |||
|---|---|---|---|---|
| <?xml version="1.0" encoding="US-ASCII"?> | <?xml version="1.0" encoding="UTF-8"?> | |||
| <!-- This template is for creating an Internet Draft using xml2rfc, | ||||
| which is available here: http://xml.resource.org. --> | ||||
| <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [ | ||||
| <!-- One method to get references from the online citation libraries. | ||||
| There has to be one entity for each item to be referenced. | ||||
| An alternate method (rfc include) is described in the references. --> | ||||
| <!ENTITY RFC2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .2119.xml"> | ||||
| <!ENTITY RFC3688 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .3688.xml"> | ||||
| <!ENTITY RFC3915 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .3915.xml"> | ||||
| <!ENTITY RFC5730 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .5730.xml"> | ||||
| <!ENTITY RFC5731 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .5731.xml"> | ||||
| <!ENTITY RFC7451 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .7451.xml"> | ||||
| <!ENTITY RFC7942 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .7942.xml"> | ||||
| <!ENTITY RFC8174 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .8174.xml"> | ||||
| <!ENTITY RFC8334 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .8334.xml"> | ||||
| <!ENTITY W3C.REC-xmlschema-1-20041028 PUBLIC '' 'http://xml2rfc.ietf.org/public/ | ||||
| rfc/bibxml4/reference.W3C.REC-xmlschema-1-20041028.xml'> | ||||
| <!ENTITY I-D.narten-iana-considerations-rfc2434bis SYSTEM "http://xml.resource.o | ||||
| rg/public/rfc/bibxml3/reference.I-D.narten-iana-considerations-rfc2434bis.xml"> | ||||
| ]> | ||||
| <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> | ||||
| <!-- used by XSLT processors --> | ||||
| <!-- For a complete list and description of processing instructions (PIs), | ||||
| please see http://xml.resource.org/authoring/README.html. --> | ||||
| <!-- Below are generally applicable Processing Instructions (PIs) that most I-Ds | ||||
| might want to use. | ||||
| (Here they are set differently than their defaults in xml2rfc v1.32) --> | ||||
| <?rfc strict="yes" ?> | ||||
| <!-- give errors regarding ID-nits and DTD validation --> | ||||
| <!-- control the table of contents (ToC) --> | ||||
| <?rfc toc="yes"?> | ||||
| <!-- generate a ToC --> | ||||
| <?rfc tocdepth="4"?> | ||||
| <!-- the number of levels of subsections in ToC. default: 3 --> | ||||
| <!-- control references --> | ||||
| <?rfc symrefs="yes"?> | ||||
| <!-- use symbolic references tags, i.e, [RFC2119] instead of [1] --> | ||||
| <?rfc sortrefs="yes" ?> | ||||
| <!-- sort the reference entries alphabetically --> | ||||
| <!-- control vertical white space | ||||
| (using these PIs as follows is recommended by the RFC Editor) --> | ||||
| <?rfc compact="yes" ?> | ||||
| <!-- do not start each main section on a new page --> | ||||
| <?rfc subcompact="yes" ?> | ||||
| <!-- keep one blank line between list items --> | ||||
| <?rfc comments="yes" ?> | ||||
| <!-- show cref output --> | ||||
| <?rfc inline="yes" ?> | ||||
| <!-- inline cref output --> | ||||
| <!-- end of list of popular I-D processing instructions --> | ||||
| <rfc category="std" docName="draft-ietf-regext-epp-fees-20" ipr="trust200902"> | ||||
| <!-- category values: std, bcp, info, exp, and historic | ||||
| ipr values: full3667, noModification3667, noDerivatives3667 | ||||
| you can add the attributes updates="NNNN" and obsoletes="NNNN" | ||||
| they will automatically be output with "(if approved)" --> | ||||
| <!-- ***** FRONT MATTER ***** --> | <!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent"> | |||
| <front> | <rfc xmlns:xi="http://www.w3.org/2001/XInclude" category="std" consensus="true" | |||
| <!-- The abbreviated title is used in the page header - it is only necessary | docName="draft-ietf-regext-epp-fees-20" number="8748" ipr="trust200902" obsolete | |||
| if the | s="" updates="" submissionType="IETF" xml:lang="en" tocInclude="true" tocDepth=" | |||
| full title is longer than 39 characters --> | 4" symRefs="true" sortRefs="true" version="3"> | |||
| <!-- xml2rfc v2v3 conversion 2.35.0 --> | ||||
| <front> | ||||
| <title abbrev="Registry Fee Extension"> | <title abbrev="Registry Fee Extension"> | |||
| Registry Fee Extension for the Extensible Provisioning Protocol (EPP)</title > | Registry Fee Extension for the Extensible Provisioning Protocol (EPP)</title > | |||
| <seriesInfo name="RFC" value="8748"/> | ||||
| <author fullname="Roger Carney" initials="R.C." surname="Carney"> | <author fullname="Roger Carney" initials="R." surname="Carney"> | |||
| <organization>GoDaddy Inc.</organization> | <organization>GoDaddy Inc.</organization> | |||
| <address> | <address> | |||
| <postal> | <postal> | |||
| <street>14455 N. Hayden Rd. #219</street> | <street>14455 N. Hayden Rd. #219</street> | |||
| <city>Scottsdale</city> | <city>Scottsdale</city> | |||
| <region>AZ</region> | <region>AZ</region> | |||
| <code>85260</code> | <code>85260</code> | |||
| <country>United States of America</country> | ||||
| <country>US</country> | ||||
| </postal> | </postal> | |||
| <email>rcarney@godaddy.com</email> | <email>rcarney@godaddy.com</email> | |||
| <uri>http://www.godaddy.com</uri> | <uri>http://www.godaddy.com</uri> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author fullname="Gavin Brown" initials="G." surname="Brown"> | <author fullname="Gavin Brown" initials="G." surname="Brown"> | |||
| <organization>CentralNic Group plc</organization> | <organization>CentralNic Group plc</organization> | |||
| <address> | <address> | |||
| <postal> | <postal> | |||
| <street>35-39 Moorgate</street> | <street>35-39 Moorgate</street> | |||
| <city>London</city> | <city>London</city> | |||
| <region/> | ||||
| <region>England</region> | ||||
| <code>EC2R 6AR</code> | <code>EC2R 6AR</code> | |||
| <country>United Kingdom</country> | ||||
| <country>GB</country> | ||||
| </postal> | </postal> | |||
| <phone>+44 20 33 88 0600</phone> | <phone>+44 20 33 88 0600</phone> | |||
| <email>gavin.brown@centralnic.com</email> | <email>gavin.brown@centralnic.com</email> | |||
| <uri>http://www.centralnic.com</uri> | <uri>http://www.centralnic.com</uri> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author fullname="Jothan Frakes" initials="J." surname="Frakes"> | <author fullname="Jothan Frakes" initials="J." surname="Frakes"> | |||
| <organization/> | <organization/> | |||
| <address> | <address> | |||
| <email>jothan@jothan.com</email> | <email>jothan@jothan.com</email> | |||
| <uri>http://jothan.com</uri> | <uri>http://jothan.com</uri> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <date year="2020" month="March"/> | ||||
| <date year="2019"/> | ||||
| <!-- Meta-data Declarations --> | ||||
| <area>Applications and Real-Time</area> | <area>Applications and Real-Time</area> | |||
| <workgroup>Registration Protocols Extensions</workgroup> | <workgroup>Registration Protocols Extensions</workgroup> | |||
| <abstract> | <abstract> | |||
| <t>Given the expansion of the DNS namespace, and the proliferation of | <t>Given the expansion of the DNS namespace and the proliferation of | |||
| novel business models, it is desirable to provide a method for Extensible | novel business models, it is desirable to provide a method for Extensible | |||
| Provisioning Protocol (EPP) clients to query EPP servers for the fees and | Provisioning Protocol (EPP) clients to query EPP servers for the fees and | |||
| credits and provide expected fees and credits for certain commands and | credits associated with various billable transactions and provide expected fees and credits for certain commands and | |||
| objects. This document describes an EPP extension mapping for registry fee s. | objects. This document describes an EPP extension mapping for registry fee s. | |||
| </t> | </t> | |||
| </abstract> | </abstract> | |||
| </front> | </front> | |||
| <middle> | <middle> | |||
| <section title="Introduction"> | <section anchor="intro" numbered="true" toc="default"> | |||
| <name>Introduction</name> | ||||
| <t>Historically, domain name registries have applied a simple fee | <t>Historically, domain name registries have applied a simple fee | |||
| structure for billable transactions, namely a basic unit price applied to | structure for billable transactions, namely a basic unit price applied to | |||
| domain <create>, <renew>, <transfer> and RGP [RFC3915] | domain <create>, <renew>, <transfer>, and Redemption | |||
| Grace Period (RGP) <xref target="RFC3915" format="default"/> | ||||
| restore commands. Given the relatively small number of EPP servers to | restore commands. Given the relatively small number of EPP servers to | |||
| which EPP clients have been required to connect, it has generally been the | which EPP clients have been required to connect, it has generally been the | |||
| case that client operators have been able to obtain details of these fees | case that client operators have been able to obtain details of these fees | |||
| out-of-band by contacting the server operators.</t> | out of band by contacting the server operators.</t> | |||
| <t>Given the expansion of the DNS namespace and the proliferation | ||||
| <t>Given the expansion of the DNS namespace, and the proliferation | ||||
| of novel business models, it is desirable to provide a method for EPP | of novel business models, it is desirable to provide a method for EPP | |||
| clients to query EPP servers for the fees and credits associated with | clients to query EPP servers for the fees and credits associated with | |||
| certain commands and specific objects.</t> | various billable transactions and certain commands and specific objects.</ | |||
| t> | ||||
| <t>This document describes an extension mapping for version 1.0 of the | <t>This document describes an extension mapping for version 1.0 of the | |||
| Extensible Provisioning Protocol (EPP) [RFC5730]. This EPP mapping | Extensible Provisioning Protocol (EPP) <xref target="RFC5730" format="defa ult"/>. This EPP mapping | |||
| provides a mechanism by which EPP clients may query the fees and credits | provides a mechanism by which EPP clients may query the fees and credits | |||
| associated with various billable transactions, and obtain their | associated with various billable transactions and obtain their | |||
| current account balance.</t> | current account balance.</t> | |||
| <section anchor="conventions" numbered="true" toc="default"> | ||||
| <name>Conventions Used in This Document</name> | ||||
| <t> | ||||
| The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQU | ||||
| IRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL NOT</bcp14>", | ||||
| "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDE | ||||
| D</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>", "<bcp14>MAY</bcp14>", and | ||||
| "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as | ||||
| described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> | ||||
| when, and only when, they appear in all capitals, as shown here. | ||||
| </t> | ||||
| <section title="Conventions Used in This Document"> | <t>XML is case sensitive. Unless stated otherwise, the XML specification | |||
| <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | s | |||
| "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and | and examples provided in this document <bcp14>MUST</bcp14> be interprete | |||
| "OPTIONAL" in this document are to be interpreted as described in BCP 14 | d in the | |||
| <xref target="RFC2119"/> | ||||
| <xref target="RFC8174"/> when, and only when, they appear | ||||
| in all capitals, as shown here.</t> | ||||
| <t>XML is case sensitive. Unless stated otherwise, XML specifications | ||||
| and examples provided in this document MUST be interpreted in the | ||||
| character case presented in order to develop a conforming | character case presented in order to develop a conforming | |||
| implementation.</t> | implementation.</t> | |||
| <t>"fee" is used as an abbreviation for "urn:ietf:params:xml:ns:epp:fee- 1.0". | <t>"fee" is used as an abbreviation for "urn:ietf:params:xml:ns:epp:fee- 1.0". | |||
| The XML namespace prefix "fee" is used, but implementations MUST NOT | The XML namespace prefix "fee" is used, but implementations <bcp14>MUST NOT</bcp14> | |||
| depend on it and instead employ a proper namespace-aware XML parser and | depend on it and instead employ a proper namespace-aware XML parser and | |||
| serializer to interpret and output the XML documents.</t> | serializer to interpret and output the XML documents.</t> | |||
| <t>In the examples, "C:" represents lines sent by a protocol client, and | ||||
| <t>In examples, "C:" represents lines sent by a protocol client and "S:" | "S:" | |||
| represents lines returned by a protocol server. Indentation and white | represents lines returned by a protocol server. Indentation and white | |||
| space in examples are provided only to illustrate element relationships | space in the examples are provided only to illustrate element relationsh ips | |||
| and are not a required feature of this protocol. | and are not a required feature of this protocol. | |||
| </t> | </t> | |||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="migrating" numbered="true" toc="default"> | ||||
| <section title="Migrating to Newer Versions of This Extension"> | <name>Migrating to Newer Versions of This Extension</name> | |||
| <t>Servers which implement this extension SHOULD provide a way for clients | <t>Servers that implement this extension <bcp14>SHOULD</bcp14> provide a w | |||
| ay for clients | ||||
| to progressively update their implementations when a new version of the | to progressively update their implementations when a new version of the | |||
| extension is deployed.</t> | extension is deployed.</t> | |||
| <t>Servers <bcp14>SHOULD</bcp14> (for a temporary migration period) provid | ||||
| <t>Servers SHOULD (for a temporary migration period) provide support for | e support for | |||
| older versions of the extension in parallel to the newest version, and | older versions of the extension in parallel to the newest version and | |||
| allow clients to select their preferred version via the <svcExtension&g t; | allow clients to select their preferred version via the <svcExtension&g t; | |||
| element of the <login> command.</t> | element of the <login> command.</t> | |||
| <t>If a client requests multiple versions of the extension at login, then, | <t>If a client requests multiple versions of the extension at login, then, | |||
| when preparing responses to commands which do not include extension | when preparing responses to commands that do not include extension | |||
| elements, the server SHOULD only include extension elements in the | elements, the server <bcp14>SHOULD</bcp14> only include extension elements | |||
| in the | ||||
| namespace of the newest version of the extension requested by the client.< /t> | namespace of the newest version of the extension requested by the client.< /t> | |||
| <t>When preparing responses to commands that do include extension | ||||
| <t>When preparing responses to commands which do include extension | elements, the server <bcp14>SHOULD</bcp14> only include extension elements | |||
| elements, the server SHOULD only include extension elements for the | for the | |||
| extension versions present in the command.</t> | extension versions present in the command.</t> | |||
| </section> | </section> | |||
| <section anchor="extension-elements" numbered="true" toc="default"> | ||||
| <section title="Extension Elements"> | <name>Extension Elements</name> | |||
| <section title="Client Commands"> | <section anchor="client-commands" numbered="true" toc="default"> | |||
| <name>Client Commands</name> | ||||
| <t>The <fee:command> element is used in the EPP <check> | <t>The <fee:command> element is used in the EPP <check> | |||
| command to determine the fee that is applicable to the given command.</t | command to determine the fee that is applicable to the given | |||
| > | command.</t> | |||
| <t>The use of the <fee:command> keys off the use of the "name" | ||||
| attribute to define which transform fees the client is requesting | ||||
| information about. Here is the list of possible values for the "name" | ||||
| attribute:</t> | ||||
| <t><list style="symbols"> | ||||
| <t>"create" indicating a <create> command as defined in [RFC5730 | ||||
| ];</t> | ||||
| <t>"delete" indicating a <delete> command as defined in [RFC5730 | ||||
| ];</t> | ||||
| <t>"renew" indicating a <renew> command as defined in [RFC5730]; | ||||
| </t> | ||||
| <t>"update" indicating a <update> command as defined in [RFC5730 | ||||
| ];</t> | ||||
| <t>"transfer" indicating a <transfer> command as defined in [RFC | ||||
| 5730];</t> | ||||
| <t>If the server supports the Registry Grace Period Mapping [RFC3915], | ||||
| then the server MUST also support the "restore" value as defined in | ||||
| [RFC3915];</t> | ||||
| <t>"custom" indicating a custom command that MUST set the "customName" | ||||
| attribute with custom command name. The possible set of custom command | ||||
| name values is up to server policy.</t> | ||||
| </list></t> | ||||
| <t>The <fee:command> element MAY have an OPTIONAL "phase" | <t>The "name" attribute of the <fee:command> is used to define whi | |||
| ch transform fees the client is requesting | ||||
| information about. The possible values for the "name" | ||||
| attribute are:</t> | ||||
| <ul spacing="normal"> | ||||
| <li>"create", indicating a <create> command as defined in <xref | ||||
| target="RFC5730" format="default"/>.</li> | ||||
| <li>"delete", indicating a <delete> command as defined in <xref | ||||
| target="RFC5730" format="default"/>.</li> | ||||
| <li>"renew", indicating a <renew> command as defined in <xref | ||||
| target="RFC5730" format="default"/>.</li> | ||||
| <li>"update", indicating a <update> command as defined in <xref | ||||
| target="RFC5730" format="default"/>.</li> | ||||
| <li>"transfer", indicating a <transfer> command as defined in | ||||
| <xref target="RFC5730" format="default"/>.</li> | ||||
| <li>If the server supports registry grace period mapping <xref | ||||
| target="RFC3915" format="default"/>, | ||||
| then the server <bcp14>MUST</bcp14> also support the "restore" value a | ||||
| s defined in | ||||
| <xref target="RFC3915" format="default"/>.</li> | ||||
| <li>"custom", indicating a custom command that <bcp14>MUST</bcp14> set | ||||
| the "customName" | ||||
| attribute with a custom command name. The possible set of custom comma | ||||
| nd | ||||
| name values is dictated by the server policy.</li> | ||||
| </ul> | ||||
| <t>The <fee:command> element <bcp14>MAY</bcp14> have an <bcp14>OPT | ||||
| IONAL</bcp14> "phase" | ||||
| attribute specifying a launch phase as described in | attribute specifying a launch phase as described in | |||
| [RFC8334]. It may also contain an OPTIONAL | <xref target="RFC8334" format="default"/>. It may also contain an <bcp1 | |||
| "subphase" attribute identifying the custom or sub-phase as described in | 4>OPTIONAL</bcp14> | |||
| [RFC8334].</t> | "subphase" attribute identifying the custom or subphase as described in | |||
| <xref target="RFC8334" format="default"/>.</t> | ||||
| </section> | </section> | |||
| <section anchor="currency-codes" numbered="true" toc="default"> | ||||
| <section title="Currency Codes"> | <name>Currency Codes</name> | |||
| <t>The <fee:currency> element is used to indicate which currency | <t>The <fee:currency> element is used to indicate the currency | |||
| fees are charged in. This value of this element MUST be a | in which fees are charged. The value of this element <bcp14>MUST</bcp14> | |||
| three-character currency code from [ISO4217:2015].</t> | be a | |||
| three-character currency code from <xref target="ISO4217_2015" format="d | ||||
| <t>Note that ISO 4217:2015 provides the special "XXX" code, which MAY be | efault"/>.</t> | |||
| used | <t>Note that <xref target="ISO4217_2015" format="default"/> provides the | |||
| if the server uses a non-currency based system for assessing fees, such | special "XXX" code, which <bcp14>MAY</bcp14> be used | |||
| if the server uses a non-currency-based system for assessing fees, such | ||||
| as a system of credits.</t> | as a system of credits.</t> | |||
| <t>The use of <fee:currency> elements in client commands is <bcp14 | ||||
| <t>The use of <fee:currency> elements in client commands is OPTION | >OPTIONAL</bcp14>: if | |||
| AL: if | ||||
| a <fee:currency> element is not present in a command, the server | a <fee:currency> element is not present in a command, the server | |||
| MUST determine the currency based on the server default currency or | <bcp14>MUST</bcp14> determine the currency based on the server default c | |||
| based on the client's account settings which are agreed to by the client | urrency or on the client's account settings, which are agreed to by the client | |||
| and server via an out-of-band channel. However, the <fee:currency> | and server via an out-of-band channel. However, the | |||
| element MUST be present in responses.</t> | <fee:currency> element <bcp14>MUST</bcp14> be present in the respon | |||
| ses.</t> | ||||
| <t>Servers SHOULD NOT perform a currency conversion if a client uses an | <t>Servers <bcp14>SHOULD NOT</bcp14> perform a currency conversion if a | |||
| incorrect currency code. Servers SHOULD return a 2004 "Parameter value | client uses an | |||
| range" error instead.</t> | incorrect currency code. Servers <bcp14>SHOULD</bcp14> return a 2004 "P | |||
| arameter value | ||||
| range error" instead.</t> | ||||
| </section> | </section> | |||
| <section anchor="validity-periods" numbered="true" toc="default"> | ||||
| <section title="Validity Periods"> | <name>Validity Periods</name> | |||
| <t>When querying for fee information using the <check> command, | <t>When querying for fee information using the <check> command, | |||
| the <fee:period> element is used to indicate the period measured | the <fee:period> element is used to indicate the validity | |||
| in years or months, with the appropriate units specified using the "unit | period, which is to be added to extend the registration period of | |||
| " | objects by the <create>, <renew>, and <transfer> | |||
| attribute to be added to the registration period of objects by the | commands. Validity periods are measured in years or months, with the | |||
| <create>, <renew> and <transfer> commands. This | appropriate units specified using the "unit" attribute. Valid values | |||
| element is derived from the <domain:period> element described in | for the "unit" attribute are "y" for years and "m" for months. | |||
| [RFC5731].</t> | ||||
| <t>The <fee:period> element is OPTIONAL in <check> commands, | This element is derived from the <domain:period> element described in | |||
| if omitted, the server MUST determine the fee(s) using the server | <xref target="RFC5731" format="default"/>.</t> | |||
| default period. The <fee:period> element MUST be present in | <t>The <fee:period> element is <bcp14>OPTIONAL</bcp14> in <chec | |||
| k> commands; | ||||
| if omitted, the server <bcp14>MUST</bcp14> determine the fee(s) using th | ||||
| e server | ||||
| default period. The <fee:period> element <bcp14>MUST</bcp14> be p | ||||
| resent in | ||||
| <check> responses.</t> | <check> responses.</t> | |||
| </section> | </section> | |||
| <section anchor="fees-credits" numbered="true" toc="default"> | ||||
| <section title="Fees and Credits"> | <name>Fees and Credits</name> | |||
| <t>Servers which implement this extension will include elements in | <t>Servers that implement this extension will include elements in | |||
| responses which provide information about the fees and/or credits | responses that provide information about the fees and/or credits | |||
| associated with a given billable transaction. A fee will result in | associated with a given billable transaction. A fee will result in | |||
| subtracting from the Account Balance (described in Section 3.5) and a | subtracting from the Account Balance (described in <xref | |||
| credit will result in adding to the Account Balance (described in | target="account-balance"/>), and a | |||
| Section 3.5).</t> | credit will result in adding to the Account Balance (described in <xref | |||
| target="account-balance"/>).</t> | ||||
| <t>The <fee:fee> and <fee:credit> elements are used to | <t>The <fee:fee> and <fee:credit> elements are used to | |||
| provide this information. The presence of a <fee:fee> element in | provide this information. The presence of a <fee:fee> element in | |||
| a response indicates a debit against the client's account balance; a | a response indicates a debit against the client's account balance; a | |||
| <fee:credit> element indicates a credit. A <fee:fee> | <fee:credit> element indicates a credit. A <fee:fee> | |||
| element MUST have a zero or greater (non-negative) value. A <fee:cre | element <bcp14>MUST</bcp14> have a zero or greater (non-negative) value. | |||
| dit> element | A <fee:credit> element | |||
| MUST have a negative value.</t> | <bcp14>MUST</bcp14> have a negative value.</t> | |||
| <t>A server <bcp14>MAY</bcp14> respond with multiple <fee:fee> and | ||||
| <t>A server MAY respond with multiple <fee:fee> and <fee:credit | <fee:credit> | |||
| > | ||||
| elements in the same response. In such cases, the net fee or credit | elements in the same response. In such cases, the net fee or credit | |||
| applicable to the transaction is the arithmetic sum of the values of | applicable to the transaction is the arithmetic sum of the values of | |||
| each of the <fee:fee> and/or <fee:credit> elements. This | each of the <fee:fee> and/or <fee:credit> elements. This | |||
| amount applies to the total additional validity period applied to the | amount applies to the total additional validity period for the | |||
| object (where applicable).</t> | object (where applicable).</t> | |||
| <t>The following attributes are defined for the <fee:fee> element. | <t>The following attributes are defined for the <fee:fee> element. | |||
| These are described in detail below:</t> | These are described in detail below:</t> | |||
| <t>description: an OPTIONAL attribute which provides a human-readable | <dl newline="false"> | |||
| <dt>description:</dt> | ||||
| <dd>an <bcp14>OPTIONAL</bcp14> attribute that provides a human-readable | ||||
| description of the fee. Servers should provide documentation on the | description of the fee. Servers should provide documentation on the | |||
| possible values of this attribute, and their meanings. An OPTIONAL | possible values of this attribute and their meanings. An <bcp14>OPTIONAL | |||
| "lang" attribute MAY be present, per the language structure in [RFC5646] | </bcp14> | |||
| , | "lang" attribute <bcp14>MAY</bcp14> be present, per the language structu | |||
| re in <xref | ||||
| target="RFC5646" format="default"/>, | ||||
| to identify the language of the returned text and has a default value | to identify the language of the returned text and has a default value | |||
| of "en" (English). If the "description" attribute is not present, the | of "en" (English). If the "description" attribute is not present, the | |||
| "lang" attribute can be ignored.</t> | "lang" attribute can be ignored.</dd> | |||
| <dt>refundable:</dt> | ||||
| <t>refundable: an OPTIONAL boolean attribute indicating whether the fee | <dd>an <bcp14>OPTIONAL</bcp14> boolean attribute indicating whether the fee | |||
| is refundable if the object is deleted.</t> | is refundable if the object is deleted.</dd> | |||
| <dt>grace-period:</dt> <dd>an <bcp14>OPTIONAL</bcp14> attribute that pro | ||||
| <t>grace-period: an OPTIONAL attribute which provides the time period | vides the time period | |||
| during which the fee is refundable.</t> | during which the fee is refundable.</dd> | |||
| <dt>applied:</dt> <dd>an <bcp14>OPTIONAL</bcp14> attribute indicating w | ||||
| <t>applied: an OPTIONAL attribute indicating when the fee will be | hen the fee will be | |||
| deducted from the client's account.</t> | deducted from the client's account.</dd></dl> | |||
| <t>The <fee:credit> element can take a "description" attribute as | <t>The <fee:credit> element can take a "description" attribute as | |||
| described above. An OPTIONAL "lang" attribute MAY be present to | described above. An <bcp14>OPTIONAL</bcp14> "lang" attribute <bcp14>M AY</bcp14> be present to | |||
| identify the language of the returned text and has a default value of | identify the language of the returned text and has a default value of | |||
| "en" (English).</t> | "en" (English).</t> | |||
| <section title="Refunds"> | <section anchor="refunds" numbered="true" toc="default"> | |||
| <t><fee:fee> elements MAY have an OPTIONAL "refundable" | <name>Refunds</name> | |||
| attribute which takes a boolean value. Fees may be refunded under | <t><fee:fee> elements <bcp14>MAY</bcp14> have an <bcp14>OPTIONAL | |||
| </bcp14> "refundable" | ||||
| attribute that takes a boolean value. Fees may be refunded under | ||||
| certain circumstances, such as when a domain application is rejected | certain circumstances, such as when a domain application is rejected | |||
| (as described in [RFC8334]) or when an object is | (as described in <xref target="RFC8334" format="default"/>) or when an | |||
| deleted during the relevant Grace Period (see below).</t> | object is | |||
| deleted during the relevant grace period (see <xref target="grace-peri | ||||
| <t>If the "refundable" attribute is omitted, then clients SHOULD NOT | ods"/>).</t> | |||
| make any assumption about the refundability of the fee.</t> | <t>If the "refundable" attribute is omitted, then clients <bcp14>SHOUL | |||
| D NOT</bcp14> | ||||
| make any assumptions about the refundability of the fee.</t> | ||||
| </section> | </section> | |||
| <section anchor="grace-periods" numbered="true" toc="default"> | ||||
| <section title="Grace Periods"> | <name>Grace Periods</name> | |||
| <t>[RFC3915] describes a system of "grace periods", which are time | <t><xref target="RFC3915" format="default"/> describes a system of "gr | |||
| ace periods", which are time | ||||
| periods following a billable transaction during which, if an object is | periods following a billable transaction during which, if an object is | |||
| deleted, the client receives a refund.</t> | deleted, the client receives a refund.</t> | |||
| <t>The "grace-period" attribute <bcp14>MAY</bcp14> be used to indicate | ||||
| <t>The "grace-period" attribute MAY be used to indicate the relevant | the relevant | |||
| grace period for a fee. If a server implements the Registry Grace | grace period for a fee. If a server implements the registry grace | |||
| Period extension [RFC3915], it MUST specify the grace period for all | period extension <xref target="RFC3915" format="default"/>, it <bcp14> | |||
| MUST</bcp14> specify the grace period for all | ||||
| relevant transactions.</t> | relevant transactions.</t> | |||
| <t>If the "grace-period" attribute is omitted, then clients <bcp14>SHO | ||||
| <t>If the "grace-period" attribute is omitted, then clients SHOULD NOT | ULD NOT</bcp14> | |||
| make any assumption about the grace period of the fee.</t> | make any assumptions about the grace period of the fee.</t> | |||
| </section> | </section> | |||
| <section anchor="correlation-refund-grace" numbered="true" toc="default" | ||||
| <section title="Correlation between Refundability and Grace Periods"> | > | |||
| <t>If a <fee:fee> element has a "grace-period" attribute then it | <name>Correlation between Refundability and Grace Periods</name> | |||
| MUST also be refundable and the "refundable" attribute MUST be true. | <t>If a <fee:fee> element has a "grace-period" attribute, then i | |||
| If the "refundable" attribute of a <fee:fee> element is false | t | |||
| then it MUST NOT have a "grace-period" attribute.</t> | <bcp14>MUST</bcp14> also be refundable, and the "refundable" attribute | |||
| <bcp14>MUST</bcp14> be true. | ||||
| If the "refundable" attribute of a <fee:fee> element is false, | ||||
| then it <bcp14>MUST NOT</bcp14> have a "grace-period" attribute.</t> | ||||
| </section> | </section> | |||
| <section anchor="applicability" numbered="true" toc="default"> | ||||
| <section title="Applicability"> | <name>Applicability</name> | |||
| <t>Fees may be applied immediately upon receipt of a command from a | <t>Fees may be applied immediately upon receipt of a command from a | |||
| client, or may only be applied once an out-of-band process (such as | client or may only be applied once an out-of-band process (such as | |||
| the processing of applications at the end of a launch phase) has taken | the processing of applications at the end of a launch phase) has taken | |||
| place.</t> | place.</t> | |||
| <t>The "applied" attribute of the <fee:fee> element allows | <t>The "applied" attribute of the <fee:fee> element allows | |||
| servers to indicate whether a fee will be applied immediately, or | servers to indicate whether a fee will be applied immediately or | |||
| whether it will be applied at some point in the future. This | whether it will be applied at some point in the future. This | |||
| attribute takes two possible values: "immediate" or "delayed".</t> | attribute takes two possible values: "immediate" or "delayed".</t> | |||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="account-balance" numbered="true" toc="default"> | ||||
| <section title="Account Balance"> | <name>Account Balance</name> | |||
| <t>The <fee:balance> element is an OPTIONAL element which MAY be | <t>The <fee:balance> element is an <bcp14>OPTIONAL</bcp14> element | |||
| that <bcp14>MAY</bcp14> be | ||||
| included in server responses to transform commands. If present, it can | included in server responses to transform commands. If present, it can | |||
| be used by the client to determine the remaining credit at the server.</ t> | be used by the client to determine the remaining credit at the server.</ t> | |||
| <t>Whether or not the <fee:balance> is included in responses is a | <t>Whether or not the <fee:balance> is included in responses is a | |||
| matter of server policy. However, if a server chooses to offer support | matter of server policy. However, if a server chooses to offer support | |||
| for this element, it MUST be included in responses to all "transform" or | for this element, it <bcp14>MUST</bcp14> be included in responses to all | |||
| billable commands (e.g. <create>, <renew>, <update>, | "transform" or | |||
| billable commands (e.g., <create>, <renew>, <update>, | ||||
| <delete>, <transfer op="request">).</t> | <delete>, <transfer op="request">).</t> | |||
| <t>The value of the <fee:balance> <bcp14>MAY</bcp14> be negative. | ||||
| <t>The value of the <fee:balance> MAY be negative. A negative | A negative | |||
| balance indicates that the server has extended a line of credit to the | balance indicates that the server has extended a line of credit to the | |||
| client (see below).</t> | client (see <xref target="credit-limit"/>).</t> | |||
| <t>If a server includes a <fee:balance> element in response to | <t>If a server includes a <fee:balance> element in response to | |||
| transform commands, the value of the element MUST reflect the client's | transform commands, the value of the element <bcp14>MUST</bcp14> reflect the client's | |||
| account balance after any fees or credits associated with that command | account balance after any fees or credits associated with that command | |||
| have been applied. If the "applied" attribute of the <fee:fee> ele ment | have been applied. If the "applied" attribute of the <fee:fee> ele ment | |||
| is "delayed", then the <fee:balance> MUST reflect the client's acc ount | is "delayed", then the <fee:balance> <bcp14>MUST</bcp14> reflect t he client's account | |||
| balance without any fees or credits associated with that command.</t> | balance without any fees or credits associated with that command.</t> | |||
| </section> | </section> | |||
| <section anchor="credit-limit" numbered="true" toc="default"> | ||||
| <name>Credit Limit</name> | ||||
| <section title="Credit Limit"> | ||||
| <t>As described above, if a server returns a response containing a | <t>As described above, if a server returns a response containing a | |||
| <fee:balance> with a negative value, then the server has extended | <fee:balance> with a negative value, then the server has extended | |||
| a line of credit to the client. A server MAY also include a | a line of credit to the client. A server <bcp14>MAY</bcp14> also | |||
| <fee:creditLimit> element in responses that indicates the maximum | include in responses a | |||
| credit available to a client. A server MAY reject certain transactions | <fee:creditLimit> element that indicates the maximum | |||
| credit available to a client. A server <bcp14>MAY</bcp14> reject certai | ||||
| n transactions | ||||
| if the absolute value of the <fee:balance> is equal to or exceeds the | if the absolute value of the <fee:balance> is equal to or exceeds the | |||
| value of the <fee:creditLimit> element.</t> | value of the <fee:creditLimit> element.</t> | |||
| <t>Whether or not the <fee:creditLimit> is included in responses | <t>Whether or not the <fee:creditLimit> is included in responses | |||
| is a matter of server policy. However, if a server chooses to offer | is a matter of server policy. However, if a server chooses to offer | |||
| support for this element, it MUST be included in responses to all | support for this element, it <bcp14>MUST</bcp14> be included in response | |||
| "transform" commands (e.g. <create>, <renew>, <update> | s to all | |||
| , | "transform" commands (e.g., <create>, <renew>, <update> | |||
| ;, | ||||
| <delete>, <transfer op="request">).</t> | <delete>, <transfer op="request">).</t> | |||
| </section> | </section> | |||
| <section anchor="classification-objects" numbered="true" toc="default"> | ||||
| <section title="Classification of Objects"> | <name>Classification of Objects</name> | |||
| <t>Objects may be assigned to a particular class, category, or tier, | <t>Objects may be assigned to a particular class, category, or tier, | |||
| each of which has a particular fee or set of fees associated with it. | each of which has a particular fee or set of fees associated with it. | |||
| The <fee:class> element, which MAY appear in <check> and | The <fee:class> element, which <bcp14>MAY</bcp14> appear in <ch eck> and | |||
| transform responses, is used to indicate the classification of an object .</t> | transform responses, is used to indicate the classification of an object .</t> | |||
| <t>If a server makes use of this element, it should provide clients with | <t>If a server makes use of this element, it should provide clients with | |||
| a list of all the values that the element may take via an out-of-band | a list of all the values that the element may take via an out-of-band | |||
| channel. Servers MUST NOT use values which do not appear on this list.< | channel. Servers <bcp14>MUST NOT</bcp14> use values that do not appear | |||
| /t> | on this list.</t> | |||
| <t>Servers that make use of this element <bcp14>MUST</bcp14> use a <f | ||||
| <t>Servers that make use of this element MUST use a <fee:class> | ee:class> | |||
| element with the value "standard" for all objects that are subject to | element with the value "standard" for all objects that are subject to | |||
| the standard or default fee.</t> | the standard or default fee.</t> | |||
| </section> | </section> | |||
| <section anchor="phase-subphase" numbered="true" toc="default"> | ||||
| <section title="Phase and Subphase Attributes"> | <name>"Phase" and "Subphase" Attributes</name> | |||
| <t>The <fee:command> element has two attributes, phase and | <t>The <fee:command> element has two attributes, "phase" and | |||
| subphase, that provide additional information related to a specific | "subphase", that provide additional information related to a specific | |||
| launch phase as described in [RFC8334]. These | launch phase, as described in <xref target="RFC8334" format="default"/>. | |||
| These | ||||
| attributes are used as filters that should refine the server processing. </t> | attributes are used as filters that should refine the server processing. </t> | |||
| <t>If the client <fee:command> contains a server-supported | ||||
| <t>If the client <fee:command> contains a server supported | combination of phase/subphase, the server <bcp14>MUST</bcp14> return | |||
| combination of phase/subphase the server MUST return fee data (including | the fee data (including | |||
| the phase/subphase attribute(s)) for the specific combination.</t> | the phase/subphase attribute(s)) for the specific combination.</t> | |||
| <t>If the client <fee:command> contains no "phase"/"subphase" | ||||
| <t>If the client <fee:command> contains no phase/subphase | attributes and the server has only one active phase/subphase combination | |||
| attributes and the server has only one active phase/subphase combination | , | |||
| the server MUST return data (including the phase/subphase attribute(s)) | the server <bcp14>MUST</bcp14> return the data (including the "phase"/"s | |||
| ubphase" attribute(s)) | ||||
| of the currently active phase/subphase.</t> | of the currently active phase/subphase.</t> | |||
| <t>If the client <fee:command> contains no phase/subphase | <t>If the client <fee:command> contains no phase/subphase | |||
| attributes and the server has more than one active phase/subphase | attributes and the server has more than one active phase/subphase | |||
| combination the server MUST respond with a 2003 "Required | combination, the server <bcp14>MUST</bcp14> respond with a 2003 "Require d | |||
| parameter missing" error.</t> | parameter missing" error.</t> | |||
| <t>If the client <fee:command> contains no phase/subphase | <t>If the client <fee:command> contains no phase/subphase | |||
| attributes and the server is currently in a "quiet period" (e.g. not | attributes and the server is currently in a "quiet period" (e.g., not | |||
| accepting registrations or applications) the server MUST return data | accepting registrations or applications), the server <bcp14>MUST</bcp14> | |||
| consistent with the default general availability phase (e.g. "open" or | return data | |||
| "claims") including the appropriate phase/subphase attribute(s).</t> | consistent with the default general availability phase (e.g., "open" or | |||
| "claims"), including the appropriate phase/subphase attribute(s).</t> | ||||
| <t>If the client <fee:command> contains a phase attribute with no | <t>If the client <fee:command> contains a phase attribute with no | |||
| subphase and the server has only one active subphase (or no subphase) of | subphase and the server has only one active subphase (or no subphase) of | |||
| this phase, the server MUST return data (including the phase/subphase | this phase, the server <bcp14>MUST</bcp14> return the data (including th e phase/subphase | |||
| attribute(s)) of the provided phase and currently active subphase.</t> | attribute(s)) of the provided phase and currently active subphase.</t> | |||
| <t>If the client <fee:command> contains a phase attribute with no | <t>If the client <fee:command> contains a phase attribute with no | |||
| subphase and the server has more than one active subphase combination of | subphase and the server has more than one active subphase combination of | |||
| this phase, the server MUST respond with a 2003 "Required parameter | this phase, the server <bcp14>MUST</bcp14> respond with a 2003 "Required parameter | |||
| missing" error.</t> | missing" error.</t> | |||
| <t>If the client <fee:command> contains a subphase with no phase | <t>If the client <fee:command> contains a subphase with no phase | |||
| attribute the server MUST respond with a 2003 "Required parameter | attribute, the server <bcp14>MUST</bcp14> respond with a 2003 "Required parameter | |||
| missing" error.</t> | missing" error.</t> | |||
| <t>If the client <fee:command> contains a phase attribute not | <t>If the client <fee:command> contains a phase attribute not | |||
| defined in [RFC8334] or not supported by server | defined in <xref target="RFC8334" format="default"/> or not supported | |||
| the server MUST respond with a 2004 "Parameter value range" error.</t> | by the server, | |||
| the server <bcp14>MUST</bcp14> respond with a 2004 "Parameter value rang | ||||
| e error".</t> | ||||
| <t>If the client <fee:command> contains a subphase attribute (or | <t>If the client <fee:command> contains a subphase attribute (or | |||
| phase/subphase combination) not supported by server the server MUST | phase/subphase combination) not supported by the server, the server <bcp | |||
| respond with a 2004 "Parameter value range" error.</t> | 14>MUST</bcp14> | |||
| respond with a 2004 "Parameter value range error".</t> | ||||
| </section> | </section> | |||
| <section anchor="reason" numbered="true" toc="default"> | ||||
| <section title="Reason"> | <name>Reason</name> | |||
| <t>The <fee:reason> element is used to provide server specific | <t>The <fee:reason> element is used to provide server-specific | |||
| text in an effort to better explain why a <check> command did not | text in an effort to better explain why a <check> command did not | |||
| complete as the client expected. An OPTIONAL "lang" attribute MAY be | complete as the client expected. An <bcp14>OPTIONAL</bcp14> "lang" attri bute <bcp14>MAY</bcp14> be | |||
| present to identify the language, per the language structure in | present to identify the language, per the language structure in | |||
| [RFC5646], of the returned text and has a default value of "en" (English | <xref target="RFC5646" format="default"/>, of the returned text and has | |||
| ).</t> | a default value of "en" (English).</t> | |||
| <t>The <fee:reason> element can be used within the server response | <t>The <fee:reason> element can be used within the server response | |||
| <fee:command> element or within the <fee:cd> element. See | <fee:command> element or within the <fee:cd> element. See | |||
| section 5.1.1 for details on the <fee:cd> "check data" element.</t | <xref target="epp-check"/> for details on the <fee:cd> "check data | |||
| > | " element.</t> | |||
| <t>If the server cannot calculate the relevant fees because the object, | ||||
| <t>If the server cannot calculate the relevant fees, because the object, | command, currency, period, class, or some combination is invalid per | |||
| command, currency, period, class or some combination is invalid per | server policy, the server has two ways of handling the error processing | |||
| server policy, the server has two ways of handling error processing of | of | |||
| <fee:command> element(s):</t> | <fee:command> element(s):</t> | |||
| <ol spacing="normal" type="1"> | ||||
| <t><list style="numbers"> | <li> | |||
| <t>Fast-fail - The server, upon error identification, MAY stop | <t>Fast-fail: The server, upon error identification, <bcp14>MAY</bcp | |||
| processing <fee:command> elements and return to the client a | 14> stop | |||
| <fee:cd> containing the <fee:objID> and a | processing <fee:command> elements and return a | |||
| <fee:cd> to the client containing the <fee:objID> and a | ||||
| <fee:reason> element detailing the reason for failure. | <fee:reason> element detailing the reason for failure. | |||
| <figure> | </t> | |||
| <artwork><![CDATA[ S: <fee:cd avail="0"> | ||||
| <sourcecode name="" type=""><![CDATA[ S: <fee:cd avail="0"> | ||||
| S: <fee:objID>example.xyz</fee:objID> | S: <fee:objID>example.xyz</fee:objID> | |||
| S: <fee:reason>Only 1 year registration periods are | S: <fee:reason>Only 1 year registration periods are | |||
| S: valid.</fee:reason> | S: valid.</fee:reason> | |||
| S: </fee:cd> | S: </fee:cd> | |||
| ]]> | ]]></sourcecode> | |||
| </artwork> | </li> | |||
| </figure> | <li> | |||
| </t> | <t>Partial-fail: The server, upon error identification, <bcp14>MAY</ | |||
| <t>Partial-fail - The server, upon error identification, MAY continue | bcp14> continue | |||
| processing <fee:command> elements and return to the client a | processing <fee:command> elements and return a | |||
| <fee:cd> containing successfully processed <fee:command> | <fee:cd> to the client containing the successfully processed < | |||
| ;fee:command> | ||||
| elements and failed <fee:command> elements. All returned failed | elements and failed <fee:command> elements. All returned failed | |||
| <fee:command> elements MUST have a <fee:reason> | <fee:command> elements <bcp14>MUST</bcp14> have a <fee:reason | |||
| element detailing the reason for failure, and the server MAY | > | |||
| element detailing the reason for failure, and the server <bcp14>MAY</b | ||||
| cp14> | ||||
| additionally include a <fee:reason> element at the | additionally include a <fee:reason> element at the | |||
| <fee:cd> level. | <fee:cd> level. | |||
| <figure> | </t> | |||
| <artwork><![CDATA[ S: <fee:cd avail="0"> | <sourcecode name="" type=""><![CDATA[ S: <fee:cd avail="0"> | |||
| S: <fee:objID>example.xyz</fee:objID> | S: <fee:objID>example.xyz</fee:objID> | |||
| S: <fee:command name="create"> | S: <fee:command name="create"> | |||
| S: <fee:period unit="y">2</fee:period> | S: <fee:period unit="y">2</fee:period> | |||
| S: <fee:reason>Only 1 year registration periods are | S: <fee:reason>Only 1 year registration periods are | |||
| S: valid.</fee:reason> | S: valid.</fee:reason> | |||
| S: </fee:command> | S: </fee:command> | |||
| S: </fee:cd> | S: </fee:cd> | |||
| ]]> | ]]></sourcecode> | |||
| </artwork> | </li> | |||
| </figure> | </ol> | |||
| </t> | <t>In either failure scenario, the server <bcp14>MUST</bcp14> set the &l | |||
| </list></t> | t;fee:cd> | |||
| "avail" attribute to false (0), and the server <bcp14>MUST</bcp14> proce | ||||
| <t>In either failure scenario the server MUST set the <fee:cd> | ss all objects in | |||
| avail attribute to false (0) and the server MUST process all objects in | ||||
| the client request.</t> | the client request.</t> | |||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="server-handling" numbered="true" toc="default"> | ||||
| <section title="Server Handling of Fee Information"> | <name>Server Handling of Fee Information</name> | |||
| <t>Depending on server policy, a client MAY be required to include the | <t>Depending on the server policy, a client <bcp14>MAY</bcp14> be required | |||
| to include the | ||||
| extension elements described in this document for certain transform | extension elements described in this document for certain transform | |||
| commands. Servers must provide clear documentation to clients about the | commands. Servers must provide clear documentation to clients about the | |||
| circumstances in which this extension must be used.</t> | circumstances in which this extension must be used.</t> | |||
| <t>The server <bcp14>MUST</bcp14> return avail="0" in its response to a &l | ||||
| <t>The server MUST return avail="0" in its response to a <check> | t;check> | |||
| command for any object in the <check> command that does not | command for any object in the <check> command that does not | |||
| include the <fee:check> extension for which the server would | include the <fee:check> extension where the server would | |||
| likewise fail a domain <create> command when no <fee> | fail a domain <create> command when no <fee> | |||
| extension is provided for that same object.</t> | extension is provided for that same object.</t> | |||
| <t>If a server receives a <check> command from a client that | ||||
| <t>If a server receives a <check> command from a client, which | results in no possible fee combination, the server <bcp14>MUST</bcp14> set | |||
| results in no possible fee combination, the server MUST set the "avail" | the "avail" | |||
| attribute of the <fee:cd> element to false (0) and provide a | attribute of the <fee:cd> element to false (0) and provide a | |||
| <fee:reason>.</t> | <fee:reason>.</t> | |||
| <t>If a server receives a <check> command from a client that results | ||||
| <t>If a server receives a <check> command from a client, which | in an ambiguous result (i.e., multiple possible fee combinations), | |||
| results in an ambiguous result (i.e. multiple possible fee combinations) | the server <bcp14>MUST</bcp14> reject the command with a 2003 "Required pa | |||
| the server MUST reject the command with a 2003 "Required parameter | rameter | |||
| missing" error.</t> | missing" error.</t> | |||
| <t>If a server receives a command from a client that does not include the | ||||
| <t>If a server receives a command from a client, which does not include th | ||||
| e | ||||
| fee extension data elements required by the server for that command, then | fee extension data elements required by the server for that command, then | |||
| the server MUST respond with a 2003 "Required parameter missing" error.</t | the server <bcp14>MUST</bcp14> respond with a 2003 "Required parameter mis | |||
| > | sing" error.</t> | |||
| <t>If the total fee provided by the client is less than the server's own | <t>If the total fee provided by the client is less than the server's own | |||
| calculation of the fee or the server determines the currency is | calculation of the fee or the server determines the currency is | |||
| inappropriate for that command, then the server MUST reject the command | inappropriate for that command, then the server <bcp14>MUST</bcp14> reject | |||
| with a 2004 "Parameter value range" error.</t> | the command | |||
| with a 2004 "Parameter value range error".</t> | ||||
| </section> | </section> | |||
| <section anchor="epp-command" numbered="true" toc="default"> | ||||
| <section title="EPP Command Mapping"> | <name>EPP Command Mapping</name> | |||
| <t>A detailed description of the EPP syntax and semantics can be found in | <t>A detailed description of the EPP syntax and semantics can be found in | |||
| [RFC5730].</t> | <xref target="RFC5730" format="default"/>.</t> | |||
| <section anchor="epp-query" numbered="true" toc="default"> | ||||
| <section title="EPP Query Commands"> | <name>EPP Query Commands</name> | |||
| <t>This extension does not add any elements to the EPP <poll> or | <t>This extension does not add any elements to the EPP <poll> or | |||
| <info> commands or responses.</t> | <info> commands or responses.</t> | |||
| <section anchor="epp-check" numbered="true" toc="default"> | ||||
| <name>EPP <check> Command</name> | ||||
| <section title="EPP <check> Command"> | ||||
| <t>This extension defines a new command called the Fee Check Command | <t>This extension defines a new command called the Fee Check Command | |||
| that defines additional elements for the EPP <check> command to | that defines additional elements for the EPP <check> command to | |||
| provide fee information along with the availability information of the | provide fee information.</t> | |||
| EPP <check> command.</t> | <t>The command <bcp14>MAY</bcp14> contain an <extension> element | |||
| , which <bcp14>MAY</bcp14> | ||||
| <t>The command MAY contain an <extension> element which MAY | ||||
| contain a <fee:check> element. The <fee:check> element | contain a <fee:check> element. The <fee:check> element | |||
| MAY contain one <fee:currency> element and MUST contain one or | <bcp14>MAY</bcp14> contain one <fee:currency> element and <bcp14 >MUST</bcp14> contain one or | |||
| more <fee:command> elements.</t> | more <fee:command> elements.</t> | |||
| <t>The <fee:command> element(s) <bcp14>MUST</bcp14> contain a "n | ||||
| <t>The <fee:command> element(s) MUST contain(s) a "name" attribu | ame" attribute | |||
| te | (see <xref target="client-commands"/>), an <bcp14>OPTIONAL</bcp14> "ph | |||
| (see Section 3.1), an OPTIONAL "phase" attribute, and an OPTIONAL | ase" attribute, and an <bcp14>OPTIONAL</bcp14> | |||
| "subphase" attribute (see Section 3.8). The <fee:command> | "subphase" attribute (see <xref target="phase-subphase"/>). The <fe | |||
| element(s) MAY have the following child elements:</t> | e:command> | |||
| element(s) <bcp14>MAY</bcp14> have the following child elements:</t> | ||||
| <t><list style="symbols"> | <ul spacing="normal"> | |||
| <t>An OPTIONAL <fee:period> element (as described in Section 3 | <li>An <bcp14>OPTIONAL</bcp14> <fee:period> element (as descri | |||
| .3).</t> | bed in <xref target="validity-periods"/>).</li> | |||
| </list></t> | </ul> | |||
| <t>Example <check> command:</t> | ||||
| <figure> | <sourcecode name="" type=""><![CDATA[ | |||
| <preamble>Example <check> command:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| C: <command> | C: <command> | |||
| C: <check> | C: <check> | |||
| C: <domain:check | C: <domain:check | |||
| C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| C: <domain:name>example.com</domain:name> | C: <domain:name>example.com</domain:name> | |||
| C: <domain:name>example.net</domain:name> | C: <domain:name>example.net</domain:name> | |||
| C: <domain:name>example.xyz</domain:name> | C: <domain:name>example.xyz</domain:name> | |||
| C: </domain:check> | C: </domain:check> | |||
| skipping to change at line 617 ¶ | skipping to change at line 507 ¶ | |||
| C: <fee:command name="create"> | C: <fee:command name="create"> | |||
| C: <fee:period unit="y">2</fee:period> | C: <fee:period unit="y">2</fee:period> | |||
| C: </fee:command> | C: </fee:command> | |||
| C: <fee:command name="renew"/> | C: <fee:command name="renew"/> | |||
| C: <fee:command name="transfer"/> | C: <fee:command name="transfer"/> | |||
| C: <fee:command name="restore"/> | C: <fee:command name="restore"/> | |||
| C: </fee:check> | C: </fee:check> | |||
| C: </extension> | C: </extension> | |||
| C: <clTRID>ABC-12345</clTRID> | C: <clTRID>ABC-12345</clTRID> | |||
| C: </command> | C: </command> | |||
| C: </epp>]]> | C: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | ||||
| <t>When the server receives a <check> command that includes the | <t>When the server receives a <check> command that includes the | |||
| extension elements described above, its response MUST contain an | extension elements described above, its response <bcp14>MUST</bcp14> c | |||
| <extension> element, which MUST contain a child | ontain an | |||
| <fee:chkData> element. The <fee:chkData> element MUST | <extension> element, which <bcp14>MUST</bcp14> contain a child | |||
| <fee:chkData> element. The <fee:chkData> element <bcp14>MU | ||||
| ST</bcp14> | ||||
| contain a <fee:currency> element and a <fee:cd> element | contain a <fee:currency> element and a <fee:cd> element | |||
| for each object referenced in the client <check> command.</t> | for each object referenced in the client <check> command.</t> | |||
| <t>Each <fee:cd> (check data) element <bcp14>MUST</bcp14> contai | ||||
| <t>Each <fee:cd> (check data) element MUST contain the following | n the following | |||
| child elements:</t> | child elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>A <fee:objID> element, which <bcp14>MUST</bcp14> match an | |||
| <t>A <fee:objID> element, which MUST match an element | element | |||
| referenced in the client <check> command.</t> | referenced in the client <check> command.</li> | |||
| <t>An OPTIONAL <fee:class> element (as described in Section 3. | <li>An <bcp14>OPTIONAL</bcp14> <fee:class> element (as | |||
| 7).</t> | described in <xref target="classification-objects"/>).</li> | |||
| <t>A <fee:command> element matching each <fee:command> | <li>A <fee:command> element matching each <fee:command> | |||
| (unless the "avail" attribute of the <fee:cd> if false) that | (unless the "avail" attribute of the <fee:cd> is false) that | |||
| appeared in the corresponding <fee:check> of the client | appeared in the corresponding <fee:check> of the client | |||
| command. This element MAY have the OPTIONAL "standard" attribute, | command. This element <bcp14>MAY</bcp14> have the <bcp14>OPTIONAL</b cp14> "standard" attribute, | |||
| with a default value of "0" (or "false"), which indicates whether | with a default value of "0" (or "false"), which indicates whether | |||
| the fee matches the fee of the "standard" classification (see | the fee is the standard or default fee (see | |||
| section 3.7). This element MAY have the OPTIONAL "phase" and | <xref target="classification-objects"/>). This element <bcp14>MAY</b | |||
| cp14> have the <bcp14>OPTIONAL</bcp14> "phase" and | ||||
| "subphase" attributes, which will match the same attributes in the | "subphase" attributes, which will match the same attributes in the | |||
| corresponding <fee:command> element of the client command if | corresponding <fee:command> element of the client command if | |||
| sent by the client.</t> | sent by the client.</li> | |||
| </list></t> | </ul> | |||
| <t>The <fee:cd> element also has an <bcp14>OPTIONAL</bcp14> "ava | ||||
| <t>The <fee:cd> element also has an OPTIONAL "avail" | il" | |||
| attribute which is a boolean. If the value of this attribute evaluates | attribute, which is a boolean. If the value of this attribute evaluate | |||
| s | ||||
| to false, this indicates that the server cannot calculate the relevant | to false, this indicates that the server cannot calculate the relevant | |||
| fees, because the object, command, currency, period, class or some | fees because the object, command, currency, period, class, or some | |||
| combination is invalid per server policy. If "avail" is false then the | combination is invalid per server policy. If "avail" is false, then th | |||
| <fee:cd> or the <fee:command> element MUST contain a | e | |||
| <fee:reason> element (as described in Section 3.9) and the | <fee:cd> or the <fee:command> element <bcp14>MUST</bcp14> | |||
| server MAY eliminate some or all of the <fee:command> element(s) | contain a | |||
| .</t> | <fee:reason> element (as described in <xref target="reason"/>), | |||
| and the | ||||
| <t>The <fee:command> element(s) MAY have the following child | server <bcp14>MAY</bcp14> eliminate some or all of the <fee:command | |||
| > element(s).</t> | ||||
| <t>The <fee:command> element(s) <bcp14>MAY</bcp14> have the foll | ||||
| owing child | ||||
| elements:</t> | elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>An <bcp14>OPTIONAL</bcp14> <fee:period> element (as descri | |||
| <t>An OPTIONAL <fee:period> element (as described in Section | bed in <xref target="validity-periods"/>), which contains the same unit, if pres | |||
| 3.3), which contains the same unit, if present, that appeared in the | ent, that appeared in the | |||
| <fee:period> element of the command. If the value of the paren t | <fee:period> element of the command. If the value of the paren t | |||
| <fee:command> element is "restore", this element MUST NOT be | <fee:command> element is "restore", this element <bcp14>MUST N | |||
| included, otherwise it MUST be included. If no <fee:period> | OT</bcp14> be | |||
| appeared in the client command (and the command is not "restore") | included; otherwise, it <bcp14>MUST</bcp14> be included. If no <f | |||
| then the server MUST return its default period value.</t> | ee:period> | |||
| <t>Zero or more <fee:fee> elements (as described in Section 3. | appeared in the client command (and the command is not "restore"), | |||
| 4).</t> | then the server <bcp14>MUST</bcp14> return its default period value. | |||
| <t>Zero or more <fee:credit> elements (as described in Section | </li> | |||
| 3.4).</t> | <li>Zero or more <fee:fee> elements (as described in <xref tar | |||
| <t>An OPTIONAL <fee:reason> element (as described in Section 3 | get="fees-credits"/>).</li> | |||
| .9).</t> | <li>Zero or more <fee:credit> elements (as described in | |||
| </list></t> | <xref target="fees-credits"/>).</li> | |||
| <li>An <bcp14>OPTIONAL</bcp14> <fee:reason> element (as descri | ||||
| bed in <xref target="reason"/>).</li> | ||||
| </ul> | ||||
| <t>If the "avail" attribute of the <fee:cd> element is true (1) and | <t>If the "avail" attribute of the <fee:cd> element is true (1) and | |||
| if no <fee:fee> elements are present in a <fee:command> | if no <fee:fee> elements are present in a <fee:command> | |||
| element, this indicates that no fee will be assessed by the server for | element, this indicates that no fee will be assessed by the server for | |||
| this command.</t> | this command.</t> | |||
| <t>If the "avail" attribute of the <fee:cd> element is true (1), | <t>If the "avail" attribute of the <fee:cd> element is true (1), | |||
| then the <fee:command> element MUST NOT contain a <fee:reason > | then the <fee:command> element <bcp14>MUST NOT</bcp14> contain a <fee:reason> | |||
| element.</t> | element.</t> | |||
| <t>Example <check> response:</t> | ||||
| <figure> | <sourcecode name="" type=""><![CDATA[ | |||
| <preamble>Example <check> response:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: </result> | S: </result> | |||
| S: <resData> | S: <resData> | |||
| S: <domain:chkData | S: <domain:chkData | |||
| S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| S: <domain:cd> | S: <domain:cd> | |||
| skipping to change at line 782 ¶ | skipping to change at line 661 ¶ | |||
| S: valid.</fee:reason> | S: valid.</fee:reason> | |||
| S: </fee:command> | S: </fee:command> | |||
| S: </fee:cd> | S: </fee:cd> | |||
| S: </fee:chkData> | S: </fee:chkData> | |||
| S: </extension> | S: </extension> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S: </epp>]]> | S: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | ||||
| </section> | </section> | |||
| <section anchor="epp-transfer-query" numbered="true" toc="default"> | ||||
| <section title="EPP Transfer Query Command"> | <name>EPP Transfer Query Command</name> | |||
| <t>This extension does not add any elements to the EPP <transfer> ; | <t>This extension does not add any elements to the EPP <transfer> ; | |||
| query command, but does include elements in the response, when the | query command, but it does include elements in the response when the | |||
| extension is included in the <login> command service extensions. </t> | extension is included in the <login> command service extensions. </t> | |||
| <t>When the <transfer> query command has been processed | <t>When the <transfer> query command has been processed | |||
| successfully, if the client has included the extension in the <logi n> | successfully, if the client has included the extension in the <logi n> | |||
| command service <svcExtension> element, and if the client is | command service <svcExtension> element, and if the client is | |||
| authorized by the server to view information about the transfer, then | authorized by the server to view information about the transfer, then | |||
| the server MAY include in the <extension> section of the EPP | the server <bcp14>MAY</bcp14> include in the <extension> section of the EPP | |||
| response a <fee:trnData> element, which contains the following | response a <fee:trnData> element, which contains the following | |||
| child elements:</t> | child elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>A <fee:currency> element (as described in <xref target="cu | |||
| <t>A <fee:currency> element (as described in Section 3.2).</t> | rrency-codes"/>).</li> | |||
| <t>A <fee:period> element (as described in Section 3.3).</t> | <li>A <fee:period> element (as described in <xref target="vali | |||
| <t>Zero or more <fee:fee> elements (as described in Section | dity-periods"/>).</li> | |||
| 3.4) containing the fees that will be charged to the gaining client. | <li>Zero or more <fee:fee> elements (as described in <xref ta | |||
| </t> | rget="fees-credits"/>) containing the fees that will be charged to the gaining c | |||
| <t>Zero or more <fee:credit> elements (as described in | lient.</li> | |||
| Section 3.4) containing the credits that will be refunded to the | <li>Zero or more <fee:credit> elements (as described in | |||
| losing client.</t> | <xref target="fees-credits"/>) containing the credits that will be r | |||
| </list></t> | efunded to the | |||
| losing client.</li> | ||||
| <t>Servers SHOULD omit <fee:credit> when returning a response to | </ul> | |||
| the gaining client, and omit <fee:fee> elements when returning a | <t>Servers <bcp14>SHOULD</bcp14> omit <fee:credit> when returnin | |||
| g a response to | ||||
| the gaining client and omit <fee:fee> elements when returning a | ||||
| response to the losing client.</t> | response to the losing client.</t> | |||
| <t>If no <fee:trnData> element is included in the response, then | <t>If no <fee:trnData> element is included in the response, then | |||
| no fee will be assessed by the server for the transfer.</t> | no fee will be assessed by the server for the transfer.</t> | |||
| <t>Example <transfer> query response:</t> | ||||
| <figure> | <sourcecode name="" type=""><![CDATA[ | |||
| <preamble>Example <transfer> query response:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1001"> | S: <result code="1001"> | |||
| S: <msg>Command completed successfully; action pending</msg> | S: <msg>Command completed successfully; action pending</msg> | |||
| S: </result> | S: </result> | |||
| S: <resData> | S: <resData> | |||
| S: <domain:trnData | S: <domain:trnData | |||
| S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| S: <domain:name>example.com</domain:name> | S: <domain:name>example.com</domain:name> | |||
| skipping to change at line 852 ¶ | skipping to change at line 721 ¶ | |||
| S: <fee:currency>USD</fee:currency> | S: <fee:currency>USD</fee:currency> | |||
| S: <fee:period unit="y">1</fee:period> | S: <fee:period unit="y">1</fee:period> | |||
| S: <fee:fee>5.00</fee:fee> | S: <fee:fee>5.00</fee:fee> | |||
| S: </fee:trnData> | S: </fee:trnData> | |||
| S: </extension> | S: </extension> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S: </epp>]]> | S: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | ||||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="epp-transform" numbered="true" toc="default"> | ||||
| <section title="EPP Transform Commands"> | <name>EPP Transform Commands</name> | |||
| <section anchor="epp-create" numbered="true" toc="default"> | ||||
| <section title="EPP <create> Command"> | <name>EPP <create> Command</name> | |||
| <t>This extension adds elements to both the EPP <create> command | <t>This extension adds elements to both the EPP <create> command | |||
| and response, when the extension is included in the <login> | and response when the extension is included in the <login> | |||
| command service extensions.</t> | command service extensions.</t> | |||
| <t>When submitting a <create> command to the server, the client | <t>When submitting a <create> command to the server, the client | |||
| MAY include in the <extension> element a <fee:create> | <bcp14>MAY</bcp14> include in the <extension> element a <fee: | |||
| element which includes the following child elements:</t> | create> | |||
| element, which includes the following child elements:</t> | ||||
| <t><list style="symbols"> | <ul spacing="normal"> | |||
| <t>An OPTIONAL <fee:currency> element (as described in Section | <li>An <bcp14>OPTIONAL</bcp14> <fee:currency> element (as desc | |||
| 3.2);</t> | ribed in | |||
| <t>One or more <fee:fee> elements (as described in Section 3.4 | <xref target="currency-codes"/>).</li> | |||
| ).</t> | <li>One or more <fee:fee> elements (as described in <xref targ | |||
| </list></t> | et="fees-credits"/>).</li> | |||
| </ul> | ||||
| <t>When the <create> command has been processed successfully, | <t>When the <create> command has been processed successfully, | |||
| and the client included the extension in the <login> command | the client included the extension in the <login> command | |||
| service extensions, and a fee was assessed by the server for the | service extensions, and a fee was assessed by the server for the | |||
| transaction, the server MUST include in the <extension> section | transaction, the server <bcp14>MUST</bcp14> include in the <extensi on> section | |||
| of the EPP response a <fee:creData> element, which contains the | of the EPP response a <fee:creData> element, which contains the | |||
| following child elements:</t> | following child elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>A <fee:currency> element (as described in <xref target="cu | |||
| <t>A <fee:currency> element (as described in Section 3.2);</t> | rrency-codes"/>).</li> | |||
| <t>Zero or more <fee:fee> elements (as described in Section 3. | <li>Zero or more <fee:fee> elements (as described in <xref tar | |||
| 4);</t> | get="fees-credits"/>).</li> | |||
| <t>Zero or more <fee:credit> elements (as described in Section | <li>Zero or more <fee:credit> elements (as described in <xref | |||
| 3.4);</t> | target="fees-credits"/>).</li> | |||
| <t>An OPTIONAL <fee:balance> element (as described in Section | <li>An <bcp14>OPTIONAL</bcp14> <fee:balance> element (as descr | |||
| 3.5);</t> | ibed in <xref | |||
| <t>An OPTIONAL <fee:creditLimit> element (as described in Sect | target="account-balance"/>).</li> | |||
| ion 3.6).</t> | <li>An <bcp14>OPTIONAL</bcp14> <fee:creditLimit> element (as d | |||
| </list></t> | escribed in <xref target="credit-limit"/>).</li> | |||
| </ul> | ||||
| <figure> | <t>Example <create> command:</t> | |||
| <preamble>Example <create> command:</preamble> | <sourcecode name="" type=""><![CDATA[ | |||
| <artwork><![CDATA[ | ||||
| C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| C: <command> | C: <command> | |||
| C: <create> | C: <create> | |||
| C: <domain:create | C: <domain:create | |||
| C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| C: <domain:name>example.com</domain:name> | C: <domain:name>example.com</domain:name> | |||
| C: <domain:period unit="y">2</domain:period> | C: <domain:period unit="y">2</domain:period> | |||
| C: <domain:ns> | C: <domain:ns> | |||
| C: <domain:hostObj>ns1.example.net</domain:hostObj> | C: <domain:hostObj>ns1.example.net</domain:hostObj> | |||
| skipping to change at line 923 ¶ | skipping to change at line 784 ¶ | |||
| C: </domain:create> | C: </domain:create> | |||
| C: </create> | C: </create> | |||
| C: <extension> | C: <extension> | |||
| C: <fee:create xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | C: <fee:create xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | |||
| C: <fee:currency>USD</fee:currency> | C: <fee:currency>USD</fee:currency> | |||
| C: <fee:fee>5.00</fee:fee> | C: <fee:fee>5.00</fee:fee> | |||
| C: </fee:create> | C: </fee:create> | |||
| C: </extension> | C: </extension> | |||
| C: <clTRID>ABC-12345</clTRID> | C: <clTRID>ABC-12345</clTRID> | |||
| C: </command> | C: </command> | |||
| C: </epp>]]> | C: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | <t>Example <create> response:</t> | |||
| <sourcecode name="" type=""><![CDATA[ | ||||
| <figure> | ||||
| <preamble>Example <create> response:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: </result> | S: </result> | |||
| S: <resData> | S: <resData> | |||
| S: <domain:creData | S: <domain:creData | |||
| S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| S: <domain:name>example.com</domain:name> | S: <domain:name>example.com</domain:name> | |||
| skipping to change at line 962 ¶ | skipping to change at line 819 ¶ | |||
| S: grace-period="P5D">5.00</fee:fee> | S: grace-period="P5D">5.00</fee:fee> | |||
| S: <fee:balance>-5.00</fee:balance> | S: <fee:balance>-5.00</fee:balance> | |||
| S: <fee:creditLimit>1000.00</fee:creditLimit> | S: <fee:creditLimit>1000.00</fee:creditLimit> | |||
| S: </fee:creData> | S: </fee:creData> | |||
| S: </extension> | S: </extension> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54321-XYZ</svTRID> | S: <svTRID>54321-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S: </epp>]]> | S: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | ||||
| </section> | </section> | |||
| <section anchor="epp-delete" numbered="true" toc="default"> | ||||
| <section title="EPP <delete> Command"> | <name>EPP <delete> Command</name> | |||
| <t>This extension does not add any elements to the EPP <delete> | <t>This extension does not add any elements to the EPP <delete> | |||
| command, but does include elements in the response, when the extension | command, but it does include elements in the response when the extensi on | |||
| is included in the <login> command service extensions.</t> | is included in the <login> command service extensions.</t> | |||
| <t>When the <delete> command has been processed successfully | ||||
| <t>When the <delete> command has been processed successfully, | ||||
| and the client included the extension in the <login> command | and the client included the extension in the <login> command | |||
| service extensions, the server MAY include in the <extension> | service extensions, the server <bcp14>MAY</bcp14> include in the <e xtension> | |||
| section of the EPP response a <fee:delData> element, which | section of the EPP response a <fee:delData> element, which | |||
| contains the following child elements:</t> | contains the following child elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>A <fee:currency> element (as described in <xref target="cu | |||
| <t>A <fee:currency> element (as described in Section 3.2);</t> | rrency-codes"/>).</li> | |||
| <t>Zero or more <fee:fee> elements (as described in Section 3. | <li>Zero or more <fee:fee> elements (as described in <xref tar | |||
| 4);</t> | get="fees-credits"/>).</li> | |||
| <t>Zero or more <fee:credit> elements (as described in Section | <li>Zero or more <fee:credit> elements (as described in <xref | |||
| 3.4);</t> | target="fees-credits"/>).</li> | |||
| <t>An OPTIONAL <fee:balance> element (as described in Section | <li>An <bcp14>OPTIONAL</bcp14> <fee:balance> element (as descr | |||
| 3.5);</t> | ibed in <xref | |||
| <t>An OPTIONAL <fee:creditLimit> element (as described in Sect | target="account-balance"/>).</li> | |||
| ion 3.6).</t> | <li>An <bcp14>OPTIONAL</bcp14> <fee:creditLimit> element (as d | |||
| </list></t> | escribed in <xref target="credit-limit"/>).</li> | |||
| </ul> | ||||
| <figure> | <t>Example <delete> response:</t> | |||
| <preamble>Example <delete> response:</preamble> | <sourcecode name="" type=""><![CDATA[ | |||
| <artwork><![CDATA[ | ||||
| S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: </result> | S: </result> | |||
| S: <extension> | S: <extension> | |||
| S: <fee:delData | S: <fee:delData | |||
| S: xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | S: xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | |||
| S: <fee:currency>USD</fee:currency> | S: <fee:currency>USD</fee:currency> | |||
| skipping to change at line 1012 ¶ | skipping to change at line 863 ¶ | |||
| S: description="AGP Credit" | S: description="AGP Credit" | |||
| S: lang="en">-5.00</fee:credit> | S: lang="en">-5.00</fee:credit> | |||
| S: <fee:balance>1005.00</fee:balance> | S: <fee:balance>1005.00</fee:balance> | |||
| S: </fee:delData> | S: </fee:delData> | |||
| S: </extension> | S: </extension> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54321-XYZ</svTRID> | S: <svTRID>54321-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S: </epp>]]> | S: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | ||||
| </section> | </section> | |||
| <section anchor="epp-renew" numbered="true" toc="default"> | ||||
| <section title="EPP <renew> Command"> | <name>EPP <renew> Command</name> | |||
| <t>This extension adds elements to both the EPP <renew> command | <t>This extension adds elements to both the EPP <renew> command | |||
| and response, when the extension is included in the <login> | and response when the extension is included in the <login> | |||
| command service extensions.</t> | command service extensions.</t> | |||
| <t>When submitting a <renew> command to the server, the client | <t>When submitting a <renew> command to the server, the client | |||
| MAY include in the <extension> element a <fee:renew> | <bcp14>MAY</bcp14> include in the <extension> element a <fee: | |||
| element which includes the following child elements:</t> | renew> | |||
| element, which includes the following child elements:</t> | ||||
| <t><list style="symbols"> | <ul spacing="normal"> | |||
| <t>An OPTIONAL <fee:currency> element (as described in Section | <li>An <bcp14>OPTIONAL</bcp14> <fee:currency> element (as desc | |||
| 3.2);</t> | ribed in <xref target="currency-codes"/>).</li> | |||
| <t>One or more <fee:fee> elements (as described in Section 3.4 | <li>One or more <fee:fee> elements (as described in <xref targ | |||
| ).</t> | et="fees-credits"/>).</li> | |||
| </list></t> | </ul> | |||
| <t>When the <renew> command has been processed successfully and | ||||
| <t>When the <renew> command has been processed successfully, and | ||||
| the client included the extension in the <login> command service | the client included the extension in the <login> command service | |||
| extensions, the server MAY include in the <extension> section of | extensions, the server <bcp14>MAY</bcp14> include in the <extension > section of | |||
| the EPP response a <fee:renData> element, which contains the | the EPP response a <fee:renData> element, which contains the | |||
| following child elements:</t> | following child elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>A <fee:currency> element (as described in <xref target="cu | |||
| <t>A <fee:currency> element (as described in Section 3.2);</t> | rrency-codes"/>).</li> | |||
| <t>Zero or more <fee:fee> elements (as described in Section 3. | <li>Zero or more <fee:fee> elements (as described in <xref tar | |||
| 4);</t> | get="fees-credits"/>).</li> | |||
| <t>Zero or more <fee:credit> elements (as described in Section | <li>Zero or more <fee:credit> elements (as described in <xref | |||
| 3.4);</t> | target="fees-credits"/>).</li> | |||
| <t>An OPTIONAL <fee:balance> element (as described in Section | <li>An <bcp14>OPTIONAL</bcp14> <fee:balance> element (as descr | |||
| 3.5);</t> | ibed in <xref target="account-balance"/>).</li> | |||
| <t>An OPTIONAL <fee:creditLimit> element (as described in Sect | <li>An <bcp14>OPTIONAL</bcp14> <fee:creditLimit> element (as d | |||
| ion 3.6).</t> | escribed in <xref target="credit-limit"/>).</li> | |||
| </list></t> | </ul> | |||
| <t>Example <renew> command:</t> | ||||
| <figure> | <sourcecode name="" type=""><![CDATA[ | |||
| <preamble>Example <renew> command:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| C: <command> | C: <command> | |||
| C: <renew> | C: <renew> | |||
| C: <domain:renew | C: <domain:renew | |||
| C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| C: <domain:name>example.com</domain:name> | C: <domain:name>example.com</domain:name> | |||
| C: <domain:curExpDate>2019-04-03</domain:curExpDate> | C: <domain:curExpDate>2019-04-03</domain:curExpDate> | |||
| C: <domain:period unit="y">5</domain:period> | C: <domain:period unit="y">5</domain:period> | |||
| C: </domain:renew> | C: </domain:renew> | |||
| C: </renew> | C: </renew> | |||
| C: <extension> | C: <extension> | |||
| C: <fee:renew xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | C: <fee:renew xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | |||
| C: <fee:currency>USD</fee:currency> | C: <fee:currency>USD</fee:currency> | |||
| C: <fee:fee>5.00</fee:fee> | C: <fee:fee>5.00</fee:fee> | |||
| C: </fee:renew> | C: </fee:renew> | |||
| C: </extension> | C: </extension> | |||
| C: <clTRID>ABC-12345</clTRID> | C: <clTRID>ABC-12345</clTRID> | |||
| C: </command> | C: </command> | |||
| C: </epp>]]> | C: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | <t>Example <renew> response:</t> | |||
| <sourcecode name="" type=""><![CDATA[ | ||||
| <figure> | ||||
| <preamble>Example <renew> response:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: </result> | S: </result> | |||
| S: <resData> | S: <resData> | |||
| S: <domain:renData | S: <domain:renData | |||
| S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| S: <domain:name>example.com</domain:name> | S: <domain:name>example.com</domain:name> | |||
| skipping to change at line 1104 ¶ | skipping to change at line 942 ¶ | |||
| S: refundable="1" | S: refundable="1" | |||
| S: grace-period="P5D">5.00</fee:fee> | S: grace-period="P5D">5.00</fee:fee> | |||
| S: <fee:balance>1000.00</fee:balance> | S: <fee:balance>1000.00</fee:balance> | |||
| S: </fee:renData> | S: </fee:renData> | |||
| S: </extension> | S: </extension> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S: </epp>]]> | S: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | ||||
| </section> | </section> | |||
| <section anchor="epp-transfer-command" numbered="true" toc="default"> | ||||
| <section title="EPP <transfer> Command"> | <name>EPP <transfer> Command</name> | |||
| <t>This extension adds elements to both the EPP <transfer> | <t>This extension adds elements to both the EPP <transfer> | |||
| command and response, when the value of the "op" attribute of the | command and response when the value of the "op" attribute of the | |||
| <transfer> command element is "request", and the extension is | <transfer> command element is "request" and the extension is | |||
| included in the <login> command service extensions.</t> | included in the <login> command service extensions.</t> | |||
| <t>When submitting a <transfer> command to the server, the | <t>When submitting a <transfer> command to the server, the | |||
| client MAY include in the <extension> element a | client <bcp14>MAY</bcp14> include in the <extension> element a | |||
| <fee:transfer> element which includes the following child | <fee:transfer> element, which includes the following child | |||
| elements:</t> | elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>An <bcp14>OPTIONAL</bcp14> <fee:currency> element (as desc | |||
| <t>An OPTIONAL <fee:currency> element (as described in Section | ribed in <xref target="currency-codes"/>).</li> | |||
| 3.2);</t> | <li>One or more <fee:fee> elements (as described in <xref targ | |||
| <t>One or more <fee:fee> elements (as described in Section 3.4 | et="fees-credits"/>).</li> | |||
| ).</t> | </ul> | |||
| </list></t> | <t>When the <transfer> command has been processed successfully | |||
| <t>When the <transfer> command has been processed successfully, | ||||
| and the client included the extension in the <login> command | and the client included the extension in the <login> command | |||
| service extensions, the server MAY include in the <extension> | service extensions, the server <bcp14>MAY</bcp14> include in the <e xtension> | |||
| section of the EPP response a <fee:trnData> element, which | section of the EPP response a <fee:trnData> element, which | |||
| contains the following child elements:</t> | contains the following child elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>A <fee:currency> element (as described in <xref target="cu | |||
| <t>A <fee:currency> element (as described in Section 3.2);</t> | rrency-codes"/>).</li> | |||
| <t>Zero or more <fee:fee> elements (as described in Section 3. | <li>Zero or more <fee:fee> elements (as described in <xref tar | |||
| 4);</t> | get="fees-credits"/>).</li> | |||
| <t>Zero or more <fee:credit> elements (as described in Section | <li>Zero or more <fee:credit> elements (as described in <xref | |||
| 3.4);</t> | target="fees-credits"/>).</li> | |||
| <t>An OPTIONAL <fee:balance> element (as described in Section | <li>An <bcp14>OPTIONAL</bcp14> <fee:balance> element (as descr | |||
| 3.5);</t> | ibed in <xref target="account-balance"/>).</li> | |||
| <t>An OPTIONAL <fee:creditLimit> element (as described in Sect | <li>An <bcp14>OPTIONAL</bcp14> <fee:creditLimit> element (as d | |||
| ion 3.6).</t> | escribed in <xref target="credit-limit"/>).</li> | |||
| </list></t> | </ul> | |||
| <t>Example <transfer> command:</t> | ||||
| <figure> | <sourcecode name="" type=""><![CDATA[ | |||
| <preamble>Example <transfer> command:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| C: <command> | C: <command> | |||
| C: <transfer op="request"> | C: <transfer op="request"> | |||
| C: <domain:transfer | C: <domain:transfer | |||
| C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| C: <domain:name>example.com</domain:name> | C: <domain:name>example.com</domain:name> | |||
| C: <domain:period unit="y">1</domain:period> | C: <domain:period unit="y">1</domain:period> | |||
| C: <domain:authInfo> | C: <domain:authInfo> | |||
| C: <domain:pw roid="JD1234-REP">2fooBAR</domain:pw> | C: <domain:pw roid="JD1234-REP">2fooBAR</domain:pw> | |||
| C: </domain:authInfo> | C: </domain:authInfo> | |||
| C: </domain:transfer> | C: </domain:transfer> | |||
| C: </transfer> | C: </transfer> | |||
| C: <extension> | C: <extension> | |||
| C: <fee:transfer xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | C: <fee:transfer xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | |||
| C: <fee:currency>USD</fee:currency> | C: <fee:currency>USD</fee:currency> | |||
| C: <fee:fee>5.00</fee:fee> | C: <fee:fee>5.00</fee:fee> | |||
| C: </fee:transfer> | C: </fee:transfer> | |||
| C: </extension> | C: </extension> | |||
| C: <clTRID>ABC-12345</clTRID> | C: <clTRID>ABC-12345</clTRID> | |||
| C: </command> | C: </command> | |||
| C: </epp>]]> | C: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | <t>Example <transfer> response:</t> | |||
| <sourcecode name="" type=""><![CDATA[ | ||||
| <figure> | ||||
| <preamble>Example <transfer> response:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1001"> | S: <result code="1001"> | |||
| S: <msg>Command completed successfully; action pending</msg> | S: <msg>Command completed successfully; action pending</msg> | |||
| S: </result> | S: </result> | |||
| S: <resData> | S: <resData> | |||
| S: <domain:trnData | S: <domain:trnData | |||
| S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| S: <domain:name>example.com</domain:name> | S: <domain:name>example.com</domain:name> | |||
| skipping to change at line 1204 ¶ | skipping to change at line 1029 ¶ | |||
| S: <fee:fee | S: <fee:fee | |||
| S: refundable="1" | S: refundable="1" | |||
| S: grace-period="P5D">5.00</fee:fee> | S: grace-period="P5D">5.00</fee:fee> | |||
| S: </fee:trnData> | S: </fee:trnData> | |||
| S: </extension> | S: </extension> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S: </epp>]]> | S: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | ||||
| </section> | </section> | |||
| <section anchor="epp-update" numbered="true" toc="default"> | ||||
| <section title="EPP <update> Command"> | <name>EPP <update> Command</name> | |||
| <t>This extension adds elements to both the EPP <update> | <t>This extension adds elements to both the EPP <update> | |||
| command and response, when the extension is included in the <login& gt; | command and response when the extension is included in the <login&g t; | |||
| command service extensions.</t> | command service extensions.</t> | |||
| <t>When submitting an <update> command to the server, the | ||||
| <t>When submitting a <update> command to the server, the | client <bcp14>MAY</bcp14> include in the <extension> element a | |||
| client MAY include in the <extension> element a | <fee:update> element, which includes the following child | |||
| <fee:update> element which includes the following child | ||||
| elements:</t> | elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>An <bcp14>OPTIONAL</bcp14> <fee:currency> element (as desc | |||
| <t>An OPTIONAL <fee:currency> element (as described in Section | ribed in <xref target="currency-codes"/>).</li> | |||
| 3.2);</t> | <li>One or more <fee:fee> elements (as described in <xref targ | |||
| <t>One or more <fee:fee> elements (as described in Section 3.4 | et="fees-credits"/>).</li> | |||
| ).</t> | </ul> | |||
| </list></t> | <t>When the <update> command has been processed successfully | |||
| <t>When the <update> command has been processed successfully, | ||||
| and the client included the extension in the <login> command | and the client included the extension in the <login> command | |||
| service extensions, the server MAY include in the <extension> | service extensions, the server <bcp14>MAY</bcp14> include in the <e xtension> | |||
| section of the EPP response a <fee:updData> element, which | section of the EPP response a <fee:updData> element, which | |||
| contains the following child elements:</t> | contains the following child elements:</t> | |||
| <ul spacing="normal"> | ||||
| <t><list style="symbols"> | <li>A <fee:currency> element (as described in <xref target="cu | |||
| <t>A <fee:currency> element (as described in Section 3.2);</t> | rrency-codes"/>).</li> | |||
| <t>Zero or more <fee:fee> elements (as described in Section 3. | <li>Zero or more <fee:fee> elements (as described in <xref tar | |||
| 4);</t> | get="fees-credits"/>).</li> | |||
| <t>Zero or more <fee:credit> elements (as described in Section | <li>Zero or more <fee:credit> elements (as described in <xref | |||
| 3.4);</t> | target="fees-credits"/>).</li> | |||
| <t>An OPTIONAL <fee:balance> element (as described in Section | <li>An <bcp14>OPTIONAL</bcp14> <fee:balance> element (as descr | |||
| 3.5);</t> | ibed in <xref target="account-balance"/>).</li> | |||
| <t>An OPTIONAL <fee:creditLimit> element (as described in Sect | <li>An <bcp14>OPTIONAL</bcp14> <fee:creditLimit> element (as d | |||
| ion 3.6).</t> | escribed in <xref target="credit-limit"/>).</li> | |||
| </list></t> | </ul> | |||
| <t>Example <update> command:</t> | ||||
| <figure> | <sourcecode name="" type=""><![CDATA[ | |||
| <preamble>Example <update> command:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | C: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | C: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| C: <command> | C: <command> | |||
| C: <update> | C: <update> | |||
| C: <domain:update | C: <domain:update | |||
| C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | C: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| C: <domain:name>example.com</domain:name> | C: <domain:name>example.com</domain:name> | |||
| C: <domain:chg> | C: <domain:chg> | |||
| C: <domain:registrant>sh8013</domain:registrant> | C: <domain:registrant>sh8013</domain:registrant> | |||
| C: </domain:chg> | C: </domain:chg> | |||
| C: </domain:update> | C: </domain:update> | |||
| C: </update> | C: </update> | |||
| C: <extension> | C: <extension> | |||
| C: <fee:update xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | C: <fee:update xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | |||
| C: <fee:currency>USD</fee:currency> | C: <fee:currency>USD</fee:currency> | |||
| C: <fee:fee>5.00</fee:fee> | C: <fee:fee>5.00</fee:fee> | |||
| C: </fee:update> | C: </fee:update> | |||
| C: </extension> | C: </extension> | |||
| C: <clTRID>ABC-12345</clTRID> | C: <clTRID>ABC-12345</clTRID> | |||
| C: </command> | C: </command> | |||
| C: </epp>]]> | C: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | <t>Example <update> response:</t> | |||
| <sourcecode name="" type=""><![CDATA[ | ||||
| <figure> | ||||
| <preamble>Example <update> response:</preamble> | ||||
| <artwork><![CDATA[ | ||||
| S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | S: <?xml version="1.0" encoding="utf-8" standalone="no"?> | |||
| S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S: <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: </result> | S: </result> | |||
| S: <extension> | S: <extension> | |||
| S: <fee:updData xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | S: <fee:updData xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0"> | |||
| S: <fee:currency>USD</fee:currency> | S: <fee:currency>USD</fee:currency> | |||
| S: <fee:fee>5.00</fee:fee> | S: <fee:fee>5.00</fee:fee> | |||
| S: </fee:updData> | S: </fee:updData> | |||
| S: </extension> | S: </extension> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54321-XYZ</svTRID> | S: <svTRID>54321-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S: </epp>]]> | S: </epp> | |||
| </artwork> | ]]></sourcecode> | |||
| </figure> | ||||
| </section> | </section> | |||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="syntax" numbered="true" toc="default"> | ||||
| <section anchor="syntax" title="Formal Syntax"> | <name>Formal Syntax</name> | |||
| <t>One schema is presented here -- the EPP Fee Extension schema.</t> | ||||
| <t>One schema is presented here that is the EPP Fee Extension schema.</t> | ||||
| <t>The formal syntax presented here is a complete schema representation of | <t>The formal syntax presented here is a complete schema representation of | |||
| the object mapping suitable for automated validation of EPP XML instances. | the object mapping suitable for automated validation of EPP XML instances. | |||
| The BEGIN and END tags are not part of the schema; they are used to note t | </t> | |||
| he | <section anchor="fee-extension" numbered="true" toc="default"> | |||
| beginning and ending of the schema for URI registration purposes.</t> | <name>Fee Extension Schema</name> | |||
| <t>The formal syntax presented here is a complete schema | ||||
| <section title="Fee Extension Schema"> | representation <xref target="W3C.REC-xmlschema-1-20041028"/> | |||
| <t>The formal syntax presented here is a complete schema representation | ||||
| of the object mapping suitable for automated validation of EPP XML | of the object mapping suitable for automated validation of EPP XML | |||
| instances. The BEGIN and END tags are not part of the schema; they are | instances. The <CODE BEGINS> and <CODE ENDS> tags are not p | |||
| used to note the beginning and ending of the schema for URI registration | art of the schema; they are | |||
| used to note the beginning and end of the schema for URI registration | ||||
| purposes.</t> | purposes.</t> | |||
| <sourcecode type="xml" markers="true"><![CDATA[ | ||||
| <figure> | ||||
| <artwork><![CDATA[ | ||||
| BEGIN | ||||
| <?xml version="1.0" encoding="utf-8"?> | <?xml version="1.0" encoding="utf-8"?> | |||
| <schema xmlns="http://www.w3.org/2001/XMLSchema" | <schema xmlns="http://www.w3.org/2001/XMLSchema" | |||
| xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0" | xmlns:fee="urn:ietf:params:xml:ns:epp:fee-1.0" | |||
| xmlns:eppcom="urn:ietf:params:xml:ns:eppcom-1.0" | xmlns:eppcom="urn:ietf:params:xml:ns:eppcom-1.0" | |||
| xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" | xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" | |||
| targetNamespace="urn:ietf:params:xml:ns:epp:fee-1.0" | targetNamespace="urn:ietf:params:xml:ns:epp:fee-1.0" | |||
| elementFormDefault="qualified"> | elementFormDefault="qualified"> | |||
| <import namespace="urn:ietf:params:xml:ns:eppcom-1.0" /> | <import namespace="urn:ietf:params:xml:ns:eppcom-1.0" /> | |||
| <import namespace="urn:ietf:params:xml:ns:domain-1.0" /> | <import namespace="urn:ietf:params:xml:ns:domain-1.0" /> | |||
| skipping to change at line 1387 ¶ | skipping to change at line 1188 ¶ | |||
| <sequence> | <sequence> | |||
| <element name="objID" type="fee:objectIdentifierType" /> | <element name="objID" type="fee:objectIdentifierType" /> | |||
| <element name="class" type="token" minOccurs="0" /> | <element name="class" type="token" minOccurs="0" /> | |||
| <element name="command" type="fee:commandDataType" | <element name="command" type="fee:commandDataType" | |||
| minOccurs="0" maxOccurs="unbounded" /> | minOccurs="0" maxOccurs="unbounded" /> | |||
| <element name="reason" type="fee:reasonType" minOccurs="0" /> | <element name="reason" type="fee:reasonType" minOccurs="0" /> | |||
| </sequence> | </sequence> | |||
| <attribute name="avail" type="boolean" default="1" /> | <attribute name="avail" type="boolean" default="1" /> | |||
| </complexType> | </complexType> | |||
| <!-- general transform (create, renew, update, transfer) command --> | <!-- general transform (create, renew, update, transfer) command--> | |||
| <complexType name="transformCommandType"> | <complexType name="transformCommandType"> | |||
| <sequence> | <sequence> | |||
| <element name="currency" type="fee:currencyType" | <element name="currency" type="fee:currencyType" | |||
| minOccurs="0" /> | minOccurs="0" /> | |||
| <element name="fee" type="fee:feeType" | <element name="fee" type="fee:feeType" | |||
| maxOccurs="unbounded" /> | maxOccurs="unbounded" /> | |||
| <element name="credit" type="fee:creditType" | <element name="credit" type="fee:creditType" | |||
| minOccurs="0" maxOccurs="unbounded" /> | minOccurs="0" maxOccurs="unbounded" /> | |||
| </sequence> | </sequence> | |||
| </complexType> | </complexType> | |||
| skipping to change at line 1520 ¶ | skipping to change at line 1321 ¶ | |||
| <simpleType name="balanceType"> | <simpleType name="balanceType"> | |||
| <restriction base="decimal" /> | <restriction base="decimal" /> | |||
| </simpleType> | </simpleType> | |||
| <simpleType name="creditLimitType"> | <simpleType name="creditLimitType"> | |||
| <restriction base="decimal" /> | <restriction base="decimal" /> | |||
| </simpleType> | </simpleType> | |||
| </schema> | </schema> | |||
| END]]> | ]]></sourcecode> | |||
| </artwork> | ||||
| </figure> | ||||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="Security" numbered="true" toc="default"> | ||||
| <section anchor="Security" title="Security Considerations"> | <name>Security Considerations</name> | |||
| <t>The mapping extensions described in this document do not provide any | <t>The mapping extensions described in this document do not provide any | |||
| security services beyond those described by EPP [RFC5730], the EPP domain | security services beyond those described by the EPP <xref target="RFC5730" | |||
| name mapping [RFC5731], and protocol layers used by EPP. The security | format="default"/>, the EPP domain | |||
| name mapping <xref target="RFC5731" format="default"/>, and the protocol | ||||
| layers used by the EPP. The security | ||||
| considerations described in these other specifications apply to this | considerations described in these other specifications apply to this | |||
| specification as well. This extension passes financial information using | specification as well. This extension passes financial information using | |||
| the EPP protocol, so confidentiality and integrity protection must be | the EPP protocol, so confidentiality and integrity protection must be | |||
| provided by the transport mechanism. All transports compliant with | provided by the transport mechanism. All transports compliant with | |||
| [RFC5730] provide the needed level of confidentiality and integrity | <xref target="RFC5730" format="default"/> provide the needed level of conf identiality and integrity | |||
| protections. The server will only provide information, including | protections. The server will only provide information, including | |||
| financial information, that is relevant to the authenticated client.</t> | financial information, that is relevant to the authenticated client.</t> | |||
| </section> | </section> | |||
| <section anchor="IANA" numbered="true" toc="default"> | ||||
| <section anchor="IANA" title="IANA Considerations"> | <name>IANA Considerations</name> | |||
| <section anchor="xml-namespace" numbered="true" toc="default"> | ||||
| <section title="XML Namespace"> | <name>XML Namespace</name> | |||
| <t>This document uses URNs to describe XML namespaces and XML schemas | <t>This document uses URNs to describe XML namespaces and XML schemas | |||
| conforming to a registry mechanism described in <xref target="RFC3688"/> | conforming to a registry mechanism described in <xref target="RFC3688" f | |||
| .</t> | ormat="default"/>.</t> | |||
| <t>Registration request for the fee namespace:</t> | <t>Registration request for the fee namespace:</t> | |||
| <t>URI: urn:ietf:params:xml:ns:epp:fee-1.0</t> | <t>URI: urn:ietf:params:xml:ns:epp:fee-1.0</t> | |||
| <t>Registrant Contact: IESG</t> | <t>Registrant Contact: IESG</t> | |||
| <t>XML: None. Namespace URIs do not represent an XML specification.</t> | <t>XML: None. Namespace URIs do not represent an XML specification.</t> | |||
| <t>Registration request for the fee schema:</t> | ||||
| <t>Registration request for the fee schema:</t> | <t>URI: urn:ietf:params:xml:schema:epp:fee-1.0</t> | |||
| <t>Registrant Contact: IESG</t> | ||||
| <t>URI: urn:ietf:params:xml:schema:epp:fee-1.0</t> | <t>XML: See <xref target="syntax"/> of this document.</t> | |||
| </section> | ||||
| <t>Registrant Contact: IESG</t> | <section anchor="epp-extension-reg" numbered="true" toc="default"> | |||
| <name>EPP Extension Registry</name> | ||||
| <t>XML: See the "Formal Syntax" section of this document.</t> | <t>The EPP extension described in this document has been registered by | |||
| IANA in the "Extensions for the Extensible Provisioning Protocol (EPP)" | ||||
| </section> | registry described in <xref target="RFC7451" format="default"/>. The | |||
| <section title="EPP Extension Registry"> | ||||
| <t>The EPP extension described in this document should be registered by | ||||
| the IANA in the EPP Extension Registry described in [RFC7451]. The | ||||
| details of the registration are as follows:</t> | details of the registration are as follows:</t> | |||
| <t>Name of Extension: Registry Fee Extension for the Extensible | <t>Name of Extension: Registry Fee Extension for the Extensible | |||
| Provisioning Protocol (EPP)</t> | Provisioning Protocol (EPP)</t> | |||
| <t>Document status: Standards Track</t> | <t>Document status: Standards Track</t> | |||
| <t>Reference: RFC 8748</t> | ||||
| <t>Reference: (insert reference to RFC version of this document)</t> | <t>Registrant Name and Email Address: IESG <iesg@ietf.org></t> | |||
| <t>Registrant Name and Email Address: IESG, <iesg@ietf.org></t> | ||||
| <t>TLDs: Any</t> | <t>TLDs: Any</t> | |||
| <t>IPR Disclosure: None</t> | <t>IPR Disclosure: None</t> | |||
| <t>Status: Active</t> | <t>Status: Active</t> | |||
| <t>Notes: None</t> | <t>Notes: None</t> | |||
| </section> | </section> | |||
| </section> | </section> | |||
| <section title="Implementation Status"> | ||||
| <t>Note to RFC Editor: Please remove this section and the reference to | ||||
| [RFC7942] before publication.</t> | ||||
| <t>This section records the status of known implementations of the | ||||
| protocol defined by this specification at the time of posting of this | ||||
| Internet-Draft, and is based on a proposal described in [RFC7942]. The | ||||
| description of implementations in this section is intended to assist the | ||||
| IETF in its decision processes in progressing drafts to RFCs. Please note | ||||
| that the listing of any individual implementation here does not imply | ||||
| endorsement by the IETF. Furthermore, no effort has been spent to verify | ||||
| the information presented here that was supplied by IETF contributors. | ||||
| This is not intended as, and must not be construed to be, a catalog of | ||||
| available implementations or their features. Readers are advised to note | ||||
| that other implementations may exist.</t> | ||||
| <t>According to [RFC7942], "this will allow reviewers and working groups | ||||
| to assign due consideration to documents that have the benefit of running | ||||
| code, which may serve as evidence of valuable experimentation and feedback | ||||
| that have made the implemented protocols more mature. It is up to the | ||||
| individual working groups to use this information as they see fit".</t> | ||||
| <section title="RegistryEngine EPP Service"> | ||||
| <t>Organization: CentralNic</t> | ||||
| <t>Name: RegistryEngine EPP Service</t> | ||||
| <t>Description: Generic high-volume EPP service for gTLDs, ccTLDs and | ||||
| SLDs</t> | ||||
| <t>Level of maturity: Deployed in CentralNic's production environment as | ||||
| well as two other gTLD registry systems, and two ccTLD registry systems. | ||||
| </t> | ||||
| <t>Coverage: All aspects of the protocol are implemented.</t> | ||||
| <t>Licensing: Proprietary In-House software</t> | ||||
| <t>Contact: epp@centralnic.com</t> | ||||
| <t>URL: https://www.centralnic.com</t> | ||||
| </section> | ||||
| </section> | ||||
| <section title="Acknowledgements"> | ||||
| <t>The authors wish to thank the following persons for their feedback and | ||||
| suggestions:</t> | ||||
| <t><list style="symbols"> | ||||
| <t>James Gould of Verisign Inc</t> | ||||
| <t>Luis Munoz of ISC</t> | ||||
| <t>Michael Young of Architelos</t> | ||||
| <t>Ben Levac and Jeff Eckhaus of Demand Media</t> | ||||
| <t>Seth Goldman of Google</t> | ||||
| <t>Klaus Malorny and Michael Bauland of Knipp</t> | ||||
| <t>Jody Kolker, Joe Snitker and Kevin Allendorf of Go Daddy</t> | ||||
| <t>Michael Holloway of Com Laude</t> | ||||
| <t>Santosh Kalsangrah of Impetus Infotech</t> | ||||
| <t>Alex Mayrhofer of Nic.at</t> | ||||
| <t>Thomas Corte of Knipp Medien und Kommunikation GmbH</t> | ||||
| </list></t> | ||||
| </section> | ||||
| <section title="Change History"> | ||||
| <section title="Change from 18 to 19"> | ||||
| <t>Added normative reference for XML Schema.</t> | ||||
| </section> | ||||
| <section title="Change from 18 to 19"> | ||||
| <t>Updated per IESG review, all updates (except for one schema change) | ||||
| were just textual for clarity and correctness. The schema change was to | ||||
| require the name attribute of the commandType element.</t> | ||||
| </section> | ||||
| <section title="Change from 17 to 18"> | ||||
| <t>Corrected erroneous edit left in place in previous revision (17), | ||||
| reverted text back to original text (revision 16) in section 3.4.</t> | ||||
| </section> | ||||
| <section title="Change from 16 to 17"> | ||||
| <t>Updated per AD review, all updates were just textual for clarity and | ||||
| correctness.</t> | ||||
| </section> | ||||
| <section title="Change from 15 to 16"> | ||||
| <t>Updated per AD review and list comments: several grammar corrections; | ||||
| clarification text added to section 3.4.3 and 3.5; and a schema | ||||
| update for consistency by providing a "lang" attribute to the | ||||
| <fee:fee> and <fee:credit> "description" attribute | ||||
| detailed in section 3.4.</t> | ||||
| </section> | ||||
| <section title="Change from 14 to 15"> | ||||
| <t>Updated schema, moving the "standard" attribute of the "commandDataTy | ||||
| pe" inside the <extension> block.</t> | ||||
| </section> | ||||
| <section title="Change from 13 to 14"> | ||||
| <t>Moved RFC 7451 reference from Normative to Informative section.</t> | ||||
| </section> | ||||
| <section title="Change from 12 to 13"> | ||||
| <t>Updated XML namespace and schema registration to be "epp" scoped - | ||||
| global replace of XML namespace from urn:ietf:params:xml:ns:fee-1.0 | ||||
| to urn:ietf:params:xml:ns:epp:fee-1.0 and the XML schema | ||||
| registration from urn:ietf:params:xml:schema:fee-1.0 to | ||||
| urn:ietf:params:xml:schema:epp:fee-1.0.</t> | ||||
| </section> | ||||
| <section title="Change from 11 to 12"> | ||||
| <t>Updated references to current version of documents and moved the | ||||
| "standard" attribute from the check command (commandType) to the | ||||
| check response (commandDataType).</t> | ||||
| </section> | ||||
| <section title="Change from 10 to 11"> | ||||
| <t>Updated document per Working Group Last Call comments. Made minor | ||||
| textual changes throughout for enhanced clarity per WGLC comments.</t> | ||||
| </section> | ||||
| <section title="Change from 09 to 10"> | ||||
| <t>Updated document per Working Group Last Call comments. Updated schema | ||||
| to version 1.0 in anticipation of standardization, no changes were made | ||||
| to the latest, 0.25, schema. Made minor textual changes throughout for | ||||
| enhanced clarity per WGLC comments.</t> | ||||
| </section> | ||||
| <section title="Change from 08 to 09"> | ||||
| <t>Updated scheme to version 0.25 to allow tighter checking on | ||||
| <fee:command> by splitting the client and server definitions, | ||||
| moved the class element from the command to the object level and added | ||||
| an optional standard attribute to the command element. Also updated | ||||
| section 3.1 for clarity on name attribute; updated section 3.9 for | ||||
| clarity on uses of <fee:reason>; removed second paragraph in | ||||
| section 5.2.1 as it was duplicative of second to last paragraph in 4.0; | ||||
| and updated section 5.1.1 to add section references.</t> | ||||
| </section> | ||||
| <section title="Change from 07 to 08"> | ||||
| <t>Updated section 3.8 and 5.1.1 to provide clarity on server processing | ||||
| and response of various scenarios (i.e. "quiet" period processing).</t> | ||||
| </section> | ||||
| <section title="Change from 06 to 07"> | ||||
| <t>Updated section 3.8 and 4.0 to provide clarity on server processing | ||||
| and response of various scenarios.</t> | ||||
| </section> | ||||
| <section title="Change from 05 to 06"> | ||||
| <t>Updated scheme to version 0.23 to allow the return of no | ||||
| <fee:command> element(s) if an error situation occurs. Edited | ||||
| section 3.8 extensively after input from interim meeting and REGEXT F2F | ||||
| meeting at IETF-99. Added normative reference for | ||||
| draft-ietf-eppext-launchphase.</t> | ||||
| </section> | ||||
| <section title="Change from 04 to 05"> | ||||
| <t>Updated scheme to version 0.21 to support the lang attribute for the | ||||
| reason element of the objectCDType and the commandType types as well as | ||||
| to add the update command to the commandEnum type. Updated section 3.1 | ||||
| to include language for the custom command. Added section 3.9 to provide | ||||
| a description of the <fee:reason> element. Fixed typos and added | ||||
| clarification text on when client fee is less than server fee in section | ||||
| 4. Additionally, I added description pointers to appropriate Section 3 | ||||
| definitions for element clarity throughout the document.</t> | ||||
| </section> | ||||
| <section title="Change from 03 to 04"> | ||||
| <t>Updated scheme to version 0.19 to correct typos and to replace the | ||||
| commandTypeValue type with the commandEnum type and customName attribute | ||||
| for | ||||
| stricter validation. Updated various text for grammar and clarity. Added | ||||
| text to section 4 clarifying the <check> response when the client | ||||
| provided no fee extension but the server was expecting the extension.</t | ||||
| > | ||||
| </section> | ||||
| <section title="Change from 02 to 03"> | ||||
| <t>Updated scheme to version 0.17 to simplify the check command syntax. | ||||
| Moved fee avail to objectCDType to allow fast failing on error | ||||
| situations. Removed the objectCheckType as it was no longer being used. | ||||
| Updated examples to reflect these scheme changes. Added language for | ||||
| server failing a <create> if the <fee:fee> passed by the | ||||
| client is less than the server fee.</t> | ||||
| </section> | ||||
| <section title="Change from 01 to 02"> | ||||
| <t>Updated scheme to version 0.15 to fix errors in CommandType, | ||||
| objectCDType, transformCommandType and transformResultType definitions.< | ||||
| /t> | ||||
| </section> | ||||
| <section title="Change from 00 to 01"> | ||||
| <t>Added Roger Carney as author to finish draft. Moved Formal Syntax | ||||
| section to main level numbering. Various grammar, typos, and | ||||
| administrative edits for clarity. Removed default value for the | ||||
| "applied" attribute of <fee:fee> so that it can truly be | ||||
| optional. Added support for the <delete> command to return a | ||||
| <fee:fee> element as well. Modified default response on the | ||||
| <check> command for the optional <fee:period> when it was | ||||
| not provided in the command, leaving it to the server to provide the | ||||
| default period value. Extensive edits were done to the <check> | ||||
| command, the <check> response and to the fee extension schema | ||||
| (checkType, objectCheckType, objectIdentifierType, objectCDType, | ||||
| commandType) to support requesting and returning multiple transformation | ||||
| fees in a single call. Added section on Phase/Subphase to provide more | ||||
| context on the uses.</t> | ||||
| </section> | ||||
| <section title="Change from draft-brown-00 to draft-ietf-regext-fees-00"> | ||||
| <t>Updated to be REGEXT WG document.</t> | ||||
| </section> | ||||
| </section> | ||||
| </middle> | </middle> | |||
| <!-- *****BACK MATTER ***** --> | ||||
| <back> | <back> | |||
| <!-- References split into informative and normative --> | <references> | |||
| <name>References</name> | ||||
| <!-- There are 2 ways to insert reference entries from the citation librarie | <references> | |||
| s: | <name>Normative References</name> | |||
| 1. define an ENTITY at the top, and use "ampersand character"RFC2629; here | <reference anchor="ISO4217_2015" target="https://www.iso.org/standard/64 | |||
| (as shown) | 758.html"> | |||
| 2. simply use a PI "less than character"?rfc include="reference.RFC.2119.xm | <front> | |||
| l"?> here | <title>Codes for the representation of currencies</title> | |||
| (for I-Ds: include="reference.I-D.narten-iana-considerations-rfc2434bis. | <seriesInfo name="ISO" value="4217:2015"/> | |||
| xml") | <author> | |||
| <organization>ISO</organization> | ||||
| Both are cited textually in the same manner: by using xref elements. | </author> | |||
| If you use the PI option, xml2rfc will, by default, try to find included fi | <date year="2015" month="August"/> | |||
| les in the same | </front> | |||
| directory as the including file. You can also define the XML_LIBRARY enviro | </reference> | |||
| nment variable | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | |||
| with a value containing a set of directories to search. These can be eithe | FC.2119.xml"/> | |||
| r in the local | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | |||
| filing system or remote ones accessed by http (http://domain/dir/... ).--> | FC.3688.xml"/> | |||
| <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | ||||
| <references title="Normative References"> | FC.3915.xml"/> | |||
| <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | ||||
| <reference anchor='ISO4217:2015' target='https://www.iso.org/standard/6475 | FC.5646.xml"/> | |||
| 8.html'> | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | |||
| <front> | FC.5730.xml"/> | |||
| <title>Codes for the representation of currencies</title> | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | |||
| <author> | FC.5731.xml"/> | |||
| <organization>International Organization for Standardization</organi | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | |||
| zation> | FC.8174.xml"/> | |||
| </author> | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | |||
| <date year='2015' month='August'/> | FC.8334.xml"/> | |||
| </front> | ||||
| </reference> | ||||
| &RFC2119; | ||||
| &RFC3688; | ||||
| &RFC3915; | ||||
| &RFC5730; | ||||
| &RFC5731; | ||||
| &RFC7942; | ||||
| &RFC8174; | ||||
| &RFC8334; | ||||
| &W3C.REC-xmlschema-1-20041028; | ||||
| </references> | ||||
| <references title="Informative References"> | ||||
| &RFC7451; | ||||
| <reference anchor="W3C.REC-xmlschema-1-20041028" target="http://www.w3.o | ||||
| rg/TR/2004/REC-xmlschema-1-20041028" xml:base="https://xml2rfc.ietf.org/public/r | ||||
| fc/bibxml4/reference.W3C.REC-xmlschema-1-20041028.xml"> | ||||
| <front> | ||||
| <title>XML Schema Part 1: Structures Second Edition</title> | ||||
| <seriesInfo name="World Wide Web Consortium Recommendation" value="R | ||||
| EC-xmlschema-1-20041028"/> | ||||
| <author initials="H." surname="Thompson" fullname="Henry Thompson"> | ||||
| <organization/> | ||||
| </author> | ||||
| <author initials="D." surname="Beech" fullname="David Beech"> | ||||
| <organization/> | ||||
| </author> | ||||
| <author initials="M." surname="Maloney" fullname="Murray Maloney"> | ||||
| <organization/> | ||||
| </author> | ||||
| <author initials="N." surname="Mendelsohn" fullname="Noah Mendelsohn | ||||
| "> | ||||
| <organization/> | ||||
| </author> | ||||
| <date month="October" year="2004"/> | ||||
| </front> | ||||
| </reference> | ||||
| </references> | ||||
| <references> | ||||
| <name>Informative References</name> | ||||
| <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R | ||||
| FC.7451.xml"/> | ||||
| </references> | ||||
| </references> | </references> | |||
| <section anchor="acknowledgements" numbered="false" toc="default"> | ||||
| <name>Acknowledgements</name> | ||||
| <t>The authors wish to thank the following persons for their feedback and | ||||
| suggestions:</t> | ||||
| <ul spacing="compact"> | ||||
| <li><t><contact fullname="James Gould"/> of Verisign Inc.</t></li> | ||||
| <li><t><contact fullname="Luis Munoz"/> of ISC</t></li> | ||||
| <li><t><contact fullname="Michael Young"/></t></li> | ||||
| <li><t><contact fullname="Ben Levac"/></t></li> | ||||
| <li><t><contact fullname="Jeff Eckhaus"/></t></li> | ||||
| <li><t><contact fullname="Seth Goldman"/> of Google</t></li> | ||||
| <li><t><contact fullname="Klaus Malorny"/> and <contact fullname="Michae | ||||
| l Bauland"/> of Knipp</t></li> | ||||
| <li><t><contact fullname="Jody Kolker"/>, <contact fullname="Joe | ||||
| Snitker"/>, and <contact fullname="Kevin Allendorf"/> of GoDaddy</t></li> | ||||
| <li><t><contact fullname="Michael Holloway"/> of Com Laude</t></li> | ||||
| <li><t><contact fullname="Santosh Kalsangrah"/> of Impetus Infotech</t>< | ||||
| /li> | ||||
| <li><t><contact fullname="Alex Mayrhofer"/> of Nic.at</t></li> | ||||
| <li><t><contact fullname="Thomas Corte"/> of Knipp Medien und Kommunikat | ||||
| ion GmbH</t></li> | ||||
| </ul> | ||||
| </section> | ||||
| </back> | </back> | |||
| </rfc> | </rfc> | |||
| End of changes. 228 change blocks. | ||||
| 1064 lines changed or deleted | 727 lines changed or added | |||
This html diff was produced by rfcdiff 1.45. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||