MAGETWO-32921: Adapt Payment\Gateway framework to client requirement

- Added API documentation for Order Address

Author: dkvashninbay

app/code/Magento/Sales/Api/Data/OrderAddressInterface.php

@@ -35,6 +35,10 @@ interface OrderAddressInterface extends \Magento\Framework\Api\ExtensibleDataInt
      * Region ID.
      */
     const REGION_ID = 'region_id';
+    /**
+     * Region code.
+     */
+    const KEY_REGION_CODE = 'region_code';
     /*
      * Customer ID.
      */
@@ -248,9 +252,9 @@ public function getQuoteAddressId();
     public function getRegion();
 
     /**
-     * Return 2 letter state code if available, otherwise full region name
+     * Gets the region code for the order address
      *
-     * @return null|string
+     * @return string|null Region code.
      */
     public function getRegionCode();
 
@@ -501,6 +505,14 @@ public function setVatIsValid($vatIsValid);
      */
     public function setVatRequestId($id);
 
+    /**
+     * Set region code
+     *
+     * @param string $regionCode
+     * @return $this
+     */
+    public function setRegionCode($regionCode);
+
     /**
      * Sets the VAT request date for the order address.
      *

app/code/Magento/Sales/Model/Order/Address.php

@@ -702,6 +702,14 @@ public function setVatRequestId($id)
         return $this->setData(OrderAddressInterface::VAT_REQUEST_ID, $id);
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public function setRegionCode($regionCode)
+    {
+        return $this->setData(OrderAddressInterface::KEY_REGION_CODE, $regionCode);
+    }
+
     /**
      * {@inheritdoc}
      */