Add Easy Address
<div class="section">
<p>
Easy address can be added for instant payment via this API.</p>
<h3>
API Information</h3>
<table class="doctable">
<tbody>
<tr>
<td>
<h3>
URL</h3>
</td>
<td>
/addKOLAS</td>
</tr>
<tr>
<td>
<h3>
Method</h3>
</td>
<td>
POST</td>
</tr>
<tr>
<td>
<h3>
Version</h3>
</td>
<td>
1.0</td>
</tr>
<tr>
<td>
<h3>
Scope</h3>
</td>
<td>
transfer</td>
</tr>
<tr>
<td>
<h3>
Authorization Flow</h3>
</td>
<td>
Authorization Code</td>
</tr>
</tbody>
</table>
<h3>
<br />
Input Information</h3>
<table class="doctable">
<thead>
<tr>
<td>
Name</td>
<td>
Format</td>
<td>
Description</td>
<td>
Required/Optional</td>
</tr>
</thead>
<tbody>
<tr>
<td>
<h3>
AddressType</h3>
</td>
<td>
String (1)</td>
<td>
Easy Address Types<br />
K: T.R. Identity Number<br />
T: Phone Number<br />
E: E-Mail<br />
V: Tax Identity Number<br />
Y: Foreign Identity Number<br />
P:Passport Number</td>
<td>
Required</td>
</tr>
<tr>
<td>
<h3>
AddressValue</h3>
</td>
<td>
String (30)</td>
<td>
Address value that added by customer and cofirmed by participant. Must be compatible with “Easy Address Type”.</td>
<td>
Required</td>
</tr>
<tr>
<td>
<h3>
AccountOwner</h3>
</td>
<td>
String (30)</td>
<td>
Name Surname/Title information.</td>
<td>
Required</td>
</tr>
<tr>
<td>
<h3>
IBAN</h3>
</td>
<td>
String (30)</td>
<td>
IBAN .</td>
<td>
Required</td>
</tr>
<tr>
<td>
<h3>
Description</h3>
</td>
<td>
String (30)</td>
<td>
Description</td>
<td>
Optional</td>
</tr>
</tbody>
</table>
<h3>
<br />
Output Information</h3>
<table class="doctable">
<thead>
<tr>
<td>
Name</td>
<td>
Format</td>
<td>
Description</td>
</tr>
</thead>
<tbody>
<tr>
<td>
<h3>
SystemRefNo</h3>
</td>
<td>
Integer</td>
<td>
System Referance Number</td>
</tr>
<tr>
<td>
<h3>
AddressType</h3>
</td>
<td>
String(1)</td>
<td>
Easy Address Types<br />
K: T.R. Identity Number<br />
T: Phone Number<br />
E: E-Mail<br />
V: Tax Identity Number<br />
Y: Foreign Identity Number<br />
P:Passport Number</td>
</tr>
<tr>
<td>
<h3>
AddressValue</h3>
</td>
<td>
String</td>
<td>
Address value that added by customer and cofirmed by participant. Must be compatible with “Easy Address Type”.</td>
</tr>
<tr>
<td>
<h3>
TradeName</h3>
</td>
<td>
String</td>
<td>
Trade Name which is only shown by commercial customer.</td>
</tr>
</tbody>
</table>
<br />
<h4>
List< KOLASError ></h4>
<table class="doctable">
<thead>
<tr>
<td>
Name</td>
<td>
Format</td>
<td>
Description</td>
</tr>
</thead>
<tbody>
<tr>
<td>
<h3>
ErrorCode</h3>
</td>
<td>
Integer</td>
<td>
Error Code</td>
</tr>
<tr>
<td>
<h3>
Information</h3>
</td>
<td>
String</td>
<td>
Error description</td>
</tr>
</tbody>
</table>
<h3>
</h3>
<h3>
Message Codes</h3>
<table class="doctable">
<thead>
<tr>
<td>
Message Code</td>
<td>
Description</td>
</tr>
</thead>
<tbody>
<tr>
<td>
<h3>
ACBH000022</h3>
</td>
<td>
IBAN format is incorrect.</td>
</tr>
<tr>
<td>
<h3>
ACBH000055</h3>
</td>
<td>
IBAN cannot be empty.</td>
</tr>
<tr>
<td>
<h3>
ACBH000143</h3>
</td>
<td>
Name/Surname cannot be empty.</td>
</tr>
<tr>
<td>
<h3>
ACBH000146</h3>
</td>
<td>
T.R. Identity Number format is incorrect.</td>
</tr>
<tr>
<td>
<h3>
ACBH000364</h3>
</td>
<td>
T.R. Idetity Number cannot be empty.</td>
</tr>
<tr>
<td>
<h3>
ACBH000267</h3>
</td>
<td>
Tax Identity Number is incorrect.</td>
</tr>
<tr>
<td>
<h3>
ACBH000365</h3>
</td>
<td>
Tax Identity Number cannot be empty.</td>
</tr>
<tr>
<td>
<h3>
ACBH000212</h3>
</td>
<td>
Cell phone number must be 10 digits and start with 5.</td>
</tr>
<tr>
<td>
<h3>
ACBH000366</h3>
</td>
<td>
Cell phone number cannot be empty.</td>
</tr>
<tr>
<td>
<h3>
ACBH000367</h3>
</td>
<td>
Passport number format is incorrect.</td>
</tr>
<tr>
<td>
<h3>
ACBH000368</h3>
</td>
<td>
Passport number cannot be empty.</td>
</tr>
<tr>
<td>
<h3>
ACBH000369</h3>
</td>
<td>
Foreign identity number is incorrect.</td>
</tr>
<tr>
<td>
<h3>
ACBH000370</h3>
</td>
<td>
Foreign number cannot be empty.</td>
</tr>
<tr>
<td>
<h3>
ACBH000197</h3>
</td>
<td>
E-Mail format is incorrect.</td>
</tr>
<tr>
<td>
<h3>
ACBH000199</h3>
</td>
<td>
E-Mail cannot be empty.</td>
</tr>
<tr>
<td>
<h3>
ACBH000376</h3>
</td>
<td>
Address Type cannot be empty.</td>
</tr>
</tbody>
</table>
<h3>
Example:</h3>
<p>
Request:</p>
<div style="background-color: #fcf6db;width: 100%;color:green;">
<pre>
{
"AddressType":"K",
"AddressValue":"123456789",
"AccountOwner":"KIZILCIM ŞERBET",
"IBAN":"TR000000000000000000000000",
"Description": "test"
}
</pre>
</div>
<p>
Response:</p>
<div style="background-color: #fcf6db;width: 100%;color:green;">
<pre>
{
"Header": {
"StatusCode": "APIGW000000",
"StatusDescription": "Tamamlandı",
"StatusDescriptionEn": "Completed",
"ObjectID": "4d019752-415e-498a-953f-a97baf30bcc5"
},
"Data": {
"systemRefNo": 527826687958712322,
"AddressValue": 12345678912,
"KOLASError": "",
"AddressType": "K"
}
}
</pre>
</div>
</div>
<p>
</p>
<p>
</p>