app.833beb9a.js

js ohvps.github.io collected 2026-10-03 09:42:34 UTC 2,311,802 bytes, 16 lines download raw bytes

1(window.webpackJsonp=window.webpackJsonp||[]).push([[0],[]]);!function(e){function i(i){for(var a,t,d=i[0],m=i[1],s=i[2],k=0,o=[];k<d.length;k++)t=d[k],Object.prototype.hasOwnProperty.call(r,t)&&r[t]&&o.push(r[t][0]),r[t]=0;for(a in m)Object.prototype.hasOwnProperty.call(m,a)&&(e[a]=m[a]);for(u&&u(i);o.length;)o.shift()();return l.push.apply(l,s||[]),n()}function n(){for(var e,i=0;i<l.length;i++){for(var n=l[i],a=!0,d=1;d<n.length;d++){var m=n[d];0!==r[m]&&(a=!1)}a&&(l.splice(i--,1),e=t(t.s=n[0]))}return e}var a={},r={13:0},l=[];function t(i){if(a[i])return a[i].exports;var n=a[i]={i:i,l:!1,exports:{}};return e[i].call(n.exports,n,n.exports,t),n.l=!0,n.exports}t.e=function(e){var i=[],n=r[e];if(0!==n)if(n)i.push(n[2]);else{var a=new Promise((function(i,a){n=r[e]=[i,a]}));i.push(n[2]=a);var l,d=document.createElement("script");d.charset="utf-8",d.timeout=120,t.nc&&d.setAttribute("nonce",t.nc),d.src=function(e){return t.p+"assets/js/"+({14:"vendors~docsearch"}[e]||e)+"."+{1:"d3419479",2:"484a14f6",3:"43da589b",4:"f865ed41",5:"ee1d951c",6:"ab10f7fc",7:"1da5ce0f",8:"93d599e6",9:"c1e1d6c2",10:"51f8626e",11:"452b283d",12:"9cfc9ded",14:"2cdbc4a2",15:"0ddc6579",16:"487f380b",17:"286f0068",18:"140498cb",19:"e806f998",20:"947b69c0",21:"20c03261",22:"17f00dc3",23:"dd5e09da",24:"db073f16",25:"dd740719",26:"a0ccbc75",27:"906389c9",28:"42c37ed6",29:"c32a9437",30:"62f76616",31:"b17fed96",32:"545f479b",33:"f2e76a85",34:"7cd9ebbc",35:"a0308e6f",36:"2e60eed1",37:"1d79f5c0",38:"2f097d28",39:"425d08b1",40:"6bef2065",41:"3876ae4c",42:"ac7a2ece",43:"381f48e0",44:"4113163c",45:"7761d8de",46:"7b930815",47:"aa5da579",48:"9daea828",49:"3355f252",50:"dfbe829f",51:"82759ea7",52:"0269347d",53:"4d00b261",54:"eef17477",55:"9200d8ee",56:"ece329b6",57:"cb8f95c1",58:"15a1c97b",59:"52f562ab",60:"d249f4f4",61:"54e25de5",62:"cc130124",63:"3cd612f3",64:"145aafc1",65:"a8fef4ab",66:"0906aefd",67:"c7e6d720",68:"25a08d2f",69:"a7a1880a",70:"f570af1a",71:"0238b940",72:"2c12f096",73:"b4ac53c8",74:"17fb3a33",75:"96e8ac3b",76:"9907dc4e",77:"575c93f3",78:"577450cd",79:"0a51d2e3",80:"d6ef57b4",81:"86dd65b7",82:"7705c415",83:"207e9c23",84:"665cea46",85:"16779d2e",86:"82b4f6b0",87:"ce388e58",88:"c8bce608",89:"f0dc1d72",90:"2746e664",91:"fdf7cfa0",92:"8afd71cd",93:"a2a017c9",94:"d194b8cd",95:"1a7a7043",96:"f93927e5",97:"29a8c7ab",98:"f7a59bb3",99:"02a9be02",100:"4bba77e7",101:"52660392",102:"34923ed6",103:"396ad9c1",104:"98661a9e",105:"88398786",106:"c16c355f",107:"83ed4c26",108:"936cc147",109:"6c13c824",110:"bd566c19",111:"fdb42917",112:"3951ee8d",113:"807e0ac8",114:"0b7c2831",115:"8a1300e0",116:"b4d01a96",117:"7b66cc05",118:"2d279739",119:"21593bd4",120:"20039be9",121:"d34a8ab5",122:"d489fae5",123:"434365d9",124:"d826e5cf",125:"8d668e4f",126:"0ceb7ec6",127:"804e6234",128:"7cd680d4",129:"8f5a3939",130:"8f245b7e",131:"a6f15b85",132:"4cd71ed6"}[e]+".js"}(e);var m=new Error;l=function(i){d.onerror=d.onload=null,clearTimeout(s);var n=r[e];if(0!==n){if(n){var a=i&&("load"===i.type?"missing":i.type),l=i&&i.target&&i.target.src;m.message="Loading chunk "+e+" failed.\n("+a+": "+l+")",m.name="ChunkLoadError",m.type=a,m.request=l,n[1](m)}r[e]=void 0}};var s=setTimeout((function(){l({type:"timeout",target:d})}),12e4);d.onerror=d.onload=l,document.head.appendChild(d)}return Promise.all(i)},t.m=e,t.c=a,t.d=function(e,i,n){t.o(e,i)||Object.defineProperty(e,i,{enumerable:!0,get:n})},t.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},t.t=function(e,i){if(1&i&&(e=t(e)),8&i)return e;if(4&i&&"object"==typeof e&&e&&e.__esModule)return e;var n=Object.create(null);if(t.r(n),Object.defineProperty(n,"default",{enumerable:!0,value:e}),2&i&&"string"!=typeof e)for(var a in e)t.d(n,a,function(i){return e[i]}.bind(null,a));return n},t.n=function(e){var i=e&&e.__esModule?function(){return e.default}:function(){return e};return t.d(i,"a",i),i},t.o=function(e,i){return Object.prototype.hasOwnProperty.call(e,i)},t.p="/",t.oe=function(e){throw console.error(e),e};var d=window.webpackJsonp=window.webpackJsonp||[],m=d.push.bind(d);d.push=i,d=d.slice();for(var s=0;s<d.length;s++)i(d[s]);var u=m;l.push([145,0]),n()}([function(e,i,n){"use strict";n.r(i),n.d(i,"EffectScope",(function(){return pi})),n.d(i,"computed",(function(){return di})),n.d(i,"customRef",(function(){return ei})),n.d(i,"default",(function(){return qa})),n.d(i,"defineAsyncComponent",(function(){return Nn})),n.d(i,"defineComponent",(function(){return jn})),n.d(i,"del",(function(){return Ee})),n.d(i,"effectScope",(function(){return Si})),n.d(i,"getCurrentInstance",(function(){return oe})),n.d(i,"getCurrentScope",(function(){return zi})),n.d(i,"h",(function(){return yn})),n.d(i,"inject",(function(){return Ai})),n.d(i,"isProxy",(function(){return Le})),n.d(i,"isReactive",(function(){return Me})),n.d(i,"isReadonly",(function(){return _e})),n.d(i,"isRef",(function(){return je})),n.d(i,"isShallow",(function(){return Fe})),n.d(i,"markRaw",(function(){return Ue})),n.d(i,"mergeDefaults",(function(){return mn})),n.d(i,"nextTick",(function(){return Bn})),n.d(i,"onActivated",(function(){return Vn})),n.d(i,"onBeforeMount",(function(){return On})),n.d(i,"onBeforeUnmount",(function(){return Zn})),n.d(i,"onBeforeUpdate",(function(){return In})),n.d(i,"onDeactivated",(function(){return Cn})),n.d(i,"onErrorCaptured",(function(){return xn})),n.d(i,"onMounted",(function(){return Dn})),n.d(i,"onRenderTracked",(function(){return Fn})),n.d(i,"onRenderTriggered",(function(){return _n})),n.d(i,"onScopeDispose",(function(){return hi})),n.d(i,"onServerPrefetch",(function(){return Mn})),n.d(i,"onUnmounted",(function(){return Gn})),n.d(i,"onUpdated",(function(){return En})),n.d(i,"provide",(function(){return Ki})),n.d(i,"proxyRefs",(function(){return qe})),n.d(i,"reactive",(function(){return Ge})),n.d(i,"readonly",(function(){return ai})),n.d(i,"ref",(function(){return we})),n.d(i,"set",(function(){return Ie})),n.d(i,"shallowReactive",(function(){return Ve})),n.d(i,"shallowReadonly",(function(){return ti})),n.d(i,"shallowRef",(function(){return $e})),n.d(i,"toRaw",(function(){return xe})),n.d(i,"toRef",(function(){return ni})),n.d(i,"toRefs",(function(){return ii})),n.d(i,"triggerRef",(function(){return Xe})),n.d(i,"unref",(function(){return We})),n.d(i,"useAttrs",(function(){return ln})),n.d(i,"useCssModule",(function(){return Rn})),n.d(i,"useCssVars",(function(){return Yn})),n.d(i,"useListeners",(function(){return tn})),n.d(i,"useSlots",(function(){return rn})),n.d(i,"version",(function(){return Un})),n.d(i,"watch",(function(){return ci})),n.d(i,"watchEffect",(function(){return ki})),n.d(i,"watchPostEffect",(function(){return oi})),n.d(i,"watchSyncEffect",(function(){return yi}));
2/*!
3 * Vue.js v2.7.16
4 * (c) 2014-2023 Evan You
5 * Released under the MIT License.
6 */
7var a=Object.freeze({}),r=Array.isArray;function l(e){return null==e}function t(e){return null!=e}function d(e){return!0===e}function m(e){return"string"==typeof e||"number"==typeof e||"symbol"==typeof e||"boolean"==typeof e}function s(e){return"function"==typeof e}function u(e){return null!==e&&"object"==typeof e}var k=Object.prototype.toString;function o(e){return"[object Object]"===k.call(e)}function y(e){return"[object RegExp]"===k.call(e)}function b(e){var i=parseFloat(String(e));return i>=0&&Math.floor(i)===i&&isFinite(e)}function g(e){return t(e)&&"function"==typeof e.then&&"function"==typeof e.catch}function c(e){return null==e?"":Array.isArray(e)||o(e)&&e.toString===k?JSON.stringify(e,H,2):String(e)}function H(e,i){return i&&i.__v_isRef?i.value:i}function p(e){var i=parseFloat(e);return isNaN(i)?e:i}function S(e,i){for(var n=Object.create(null),a=e.split(","),r=0;r<a.length;r++)n[a[r]]=!0;return i?function(e){return n[e.toLowerCase()]}:function(e){return n[e]}}S("slot,component",!0);var z=S("key,ref,slot,slot-scope,is");function h(e,i){var n=e.length;if(n){if(i===e[n-1])return void(e.length=n-1);var a=e.indexOf(i);if(a>-1)return e.splice(a,1)}}var K=Object.prototype.hasOwnProperty;function v(e,i){return K.call(e,i)}function A(e){var i=Object.create(null);return function(n){return i[n]||(i[n]=e(n))}}var T=/-(\w)/g,f=A((function(e){return e.replace(T,(function(e,i){return i?i.toUpperCase():""}))})),B=A((function(e){return e.charAt(0).toUpperCase()+e.slice(1)})),R=/\B([A-Z])/g,Y=A((function(e){return e.replace(R,"-$1").toLowerCase()}));var N=Function.prototype.bind?function(e,i){return e.bind(i)}:function(e,i){function n(n){var a=arguments.length;return a?a>1?e.apply(i,arguments):e.call(i,n):e.call(i)}return n._length=e.length,n};

vendor: 15,259 bytes, line 7

7function P(e,i){i=i||0;for(var n=e.length-i,a=new Array(n);n--;)a[n]=e[n+i];return a}function O(e,i){for(var n in i)e[n]=i[n];return e}function D(e){for(var i={},n=0;n<e.length;n++)e[n]&&O(i,e[n]);return i}function I(e,i,n){}var E=function(e,i,n){return!1},Z=function(e){return e};function G(e,i){if(e===i)return!0;var n=u(e),a=u(i);if(!n||!a)return!n&&!a&&String(e)===String(i);try{var r=Array.isArray(e),l=Array.isArray(i);if(r&&l)return e.length===i.length&&e.every((function(e,n){return G(e,i[n])}));if(e instanceof Date&&i instanceof Date)return e.getTime()===i.getTime();if(r||l)return!1;var t=Object.keys(e),d=Object.keys(i);return t.length===d.length&&t.every((function(n){return G(e[n],i[n])}))}catch(e){return!1}}function V(e,i){for(var n=0;n<e.length;n++)if(G(e[n],i))return n;return-1}function C(e){var i=!1;return function(){i||(i=!0,e.apply(this,arguments))}}function M(e,i){return e===i?0===e&&1/e!=1/i:e==e||i==i}var F=["component","directive","filter"],_=["beforeCreate","created","beforeMount","mounted","beforeUpdate","updated","beforeDestroy","destroyed","activated","deactivated","errorCaptured","serverPrefetch","renderTracked","renderTriggered"],L={optionMergeStrategies:Object.create(null),silent:!1,productionTip:!1,devtools:!1,performance:!1,errorHandler:null,warnHandler:null,ignoredElements:[],keyCodes:Object.create(null),isReservedTag:E,isReservedAttr:E,isUnknownElement:E,getTagNamespace:I,parsePlatformTagName:Z,mustUseProp:E,async:!0,_lifecycleHooks:_},x=/a-zA-Z\u00B7\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u037D\u037F-\u1FFF\u200C-\u200D\u203F-\u2040\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD/;function U(e){var i=(e+"").charCodeAt(0);return 36===i||95===i}function j(e,i,n,a){Object.defineProperty(e,i,{value:n,enumerable:!!a,writable:!0,configurable:!0})}var w=new RegExp("[^".concat(x.source,".$_\\d]"));var $="__proto__"in{},J="undefined"!=typeof window,X=J&&window.navigator.userAgent.toLowerCase(),W=X&&/msie|trident/.test(X),q=X&&X.indexOf("msie 9.0")>0,Q=X&&X.indexOf("edge/")>0;X&&X.indexOf("android");var ee=X&&/iphone|ipad|ipod|ios/.test(X);X&&/chrome\/\d+/.test(X),X&&/phantomjs/.test(X);var ie,ne=X&&X.match(/firefox\/(\d+)/),ae={}.watch,re=!1;if(J)try{var le={};Object.defineProperty(le,"passive",{get:function(){re=!0}}),window.addEventListener("test-passive",null,le)}catch(e){}var te=function(){return void 0===ie&&(ie=!J&&"undefined"!=typeof global&&(global.process&&"server"===global.process.env.VUE_ENV)),ie},de=J&&window.__VUE_DEVTOOLS_GLOBAL_HOOK__;function me(e){return"function"==typeof e&&/native code/.test(e.toString())}var se,ue="undefined"!=typeof Symbol&&me(Symbol)&&"undefined"!=typeof Reflect&&me(Reflect.ownKeys);se="undefined"!=typeof Set&&me(Set)?Set:function(){function e(){this.set=Object.create(null)}return e.prototype.has=function(e){return!0===this.set[e]},e.prototype.add=function(e){this.set[e]=!0},e.prototype.clear=function(){this.set=Object.create(null)},e}();var ke=null;function oe(){return ke&&{proxy:ke}}function ye(e){void 0===e&&(e=null),e||ke&&ke._scope.off(),ke=e,e&&e._scope.on()}var be=function(){function e(e,i,n,a,r,l,t,d){this.tag=e,this.data=i,this.children=n,this.text=a,this.elm=r,this.ns=void 0,this.context=l,this.fnContext=void 0,this.fnOptions=void 0,this.fnScopeId=void 0,this.key=i&&i.key,this.componentOptions=t,this.componentInstance=void 0,this.parent=void 0,this.raw=!1,this.isStatic=!1,this.isRootInsert=!0,this.isComment=!1,this.isCloned=!1,this.isOnce=!1,this.asyncFactory=d,this.asyncMeta=void 0,this.isAsyncPlaceholder=!1}return Object.defineProperty(e.prototype,"child",{get:function(){return this.componentInstance},enumerable:!1,configurable:!0}),e}(),ge=function(e){void 0===e&&(e="");var i=new be;return i.text=e,i.isComment=!0,i};function ce(e){return new be(void 0,void 0,void 0,String(e))}function He(e){var i=new be(e.tag,e.data,e.children&&e.children.slice(),e.text,e.elm,e.context,e.componentOptions,e.asyncFactory);return i.ns=e.ns,i.isStatic=e.isStatic,i.key=e.key,i.isComment=e.isComment,i.fnContext=e.fnContext,i.fnOptions=e.fnOptions,i.fnScopeId=e.fnScopeId,i.asyncMeta=e.asyncMeta,i.isCloned=!0,i}"function"==typeof SuppressedError&&SuppressedError;var pe=0,Se=[],ze=function(){function e(){this._pending=!1,this.id=pe++,this.subs=[]}return e.prototype.addSub=function(e){this.subs.push(e)},e.prototype.removeSub=function(e){this.subs[this.subs.indexOf(e)]=null,this._pending||(this._pending=!0,Se.push(this))},e.prototype.depend=function(i){e.target&&e.target.addDep(this)},e.prototype.notify=function(e){var i=this.subs.filter((function(e){return e}));for(var n=0,a=i.length;n<a;n++){0,i[n].update()}},e}();ze.target=null;var he=[];function Ke(e){he.push(e),ze.target=e}function ve(){he.pop(),ze.target=he[he.length-1]}var Ae=Array.prototype,Te=Object.create(Ae);["push","pop","shift","unshift","splice","sort","reverse"].forEach((function(e){var i=Ae[e];j(Te,e,(function(){for(var n=[],a=0;a<arguments.length;a++)n[a]=arguments[a];var r,l=i.apply(this,n),t=this.__ob__;switch(e){case"push":case"unshift":r=n;break;case"splice":r=n.slice(2)}return r&&t.observeArray(r),t.dep.notify(),l}))}));var fe=Object.getOwnPropertyNames(Te),Be={},Re=!0;function Ye(e){Re=e}var Ne={notify:I,depend:I,addSub:I,removeSub:I},Pe=function(){function e(e,i,n){if(void 0===i&&(i=!1),void 0===n&&(n=!1),this.value=e,this.shallow=i,this.mock=n,this.dep=n?Ne:new ze,this.vmCount=0,j(e,"__ob__",this),r(e)){if(!n)if($)e.__proto__=Te;else for(var a=0,l=fe.length;a<l;a++){j(e,d=fe[a],Te[d])}i||this.observeArray(e)}else{var t=Object.keys(e);for(a=0;a<t.length;a++){var d;De(e,d=t[a],Be,void 0,i,n)}}}return e.prototype.observeArray=function(e){for(var i=0,n=e.length;i<n;i++)Oe(e[i],!1,this.mock)},e}();function Oe(e,i,n){return e&&v(e,"__ob__")&&e.__ob__ instanceof Pe?e.__ob__:!Re||!n&&te()||!r(e)&&!o(e)||!Object.isExtensible(e)||e.__v_skip||je(e)||e instanceof be?void 0:new Pe(e,i,n)}function De(e,i,n,a,l,t,d){void 0===d&&(d=!1);var m=new ze,s=Object.getOwnPropertyDescriptor(e,i);if(!s||!1!==s.configurable){var u=s&&s.get,k=s&&s.set;u&&!k||n!==Be&&2!==arguments.length||(n=e[i]);var o=l?n&&n.__ob__:Oe(n,!1,t);return Object.defineProperty(e,i,{enumerable:!0,configurable:!0,get:function(){var i=u?u.call(e):n;return ze.target&&(m.depend(),o&&(o.dep.depend(),r(i)&&Ze(i))),je(i)&&!l?i.value:i},set:function(i){var a=u?u.call(e):n;if(M(a,i)){if(k)k.call(e,i);else{if(u)return;if(!l&&je(a)&&!je(i))return void(a.value=i);n=i}o=l?i&&i.__ob__:Oe(i,!1,t),m.notify()}}}),m}}function Ie(e,i,n){if(!_e(e)){var a=e.__ob__;return r(e)&&b(i)?(e.length=Math.max(e.length,i),e.splice(i,1,n),a&&!a.shallow&&a.mock&&Oe(n,!1,!0),n):i in e&&!(i in Object.prototype)?(e[i]=n,n):e._isVue||a&&a.vmCount?n:a?(De(a.value,i,n,void 0,a.shallow,a.mock),a.dep.notify(),n):(e[i]=n,n)}}function Ee(e,i){if(r(e)&&b(i))e.splice(i,1);else{var n=e.__ob__;e._isVue||n&&n.vmCount||_e(e)||v(e,i)&&(delete e[i],n&&n.dep.notify())}}function Ze(e){for(var i=void 0,n=0,a=e.length;n<a;n++)(i=e[n])&&i.__ob__&&i.__ob__.dep.depend(),r(i)&&Ze(i)}function Ge(e){return Ce(e,!1),e}function Ve(e){return Ce(e,!0),j(e,"__v_isShallow",!0),e}function Ce(e,i){if(!_e(e)){Oe(e,i,te());0}}function Me(e){return _e(e)?Me(e.__v_raw):!(!e||!e.__ob__)}function Fe(e){return!(!e||!e.__v_isShallow)}function _e(e){return!(!e||!e.__v_isReadonly)}function Le(e){return Me(e)||_e(e)}function xe(e){var i=e&&e.__v_raw;return i?xe(i):e}function Ue(e){return Object.isExtensible(e)&&j(e,"__v_skip",!0),e}function je(e){return!(!e||!0!==e.__v_isRef)}function we(e){return Je(e,!1)}function $e(e){return Je(e,!0)}function Je(e,i){if(je(e))return e;var n={};return j(n,"__v_isRef",!0),j(n,"__v_isShallow",i),j(n,"dep",De(n,"value",e,null,i,te())),n}function Xe(e){e.dep&&e.dep.notify()}function We(e){return je(e)?e.value:e}function qe(e){if(Me(e))return e;for(var i={},n=Object.keys(e),a=0;a<n.length;a++)Qe(i,e,n[a]);return i}function Qe(e,i,n){Object.defineProperty(e,n,{enumerable:!0,configurable:!0,get:function(){var e=i[n];if(je(e))return e.value;var a=e&&e.__ob__;return a&&a.dep.depend(),e},set:function(e){var a=i[n];je(a)&&!je(e)?a.value=e:i[n]=e}})}function ei(e){var i=new ze,n=e((function(){i.depend()}),(function(){i.notify()})),a=n.get,r=n.set,l={get value(){return a()},set value(e){r(e)}};return j(l,"__v_isRef",!0),l}function ii(e){var i=r(e)?new Array(e.length):{};for(var n in e)i[n]=ni(e,n);return i}function ni(e,i,n){var a=e[i];if(je(a))return a;var r={get value(){var a=e[i];return void 0===a?n:a},set value(n){e[i]=n}};return j(r,"__v_isRef",!0),r}function ai(e){return ri(e,!1)}function ri(e,i){if(!o(e))return e;if(_e(e))return e;var n=i?"__v_rawToShallowReadonly":"__v_rawToReadonly",a=e[n];if(a)return a;var r=Object.create(Object.getPrototypeOf(e));j(e,n,r),j(r,"__v_isReadonly",!0),j(r,"__v_raw",e),je(e)&&j(r,"__v_isRef",!0),(i||Fe(e))&&j(r,"__v_isShallow",!0);for(var l=Object.keys(e),t=0;t<l.length;t++)li(r,e,l[t],i);return r}function li(e,i,n,a){Object.defineProperty(e,n,{enumerable:!0,configurable:!0,get:function(){var e=i[n];return a||!o(e)?e:ai(e)},set:function(){}})}function ti(e){return ri(e,!0)}function di(e,i){var n,a,r=s(e);r?(n=e,a=I):(n=e.get,a=e.set);var l=te()?null:new Wn(ke,n,I,{lazy:!0});var t={effect:l,get value(){return l?(l.dirty&&l.evaluate(),ze.target&&l.depend(),l.value):n()},set value(e){a(e)}};return j(t,"__v_isRef",!0),j(t,"__v_isReadonly",r),t}var mi="".concat("watcher"," callback"),si="".concat("watcher"," getter"),ui="".concat("watcher"," cleanup");function ki(e,i){return Hi(e,null,i)}function oi(e,i){return Hi(e,null,{flush:"post"})}function yi(e,i){return Hi(e,null,{flush:"sync"})}var bi,gi={};function ci(e,i,n){return Hi(e,i,n)}function Hi(e,i,n){var l=void 0===n?a:n,t=l.immediate,d=l.deep,m=l.flush,u=void 0===m?"pre":m;l.onTrack,l.onTrigger;var k,o,y=ke,b=function(e,i,n){void 0===n&&(n=null);var a=gn(e,null,n,y,i);return d&&a&&a.__ob__&&a.__ob__.dep.depend(),a},g=!1,c=!1;if(je(e)?(k=function(){return e.value},g=Fe(e)):Me(e)?(k=function(){return e.__ob__.dep.depend(),e},d=!0):r(e)?(c=!0,g=e.some((function(e){return Me(e)||Fe(e)})),k=function(){return e.map((function(e){return je(e)?e.value:Me(e)?(e.__ob__.dep.depend(),$n(e)):s(e)?b(e,si):void 0}))}):k=s(e)?i?function(){return b(e,si)}:function(){if(!y||!y._isDestroyed)return o&&o(),b(e,"watcher",[p])}:I,i&&d){var H=k;k=function(){return $n(H())}}var p=function(e){o=S.onStop=function(){b(e,ui)}};if(te())return p=I,i?t&&b(i,mi,[k(),c?[]:void 0,p]):k(),I;var S=new Wn(ke,k,I,{lazy:!0});S.noRecurse=!i;var z=c?[]:gi;return S.run=function(){if(S.active)if(i){var e=S.get();(d||g||(c?e.some((function(e,i){return M(e,z[i])})):M(e,z)))&&(o&&o(),b(i,mi,[e,z===gi?void 0:z,p]),z=e)}else S.get()},"sync"===u?S.update=S.run:"post"===u?(S.post=!0,S.update=function(){return pa(S)}):S.update=function(){if(y&&y===ke&&!y._isMounted){var e=y._preWatchers||(y._preWatchers=[]);e.indexOf(S)<0&&e.push(S)}else pa(S)},i?t?S.run():z=S.get():"post"===u&&y?y.$once("hook:mounted",(function(){return S.get()})):S.get(),function(){S.teardown()}}var pi=function(){function e(e){void 0===e&&(e=!1),this.detached=e,this.active=!0,this.effects=[],this.cleanups=[],this.parent=bi,!e&&bi&&(this.index=(bi.scopes||(bi.scopes=[])).push(this)-1)}return e.prototype.run=function(e){if(this.active){var i=bi;try{return bi=this,e()}finally{bi=i}}else 0},e.prototype.on=function(){bi=this},e.prototype.off=function(){bi=this.parent},e.prototype.stop=function(e){if(this.active){var i=void 0,n=void 0;for(i=0,n=this.effects.length;i<n;i++)this.effects[i].teardown();for(i=0,n=this.cleanups.length;i<n;i++)this.cleanups[i]();if(this.scopes)for(i=0,n=this.scopes.length;i<n;i++)this.scopes[i].stop(!0);if(!this.detached&&this.parent&&!e){var a=this.parent.scopes.pop();a&&a!==this&&(this.parent.scopes[this.index]=a,a.index=this.index)}this.parent=void 0,this.active=!1}},e}();function Si(e){return new pi(e)}function zi(){return bi}function hi(e){bi&&bi.cleanups.push(e)}function Ki(e,i){ke&&(vi(ke)[e]=i)}function vi(e){var i=e._provided,n=e.$parent&&e.$parent._provided;return n===i?e._provided=Object.create(n):i}function Ai(e,i,n){void 0===n&&(n=!1);var a=ke;if(a){var r=a.$parent&&a.$parent._provided;if(r&&e in r)return r[e];if(arguments.length>1)return n&&s(i)?i.call(a):i}else 0}var Ti=A((function(e){var i="&"===e.charAt(0),n="~"===(e=i?e.slice(1):e).charAt(0),a="!"===(e=n?e.slice(1):e).charAt(0);return{name:e=a?e.slice(1):e,once:n,capture:a,passive:i}}));function fi(e,i){function n(){var e=n.fns;if(!r(e))return gn(e,null,arguments,i,"v-on handler");for(var a=e.slice(),l=0;l<a.length;l++)gn(a[l],null,arguments,i,"v-on handler")}return n.fns=e,n}function Bi(e,i,n,a,r,t){var m,s,u,k;for(m in e)s=e[m],u=i[m],k=Ti(m),l(s)||(l(u)?(l(s.fns)&&(s=e[m]=fi(s,t)),d(k.once)&&(s=e[m]=r(k.name,s,k.capture)),n(k.name,s,k.capture,k.passive,k.params)):s!==u&&(u.fns=s,e[m]=u));for(m in i)l(e[m])&&a((k=Ti(m)).name,i[m],k.capture)}function Ri(e,i,n){var a;e instanceof be&&(e=e.data.hook||(e.data.hook={}));var r=e[i];function m(){n.apply(this,arguments),h(a.fns,m)}l(r)?a=fi([m]):t(r.fns)&&d(r.merged)?(a=r).fns.push(m):a=fi([r,m]),a.merged=!0,e[i]=a}function Yi(e,i,n,a,r){if(t(i)){if(v(i,n))return e[n]=i[n],r||delete i[n],!0;if(v(i,a))return e[n]=i[a],r||delete i[a],!0}return!1}function Ni(e){return m(e)?[ce(e)]:r(e)?function e(i,n){var a,s,u,k,o=[];for(a=0;a<i.length;a++)l(s=i[a])||"boolean"==typeof s||(u=o.length-1,k=o[u],r(s)?s.length>0&&(Pi((s=e(s,"".concat(n||"","_").concat(a)))[0])&&Pi(k)&&(o[u]=ce(k.text+s[0].text),s.shift()),o.push.apply(o,s)):m(s)?Pi(k)?o[u]=ce(k.text+s):""!==s&&o.push(ce(s)):Pi(s)&&Pi(k)?o[u]=ce(k.text+s.text):(d(i._isVList)&&t(s.tag)&&l(s.key)&&t(n)&&(s.key="__vlist".concat(n,"_").concat(a,"__")),o.push(s)));return o}(e):void 0}function Pi(e){return t(e)&&t(e.text)&&!1===e.isComment}function Oi(e,i){var n,a,l,d,m=null;if(r(e)||"string"==typeof e)for(m=new Array(e.length),n=0,a=e.length;n<a;n++)m[n]=i(e[n],n);else if("number"==typeof e)for(m=new Array(e),n=0;n<e;n++)m[n]=i(n+1,n);else if(u(e))if(ue&&e[Symbol.iterator]){m=[];for(var s=e[Symbol.iterator](),k=s.next();!k.done;)m.push(i(k.value,m.length)),k=s.next()}else for(l=Object.keys(e),m=new Array(l.length),n=0,a=l.length;n<a;n++)d=l[n],m[n]=i(e[d],d,n);return t(m)||(m=[]),m._isVList=!0,m}function Di(e,i,n,a){var r,l=this.$scopedSlots[e];l?(n=n||{},a&&(n=O(O({},a),n)),r=l(n)||(s(i)?i():i)):r=this.$slots[e]||(s(i)?i():i);var t=n&&n.slot;return t?this.$createElement("template",{slot:t},r):r}function Ii(e){return Za(this.$options,"filters",e,!0)||Z}function Ei(e,i){return r(e)?-1===e.indexOf(i):e!==i}function Zi(e,i,n,a,r){var l=L.keyCodes[i]||n;return r&&a&&!L.keyCodes[i]?Ei(r,a):l?Ei(l,e):a?Y(a)!==i:void 0===e}function Gi(e,i,n,a,l){if(n)if(u(n)){r(n)&&(n=D(n));var t=void 0,d=function(r){if("class"===r||"style"===r||z(r))t=e;else{var d=e.attrs&&e.attrs.type;t=a||L.mustUseProp(i,d,r)?e.domProps||(e.domProps={}):e.attrs||(e.attrs={})}var m=f(r),s=Y(r);m in t||s in t||(t[r]=n[r],l&&((e.on||(e.on={}))["update:".concat(r)]=function(e){n[r]=e}))};for(var m in n)d(m)}else;return e}function Vi(e,i){var n=this._staticTrees||(this._staticTrees=[]),a=n[e];return a&&!i||Mi(a=n[e]=this.$options.staticRenderFns[e].call(this._renderProxy,this._c,this),"__static__".concat(e),!1),a}

vendor: 2,489 bytes, line 7

7function Ci(e,i,n){return Mi(e,"__once__".concat(i).concat(n?"_".concat(n):""),!0),e}function Mi(e,i,n){if(r(e))for(var a=0;a<e.length;a++)e[a]&&"string"!=typeof e[a]&&Fi(e[a],"".concat(i,"_").concat(a),n);else Fi(e,i,n)}function Fi(e,i,n){e.isStatic=!0,e.key=i,e.isOnce=n}function _i(e,i){if(i)if(o(i)){var n=e.on=e.on?O({},e.on):{};for(var a in i){var r=n[a],l=i[a];n[a]=r?[].concat(r,l):l}}else;return e}function Li(e,i,n,a){i=i||{$stable:!n};for(var l=0;l<e.length;l++){var t=e[l];r(t)?Li(t,i,n):t&&(t.proxy&&(t.fn.proxy=!0),i[t.key]=t.fn)}return a&&(i.$key=a),i}function xi(e,i){for(var n=0;n<i.length;n+=2){var a=i[n];"string"==typeof a&&a&&(e[i[n]]=i[n+1])}return e}function Ui(e,i){return"string"==typeof e?i+e:e}function ji(e){e._o=Ci,e._n=p,e._s=c,e._l=Oi,e._t=Di,e._q=G,e._i=V,e._m=Vi,e._f=Ii,e._k=Zi,e._b=Gi,e._v=ce,e._e=ge,e._u=Li,e._g=_i,e._d=xi,e._p=Ui}function wi(e,i){if(!e||!e.length)return{};for(var n={},a=0,r=e.length;a<r;a++){var l=e[a],t=l.data;if(t&&t.attrs&&t.attrs.slot&&delete t.attrs.slot,l.context!==i&&l.fnContext!==i||!t||null==t.slot)(n.default||(n.default=[])).push(l);else{var d=t.slot,m=n[d]||(n[d]=[]);"template"===l.tag?m.push.apply(m,l.children||[]):m.push(l)}}for(var s in n)n[s].every($i)&&delete n[s];return n}function $i(e){return e.isComment&&!e.asyncFactory||" "===e.text}function Ji(e){return e.isComment&&e.asyncFactory}function Xi(e,i,n,r){var l,t=Object.keys(n).length>0,d=i?!!i.$stable:!t,m=i&&i.$key;if(i){if(i._normalized)return i._normalized;if(d&&r&&r!==a&&m===r.$key&&!t&&!r.$hasNormal)return r;for(var s in l={},i)i[s]&&"$"!==s[0]&&(l[s]=Wi(e,n,s,i[s]))}else l={};for(var u in n)u in l||(l[u]=qi(n,u));return i&&Object.isExtensible(i)&&(i._normalized=l),j(l,"$stable",d),j(l,"$key",m),j(l,"$hasNormal",t),l}function Wi(e,i,n,a){var l=function(){var i=ke;ye(e);var n=arguments.length?a.apply(null,arguments):a({}),l=(n=n&&"object"==typeof n&&!r(n)?[n]:Ni(n))&&n[0];return ye(i),n&&(!l||1===n.length&&l.isComment&&!Ji(l))?void 0:n};return a.proxy&&Object.defineProperty(i,n,{get:l,enumerable:!0,configurable:!0}),l}function qi(e,i){return function(){return e[i]}}function Qi(e){return{get attrs(){if(!e._attrsProxy){var i=e._attrsProxy={};j(i,"_v_attr_proxy",!0),en(i,e.$attrs,a,e,"$attrs")}return e._attrsProxy},get listeners(){e._listenersProxy||en(e._listenersProxy={},e.$listeners,a,e,"$listeners");return e._listenersProxy},get slots(){return function(e){e._slotsProxy||an(e._slotsProxy={},e.$scopedSlots);return e._slotsProxy}(e)}

vendor: 21,517 bytes, line 7

7,emit:N(e.$emit,e),expose:function(i){i&&Object.keys(i).forEach((function(n){return Qe(e,i,n)}))}}}function en(e,i,n,a,r){var l=!1;for(var t in i)t in e?i[t]!==n[t]&&(l=!0):(l=!0,nn(e,t,a,r));for(var t in e)t in i||(l=!0,delete e[t]);return l}function nn(e,i,n,a){Object.defineProperty(e,i,{enumerable:!0,configurable:!0,get:function(){return n[a][i]}})}function an(e,i){for(var n in i)e[n]=i[n];for(var n in e)n in i||delete e[n]}function rn(){return dn().slots}function ln(){return dn().attrs}function tn(){return dn().listeners}function dn(){var e=ke;return e._setupContext||(e._setupContext=Qi(e))}function mn(e,i){var n=r(e)?e.reduce((function(e,i){return e[i]={},e}),{}):e;for(var a in i){var l=n[a];l?r(l)||s(l)?n[a]={type:l,default:i[a]}:l.default=i[a]:null===l&&(n[a]={default:i[a]})}return n}var sn=null;function un(e,i){return(e.__esModule||ue&&"Module"===e[Symbol.toStringTag])&&(e=e.default),u(e)?i.extend(e):e}function kn(e){if(r(e))for(var i=0;i<e.length;i++){var n=e[i];if(t(n)&&(t(n.componentOptions)||Ji(n)))return n}}function on(e,i,n,a,k,o){return(r(n)||m(n))&&(k=a,a=n,n=void 0),d(o)&&(k=2),function(e,i,n,a,m){if(t(n)&&t(n.__ob__))return ge();t(n)&&t(n.is)&&(i=n.is);if(!i)return ge();0;r(a)&&s(a[0])&&((n=n||{}).scopedSlots={default:a[0]},a.length=0);2===m?a=Ni(a):1===m&&(a=function(e){for(var i=0;i<e.length;i++)if(r(e[i]))return Array.prototype.concat.apply([],e);return e}(a));var k,o;if("string"==typeof i){var y=void 0;o=e.$vnode&&e.$vnode.ns||L.getTagNamespace(i),k=L.isReservedTag(i)?new be(L.parsePlatformTagName(i),n,a,void 0,void 0,e):n&&n.pre||!t(y=Za(e.$options,"components",i))?new be(i,n,a,void 0,void 0,e):fa(y,n,e,a,i)}else k=fa(i,n,e,a);return r(k)?k:t(k)?(t(o)&&function e(i,n,a){i.ns=n,"foreignObject"===i.tag&&(n=void 0,a=!0);if(t(i.children))for(var r=0,m=i.children.length;r<m;r++){var s=i.children[r];t(s.tag)&&(l(s.ns)||d(a)&&"svg"!==s.tag)&&e(s,n,a)}}(k,o),t(n)&&function(e){u(e.style)&&$n(e.style);u(e.class)&&$n(e.class)}(n),k):ge()}(e,i,n,a,k)}function yn(e,i,n){return on(ke,e,i,n,2,!0)}function bn(e,i,n){Ke();try{if(i)for(var a=i;a=a.$parent;){var r=a.$options.errorCaptured;if(r)for(var l=0;l<r.length;l++)try{if(!1===r[l].call(a,e,i,n))return}catch(e){cn(e,a,"errorCaptured hook")}}cn(e,i,n)}finally{ve()}}function gn(e,i,n,a,r){var l;try{(l=n?e.apply(i,n):e.call(i))&&!l._isVue&&g(l)&&!l._handled&&(l.catch((function(e){return bn(e,a,r+" (Promise/async)")})),l._handled=!0)}catch(e){bn(e,a,r)}return l}function cn(e,i,n){if(L.errorHandler)try{return L.errorHandler.call(null,e,i,n)}catch(i){i!==e&&Hn(i,null,"config.errorHandler")}Hn(e,i,n)}function Hn(e,i,n){if(!J||"undefined"==typeof console)throw e;console.error(e)}var pn,Sn=!1,zn=[],hn=!1;function Kn(){hn=!1;var e=zn.slice(0);zn.length=0;for(var i=0;i<e.length;i++)e[i]()}if("undefined"!=typeof Promise&&me(Promise)){var vn=Promise.resolve();pn=function(){vn.then(Kn),ee&&setTimeout(I)},Sn=!0}else if(W||"undefined"==typeof MutationObserver||!me(MutationObserver)&&"[object MutationObserverConstructor]"!==MutationObserver.toString())pn="undefined"!=typeof setImmediate&&me(setImmediate)?function(){setImmediate(Kn)}:function(){setTimeout(Kn,0)};else{var An=1,Tn=new MutationObserver(Kn),fn=document.createTextNode(String(An));Tn.observe(fn,{characterData:!0}),pn=function(){An=(An+1)%2,fn.data=String(An)},Sn=!0}function Bn(e,i){var n;if(zn.push((function(){if(e)try{e.call(i)}catch(e){bn(e,i,"nextTick")}else n&&n(i)})),hn||(hn=!0,pn()),!e&&"undefined"!=typeof Promise)return new Promise((function(e){n=e}))}function Rn(e){if(void 0===e&&(e="$style"),!ke)return a;var i=ke[e];return i||a}function Yn(e){if(J){var i=ke;i&&oi((function(){var n=i.$el,a=e(i,i._setupProxy);if(n&&1===n.nodeType){var r=n.style;for(var l in a)r.setProperty("--".concat(l),a[l])}}))}}function Nn(e){s(e)&&(e={loader:e});var i=e.loader,n=e.loadingComponent,a=e.errorComponent,r=e.delay,l=void 0===r?200:r,t=e.timeout,d=(e.suspensible,e.onError);var m=null,u=0,k=function(){var e;return m||(e=m=i().catch((function(e){if(e=e instanceof Error?e:new Error(String(e)),d)return new Promise((function(i,n){d(e,(function(){return i((u++,m=null,k()))}),(function(){return n(e)}),u+1)}));throw e})).then((function(i){return e!==m&&m?m:(i&&(i.__esModule||"Module"===i[Symbol.toStringTag])&&(i=i.default),i)})))};return function(){return{component:k(),delay:l,timeout:t,error:a,loading:n}}}function Pn(e){return function(i,n){if(void 0===n&&(n=ke),n)return function(e,i,n){var a=e.$options;a[i]=Oa(a[i],n)}(n,e,i)}}var On=Pn("beforeMount"),Dn=Pn("mounted"),In=Pn("beforeUpdate"),En=Pn("updated"),Zn=Pn("beforeDestroy"),Gn=Pn("destroyed"),Vn=Pn("activated"),Cn=Pn("deactivated"),Mn=Pn("serverPrefetch"),Fn=Pn("renderTracked"),_n=Pn("renderTriggered"),Ln=Pn("errorCaptured");function xn(e,i){void 0===i&&(i=ke),Ln(e,i)}var Un="2.7.16";function jn(e){return e}var wn=new se;function $n(e){return function e(i,n){var a,l,t=r(i);if(!t&&!u(i)||i.__v_skip||Object.isFrozen(i)||i instanceof be)return;if(i.__ob__){var d=i.__ob__.dep.id;if(n.has(d))return;n.add(d)}if(t)for(a=i.length;a--;)e(i[a],n);else if(je(i))e(i.value,n);else for(l=Object.keys(i),a=l.length;a--;)e(i[l[a]],n)}(e,wn),wn.clear(),e}var Jn,Xn=0,Wn=function(){function e(e,i,n,a,r){var l,t;l=this,void 0===(t=bi&&!bi._vm?bi:e?e._scope:void 0)&&(t=bi),t&&t.active&&t.effects.push(l),(this.vm=e)&&r&&(e._watcher=this),a?(this.deep=!!a.deep,this.user=!!a.user,this.lazy=!!a.lazy,this.sync=!!a.sync,this.before=a.before):this.deep=this.user=this.lazy=this.sync=!1,this.cb=n,this.id=++Xn,this.active=!0,this.post=!1,this.dirty=this.lazy,this.deps=[],this.newDeps=[],this.depIds=new se,this.newDepIds=new se,this.expression="",s(i)?this.getter=i:(this.getter=function(e){if(!w.test(e)){var i=e.split(".");return function(e){for(var n=0;n<i.length;n++){if(!e)return;e=e[i[n]]}return e}}}(i),this.getter||(this.getter=I)),this.value=this.lazy?void 0:this.get()}return e.prototype.get=function(){var e;Ke(this);var i=this.vm;try{e=this.getter.call(i,i)}catch(e){if(!this.user)throw e;bn(e,i,'getter for watcher "'.concat(this.expression,'"'))}finally{this.deep&&$n(e),ve(),this.cleanupDeps()}return e},e.prototype.addDep=function(e){var i=e.id;this.newDepIds.has(i)||(this.newDepIds.add(i),this.newDeps.push(e),this.depIds.has(i)||e.addSub(this))},e.prototype.cleanupDeps=function(){for(var e=this.deps.length;e--;){var i=this.deps[e];this.newDepIds.has(i.id)||i.removeSub(this)}var n=this.depIds;this.depIds=this.newDepIds,this.newDepIds=n,this.newDepIds.clear(),n=this.deps,this.deps=this.newDeps,this.newDeps=n,this.newDeps.length=0},e.prototype.update=function(){this.lazy?this.dirty=!0:this.sync?this.run():pa(this)},e.prototype.run=function(){if(this.active){var e=this.get();if(e!==this.value||u(e)||this.deep){var i=this.value;if(this.value=e,this.user){var n='callback for watcher "'.concat(this.expression,'"');gn(this.cb,this.vm,[e,i],this.vm,n)}else this.cb.call(this.vm,e,i)}}},e.prototype.evaluate=function(){this.value=this.get(),this.dirty=!1},e.prototype.depend=function(){for(var e=this.deps.length;e--;)this.deps[e].depend()},e.prototype.teardown=function(){if(this.vm&&!this.vm._isBeingDestroyed&&h(this.vm._scope.effects,this),this.active){for(var e=this.deps.length;e--;)this.deps[e].removeSub(this);this.active=!1,this.onStop&&this.onStop()}},e}();function qn(e,i){Jn.$on(e,i)}function Qn(e,i){Jn.$off(e,i)}function ea(e,i){var n=Jn;return function a(){var r=i.apply(null,arguments);null!==r&&n.$off(e,a)}}function ia(e,i,n){Jn=e,Bi(i,n||{},qn,Qn,ea,e),Jn=void 0}var na=null;function aa(e){var i=na;return na=e,function(){na=i}}function ra(e){for(;e&&(e=e.$parent);)if(e._inactive)return!0;return!1}function la(e,i){if(i){if(e._directInactive=!1,ra(e))return}else if(e._directInactive)return;if(e._inactive||null===e._inactive){e._inactive=!1;for(var n=0;n<e.$children.length;n++)la(e.$children[n]);ta(e,"activated")}}function ta(e,i,n,a){void 0===a&&(a=!0),Ke();var r=ke,l=zi();a&&ye(e);var t=e.$options[i],d="".concat(i," hook");if(t)for(var m=0,s=t.length;m<s;m++)gn(t[m],e,n||null,e,d);e._hasHookEvent&&e.$emit("hook:"+i),a&&(ye(r),l&&l.on()),ve()}var da=[],ma=[],sa={},ua=!1,ka=!1,oa=0;var ya=0,ba=Date.now;if(J&&!W){var ga=window.performance;ga&&"function"==typeof ga.now&&ba()>document.createEvent("Event").timeStamp&&(ba=function(){return ga.now()})}var ca=function(e,i){if(e.post){if(!i.post)return 1}else if(i.post)return-1;return e.id-i.id};function Ha(){var e,i;for(ya=ba(),ka=!0,da.sort(ca),oa=0;oa<da.length;oa++)(e=da[oa]).before&&e.before(),i=e.id,sa[i]=null,e.run();var n=ma.slice(),a=da.slice();oa=da.length=ma.length=0,sa={},ua=ka=!1,function(e){for(var i=0;i<e.length;i++)e[i]._inactive=!0,la(e[i],!0)}(n),function(e){var i=e.length;for(;i--;){var n=e[i],a=n.vm;a&&a._watcher===n&&a._isMounted&&!a._isDestroyed&&ta(a,"updated")}}(a),function(){for(var e=0;e<Se.length;e++){var i=Se[e];i.subs=i.subs.filter((function(e){return e})),i._pending=!1}Se.length=0}(),de&&L.devtools&&de.emit("flush")}function pa(e){var i=e.id;if(null==sa[i]&&(e!==ze.target||!e.noRecurse)){if(sa[i]=!0,ka){for(var n=da.length-1;n>oa&&da[n].id>e.id;)n--;da.splice(n+1,0,e)}else da.push(e);ua||(ua=!0,Bn(Ha))}}function Sa(e,i){if(e){for(var n=Object.create(null),a=ue?Reflect.ownKeys(e):Object.keys(e),r=0;r<a.length;r++){var l=a[r];if("__ob__"!==l){var t=e[l].from;if(t in i._provided)n[l]=i._provided[t];else if("default"in e[l]){var d=e[l].default;n[l]=s(d)?d.call(i):d}else 0}}return n}}function za(e,i,n,l,t){var m,s=this,u=t.options;v(l,"_uid")?(m=Object.create(l))._original=l:(m=l,l=l._original);var k=d(u._compiled),o=!k;this.data=e,this.props=i,this.children=n,this.parent=l,this.listeners=e.on||a,this.injections=Sa(u.inject,l),this.slots=function(){return s.$slots||Xi(l,e.scopedSlots,s.$slots=wi(n,l)),s.$slots},Object.defineProperty(this,"scopedSlots",{enumerable:!0,get:function(){return Xi(l,e.scopedSlots,this.slots())}}),k&&(this.$options=u,this.$slots=this.slots(),this.$scopedSlots=Xi(l,e.scopedSlots,this.$slots)),u._scopeId?this._c=function(e,i,n,a){var t=on(m,e,i,n,a,o);return t&&!r(t)&&(t.fnScopeId=u._scopeId,t.fnContext=l),t}:this._c=function(e,i,n,a){return on(m,e,i,n,a,o)}}function ha(e,i,n,a,r){var l=He(e);return l.fnContext=n,l.fnOptions=a,i.slot&&((l.data||(l.data={})).slot=i.slot),l}function Ka(e,i){for(var n in i)e[f(n)]=i[n]}function va(e){return e.name||e.__name||e._componentTag}ji(za.prototype);var Aa={init:function(e,i){if(e.componentInstance&&!e.componentInstance._isDestroyed&&e.data.keepAlive){var n=e;Aa.prepatch(n,n)}else{(e.componentInstance=function(e,i){var n={_isComponent:!0,_parentVnode:e,parent:i},a=e.data.inlineTemplate;t(a)&&(n.render=a.render,n.staticRenderFns=a.staticRenderFns);return new e.componentOptions.Ctor(n)}(e,na)).$mount(i?e.elm:void 0,i)}},prepatch:function(e,i){var n=i.componentOptions;!function(e,i,n,r,l){var t=r.data.scopedSlots,d=e.$scopedSlots,m=!!(t&&!t.$stable||d!==a&&!d.$stable||t&&e.$scopedSlots.$key!==t.$key||!t&&e.$scopedSlots.$key),s=!!(l||e.$options._renderChildren||m),u=e.$vnode;e.$options._parentVnode=r,e.$vnode=r,e._vnode&&(e._vnode.parent=r),e.$options._renderChildren=l;var k=r.data.attrs||a;e._attrsProxy&&en(e._attrsProxy,k,u.data&&u.data.attrs||a,e,"$attrs")&&(s=!0),e.$attrs=k,n=n||a;var o=e.$options._parentListeners;if(e._listenersProxy&&en(e._listenersProxy,n,o||a,e,"$listeners"),e.$listeners=e.$options._parentListeners=n,ia(e,n,o),i&&e.$options.props){Ye(!1);for(var y=e._props,b=e.$options._propKeys||[],g=0;g<b.length;g++){var c=b[g],H=e.$options.props;y[c]=Ga(c,H,i,e)}Ye(!0),e.$options.propsData=i}s&&(e.$slots=wi(l,r.context),e.$forceUpdate())}(i.componentInstance=e.componentInstance,n.propsData,n.listeners,i,n.children)},insert:function(e){var i,n=e.context,a=e.componentInstance;a._isMounted||(a._isMounted=!0,ta(a,"mounted")),e.data.keepAlive&&(n._isMounted?((i=a)._inactive=!1,ma.push(i)):la(a,!0))},destroy:function(e){var i=e.componentInstance;i._isDestroyed||(e.data.keepAlive?function e(i,n){if(!(n&&(i._directInactive=!0,ra(i))||i._inactive)){i._inactive=!0;for(var a=0;a<i.$children.length;a++)e(i.$children[a]);ta(i,"deactivated")}}(i,!0):i.$destroy())}},Ta=Object.keys(Aa);function fa(e,i,n,m,s){if(!l(e)){var k=n.$options._base;if(u(e)&&(e=k.extend(e)),"function"==typeof e){var o;if(l(e.cid)&&void 0===(e=function(e,i){if(d(e.error)&&t(e.errorComp))return e.errorComp;if(t(e.resolved))return e.resolved;var n=sn;if(n&&t(e.owners)&&-1===e.owners.indexOf(n)&&e.owners.push(n),d(e.loading)&&t(e.loadingComp))return e.loadingComp;if(n&&!t(e.owners)){var a=e.owners=[n],r=!0,m=null,s=null;n.$on("hook:destroyed",(function(){return h(a,n)}));var k=function(e){for(var i=0,n=a.length;i<n;i++)a[i].$forceUpdate();e&&(a.length=0,null!==m&&(clearTimeout(m),m=null),null!==s&&(clearTimeout(s),s=null))},o=C((function(n){e.resolved=un(n,i),r?a.length=0:k(!0)})),y=C((function(i){t(e.errorComp)&&(e.error=!0,k(!0))})),b=e(o,y);return u(b)&&(g(b)?l(e.resolved)&&b.then(o,y):g(b.component)&&(b.component.then(o,y),t(b.error)&&(e.errorComp=un(b.error,i)),t(b.loading)&&(e.loadingComp=un(b.loading,i),0===b.delay?e.loading=!0:m=setTimeout((function(){m=null,l(e.resolved)&&l(e.error)&&(e.loading=!0,k(!1))}),b.delay||200)),t(b.timeout)&&(s=setTimeout((function(){s=null,l(e.resolved)&&y(null)}),b.timeout)))),r=!1,e.loading?e.loadingComp:e.resolved}}(o=e,k)))return function(e,i,n,a,r){var l=ge();return l.asyncFactory=e,l.asyncMeta={data:i,context:n,children:a,tag:r},l}(o,i,n,m,s);i=i||{},Wa(e),t(i.model)&&function(e,i){var n=e.model&&e.model.prop||"value",a=e.model&&e.model.event||"input";(i.attrs||(i.attrs={}))[n]=i.model.value;var l=i.on||(i.on={}),d=l[a],m=i.model.callback;t(d)?(r(d)?-1===d.indexOf(m):d!==m)&&(l[a]=[m].concat(d)):l[a]=m}(e.options,i);var y=function(e,i,n){var a=i.options.props;if(!l(a)){var r={},d=e.attrs,m=e.props;if(t(d)||t(m))for(var s in a){var u=Y(s);Yi(r,m,s,u,!0)||Yi(r,d,s,u,!1)}return r}}(i,e);if(d(e.options.functional))return function(e,i,n,l,d){var m=e.options,s={},u=m.props;if(t(u))for(var k in u)s[k]=Ga(k,u,i||a);else t(n.attrs)&&Ka(s,n.attrs),t(n.props)&&Ka(s,n.props);var o=new za(n,s,d,l,e),y=m.render.call(null,o._c,o);if(y instanceof be)return ha(y,n,o.parent,m,o);if(r(y)){for(var b=Ni(y)||[],g=new Array(b.length),c=0;c<b.length;c++)g[c]=ha(b[c],n,o.parent,m,o);return g}}(e,y,i,n,m);var b=i.on;if(i.on=i.nativeOn,d(e.options.abstract)){var c=i.slot;i={},c&&(i.slot=c)}!function(e){for(var i=e.hook||(e.hook={}),n=0;n<Ta.length;n++){var a=Ta[n],r=i[a],l=Aa[a];r===l||r&&r._merged||(i[a]=r?Ba(l,r):l)}}(i);var H=va(e.options)||s;return new be("vue-component-".concat(e.cid).concat(H?"-".concat(H):""),i,void 0,void 0,void 0,n,{Ctor:e,propsData:y,listeners:b,tag:s,children:m},o)}}}function Ba(e,i){var n=function(n,a){e(n,a),i(n,a)};return n._merged=!0,n}var Ra=I,Ya=L.optionMergeStrategies;function Na(e,i,n){if(void 0===n&&(n=!0),!i)return e;for(var a,r,l,t=ue?Reflect.ownKeys(i):Object.keys(i),d=0;d<t.length;d++)"__ob__"!==(a=t[d])&&(r=e[a],l=i[a],n&&v(e,a)?r!==l&&o(r)&&o(l)&&Na(r,l):Ie(e,a,l));return e}function Pa(e,i,n){return n?function(){var a=s(i)?i.call(n,n):i,r=s(e)?e.call(n,n):e;return a?Na(a,r):r}:i?e?function(){return Na(s(i)?i.call(this,this):i,s(e)?e.call(this,this):e)}:i:e}function Oa(e,i){var n=i?e?e.concat(i):r(i)?i:[i]:e;return n?function(e){for(var i=[],n=0;n<e.length;n++)-1===i.indexOf(e[n])&&i.push(e[n]);return i}(n):n}function Da(e,i,n,a){var r=Object.create(e||null);return i?O(r,i):r}Ya.data=function(e,i,n){return n?Pa(e,i,n):i&&"function"!=typeof i?e:Pa(e,i)},_.forEach((function(e){Ya[e]=Oa})),F.forEach((function(e){Ya[e+"s"]=Da})),Ya.watch=function(e,i,n,a){if(e===ae&&(e=void 0),i===ae&&(i=void 0),!i)return Object.create(e||null);if(!e)return i;var l={};for(var t in O(l,e),i){var d=l[t],m=i[t];d&&!r(d)&&(d=[d]),l[t]=d?d.concat(m):r(m)?m:[m]}return l},Ya.props=Ya.methods=Ya.inject=Ya.computed=function(e,i,n,a){if(!e)return i;var r=Object.create(null);return O(r,e),i&&O(r,i),r},Ya.provide=function(e,i){return e?function(){var n=Object.create(null);return Na(n,s(e)?e.call(this):e),i&&Na(n,s(i)?i.call(this):i,!1),n}:i};var Ia=function(e,i){return void 0===i?e:i};function Ea(e,i,n){if(s(i)&&(i=i.options),function(e,i){var n=e.props;if(n){var a,l,t={};if(r(n))for(a=n.length;a--;)"string"==typeof(l=n[a])&&(t[f(l)]={type:null});else if(o(n))for(var d in n)l=n[d],t[f(d)]=o(l)?l:{type:l};else 0;e.props=t}}(i),function(e,i){var n=e.inject;if(n){var a=e.inject={};if(r(n))for(var l=0;l<n.length;l++)a[n[l]]={from:n[l]};else if(o(n))for(var t in n){var d=n[t];a[t]=o(d)?O({from:t},d):{from:d}}else 0}}(i),function(e){var i=e.directives;if(i)for(var n in i){var a=i[n];s(a)&&(i[n]={bind:a,update:a})}}(i),!i._base&&(i.extends&&(e=Ea(e,i.extends,n)),i.mixins))for(var a=0,l=i.mixins.length;a<l;a++)e=Ea(e,i.mixins[a],n);var t,d={};for(t in e)m(t);for(t in i)v(e,t)||m(t);function m(a){var r=Ya[a]||Ia;d[a]=r(e[a],i[a],n,a)}return d}function Za(e,i,n,a){if("string"==typeof n){var r=e[i];if(v(r,n))return r[n];var l=f(n);if(v(r,l))return r[l];var t=B(l);return v(r,t)?r[t]:r[n]||r[l]||r[t]}}function Ga(e,i,n,a){var r=i[e],l=!v(n,e),t=n[e],d=Fa(Boolean,r.type);if(d>-1)if(l&&!v(r,"default"))t=!1;else if(""===t||t===Y(e)){var m=Fa(String,r.type);(m<0||d<m)&&(t=!0)}if(void 0===t){t=function(e,i,n){if(!v(i,"default"))return;var a=i.default;0;if(e&&e.$options.propsData&&void 0===e.$options.propsData[n]&&void 0!==e._props[n])return e._props[n];return s(a)&&"Function"!==Ca(i.type)?a.call(e):a}(a,r,e);var u=Re;Ye(!0),Oe(t),Ye(u)}return t}var Va=/^\s*function (\w+)/;function Ca(e){var i=e&&e.toString().match(Va);return i?i[1]:""}function Ma(e,i){return Ca(e)===Ca(i)}function Fa(e,i){if(!r(i))return Ma(i,e)?0:-1;for(var n=0,a=i.length;n<a;n++)if(Ma(i[n],e))return n;return-1}var _a={enumerable:!0,configurable:!0,get:I,set:I};function La(e,i,n){_a.get=function(){return this[i][n]},_a.set=function(e){this[i][n]=e},Object.defineProperty(e,n,_a)}function xa(e){var i=e.$options;if(i.props&&function(e,i){var n=e.$options.propsData||{},a=e._props=Ve({}),r=e.$options._propKeys=[];e.$parent&&Ye(!1);var l=function(l){r.push(l);var t=Ga(l,i,n,e);De(a,l,t,void 0,!0),l in e||La(e,"_props",l)};for(var t in i)l(t);Ye(!0)}(e,i.props),function(e){var i=e.$options,n=i.setup;if(n){var a=e._setupContext=Qi(e);ye(e),Ke();var r=gn(n,null,[e._props||Ve({}),a],e,"setup");if(ve(),ye(),s(r))i.render=r;else if(u(r))if(e._setupState=r,r.__sfc){var l=e._setupProxy={};for(var t in r)"__sfc"!==t&&Qe(l,r,t)}else for(var t in r)U(t)||Qe(e,r,t);else 0}}(e),i.methods&&function(e,i){e.$options.props;for(var n in i)e[n]="function"!=typeof i[n]?I:N(i[n],e)}(e,i.methods),i.data)!function(e){var i=e.$options.data;o(i=e._data=s(i)?function(e,i){Ke();try{return e.call(i,i)}catch(e){return bn(e,i,"data()"),{}}finally{ve()}}(i,e):i||{})||(i={});var n=Object.keys(i),a=e.$options.props,r=(e.$options.methods,n.length);for(;r--;){var l=n[r];0,a&&v(a,l)||U(l)||La(e,"_data",l)}var t=Oe(i);t&&t.vmCount++}(e);else{var n=Oe(e._data={});n&&n.vmCount++}i.computed&&function(e,i){var n=e._computedWatchers=Object.create(null),a=te();for(var r in i){var l=i[r],t=s(l)?l:l.get;0,a||(n[r]=new Wn(e,t||I,I,Ua)),r in e||ja(e,r,l)}}(e,i.computed),i.watch&&i.watch!==ae&&function(e,i){for(var n in i){var a=i[n];if(r(a))for(var l=0;l<a.length;l++)Ja(e,n,a[l]);else Ja(e,n,a)}}(e,i.watch)}var Ua={lazy:!0};function ja(e,i,n){var a=!te();s(n)?(_a.get=a?wa(i):$a(n),_a.set=I):(_a.get=n.get?a&&!1!==n.cache?wa(i):$a(n.get):I,_a.set=n.set||I),Object.defineProperty(e,i,_a)}function wa(e){return function(){var i=this._computedWatchers&&this._computedWatchers[e];if(i)return i.dirty&&i.evaluate(),ze.target&&i.depend(),i.value}}function $a(e){return function(){return e.call(this,this)}}function Ja(e,i,n,a){return o(n)&&(a=n,n=n.handler),"string"==typeof n&&(n=e[n]),e.$watch(i,n,a)}var Xa=0;function Wa(e){var i=e.options;if(e.super){var n=Wa(e.super);if(n!==e.superOptions){e.superOptions=n;var a=function(e){var i,n=e.options,a=e.sealedOptions;for(var r in n)n[r]!==a[r]&&(i||(i={}),i[r]=n[r]);return i}(e);a&&O(e.extendOptions,a),(i=e.options=Ea(n,e.extendOptions)).name&&(i.components[i.name]=e)}}return i}function qa(e){this._init(e)}function Qa(e){e.cid=0;var i=1;e.extend=function(e){e=e||{};var n=this,a=n.cid,r=e._Ctor||(e._Ctor={});if(r[a])return r[a];var l=va(e)||va(n.options);var t=function(e){this._init(e)};return(t.prototype=Object.create(n.prototype)).constructor=t,t.cid=i++,t.options=Ea(n.options,e),t.super=n,t.options.props&&function(e){var i=e.options.props;for(var n in i)La(e.prototype,"_props",n)}(t),t.options.computed&&function(e){var i=e.options.computed;for(var n in i)ja(e.prototype,n,i[n])}(t),t.extend=n.extend,t.mixin=n.mixin,t.use=n.use,F.forEach((function(e){t[e]=n[e]})),l&&(t.options.components[l]=t),t.superOptions=n.options,t.extendOptions=e,t.sealedOptions=O({},t.options),r[a]=t,t}}function er(e){return e&&(va(e.Ctor.options)||e.tag)}function ir(e,i){return r(e)?e.indexOf(i)>-1:"string"==typeof e?e.split(",").indexOf(i)>-1:!!y(e)&&e.test(i)}function nr(e,i){var n=e.cache,a=e.keys,r=e._vnode,l=e.$vnode;for(var t in n){var d=n[t];if(d){var m=d.name;m&&!i(m)&&ar(n,t,a,r)}}l.componentOptions.children=void 0}function ar(e,i,n,a){var r=e[i];!r||a&&r.tag===a.tag||r.componentInstance.$destroy(),e[i]=null,h(n,i)}!function(e){e.prototype._init=function(e){var i=this;i._uid=Xa++,i._isVue=!0,i.__v_skip=!0,i._scope=new pi(!0),i._scope.parent=void 0,i._scope._vm=!0,e&&e._isComponent?function(e,i){var n=e.$options=Object.create(e.constructor.options),a=i._parentVnode;

vendor: 1,248 bytes, line 7

7n.parent=i.parent,n._parentVnode=a;var r=a.componentOptions;n.propsData=r.propsData,n._parentListeners=r.listeners,n._renderChildren=r.children,n._componentTag=r.tag,i.render&&(n.render=i.render,n.staticRenderFns=i.staticRenderFns)}(i,e):i.$options=Ea(Wa(i.constructor),e||{},i),i._renderProxy=i,i._self=i,function(e){var i=e.$options,n=i.parent;if(n&&!i.abstract){for(;n.$options.abstract&&n.$parent;)n=n.$parent;n.$children.push(e)}e.$parent=n,e.$root=n?n.$root:e,e.$children=[],e.$refs={},e._provided=n?n._provided:Object.create(null),e._watcher=null,e._inactive=null,e._directInactive=!1,e._isMounted=!1,e._isDestroyed=!1,e._isBeingDestroyed=!1}(i),function(e){e._events=Object.create(null),e._hasHookEvent=!1;var i=e.$options._parentListeners;i&&ia(e,i)}(i),function(e){e._vnode=null,e._staticTrees=null;var i=e.$options,n=e.$vnode=i._parentVnode,r=n&&n.context;e.$slots=wi(i._renderChildren,r),e.$scopedSlots=n?Xi(e.$parent,n.data.scopedSlots,e.$slots):a,e._c=function(i,n,a,r){return on(e,i,n,a,r,!1)},e.$createElement=function(i,n,a,r){return on(e,i,n,a,r,!0)};var l=n&&n.data;De(e,"$attrs",l&&l.attrs||a,null,!0),De(e,"$listeners",i._parentListeners||a,null,!0)}(i),ta(i,"beforeCreate",void 0,!1),function(e){var i=Sa(e.$options.inject,e);

vendor: 31,835 bytes, line 7

7i&&(Ye(!1),Object.keys(i).forEach((function(n){De(e,n,i[n])})),Ye(!0))}(i),xa(i),function(e){var i=e.$options.provide;if(i){var n=s(i)?i.call(e):i;if(!u(n))return;for(var a=vi(e),r=ue?Reflect.ownKeys(n):Object.keys(n),l=0;l<r.length;l++){var t=r[l];Object.defineProperty(a,t,Object.getOwnPropertyDescriptor(n,t))}}}(i),ta(i,"created"),i.$options.el&&i.$mount(i.$options.el)}}(qa),function(e){var i={get:function(){return this._data}},n={get:function(){return this._props}};Object.defineProperty(e.prototype,"$data",i),Object.defineProperty(e.prototype,"$props",n),e.prototype.$set=Ie,e.prototype.$delete=Ee,e.prototype.$watch=function(e,i,n){if(o(i))return Ja(this,e,i,n);(n=n||{}).user=!0;var a=new Wn(this,e,i,n);if(n.immediate){var r='callback for immediate watcher "'.concat(a.expression,'"');Ke(),gn(i,this,[a.value],this,r),ve()}return function(){a.teardown()}}}(qa),function(e){var i=/^hook:/;e.prototype.$on=function(e,n){var a=this;if(r(e))for(var l=0,t=e.length;l<t;l++)a.$on(e[l],n);else(a._events[e]||(a._events[e]=[])).push(n),i.test(e)&&(a._hasHookEvent=!0);return a},e.prototype.$once=function(e,i){var n=this;function a(){n.$off(e,a),i.apply(n,arguments)}return a.fn=i,n.$on(e,a),n},e.prototype.$off=function(e,i){var n=this;if(!arguments.length)return n._events=Object.create(null),n;if(r(e)){for(var a=0,l=e.length;a<l;a++)n.$off(e[a],i);return n}var t,d=n._events[e];if(!d)return n;if(!i)return n._events[e]=null,n;for(var m=d.length;m--;)if((t=d[m])===i||t.fn===i){d.splice(m,1);break}return n},e.prototype.$emit=function(e){var i=this,n=i._events[e];if(n){n=n.length>1?P(n):n;for(var a=P(arguments,1),r='event handler for "'.concat(e,'"'),l=0,t=n.length;l<t;l++)gn(n[l],i,a,i,r)}return i}}(qa),function(e){e.prototype._update=function(e,i){var n=this,a=n.$el,r=n._vnode,l=aa(n);n._vnode=e,n.$el=r?n.__patch__(r,e):n.__patch__(n.$el,e,i,!1),l(),a&&(a.__vue__=null),n.$el&&(n.$el.__vue__=n);for(var t=n;t&&t.$vnode&&t.$parent&&t.$vnode===t.$parent._vnode;)t.$parent.$el=t.$el,t=t.$parent},e.prototype.$forceUpdate=function(){this._watcher&&this._watcher.update()},e.prototype.$destroy=function(){var e=this;if(!e._isBeingDestroyed){ta(e,"beforeDestroy"),e._isBeingDestroyed=!0;var i=e.$parent;!i||i._isBeingDestroyed||e.$options.abstract||h(i.$children,e),e._scope.stop(),e._data.__ob__&&e._data.__ob__.vmCount--,e._isDestroyed=!0,e.__patch__(e._vnode,null),ta(e,"destroyed"),e.$off(),e.$el&&(e.$el.__vue__=null),e.$vnode&&(e.$vnode.parent=null)}}}(qa),function(e){ji(e.prototype),e.prototype.$nextTick=function(e){return Bn(e,this)},e.prototype._render=function(){var e=this,i=e.$options,n=i.render,a=i._parentVnode;a&&e._isMounted&&(e.$scopedSlots=Xi(e.$parent,a.data.scopedSlots,e.$slots,e.$scopedSlots),e._slotsProxy&&an(e._slotsProxy,e.$scopedSlots)),e.$vnode=a;var l,t=ke,d=sn;try{ye(e),sn=e,l=n.call(e._renderProxy,e.$createElement)}catch(i){bn(i,e,"render"),l=e._vnode}finally{sn=d,ye(t)}return r(l)&&1===l.length&&(l=l[0]),l instanceof be||(l=ge()),l.parent=a,l}}(qa);var rr=[String,RegExp,Array],lr={KeepAlive:{name:"keep-alive",abstract:!0,props:{include:rr,exclude:rr,max:[String,Number]},methods:{cacheVNode:function(){var e=this.cache,i=this.keys,n=this.vnodeToCache,a=this.keyToCache;if(n){var r=n.tag,l=n.componentInstance,t=n.componentOptions;e[a]={name:er(t),tag:r,componentInstance:l},i.push(a),this.max&&i.length>parseInt(this.max)&&ar(e,i[0],i,this._vnode),this.vnodeToCache=null}}},created:function(){this.cache=Object.create(null),this.keys=[]},destroyed:function(){for(var e in this.cache)ar(this.cache,e,this.keys)},mounted:function(){var e=this;this.cacheVNode(),this.$watch("include",(function(i){nr(e,(function(e){return ir(i,e)}))})),this.$watch("exclude",(function(i){nr(e,(function(e){return!ir(i,e)}))}))},updated:function(){this.cacheVNode()},render:function(){var e=this.$slots.default,i=kn(e),n=i&&i.componentOptions;if(n){var a=er(n),r=this.include,l=this.exclude;if(r&&(!a||!ir(r,a))||l&&a&&ir(l,a))return i;var t=this.cache,d=this.keys,m=null==i.key?n.Ctor.cid+(n.tag?"::".concat(n.tag):""):i.key;t[m]?(i.componentInstance=t[m].componentInstance,h(d,m),d.push(m)):(this.vnodeToCache=i,this.keyToCache=m),i.data.keepAlive=!0}return i||e&&e[0]}}};!function(e){var i={get:function(){return L}};Object.defineProperty(e,"config",i),e.util={warn:Ra,extend:O,mergeOptions:Ea,defineReactive:De},e.set=Ie,e.delete=Ee,e.nextTick=Bn,e.observable=function(e){return Oe(e),e},e.options=Object.create(null),F.forEach((function(i){e.options[i+"s"]=Object.create(null)})),e.options._base=e,O(e.options.components,lr),function(e){e.use=function(e){var i=this._installedPlugins||(this._installedPlugins=[]);if(i.indexOf(e)>-1)return this;var n=P(arguments,1);return n.unshift(this),s(e.install)?e.install.apply(e,n):s(e)&&e.apply(null,n),i.push(e),this}}(e),function(e){e.mixin=function(e){return this.options=Ea(this.options,e),this}}(e),Qa(e),function(e){F.forEach((function(i){e[i]=function(e,n){return n?("component"===i&&o(n)&&(n.name=n.name||e,n=this.options._base.extend(n)),"directive"===i&&s(n)&&(n={bind:n,update:n}),this.options[i+"s"][e]=n,n):this.options[i+"s"][e]}}))}(e)}(qa),Object.defineProperty(qa.prototype,"$isServer",{get:te}),Object.defineProperty(qa.prototype,"$ssrContext",{get:function(){return this.$vnode&&this.$vnode.ssrContext}}),Object.defineProperty(qa,"FunctionalRenderContext",{value:za}),qa.version=Un;var tr=S("style,class"),dr=S("input,textarea,option,select,progress"),mr=S("contenteditable,draggable,spellcheck"),sr=S("events,caret,typing,plaintext-only"),ur=S("allowfullscreen,async,autofocus,autoplay,checked,compact,controls,declare,default,defaultchecked,defaultmuted,defaultselected,defer,disabled,enabled,formnovalidate,hidden,indeterminate,inert,ismap,itemscope,loop,multiple,muted,nohref,noresize,noshade,novalidate,nowrap,open,pauseonexit,readonly,required,reversed,scoped,seamless,selected,sortable,truespeed,typemustmatch,visible"),kr="http://www.w3.org/1999/xlink",or=function(e){return":"===e.charAt(5)&&"xlink"===e.slice(0,5)},yr=function(e){return or(e)?e.slice(6,e.length):""},br=function(e){return null==e||!1===e};function gr(e){for(var i=e.data,n=e,a=e;t(a.componentInstance);)(a=a.componentInstance._vnode)&&a.data&&(i=cr(a.data,i));for(;t(n=n.parent);)n&&n.data&&(i=cr(i,n.data));return function(e,i){if(t(e)||t(i))return Hr(e,pr(i));return""}(i.staticClass,i.class)}function cr(e,i){return{staticClass:Hr(e.staticClass,i.staticClass),class:t(e.class)?[e.class,i.class]:i.class}}function Hr(e,i){return e?i?e+" "+i:e:i||""}function pr(e){return Array.isArray(e)?function(e){for(var i,n="",a=0,r=e.length;a<r;a++)t(i=pr(e[a]))&&""!==i&&(n&&(n+=" "),n+=i);return n}(e):u(e)?function(e){var i="";for(var n in e)e[n]&&(i&&(i+=" "),i+=n);return i}(e):"string"==typeof e?e:""}var Sr={svg:"http://www.w3.org/2000/svg",math:"http://www.w3.org/1998/Math/MathML"},zr=S("html,body,base,head,link,meta,style,title,address,article,aside,footer,header,h1,h2,h3,h4,h5,h6,hgroup,nav,section,div,dd,dl,dt,figcaption,figure,picture,hr,img,li,main,ol,p,pre,ul,a,b,abbr,bdi,bdo,br,cite,code,data,dfn,em,i,kbd,mark,q,rp,rt,rtc,ruby,s,samp,small,span,strong,sub,sup,time,u,var,wbr,area,audio,map,track,video,embed,object,param,source,canvas,script,noscript,del,ins,caption,col,colgroup,table,thead,tbody,td,th,tr,button,datalist,fieldset,form,input,label,legend,meter,optgroup,option,output,progress,select,textarea,details,dialog,menu,menuitem,summary,content,element,shadow,template,blockquote,iframe,tfoot"),hr=S("svg,animate,circle,clippath,cursor,defs,desc,ellipse,filter,font-face,foreignobject,g,glyph,image,line,marker,mask,missing-glyph,path,pattern,polygon,polyline,rect,switch,symbol,text,textpath,tspan,use,view",!0),Kr=function(e){return zr(e)||hr(e)};var vr=Object.create(null);var Ar=S("text,number,password,search,email,tel,url");var Tr=Object.freeze({__proto__:null,createElement:function(e,i){var n=document.createElement(e);return"select"!==e||i.data&&i.data.attrs&&void 0!==i.data.attrs.multiple&&n.setAttribute("multiple","multiple"),n},createElementNS:function(e,i){return document.createElementNS(Sr[e],i)},createTextNode:function(e){return document.createTextNode(e)},createComment:function(e){return document.createComment(e)},insertBefore:function(e,i,n){e.insertBefore(i,n)},removeChild:function(e,i){e.removeChild(i)},appendChild:function(e,i){e.appendChild(i)},parentNode:function(e){return e.parentNode},nextSibling:function(e){return e.nextSibling},tagName:function(e){return e.tagName},setTextContent:function(e,i){e.textContent=i},setStyleScope:function(e,i){e.setAttribute(i,"")}}),fr={create:function(e,i){Br(i)},update:function(e,i){e.data.ref!==i.data.ref&&(Br(e,!0),Br(i))},destroy:function(e){Br(e,!0)}};function Br(e,i){var n=e.data.ref;if(t(n)){var a=e.context,l=e.componentInstance||e.elm,d=i?null:l,m=i?void 0:l;if(s(n))gn(n,a,[d],a,"template ref function");else{var u=e.data.refInFor,k="string"==typeof n||"number"==typeof n,o=je(n),y=a.$refs;if(k||o)if(u){var b=k?y[n]:n.value;i?r(b)&&h(b,l):r(b)?b.includes(l)||b.push(l):k?(y[n]=[l],Rr(a,n,y[n])):n.value=[l]}else if(k){if(i&&y[n]!==l)return;y[n]=m,Rr(a,n,d)}else if(o){if(i&&n.value!==l)return;n.value=d}else 0}}}function Rr(e,i,n){var a=e._setupState;a&&v(a,i)&&(je(a[i])?a[i].value=n:a[i]=n)}var Yr=new be("",{},[]),Nr=["create","activate","update","remove","destroy"];function Pr(e,i){return e.key===i.key&&e.asyncFactory===i.asyncFactory&&(e.tag===i.tag&&e.isComment===i.isComment&&t(e.data)===t(i.data)&&function(e,i){if("input"!==e.tag)return!0;var n,a=t(n=e.data)&&t(n=n.attrs)&&n.type,r=t(n=i.data)&&t(n=n.attrs)&&n.type;return a===r||Ar(a)&&Ar(r)}(e,i)||d(e.isAsyncPlaceholder)&&l(i.asyncFactory.error))}function Or(e,i,n){var a,r,l={};for(a=i;a<=n;++a)t(r=e[a].key)&&(l[r]=a);return l}var Dr={create:Ir,update:Ir,destroy:function(e){Ir(e,Yr)}};function Ir(e,i){(e.data.directives||i.data.directives)&&function(e,i){var n,a,r,l=e===Yr,t=i===Yr,d=Zr(e.data.directives,e.context),m=Zr(i.data.directives,i.context),s=[],u=[];for(n in m)a=d[n],r=m[n],a?(r.oldValue=a.value,r.oldArg=a.arg,Vr(r,"update",i,e),r.def&&r.def.componentUpdated&&u.push(r)):(Vr(r,"bind",i,e),r.def&&r.def.inserted&&s.push(r));if(s.length){var k=function(){for(var n=0;n<s.length;n++)Vr(s[n],"inserted",i,e)};l?Ri(i,"insert",k):k()}u.length&&Ri(i,"postpatch",(function(){for(var n=0;n<u.length;n++)Vr(u[n],"componentUpdated",i,e)}));if(!l)for(n in d)m[n]||Vr(d[n],"unbind",e,e,t)}(e,i)}var Er=Object.create(null);function Zr(e,i){var n,a,r=Object.create(null);if(!e)return r;for(n=0;n<e.length;n++){if((a=e[n]).modifiers||(a.modifiers=Er),r[Gr(a)]=a,i._setupState&&i._setupState.__sfc){var l=a.def||Za(i,"_setupState","v-"+a.name);a.def="function"==typeof l?{bind:l,update:l}:l}a.def=a.def||Za(i.$options,"directives",a.name)}return r}function Gr(e){return e.rawName||"".concat(e.name,".").concat(Object.keys(e.modifiers||{}).join("."))}function Vr(e,i,n,a,r){var l=e.def&&e.def[i];if(l)try{l(n.elm,e,n,a,r)}catch(a){bn(a,n.context,"directive ".concat(e.name," ").concat(i," hook"))}}var Cr=[fr,Dr];function Mr(e,i){var n=i.componentOptions;if(!(t(n)&&!1===n.Ctor.options.inheritAttrs||l(e.data.attrs)&&l(i.data.attrs))){var a,r,m=i.elm,s=e.data.attrs||{},u=i.data.attrs||{};for(a in(t(u.__ob__)||d(u._v_attr_proxy))&&(u=i.data.attrs=O({},u)),u)r=u[a],s[a]!==r&&Fr(m,a,r,i.data.pre);for(a in(W||Q)&&u.value!==s.value&&Fr(m,"value",u.value),s)l(u[a])&&(or(a)?m.removeAttributeNS(kr,yr(a)):mr(a)||m.removeAttribute(a))}}function Fr(e,i,n,a){a||e.tagName.indexOf("-")>-1?_r(e,i,n):ur(i)?br(n)?e.removeAttribute(i):(n="allowfullscreen"===i&&"EMBED"===e.tagName?"true":i,e.setAttribute(i,n)):mr(i)?e.setAttribute(i,function(e,i){return br(i)||"false"===i?"false":"contenteditable"===e&&sr(i)?i:"true"}(i,n)):or(i)?br(n)?e.removeAttributeNS(kr,yr(i)):e.setAttributeNS(kr,i,n):_r(e,i,n)}function _r(e,i,n){if(br(n))e.removeAttribute(i);else{if(W&&!q&&"TEXTAREA"===e.tagName&&"placeholder"===i&&""!==n&&!e.__ieph){var a=function(i){i.stopImmediatePropagation(),e.removeEventListener("input",a)};e.addEventListener("input",a),e.__ieph=!0}e.setAttribute(i,n)}}var Lr={create:Mr,update:Mr};function xr(e,i){var n=i.elm,a=i.data,r=e.data;if(!(l(a.staticClass)&&l(a.class)&&(l(r)||l(r.staticClass)&&l(r.class)))){var d=gr(i),m=n._transitionClasses;t(m)&&(d=Hr(d,pr(m))),d!==n._prevClass&&(n.setAttribute("class",d),n._prevClass=d)}}var Ur,jr={create:xr,update:xr};function wr(e,i,n){var a=Ur;return function r(){var l=i.apply(null,arguments);null!==l&&Xr(e,r,n,a)}}var $r=Sn&&!(ne&&Number(ne[1])<=53);function Jr(e,i,n,a){if($r){var r=ya,l=i;i=l._wrapper=function(e){if(e.target===e.currentTarget||e.timeStamp>=r||e.timeStamp<=0||e.target.ownerDocument!==document)return l.apply(this,arguments)}}Ur.addEventListener(e,i,re?{capture:n,passive:a}:n)}function Xr(e,i,n,a){(a||Ur).removeEventListener(e,i._wrapper||i,n)}function Wr(e,i){if(!l(e.data.on)||!l(i.data.on)){var n=i.data.on||{},a=e.data.on||{};Ur=i.elm||e.elm,function(e){if(t(e.__r)){var i=W?"change":"input";e[i]=[].concat(e.__r,e[i]||[]),delete e.__r}t(e.__c)&&(e.change=[].concat(e.__c,e.change||[]),delete e.__c)}(n),Bi(n,a,Jr,Xr,wr,i.context),Ur=void 0}}var qr,Qr={create:Wr,update:Wr,destroy:function(e){return Wr(e,Yr)}};function el(e,i){if(!l(e.data.domProps)||!l(i.data.domProps)){var n,a,r=i.elm,m=e.data.domProps||{},s=i.data.domProps||{};for(n in(t(s.__ob__)||d(s._v_attr_proxy))&&(s=i.data.domProps=O({},s)),m)n in s||(r[n]="");for(n in s){if(a=s[n],"textContent"===n||"innerHTML"===n){if(i.children&&(i.children.length=0),a===m[n])continue;1===r.childNodes.length&&r.removeChild(r.childNodes[0])}if("value"===n&&"PROGRESS"!==r.tagName){r._value=a;var u=l(a)?"":String(a);il(r,u)&&(r.value=u)}else if("innerHTML"===n&&hr(r.tagName)&&l(r.innerHTML)){(qr=qr||document.createElement("div")).innerHTML="<svg>".concat(a,"</svg>");for(var k=qr.firstChild;r.firstChild;)r.removeChild(r.firstChild);for(;k.firstChild;)r.appendChild(k.firstChild)}else if(a!==m[n])try{r[n]=a}catch(e){}}}}function il(e,i){return!e.composing&&("OPTION"===e.tagName||function(e,i){var n=!0;try{n=document.activeElement!==e}catch(e){}return n&&e.value!==i}(e,i)||function(e,i){var n=e.value,a=e._vModifiers;if(t(a)){if(a.number)return p(n)!==p(i);if(a.trim)return n.trim()!==i.trim()}return n!==i}(e,i))}var nl={create:el,update:el},al=A((function(e){var i={},n=/:(.+)/;return e.split(/;(?![^(]*\))/g).forEach((function(e){if(e){var a=e.split(n);a.length>1&&(i[a[0].trim()]=a[1].trim())}})),i}));function rl(e){var i=ll(e.style);return e.staticStyle?O(e.staticStyle,i):i}function ll(e){return Array.isArray(e)?D(e):"string"==typeof e?al(e):e}var tl,dl=/^--/,ml=/\s*!important$/,sl=function(e,i,n){if(dl.test(i))e.style.setProperty(i,n);else if(ml.test(n))e.style.setProperty(Y(i),n.replace(ml,""),"important");else{var a=kl(i);if(Array.isArray(n))for(var r=0,l=n.length;r<l;r++)e.style[a]=n[r];else e.style[a]=n}},ul=["Webkit","Moz","ms"],kl=A((function(e){if(tl=tl||document.createElement("div").style,"filter"!==(e=f(e))&&e in tl)return e;for(var i=e.charAt(0).toUpperCase()+e.slice(1),n=0;n<ul.length;n++){var a=ul[n]+i;if(a in tl)return a}}));function ol(e,i){var n=i.data,a=e.data;if(!(l(n.staticStyle)&&l(n.style)&&l(a.staticStyle)&&l(a.style))){var r,d,m=i.elm,s=a.staticStyle,u=a.normalizedStyle||a.style||{},k=s||u,o=ll(i.data.style)||{};i.data.normalizedStyle=t(o.__ob__)?O({},o):o;var y=function(e,i){var n,a={};if(i)for(var r=e;r.componentInstance;)(r=r.componentInstance._vnode)&&r.data&&(n=rl(r.data))&&O(a,n);(n=rl(e.data))&&O(a,n);for(var l=e;l=l.parent;)l.data&&(n=rl(l.data))&&O(a,n);return a}(i,!0);for(d in k)l(y[d])&&sl(m,d,"");for(d in y)r=y[d],sl(m,d,null==r?"":r)}}var yl={create:ol,update:ol},bl=/\s+/;function gl(e,i){if(i&&(i=i.trim()))if(e.classList)i.indexOf(" ")>-1?i.split(bl).forEach((function(i){return e.classList.add(i)})):e.classList.add(i);else{var n=" ".concat(e.getAttribute("class")||""," ");n.indexOf(" "+i+" ")<0&&e.setAttribute("class",(n+i).trim())}}function cl(e,i){if(i&&(i=i.trim()))if(e.classList)i.indexOf(" ")>-1?i.split(bl).forEach((function(i){return e.classList.remove(i)})):e.classList.remove(i),e.classList.length||e.removeAttribute("class");else{for(var n=" ".concat(e.getAttribute("class")||""," "),a=" "+i+" ";n.indexOf(a)>=0;)n=n.replace(a," ");(n=n.trim())?e.setAttribute("class",n):e.removeAttribute("class")}}function Hl(e){if(e){if("object"==typeof e){var i={};return!1!==e.css&&O(i,pl(e.name||"v")),O(i,e),i}return"string"==typeof e?pl(e):void 0}}var pl=A((function(e){return{enterClass:"".concat(e,"-enter"),enterToClass:"".concat(e,"-enter-to"),enterActiveClass:"".concat(e,"-enter-active"),leaveClass:"".concat(e,"-leave"),leaveToClass:"".concat(e,"-leave-to"),leaveActiveClass:"".concat(e,"-leave-active")}})),Sl=J&&!q,zl="transition",hl="transitionend",Kl="animation",vl="animationend";Sl&&(void 0===window.ontransitionend&&void 0!==window.onwebkittransitionend&&(zl="WebkitTransition",hl="webkitTransitionEnd"),void 0===window.onanimationend&&void 0!==window.onwebkitanimationend&&(Kl="WebkitAnimation",vl="webkitAnimationEnd"));var Al=J?window.requestAnimationFrame?window.requestAnimationFrame.bind(window):setTimeout:function(e){return e()};function Tl(e){Al((function(){Al(e)}))}function fl(e,i){var n=e._transitionClasses||(e._transitionClasses=[]);n.indexOf(i)<0&&(n.push(i),gl(e,i))}function Bl(e,i){e._transitionClasses&&h(e._transitionClasses,i),cl(e,i)}function Rl(e,i,n){var a=Nl(e,i),r=a.type,l=a.timeout,t=a.propCount;if(!r)return n();var d="transition"===r?hl:vl,m=0,s=function(){e.removeEventListener(d,u),n()},u=function(i){i.target===e&&++m>=t&&s()};setTimeout((function(){m<t&&s()}),l+1),e.addEventListener(d,u)}var Yl=/\b(transform|all)(,|$)/;function Nl(e,i){var n,a=window.getComputedStyle(e),r=(a[zl+"Delay"]||"").split(", "),l=(a[zl+"Duration"]||"").split(", "),t=Pl(r,l),d=(a[Kl+"Delay"]||"").split(", "),m=(a[Kl+"Duration"]||"").split(", "),s=Pl(d,m),u=0,k=0;return"transition"===i?t>0&&(n="transition",u=t,k=l.length):"animation"===i?s>0&&(n="animation",u=s,k=m.length):k=(n=(u=Math.max(t,s))>0?t>s?"transition":"animation":null)?"transition"===n?l.length:m.length:0,{type:n,timeout:u,propCount:k,hasTransform:"transition"===n&&Yl.test(a[zl+"Property"])}}function Pl(e,i){for(;e.length<i.length;)e=e.concat(e);return Math.max.apply(null,i.map((function(i,n){return Ol(i)+Ol(e[n])})))}function Ol(e){return 1e3*Number(e.slice(0,-1).replace(",","."))}function Dl(e,i){var n=e.elm;t(n._leaveCb)&&(n._leaveCb.cancelled=!0,n._leaveCb());var a=Hl(e.data.transition);if(!l(a)&&!t(n._enterCb)&&1===n.nodeType){for(var r=a.css,d=a.type,m=a.enterClass,k=a.enterToClass,o=a.enterActiveClass,y=a.appearClass,b=a.appearToClass,g=a.appearActiveClass,c=a.beforeEnter,H=a.enter,S=a.afterEnter,z=a.enterCancelled,h=a.beforeAppear,K=a.appear,v=a.afterAppear,A=a.appearCancelled,T=a.duration,f=na,B=na.$vnode;B&&B.parent;)f=B.context,B=B.parent;var R=!f._isMounted||!e.isRootInsert;if(!R||K||""===K){var Y=R&&y?y:m,N=R&&g?g:o,P=R&&b?b:k,O=R&&h||c,D=R&&s(K)?K:H,I=R&&v||S,E=R&&A||z,Z=p(u(T)?T.enter:T);0;var G=!1!==r&&!q,V=Zl(D),M=n._enterCb=C((function(){G&&(Bl(n,P),Bl(n,N)),M.cancelled?(G&&Bl(n,Y),E&&E(n)):I&&I(n),n._enterCb=null}));e.data.show||Ri(e,"insert",(function(){var i=n.parentNode,a=i&&i._pending&&i._pending[e.key];a&&a.tag===e.tag&&a.elm._leaveCb&&a.elm._leaveCb(),D&&D(n,M)})),O&&O(n),G&&(fl(n,Y),fl(n,N),Tl((function(){Bl(n,Y),M.cancelled||(fl(n,P),V||(El(Z)?setTimeout(M,Z):Rl(n,d,M)))}))),e.data.show&&(i&&i(),D&&D(n,M)),G||V||M()}}}function Il(e,i){var n=e.elm;t(n._enterCb)&&(n._enterCb.cancelled=!0,n._enterCb());var a=Hl(e.data.transition);if(l(a)||1!==n.nodeType)return i();if(!t(n._leaveCb)){var r=a.css,d=a.type,m=a.leaveClass,s=a.leaveToClass,k=a.leaveActiveClass,o=a.beforeLeave,y=a.leave,b=a.afterLeave,g=a.leaveCancelled,c=a.delayLeave,H=a.duration,S=!1!==r&&!q,z=Zl(y),h=p(u(H)?H.leave:H);0;var K=n._leaveCb=C((function(){n.parentNode&&n.parentNode._pending&&(n.parentNode._pending[e.key]=null),S&&(Bl(n,s),Bl(n,k)),K.cancelled?(S&&Bl(n,m),g&&g(n)):(i(),b&&b(n)),n._leaveCb=null}));c?c(v):v()}function v(){K.cancelled||(!e.data.show&&n.parentNode&&((n.parentNode._pending||(n.parentNode._pending={}))[e.key]=e),o&&o(n),S&&(fl(n,m),fl(n,k),Tl((function(){Bl(n,m),K.cancelled||(fl(n,s),z||(El(h)?setTimeout(K,h):Rl(n,d,K)))}))),y&&y(n,K),S||z||K())}}function El(e){return"number"==typeof e&&!isNaN(e)}function Zl(e){if(l(e))return!1;var i=e.fns;return t(i)?Zl(Array.isArray(i)?i[0]:i):(e._length||e.length)>1}function Gl(e,i){!0!==i.data.show&&Dl(i)}var Vl=function(e){var i,n,a={},s=e.modules,u=e.nodeOps;for(i=0;i<Nr.length;++i)for(a[Nr[i]]=[],n=0;n<s.length;++n)t(s[n][Nr[i]])&&a[Nr[i]].push(s[n][Nr[i]]);function k(e){var i=u.parentNode(e);t(i)&&u.removeChild(i,e)}function o(e,i,n,r,l,m,s){if(t(e.elm)&&t(m)&&(e=m[s]=He(e)),e.isRootInsert=!l,!function(e,i,n,r){var l=e.data;if(t(l)){var m=t(e.componentInstance)&&l.keepAlive;if(t(l=l.hook)&&t(l=l.init)&&l(e,!1),t(e.componentInstance))return y(e,i),b(n,e.elm,r),d(m)&&function(e,i,n,r){var l,d=e;for(;d.componentInstance;)if(d=d.componentInstance._vnode,t(l=d.data)&&t(l=l.transition)){for(l=0;l<a.activate.length;++l)a.activate[l](Yr,d);i.push(d);break}b(n,e.elm,r)}(e,i,n,r),!0}}(e,i,n,r)){var k=e.data,o=e.children,c=e.tag;t(c)?(e.elm=e.ns?u.createElementNS(e.ns,c):u.createElement(c,e),p(e),g(e,o,i),t(k)&&H(e,i),b(n,e.elm,r)):d(e.isComment)?(e.elm=u.createComment(e.text),b(n,e.elm,r)):(e.elm=u.createTextNode(e.text),b(n,e.elm,r))}}function y(e,i){t(e.data.pendingInsert)&&(i.push.apply(i,e.data.pendingInsert),e.data.pendingInsert=null),e.elm=e.componentInstance.$el,c(e)?(H(e,i),p(e)):(Br(e),i.push(e))}function b(e,i,n){t(e)&&(t(n)?u.parentNode(n)===e&&u.insertBefore(e,i,n):u.appendChild(e,i))}function g(e,i,n){if(r(i)){0;for(var a=0;a<i.length;++a)o(i[a],n,e.elm,null,!0,i,a)}else m(e.text)&&u.appendChild(e.elm,u.createTextNode(String(e.text)))}function c(e){for(;e.componentInstance;)e=e.componentInstance._vnode;return t(e.tag)}function H(e,n){for(var r=0;r<a.create.length;++r)a.create[r](Yr,e);t(i=e.data.hook)&&(t(i.create)&&i.create(Yr,e),t(i.insert)&&n.push(e))}function p(e){var i;if(t(i=e.fnScopeId))u.setStyleScope(e.elm,i);else for(var n=e;n;)t(i=n.context)&&t(i=i.$options._scopeId)&&u.setStyleScope(e.elm,i),n=n.parent;t(i=na)&&i!==e.context&&i!==e.fnContext&&t(i=i.$options._scopeId)&&u.setStyleScope(e.elm,i)}function z(e,i,n,a,r,l){for(;a<=r;++a)o(n[a],l,e,i,!1,n,a)}function h(e){var i,n,r=e.data;if(t(r))for(t(i=r.hook)&&t(i=i.destroy)&&i(e),i=0;i<a.destroy.length;++i)a.destroy[i](e);if(t(i=e.children))for(n=0;n<e.children.length;++n)h(e.children[n])}function K(e,i,n){for(;i<=n;++i){var a=e[i];t(a)&&(t(a.tag)?(v(a),h(a)):k(a.elm))}}function v(e,i){if(t(i)||t(e.data)){var n,r=a.remove.length+1;for(t(i)?i.listeners+=r:i=function(e,i){function n(){0==--n.listeners&&k(e)}return n.listeners=i,n}(e.elm,r),t(n=e.componentInstance)&&t(n=n._vnode)&&t(n.data)&&v(n,i),n=0;n<a.remove.length;++n)a.remove[n](e,i);t(n=e.data.hook)&&t(n=n.remove)?n(e,i):i()}else k(e.elm)}function A(e,i,n,a){for(var r=n;r<a;r++){var l=i[r];if(t(l)&&Pr(e,l))return r}}function T(e,i,n,r,m,s){if(e!==i){t(i.elm)&&t(r)&&(i=r[m]=He(i));var k=i.elm=e.elm;if(d(e.isAsyncPlaceholder))t(i.asyncFactory.resolved)?R(e.elm,i,n):i.isAsyncPlaceholder=!0;else if(d(i.isStatic)&&d(e.isStatic)&&i.key===e.key&&(d(i.isCloned)||d(i.isOnce)))i.componentInstance=e.componentInstance;else{var y,b=i.data;t(b)&&t(y=b.hook)&&t(y=y.prepatch)&&y(e,i);var g=e.children,H=i.children;if(t(b)&&c(i)){for(y=0;y<a.update.length;++y)a.update[y](e,i);t(y=b.hook)&&t(y=y.update)&&y(e,i)}l(i.text)?t(g)&&t(H)?g!==H&&function(e,i,n,a,r){var d,m,s,k=0,y=0,b=i.length-1,g=i[0],c=i[b],H=n.length-1,p=n[0],S=n[H],h=!r;for(0;k<=b&&y<=H;)l(g)?g=i[++k]:l(c)?c=i[--b]:Pr(g,p)?(T(g,p,a,n,y),g=i[++k],p=n[++y]):Pr(c,S)?(T(c,S,a,n,H),c=i[--b],S=n[--H]):Pr(g,S)?(T(g,S,a,n,H),h&&u.insertBefore(e,g.elm,u.nextSibling(c.elm)),g=i[++k],S=n[--H]):Pr(c,p)?(T(c,p,a,n,y),h&&u.insertBefore(e,c.elm,g.elm),c=i[--b],p=n[++y]):(l(d)&&(d=Or(i,k,b)),l(m=t(p.key)?d[p.key]:A(p,i,k,b))?o(p,a,e,g.elm,!1,n,y):Pr(s=i[m],p)?(T(s,p,a,n,y),i[m]=void 0,h&&u.insertBefore(e,s.elm,g.elm)):o(p,a,e,g.elm,!1,n,y),p=n[++y]);k>b?z(e,l(n[H+1])?null:n[H+1].elm,n,y,H,a):y>H&&K(i,k,b)}(k,g,H,n,s):t(H)?(t(e.text)&&u.setTextContent(k,""),z(k,null,H,0,H.length-1,n)):t(g)?K(g,0,g.length-1):t(e.text)&&u.setTextContent(k,""):e.text!==i.text&&u.setTextContent(k,i.text),t(b)&&t(y=b.hook)&&t(y=y.postpatch)&&y(e,i)}}}function f(e,i,n){if(d(n)&&t(e.parent))e.parent.data.pendingInsert=i;else for(var a=0;a<i.length;++a)i[a].data.hook.insert(i[a])}var B=S("attrs,class,staticClass,staticStyle,key");function R(e,i,n,a){var r,l=i.tag,m=i.data,s=i.children;if(a=a||m&&m.pre,i.elm=e,d(i.isComment)&&t(i.asyncFactory))return i.isAsyncPlaceholder=!0,!0;if(t(m)&&(t(r=m.hook)&&t(r=r.init)&&r(i,!0),t(r=i.componentInstance)))return y(i,n),!0;if(t(l)){if(t(s))if(e.hasChildNodes())if(t(r=m)&&t(r=r.domProps)&&t(r=r.innerHTML)){if(r!==e.innerHTML)return!1}else{for(var u=!0,k=e.firstChild,o=0;o<s.length;o++){if(!k||!R(k,s[o],n,a)){u=!1;break}k=k.nextSibling}if(!u||k)return!1}else g(i,s,n);if(t(m)){var b=!1;for(var c in m)if(!B(c)){b=!0,H(i,n);break}!b&&m.class&&$n(m.class)}}else e.data!==i.text&&(e.data=i.text);return!0}return function(e,i,n,r){if(!l(i)){var m,s=!1,k=[];if(l(e))s=!0,o(i,k);else{var y=t(e.nodeType);if(!y&&Pr(e,i))T(e,i,k,null,null,r);else{if(y){if(1===e.nodeType&&e.hasAttribute("data-server-rendered")&&(e.removeAttribute("data-server-rendered"),n=!0),d(n)&&R(e,i,k))return f(i,k,!0),e;m=e,e=new be(u.tagName(m).toLowerCase(),{},[],void 0,m)}var b=e.elm,g=u.parentNode(b);if(o(i,k,b._leaveCb?null:g,u.nextSibling(b)),t(i.parent))for(var H=i.parent,p=c(i);H;){for(var S=0;S<a.destroy.length;++S)a.destroy[S](H);if(H.elm=i.elm,p){for(var z=0;z<a.create.length;++z)a.create[z](Yr,H);var v=H.data.hook.insert;if(v.merged)for(var A=v.fns.slice(1),B=0;B<A.length;B++)A[B]()}else Br(H);H=H.parent}t(g)?K([e],0,0):t(e.tag)&&h(e)}}return f(i,k,s),i.elm}t(e)&&h(e)}}({nodeOps:Tr,modules:[Lr,jr,Qr,nl,yl,J?{create:Gl,activate:Gl,remove:function(e,i){!0!==e.data.show?Il(e,i):i()}}:{}].concat(Cr)});q&&document.addEventListener("selectionchange",(function(){var e=document.activeElement;e&&e.vmodel&&jl(e,"input")}));var Cl={inserted:function(e,i,n,a){"select"===n.tag?(a.elm&&!a.elm._vOptions?Ri(n,"postpatch",(function(){Cl.componentUpdated(e,i,n)})):Ml(e,i,n.context),e._vOptions=[].map.call(e.options,Ll)):("textarea"===n.tag||Ar(e.type))&&(e._vModifiers=i.modifiers,i.modifiers.lazy||(e.addEventListener("compositionstart",xl),e.addEventListener("compositionend",Ul),e.addEventListener("change",Ul),q&&(e.vmodel=!0)))},componentUpdated:function(e,i,n){if("select"===n.tag){Ml(e,i,n.context);var a=e._vOptions,r=e._vOptions=[].map.call(e.options,Ll);if(r.some((function(e,i){return!G(e,a[i])})))(e.multiple?i.value.some((function(e){return _l(e,r)})):i.value!==i.oldValue&&_l(i.value,r))&&jl(e,"change")}}};function Ml(e,i,n){Fl(e,i,n),(W||Q)&&setTimeout((function(){Fl(e,i,n)}),0)}function Fl(e,i,n){var a=i.value,r=e.multiple;if(!r||Array.isArray(a)){for(var l,t,d=0,m=e.options.length;d<m;d++)if(t=e.options[d],r)l=V(a,Ll(t))>-1,t.selected!==l&&(t.selected=l);else if(G(Ll(t),a))return void(e.selectedIndex!==d&&(e.selectedIndex=d));r||(e.selectedIndex=-1)}}function _l(e,i){return i.every((function(i){return!G(i,e)}))}function Ll(e){return"_value"in e?e._value:e.value}function xl(e){e.target.composing=!0}function Ul(e){e.target.composing&&(e.target.composing=!1,jl(e.target,"input"))}function jl(e,i){var n=document.createEvent("HTMLEvents");n.initEvent(i,!0,!0),e.dispatchEvent(n)}function wl(e){return!e.componentInstance||e.data&&e.data.transition?e:wl(e.componentInstance._vnode)}var $l={model:Cl,show:{bind:function(e,i,n){var a=i.value,r=(n=wl(n)).data&&n.data.transition,l=e.__vOriginalDisplay="none"===e.style.display?"":e.style.display;a&&r?(n.data.show=!0,Dl(n,(function(){e.style.display=l}))):e.style.display=a?l:"none"},update:function(e,i,n){var a=i.value;!a!=!i.oldValue&&((n=wl(n)).data&&n.data.transition?(n.data.show=!0,a?Dl(n,(function(){e.style.display=e.__vOriginalDisplay})):Il(n,(function(){e.style.display="none"}))):e.style.display=a?e.__vOriginalDisplay:"none")},unbind:function(e,i,n,a,r){r||(e.style.display=e.__vOriginalDisplay)}}},Jl={name:String,appear:Boolean,css:Boolean,mode:String,type:String,enterClass:String,leaveClass:String,enterToClass:String,leaveToClass:String,enterActiveClass:String,leaveActiveClass:String,appearClass:String,appearActiveClass:String,appearToClass:String,duration:[Number,String,Object]};function Xl(e){var i=e&&e.componentOptions;return i&&i.Ctor.options.abstract?Xl(kn(i.children)):e}function Wl(e){var i={},n=e.$options;for(var a in n.propsData)i[a]=e[a];var r=n._parentListeners;for(var a in r)i[f(a)]=r[a];return i}function ql(e,i){if(/\d-keep-alive$/.test(i.tag))return e("keep-alive",{props:i.componentOptions.propsData})}var Ql=function(e){return e.tag||Ji(e)},et=function(e){return"show"===e.name},it={name:"transition",props:Jl,abstract:!0,render:function(e){var i=this,n=this.$slots.default;if(n&&(n=n.filter(Ql)).length){0;var a=this.mode;0;var r=n[0];if(function(e){for(;e=e.parent;)if(e.data.transition)return!0}(this.$vnode))return r;var l=Xl(r);if(!l)return r;if(this._leaving)return ql(e,r);var t="__transition-".concat(this._uid,"-");l.key=null==l.key?l.isComment?t+"comment":t+l.tag:m(l.key)?0===String(l.key).indexOf(t)?l.key:t+l.key:l.key;var d=(l.data||(l.data={})).transition=Wl(this),s=this._vnode,u=Xl(s);if(l.data.directives&&l.data.directives.some(et)&&(l.data.show=!0),u&&u.data&&!function(e,i){return i.key===e.key&&i.tag===e.tag}(l,u)&&!Ji(u)&&(!u.componentInstance||!u.componentInstance._vnode.isComment)){var k=u.data.transition=O({},d);if("out-in"===a)return this._leaving=!0,Ri(k,"afterLeave",(function(){i._leaving=!1,i.$forceUpdate()})),ql(e,r);if("in-out"===a){if(Ji(l))return s;var o,y=function(){o()};Ri(d,"afterEnter",y),Ri(d,"enterCancelled",y),Ri(k,"delayLeave",(function(e){o=e}))}}return r}}},nt=O({tag:String,moveClass:String},Jl);function at(e){e.elm._moveCb&&e.elm._moveCb(),e.elm._enterCb&&e.elm._enterCb()}function rt(e){e.data.newPos=e.elm.getBoundingClientRect()}function lt(e){var i=e.data.pos,n=e.data.newPos,a=i.left-n.left,r=i.top-n.top;if(a||r){e.data.moved=!0;var l=e.elm.style;l.transform=l.WebkitTransform="translate(".concat(a,"px,").concat(r,"px)"),l.transitionDuration="0s"}}delete nt.mode;var tt={Transition:it,TransitionGroup:{props:nt,beforeMount:function(){var e=this,i=this._update;this._update=function(n,a){var r=aa(e);e.__patch__(e._vnode,e.kept,!1,!0),e._vnode=e.kept,r(),i.call(e,n,a)}},render:function(e){for(var i=this.tag||this.$vnode.data.tag||"span",n=Object.create(null),a=this.prevChildren=this.children,r=this.$slots.default||[],l=this.children=[],t=Wl(this),d=0;d<r.length;d++){if((u=r[d]).tag)if(null!=u.key&&0!==String(u.key).indexOf("__vlist"))l.push(u),n[u.key]=u,(u.data||(u.data={})).transition=t;else;}if(a){var m=[],s=[];for(d=0;d<a.length;d++){var u;(u=a[d]).data.transition=t,u.data.pos=u.elm.getBoundingClientRect(),n[u.key]?m.push(u):s.push(u)}this.kept=e(i,null,m),this.removed=s}return e(i,null,l)},updated:function(){var e=this.prevChildren,i=this.moveClass||(this.name||"v")+"-move";e.length&&this.hasMove(e[0].elm,i)&&(e.forEach(at),e.forEach(rt),e.forEach(lt),this._reflow=document.body.offsetHeight,e.forEach((function(e){if(e.data.moved){var n=e.elm,a=n.style;fl(n,i),a.transform=a.WebkitTransform=a.transitionDuration="",n.addEventListener(hl,n._moveCb=function e(a){a&&a.target!==n||a&&!/transform$/.test(a.propertyName)||(n.removeEventListener(hl,e),n._moveCb=null,Bl(n,i))})}})))},methods:{hasMove:function(e,i){if(!Sl)return!1;if(this._hasMove)return this._hasMove;var n=e.cloneNode();

7e._transitionClasses&&e._transitionClasses.forEach((function(e){cl(n,e)})),gl(n,i),n.style.display="none",this.$el.appendChild(n);var a=Nl(n);return this.$el.removeChild(n),this._hasMove=a.hasTransform}}}};qa.config.mustUseProp=function(e,i,n){return"value"===n&&dr(e)&&"button"!==i||"selected"===n&&"option"===e||"checked"===n&&"input"===e||"muted"===n&&"video"===e},qa.config.isReservedTag=Kr,qa.config.isReservedAttr=tr,qa.config.getTagNamespace=function(e){return hr(e)?"svg":"math"===e?"math":void 0},qa.config.isUnknownElement=function(e){if(!J)return!0;if(Kr(e))return!1;if(e=e.toLowerCase(),null!=vr[e])return vr[e];var i=document.createElement(e);return e.indexOf("-")>-1?vr[e]=i.constructor===window.HTMLUnknownElement||i.constructor===window.HTMLElement:vr[e]=/HTMLUnknownElement/.test(i.toString())},O(qa.options.directives,$l),O(qa.options.components,tt),qa.prototype.__patch__=J?Vl:I,qa.prototype.$mount=function(e,i){return function(e,i,n){var a;e.$el=i,e.$options.render||(e.$options.render=ge),ta(e,"beforeMount"),a=function(){e._update(e._render(),n)},new Wn(e,a,I,{before:function(){e._isMounted&&!e._isDestroyed&&ta(e,"beforeUpdate")}},!0),n=!1;var r=e._preWatchers;if(r)for(var l=0;l<r.length;l++)r[l].run();return null==e.$vnode&&(e._isMounted=!0,ta(e,"mounted")),e}(this,e=e&&J?function(e){if("string"==typeof e){var i=document.querySelector(e);return i||document.createElement("div")}return e}(e):void 0,i)},J&&setTimeout((function(){L.devtools&&de&&de.emit("init",qa)}),0)},function(e,i,n){"use strict";e.exports=function(e){try{return!!e()}catch(e){return!0}}},function(e,i,n){"use strict";var a="object"==typeof document&&document.all;e.exports=void 0===a&&void 0!==a?function(e){return"function"==typeof e||e===a}:function(e){return"function"==typeof e}},function(e,i,n){"use strict";var a=function(e){return e&&e.Math===Math&&e};e.exports=a("object"==typeof globalThis&&globalThis)||a("object"==typeof window&&window)||a("object"==typeof self&&self)||a("object"==typeof global&&global)||a("object"==typeof this&&this)||function(){return this}()||Function("return this")()},function(e,i,n){"use strict";var a=n(36),r=Function.prototype,l=r.call,t=a&&r.bind.bind(l,l);e.exports=a?t:function(e){return function(){return l.apply(e,arguments)}}},function(e,i,n){"use strict";var a=n(9),r=String,l=TypeError;e.exports=function(e){if(a(e))return e;throw new l(r(e)+" is not an object")}},function(e,i,n){"use strict";var a=n(36),r=Function.prototype.call;e.exports=a?r.bind(r):function(){return r.apply(r,arguments)}},function(e,i,n){"use strict";var a=n(1);e.exports=!a((function(){return 7!==Object.defineProperty({},1,{get:function(){return 7}})[1]}))},function(e,i,n){"use strict";var a=n(4),r=n(33),l=a({}.hasOwnProperty);e.exports=Object.hasOwn||function(e,i){return l(r(e),i)}},function(e,i,n){"use strict";var a=n(2);e.exports=function(e){return"object"==typeof e?null!==e:a(e)}},function(e,i,n){"use strict";var a=n(3),r=n(83).f,l=n(21),t=n(45),d=n(55),m=n(74),s=n(156);e.exports=function(e,i){var n,u,k,o,y,b=e.target,g=e.global,c=e.stat;if(n=g?a:c?a[b]||d(b,{}):a[b]&&a[b].prototype)for(u in i){if(o=i[u],k=e.dontCallGetSet?(y=r(n,u))&&y.value:n[u],!s(g?u:b+(c?".":"#")+u,e.forced)&&void 0!==k){if(typeof o==typeof k)continue;m(o,k)}(e.sham||k&&k.sham)&&l(o,"sham",!0),t(n,u,o,e)}}},function(e,i,n){"use strict";var a=n(2),r=n(49),l=TypeError;e.exports=function(e){if(a(e))return e;throw new l(r(e)+" is not a function")}},function(e,i,n){"use strict";var a=n(6),r=n(5),l=n(35);e.exports=function(e,i,n){var t,d;r(e);try{if(!(t=l(e,"return"))){if("throw"===i)throw n;return n}t=a(t,e)}catch(e){d=!0,t=e}if("throw"===i)throw n;if(d)throw t;return r(t),n}},function(e,i){var n=Array.isArray;e.exports=n},function(e,i,n){var a=n(97),r="object"==typeof self&&self&&self.Object===Object&&self,l=a||r||Function("return this")();e.exports=l},function(e,i,n){"use strict";var a=n(3),r=n(87),l=n(8),t=n(50),d=n(48),m=n(85),s=a.Symbol,u=r("wks"),k=m?s.for||s:s&&s.withoutSetter||t;e.exports=function(e){return l(u,e)||(u[e]=d&&l(s,e)?s[e]:k("Symbol."+e)),u[e]}},function(e,i,n){"use strict";var a=n(10),r=n(3),l=n(134),t=n(5),d=n(2),m=n(72),s=n(121),u=n(127),k=n(1),o=n(8),y=n(15),b=n(94).IteratorPrototype,g=n(7),c=n(20),H=y("toStringTag"),p=TypeError,S=r.Iterator,z=c||!d(S)||S.prototype!==b||!k((function(){S({})})),h=function(){if(l(this,b),m(this)===b)throw new p("Abstract class Iterator not directly constructable")},K=function(e,i){g?s(b,e,{configurable:!0,get:function(){return i},set:function(i){if(t(this),this===b)throw new p("You can't redefine this property");o(this,e)?this[e]=i:u(this,e,i)}}):b[e]=i};o(b,H)||K(H,"Iterator"),!z&&o(b,"constructor")&&b.constructor!==Object||K("constructor",h),h.prototype=b,a({global:!0,constructor:!0,forced:z},{Iterator:h})},function(e,i,n){"use strict";var a=n(7),r=n(88),l=n(90),t=n(5),d=n(84),m=TypeError,s=Object.defineProperty,u=Object.getOwnPropertyDescriptor;i.f=a?l?function(e,i,n){if(t(e),i=d(i),t(n),"function"==typeof e&&"prototype"===i&&"value"in n&&"writable"in n&&!n.writable){var a=u(e,i);

7a&&a.writable&&(e[i]=n.value,n={configurable:"configurable"in n?n.configurable:a.configurable,enumerable:"enumerable"in n?n.enumerable:a.enumerable,writable:!1})}return s(e,i,n)}:s:function(e,i,n){if(t(e),i=d(i),t(n),r)try{return s(e,i,n)}catch(e){}if("get"in n||"set"in n)throw new m("Accessors not supported");return"value"in n&&(e[i]=n.value),e}},function(e,i,n){"use strict";var a=n(4),r=a({}.toString),l=a("".slice);e.exports=function(e){return l(r(e),8,-1)}},function(e,i,n){var a=n(199),r=n(202);e.exports=function(e,i){var n=r(e,i);return a(n)?n:void 0}},function(e,i,n){"use strict";e.exports=!1},function(e,i,n){"use strict";var a=n(7),r=n(17),l=n(34);e.exports=a?function(e,i,n){return r.f(e,i,l(1,n))}:function(e,i,n){return e[i]=n,e}},function(e,i){e.exports=function(e){return null!=e&&"object"==typeof e}},function(e,i,n){"use strict";e.exports=function(e){return{iterator:e,next:e.next,done:!1}}},function(e,i,n){"use strict";var a=n(10),r=n(6),l=n(11),t=n(5),d=n(23),m=n(75),s=n(95),u=n(20),k=n(12),o=n(76),y=n(26),b=!u&&!o("filter",(function(){})),g=!u&&!b&&y("filter",TypeError),c=u||b||g,H=m((function(){for(var e,i,n=this.iterator,a=this.predicate,l=this.next;;){if(e=t(r(l,n)),this.done=!!e.done)return;if(i=e.value,s(n,a,[i,this.counter++],!0))return i}}));a({target:"Iterator",proto:!0,real:!0,forced:c},{filter:function(e){t(this);try{l(e)}catch(e){k(this,"throw",e)}return g?r(g,this,e):new H(d(this),{predicate:e})}})},function(e,i,n){"use strict";var a=n(3),r=n(2),l=function(e){return r(e)?e:void 0};e.exports=function(e,i){return arguments.length<2?l(a[e]):a[e]&&a[e][i]}},function(e,i,n){"use strict";var a=n(3);e.exports=function(e,i){var n=a.Iterator,r=n&&n.prototype,l=r&&r[e],t=!1;if(l)try{l.call({next:function(){return{done:!0}},return:function(){t=!0}},-1)}catch(e){e instanceof i||(t=!1)}if(!t)return l}},function(e,i,n){var a=n(28),r=n(184),l=n(185),t=a?a.toStringTag:void 0;e.exports=function(e){return null==e?void 0===e?"[object Undefined]":"[object Null]":t&&t in Object(e)?r(e):l(e)}},function(e,i,n){var a=n(14).Symbol;e.exports=a},function(e,i,n){"use strict";function a(e,i,n,a,r,l,t,d){var m,s="function"==typeof e?e.options:e;if(i&&(s.render=i,s.staticRenderFns=n,s._compiled=!0),a&&(s.functional=!0),l&&(s._scopeId="data-v-"+l),t?(m=function(e){(e=e||this.$vnode&&this.$vnode.ssrContext||this.parent&&this.parent.$vnode&&this.parent.$vnode.ssrContext)||"undefined"==typeof __VUE_SSR_CONTEXT__||(e=__VUE_SSR_CONTEXT__),r&&r.call(this,e),e&&e._registeredComponents&&e._registeredComponents.add(t)},s._ssrRegister=m):r&&(m=d?function(){r.call(this,(s.functional?this.parent:this).$root.$options.shadowRoot)}:r),m)if(s.functional){s._injectStyles=m;var u=s.render;s.render=function(e,i){return m.call(i),u(e,i)}}else{var k=s.beforeCreate;s.beforeCreate=k?[].concat(k,m):[m]}return{exports:e,options:s}}n.d(i,"a",(function(){return a}))},function(e,i,n){"use strict";var a=n(133);e.exports=function(e){return a(e.length)}},function(e,i,n){"use strict";var a=n(10),r=n(6),l=n(11),t=n(5),d=n(23),m=n(75),s=n(95),u=n(12),k=n(76),o=n(26),y=n(20),b=!y&&!k("map",(function(){})),g=!y&&!b&&o("map",TypeError),c=y||b||g,H=m((function(){var e=this.iterator,i=t(r(this.next,e));if(!(this.done=!!i.done))return s(e,this.mapper,[i.value,this.counter++],!0)}));a({target:"Iterator",proto:!0,real:!0,forced:c},{map:function(e){t(this);try{l(e)}catch(e){u(this,"throw",e)}return g?r(g,this,e):new H(d(this),{mapper:e})}})},function(e,i,n){"use strict";var a=n(4);e.exports=a({}.isPrototypeOf)},function(e,i,n){"use strict";var a=n(47),r=Object;e.exports=function(e){return r(a(e))}},function(e,i,n){"use strict";e.exports=function(e,i){return{enumerable:!(1&e),configurable:!(2&e),writable:!(4&e),value:i}}},function(e,i,n){"use strict";var a=n(11),r=n(52);e.exports=function(e,i){var n=e[i];return r(n)?void 0:a(n)}},function(e,i,n){"use strict";var a=n(1);e.exports=!a((function(){var e=function(){}.bind();return"function"!=typeof e||e.hasOwnProperty("prototype")}))},function(e,i,n){"use strict";var a=n(77),r=n(47);e.exports=function(e){return a(r(e))}},function(e,i,n){var a=n(189),r=n(190),l=n(191),t=n(192),d=n(193);function m(e){var i=-1,n=null==e?0:e.length;for(this.clear();++i<n;){var a=e[i];this.set(a[0],a[1])}}m.prototype.clear=a,m.prototype.delete=r,m.prototype.get=l,m.prototype.has=t,m.prototype.set=d,e.exports=m},function(e,i,n){var a=n(99);e.exports=function(e,i){for(var n=e.length;n--;)if(a(e[n][0],i))return n;return-1}},function(e,i,n){var a=n(19)(Object,"create");e.exports=a},function(e,i,n){var a=n(211);e.exports=function(e,i){var n=e.__data__;return a(i)?n["string"==typeof i?"string":"hash"]:n.map}},function(e,i,n){var a=n(66);e.exports=function(e){if("string"==typeof e||a(e))return e;var i=e+"";return"0"==i&&1/e==-1/0?"-0":i}},function(e,i,n){var a,r;
8/* NProgress, (c) 2013, 2014 Rico Sta. Cruz - http://ricostacruz.com/nprogress
9 * @license MIT */void 0===(r="function"==typeof(a=function(){var e,i,n={version:"0.2.0"},a=n.settings={minimum:.08,easing:"ease",positionUsing:"",speed:200,trickle:!0,trickleRate:.02,trickleSpeed:800,showSpinner:!0,barSelector:'[role="bar"]',spinnerSelector:'[role="spinner"]',parent:"body",template:'<div class="bar" role="bar"><div class="peg"></div></div><div class="spinner" role="spinner"><div class="spinner-icon"></div></div>'};function r(e,i,n){return e<i?i:e>n?n:e}function l(e){return 100*(-1+e)}n.configure=function(e){var i,n;for(i in e)void 0!==(n=e[i])&&e.hasOwnProperty(i)&&(a[i]=n);return this}

9,n.status=null,n.set=function(e){var i=n.isStarted();e=r(e,a.minimum,1),n.status=1===e?null:e;var m=n.render(!i),s=m.querySelector(a.barSelector),u=a.speed,k=a.easing;return m.offsetWidth,t((function(i){""===a.positionUsing&&(a.positionUsing=n.getPositioningCSS()),d(s,function(e,i,n){var r;return(r="translate3d"===a.positionUsing?{transform:"translate3d("+l(e)+"%,0,0)"}:"translate"===a.positionUsing?{transform:"translate("+l(e)+"%,0)"}:{"margin-left":l(e)+"%"}).transition="all "+i+"ms "+n,r}(e,u,k)),1===e?(d(m,{transition:"none",opacity:1}),m.offsetWidth,setTimeout((function(){d(m,{transition:"all "+u+"ms linear",opacity:0}),setTimeout((function(){n.remove(),i()}),u)}),u)):setTimeout(i,u)})),this},n.isStarted=function(){return"number"==typeof n.status},n.start=function(){n.status||n.set(0);var e=function(){setTimeout((function(){n.status&&(n.trickle(),e())}),a.trickleSpeed)};return a.trickle&&e(),this},n.done=function(e){return e||n.status?n.inc(.3+.5*Math.random()).set(1):this},n.inc=function(e){var i=n.status;return i?("number"!=typeof e&&(e=(1-i)*r(Math.random()*i,.1,.95)),i=r(i+e,0,.994),n.set(i)):n.start()},n.trickle=function(){return n.inc(Math.random()*a.trickleRate)},e=0,i=0,n.promise=function(a){return a&&"resolved"!==a.state()?(0===i&&n.start(),e++,i++,a.always((function(){0==--i?(e=0,n.done()):n.set((e-i)/e)})),this):this},n.render=function(e){if(n.isRendered())return document.getElementById("nprogress");s(document.documentElement,"nprogress-busy");var i=document.createElement("div");i.id="nprogress",i.innerHTML=a.template;var r,t=i.querySelector(a.barSelector),m=e?"-100":l(n.status||0),u=document.querySelector(a.parent);return d(t,{transition:"all 0 linear",transform:"translate3d("+m+"%,0,0)"}),a.showSpinner||(r=i.querySelector(a.spinnerSelector))&&o(r),u!=document.body&&s(u,"nprogress-custom-parent"),u.appendChild(i),i},n.remove=function(){u(document.documentElement,"nprogress-busy"),u(document.querySelector(a.parent),"nprogress-custom-parent");var e=document.getElementById("nprogress");e&&o(e)},n.isRendered=function(){return!!document.getElementById("nprogress")},n.getPositioningCSS=function(){var e=document.body.style,i="WebkitTransform"in e?"Webkit":"MozTransform"in e?"Moz":"msTransform"in e?"ms":"OTransform"in e?"O":"";return i+"Perspective"in e?"translate3d":i+"Transform"in e?"translate":"margin"};var t=function(){var e=[];function i(){var n=e.shift();n&&n(i)}return function(n){e.push(n),1==e.length&&i()}}(),d=function(){var e=["Webkit","O","Moz","ms"],i={};function n(n){return n=n.replace(/^-ms-/,"ms-").replace(/-([\da-z])/gi,(function(e,i){return i.toUpperCase()})),i[n]||(i[n]=function(i){var n=document.body.style;if(i in n)return i;for(var a,r=e.length,l=i.charAt(0).toUpperCase()+i.slice(1);r--;)if((a=e[r]+l)in n)return a;return i}(n))}function a(e,i,a){i=n(i),e.style[i]=a}return function(e,i){var n,r,l=arguments;if(2==l.length)for(n in i)void 0!==(r=i[n])&&i.hasOwnProperty(n)&&a(e,n,r);else a(e,l[1],l[2])}}();function m(e,i){return("string"==typeof e?e:k(e)).indexOf(" "+i+" ")>=0}function s(e,i){var n=k(e),a=n+i;m(n,i)||(e.className=a.substring(1))}function u(e,i){var n,a=k(e);m(e,i)&&(n=a.replace(" "+i+" "," "),e.className=n.substring(1,n.length-1))}function k(e){return(" "+(e.className||"")+" ").replace(/\s+/gi," ")}function o(e){e&&e.parentNode&&e.parentNode.removeChild(e)}return n})?a.call(i,n,i,e):a)||(e.exports=r)},function(e,i,n){"use strict";var a=n(137),r=n(6),l=n(5),t=n(49),d=n(168),m=n(30),s=n(32),u=n(170),k=n(79),o=n(12),y=TypeError,b=function(e,i){this.stopped=e,this.result=i},g=b.prototype;e.exports=function(e,i,n){var c,H,p,S,z,h,K,v=n&&n.that,A=!(!n||!n.AS_ENTRIES),T=!(!n||!n.IS_RECORD),f=!(!n||!n.IS_ITERATOR),B=!(!n||!n.INTERRUPTED),R=a(i,v),Y=function(e){var i=c;return c=void 0,i&&o(i,"normal"),new b(!0,e)},N=function(e){return A?(l(e),B?R(e[0],e[1],Y):R(e[0],e[1])):B?R(e,Y):R(e)};if(T)c=e.iterator;else if(f)c=e;else{if(!(H=k(e)))throw new y(t(e)+" is not iterable");if(d(H)){for(p=0,S=m(e);S>p;p++)if((z=N(e[p]))&&s(g,z))return z;return new b(!1)}c=u(e,H)}for(h=T?e.next:c.next;!(K=r(h,c)).done;){var P=K.value;try{z=N(P)}catch(e){if(!c)throw e;o(c,"throw",e)}if("object"==typeof z&&z&&s(g,z))return z}return new b(!1)}},function(e,i,n){"use strict";var a=n(2),r=n(17),l=n(91),t=n(55);e.exports=function(e,i,n,d){d||(d={});var m=d.enumerable,s=void 0!==d.name?d.name:i;if(a(n)&&l(n,s,d),d.global)m?e[i]=n:t(i,n);else{try{d.unsafe?e[i]&&(m=!0):delete e[i]}catch(e){}

9m?e[i]=n:r.f(e,i,{value:n,enumerable:!1,configurable:!d.nonConfigurable,writable:!d.nonWritable})}return e}},function(e,i,n){"use strict";var a,r=n(5),l=n(158),t=n(58),d=n(57),m=n(160),s=n(89),u=n(56),k=u("IE_PROTO"),o=function(){},y=function(e){return"<script>"+e+"<\/script>"},b=function(e){e.write(y("")),e.close();var i=e.parentWindow.Object;return e=null,i},g=function(){try{a=new ActiveXObject("htmlfile")}catch(e){}var e,i;g="undefined"!=typeof document?document.domain&&a?b(a):((i=s("iframe")).style.display="none",m.appendChild(i),i.src=String("javascript:"),(e=i.contentWindow.document).open(),e.write(y("document.F=Object")),e.close(),e.F):b(a);for(var n=t.length;n--;)delete g.prototype[t[n]];return g()};d[k]=!0,e.exports=Object.create||function(e,i){var n;return null!==e?(o.prototype=r(e),n=new o,o.prototype=null,n[k]=e):n=g(),void 0===i?n:l.f(n,i)}},function(e,i,n){"use strict";var a=n(52),r=TypeError;e.exports=function(e){if(a(e))throw new r("Can't call method on "+e);return e}},function(e,i,n){"use strict";var a=n(78),r=n(1),l=n(3).String;e.exports=!!Object.getOwnPropertySymbols&&!r((function(){var e=Symbol("symbol detection");return!l(e)||!(Object(e)instanceof Symbol)||!Symbol.sham&&a&&a<41}))},function(e,i,n){"use strict";var a=String;e.exports=function(e){try{return a(e)}catch(e){return"Object"}}},function(e,i,n){"use strict";var a=n(4),r=0,l=Math.random(),t=a(1.1.toString);e.exports=function(e){return"Symbol("+(void 0===e?"":e)+")_"+t(++r+l,36)}},function(e,i,n){"use strict";var a,r,l,t=n(150),d=n(3),m=n(9),s=n(21),u=n(8),k=n(54),o=n(56),y=n(57),b=d.TypeError,g=d.WeakMap;if(t||k.state){var c=k.state||(k.state=new g);

9c.get=c.get,c.has=c.has,c.set=c.set,a=function(e,i){if(c.has(e))throw new b("Object already initialized");return i.facade=e,c.set(e,i),i},r=function(e){return c.get(e)||{}},l=function(e){return c.has(e)}}else{var H=o("state");y[H]=!0,a=function(e,i){if(u(e,H))throw new b("Object already initialized");return i.facade=e,s(e,H,i),i},r=function(e){return u(e,H)?e[H]:{}},l=function(e){return u(e,H)}}e.exports={set:a,get:r,has:l,enforce:function(e){return l(e)?r(e):a(e,{})},getterFor:function(e){return function(i){var n;if(!m(i)||(n=r(i)).type!==e)throw new b("Incompatible receiver, "+e+" required");return n}}}},function(e,i,n){"use strict";e.exports=function(e){return null==e}},function(e,i,n){"use strict";var a=n(25),r=n(2),l=n(32),t=n(85),d=Object;e.exports=t?function(e){return"symbol"==typeof e}:function(e){var i=a("Symbol");return r(i)&&l(i.prototype,d(e))}},function(e,i,n){"use strict";var a=n(20),r=n(3),l=n(55),t=e.exports=r["__core-js_shared__"]||l("__core-js_shared__",{});(t.versions||(t.versions=[])).push({version:"3.50.0",mode:a?"pure":"global",copyright:"Â© 2013â2025 Denis Pushkarev (zloirock.ru), 2025â2026 CoreJS Company (core-js.io). All rights reserved.",license:"https://github.com/zloirock/core-js/blob/v3.50.0/LICENSE",source:"https://github.com/zloirock/core-js"})},function(e,i,n){"use strict";var a=n(3),r=Object.defineProperty;e.exports=function(e,i){try{r(a,e,{value:i,configurable:!0,writable:!0})}catch(n){a[e]=i}return i}},function(e,i,n){"use strict";var a=n(87),r=n(50),l=a("keys");e.exports=function(e){return l[e]||(l[e]=r(e))}},function(e,i,n){"use strict";e.exports={}},function(e,i,n){"use strict";e.exports=["constructor","hasOwnProperty","isPrototypeOf","propertyIsEnumerable","toLocaleString","toString","valueOf"]},function(e,i,n){var a=n(183),r=n(22),l=Object.prototype,t=l.hasOwnProperty,d=l.propertyIsEnumerable,m=a(function(){return arguments}())?a:function(e){return r(e)&&t.call(e,"callee")&&!d.call(e,"callee")};e.exports=m},function(e,i,n){var a=n(19)(n(14),"Map");e.exports=a},function(e,i){e.exports=function(e){var i=typeof e;return null!=e&&("object"==i||"function"==i)}},function(e,i,n){var a=n(203),r=n(210),l=n(212),t=n(213),d=n(214);function m(e){var i=-1,n=null==e?0:e.length;for(this.clear();++i<n;){var a=e[i];this.set(a[0],a[1])}}m.prototype.clear=a,m.prototype.delete=r,m.prototype.get=l,m.prototype.has=t,m.prototype.set=d,e.exports=m},function(e,i){e.exports=function(e){var i=-1,n=Array(e.size);return e.forEach((function(e){n[++i]=e})),n}},function(e,i){e.exports=function(e){return"number"==typeof e&&e>-1&&e%1==0&&e<=9007199254740991}},function(e,i,n){var a=n(13),r=n(66),l=/\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/,t=/^\w*$/;e.exports=function(e,i){if(a(e))return!1;var n=typeof e;return!("number"!=n&&"symbol"!=n&&"boolean"!=n&&null!=e&&!r(e))||(t.test(e)||!l.test(e)||null!=i&&e in Object(i))}},function(e,i,n){var a=n(27),r=n(22);e.exports=function(e){return"symbol"==typeof e||r(e)&&"[object Symbol]"==a(e)}},function(e,i){e.exports=function(e){return e}},function(e,i,n){"use strict";var a=n(154);e.exports=function(e){var i=+e;return i!=i||0===i?0:a(i)}},function(e,i,n){"use strict";var a=n(125),r=String;e.exports=function(e){if("Symbol"===a(e))throw new TypeError("Cannot convert a Symbol value to a string");return r(e)}},function(e,i,n){"use strict";var a=n(10),r=n(6),l=n(44),t=n(11),d=n(5),m=n(23),s=n(12),u=n(26)("some",TypeError);a({target:"Iterator",proto:!0,real:!0,forced:u},{some:function(e){d(this);try{t(e)}catch(e){s(this,"throw",e)}if(u)return r(u,this,e);var i=m(this),n=0;return l(i,(function(i,a){if(e(i,n++))return a()}),{IS_RECORD:!0,INTERRUPTED:!0}).stopped}})},function(e,i,n){"use strict";var a=n(10),r=n(6),l=n(44),t=n(11),d=n(5),m=n(23),s=n(12),u=n(26)("forEach",TypeError);a({target:"Iterator",proto:!0,real:!0,forced:u},{forEach:function(e){d(this);try{t(e)}catch(e){s(this,"throw",e)}if(u)return r(u,this,e);var i=m(this),n=0;l(i,(function(i){e(i,n++)}),{IS_RECORD:!0})}})},function(e,i,n){"use strict";var a=n(8),r=n(2),l=n(33),t=n(56),d=n(157),m=t("IE_PROTO"),s=Object,u=s.prototype;e.exports=d?s.getPrototypeOf:function(e){var i=l(e);if(a(i,m))return i[m];var n=i.constructor;return r(n)&&i instanceof n?n.prototype:i instanceof s?u:null}},function(e,i,n){"use strict";var a=n(123),r=n(9),l=n(47),t=n(171);

9e.exports=Object.setPrototypeOf||("__proto__"in{}?function(){var e,i=!1,n={};try{(e=a(Object.prototype,"__proto__","set"))(n,[]),i=n instanceof Array}catch(e){}return function(n,a){return l(n),t(a),r(n)?(i?e(n,a):n.__proto__=a,n):n}}():void 0)},function(e,i,n){"use strict";var a=n(8),r=n(151),l=n(83),t=n(17);e.exports=function(e,i,n){for(var d=r(i),m=t.f,s=l.f,u=0;u<d.length;u++){var k=d[u];a(e,k)||n&&a(n,k)||m(e,k,s(i,k))}}},function(e,i,n){"use strict";var a=n(6),r=n(46),l=n(21),t=n(161),d=n(15),m=n(51),s=n(35),u=n(94).IteratorPrototype,k=n(162),o=n(12),y=n(163),b=n(164),g=d("toStringTag"),c=m.set,H=function(e){var i=m.getterFor(e?"WrapForValidIterator":"IteratorHelper");return t(r(u),{next:function(){var n=i(this);if(e)return n.nextHandler();if(n.done)return k(void 0,!0);try{var a=n.nextHandler();return n.done&&b(n),n.returnHandlerResult?a:k(a,n.done)}catch(e){throw n.done=!0,b(n),e}},return:function(){var n=i(this),r=n.iterator,l=n.inner,t=n.openIters,d=n.done;if(n.done=!0,e){var m=s(r,"return");return m?a(m,r):k(void 0,!0)}if(b(n),d)return k(void 0,!0);if(l)try{o(l.iterator,"normal")}catch(e){return o(r,"throw",e)}if(t)try{y(t,"normal")}catch(e){if(r)return o(r,"throw",e);throw e}return r&&o(r,"normal"),k(void 0,!0)}})},p=H(!0),S=H(!1);l(S,g,"Iterator Helper"),e.exports=function(e,i,n){var a=function(a,r){r?(r.iterator=a.iterator,r.next=a.next):r=a,r.type=i?"WrapForValidIterator":"IteratorHelper",r.returnHandlerResult=!!n,r.nextHandler=e,r.counter=0,r.done=!1,c(this,r)};return a.prototype=i?p:S,a}},function(e,i,n){"use strict";e.exports=function(e,i){var n="function"==typeof Iterator&&Iterator.prototype[e];if(n)try{n.call({next:null},i).next()}catch(e){return!0}}},function(e,i,n){"use strict";var a=n(4),r=n(1),l=n(18),t=Object,d=a("".split);e.exports=r((function(){return!t("z").propertyIsEnumerable(0)}))?function(e){return"String"===l(e)?d(e,""):t(e)}:t},function(e,i,n){"use strict";var a,r,l=n(3),t=n(86),d=l.process,m=l.Deno,s=d&&d.versions||m&&m.version,u=s&&s.v8;u&&(r=(a=u.split("."))[0]>0&&a[0]<4?1:+(a[0]+a[1])),!r&&t&&(!(a=t.match(/Edge\/(\d+)/))||a[1]>=74)&&(a=t.match(/Chrome\/(\d+)/))&&(r=+a[1]),e.exports=r},function(e,i,n){"use strict";var a=n(18),r=n(52),l=n(35),t=n(15)("iterator"),d=Array.prototype;e.exports=function(e){if(!r(e))return l(e,t)||l(e,"@@iterator")||("Arguments"===a(e)?d[t]:void 0)}},function(e,i,n){"use strict";var a=n(36),r=Function.prototype,l=r.apply,t=r.call;e.exports="object"==typeof Reflect&&Reflect.apply||(a?t.bind(l):function(){return t.apply(l,arguments)})},function(e,i,n){"use strict";var a=n(18);e.exports=Array.isArray||function(e){return"Array"===a(e)}},function(e,i){e.exports=function(e){return e.webpackPolyfill||(e.deprecate=function(){},e.paths=[],e.children||(e.children=[]),Object.defineProperty(e,"loaded",{enumerable:!0,get:function(){return e.l}}),Object.defineProperty(e,"id",{enumerable:!0,get:function(){return e.i}}),e.webpackPolyfill=1),e}},function(e,i,n){"use strict";var a=n(7),r=n(6),l=n(146),t=n(34),d=n(37),m=n(84),s=n(8),u=n(88),k=Object.getOwnPropertyDescriptor;i.f=a?k:function(e,i){if(e=d(e),i=m(i),u)try{return k(e,i)}catch(e){}if(s(e,i))return t(!r(l.f,e,i),e[i])}},function(e,i,n){"use strict";var a=n(132),r=n(53);e.exports=function(e){var i=a(e,"string");return r(i)?i:i+""}},function(e,i,n){"use strict";var a=n(48);e.exports=a&&!Symbol.sham&&"symbol"==typeof Symbol.iterator},function(e,i,n){"use strict";var a=n(3).navigator,r=a&&a.userAgent;e.exports=r?String(r):""},function(e,i,n){"use strict";var a=n(54),r=Object.create||Object;e.exports=function(e,i){return a[e]||(a[e]=i||r(null))}},function(e,i,n){"use strict";var a=n(7),r=n(1),l=n(89);e.exports=!a&&!r((function(){return 7!==Object.defineProperty(l("div"),"a",{get:function(){return 7}}).a}))},function(e,i,n){"use strict";var a=n(3),r=n(9),l=a.document,t=r(l)&&r(l.createElement);e.exports=function(e){return t?l.createElement(e):{}}},function(e,i,n){"use strict";var a=n(7),r=n(1);e.exports=a&&r((function(){return 42!==Object.defineProperty((function(){}),"prototype",{value:42,writable:!1}).prototype}))},function(e,i,n){"use strict";var a=n(4),r=n(1),l=n(2),t=n(8),d=n(7),m=n(148).CONFIGURABLE,s=n(149),u=n(51),k=u.enforce,o=u.get,y=String,b=Object.defineProperty,g=a("".slice),c=a("".replace),H=a([].join),p=d&&!r((function(){return 8!==b((function(){}),"length",{value:8}).length})),S=String(String).split("String"),z=e.exports=function(e,i,n){"Symbol("===g(y(i),0,7)&&(i="["+c(y(i),/^Symbol\(([^)]*)\).*$/,"$1")+"]"),n&&n.getter&&(i="get "+i),n&&n.setter&&(i="set "+i),(!t(e,"name")||m&&e.name!==i)&&(d?b(e,"name",{value:i,configurable:!0}):e.name=i),p&&n&&t(n,"arity")&&e.length!==n.arity&&b(e,"length",{value:n.arity});try{n&&t(n,"constructor")&&n.constructor?d&&b(e,"prototype",{writable:!1}):e.prototype&&(e.prototype=void 0)}catch(e){}var a=k(e);return t(a,"source")||(a.source=H(S,"string"==typeof i?i:"")),e};Function.prototype.toString=z((function(){return l(this)&&o(this).source||s(this)}),"toString")},function(e,i,n){"use strict";var a=n(4),r=n(8),l=n(37),t=n(93).indexOf,d=n(57),m=a([].push);e.exports=function(e,i){var n,a=l(e),s=0,u=[];for(n in a)!r(d,n)&&r(a,n)&&m(u,n);for(;i.length>s;)r(a,n=i[s++])&&(~t(u,n)||m(u,n));return u}},function(e,i,n){"use strict";var a=n(37),r=n(153),l=n(30),t=function(e){return function(i,n,t){var d=a(i),m=l(d);if(0===m)return!e&&-1;var s,u=r(t,m);if(e&&n!=n){for(;m>u;)if((s=d[u++])!=s)return!0}else for(;m>u;u++)if((e||u in d)&&d[u]===n)return e||u||0;return!e&&-1}};e.exports={includes:t(!0),indexOf:t(!1)}},function(e,i,n){"use strict";var a,r,l,t=n(1),d=n(2),m=n(9),s=n(46),u=n(72),k=n(45),o=n(15),y=n(20),b=o("iterator"),g=!1;[].keys&&("next"in(l=[].keys())?(r=u(u(l)))!==Object.prototype&&(a=r):g=!0),!m(a)||t((function(){var e={};return a[b].call(e)!==e}))?a={}:y&&(a=s(a)),d(a[b])||k(a,b,(function(){return this})),e.exports={IteratorPrototype:a,BUGGY_SAFARI_ITERATORS:g}},function(e,i,n){"use strict";var a=n(5),r=n(12);e.exports=function(e,i,n,l){try{return l?i(a(n)[0],n[1]):i(n)}catch(i){r(e,"throw",i)}}},function(e,i){e.exports=function(e,i){for(var n=-1,a=i.length,r=e.length;++n<a;)e[r+n]=i[n];return e}},function(e,i){var n="object"==typeof global&&global&&global.Object===Object&&global;e.exports=n},function(e,i,n){var a=n(38),r=n(194),l=n(195),t=n(196),d=n(197),m=n(198);function s(e){var i=this.__data__=new a(e);this.size=i.size}s.prototype.clear=r,s.prototype.delete=l,s.prototype.get=t,s.prototype.has=d,s.prototype.set=m,e.exports=s},function(e,i){e.exports=function(e,i){return e===i||e!=e&&i!=i}},function(e,i,n){var a=n(27),r=n(61);e.exports=function(e){if(!r(e))return!1;var i=a(e);return"[object Function]"==i||"[object GeneratorFunction]"==i||"[object AsyncFunction]"==i||"[object Proxy]"==i}},function(e,i){var n=Function.prototype.toString;e.exports=function(e){if(null!=e){try{return n.call(e)}catch(e){}try{return e+""}catch(e){}}return""}},function(e,i,n){var a=n(215),r=n(22);e.exports=function e(i,n,l,t,d){return i===n||(null==i||null==n||!r(i)&&

9!r(n)?i!=i&&n!=n:a(i,n,l,t,e,d))}},function(e,i,n){var a=n(104),r=n(218),l=n(105);e.exports=function(e,i,n,t,d,m){var s=1&n,u=e.length,k=i.length;if(u!=k&&!(s&&k>u))return!1;var o=m.get(e),y=m.get(i);if(o&&y)return o==i&&y==e;var b=-1,g=!0,c=2&n?new a:void 0;for(m.set(e,i),m.set(i,e);++b<u;){var H=e[b],p=i[b];if(t)var S=s?t(p,H,b,i,e,m):t(H,p,b,e,i,m);if(void 0!==S){if(S)continue;g=!1;break}if(c){if(!r(i,(function(e,i){if(!l(c,i)&&(H===e||d(H,e,n,t,m)))return c.push(i)}))){g=!1;break}}else if(H!==p&&!d(H,p,n,t,m)){g=!1;break}}return m.delete(e),m.delete(i),g}},function(e,i,n){var a=n(62),r=n(216),l=n(217);function t(e){var i=-1,n=null==e?0:e.length;for(this.__data__=new a;++i<n;)this.add(e[i])}t.prototype.add=t.prototype.push=r,t.prototype.has=l,e.exports=t},function(e,i){e.exports=function(e,i){return e.has(i)}},function(e,i,n){var a=n(228),r=n(234),l=n(110);e.exports=function(e){return l(e)?a(e):r(e)}},function(e,i,n){(function(e){var a=n(14),r=n(230),l=i&&!i.nodeType&&i,t=l&&"object"==typeof e&&e&&!e.nodeType&&e,d=t&&t.exports===l?a.Buffer:void 0,m=(d?d.isBuffer:void 0)||r;e.exports=m}).call(this,n(82)(e))},function(e,i){var n=/^(?:0|[1-9]\d*)$/;e.exports=function(e,i){var a=typeof e;return!!(i=null==i?9007199254740991:i)&&("number"==a||"symbol"!=a&&n.test(e))&&e>-1&&e%1==0&&e<i}},function(e,i,n){var a=n(231),r=n(232),l=n(233),t=l&&l.isTypedArray,d=t?r(t):a;e.exports=d},function(e,i,n){var a=n(100),r=n(64);e.exports=function(e){return null!=e&&r(e.length)&&!a(e)}},function(e,i,n){var a=n(19)(n(14),"Set");e.exports=a},function(e,i,n){var a=n(61);e.exports=function(e){return e==e&&!a(e)}},function(e,i){e.exports=function(e,i){return function(n){return null!=n&&(n[e]===i&&(void 0!==i||e in Object(n)))}}},function(e,i,n){var a=n(115),r=n(42);e.exports=function(e,i){for(var n=0,l=(i=a(i,e)).length;null!=e&&n<l;)e=e[r(i[n++])];return n&&n==l?e:void 0}},function(e,i,n){var a=n(13),r=n(65),l=n(244),t=n(247);e.exports=function(e,i){return a(e)?e:r(e,i)?[e]:l(t(e))}},function(e,i,n){},function(e,i,n){},function(e,i,n){var a=n(181),r=n(186),l=n(256),t=n(264),d=n(273),m=n(143),s=l((function(e){var i=m(e);return d(i)&&(i=void 0),t(a(e,1,d,!0),r(i,2))}));e.exports=s},function(e,i,n){"use strict";
10/*!
11 * escape-html
12 * Copyright(c) 2012-2013 TJ Holowaychuk
13 * Copyright(c) 2015 Andreas Lubbe
14 * Copyright(c) 2015 Tiancheng "Timothy" Gu
15 * MIT Licensed
16 */var a=/["'&<>]/;e.exports=function(e){var i,n=""+e,r=a.exec(n);if(!r)return n;var l="",t=0,d=0;for(t=r.index;t<n.length;t++){switch(n.charCodeAt(t)){case 34:i="&quot;";break;case 38:i="&amp;";break;case 39:i="&#39;";break;case 60:i="&lt;";break;case 62:i="&gt;";break;default:continue}d!==t&&(l+=n.substring(d,t)),d=t+1,l+=i}return d!==t?l+n.substring(d,t):l}},function(e,i){var n=/^\s+|\s+$/g,a=/^[-+]0x[0-9a-f]+$/i,r=/^0b[01]+$/i,l=/^0o[0-7]+$/i,t=parseInt,d="object"==typeof global&&global&&global.Object===Object&&global,m="object"==typeof self&&self&&self.Object===Object&&self,s=d||m||Function("return this")(),u=Object.prototype.toString,k=Math.max,o=Math.min,y=function(){return s.Date.now()};function b(e){var i=typeof e;return!!e&&("object"==i||"function"==i)}function g(e){if("number"==typeof e)return e;if(function(e){return"symbol"==typeof e||function(e){return!!e&&"object"==typeof e}(e)&&"[object Symbol]"==u.call(e)}(e))return NaN;if(b(e)){var i="function"==typeof e.valueOf?e.valueOf():e;e=b(i)?i+"":i}if("string"!=typeof e)return 0===e?e:+e;e=e.replace(n,"");var d=r.test(e);return d||l.test(e)?t(e.slice(2),d?2:8):a.test(e)?NaN:+e}e.exports=function(e,i,n){var a,r,l,t,d,m,s=0,u=!1,c=!1,H=!0;if("function"!=typeof e)throw new TypeError("Expected a function");function p(i){var n=a,l=r;return a=r=void 0,s=i,t=e.apply(l,n)}function S(e){return s=e,d=setTimeout(h,i),u?p(e):t}function z(e){var n=e-m;return void 0===m||n>=i||n<0||c&&e-s>=l}function h(){var e=y();if(z(e))return K(e);d=setTimeout(h,function(e){var n=i-(e-m);return c?o(n,l-(e-s)):n}(e))}function K(e){return d=void 0,H&&a?p(e):(a=r=void 0,t)}function v(){var e=y(),n=z(e);if(a=arguments,r=this,m=e,n){if(void 0===d)return S(m);if(c)return d=setTimeout(h,i),p(m)}return void 0===d&&(d=setTimeout(h,i)),t}return i=g(i)||0,b(n)&&(u=!!n.leading,l=(c="maxWait"in n)?k(g(n.maxWait)||0,i):l,H="trailing"in n?!!n.trailing:H),v.cancel=function(){void 0!==d&&clearTimeout(d),s=0,a=m=r=d=void 0},v.flush=function(){return void 0===d?t:K(y())},v}},function(e,i,n){"use strict";var a=n(91),r=n(17);e.exports=function(e,i,n){return n.get&&a(n.get,i,{getter:!0}),n.set&&a(n.set,i,{setter:!0}),r.f(e,i,n)}},function(e,i,n){"use strict";var a=n(10),r=n(33),l=n(30),t=n(176),d=n(177);a({target:"Array",proto:!0,arity:1,forced:n(1)((function(){return 4294967297!==[].push.call({length:4294967296},1)}))||!function(){try{Object.defineProperty([],"length",{writable:!1}).push()}catch(e){return e instanceof TypeError}}()},{push:function(e){var i=r(this),n=l(i),a=arguments.length;d(n+a);for(var m=0;m<a;m++)i[n]=arguments[m],n++;return t(i,n),n}})},function(e,i,n){"use strict";var a=n(4),r=n(11);e.exports=function(e,i,n){try{return a(r(Object.getOwnPropertyDescriptor(e,i)[n]))}catch(e){}}},function(e,i,n){"use strict";var a=n(69);e.exports=function(e,i){return void 0===e?arguments.length<2?"":i:a(e)}},function(e,i,n){"use strict";var a=n(174),r=n(2),l=n(18),t=n(15)("toStringTag"),d=Object,m="Arguments"===l(function(){return arguments}());e.exports=a?l:function(e){var i,n,a;return void 0===e?"Undefined":null===e?"Null":"string"==typeof(n=function(e,i){try{return e[i]}catch(e){}}(i=d(e),t))?n:m?l(i):"Object"===(a=l(i))&&r(i.callee)?"Arguments":a}},function(e,i,n){"use strict";var a=n(10),r=n(25),l=n(6),t=n(4),d=n(1),m=n(81),s=n(2),u=n(9),k=n(46),o=n(178),y=n(53),b=n(18),g=n(179),c=n(93).includes,H=n(8),p=n(69),S=n(142),z=n(50),h=n(48),K=n(180),v=String,A=TypeError,T=r("JSON","stringify"),f=r("BigInt"),B=t("".valueOf),R=t((!0).valueOf),Y=f&&t(f.prototype.valueOf),N=t(/./.exec),P=t("".charAt),O=t("".charCodeAt),D=t("".replace),I=t("".slice),E=t([].push),Z=t([].pop),G=t(1.1.toString),V=/[\uD800-\uDFFF]/g,C=/^[\uD800-\uDBFF]$/,M=/^[\uDC00-\uDFFF]$/,F=/^\d+$/,_=z(),L=z(),x=z(),U=_.length,j=L.length,w=!h||d((function(){var e=r("Symbol")("stringify detection");return"[null]"!==T([e])||"{}"!==T({a:e})||"{}"!==T(Object(e))})),$=d((function(){return'"\\udf06\\ud834"'!==T("\udf06\ud834")||'"\\udead"'!==T("\udead")})),J=K?r("JSON","isRawJSON"):o,X=w?function(e,i,n){return T(e,(function(e,n){var a=l(i,this,e,n);if(!y(a))return a}),n)}:T,W=function(e,i,n){var a=P(n,i-1),r=P(n,i+1);return N(C,e)&&!N(M,r)||N(M,e)&&!N(C,a)?"\\u"+G(O(e,0),16):e},q=function(e,i){try{return e(i),!0}catch(e){return!1}},Q=function(e){if(!u(e)||s(e)||m(e))return!1;try{return!function(e){var i=b(e);return"Number"===i&&q(g,e)||"String"===i&&q(B,e)||"Boolean"===i&&q(R,e)||!!Y&&"BigInt"===i&&q(Y,e)}(e)}catch(e){return!0}},ee=function(e,i){return{toJSON:function(){var n=e[i];if(u(n)||"bigint"==typeof n){var a=n.toJSON;s(a)&&(n=l(a,n,i))}return n}}};T&&a({target:"JSON",stat:!0,arity:3,forced:w||$||!K},{stringify:function(e,i,n){var a,r=s(i)?i:void 0,t=r?void 0:function(e){if(m(e)){for(var i=e.length,n=[],a=k(null),r=0;r<i;r++){var l,t=e[r];if("string"==typeof t)l=t;else{if("number"!=typeof t&&"Number"!==b(t)&&"String"!==b(t))continue;l=p(t)}H(a,l)||(a[l]=!0,E(n,l))}return n}}(i),d=t&&function(e){for(var i=0,n=e.length;i<n;i++)if(N(F,e[i]))return L;return""}(t),u=[],o=[],y=[],g=!1,z=!0,h=X(e,(function(e,i){if(e=v(e),t){if(e===x)return Z(o),void(a=Z(y));if(z)z=!1;else if(this!==a&&!m(this)&&!c(t,e))return}else r&&(i=l(r,this,e,i));if(J(i))return K?i:(g=!0,_+(E(u,i.rawJSON)-1));if(t&&Q(i)){if(c(o,i))throw new A("Converting circular structure to JSON");var n=function(e,i,n){for(var a=k(null),r=0,l=i.length;r<l;r++){var t=i[r];a[n+t]=ee(e,t)}return a[x]=null,a}(i,t,d);return E(o,i),E(y,a),a=n,d&&(g=!0),n}return i}),n);if("string"!=typeof h)return h;if($&&(h=D(h,V,W)),!g)return h;for(var T="",f=h.length,B=0;B<f;B++){var R=P(h,B);if('"'===R){var Y=S(h,++B).end-1,O=I(h,B,Y);I(O,0,U)===_?T+=u[I(O,U)]:I(O,0,j)===L?T+='"'+I(O,j)+'"':T+='"'+O+'"',B=Y}else T+=R}return T}})},function(e,i,n){"use strict";var a=n(7),r=n(17),l=n(34);e.exports=function(e,i,n){a?r.f(e,i,l(0,n)):e[i]=n}},function(e,i,n){"use strict";var a=n(10),r=n(165).left,l=n(166),t=n(78);a({target:"Array",proto:!0,forced:!n(135)&&t>79&&t<83||!l("reduce")},{reduce:function(e){var i=arguments.length;return r(this,e,i,i>1?arguments[1]:void 0)}})},function(e,i,n){"use strict";var a=n(10),r=n(44),l=n(11),t=n(5),d=n(23),m=n(12),s=n(26),u=n(80),k=n(1),o=TypeError,y=k((function(){[].keys().reduce((function(){}),void 0)})),b=!y&&s("reduce",o);a({target:"Iterator",proto:!0,real:!0,forced:y||b},{reduce:function(e){t(this);try{l(e)}catch(e){m(this,"throw",e)}var i=arguments.length<2,n=i?void 0:arguments[1];if(b)return u(b,this,i?[e]:[e,n]);var a=d(this),s=0;if(r(a,(function(a){i?(i=!1,n=a):n=e(n,a,s),s++}),{IS_RECORD:!0}),i)throw new o("Reduce of empty iterator with no initial value");return n}})},function(e,i,n){"use strict";var a=n(10),r=n(3),l=n(80),t=n(138),d=r.WebAssembly,m=7!==new Error("e",{cause:7}).cause,s=function(e,i){var n={};n[e]=t(e,i,m),a({global:!0,constructor:!0,arity:1,forced:m},n)},u=function(e,i){if(d&&d[e]){var n={};n[e]=t("WebAssembly."+e,i,m),a({target:"WebAssembly",stat:!0,constructor:!0,arity:1,forced:m},n)}};s("Error",(function(e){return function(i){return l(e,this,arguments)}})),s("EvalError",(function(e){return function(i){return l(e,this,arguments)}})),s("RangeError",(function(e){return function(i){return l(e,this,arguments)}})),s("ReferenceError",(function(e){return function(i){return l(e,this,arguments)}})),s("SyntaxError",(function(e){return function(i){return l(e,this,arguments)}})),s("TypeError",(function(e){return function(i){return l(e,this,arguments)}})),s("URIError",(function(e){return function(i){return l(e,this,arguments)}})),u("CompileError",(function(e){return function(i){return l(e,this,arguments)}})),u("LinkError",(function(e){return function(i){return l(e,this,arguments)}})),u("RuntimeError",(function(e){return function(i){return l(e,this,arguments)}}))},function(e,i,n){"use strict";var a=n(21),r=n(141),l=n(175),t=Error.captureStackTrace;e.exports=function(e,i,n,d){l&&(t?t(e,i):a(e,"stack",r(n,d)))}},function(e,i,n){"use strict";var a=n(6),r=n(9),l=n(53),t=n(35),d=n(147),m=n(15),s=TypeError,u=m("toPrimitive");e.exports=function(e,i){if(!r(e)||l(e))return e;var n,m=t(e,u);if(m){if(void 0===i&&(i="default"),n=a(m,e,i),!r(n)||l(n))return n;throw new s("Can't convert object to primitive value")}return void 0===i&&(i="number"),d(e,i)}},function(e,i,n){"use strict";var a=n(68),r=Math.min;e.exports=function(e){var i=a(e);return i>0?r(i,9007199254740991):0}},function(e,i,n){"use strict";var a=n(32),r=TypeError;e.exports=function(e,i){if(a(i,e))return e;throw new r("Incorrect invocation")}},function(e,i,n){"use strict";var a=n(136);e.exports="NODE"===a},function(e,i,n){"use strict";var a=n(3),r=n(86),l=n(18),t=function(e){return r.slice(0,e.length)===e};

16e.exports=t("Bun/")?"BUN":t("Cloudflare-Workers")?"CLOUDFLARE":t("Deno/")?"DENO":t("Node.js/")?"NODE":a.Bun&&"string"==typeof Bun.version?"BUN":a.Deno&&"object"==typeof Deno.version?"DENO":"process"===l(a.process)?"NODE":a.window&&a.document?"BROWSER":"REST"},function(e,i,n){"use strict";var a=n(167),r=n(11),l=n(36),t=a(a.bind);e.exports=function(e,i){return r(e),void 0===i?e:l?t(e,i):function(){return e.apply(i,arguments)}}},function(e,i,n){"use strict";var a=n(25),r=n(8),l=n(21),t=n(32),d=n(73),m=n(74),s=n(173),u=n(139),k=n(124),o=n(140),y=n(131),b=n(7),g=n(20);e.exports=function(e,i,n,c){var H=c?2:1,p=e.split("."),S=p[p.length-1],z=a.apply(null,p);if(z){var h=z.prototype;if(!g&&r(h,"cause")&&delete h.cause,!n)return z;var K=a("Error"),v=i((function(e,i){var n=k(c?i:e,void 0),a=c?new z(e):new z;return void 0!==n&&l(a,"message",n),y(a,v,a.stack,2),this&&t(h,this)&&u(a,this,v),arguments.length>H&&o(a,arguments[H]),a}));if(v.prototype=h,"Error"!==S?d?d(v,K):m(v,K,{name:!0}):b&&"stackTraceLimit"in z&&(s(v,z,"stackTraceLimit"),s(v,z,"prepareStackTrace")),m(v,z),!g)try{h.name!==S&&l(h,"name",S),h.constructor=v}catch(e){}return v}}},function(e,i,n){"use strict";var a=n(2),r=n(9),l=n(73);e.exports=function(e,i,n){var t,d;return l&&a(t=i.constructor)&&t!==n&&r(d=t.prototype)&&d!==n.prototype&&l(e,d),e}},function(e,i,n){"use strict";var a=n(9),r=n(21);e.exports=function(e,i){a(i)&&"cause"in i&&r(e,"cause",i.cause)}},function(e,i,n){"use strict";var a=n(4),r=Error,l=a("".replace),t=String(new r("zxcasd").stack),d=/\n\s*at [^:]*:[^\n]*/,m=d.test(t);e.exports=function(e,i){if(m&&"string"==typeof e&&!r.prepareStackTrace)for(;i--;)e=l(e,d,"");return e}},function(e,i,n){"use strict";var a=n(4),r=n(8),l=SyntaxError,t=parseInt,d=String.fromCharCode,m=a("".charAt),s=a("".slice),u=a(/./.exec),k={'\\"':'"',"\\\\":"\\","\\/":"/","\\b":"\b","\\f":"\f","\\n":"\n","\\r":"\r","\\t":"\t"},o=/^[\da-f]{4}$/i,y=/^[\u0000-\u001F]$/;e.exports=function(e,i){for(var n=!0,a="";i<e.length;){var b=m(e,i);if("\\"===b){var g=s(e,i,i+2);if(r(k,g))a+=k[g],i+=2;else{if("\\u"!==g)throw new l('Unknown escape sequence: "'+g+'"');var c=s(e,i+=2,i+4);if(!u(o,c))throw new l("Bad Unicode escape at: "+i);a+=d(t(c,16)),i+=4}}else{if('"'===b){n=!1,i++;break}if(u(y,b))throw new l("Bad control character in string literal at: "+i);a+=b,i++}}if(n)throw new l("Unterminated string at: "+i);return{value:a,end:i}}},function(e,i){e.exports=function(e){var i=null==e?0:e.length;return i?e[i-1]:void 0}},function(e,i,n){var a=n(114);e.exports=function(e,i,n){var r=null==e?void 0:a(e,i);return void 0===r?n:r}},function(e,i,n){e.exports=n(278)},function(e,i,n){"use strict";var a={}.propertyIsEnumerable,r=Object.getOwnPropertyDescriptor,l=r&&!a.call({1:2},1);i.f=l?function(e){var i=r(this,e);return!!i&&i.enumerable}:a},function(e,i,n){"use strict";var a=n(6),r=n(2),l=n(9),t=TypeError;e.exports=function(e,i){var n,d;if("string"===i&&r(n=e.toString)&&!l(d=a(n,e)))return d;if(r(n=e.valueOf)&&!l(d=a(n,e)))return d;if("string"!==i&&r(n=e.toString)&&!l(d=a(n,e)))return d;throw new t("Can't convert object to primitive value")}},function(e,i,n){"use strict";var a=n(7),r=n(8),l=Function.prototype,t=a&&Object.getOwnPropertyDescriptor,d=r(l,"name"),m=d&&"something"===function(){}.name,s=d&&(!a||a&&t(l,"name").configurable);e.exports={EXISTS:d,PROPER:m,CONFIGURABLE:s}},function(e,i,n){"use strict";var a=n(4),r=n(2),l=n(54),t=a(Function.toString);r(l.inspectSource)||(l.inspectSource=function(e){return t(e)}),e.exports=l.inspectSource},function(e,i,n){"use strict";var a=n(3),r=n(2),l=a.WeakMap;e.exports=r(l)&&/native code/.test(String(l))},function(e,i,n){"use strict";var a=n(25),r=n(4),l=n(152),t=n(155),d=n(5),m=r([].concat);e.exports=a("Reflect","ownKeys")||function(e){var i=l.f(d(e)),n=t.f;return n?m(i,n(e)):i}},function(e,i,n){"use strict";var a=n(92),r=n(58).concat("length","prototype");i.f=Object.getOwnPropertyNames||function(e){return a(e,r)}},function(e,i,n){"use strict";var a=n(68),r=Math.max,l=Math.min;e.exports=function(e,i){var n=a(e);return n<0?r(n+i,0):l(n,i)}},function(e,i,n){"use strict";var a=Math.ceil,r=Math.floor;e.exports=Math.trunc||function(e){var i=+e;return(i>0?r:a)(i)}},function(e,i,n){"use strict";i.f=Object.getOwnPropertySymbols},function(e,i,n){"use strict";var a=n(1),r=n(2),l=/#|\.prototype\./,t=function(e,i){var n=m[d(e)];return n===u||n!==s&&(r(i)?a(i):!!i)},d=t.normalize=function(e){return String(e).replace(l,".").toLowerCase()},m=t.data={},s=t.NATIVE="N",u=t.POLYFILL="P";e.exports=t},function(e,i,n){"use strict";var a=n(1);e.exports=!a((function(){function e(){}return e.prototype.constructor=null,Object.getPrototypeOf(new e)!==e.prototype}))},function(e,i,n){"use strict";var a=n(7),r=n(90),l=n(17),t=n(5),d=n(37),m=n(159);i.f=a&&!r?Object.defineProperties:function(e,i){t(e);for(var n,a=d(i),r=m(i),s=r.length,u=0;s>u;)l.f(e,n=r[u++],a[n]);return e}},function(e,i,n){"use strict";var a=n(92),r=n(58);e.exports=Object.keys||function(e){return a(e,r)}},function(e,i,n){"use strict";var a=n(25);e.exports=a("document","documentElement")},function(e,i,n){"use strict";var a=n(45);e.exports=function(e,i,n){for(var r in i)a(e,r,i[r],n);return e}},function(e,i,n){"use strict";e.exports=function(e,i){return{value:e,done:i}}},function(e,i,n){"use strict";var a=n(12);e.exports=function(e,i,n){for(var r=e.length-1;r>=0;r--)if(void 0!==e[r])try{n=a(e[r].iterator,i,n)}catch(e){i="throw",n=e}if("throw"===i)throw n;return n}},function(e,i,n){"use strict";e.exports=function(e){e.iterator=e.next=e.nextHandler=e.mapper=e.predicate=e.inner=e.iterables=e.iters=e.openIters=e.padding=e.finishResults=e.buffer=null}},function(e,i,n){"use strict";var a=n(11),r=n(33),l=n(77),t=n(30),d=TypeError,m="Reduce of empty array with

16no initial value",s=function(e){return function(i,n,s,u){var k=r(i),o=l(k),y=t(k);if(a(n),0===y&&s<2)throw new d(m);var b=e?y-1:0,g=e?-1:1;if(s<2)for(;;){if(b in o){u=o[b],b+=g;break}if(b+=g,e?b<0:y<=b)throw new d(m)}for(;e?b>=0:y>b;b+=g)b in o&&(u=n(u,o[b],b,k));return u}};e.exports={left:s(!1),right:s(!0)}},function(e,i,n){"use strict";var a=n(1);e.exports=function(e,i){var n=[][e];return!!n&&a((function(){n.call(null,i||function(){return 1},1)}))}},function(e,i,n){"use strict";var a=n(18),r=n(4);e.exports=function(e){if("Function"===a(e))return r(e)}},function(e,i,n){"use strict";var a=n(15),r=n(169),l=a("iterator"),t=Array.prototype;e.exports=function(e){return void 0!==e&&(r.Array===e||t[l]===e)}},function(e,i,n){"use strict";e.exports=Object.create?Object.create(null):{}},function(e,i,n){"use strict";var a=n(6),r=n(2),l=n(5),t=n(49),d=n(79),m=TypeError;e.exports=function(e,i){var n=arguments.length<2?d(e):i;if(r(n))return l(a(n,e));throw new m(t(e)+" is not iterable")}},function(e,i,n){"use strict";var a=n(172),r=String,l=TypeError;e.exports=function(e){if(a(e))return e;throw new l("Can't set "+r(e)+" as a prototype")}},function(e,i,n){"use strict";var a=n(9);e.exports=function(e){return a(e)||null===e}},function(e,i,n){"use strict";var a=n(17).f;e.exports=function(e,i,n){n in e||a(e,n,{configurable:!0,get:function(){return i[n]},set:function(e){i[n]=e}})}},function(e,i,n){"use strict";var a={};a[n(15)("toStringTag")]="z",e.exports="[object z]"===String(a)},function(e,i,n){"use strict";var a=n(1),r=n(34);e.exports=!a((function(){var e=new Error("a");return!("stack"in e)||(Object.defineProperty(e,"stack",r(1,7)),7!==e.stack)}))},function(e,i,n){"use strict";var a=n(7),r=n(81),l=TypeError,t=Object.getOwnPropertyDescriptor,d=a&&!function(){if(void 0!==this)return!0;try{Object.defineProperty([],"length",{writable:!1}).length=1}catch(e){return e instanceof TypeError}}();e.exports=d?function(e,i){if(r(e)&&!t(e,"length").writable)throw new l("Cannot set read only .length");return e.length=i}:function(e,i){return e.length=i}},function(e,i,n){"use strict";var a=TypeError;e.exports=function(e){if(e>9007199254740991)throw new a("Maximum allowed index exceeded");return e}},function(e,i,n){"use strict";var a=n(9),r=n(51).get;e.exports=function(e){if(!a(e))return!1;var i=r(e);return!!i&&"RawJSON"===i.type}},function(e,i,n){"use strict";var a=n(4);e.exports=a(1.1.valueOf)},function(e,i,n){"use strict";var a=n(1);e.exports=!a((function(){var e=JSON.rawJSON("9007199254740993");return!JSON.isRawJSON(e)||"9007199254740993"!==JSON.stringify(e)}))},function(e,i,n){var a=n(96),r=n(182);e.exports=function e(i,n,l,t,d){var m=-1,s=i.length;for(l||(l=r),d||(d=[]);++m<s;){var u=i[m];n>0&&l(u)?n>1?e(u,n-1,l,t,d):a(d,u):t||(d[d.length]=u)}return d}},function(e,i,n){var a=n(28),r=n(59),l=n(13),t=a?a.isConcatSpreadable:void 0;e.exports=function(e){return l(e)||r(e)||!!(t&&e&&e[t])}},function(e,i,n){var a=n(27),r=n(22);e.exports=function(e){return r(e)&&"[object Arguments]"==a(e)}},function(e,i,n){var a=n(28),r=Object.prototype,l=r.hasOwnProperty,t=r.toString,d=a?a.toStringTag:void 0;e.exports=function(e){var i=l.call(e,d),n=e[d];try{e[d]=void 0;var a=!0}catch(e){}var r=t.call(e);return a&&(i?e[d]=n:delete e[d]),r}},function(e,i){var n=Object.prototype.toString;e.exports=function(e){return n.call(e)}},function(e,i,n){var a=n(187),r=n(243),l=n(67),t=n(13),d=n(253);e.exports=function(e){return"function"==typeof e?e:null==e?l:"object"==typeof e?t(e)?r(e[0],e[1]):a(e):d(e)}},function(e,i,n){var a=n(188),r=n(242),l=n(113);e.exports=function(e){var i=r(e);return 1==i.length&&i[0][2]?l(i[0][0],i[0][1]):function(n){return n===e||a(n,e,i)}}},function(e,i,n){var a=n(98),r=n(102);e.exports=function(e,i,n,l){var t=n.length,d=t,m=!l;if(null==e)return!d;for(e=Object(e);t--;){var s=n[t];if(m&&s[2]?s[1]!==e[s[0]]:!(s[0]in e))return!1}for(;++t<d;){var u=(s=n[t])[0],k=e[u],o=s[1];if(m&&s[2]){if(void 0===k&&!(u in e))return!1}else{var y=new a;if(l)var b=l(k,o,u,e,i,y);if(!(void 0===b?r(o,k,3,l,y):b))return!1}}return!0}},function(e,i){e.exports=function(){this.__data__=[],this.size=0}},function(e,i,n){var a=n(39),r=Array.prototype.splice;e.exports=function(e){var i=this.__data__,n=a(i,e);return!(n<0)&&(n==i.length-1?i.pop():r.call(i,n,1),--this.size,!0)}},function(e,i,n){var a=n(39);e.exports=function(e){var i=this.__data__,n=a(i,e);return n<0?void 0:i[n][1]}},function(e,i,n){var a=n(39);e.exports=function(e){return a(this.__data__,e)>-1}},function(e,i,n){var a=n(39);e.exports=function(e,i){var n=this.__data__,r=a(n,e);return r<0?(++this.size,n.push([e,i])):n[r][1]=i,this}},function(e,i,n){var a=n(38);e.exports=function(){this.__data__=new a,this.size=0}},function(e,i){e.exports=function(e){var i=this.__data__,n=i.delete(e);return this.size=i.size,n}},function(e,i){e.exports=function(e){return this.__data__.get(e)}},function(e,i){e.exports=function(e){return this.__data__.has(e)}},function(e,i,n){var a=n(38),r=n(60),l=n(62);e.exports=function(e,i){var n=this.__data__;if(n instanceof a){var t=n.__data__;if(!r||t.length<199)return t.push([e,i]),this.size=++n.size,this;n=this.__data__=new l(t)}return n.set(e,i),this.size=n.size,this}},function(e,i,n){var a=n(100),r=n(200),l=n(61),t=n(101),d=/^\[object .+?Constructor\]$/,m=Function.prototype,s=Object.prototype,u=m.toString,k=s.hasOwnProperty,o=RegExp("^"+u.call(k).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");e.exports=function(e){return!(!l(e)||r(e))&&(a(e)?o:d).test(t(e))}}

vendor: 6,524 bytes, line 16

16,function(e,i,n){var a,r=n(201),l=(a=/[^.]+$/.exec(r&&r.keys&&r.keys.IE_PROTO||""))?"Symbol(src)_1."+a:"";e.exports=function(e){return!!l&&l in e}},function(e,i,n){var a=n(14)["__core-js_shared__"];e.exports=a},function(e,i){e.exports=function(e,i){return null==e?void 0:e[i]}},function(e,i,n){var a=n(204),r=n(38),l=n(60);e.exports=function(){this.size=0,this.__data__={hash:new a,map:new(l||r),string:new a}}},function(e,i,n){var a=n(205),r=n(206),l=n(207),t=n(208),d=n(209);function m(e){var i=-1,n=null==e?0:e.length;for(this.clear();++i<n;){var a=e[i];this.set(a[0],a[1])}}m.prototype.clear=a,m.prototype.delete=r,m.prototype.get=l,m.prototype.has=t,m.prototype.set=d,e.exports=m},function(e,i,n){var a=n(40);e.exports=function(){this.__data__=a?a(null):{},this.size=0}},function(e,i){e.exports=function(e){var i=this.has(e)&&delete this.__data__[e];return this.size-=i?1:0,i}},function(e,i,n){var a=n(40),r=Object.prototype.hasOwnProperty;e.exports=function(e){var i=this.__data__;if(a){var n=i[e];return"__lodash_hash_undefined__"===n?void 0:n}return r.call(i,e)?i[e]:void 0}},function(e,i,n){var a=n(40),r=Object.prototype.hasOwnProperty;e.exports=function(e){var i=this.__data__;return a?void 0!==i[e]:r.call(i,e)}},function(e,i,n){var a=n(40);e.exports=function(e,i){var n=this.__data__;return this.size+=this.has(e)?0:1,n[e]=a&&void 0===i?"__lodash_hash_undefined__":i,this}},function(e,i,n){var a=n(41);e.exports=function(e){var i=a(this,e).delete(e);return this.size-=i?1:0,i}},function(e,i){e.exports=function(e){var i=typeof e;return"string"==i||"number"==i||"symbol"==i||"boolean"==i?"__proto__"!==e:null===e}},function(e,i,n){var a=n(41);e.exports=function(e){return a(this,e).get(e)}},function(e,i,n){var a=n(41);e.exports=function(e){return a(this,e).has(e)}},function(e,i,n){var a=n(41);e.exports=function(e,i){var n=a(this,e),r=n.size;return n.set(e,i),this.size+=n.size==r?0:1,this}},function(e,i,n){var a=n(98),r=n(103),l=n(219),t=n(222),d=n(238),m=n(13),s=n(107),u=n(109),k="[object Object]",o=Object.prototype.hasOwnProperty;e.exports=function(e,i,n,y,b,g){var c=m(e),H=m(i),p=c?"[object Array]":d(e),S=H?"[object Array]":d(i),z=(p="[object Arguments]"==p?k:p)==k,h=(S="[object Arguments]"==S?k:S)==k,K=p==S;if(K&&s(e)){if(!s(i))return!1;c=!0,z=!1}if(K&&!z)return g||(g=new a),c||u(e)?r(e,i,n,y,b,g):l(e,i,p,n,y,b,g);if(!(1&n)){var v=z&&o.call(e,"__wrapped__"),A=h&&o.call(i,"__wrapped__");if(v||A){var T=v?e.value():e,f=A?i.value():i;return g||(g=new a),b(T,f,n,y,g)}}return!!K&&(g||(g=new a),t(e,i,n,y,b,g))}},function(e,i){e.exports=function(e){return this.__data__.set(e,"__lodash_hash_undefined__"),this}},function(e,i){e.exports=function(e){return this.__data__.has(e)}},function(e,i){e.exports=function(e,i){for(var n=-1,a=null==e?0:e.length;++n<a;)if(i(e[n],n,e))return!0;return!1}},function(e,i,n){var a=n(28),r=n(220),l=n(99),t=n(103),d=n(221),m=n(63),s=a?a.prototype:void 0,u=s?s.valueOf:void 0;e.exports=function(e,i,n,a,s,k,o){switch(n){case"[object DataView]":if(e.byteLength!=i.byteLength||e.byteOffset!=i.byteOffset)return!1;e=e.buffer,i=i.buffer;case"[object ArrayBuffer]":return!(e.byteLength!=i.byteLength||!k(new r(e),new r(i)));case"[object Boolean]":case"[object Date]":case"[object Number]":return l(+e,+i);case"[object Error]":return e.name==i.name&&e.message==i.message;case"[object RegExp]":case"[object String]":return e==i+"";case"[object Map]":var y=d;case"[object Set]":var b=1&a;if(y||(y=m),e.size!=i.size&&!b)return!1;var g=o.get(e);if(g)return g==i;a|=2,o.set(e,i);var c=t(y(e),y(i),a,s,k,o);return o.delete(e),c;case"[object Symbol]":if(u)return u.call(e)==u.call(i)}return!1}},function(e,i,n){var a=n(14).Uint8Array;e.exports=a},function(e,i){e.exports=function(e){var i=-1,n=Array(e.size);return e.forEach((function(e,a){n[++i]=[a,e]})),n}},function(e,i,n){var a=n(223),r=Object.prototype.hasOwnProperty;e.exports=function(e,i,n,l,t,d){var m=1&n,s=a(e),u=s.length;if(u!=a(i).length&&!m)return!1;for(var k=u;k--;){var o=s[k];if(!(m?o in i:r.call(i,o)))return!1}var y=d.get(e),b=d.get(i);if(y&&b)return y==i&&b==e;var g=!0;d.set(e,i),d.set(i,e);for(var c=m;++k<u;){var H=e[o=s[k]],p=i[o];if(l)var S=m?l(p,H,o,i,e,d):l(H,p,o,e,i,d);if(!(void 0===S?H===p||t(H,p,n,l,d):S)){g=!1;break}c||(c="constructor"==o)}if(g&&!c){var z=e.constructor,h=i.constructor;z==h||!("constructor"in e)||!("constructor"in i)||"function"==typeof z&&z instanceof z&&"function"==typeof h&&h instanceof h||(g=!1)}return d.delete(e),d.delete(i),g}},function(e,i,n){var a=n(224),r=n(225),l=n(106);e.exports=function(e){return a(e,l,r)}},function(e,i,n){var a=n(96),r=n(13);e.exports=function(e,i,n){var l=i(e);return r(e)?l:a(l,n(e))}},function(e,i,n){var a=n(226),r=n(227),l=Object.prototype.propertyIsEnumerable,t=Object.getOwnPropertySymbols,d=t?function(e){return null==e?[]:(e=Object(e),a(t(e),(function(i){return l.call(e,i)})))}:r;e.exports=d},function(e,i){e.exports=function(e,i){for(var n=-1,a=null==e?0:e.length,r=0,l=[];++n<a;){var t=e[n];i(t,n,e)&&(l[r++]=t)}return l}},function(e,i){e.exports=function(){return[]}},function(e,i,n){var a=n(229),r=n(59),l=n(13),t=n(107),d=n(108),m=n(109),s=Object.prototype.hasOwnProperty;e.exports=function(e,i){var n=l(e),u=!n&&r(e),k=!n&&!u&&t(e),o=!n&&!u&&!k&&m(e),y=n||u||k||o,b=y?a(e.length,String):[],g=b.length;for(var c in e)!i&&!s.call(e,c)||y&&("length"==c||k&&("offset"==c||"parent"==c)||o&&("buffer"==c||"byteLength"==c||"byteOffset"==c)||d(c,g))||b.push(c);return b}},function(e,i){e.exports=function(e,i){for(var n=-1,a=Array(e);++n<e;)a[n]=i(n);return a}},function(e,i){e.exports=function(){return!1}},function(e,i,n){var a=n(27),r=n(64),l=n(22),t={};t["[object Float32Array]"]=t["[object Float64Array]"]=t["[object Int8Array]"]=t["[object Int16Array]"]=t["[object Int32Array]"]=t["[object Uint8Array]"]=t["[object Uint8ClampedArray]"]=t["[object Uint16Array]"]=t["[object Uint32Array]"]=!0,t["[object Arguments]"]=t["[object Array]"]=t["[object ArrayBuffer]"]=t["[object Boolean]"]=t["[object DataView]"]=t["[object Date]"]=t["[object Error]"]=t["[object Function]"]=t["[object Map]"]=t["[object Number]"]=t["[object Object]"]=t["[object RegExp]"]=t["[object Set]"]=t["[object String]"]=t["[object WeakMap]"]=!1,e.exports=function(e){return l(e)&&r(e.length)&&!!t[a(e)]}},function(e,i){e.exports=function(e){return function(i){return e(i)}}},function(e,i,n){(function(e){var a=n(97),r=i&&!i.nodeType&&i,l=r&&"object"==typeof e&&e&&!e.nodeType&&e,t=l&&l.exports===r&&a.process,d=function(){try{var e=l&&l.require&&l.require("util").t

vendor: 5,010 bytes, line 16

16ypes;return e||t&&t.binding&&t.binding("util")}catch(e){}}();e.exports=d}).call(this,n(82)(e))},function(e,i,n){var a=n(235),r=n(236),l=Object.prototype.hasOwnProperty;e.exports=function(e){if(!a(e))return r(e);var i=[];for(var n in Object(e))l.call(e,n)&&"constructor"!=n&&i.push(n);return i}},function(e,i){var n=Object.prototype;e.exports=function(e){var i=e&&e.constructor;return e===("function"==typeof i&&i.prototype||n)}},function(e,i,n){var a=n(237)(Object.keys,Object);e.exports=a},function(e,i){e.exports=function(e,i){return function(n){return e(i(n))}}},function(e,i,n){var a=n(239),r=n(60),l=n(240),t=n(111),d=n(241),m=n(27),s=n(101),u=s(a),k=s(r),o=s(l),y=s(t),b=s(d),g=m;(a&&"[object DataView]"!=g(new a(new ArrayBuffer(1)))||r&&"[object Map]"!=g(new r)||l&&"[object Promise]"!=g(l.resolve())||t&&"[object Set]"!=g(new t)||d&&"[object WeakMap]"!=g(new d))&&(g=function(e){var i=m(e),n="[object Object]"==i?e.constructor:void 0,a=n?s(n):"";if(a)switch(a){case u:return"[object DataView]";case k:return"[object Map]";case o:return"[object Promise]";case y:return"[object Set]";case b:return"[object WeakMap]"}return i}),e.exports=g},function(e,i,n){var a=n(19)(n(14),"DataView");e.exports=a},function(e,i,n){var a=n(19)(n(14),"Promise");e.exports=a},function(e,i,n){var a=n(19)(n(14),"WeakMap");e.exports=a},function(e,i,n){var a=n(112),r=n(106);e.exports=function(e){for(var i=r(e),n=i.length;n--;){var l=i[n],t=e[l];i[n]=[l,t,a(t)]}return i}},function(e,i,n){var a=n(102),r=n(144),l=n(250),t=n(65),d=n(112),m=n(113),s=n(42);e.exports=function(e,i){return t(e)&&d(i)?m(s(e),i):function(n){var t=r(n,e);return void 0===t&&t===i?l(n,e):a(i,t,3)}}},function(e,i,n){var a=n(245),r=/[^.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]|(?=(?:\.|\[\])(?:\.|\[\]|$))/g,l=/\\(\\)?/g,t=a((function(e){var i=[];return 46===e.charCodeAt(0)&&i.push(""),e.replace(r,(function(e,n,a,r){i.push(a?r.replace(l,"$1"):n||e)})),i}));e.exports=t},function(e,i,n){var a=n(246);e.exports=function(e){var i=a(e,(function(e){return 500===n.size&&n.clear(),e})),n=i.cache;return i}},function(e,i,n){var a=n(62);function r(e,i){if("function"!=typeof e||null!=i&&"function"!=typeof i)throw new TypeError("Expected a function");var n=function(){var a=arguments,r=i?i.apply(this,a):a[0],l=n.cache;if(l.has(r))return l.get(r);var t=e.apply(this,a);return n.cache=l.set(r,t)||l,t};return n.cache=new(r.Cache||a),n}r.Cache=a,e.exports=r},function(e,i,n){var a=n(248);e.exports=function(e){return null==e?"":a(e)}},function(e,i,n){var a=n(28),r=n(249),l=n(13),t=n(66),d=a?a.prototype:void 0,m=d?d.toString:void 0;e.exports=function e(i){if("string"==typeof i)return i;if(l(i))return r(i,e)+"";if(t(i))return m?m.call(i):"";var n=i+"";return"0"==n&&1/i==-1/0?"-0":n}},function(e,i){e.exports=function(e,i){for(var n=-1,a=null==e?0:e.length,r=Array(a);++n<a;)r[n]=i(e[n],n,e);return r}},function(e,i,n){var a=n(251),r=n(252);e.exports=function(e,i){return null!=e&&r(e,i,a)}},function(e,i){e.exports=function(e,i){return null!=e&&i in Object(e)}},function(e,i,n){var a=n(115),r=n(59),l=n(13),t=n(108),d=n(64),m=n(42);e.exports=function(e,i,n){for(var s=-1,u=(i=a(i,e)).length,k=!1;++s<u;){var o=m(i[s]);if(!(k=null!=e&&n(e,o)))break;e=e[o]}return k||++s!=u?k:!!(u=null==e?0:e.length)&&d(u)&&t(o,u)&&(l(e)||r(e))}},function(e,i,n){var a=n(254),r=n(255),l=n(65),t=n(42);e.exports=function(e){return l(e)?a(t(e)):r(e)}},function(e,i){e.exports=function(e){return function(i){return null==i?void 0:i[e]}}},function(e,i,n){var a=n(114);e.exports=function(e){return function(i){return a(i,e)}}},function(e,i,n){var a=n(67),r=n(257),l=n(259);e.exports=function(e,i){return l(r(e,i,a),e+"")}},function(e,i,n){var a=n(258),r=Math.max;e.exports=function(e,i,n){return i=r(void 0===i?e.length-1:i,0),function(){for(var l=arguments,t=-1,d=r(l.length-i,0),m=Array(d);++t<d;)m[t]=l[i+t];t=-1;for(var s=Array(i+1);++t<i;)s[t]=l[t];return s[i]=n(m),a(e,this,s)}}},function(e,i){e.exports=function(e,i,n){switch(n.length){case 0:return e.call(i);case 1:return e.call(i,n[0]);case 2:return e.call(i,n[0],n[1]);case 3:return e.call(i,n[0],n[1],n[2])}return e.apply(i,n)}},function(e,i,n){var a=n(260),r=n(263)(a);e.exports=r},function(e,i,n){var a=n(261),r=n(262),l=n(67),t=r?function(e,i){return r(e,"toString",{configurable:!0,enumerable:!1,value:a(i),writable:!0})}:l;e.exports=t},function(e,i){e.exports=function(e){return function(){return e}}},function(e,i,n){var a=n(19),r=function(){try{var e=a(Object,"defineProperty");return e({},"",{}),e}catch(e){}}();e.exports=r},function(e,i){var n=Date.now;e.exports=function(e){var i=0,a=0;return function(){var r=n(),l=16-(r-a);if(a=r,l>0){if(++i>=800)return arguments[0]}else i=0;return e.apply(void 0,arguments)}}},function(e,i,n){var a=n(104),r=n(265),l=n(270),t=n(105),d=n(271),m=n(63);e.exports=function(e,i,n){var s=-1,u=r,k=e.length,o=!0,y=[],b=y;if(n)o=!1,u=l;else if(k>=200){var g=i?null:d(e);if(g)return m(g);o=!1,u=t,b=new a}else b=i?[]:y;e:for(;++s<k;){var c=e[s],H=i?i(c):c;

16if(c=n||0!==c?c:0,o&&H==H){for(var p=b.length;p--;)if(b[p]===H)continue e;i&&b.push(H),y.push(c)}else u(b,H,n)||(b!==y&&b.push(H),y.push(c))}return y}},function(e,i,n){var a=n(266);e.exports=function(e,i){return!!(null==e?0:e.length)&&a(e,i,0)>-1}},function(e,i,n){var a=n(267),r=n(268),l=n(269);e.exports=function(e,i,n){return i==i?l(e,i,n):a(e,r,n)}},function(e,i){e.exports=function(e,i,n,a){for(var r=e.length,l=n+(a?1:-1);a?l--:++l<r;)if(i(e[l],l,e))return l;return-1}},function(e,i){e.exports=function(e){return e!=e}},function(e,i){e.exports=function(e,i,n){for(var a=n-1,r=e.length;++a<r;)if(e[a]===i)return a;return-1}},function(e,i){e.exports=function(e,i,n){for(var a=-1,r=null==e?0:e.length;++a<r;)if(n(i,e[a]))return!0;return!1}},function(e,i,n){var a=n(111),r=n(272),l=n(63),t=a&&1/l(new a([,-0]))[1]==1/0?function(e){return new a(e)}:r;e.exports=t},function(e,i){e.exports=function(){}},function(e,i,n){var a=n(110),r=n(22);e.exports=function(e){return r(e)&&a(e)}},function(e,i,n){},function(e,i,n){},function(e,i,n){"use strict";n(116)},function(e,i,n){"use strict";n(117)},function(e,i,n){"use strict";n.r(i);n(16),n(24),n(31);var a=n(0);function r(e,i){for(var n in i)e[n]=i[n];return e}var l=/[!'()*]/g,t=function(e){return"%"+e.charCodeAt(0).toString(16)},d=/%2C/g,m=function(e){return encodeURIComponent(e).replace(l,t).replace(d,",")};function s(e){try{return decodeURIComponent(e)}catch(e){0}return e}var u=function(e){return null==e||"object"==typeof e?e:String(e)};function k(e){var i={};return(e=e.trim().replace(/^(\?|#|&)/,""))?(e.split("&").forEach((function(e){var n=e.replace(/\+/g," ").split("="),a=s(n.shift()),r=n.length>0?s(n.join("=")):null;void 0===i[a]?i[a]=r:Array.isArray(i[a])?i[a].push(r):i[a]=[i[a],r]})),i):i}function o(e){var i=e?Object.keys(e).map((function(i){var n=e[i];if(void 0===n)return"";if(null===n)return m(i);if(Array.isArray(n)){var a=[];return n.forEach((function(e){void 0!==e&&(null===e?a.push(m(i)):a.push(m(i)+"="+m(e)))})),a.join("&")}return m(i)+"="+m(n)})).filter((function(e){return e.length>0})).join("&"):null;return i?"?"+i:""}var y=/\/?$/;function b(e,i,n,a){var r=a&&a.options.stringifyQuery,l=i.query||{};try{l=g(l)}catch(e){}var t={name:i.name||e&&e.name,meta:e&&e.meta||{},path:i.path||"/",hash:i.hash||"",query:l,params:i.params||{},fullPath:p(i,r),matched:e?H(e):[]};return n&&(t.redirectedFrom=p(n,r)),Object.freeze(t)}function g(e){if(Array.isArray(e))return e.map(g);if(e&&"object"==typeof e){var i={};for(var n in e)i[n]=g(e[n]);return i}return e}var c=b(null,{path:"/"});function H(e){for(var i=[];e;)i.unshift(e),e=e.parent;return i}function p(e,i){var n=e.path,a=e.query;void 0===a&&(a={});var r=e.hash;return void 0===r&&(r=""),(n||"/")+(i||o)(a)+r}function S(e,i,n){return i===c?e===i:!!i&&(e.path&&i.path?e.path.replace(y,"")===i.path.replace(y,"")&&(n||e.hash===i.hash&&z(e.query,i.query)):!(!e.name||!i.name)&&(e.name===i.name&&(n||e.hash===i.hash&&z(e.query,i.query)&&z(e.params,i.params))))}function z(e,i){if(void 0===e&&(e={}),void 0===i&&(i={}),!e||!i)return e===i;var n=Object.keys(e).sort(),a=Object.keys(i).sort();return n.length===a.length&&n.every((function(n,r){var l=e[n];if(a[r]!==n)return!1;var t=i[n];return null==l||null==t?l===t:"object"==typeof l&&"object"==typeof t?z(l,t):String(l)===String(t)}))}function h(e){for(var i=0;i<e.matched.length;i++){var n=e.matched[i];for(var a in n.instances){var r=n.instances[a],l=n.enteredCbs[a];if(r&&l){delete n.enteredCbs[a];for(var t=0;t<l.length;t++)r._isBeingDestroyed||l[t](r)}}}}var K={name:"RouterView",functional:!0,props:{name:{type:String,default:"default"}},render:function(e,i){var n=i.props,a=i.children,l=i.parent,t=i.data;t.routerView=!0;for(var d=l.$createElement,m=n.name,s=l.$route,u=l._routerViewCache||(l._routerViewCache={}),k=0,o=!1;l&&l._routerRoot!==l;){var y=l.$vnode?l.$vnode.data:{};y.routerView&&k++,y.keepAlive&&l._directInactive&&l._inactive&&(o=!0),l=l.$parent}if(t.routerViewDepth=k,o){var b=u[m],g=b&&b.component;return g?(b.configProps&&v(g,t,b.route,b.configProps),d(g,t,a)):d()}var c=s.matched[k],H=c&&c.components[m];if(!c||!H)return u[m]=null,d();u[m]={component:H},t.registerRouteInstance=function(e,i){var n=c.instances[m];(i&&n!==e||!i&&n===e)&&(c.instances[m]=i)},(t.hook||(t.hook={})).prepatch=function(e,i){c.instances[m]=i.componentInstance},t.hook.init=function(e){e.data.keepAlive&&e.componentInstance&&e.componentInstance!==c.instances[m]&&(c.instances[m]=e.componentInstance),h(s)};var p=c.props&&c.props[m];return p&&(r(u[m],{route:s,configProps:p}),v(H,t,s,p)),d(H,t,a)}};function v(e,i,n,a){var l=i.props=function(e,i){switch(typeof i){case"undefined":return;case"object":return i;case"function":return i(e);case"boolean":return i?e.params:void 0;default:0}}(n,a);if(l){l=i.props=r({},l);var t=i.attrs=i.attrs||{};for(var d in l)e.props&&d in e.props||(t[d]=l[d],delete l[d])}}function A(e,i,n){var a=e.charAt(0);if("/"===a)return e;if("?"===a||"#"===a)return i+e;var r=i.split("/");n&&r[r.length-1]||r.pop();for(var l=e.replace(/^\//,"").split("/"),t=0;t<l.length;t++){var d=l[t];".."===d?r.pop():"."!==d&&r.push(d)}return""!==r[0]&&r.unshift(""),r.join("/")}function T(e){return e.replace(/\/(?:\s*\/)+/g,"/")}var f=Array.isArray||function(e){return"[object Array]"==Object.prototype.toString.call(e)},B=F,R=D,Y=function(e,i){return E(D(e,i),i)},N=E,P=M,O=new RegExp(["(\\\\.)","([\\/.])?(?:(?:\\:(\\w+)(?:\\(((?:\\\\.|[^\\\\()])+)\\))?|\\(((?:\\\\.|[^\\\\()])+)\\))([+*?])?|(\\*))"].join("|"),"g");function D(e,i){for(var n,a=[],r=0,l=0,t="",d=i&&i.delimiter||"/";null!=(n=O.exec(e));){var m=n[0],s=n[1],u=n.index;if(t+=e.slice(l,u),l=u+m.length,s)t+=s[1];else{var k=e[l],o=n[2],y=n[3],b=n[4],g=n[5],c=n[6],H=n[7];t&&(a.push(t),t="");var p=null!=o&&null!=k&&k!==o,S="+"===c||"*"===c,z="?"===c||"*"===c,h=n[2]||d,K=b||g;a.push({name:y||r++,prefix:o||"",delimiter:h,optional:z,repeat:S,partial:p,asterisk:!!H,pattern:K?G(K):H?".*":"[^"+Z(h)+"]+?"})}}return l<e.length&&(t+=e.substr(l)),t&&a.push(t),a}function I(e){return encodeURI(e).replace(/[\/?#]/g,(function(e){return"%"+e.charCodeAt(0).toString(16).toUpperCase()}))}function E(e,i){for(var n=new Array(e.length),a=0;a<e.length;a++)"object"==typeof e[a]&&(n[a]=new RegExp("^(?:"+e[a].pattern+")$",C(i)));return function(i,a){for(var r="",l=i||{},t=(a||{}).pretty?I:encodeURIComponent,d=0;d<e.length;d++){var m=e[d];if("string"!=typeof m){var s,u=l[m.name];if(null==u){if(m.optional){m.partial&&(r+=m.prefix);continue}throw new TypeError('Expected "'+m.name+'" to be defined')}if(f(u)){if(!m.repeat)throw new TypeError('Expected "'+m.name+'" to not repeat, but received `'+JSON.stringify(u)+"`");if(0===u.length){if(m.optional)continue;throw new TypeError('Expected "'+m.name+'" to not be empty')}for(var k=0;k<u.length;k++){if(s=t(u[k]),!n[d].test(s))throw new TypeError('Expected all "'+m.name+'" to match "'+m.pattern+'", but received `'+JSON.stringify(s)+"`");r+=(0===k?m.prefix:m.delimiter)+s}}else{if(s=m.asterisk?encodeURI(u).replace(/[?#]/g,(function(e){return"%"+e.charCodeAt(0).toString(16).toUpperCase()})):t(u),!n[d].test(s))throw new TypeError('Expected "'+m.name+'" to match "'+m.pattern+'", but received "'+s+'"');r+=m.prefix+s}}else r+=m}return r}}function Z(e){return e.replace(/([.+*?=^!:${}()[\]|\/\\])/g,"\\$1")}function G(e){return e.replace(/([=!:$\/()])/g,"\\$1")}function V(e,i){return e.keys=i,e}function C(e){return e&&e.sensitive?"":"i"}function M(e,i,n){f(i)||(n=i||n,i=[]);for(var a=(n=n||{}).strict,r=!1!==n.end,l="",t=0;t<e.length;t++){var d=e[t];if("string"==typeof d)l+=Z(d);else{var m=Z(d.prefix),s="(?:"+d.pattern+")";i.push(d),d.repeat&&(s+="(?:"+m+s+")*"),l+=s=d.optional?d.partial?m+"

16("+s+")?":"(?:"+m+"("+s+"))?":m+"("+s+")"}}var u=Z(n.delimiter||"/"),k=l.slice(-u.length)===u;return a||(l=(k?l.slice(0,-u.length):l)+"(?:"+u+"(?=$))?"),l+=r?"$":a&&k?"":"(?="+u+"|$)",V(new RegExp("^"+l,C(n)),i)}function F(e,i,n){return f(i)||(n=i||n,i=[]),n=n||{},e instanceof RegExp?function(e,i){var n=e.source.match(/\((?!\?)/g);if(n)for(var a=0;a<n.length;a++)i.push({name:a,prefix:null,delimiter:null,optional:!1,repeat:!1,partial:!1,asterisk:!1,pattern:null});return V(e,i)}(e,i):f(e)?function(e,i,n){for(var a=[],r=0;r<e.length;r++)a.push(F(e[r],i,n).source);return V(new RegExp("(?:"+a.join("|")+")",C(n)),i)}(e,i,n):function(e,i,n){return M(D(e,n),i,n)}(e,i,n)}B.parse=R,B.compile=Y,B.tokensToFunction=N,B.tokensToRegExp=P;var _=Object.create(null);function L(e,i,n){i=i||{};try{var a=_[e]||(_[e]=B.compile(e));return"string"==typeof i.pathMatch&&(i[0]=i.pathMatch),a(i,{pretty:!0})}catch(e){return""}finally{delete i[0]}}function x(e,i,n,a){var l="string"==typeof e?{path:e}:e;if(l._normalized)return l;if(l.name){var t=(l=r({},e)).params;return t&&"object"==typeof t&&(l.params=r({},t)),l}if(!l.path&&l.params&&i){(l=r({},l))._normalized=!0;var d=r(r({},i.params),l.params);if(i.name)l.name=i.name,l.params=d;else if(i.matched.length){var m=i.matched[i.matched.length-1].path;l.path=L(m,d,i.path)}else 0;return l}var s=function(e){var i="",n="",a=e.indexOf("#");a>=0&&(i=e.slice(a),e=e.slice(0,a));var r=e.indexOf("?");return r>=0&&(n=e.slice(r+1),e=e.slice(0,r)),{path:e,query:n,hash:i}}(l.path||""),o=i&&i.path||"/",y=s.path?A(s.path,o,n||l.append):o,b=function(e,i,n){void 0===i&&(i={});var a,r=n||k;try{a=r(e||"")}catch(e){a={}}for(var l in i){var t=i[l];a[l]=Array.isArray(t)?t.map(u):u(t)}return a}(s.query,l.query,a&&a.options.parseQuery),g=l.hash||s.hash;return g&&"#"!==g.charAt(0)&&(g="#"+g),{_normalized:!0,path:y,query:b,hash:g}}var U,j=function(){},w={name:"RouterLink",props:{to:{type:[String,Object],required:!0},tag:{type:String,default:"a"},custom:Boolean,exact:Boolean,exactPath:Boolean,append:Boolean,replace:Boolean,activeClass:String,exactActiveClass:String,ariaCurrentValue:{type:String,default:"page"},event:{type:[String,Array],default:"click"}},render:function(e){var i=this,n=this.$router,a=this.$route,l=n.resolve(this.to,a,this.append),t=l.location,d=l.route,m=l.href,s={},u=n.options.linkActiveClass,k=n.options.linkExactActiveClass,o=null==u?"router-link-active":u,g=null==k?"router-link-exact-active":k,c=null==this.activeClass?o:this.activeClass,H=null==this.exactActiveClass?g:this.exactActiveClass,p=d.redirectedFrom?b(null,x(d.redirectedFrom),null,n):d;s[H]=S(a,p,this.exactPath),s[c]=this.exact||this.exactPath?s[H]:function(e,i){return 0===e.path.replace(y,"/").indexOf(i.path.replace(y,"/"))&&(!i.hash||e.hash===i.hash)&&function(e,i){for(var n in i)if(!(n in e))return!1;return!0}(e.query,i.query)}(a,p);var z=s[H]?this.ariaCurrentValue:null,h=function(e){$(e)&&(i.replace?n.replace(t,j):n.push(t,j))},K={click:$};Array.isArray(this.event)?this.event.forEach((function(e){K[e]=h})):K[this.event]=h;var v={class:s},A=!this.$scopedSlots.$hasNormal&&this.$scopedSlots.default&&this.$scopedSlots.default({href:m,route:d,navigate:h,isActive:s[c],isExactActive:s[H]});if(A){if(1===A.length)return A[0];if(A.length>1||!A.length)return 0===A.length?e():e("span",{},A)}if("a"===this.tag)v.on=K,v.attrs={href:m,"aria-current":z};else{var T=function e(i){var n;if(i)for(var a=0;a<i.length;a++){if("a"===(n=i[a]).tag)return n;if(n.children&&(n=e(n.children)))return n}}(this.$slots.default);if(T){T.isStatic=!1;var f=T.data=r({},T.data);for(var B in f.on=f.on||{},f.on){var R=f.on[B];B in K&&(f.on[B]=Array.isArray(R)?R:[R])}for(var Y in K)Y in f.on?f.on[Y].push(K[Y]):f.on[Y]=h;var N=T.data.attrs=r({},T.data.attrs);N.href=m,N["aria-current"]=z}else v.on=K}return e(this.tag,v,this.$slots.default)}};function $(e){if(!(e.metaKey||e.altKey||e.ctrlKey||e.shiftKey||e.defaultPrevented||void 0!==e.button&&0!==e.button)){if(e.currentTarget&&e.currentTarget.getAttribute){var i=e.currentTarget.getAttribute("target");if(/\b_blank\b/i.test(i))return}return e.preventDefault&&e.preventDefault(),!0}}var J="undefined"!=typeof window;function X(e,i,n,a,r){var l=i||[],t=n||Object.create(null),d=a||Object.create(null);e.forEach((function(e){!function e(i,n,a,r,l,t){var d=r.path,m=r.name;0;var s=r.pathToRegexpOptions||{},u=function(e,i,n){n||(e=e.replace(/\/$/,""));if("/"===e[0])return e;if(null==i)return e;return T(i.path+"/"+e)}

16(d,l,s.strict);"boolean"==typeof r.caseSensitive&&(s.sensitive=r.caseSensitive);var k={path:u,regex:W(u,s),components:r.components||{default:r.component},alias:r.alias?"string"==typeof r.alias?[r.alias]:r.alias:[],instances:{},enteredCbs:{},name:m,parent:l,matchAs:t,redirect:r.redirect,beforeEnter:r.beforeEnter,meta:r.meta||{},props:null==r.props?{}:r.components?r.props:{default:r.props}};r.children&&r.children.forEach((function(r){var l=t?T(t+"/"+r.path):void 0;e(i,n,a,r,k,l)}));n[k.path]||(i.push(k.path),n[k.path]=k);if(void 0!==r.alias)for(var o=Array.isArray(r.alias)?r.alias:[r.alias],y=0;y<o.length;++y){0;var b={path:o[y],children:r.children};e(i,n,a,b,l,k.path||"/")}m&&(a[m]||(a[m]=k))}(l,t,d,e,r)}));for(var m=0,s=l.length;m<s;m++)"*"===l[m]&&(l.push(l.splice(m,1)[0]),s--,m--);return{pathList:l,pathMap:t,nameMap:d}}function W(e,i){return B(e,[],i)}function q(e,i){var n=X(e),a=n.pathList,r=n.pathMap,l=n.nameMap;function t(e,n,t){var d=x(e,n,!1,i),s=d.name;if(s){var u=l[s];if(!u)return m(null,d);var k=u.regex.keys.filter((function(e){return!e.optional})).map((function(e){return e.name}));if("object"!=typeof d.params&&(d.params={}),n&&"object"==typeof n.params)for(var o in n.params)!(o in d.params)&&k.indexOf(o)>-1&&(d.params[o]=n.params[o]);return d.path=L(u.path,d.params),m(u,d,t)}if(d.path){d.params={};for(var y=0;y<a.length;y++){var b=a[y],g=r[b];if(Q(g.regex,d.path,d.params))return m(g,d,t)}}return m(null,d)}function d(e,n){var a=e.redirect,r="function"==typeof a?a(b(e,n,null,i)):a;if("string"==typeof r&&(r={path:r}),!r||"object"!=typeof r)return m(null,n);var d=r,s=d.name,u=d.path,k=n.query,o=n.hash,y=n.params;if(k=d.hasOwnProperty("query")?d.query:k,o=d.hasOwnProperty("hash")?d.hash:o,y=d.hasOwnProperty("params")?d.params:y,s){l[s];return t({_normalized:!0,name:s,query:k,hash:o,params:y},void 0,n)}if(u){var g=function(e,i){return A(e,i.parent?i.parent.path:"/",!0)}(u,e);return t({_normalized:!0,path:L(g,y),query:k,hash:o},void 0,n)}return m(null,n)}function m(e,n,a){return e&&e.redirect?d(e,a||n):e&&e.matchAs?function(e,i,n){var a=t({_normalized:!0,path:L(n,i.params)});if(a){var r=a.matched,l=r[r.length-1];return i.params=a.params,m(l,i)}return m(null,i)}(0,n,e.matchAs):b(e,n,a,i)}return{match:t,addRoute:function(e,i){var n="object"!=typeof e?l[e]:void 0;X([i||e],a,r,l,n),n&&n.alias.length&&X(n.alias.map((function(e){return{path:e,children:[i]}})),a,r,l,n)},getRoutes:function(){return a.map((function(e){return r[e]}))},addRoutes:function(e){X(e,a,r,l)}}}function Q(e,i,n){var a=i.match(e);if(!a)return!1;if(!n)return!0;for(var r=1,l=a.length;r<l;++r){var t=e.keys[r-1];

16t&&(n[t.name||"pathMatch"]="string"==typeof a[r]?s(a[r]):a[r])}return!0}var ee=J&&window.performance&&window.performance.now?window.performance:Date;function ie(){return ee.now().toFixed(3)}var ne=ie();function ae(){return ne}function re(e){return ne=e}var le=Object.create(null);function te(){"scrollRestoration"in window.history&&(window.history.scrollRestoration="manual");var e=window.location.protocol+"//"+window.location.host,i=window.location.href.replace(e,""),n=r({},window.history.state);return n.key=ae(),window.history.replaceState(n,"",i),window.addEventListener("popstate",se),function(){window.removeEventListener("popstate",se)}}function de(e,i,n,a){if(e.app){var r=e.options.scrollBehavior;r&&e.app.$nextTick((function(){var l=function(){var e=ae();if(e)return le[e]}(),t=r.call(e,i,n,a?l:null);t&&("function"==typeof t.then?t.then((function(e){be(e,l)})).catch((function(e){0})):be(t,l))}))}}function me(){var e=ae();e&&(le[e]={x:window.pageXOffset,y:window.pageYOffset})}function se(e){me(),e.state&&e.state.key&&re(e.state.key)}function ue(e){return oe(e.x)||oe(e.y)}function ke(e){return{x:oe(e.x)?e.x:window.pageXOffset,y:oe(e.y)?e.y:window.pageYOffset}}function oe(e){return"number"==typeof e}var ye=/^#\d/;function be(e,i){var n,a="object"==typeof e;if(a&&"string"==typeof e.selector){var r=ye.test(e.selector)?document.getElementById(e.selector.slice(1)):document.querySelector(e.selector);if(r){var l=e.offset&&"object"==typeof e.offset?e.offset:{};i=function(e,i){var n=document.documentElement.getBoundingClientRect(),a=e.getBoundingClientRect();return{x:a.left-n.left-i.x,y:a.top-n.top-i.y}}(r,l={x:oe((n=l).x)?n.x:0,y:oe(n.y)?n.y:0})}else ue(e)&&(i=ke(e))}else a&&ue(e)&&(i=ke(e));i&&("scrollBehavior"in document.documentElement.style?window.scrollTo({left:i.x,top:i.y,behavior:e.behavior}):window.scrollTo(i.x,i.y))}var ge,ce=J&&((-1===(ge=window.navigator.userAgent).indexOf("Android 2.")&&-1===ge.indexOf("Android 4.0")||-1===ge.indexOf("Mobile Safari")||-1!==ge.indexOf("Chrome")||-1!==ge.indexOf("Windows Phone"))&&window.history&&"function"==typeof window.history.pushState);function He(e,i){me();var n=window.history;try{if(i){var a=r({},n.state);a.key=ae(),n.replaceState(a,"",e)}else n.pushState({key:re(ie())},"",e)}catch(n){window.location[i?"replace":"assign"](e)}}function pe(e){He(e,!0)}var Se={redirected:2,aborted:4,cancelled:8,duplicated:16};function ze(e,i){return Ke(e,i,Se.redirected,'Redirected when going from "'+e.fullPath+'" to "'+function(e){if("string"==typeof e)return e;if("path"in e)return e.path;var i={};return ve.forEach((function(n){n in e&&(i[n]=e[n])})),JSON.stringify(i,null,2)}(i)+'" via a navigation guard.')}function he(e,i){return Ke(e,i,Se.cancelled,'Navigation cancelled from "'+e.fullPath+'" to "'+i.fullPath+'" with a new navigation.')}function Ke(e,i,n,a){var r=new Error(a);return r._isRouter=!0,r.from=e,r.to=i,r.type=n,r}var ve=["params","query","hash"];function Ae(e){return Object.prototype.toString.call(e).indexOf("Error")>-1}function Te(e,i){return Ae(e)&&e._isRouter&&(null==i||e.type===i)}function fe(e,i,n){var a=function(r){r>=e.length?n():e[r]?i(e[r],(function(){a(r+1)})):a(r+1)};a(0)}function Be(e){return function(i,n,a){var r=!1,l=0,t=null;Re(e,(function(e,i,n,d){if("function"==typeof e&&void 0===e.cid){r=!0,l++;var m,s=Pe((function(i){var r;((r=i).__esModule||Ne&&"Module"===r[Symbol.toStringTag])&&(i=i.default),e.resolved="function"==typeof i?i:U.extend(i),n.components[d]=i,--l<=0&&a()})),u=Pe((function(e){var i="Failed to resolve async component "+d+": "+e;t||(t=Ae(e)?e:new Error(i),a(t))}));try{m=e(s,u)}catch(e){u(e)}if(m)if("function"==typeof m.then)m.then(s,u);else{var k=m.component;k&&"function"==typeof k.then&&k.then(s,u)}}})),r||a()}}function Re(e,i){return Ye(e.map((function(e){return Object.keys(e.components).map((function(n){return i(e.components[n],e.instances[n],e,n)}))})))}function Ye(e){return Array.prototype.concat.apply([],e)}var Ne="function"==typeof Symbol&&"symbol"==typeof Symbol.toStringTag;function Pe(e){var i=!1;return function(){for(var n=[],a=arguments.length;a--;)n[a]=arguments[a];if(!i)return i=!0,e.apply(this,n)}}var Oe=function(e,i){this.router=e,this.base=function(e){if(!e)if(J){var i=document.querySelector("base");e=(e=i&&i.getAttribute("href")||"/").replace(/^https?:\/\/[^\/]+/,"")}else e="/";"/"!==e.charAt(0)&&(e="/"+e);return e.replace(/\/$/,"")}(i),this.current=c,this.pending=null,this.ready=!1,this.readyCbs=[],this.readyErrorCbs=[],this.errorCbs=[],this.listeners=[]};function De(e,i,n,a){var r=Re(e,(function(e,a,r,l){var t=function(e,i){"function"!=typeof e&&(e=U.extend(e));return e.options[i]}(e,i);if(t)return Array.isArray(t)?t.map((function(e){return n(e,a,r,l)})):n(t,a,r,l)}));return Ye(a?r.reverse():r)}function Ie(e,i){if(i)return function(){return e.apply(i,arguments)}}Oe.prototype.listen=function(e){this.cb=e},Oe.prototype.onReady=function(e,i){this.ready?e():(this.readyCbs.push(e),i&&this.readyErrorCbs.push(i))},Oe.prototype.onError=function(e){this.errorCbs.push(e)},Oe.prototype.transitionTo=function(e,i,n){var a,r=this;try{a=this.router.match(e,this.current)}

vendor: 9,080 bytes, line 16

16catch(e){throw this.errorCbs.forEach((function(i){i(e)})),e}var l=this.current;this.confirmTransition(a,(function(){r.updateRoute(a),i&&i(a),r.ensureURL(),r.router.afterHooks.forEach((function(e){e&&e(a,l)})),r.ready||(r.ready=!0,r.readyCbs.forEach((function(e){e(a)})))}),(function(e){n&&n(e),e&&!r.ready&&(Te(e,Se.redirected)&&l===c||(r.ready=!0,r.readyErrorCbs.forEach((function(i){i(e)}))))}))},Oe.prototype.confirmTransition=function(e,i,n){var a=this,r=this.current;this.pending=e;var l,t,d=function(e){!Te(e)&&Ae(e)&&(a.errorCbs.length?a.errorCbs.forEach((function(i){i(e)})):console.error(e)),n&&n(e)},m=e.matched.length-1,s=r.matched.length-1;if(S(e,r)&&m===s&&e.matched[m]===r.matched[s])return this.ensureURL(),e.hash&&de(this.router,r,e,!1),d(((t=Ke(l=r,e,Se.duplicated,'Avoided redundant navigation to current location: "'+l.fullPath+'".')).name="NavigationDuplicated",t));var u=function(e,i){var n,a=Math.max(e.length,i.length);for(n=0;n<a&&e[n]===i[n];n++);return{updated:i.slice(0,n),activated:i.slice(n),deactivated:e.slice(n)}}(this.current.matched,e.matched),k=u.updated,o=u.deactivated,y=u.activated,b=[].concat(function(e){return De(e,"beforeRouteLeave",Ie,!0)}(o),this.router.beforeHooks,function(e){return De(e,"beforeRouteUpdate",Ie)}(k),y.map((function(e){return e.beforeEnter})),Be(y)),g=function(i,n){if(a.pending!==e)return d(he(r,e));try{i(e,r,(function(i){!1===i?(a.ensureURL(!0),d(function(e,i){return Ke(e,i,Se.aborted,'Navigation aborted from "'+e.fullPath+'" to "'+i.fullPath+'" via a navigation guard.')}(r,e))):Ae(i)?(a.ensureURL(!0),d(i)):"string"==typeof i||"object"==typeof i&&("string"==typeof i.path||"string"==typeof i.name)?(d(ze(r,e)),"object"==typeof i&&i.replace?a.replace(i):a.push(i)):n(i)}))}catch(e){d(e)}};fe(b,g,(function(){fe(function(e){return De(e,"beforeRouteEnter",(function(e,i,n,a){return function(e,i,n){return function(a,r,l){return e(a,r,(function(e){"function"==typeof e&&(i.enteredCbs[n]||(i.enteredCbs[n]=[]),i.enteredCbs[n].push(e)),l(e)}))}}(e,n,a)}))}(y).concat(a.router.resolveHooks),g,(function(){if(a.pending!==e)return d(he(r,e));a.pending=null,i(e),a.router.app&&a.router.app.$nextTick((function(){h(e)}))}))}))},Oe.prototype.updateRoute=function(e){this.current=e,this.cb&&this.cb(e)},Oe.prototype.setupListeners=function(){},Oe.prototype.teardown=function(){this.listeners.forEach((function(e){e()})),this.listeners=[],this.current=c,this.pending=null};var Ee=function(e){function i(i,n){e.call(this,i,n),this._startLocation=Ze(this.base)}return e&&(i.__proto__=e),i.prototype=Object.create(e&&e.prototype),i.prototype.constructor=i,i.prototype.setupListeners=function(){var e=this;if(!(this.listeners.length>0)){var i=this.router,n=i.options.scrollBehavior,a=ce&&n;a&&this.listeners.push(te());var r=function(){var n=e.current,r=Ze(e.base);e.current===c&&r===e._startLocation||e.transitionTo(r,(function(e){a&&de(i,e,n,!0)}))};window.addEventListener("popstate",r),this.listeners.push((function(){window.removeEventListener("popstate",r)}))}},i.prototype.go=function(e){window.history.go(e)},i.prototype.push=function(e,i,n){var a=this,r=this.current;this.transitionTo(e,(function(e){He(T(a.base+e.fullPath)),de(a.router,e,r,!1),i&&i(e)}),n)},i.prototype.replace=function(e,i,n){var a=this,r=this.current;this.transitionTo(e,(function(e){pe(T(a.base+e.fullPath)),de(a.router,e,r,!1),i&&i(e)}),n)},i.prototype.ensureURL=function(e){if(Ze(this.base)!==this.current.fullPath){var i=T(this.base+this.current.fullPath);e?He(i):pe(i)}},i.prototype.getCurrentLocation=function(){return Ze(this.base)},i}(Oe);function Ze(e){var i=window.location.pathname,n=i.toLowerCase(),a=e.toLowerCase();return!e||n!==a&&0!==n.indexOf(T(a+"/"))||(i=i.slice(e.length)),(i||"/")+window.location.search+window.location.hash}var Ge=function(e){function i(i,n,a){e.call(this,i,n),a&&function(e){var i=Ze(e);if(!/^\/#/.test(i))return window.location.replace(T(e+"/#"+i)),!0}(this.base)||Ve()}return e&&(i.__proto__=e),i.prototype=Object.create(e&&e.prototype),i.prototype.constructor=i,i.prototype.setupListeners=function(){var e=this;if(!(this.listeners.length>0)){var i=this.router.options.scrollBehavior,n=ce&&i;n&&this.listeners.push(te());var a=function(){var i=e.current;Ve()&&e.transitionTo(Ce(),(function(a){n&&de(e.router,a,i,!0),ce||_e(a.fullPath)}))},r=ce?"popstate":"hashchange";window.addEventListener(r,a),this.listeners.push((function(){window.removeEventListener(r,a)}))}},i.prototype.push=function(e,i,n){var a=this,r=this.current;this.transitionTo(e,(function(e){Fe(e.fullPath),de(a.router,e,r,!1),i&&i(e)}),n)},i.prototype.replace=function(e,i,n){var a=this,r=this.current;this.transitionTo(e,(function(e){_e(e.fullPath),de(a.router,e,r,!1),i&&i(e)}),n)},i.prototype.go=function(e){window.history.go(e)},i.prototype.ensureURL=function(e){var i=this.current.fullPath;Ce()!==i&&(e?Fe(i):_e(i))},i.prototype.getCurrentLocation=function(){return Ce()},i}(Oe);function Ve(){var e=Ce();return"/"===e.charAt(0)||(_e("/"+e),!1)}function Ce(){var e=window.location.href,i=e.indexOf("#");return i<0?"":e=e.slice(i+1)}function Me(e){var i=window.location.href,n=i.indexOf("#");return(n>=0?i.slice(0,n):i)+"#"+e}function Fe(e){ce?He(Me(e)):window.location.hash=e}function _e(e){ce?pe(Me(e)):window.location.replace(Me(e))}var Le=function(e){function i(i,n){e.call(this,i,n),this.stack=[],this.index=-1}return e&&(i.__proto__=e),i.prototype=Object.create(e&&e.prototype),i.prototype.constructor=i,i.prototype.push=function(e,i,n){var a=this;this.transitionTo(e,(function(e){a.stack=a.stack.slice(0,a.index+1).concat(e),a.index++,i&&i(e)}),n)},i.prototype.replace=function(e,i,n){var a=this;this.transitionTo(e,(function(e){a.stack=a.stack.slice(0,a.index).concat(e),i&&i(e)}),n)},i.prototype.go=function(e){var i=this,n=this.index+e;if(!(n<0||n>=this.stack.length)){var a=this.stack[n];this.confirmTransition(a,(function(){var e=i.current;i.index=n,i.updateRoute(a),i.router.afterHooks.forEach((function(i){i&&i(a,e)}))}),(function(e){Te(e,Se.duplicated)&&(i.index=n)}))}},i.prototype.getCurrentLocation=function(){var e=this.stack[this.stack.length-1];return e?e.fullPath:"/"},i.prototype.ensureURL=function(){},i}(Oe),xe=function(e){void 0===e&&(e={}),this.app=null,this.apps=[],this.options=e,this.beforeHooks=[],this.resolveHooks=[],this.afterHooks=[],this.matcher=q(e.routes||[],this);var i=e.mode||"hash";switch(this.fallback="history"===i&&!ce&&!1!==e.fallback,this.fallback&&(i="hash"),J||(i="abstract"),this.mode=i,i){case"history":this.history=new Ee(this,e.base);break;case"hash":this.history=new Ge(this,e.base,this.fallback);break;case"abstract":this.history=new Le(this,e.base);break;default:0}},Ue={currentRoute:{configurable:!0}};xe.prototype.match=function(e,i,n){return this.matcher.match(e,i,n)},Ue.currentRoute.get=function(){return this.history&&this.history.current},xe.prototype.init=function(e){var i=this;if(this.apps.push(e),e.$once("hook:destroyed",(function(){var n=i.apps.indexOf(e);n>-1&&i.apps.splice(n,1),i.app===e&&(i.app=i.apps[0]||null),i.app||i.history.teardown()})),!this.app){this.app=e;var n=this.history;if(n instanceof Ee||n instanceof Ge){var a=function(e){n.setupListeners(),function(e){var a=n.current,r=i.options.scrollBehavior;ce&&r&&"fullPath"in e&&de(i,e,a,!1)}(e)};n.transitionTo(n.getCurrentLocation(),a,a)}n.listen((function(e){i.apps.forEach((function(i){i._route=e}))}))}},xe.prototype.beforeEach=function(e){return we(this.beforeHooks,e)},xe.prototype.beforeResolve=function(e){return we(this.resolveHooks,e)},xe.prototype.afterEach=function(e){return we(this.afterHooks,e)},xe.prototype.onReady=function(e,i){this.history.onReady(e,i)},xe.prototype.onError=function(e){this.history.onError(e)},xe.prototype.push=function(e,i,n){var a=this;if(!i&&!n&&"undefined"!=typeof Promise)return new Promise((function(i,n){a.history.push(e,i,n)}));this.history.push(e,i,n)},xe.prototype.replace=function(e,i,n){var a=this;if(!i&&!n&&"undefined"!=typeof Promise)return new Promise((function(i,n){a.history.replace(e,i,n)}));this.history.replace(e,i,n)},xe.prototype.go=function(e){this.history.go(e)},xe.prototype.back=function(){this.go(-1)},xe.prototype.forward=function(){this.go(1)},xe.prototype.getMatchedComponents=function(e){var i=e?e.matched?e:this.resolve(e).route:this.currentRoute;return i?[].concat.apply([],i.matched.map((function(e){return Object.keys(e.components).map((function(i){return e.components[i]}))}))):[]},xe.prototype.resolve=function(e,i,n){var a=x(e,i=i||this.history.current,n,this),r=this.match(a,i),l=r.redirectedFrom||r.fullPath;return{location:a,route:r,href:function(e,i,n){var a="hash"===n?"#"+i:i;return e?T(e+"/"+a):a}(this.history.base,l,this.mode),normalizedTo:a,resolved:r}},xe.prototype.getRoutes=function(){return this.matcher.getRoutes()},xe.prototype.addRoute=function(e,i){this.matcher.addRoute(e,i),this.history.current!==c&&this.history.transitionTo(this.history.getCurrentLocation())},xe.prototype.addRoutes=function(e){this.matcher.addRoutes(e),this.history.current!==c&&this.history.transitionTo(this.history.getCurrentLocation())}

16,Object.defineProperties(xe.prototype,Ue);var je=xe;function we(e,i){return e.push(i),function(){var n=e.indexOf(i);n>-1&&e.splice(n,1)}}xe.install=function e(i){if(!e.installed||U!==i){e.installed=!0,U=i;var n=function(e){return void 0!==e},a=function(e,i){var a=e.$options._parentVnode;n(a)&&n(a=a.data)&&n(a=a.registerRouteInstance)&&a(e,i)};i.mixin({beforeCreate:function(){n(this.$options.router)?(this._routerRoot=this,this._router=this.$options.router,this._router.init(this),i.util.defineReactive(this,"_route",this._router.history.current)):this._routerRoot=this.$parent&&this.$parent._routerRoot||this,a(this,this)},destroyed:function(){a(this)}}),Object.defineProperty(i.prototype,"$router",{get:function(){return this._routerRoot._router}}),Object.defineProperty(i.prototype,"$route",{get:function(){return this._routerRoot._route}}),i.component("RouterView",K),i.component("RouterLink",w);var r=i.config.optionMergeStrategies;r.beforeRouteEnter=r.beforeRouteLeave=r.beforeRouteUpdate=r.created}},xe.version="3.6.5",xe.isNavigationFailure=Te,xe.NavigationFailureType=Se,xe.START_LOCATION=c,J&&window.Vue&&window.Vue.use(xe);n(128),n(71),n(129);n(130),n(122);var $e={"components/AlgoliaSearchBox":()=>Promise.all([n.e(0),n.e(28)]).then(n.bind(null,778)),"components/DropdownLink":()=>Promise.all([n.e(0),n.e(25)]).then(n.bind(null,494)),"components/DropdownTransition":()=>Promise.all([n.e(0),n.e(61)]).then(n.bind(null,454)),"components/Home":()=>Promise.all([n.e(0),n.e(44)]).then(n.bind(null,604)),"components/NavLink":()=>n.e(65).then(n.bind(null,394)),"components/NavLinks":()=>Promise.all([n.e(0),n.e(24)]).then(n.bind(null,509)),"components/Navbar":()=>Promise.all([n.e(0),n.e(4)]).then(n.bind(null,766)),"components/Page":()=>Promise.all([n.e(0),n.e(23)]).then(n.bind(null,605)),"components/PageEdit":()=>Promise.all([n.e(0),n.e(45)]).then(n.bind(null,524)),"components/PageNav":()=>Promise.all([n.e(0),n.e(38)]).then(n.bind(null,525)),"components/Sidebar":()=>Promise.all([n.e(0),n.e(22)]).then(n.bind(null,606)),"components/SidebarButton":()=>Promise.all([n.e(0),n.e(62)]).then(n.bind(null,608)),"components/SidebarGroup":()=>Promise.all([n.e(0),n.e(7)]).then(n.bind(null,510)),"components/SidebarLink":()=>Promise.all([n.e(0),n.e(47)]).then(n.bind(null,495)),"components/SidebarLinks":()=>Promise.all([n.e(0),n.e(7)]).then(n.bind(null,487)),"global-components/Badge":()=>Promise.all([n.e(0),n.e(9)]).then(n.bind(null,796)),"global-components/CodeBlock":()=>Promise.all([n.e(0),n.e(10)]).then(n.bind(null,779)),"global-components/CodeGroup":()=>Promise.all([n.e(0),n.e(11)]).then(n.bind(null,780)),"layouts/404":()=>n.e(12).then(n.bind(null,781)),"layouts/Layout":()=>Promise.all([n.e(0),n.e(4),n.e(5),n.e(8)]).then(n.bind(null,782)),NotFound:()=>n.e(12).then(n.bind(null,781)),Layout:()=>Promise.all([n.e(0),n.e(4),n.e(5),n.e(8)]).then(n.bind(null,782))},Je={"v-64dca03d":()=>n.e(66).then(n.bind(null,797)),"v-22024c43":()=>n.e(79).then(n.bind(null,798)),"v-90050004":()=>n.e(76).then(n.bind(null,799)),"v-61b42a93":()=>n.e(77).then(n.bind(null,800)),"v-6465b33d":()=>n.e(78).then(n.bind(null,801)),"v-81b8a67a":()=>n.e(80).then(n.bind(null,802)),"v-48317b86":()=>n.e(67).then(n.bind(null,803)),"v-23bd824f":()=>n.e(81).then(n.bind(null,804)),"v-5b1695dd":()=>n.e(39).then(n.bind(null,805)),"v-822cf8c6":()=>n.e(82).then(n.bind(null,806)),"v-7e81b77d":()=>n.e(48).then(n.bind(null,807)),"v-4888cd9d":()=>n.e(83).then(n.bind(null,808)),"v-7301a6d1":()=>n.e(84).then(n.bind(null,809)),"v-1178fa5d":()=>n.e(85).then(n.bind(null,810)),"v-01c649bd":()=>n.e(29).then(n.bind(null,811)),"v-432b5bd6":()=>n.e(86).then(n.bind(null,812)),"v-bc107546":()=>n.e(68).then(n.bind(null,813)),"v-d80dcb06":()=>n.e(88).then(n.bind(null,814)),"v-485bbe8d":()=>n.e(87).then(n.bind(null,815)),"v-3539d41d":()=>n.e(49).then(n.bind(null,816)),"v-f0808a06":()=>n.e(40).then(n.bind(null,817)),"v-1be15362":()=>n.e(90).then(n.bind(null,818)),"v-3e221f7d":()=>n.e(91).then(n.bind(null,819)),"v-1ef8939d":()=>n.e(30).then(n.bind(null,820)),"v-03088e53":()=>n.e(92).then(n.bind(null,821)),"v-cc5a0b86":()=>n.e(69).then(n.bind(null,822)),"v-0ec6f57d":()=>n.e(89).then(n.bind(null,823)),"v-751f6acf":()=>n.e(93).then(n.bind(null,824)),"v-9cc354c6":()=>n.e(94).then(n.bind(null,825)),"v-553c6446":()=>n.e(41).then(n.bind(null,826)),"v-9e25e106":()=>n.e(50).then(n.bind(null,827)),"v-206455c6":()=>n.e(95).then(n.bind(null,828)),"v-3358815e":()=>n.e(96).then(n.bind(null,829)),"v-7e5b51bd":()=>n.e(31).then(n.bind(null,830)),"v-8d4168c6":()=>n.e(70).then(n.bind(null,831)),"v-e8779b46":()=>n.e(97).then(n.bind(null,832)),"v-70a6dc4e":()=>n.e(99).then(n.bind(null,833)),"v-2fcc3a95":()=>n.e(98).then(n.bind(null,834)),"v-3637769d":()=>n.e(100).then(n.bind(null,835)),"v-3ee390dd":()=>n.e(101).then(n.bind(null,836)),"v-642a7506":()=>n.e(103).then(n.bind(null,837)),"v-68ac6685":()=>n.e(104).then(n.bind(null,838)),"v-6480bcc7":()=>n.e(102).then(n.bind(null,839)),"v-f0a9c5f2":()=>n.e(26).then(n.bind(null,840)),"v-e89e9b86":()=>n.e(71).then(n.bind(null,841)),"v-14ad9962":()=>n.e(105).then(n.bind(null,842)),"v-2b71dd9d":()=>n.e(106).then(n.bind(null,843)),"v-2c81f446":()=>n.e(32).then(n.bind(null,844)),"v-143b3106":()=>n.e(51).then(n.bind(null,845)),"v-c07c3efa":()=>n.e(33).then(n.bind(null,846)),"v-29ce59bd":()=>n.e(34).then(n.bind(null,847)),"v-448b4d1d":()=>n.e(107).then(n.bind(null,848)),"v-64fc905e":()=>n.e(108).then(n.bind(null,849)),"v-bfbd2b46":()=>n.e(109).then(n.bind(null,850)),"v-48365a59":()=>n.e(112).then(n.bind(null,851)),"v-e73a02ea":()=>n.e(111).then(n.bind(null,852)),"v-24f9d8c6":()=>n.e(72).then(n.bind(null,853)),"v-9f53f9d6":()=>n.e(110).then(n.bind(null,854)),"v-d8bdee46":()=>n.e(114).then(n.bind(null,855)),"v-b537e5f2":()=>n.e(115).then(n.bind(null,856)),"v-7b0a82c6":()=>n.e(113).then(n.bind(null,857)),"v-5a2e0d7d":()=>n.e(117).then(n.bind(null,858)),"v-35eaf572":()=>n.e(116).then(n.bind(null,859)),"v-aa99c1f6":()=>n.e(118).then(n.bind(null,860)),"v-51c1355d":()=>n.e(73).then(n.bind(null,861)),"v-1d292df6":()=>n.e(27).then(n.bind(null,862)),"v-1a476f8d":()=>n.e(119).then(n.bind(null,863)),"v-7adaab06":()=>n.e(74).then(n.bind(null,864)),"v-16682afd":()=>n.e(35).then(n.bind(null,865)),"v-1c9ff506":()=>n.e(120).then(n.bind(null,866)),"v-a6caf7c6":()=>

16n.e(52).then(n.bind(null,867)),"v-dbcd7a7e":()=>n.e(36).then(n.bind(null,868)),"v-4c8f674f":()=>n.e(122).then(n.bind(null,869)),"v-0219a13d":()=>n.e(121).then(n.bind(null,870)),"v-4700a39d":()=>n.e(37).then(n.bind(null,871)),"v-2b804dc9":()=>n.e(125).then(n.bind(null,872)),"v-666ae106":()=>n.e(123).then(n.bind(null,873)),"v-5617815a":()=>n.e(124).then(n.bind(null,874)),"v-43c4777d":()=>n.e(127).then(n.bind(null,875)),"v-6cd49697":()=>n.e(126).then(n.bind(null,876)),"v-3f5d6285":()=>n.e(129).then(n.bind(null,877)),"v-09a8c185":()=>n.e(130).then(n.bind(null,878)),"v-512f5cfd":()=>n.e(128).then(n.bind(null,879)),"v-6b037b83":()=>n.e(132).then(n.bind(null,880)),"v-49107346":()=>n.e(131).then(n.bind(null,881))};function Xe(e){const i=Object.create(null);return function(n){return i[n]||(i[n]=e(n))}}const We=/-(\w)/g,qe=Xe(e=>e.replace(We,(e,i)=>i?i.toUpperCase():"")),Qe=/\B([A-Z])/g,ei=Xe(e=>e.replace(Qe,"-$1").toLowerCase()),ii=Xe(e=>e.charAt(0).toUpperCase()+e.slice(1));function ni(e,i){if(!i)return;if(e(i))return e(i);return i.includes("-")?e(ii(qe(i))):e(ii(i))||e(ei(i))}const ai=Object.assign({},$e,Je),ri=e=>ai[e],li=e=>Je[e],ti=e=>$e[e],di=e=>a.default.component(e);function mi(e){return ni(li,e)}function si(e){return ni(ti,e)}function ui(e){return ni(ri,e)}function ki(e){return ni(di,e)}function oi(...e){return Promise.all(e.filter(e=>e).map(async e=>{if(!ki(e)&&ui(e)){const i=await ui(e)();a.default.component(e,i.default)}}))}function yi(e,i){"undefined"!=typeof window&&window.__VUEPRESS__&&(window.__VUEPRESS__[e]=i)}n(126);var bi=n(118),gi=n.n(bi),ci=n(119),Hi=n.n(ci),pi={created(){if(this.siteMeta=this.$site.headTags.filter(([e])=>"meta"===e).map(([e,i])=>i),this.$ssrContext){const i=this.getMergedMetaTags();this.$ssrContext.title=this.$title,this.$ssrContext.lang=this.$lang,this.$ssrContext.pageMeta=(e=i)?e.map(e=>{let i="<meta";return Object.keys(e).forEach(n=>{i+=` ${n}="${Hi()(e[n])}"`}),i+">"}).join("\n    "):"",this.$ssrContext.canonicalLink=zi(this.$canonicalUrl)}var e},mounted(){this.currentMetaTags=[...document.querySelectorAll("meta")],this.updateMeta(),this.updateCanonicalLink()},methods:{updateMeta(){document.title=this.$title,document.documentElement.lang=this.$lang;const e=this.getMergedMetaTags();this.currentMetaTags=hi(e,this.currentMetaTags)},getMergedMetaTags(){const e=this.$page.frontmatter.meta||[];return gi()([{name:"description",content:this.$description}],e,this.siteMeta,Ki)},updateCanonicalLink(){Si(),this.$canonicalUrl&&document.head.insertAdjacentHTML("beforeend",zi(this.$canonicalUrl))}},watch:{$page(){this.updateMeta(),this.updateCanonicalLink()}},beforeDestroy(){hi(null,this.currentMetaTags),Si()}};function Si(){const e=document.querySelector("link[rel='canonical']");e&&e.remove()}function zi(e=""){return e?`<link href="${e}" rel="canonical" />`:""}function hi(e,i){if(i&&[...i].filter(e=>e.parentNode===document.head).forEach(e=>document.head.removeChild(e)),e)return e.map(e=>{const i=document.createElement("meta");return Object.keys(e).forEach(n=>{i.setAttribute(n,e[n])}),document.head.appendChild(i),i})}function Ki(e){for(const i of["name","property","itemprop"])if(e.hasOwnProperty(i))return e[i]+i;return JSON.stringify(e)}n(70);var vi=n(120),Ai={mounted(){window.addEventListener("scroll",this.onScroll)},methods:{onScroll:n.n(vi)()((function(){this.setActiveHash()}),300),setActiveHash(){const e=[].slice.call(document.querySelectorAll(".sidebar-link")),i=[].slice.call(document.querySelectorAll(".header-anchor")).filter(i=>e.some(e=>e.hash===i.hash)),n=Math.max(window.pageYOffset,document.documentElement.scrollTop,document.body.scrollTop),a=Math.max(document.documentElement.scrollHeight,document.body.scrollHeight),r=window.innerHeight+n;for(let e=0;e<i.length;e++){const l=i[e],t=i[e+1],d=0===e&&0===n||n>=l.parentElement.offsetTop+10&&(!t||n<t.parentElement.offsetTop-10),m=decodeURIComponent(this.$route.hash);if(d&&m!==decodeURIComponent(l.hash)){const n=l;if(r===a)for(let n=e+1;n<i.length;n++)if(m===decodeURIComponent(i[n].hash))return;return this.$vuepress.$set("disableScrollBehavior",!0),void this.$router.replace(decodeURIComponent(n.hash),()=>{this.$nextTick(()=>{this.$vuepress.$set("disableScrollBehavior",!1)})})}}}},beforeDestroy(){window.removeEventListener("scroll",this.onScroll)}},Ti=n(43),fi=n.n(Ti),Bi=[pi,Ai,{mounted(){fi.a.configure({showSpinner:!1}),this.$router.beforeEach((e,i,n)=>{e.path===i.path||a.default.component(e.name)||fi.a.start(),n()}),this.$router.afterEach(()=>{fi.a.done(),this.isSidebarOpen=!1})}}],Ri={name:"GlobalLayout",computed:{layout(){const e=this.getLayout();return yi("layout",e),a.default.component(e)}},methods:{getLayout(){if(this.$page.path){const e=this.$page.frontmatter.layout;return e&&(this.$vuepress.getLayoutAsyncComponent(e)||this.$vuepress.getVueComponent(e))?e:"Layout"}return"NotFound"}}},Yi=n(29),Ni=Object(Yi.a)(Ri,(function(){return(0,this._self._c)(this.layout,{tag:"component"})}),[],!1,null,null,null).exports;!function(e,i,n){switch(i){case"components":e[i]||(e[i]={}),Object.assign(e[i],n);break;case"mixins":e[i]||(e[i]=[]),e[i].push(...n);break;default:throw new Error("Unknown option name.")}}(Ni,"mixins",Bi);const Pi=[{name:"v-64dca03d",path:"/pages/contact.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-64dca03d").then(n)}},{name:"v-22024c43",path:"/surum-yonetimi.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-22024c43").then(n)}},{name:"v-90050004",path:"/",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-90050004").then(n)}},{path:"/index.html",redirect:"/"},{name:"v-61b42a93",path:"/dijital-cuzdan.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-61b42a93").then(n)}},{name:"v-6465b33d",path:"/sorulan-sorular.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-6465b33d").then(n)}},{name:"v-81b8a67a",path:"/uyum-tarihleri.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-81b8a67a").then(n)}},{name:"v-48317b86",path:"/v1.0.1/contents/ekler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-48317b86").then(n)}},{name:"v-23bd824f",path:"/v1.0.1/contents/erisim-belirteci.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-23bd824f").then(n)}},{name:"v-5b1695dd",path:"/v1.0.1/contents/hesap-bilgisi-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-5b1695dd").then(n)}},{name:"v-822cf8c6",path:"/v1.0.1/contents/gkd.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-822cf8c6").then(n)}},{name:"v-7e81b77d",path:"/v1.0.1/contents/kapsam-ve-dayanak.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-7e81b77d").then(n)}},{name:"v-4888cd9d",path:"/v1.0.1/contents/hhs-yos-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-4888cd9d").then(n)}},{name:"v-7301a6d1",path:"/v1.0.1/contents/riza-durumlari.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-7301a6d1").then(n)}},{name:"v-1178fa5d",path:"/v1.0.1/contents/tanim-ve-kisitlamalar.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-1178fa5d").then(n)}},{name:"v-01c649bd",path:"/v1.0.1/contents/odeme-emri-baslatma-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-01c649bd").then(n)}},{name:"v-432b5bd6",path:"/v1.0.1/contents/temel-prensipler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-432b5bd6").then(n)}},{name:"v-bc107546",path:"/v1.0.2/contents/ekler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-bc107546").then(n)}},{name:"v-d80dcb06",path:"/v1.0.2/contents/gkd.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-d80dcb06").then(n)}},{name:"v-485bbe8d",path:"/v1.0.2/contents/erisim-belirteci.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-485bbe8d").then(n)}},{name:"v-3539d41d",path:"/v1.0.2/contents/kapsam-ve-dayanak.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-3539d41d").then(n)}},{name:"v-f0808a06",path:"/v1.0.2/contents/hesap-bilgisi-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-f0808a06").then(n)}},{name:"v-1be15362",path:"/v1.0.2/contents/riza-durumlari.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-1be15362").then(n)}},{name:"v-3e221f7d",path:"/v1.0.2/contents/tanim-ve-kisitlamalar.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-3e221f7d").then(n)}},{name:"v-1ef8939d",path:"/v1.0.2/contents/odeme-emri-baslatma-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-1ef8939d").then(n)}},{name:"v-03088e53",path:"/v1.0.2/contents/temel-prensipler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-03088e53").then(n)}},{name:"v-cc5a0b86",path:"/v1.1.0/contents/ekler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-cc5a0b86").then(n)}},{name:"v-0ec6f57d",path:"/v1.0.2/contents/hhs-yos-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-0ec6f57d").then(n)}},{name:"v-751f6acf",path:"/v1.1.0/contents/erisim-belirteci.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-751f6acf").then(n)}},{name:"v-9cc354c6",path:"/v1.1.0/contents/hhs-yos-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-9cc354c6").then(n)}},{name:"v-553c6446",path:"/v1.1.0/contents/hesap-bilgisi-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-553c6446").then(n)}},{name:"v-9e25e106",path:"/v1.1.0/contents/kapsam-ve-dayanak.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-9e25e106").then(n)}},{name:"v-206455c6",path:"/v1.1.0/contents/olay-bildirim.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-206455c6").then(n)}},{name:"v-3358815e",path:"/v1.1.0/contents/riza-durumlari.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-3358815e").then(n)}},{name:"v-7e5b51bd",path:"/v1.1.0/contents/odeme-emri-baslatma-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-7e5b51bd").then(n)}},{name:"v-8d4168c6",path:"/v1.1.0/contents/gkd.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-8d4168c6").then(n)}},{name:"v-e8779b46",path:"/v1.1.0/contents/tanim-ve-kisitlamalar.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-e8779b46").then(n)}},{name:"v-70a6dc4e",path:"/v1.1.0/deneyalani/genel-bilgiler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-70a6dc4e").then(n)}},{name:"v-2fcc3a95",path:"/v1.1.0/contents/temel-prensipler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-2fcc3a95").then(n)}},{name:"v-3637769d",path:"/v1.1.0/deneyalani/hesap-bilgisi-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-3637769d").then(n)}},{name:"v-3ee390dd",path:"/v1.1.0/deneyalani/hhs-yos-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-3ee390dd").then(n)}},{name:"v-642a7506",path:"/v1.1.0/deneyalani/olay-bildirim-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-642a7506").then(n)}},{name:"v-68ac6685",path:"/v1.1.0/deneyalani/test.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-68ac6685").then(n)}},{name:"v-6480bcc7",path:"/v1.1.0/deneyalani/odeme-emri-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-6480bcc7").then(n)}},{name:"v-f0a9c5f2",path:"/v2.0.0/contents/duzenli-odeme-emri-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-f0a9c5f2").then(n)}},{name:"v-e89e9b86",path:"/v2.0.0/contents/ekler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-e89e9b86").then(n)}},{name:"v-14ad9962",path:"/v2.0.0/contents/erisim-belirteci.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-14ad9962").then(n)}},{name:"v-2b71dd9d",path:"/v2.0.0/contents/hhs-yos-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-2b71dd9d").then(n)}},{name:"v-2c81f446",path:"/v2.0.0/contents/hesap-bilgisi-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-2c81f446").then(n)}},{name:"v-143b3106",path:"/v2.0.0/contents/kapsam-ve-dayanak.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-143b3106").then(n)}},{name:"v-c07c3efa",path:"/v2.0.0/contents/ileri-tarihli-odeme-emri-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-c07c3efa").then(n)}},{name:"v-29ce59bd",path:"/v2.0.0/contents/odeme-emri-baslatma-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-29ce59bd").then(n)}},{name:"v-448b4d1d",path:"/v2.0.0/contents/olay-bildirim.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-448b4d1d").then(n)}},{name:"v-64fc905e",path:"/v2.0.0/contents/riza-durumlari.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-64fc905e").then(n)}},{name:"v-bfbd2b46",path:"/v2.0.0/contents/tanim-ve-kisitlamalar.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-bfbd2b46").then(n)}},{name:"v-48365a59",path:"/v2.0.0/deneyalani/genel-bilgiler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-48365a59").then(n)}},{name:"v-e73a02ea",path:"/v2.0.0/deneyalani/duzenli-odeme-emri-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-e73a02ea").then(n)}},{name:"v-24f9d8c6",path:"/v2.0.0/contents/gkd.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-24f9d8c6").then(n)}},{name:"v-9f53f9d6",path:"/v2.0.0/contents/temel-prensipler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-9f53f9d6").then(n)}},{name:"v-d8bdee46",path:"/v2.0.0/deneyalani/hhs-yos-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-d8bdee46").then(n)}},{name:"v-b537e5f2",path:"/v2.0.0/deneyalani/ileri-tarihli-odeme-emri-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-b537e5f2").then(n)}},{name:"v-7b0a82c6",path:"/v2.0.0/deneyalani/hesap-bilgisi-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-7b0a82c6").then(n)}},{name:"v-5a2e0d7d",path:"/v2.0.0/deneyalani/olay-bildirim-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-5a2e0d7d").then(n)}},{name:"v-35eaf572",path:"/v2.0.0/deneyalani/odeme-emri-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-35eaf572").then(n)}},{name:"v-aa99c1f6",path:"/v2.0.0/deneyalani/test.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-aa99c1f6").then(n)}},{name:"v-51c1355d",path:"/v2.0.1/contents/ekler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-51c1355d").then(n)}},{name:"v-1d292df6",path:"/v2.0.1/contents/duzenli-odeme-emri-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-1d292df6").then(n)}},{name:"v-1a476f8d",path:"/v2.0.1/contents/erisim-belirteci.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-1a476f8d").then(n)}},{name:"v-7adaab06",path:"/v2.0.1/contents/gkd.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-7adaab06").then(n)}},{name:"v-16682afd",path:"/v2.0.1/contents/hesap-bilgisi-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-16682afd").then(n)}},{name:"v-1c9ff506",path:"/v2.0.1/contents/hhs-yos-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-1c9ff506").then(n)}},{name:"v-a6caf7c6",path:"/v2.0.1/contents/kapsam-ve-dayanak.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-a6caf7c6").then(n)}},{name:"v-dbcd7a7e",path:"/v2.0.1/contents/ileri-tarihli-odeme-emri-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-dbcd7a7e").then(n)}},{name:"v-4c8f674f",path:"/v2.0.1/contents/riza-durumlari.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-4c8f674f").then(n)}},{name:"v-0219a13d",path:"/v2.0.1/contents/olay-bildirim.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-0219a13d").then(n)}},{name:"v-4700a39d",path:"/v2.0.1/contents/odeme-emri-baslatma-hizmeti.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-4700a39d").then(n)}},{name:"v-2b804dc9",path:"/v2.0.1/deneyalani/duzenli-odeme-emri-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-2b804dc9").then(n)}},{name:"v-666ae106",path:"/v2.0.1/contents/tanim-ve-kisitlamalar.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-666ae106").then(n)}},{name:"v-5617815a",path:"/v2.0.1/contents/temel-prensipler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-5617815a").then(n)}},{name:"v-43c4777d",path:"/v2.0.1/deneyalani/hesap-bilgisi-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-43c4777d").then(n)}},{name:"v-6cd49697",path:"/v2.0.1/deneyalani/genel-bilgiler.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-6cd49697").then(n)}},{name:"v-3f5d6285",path:"/v2.0.1/deneyalani/ileri-tarihli-odeme-emri-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-3f5d6285").then(n)}},{name:"v-09a8c185",path:"/v2.0.1/deneyalani/odeme-emri-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-09a8c185").then(n)}},{name:"v-512f5cfd",path:"/v2.0.1/deneyalani/hhs-yos-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi

16("Layout","v-512f5cfd").then(n)}},{name:"v-6b037b83",path:"/v2.0.1/deneyalani/test.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-6b037b83").then(n)}},{name:"v-49107346",path:"/v2.0.1/deneyalani/olay-bildirim-api.html",component:Ni,beforeEnter:(e,i,n)=>{oi("Layout","v-49107346").then(n)}},{path:"*",component:Ni}],Oi={title:"(ÃHVPS) API Ä°LKE VE KURALLARI",description:" ",base:"/",headTags:[],pages:[{frontmatter:{},regularPath:"/pages/contact.html",relativePath:"pages/contact.md",key:"v-64dca03d",path:"/pages/contact.html",content:" TÃ¼rkiye Cumhuriyeti Merkez BankasÄ±\[email protected]Â \n \n"},{title:"ÃDEME HÄ°ZMETLERÄ° VERÄ° PAYLAÅIM SERVÄ°SLERÄ° (ÃHVPS)",frontmatter:{},regularPath:"/surum-yonetimi.html",relativePath:"surum-yonetimi.md",key:"v-22024c43",path:"/surum-yonetimi.html",content:" ÃDEME HÄ°ZMETLERÄ° VERÄ° PAYLAÅIM SERVÄ°SLERÄ° (ÃHVPS) \n API Ä°LKE VE KURALLARI SÃRÃM YÃNETÄ°MÄ°  \n OHVPS API Ä°lke ve KurallarÄ± dokÃ¼manÄ±ndaki sÃ¼rÃ¼m bilgileri aÅaÄÄ±daki kurallara gÃ¶re belirlenmektedir. \n \n \n SÃ¼rÃ¼mler 3 basamaklÄ± kodla belirlenir. SÃ¼rÃ¼m deÄiÅiklikleri basamak sÄ±rasÄ±na gÃ¶re Major deÄiÅiklikler, MinÃ¶r deÄiÅiklikler ve Patch deÄiÅiklikleri olarak sÄ±ralanÄ±r. ÃrneÄin  SÃ¼rÃ¼m 1.0.0 Ã¼zerinde yapÄ±lacak major deÄiÅiklik SÃ¼rÃ¼m 2.0.0 olarak ifade edilirken, MinÃ¶r deÄiÅiklik SÃ¼rÃ¼m 1.1.0 olarak ifade edilir. Patch deÄiÅiklik ise SÃ¼rÃ¼m 1.1.1 olarak ifade edilir. \n \n \n Major deÄiÅiklikler: \na. SÃ¼rÃ¼mÃ¼n 1. basamaÄÄ± proje kapsamÄ±ndaki major deÄiÅiklikleri ifade eder. Bu major deÄiÅiklikler ; \nÂ Â Â Â Â§ Kredi kartÄ± akÄ±ÅlarÄ±, tekrarlÄ± iÅlem akÄ±ÅlarÄ± gibi kapsama yeni akÄ±ÅlarÄ±n eklenmiÅ olmasÄ±, \nÂ Â Â Â Â§  Eski hizmetlerin Ã§alÄ±Åamaz hale getirilmesi, \nÂ Â Â Â Â§ API desenlerinde deÄiÅiklik olmasÄ± ve geriye yÃ¶nelik desteÄin sona ermesidir. \nb. Major deÄiÅiklikler, Ã¶ncelikle API standartlarÄ±nÄ±n taslak sÃ¼rÃ¼mÃ¼ne eklenir. Paralelinde simÃ¼latÃ¶r geliÅtirmelerine baÅlanÄ±r.  SimÃ¼latÃ¶rde ilgili deÄiÅikliÄin hayata geÃ§irileceÄi tarih ayrÄ±ca katÄ±lÄ±mcÄ±larla paylaÅÄ±lÄ±r. \nc. Major deÄiÅiklikler sÄ±nÄ±rlÄ± bir set ya da tÃ¼m set ile sertifikasyona tabiidir. \nd. SimÃ¼latÃ¶r tek bir major ya da minÃ¶r sÃ¼rÃ¼mÃ¼ destekler. \ne. SimÃ¼latÃ¶rÃ¼n desteklediÄi sÃ¼rÃ¼m Ã¼zerinden sertifikasyon yapÄ±lÄ±r. \nf. API StandartlarÄ±nda major  SÃ¼rÃ¼m GeÃ§iÅ Tarihinin  duyurusu TCMB tarafÄ±ndan yapÄ±lÄ±r. \ng. KatÄ±lÄ±mcÄ±larÄ±n  HHS/YÃS Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ Son Tarihi  yine TCMB tarafÄ±ndan belirlenir ve duyurulur. Bu tarihe kadar katÄ±lÄ±mcÄ±larÄ±n sertifikasyonlarÄ±nÄ±n tamamlanmasÄ± beklenir. \n \n \n MinÃ¶r deÄiÅiklikler:    \na. SÃ¼rÃ¼mÃ¼n 2. basamaÄÄ± proje kapsamÄ±ndaki minÃ¶r deÄiÅiklikleri ifade eder. Bu minÃ¶r deÄiÅiklikler ; \nÂ Â Â Â Â§ Kural deÄiÅiklikleri, \nÂ Â Â Â Â§ API desenlerinde olabilecek opsiyonel alan deÄiÅiklikleri, \nÂ Â Â Â Â§ SÄ±ralÄ± veri tÃ¼rlerine yeni deÄerlerin eklenmesi, \nÂ Â Â Â Â§ GKD sÃ¼recinde deÄiÅiklik yapÄ±lmasÄ±, \nÂ Â Â Â Â§ API desenlerinde deÄiÅiklik olmasÄ± ve geriye yÃ¶nelik desteÄin devam etmesi, \nÂ Â Â Â Â§ Yeni bir endpoint eklenmesidir. \nb. DeÄiÅiklik kapsamÄ± TCMB tarafÄ±ndan belirlenir. \nc. Bu basamakta yapÄ±lan deÄiÅikliklerin tÃ¼mÃ¼nÃ¼n sertifikasyona tabi olmasÄ± gerekir. Ancak deÄiÅikliÄin boyutuna gÃ¶re sÄ±nÄ±rlÄ± bir set ya da tÃ¼m deÄiÅiklik seti ile sertifikasyon senaryolarÄ± oluÅturulur. \nd. Geriye dÃ¶nÃ¼k destek bittiÄi noktada sÃ¼rÃ¼m deÄeri artar. \ne. Major ve minÃ¶r deÄiÅikliklerin sÃ¼rÃ¼m yÃ¶netimi aynÄ± akÄ±Åla iÅletilir. \n \n \n Patch deÄiÅiklikler: \n a. SÃ¼rÃ¼mÃ¼n 3. basamaÄÄ± proje kapsamÄ±ndaki patch deÄiÅiklikleri ifade eder. API desenlerinde bir deÄiÅiklik yaratmayan iÅ kuralÄ± deÄiÅikliÄi Ã¶rnek olabilir. \n b. Patch deÄiÅiklikler sonrasÄ± katÄ±lÄ±mcÄ±larÄ±n yeniden sertifikasyon yapmalarÄ± gerekmemektedir. \n \n \n Ä°lk defa sertifikasyona gelecek kurumlar en son aktif sÃ¼rÃ¼m ile sertifikasyona gelir. \n \n \n API Endpointlerde yapÄ±lacak major ve minor deÄiÅiklikler, endpointin pathi iÃ§erisinde yer alÄ±r. DetaylÄ± bilgi  3.5.\tKaynak URI Yol YapÄ±sÄ±  adresinde yer alÄ±r.  \n \n \n SÃ¼rÃ¼m geÃ§iÅlerinde kullanÄ±lan tarih bilgileri Åu Åekildedir: \n \n \n \n SÃ¼rÃ¼m GeÃ§iÅ Tarihi  : \n \n Yeni API StandartÄ± sÃ¼rÃ¼mÃ¼nÃ¼n yayÄ±nlandÄ±ÄÄ± tarih bilgisidir.\n \n API StandartlarÄ± taslak sÃ¼rÃ¼mÃ¼, gÃ¼ncel sÃ¼rÃ¼m haline getirilir. \n SimÃ¼latÃ¶rde yapÄ±lan gÃ¼ncellemeler development ortamÄ±ndan, katÄ±lÄ±mcÄ±larÄ±n kullanÄ±mÄ±nda olan Tripsit ortamÄ±na aktarÄ±lÄ±r. \n Tripsit ortamÄ±nda katÄ±lÄ±mcÄ±lar hem simÃ¼latÃ¶r hem de kendi uygulama testlerine baÅlayabilir. \n \n \n \n Sertifikasyona BaÅlangÄ±Ã§ Tarihi  : \n \n HHS ve YÃS'ler iÃ§in ayrÄ± olarak iletilecek tarih bilgisidir. \n \n HHS Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ S

16on Tarihi / YÃS Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ BaÅlangÄ±Ã§ Tarihi   : \n \n Bu tarihe kadar HHS'lerin sertifikasyonu tamamlayÄ±p baÅarÄ± ile geÃ§mesi gerekir. Bu tarihten Ã¶nce sertifikasyonu tamamlayan HHS'ler Ã¼retime geÃ§er. \n Bu tarih HHS'lerin Ã¼retime geÃ§iÅi iÃ§in tanÄ±mlanmÄ±Å son tarih olduÄu iÃ§in, bu tarihte tÃ¼m HHS'ler Ã¼retime geÃ§miÅ olacaktÄ±r. YÃS'ler bu tarihten itibaren Ã¼retime geÃ§iÅe baÅlar. \n BKM tarafÄ±ndan yapÄ±lmasÄ± gerekecek API sÃ¼rÃ¼m deÄiÅikliÄi varsa bu tarihte yayÄ±na alÄ±nÄ±r.(HHS-YÃS API gibi) \n \n YÃS Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ Son Tarihi  : \n \n YÃS'lerin sertifikasyon sÃ¼reci, YÃS Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ BaÅlangÄ±Ã§ Tarihinden, YÃS Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ Son Tarihine kadar sÃ¼rer. \n Mevcut YÃS'ler yeni sÃ¼rÃ¼mÃ¼ en geÃ§ bu tarihte Ã¼retim ortamÄ±na alÄ±r. \n \n Eski SÃ¼rÃ¼mÃ¼n KaldÄ±rÄ±lma Tarihi  : \n \n HHS'ler; HHS Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ Son Tarihi ile Eski SÃ¼rÃ¼mÃ¼n KaldÄ±rÄ±lma Tarihi arasÄ±nda iki servis sÃ¼rÃ¼mÃ¼nÃ¼ de desteklemek zorundadÄ±r. \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n "},{title:"ÃDEME HÄ°ZMETLERÄ° VERÄ° PAYLAÅIM SERVÄ°SLERÄ° (ÃHVPS)",frontmatter:{},regularPath:"/",relativePath:"README.md",key:"v-90050004",path:"/",content:" ÃDEME HÄ°ZMETLERÄ° VERÄ° PAYLAÅIM SERVÄ°SLERÄ° (ÃHVPS) \n API Ä°LKE VE KURALLARI   \n SÃRÃM 2.0.0 aktif sÃ¼rÃ¼mdÃ¼r. \n https://github.com/ohvps/ohvps.github.io/commits/master  adresi Ã¼zerinden deÄiÅiklik aÃ§Ä±klamalarÄ± ve tarihÃ§esi incelenebilir. \n \n SÃRÃM 2.0.1 geÃ§iÅ tarihleri Åu Åekildedir. \n \n SÃ¼rÃ¼m GeÃ§iÅ Tarihi : 7 Ekim 2026 \n \n SÃRÃM 2.0.0 geÃ§iÅ tarihleri Åu Åekildedir. \n \n \n SÃ¼rÃ¼m GeÃ§iÅ Tarihi : 1 AÄustos 2025 \n \n \n HHS(1.1.0âdan 2.0.0'a geÃ§ecek olan ve direkt 2.0.0âa gelecek olan) Sertifikasyon BaÅlangÄ±Ã§ Tarihi :  1 EylÃ¼l 2025 \n \n \n HHS(1.1.0âdan 2.0.0âa geÃ§ecek olan, direkt 2.0.0âa gelecek olan) Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ BaÅlangÄ±Ã§ Tarihi : 1 Ekim 2025 \n \n \n YÃS(1.1.0âdan 2.0.0'a geÃ§ecek olan ve direkt 2.0.0âa gelecek olan) Sertifikasyon BaÅlangÄ±Ã§ Tarihi : 1 Ekim 2025 \n \n \n HHS(1.1.0âdan 2.0.0âa geÃ§ecek olan) Sertifikasyon BitiÅ Tarihi : 16 Ocak 2026 \n \n \n HHS(1.1.0âdan 2.0.0âa geÃ§ecek olan) Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ Son Tarihi: 1 Mart 2026 \n \n \n YÃS(1.1.0âdan 2.0.0'a geÃ§ecek olan ve direkt 2.0.0âa gelecek olan) Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ BaÅlangÄ±Ã§ Tarihi : 1 Mart 2026 \n \n \n YÃS(1.1.0âdan 2.0.0âa geÃ§ecek olan) Sertifikasyon BitiÅ Tarihi : 15 MayÄ±s 2026 \n \n \n YÃS(1.1.0âdan 2.0.0'a geÃ§ecek olan ve direkt 2.0.0âa gelecek olan) Yeni SÃ¼rÃ¼m Ãretime GeÃ§iÅ Son Tarihi : 1 Haziran 2026'dan 1 Temmuz 2026âya ertelenmiÅtir. (14.05.2026 tarihinde ilgili tarih gÃ¼ncellemesi saÄlanmÄ±ÅtÄ±r.) \n \n \n Eski SÃ¼rÃ¼mÃ¼n(1.1.0) KaldÄ±rÄ±lma Tarihi : 1 Haziran 2026âdan 1 Temmuz 2026âya ertelenmiÅtir. (14.05.2026 tarihinde ilgili tarih gÃ¼ncellemesi saÄlanmÄ±ÅtÄ±r.)\n \n \n \n ÃNEMLÄ° BÄ°LGÄ°LENDÄ°RME : 3

161 AralÄ±k 2025 tarihinde geÃ§iÅ zorunluluÄu olan HHSâlerin 1 AÄustos 2025 tarihinden sonra SÃ¼rÃ¼m 2.0.0 sertifikasyonuna gelmesi durumunda en geÃ§ 31 AralÄ±k 2025 tarihine kadar sertifikasyon sÃ¼recini tamamlayarak Ã¼retime geÃ§meleri gerekmektedir. \n YÃSâlerin sadece kendilerinin destekledikleri API sÃ¼rÃ¼mÃ¼nÃ¼ destekleyen HHSâleri listelemesi gerekmektedir. \n 2.0.0 sÃ¼rÃ¼mÃ¼ iÃ§in hesap bilgisi rÄ±zasÄ± ve Ã¶deme emri rÄ±zasÄ± oluÅturmak isteyen YÃS kurumu iÃ§in YOS API iÃ§erisinde apiBilgileri olarak \"ODS\" tanÄ±mÄ± HHS tarafÄ±ndan kontrol edilmelidir. YÃS'Ã¼n ilgili tanÄ±mÄ± olmamasÄ± halinde rÄ±za isteÄinde \"TR.OHVPS.Resource.APIVersionNotSupported\" hatasÄ± verilmelidir. \n SÃ¼rÃ¼m YÃ¶netimi  bÃ¶lÃ¼mÃ¼nden tarih bilgilerinin aÃ§Ä±klamalarÄ±na ulaÅÄ±labilir. \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n "},{title:"Dijital CÃ¼zdanlardan TR Karekod ile Ãdeme",frontmatter:{},regularPath:"/dijital-cuzdan.html",relativePath:"dijital-cuzdan.md",key:"v-61b42a93",path:"/dijital-cuzdan.html",headers:[{level:2,title:"1.      Dijital CÃ¼zdana Kart Ekleme AkÄ±ÅÄ±",slug:"_1-dijital-cuzdana-kart-ekleme-akÄ±sÄ±"},{level:2,title:"2. Uyum Tarihi",slug:"_2-uyum-tarihi"}],content:" Dijital CÃ¼zdanlardan TR Karekod ile Ãdeme \n Dijital cÃ¼zdanlara eklenmiÅ ve cÃ¼zdan sahibi kuruluÅun kendisinin ihraÃ§ etmediÄi, diÄer Kart ÃÄ±karan KuruluÅlar tarafÄ±ndan ihraÃ§ edilmiÅ kartlar ile TR Karekod Ã¶demesi yapÄ±labilmesi iÃ§in HHS olarak GEÃÄ°Tâe baÄlanmÄ±Å olan Kart ÃÄ±karan KuruluÅlarÄ±n,  BKM (KartlÄ± Ãdemeler) TR Karekod Teknik Ä°lke ve KurallarÄ± Rehberinde  yer alan 5.2 maddelerindeki belirtilen akÄ±Ålar iÃ§in BKM Karekod YÃ¶nlendirme Sistemi (KYS) entegrasyonu yapmasÄ± gerekmektedir.  \n Bu sayede Kart ÃÄ±karan KuruluÅlar, otorizasyon Ã¶ncesinde iÅlemin POSâta Kart PINâi ile doÄrulanmasÄ±nÄ± veya mÃ¼Återinin telefonunda yÃ¼klÃ¼ olan Kart ÃÄ±karan KuruluÅa ait mobil uygulamaya anlÄ±k bildirim gÃ¶ndererek doÄrulanmasÄ±nÄ± saÄlayabilecektir. HHS olarak GEÃÄ°Tâe baÄlanmÄ±Å olan Kart ÃÄ±karan KuruluÅlar iÃ§in de bu doÄrulama akÄ±ÅlarÄ±ndan en az birini hayata geÃ§irmesi zorunludur. \n 1.      Dijital CÃ¼zdana Kart Ekleme AkÄ±ÅÄ± \n Dijital CÃ¼zdanlardan Ã¶deme yapÄ±labilmesi iÃ§in kullanÄ±cÄ±larÄ±n ilk olarak kartÄ± Dijital CÃ¼zdana eklemesi gerekmektedir. Dijital CÃ¼zdana eklenecek olan karta ait bilgiler kullanÄ±cÄ± tarafÄ±ndan cÃ¼zdana girilmektedir. Kart bilgilerinin Dijital CÃ¼zdana eklenmesinin ardÄ±ndan kart hamili iki faktÃ¶rlÃ¼ doÄrulama yÃ¶ntemi (GO GÃ¼venli Ãde, 3D Secure  vb.) ile doÄrulanmasÄ± gerekmektedir.  Kart hamilinin iki faktÃ¶rlÃ¼ doÄrulanmasÄ±nÄ±n ardÄ±ndan kart cÃ¼zdana eklenir ve eklenen bu kartlar ile Ã¶deme iÅlemleri yapÄ±labilir. Dijital CÃ¼zdanlarla yapÄ±labilen iÅlemler aÅaÄÄ±da bilgi amaÃ§lÄ± Ã¶zetlenmiÅtir. Bu belgenin Uyum Tarihi baÅlÄ±ÄÄ±nda TR Karekod ile yapÄ±lan iÅlemler iÃ§in kullanÄ±lacak doÄrulama akÄ±ÅlarÄ±na yer verilmiÅtir. \n \n \n Dijital cÃ¼zdanlar ile fiziksel maÄazalarda POS terminali Ã¼zerinden, e-ticaret sitelerinde ise online kanallar Ã¼zerinden  Ã¶deme yapmak mÃ¼mkÃ¼ndÃ¼r. \n \n \n Fiziksel Ã¶demelerde dijital cÃ¼zdan POS terminallerinde gÃ¶sterilen TR Karekodâu okuyarak Ã¶demeyi gerÃ§ekleÅtirebilir. Ä°kinci bir yÃ¶ntem olarak, mobil telefonun ve dijital cÃ¼zdanÄ±n NFC teknolojisini desteklemesi durumunda telefonun POS terminaline temassÄ±z olarak okutulmasÄ± suretiyle Ã¶deme yapÄ±labilmesi mÃ¼mkÃ¼ndÃ¼r. \n \n \n E-ticaret Ã¶demelerinde web sitesinde gÃ¶sterilen TR Karekodâun dijital cÃ¼zdan ile okutulmasÄ± suretiyle Ã¶deme yapÄ±lmasÄ± mÃ¼mkÃ¼ndÃ¼r. Sanal POS iÅlemlerinden kastedilen dijital cÃ¼zdanda saklÄ± olan kart ile online kanallar Ã¼zerinden bir e-ticaret Ã¶demesinin yapÄ±lmasÄ±dÄ±r. \n 2. Uyum Tarihi \n Dijital cÃ¼zdan sahibi kuruluÅ ile cÃ¼zdana eklenen kart kuruluÅunun farklÄ± olmasÄ± durumunda hem fiziki POSâlarda hem de sanal POSâlarda TR Karekod ile Ã¶deme yapÄ±labilmesine iliÅkin akÄ±Ålar BKM (KartlÄ± Ãdemeler) TR Karekod Teknik Ä°lke ve KurallarÄ± Rehberinde 5.2. maddelerinde tariflenmiÅtir. \n Bu akÄ±Ålarda; \n \n \n No-CVM (Ä°lave doÄrulama yapmadan) veya  \n \n \n Kart PIN (POS cihazÄ±nda kart Åifresi girilerek) veya  \n \n \n AnlÄ±k Bildirim ile (mobil telefonda yÃ¼klÃ¼ olan kart Ã§Ä±karan kuruluÅa ait uygulama Ã¼zerinden ile mÃ¼Återi doÄrulamasÄ± yer almaktadÄ±r.) mÃ¼Återi doÄrulamasÄ± yer almaktadÄ±r. \n \n \n KuruluÅlarÄ±n tercihine gÃ¶re yukarÄ±da tariflenmiÅ olan akÄ±Ålardan biri veya tamamÄ± kuruluÅlar tarafÄ±ndan desteklenebilir. KuruluÅlarÄ±n tercih ettiÄi akÄ±Ålar iÃ§in Karekod YÃ¶nlendirme Sistemi sertifikasyonlarÄ±nÄ± tamamlanmasÄ± gerekmektedir. YukarÄ±da tariflenmiÅ akÄ±Ålarda gÃ¶rÃ¼leceÄi Ã¼zere kart Ã§Ä±karan kuruluÅlar otorizasyon Ã¶ncesinde kendi risk deÄerlendirmesini yaparak âNo cvmâ ilave bir doÄrulama yÃ¶ntemine gerek kalmadan da iÅlemleri sonlandÄ±rÄ±lmasÄ±nÄ± isteyebilmektedir. \n ** 31.12.2023 tarihinden Ã¶nce HHS olarak GEÃÄ°Tâe baÄlanmÄ±Å olan Kart ÃÄ±karan KuruluÅlarÄ±n  BKM (KartlÄ± Ãdemeler) TR K

16arekod Teknik Ä°lke ve KurallarÄ± Rehberinde  yer alan madde 5.2âde tarifli akÄ±Å/akÄ±Ålar iÃ§in Karekod YÃ¶nlendirme Sistemi sertifikasyonunun tamamlanarak en geÃ§  30 Haziran 2024  tarihinde Ã¼retime geÃ§miÅ olmasÄ± zorunludur. \n Nezdinde Ãdeme hesabÄ± bulunduran Kart ÃÄ±karan diÄer tÃ¼m Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±n da GEÃÄ°Tâe baÄlantÄ± saÄlamalarÄ± sonrasÄ± ilk 6 ay iÃ§erisinde KYS sertifikasyonunu tamamlamasÄ± gerekmektedir.** \n"},{title:"SÄ±kÃ§a Sorulan Sorular",frontmatter:{},regularPath:"/sorulan-sorular.html",relativePath:"sorulan-sorular.md",key:"v-6465b33d",path:"/sorulan-sorular.html",content:" SÄ±kÃ§a Sorulan Sorular \n 1) ÃHVPS kapsamÄ±nda Hesap Bilgisi Hizmeti ve Ãdeme Emri BaÅlatma Hizmetiâni kullanabilmemiz iÃ§in hangi ÅartlarÄ±n saÄlanmasÄ± beklenmektedir? \n \n Hesap Hizmeti SaÄlayÄ±cÄ±lar(HHS) ve YetkilendirilmiÅ Ãdeme Hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n(YÃS) ÃHVPS kapsamÄ±nda saÄlmasÄ± gereken Åartlar iÃ§in TCMBânin yayÄ±nladÄ±ÄÄ± kanun ve yÃ¶netmeliklerin incelenmesi gerekmektedir. Ä°lgili linkte yer alan  https://ohvps.github.io/uyum-tarihleri.html  referans adreslerinin incelenmesini Ã¶neririz. \n TCMB tarafÄ±ndan lisans sÃ¼reciniz baÅlatÄ±ldÄ±ÄÄ±nda geliÅtirmelerinizde yardÄ±mcÄ± olmak adÄ±na BKM baÅvuru yapan Kurum/KuruluÅlara test hesabÄ± tanÄ±mlanmakta ve ilgili alanlara yetki almanÄ± iÃ§in gerekli yÃ¶nlendirme yapÄ±lmaktadÄ±r. \n ÃHVPS kapsamÄ±nda;\n \n Lisans sÃ¼recini yÃ¼rÃ¼ten Kurum/KuruluÅlarÄ±n BKM tarafÄ±ndan BKM ÃHVPS Teknik Sertifikasyon Onay Belgesi almasÄ± gerekmektedir. \n Lisans almasÄ± gerekmeyen Kurum/KuruluÅlarÄ±n Ã¼retime geÃ§meden Ã¶nce BKM ÃHVPS Teknik Sertifikasyon Onay Belgesi almasÄ± gerekmektedir. \n \n \n \n 2) BKM ÃHVPS Teknik Sertifikasyon Onay Belgesi nedir, nasÄ±l alÄ±nÄ±r? \n \n BKM ÃHVPS Teknik Sertifikasyon Onay Belgesi,  https://ohvps.github.io/ âda yayÄ±nlanan teknik ÅartlarÄ±n yerine getirilecek Åekilde geliÅtirme yapÄ±lmasÄ± ve Trip/Tripsit Ã¼zerinden paylaÅÄ±lan sertifikasyon senaryolarÄ±nÄ±n test ortamÄ±nda simulator Ã¼zerinden koÅularak onaya gÃ¶nderilmesi sonrasÄ± BKM tarafÄ±ndan yapÄ±lan kontrollerin olumlu olmasÄ± sonucunda verilen belgedir. Teknik sertifikasyon belgesi alÄ±nabilmesi iÃ§in katÄ±lÄ±mcÄ±larÄ±n Ã¶ncelikle sertifikasyona gelmeleri gerekmektedir. Sertifikasyon sÃ¼recine ait detaylÄ± bilgiler Tripsit> BKM Online> ÃHVPS> DokÃ¼manlar menÃ¼sÃ¼ altÄ±nda yer almaktadÄ±r. \n \n 3) Elektronik Para KuruluÅlarÄ± ve Ãdeme KuruluÅlarÄ± olarak HHS olma zorunluluÄumuz var mÄ±dÄ±r? \n \n TCMB tarafÄ±ndan yayÄ±nlanan kanun ve yÃ¶netmeliklerde bu bilgi yer almaktadÄ±r. Kanun, yÃ¶netmelik, tebliÄ vb. aÅaÄÄ±daki sayfadan ulaÅabilirsiniz. \n \n https://www.tcmb.gov.tr/wps/wcm/connect/25571f4f-72ac-4f4b-ab59-2d683fcbc271/Y%C3%B6netmelik.pdf?MOD=AJPERES&CACHEID=ROOTWORKSPACE-25571f4f-72ac-4f4b-ab59-2d683fcbc271-pntoxwf  55. Sayfa \n \n Elektronik Para KuruluÅlarÄ± ve Ãdeme KuruluÅlarÄ±ânÄ±n HHS uyum tarihleri,  https://ohvps.github.io/uyum-tarihleri.html , adresinde yer almaktadÄ±r. \n \n 4) EPK ve/veya ÃK olarak HHS ve YÃS sertifikasyonuna aynÄ± anda gelme zorunluluÄumuz bulunmakta mÄ±dÄ±r? \n \n API dokÃ¼manÄ±nda da belirtildiÄi Ã¼zere Banka rolÃ¼ndeki HHSâler HHS olmadan YÃS olamazlar. Ancak EPK/ÃKâlar iÃ§in bÃ¶yle bir zorunluluk bulunmamaktadÄ±r. Ek olarak, API ilke ve kurallarÄ± dokÃ¼manÄ±nda bulunan tÃ¼m hizmetlerin (HHSâler mevcut kanallarÄ±nda bu hizmetleri sunuyorsa aÃ§Ä±k bankacÄ±lÄ±k kapsamÄ±nda da sunmalarÄ± gerekmektedir.) HHSâler tarafÄ±ndan sunulmasÄ± gerekmektedir. YÃSâler hangi lisansÄ± alacaklarsa HBH ve ÃBH hizmetleri ayrÄ± ayrÄ± ya da beraber olacak Åekilde sertifikasyona gelebilirler. \n \n 5) Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri API Ä°lke ve KurallarÄ±âna nereden eriÅebiliriz? \n \n https://ohvps.github.io/ adresinden eriÅebilirsiniz. \n \n 6) ÃHVPS API sÃ¼rÃ¼m geÃ§iÅ tarihlerine nereden ulaÅabiliriz? \n \n https://ohvps.github.io/  adresinden ulaÅabilirsiniz. \n \n 7) YatÄ±rÄ±m BankasÄ± olarak sertifikasyona gelmemiz gereken son tarih bilgisi nedir? \n \n https://ohvps.github.io/uyum-tarihleri.html  uyum tarihleri paylaÅÄ±lmÄ±ÅtÄ±r. Buradan sizin iÃ§in belirtilen tarih aralÄ±ÄÄ±nÄ± baz alabilirsiniz. \n \n 8) HenÃ¼z AÃ§Ä±k BankacÄ±lÄ±k kapsamÄ±nda herhangi bir Ã§alÄ±Åmada bulunmamÄ±Å/ yeni sertifikasyona gelecek olan bir banka olarak sertifikasyona geleceÄimiz son tarih bilgisi konusunda bizlere destek olabilir misiniz? \n \n https://ohvps.github.io/uyum-tarihleri.html  uyum tarihleri paylaÅÄ±lmÄ±ÅtÄ±r. Buradan sizin iÃ§in belirtilen tarih aralÄ±ÄÄ±nÄ± baz alabilirsiniz. \n \n 9) SimÃ¼latÃ¶rÃ¼n mobil uygulamasÄ± bulunmakta mÄ±dÄ±r? Var ise uygulamayÄ± nasÄ±l indirebiliriz? \n \n Evet, BOSS mobil uygulamamÄ±z bulunmaktadÄ±r. Trip/Tripsit > BKM Online > ÃHVPS > DokÃ¼manlar kÄ±smÄ±ndan adÄ±mlarÄ± takip ederek indirebilirsiniz.\nAyrÄ±ca Tr

16ip / Tripsit > DokÃ¼manlar bÃ¶lÃ¼mÃ¼ndeki  SÄ°MÃLATÃR KULLANIMI VE SERTÄ°FÄ°KASYON SÃREÃ KILAVUZU  bu belgenin de sÃ¼reÃ§ler iÃ§in incelenmesi gerektiÄi tavsiye edilmektedir. \n \n 10) ÃHVPS APIâlarÄ±nÄ±n entegrasyonu iÃ§in hangi adÄ±mlar ile ilerlemeliyiz? \n \n \n ÃHVPS API geliÅtirmeleri iÃ§in BKM olarak simÃ¼lator ortamÄ± sunulmaktadÄ±r. SimÃ¼latÃ¶r ortamÄ±na eriÅim iÃ§in test entegrasyonu saÄlanmalÄ±dÄ±r. Entegrasyon iÃ§in aÅaÄÄ±daki adÄ±mlar takip edilmelidir. \n \n âYeni KayÄ±tâ ve âGÃ¼ncellemeâ iÅlemine dair sÃ¼reÃ§ler  https://pys-preprod.bkm.com.tr   adresi Ã¼zerinden yapÄ±lacaktÄ±r. Mevcut durumda PYS giriÅ yetkisi olan katÄ±lÄ±mcÄ±lar Tripsit'e giriÅ yaptÄ±klarÄ± kullanÄ±cÄ± adÄ± ve Åifresi ile giriÅ yapabilir. \n Ä°lgili adrese eriÅimler aÃ§Ä±k olup katÄ±lÄ±mcÄ±lar Tripsitâe  https://tripsit.bkm.com.tr  giriÅ yaptÄ±klarÄ± kullanÄ±cÄ± adÄ± ve Åifresi ile girebilecektir. \n HHS, YÃS test ortamÄ± tanÄ±mlarÄ±na ait menÃ¼ler iÃ§in yetki alÄ±nmasÄ± gerekmektedir. Ä°lgili yetkiler iÃ§in kurumunuza Ã¶zgÃ¼ olan sÃ¼per kullanÄ±cÄ±dan yetki talep edilmelidir. SÃ¼per kullanÄ±cÄ± sÃ¼reÃ§leri ile PYS Ã¼zerinde ilgili hizmetlerin yetkilerine dair dokÃ¼manlar Trip/Tripsit > BKM Online > ÃHVPS iÃ§erisinde yer almaktadÄ±r.\n \n Ek-1: Merkezi KullanÄ±cÄ± YÃ¶netim Sistemi Uygulama KurallarÄ±-Åubat 2025 \n Ek-2: Parametre YÃ¶netim Sistemi AÃ§Ä±k BankacÄ±lÄ±k YÃS ve HHS Yetki Talebi KÄ±lavuzu \n \n \n \n Kurumunuza ait en az iki sÃ¼per kullanÄ±cÄ± bulunmaktadÄ±r. SÃ¼per kullanÄ±cÄ±nÄ±z Ã¼zerinden yetki talebinde bulunabilirsiniz. Yetki talebi verildikten sonra kurumunuzdaki diÄer sÃ¼per kullanÄ±cÄ± tarafÄ±ndan isteÄiniz onaylanmaktadÄ±r. EÄer kurumunuza ait sÃ¼per kullanÄ±cÄ±larÄ±nÄ±z bulunmuyor ise [email protected]âe mail atÄ±larak yetki talep edilmelidir. \n \n \n 11) Ä°stemci sertifikasÄ± talebini nereden yapabiliriz? \n \n âÄ°stemci SertifikasÄ± Talep EkranÄ±â  sadece yetkili kiÅi tarafÄ±ndan seÃ§ilerek gÃ¶nderilmelidir. Yetkili kiÅi Trip/Tripsit > BKM Online > ÃHVPS > DokÃ¼manlar menÃ¼sÃ¼ altÄ±ndan ulaÅabilir. \n \n 12) Mesaj imzalama sÃ¼reÃ§leri nasÄ±l olmalÄ±dÄ±r? \n \n https://ohvps.github.io/v2.0.0/contents/ekler.html#ek-5-mesaj-imzalama-ak%C4%B1s%C4%B1  detaylÄ± bilgiye eriÅebilirsiniz. \n \n 13) Sertifikasyona gelmeden Ã¶nce yapÄ±lmasÄ± gerekenleri paylaÅabilir misiniz? \n \n HHS rolÃ¼nde sertifikasyona gelmeden Ã¶nce  tÃ¼m hizmetler iÃ§in âTest Otomasyonâ Ã§alÄ±ÅtÄ±rÄ±larak baÅarÄ±sÄ±z senaryolar dÃ¼zeltilmelidir.\n \n Ekranlarda gÃ¶sterilmesi gerekli tÃ¼m alanlar Trip/Tripsit > ÃHVPS > DokÃ¼manlar > ÃHVPS SÃ¼rÃ¼m 2.0 Sertifikasyon SenaryolarÄ± AktarÄ±m ToplantÄ±sÄ± dokÃ¼manÄ±nda yer almaktadÄ±r. Ä°lgili dokÃ¼man incelenerek ekran tasarÄ±mlarÄ± tasarlanmalÄ±dÄ±r. DokÃ¼manda ekranda gÃ¶sterilmesi gereken zorunlu alanlar belirtilmektedir. Ekranlarda istenilen Åartlar yerine getirildiÄi sÃ¼rece ekran tasarÄ±mlarÄ± kurum/kuruluÅlarÄ±n insiyatifine bÄ±rakÄ±lmÄ±ÅtÄ±r. \n \n \n YÃS rolÃ¼nde ise  Ekranlarda gÃ¶sterilmesi gerekli tÃ¼m alanlar Trip/Tripsit > ÃHVPS > DokÃ¼manlar > ÃHVPS SÃ¼rÃ¼m 2.0 Sertifikasyon SenaryolarÄ± AktarÄ±m ToplantÄ±sÄ± dokÃ¼manÄ±nda yer almaktadÄ±r. Ä°ncelenerek ekran tasarÄ±mlarÄ± tasarlanmalÄ±dÄ±r. DokÃ¼manda ekranda gÃ¶sterilmesi gereken zorunlu alanlar belirtilmektedir. Zorunlu alanlarÄ±n tek ekranda gÃ¶sterilmesine gerek bulunmamaktadÄ±r. Ekranlarda istenilen Åartlar yerine getirildiÄi sÃ¼rece ekran tasarÄ±mlarÄ± kurum/kuruluÅlarÄ±n insiyatifine bÄ±rakÄ±lmÄ±ÅtÄ±r. \n Sertifikasyon onayÄ± iletilmeden en az bir ay Ã¶ncesinde sertifikasyon slot talebi ekranÄ±ndan slot tarihi alÄ±nmalÄ±dÄ±r. Sertifikasyon slot talebi ekranÄ±na  https://sertifikasyon-preprod.bkmtest.com.tr/certification-slots  adresinden eriÅim saÄlayabilirsiniz.\nAlmÄ±Å olduÄunuz slot tarihinden en az Ã¼Ã§ iÅ gÃ¼nÃ¼ Ã¶ncesinde sistem Ã¼zerinden sertifikasyon onayÄ± iletmeniz beklenmektedir. \n Sertifikasyon kontrolleri sonrasÄ±nda sizlere geri bildirimlerde bulunulur. TÃ¼m revizeler tamamlandÄ±ktan sonra sertifikasyon onayÄ± verilir ve Ã¼retime geÃ§iÅ iÃ§in planlama yapÄ±lÄ±r. \n \n 14) Kurum/KuruluÅ olarak mobil kanallardan mÃ¼Återimize hizmet vermemekteyiz. Bu kapsamda sertifikasyonda sadece web akÄ±ÅlarÄ±nÄ± iÅletebilir miyiz? \n \n Sertifikasyon sÃ¼recinde mobil ve web sertifikasyonlarÄ± ayrÄ± iÅletilmektedir. Bu kapsamda mevcut durumda hangi kanal Ã¼zerinden mÃ¼Återilere hizmet sunuluyorsa sadece o hizmet kapsamÄ±nda sertifikasyona gelebilirsiniz. \n \n 15) Bireysel segmentte mobil ve web kanallarÄ±nda hizmetimiz bulunurken Kurumsal mÃ¼Återi Ã¶zelinde sadece web kanalÄ±nda hizmetimiz bulunmaktadÄ±r. Bu kapsamda Kurumsal mÃ¼Återiler iÃ§in sadece web akÄ±ÅÄ±nÄ± destekleyebilir miyiz? \n \n Sertifikasyon sÃ¼recinde mobil ve web sertifikasyonlarÄ± ayrÄ± iÅletilmektedir. Bu kapsamda mevcut durumda hangi servisi destekleniyorsa ya da hangi kanal Ã¼zerinden mÃ¼Återilere hizmet sunuluyorsa sadece o hizmet kapsamÄ±nda sertifikasyona gelebilirsiniz. \n \n 16) Sertifikasyon onay isteÄi oluÅturmak iÃ§in nasÄ±l bir yol izlemeliyiz? \n \n TÃ¼m seritifkasyon sÃ¼reÃ§leri ile ilgili bilgiler Tripsit>BKM Online> ÃHVPS > dokÃ¼manlar menÃ¼sÃ¼ altÄ±nda paylaÅÄ±lmaktadÄ±r. Bu sÃ¼reÃ§le ilgili yine destek alabileceÄiniz Sertifikasyon Merkezi > ÃHVPS Sertifikasyon Bilgilendirme menÃ¼sÃ¼ altÄ±nda sertifikasyon sÃ¼reci ile ilgili video kaydÄ± bulunmaktadÄ±r. Gerekli video kaydÄ±na  https://sertifikasyon-preprod.bkmtest.com.tr/certification-ohvps-info link Ã¼zerinden eriÅim saÄlayabilirsiniz.\nBu alanlardaki belgeleri ve video kayÄ±tlarÄ±nÄ± inceleyerek destek alabilirsiniz. SimÃ¼latÃ¶r Ã¼zerinden sertifikasyon senaryolarÄ±nÄ±n kapsam dÄ±ÅÄ± hariÃ§ hepsinin tiklenerek onaya gÃ¶nderilmesi gerekmektedir. \n \n 17) Sertifikasyon slot tarihine yetiÅememe durumu ile karÅÄ±laÅÄ±laÅÄ±lÄ±rsa nasÄ±l ilerlemeliyiz? \n \n Sertifikasyon slot tarihine yetiÅilemediÄi durumda bir sonraki uygun sertifikasyon tarihinin katÄ±lÄ±mcÄ± tarafÄ±ndan tekrar talep edilmesi gereklidir. \n \n 18) Sertifikasyon iÃ§in koÅulmasÄ± gereken senaryolara nereden ulaÅabiliriz? \n \n AÅaÄÄ±daki link Ã¼zerinden eriÅim saÄlayabilirsiniz.\n https://sertifikasyon-preprod.bkmtest.com.tr/certification-rules \n \n 19) Sertifikasyon senaryolarÄ±nÄ±n hepsi koÅulmalÄ± mÄ±dÄ±r? Bireysel ve kurumsal iÃ§in ayrÄ± sertifikasyona gelinebilir mi? \n \n Kapsam dÄ±ÅÄ± olduÄunuz tÃ¼m senaryolar hariÃ§ hepsi koÅulmalÄ±dÄ±r. \n HHS SertifikasyonlarÄ± iÃ§in bireysel ve kurumsal birlikte koÅularak gÃ¶nderilmelidir. YÃS sertifikasyonlarÄ± iÃ§in hangi mÃ¼Återi segmentine hizmet verilecekse ilgili mÃ¼Återi segmenti iÃ§in ayrÄ± olarak sertifikasyona gelinebilir. \n Mobil ve Web Kanallar iÃ§in aynÄ± altyapÄ± (backend-arkayÃ¼z) kullanÄ±lÄ±yor ise sertifikasyonda web ve mobilin tek bir sertifikasyonda koÅulmasÄ± gerekmektedir. Detaylar  SÄ°MÃLATÃR KULLANIMI VE SERTÄ°FÄ°KASYON SÃREÃ KILAVUZU âunda yer almaktadÄ±r. \n \n 20) Sertifikasyon senaryolarÄ± koÅulurken nelere dikkat edilmelidir? Ekranlar nasÄ±l olmalÄ±dÄ±r? \n \n Sertifikasyon iÃ§in  https://ohvps.github.io/  adresinde yayÄ±nlanan API Ä°lke ve KurallarÄ± dokÃ¼manÄ±ndaki teknik gereksinimleri yerine getirmeniz beklenmektedir. \n Web/mobil ekranlar iÃ§in sertifikasyonda iletilmesi gereken zorunlu alanlar bulunmaktadÄ±r. Bu alanlar iÃ§in Trip/Tripsit > BKM Online > ÃHVPS >DokÃ¼manlar menÃ¼sÃ¼ altÄ±nda yer alan âMÃ¼Återi Deneyim DokÃ¼manÄ±ânÄ± inceleyebilirsiniz. Ekranlarda istenilen Åartlar yerine getirildiÄi sÃ¼rece ekran tasarÄ±mlarÄ± kurum/kuruluÅlarÄ±n insiyatifine bÄ±rakÄ±lmÄ±ÅtÄ±r.\nSertifikasyona gelmeden Ã¶nce ekranlar son kullanÄ±cÄ±ya gÃ¶sterilecek Åekilde hazÄ±rlanmalÄ±dÄ±r. \n \n 21) Sertifikasyon onay isteÄi nasÄ±l oluÅturabiliriz? \n \n Tripsit >BOSS> Sertifikasyon OnayÄ± OluÅturma seÃ§ilerek sertifikasyon ekranÄ±na eriÅim saÄlanÄ±r. âSertifikasyon Onay Ä°steÄi OluÅturmaâ ekranÄ± ile katÄ±lÄ±mcÄ±lar ilgili APIâye ait sertifikasyon senaryolarÄ± kapsamÄ±ndaki iÅlemlerini tamamladÄ±ktan sonra sertifikasyon isteklerini bu ekran Ã¼zerinden iletebilirler. Bu ekran Ã¼zerinden ekran gÃ¶rÃ¼ntÃ¼sÃ¼ ekleme, senaryonun kapsam dÄ±ÅÄ±na alÄ±nmasÄ± gibi iÅlemler yapÄ±labilmektedir. Sertifikasyon sonuÃ§larÄ± da yine bu ekran Ã¼zerinden takip edilebilir.\nDetaylar  SÄ°MÃLATÃR KULLANIMI VE SERTÄ°FÄ°KASYON SÃREÃ KILAVUZU âunda yer almaktadÄ±r.  Bu sÃ¼reÃ§le ilgili yine destek alabileceÄiniz video kaydÄ± bulunmaktadÄ±r. \n \n 22) Sertifikasyon onay isteÄi oluÅturdum. BaÅlatÄ±ldÄ± statÃ¼sÃ¼nde kaldÄ±. YardÄ±mcÄ± olabilir misiniz? \n \n Sertifikasyon talebinde bulunulduÄunda seÃ§ilen tarih aralÄ±ÄÄ±ndaki log kayÄ±tlarÄ± Ã§ekilerek otomatik olarak âÃalÄ±ÅtÄ±rÄ±ldÄ±â statÃ¼sÃ¼ne geÃ§mektedir. Sizin Ã§alÄ±ÅtÄ±rdÄ±ÄÄ±nÄ±z tarih aralÄ±ÄÄ±nda log kaydÄ± olup olmadÄ±ÄÄ± kontrol edilmelidir. HHS senaryolarÄ± koÅulurken X-Group-ID seÃ§iminin yapÄ±ldÄ±ÄÄ± kontrol edilmelidir. \n \n 23) Sertifikasyon onay isteÄi oluÅturdum. Senaryolar tiklenmedi. Kontrol edebilir misiniz? \n \n Sertifikasyon onayÄ± oluÅturulduktan sonra ilgili sertifikasyon id iÃ§in âDetayâ seÃ§ilmeli ve senaryonun neden tiklenmediÄi âHata GÃ¶râ kolonundan kontrol edilmelidir. \n \n 24) ÃHVPS SimÃ¼latÃ¶rlerini kullanarak geliÅtirmelerimizi tamamladÄ±k. Ãretim ortamÄ±na geÃ§iÅ iÃ§in neler yapÄ±lmasÄ± gerekir? \n \n Ãretim ortamÄ±na ait entegrasyon iÃ§in gerekli bilgilere aÅaÄÄ±daki dokÃ¼manlardan ulaÅabilirsiniz.\nTrip/Tripsit â BKM Online â ÃHVPS dokÃ¼manlar iÃ§erisinde yer almaktadÄ±r.\nBKM GeÃ§it - ÃHVPS Uygulama KurallarÄ±_Ver1.11\nDokÃ¼man iÃ§erisinde Ã¶zellikle incelenmesi gereken ilgili baÅlÄ±klar:\n \n \n \n KatÄ±lÄ±mcÄ± Gereksinimleri \n \n \n \n \n Entegrasyon AdÄ±mlarÄ± \n \n \n \n \n Ãretime GeÃ§iÅ \n \n \n \n \n \n Ãretim ortamÄ± YÃS ve HHS BKM GEÃÄ°T entegrasyonlarÄ± https://pys.bkm.com.tr adresi Ã¼zerinden yapÄ±lacaktÄ±r.\nÄ°lgili adrese eriÅimler aÃ§Ä±k olup katÄ±lÄ±mcÄ±lar Tripâe ( https://trip.bkm.com.tr ) giriÅ yapÄ±lan kullanÄ±cÄ± adÄ± ve Åifresi ile girilebilecektir.\nHHS ve YÃS tanÄ±mlarÄ±na ait menÃ¼ler iÃ§in yetki alÄ±nmasÄ± gerekmektedir. Ä°lgili yetkiler iÃ§in kurumunuza Ã¶zgÃ¼ olan Superuser kullanÄ±cÄ±lardan yetki talep edilmelidir.\nSuperuser sÃ¼reÃ§leri ile PYS Ã¼zerinde ilgili hizmetlerin yetkilerine dair dokÃ¼manlar Trip/Tripsit â BKM Online â ÃHVPS dokÃ¼manlar iÃ§erisinde yer almaktadÄ±r.\nEk-1: Merkezi KullanÄ±cÄ± YÃ¶netim Sistemi Uygulama KurallarÄ±-Åubat 2025\nEk-2: Parametre YÃ¶netim Sistemi AÃ§Ä±k BankacÄ±lÄ±k YÃS ve HHS Yetki Talebi KÄ±lavuzu \n 25) ÃHVPS APIâlarÄ±na ait swagger dosyasÄ± bulunmakta mÄ±dÄ±r? \n \n Evet bulunmaktadÄ±r. ÃHVPS > HHS/YÃS SimÃ¼latÃ¶rÃ¼ ekranÄ±na gidilerek aÃ§Ä±lan sayfada istenilen API seÃ§ilir ve âSwagger DokÃ¼manÄ±nÄ± Ä°ndirâ seÃ§ilerek indirebilir. \n \n 26) ÃHVPS API Ä°lke ve KurallarÄ± dokÃ¼manÄ±nda yapÄ±lan deÄiÅiklikleri nereden gÃ¶rebiliriz? \n \n https://ohvps.github.io/  adresine gidildiÄinde ana sayfada yer alan  https://github.com/ohvps/ohvps.github.io/commits/master  adresi Ã¼zerinden deÄiÅiklik aÃ§Ä±klamalarÄ± ve tarihÃ§esi incelenebilir. \n \n 27) GeliÅtirmeler sÄ±rasÄ±nda dokÃ¼man ile simÃ¼latÃ¶r arasÄ±nda fark gÃ¶rÃ¼ldÃ¼ÄÃ¼nde hangisi doÄrudur? NasÄ±l ilerlemeliyiz? \n \n SimÃ¼latÃ¶r ortamÄ± katÄ±lÄ±mcÄ±larÄ±n API geliÅtirmelerini test edebilmesi iÃ§in oluÅturulmuÅ sandbox ortamdÄ±r. BazÄ± geliÅtirmeler katÄ±lÄ±mcÄ±larÄ±n test edebilmesi iÃ§in simÃ¼latÃ¶r tarafÄ±nda esnek bÄ±rakÄ±lmÄ±ÅtÄ±r. Bu yÃ¼zden her zaman dokÃ¼man dikkate alÄ±nmalÄ±dÄ±r. SimÃ¼latÃ¶rÃ¼n geliÅtirilmesi iÃ§in farklÄ±lÄ±ÄÄ± bizlere iletebilirsiniz. \n \n 28) AÃ§Ä±k BankacÄ±lÄ±k kanal ayarlarÄ± her kullanÄ±cÄ±ya default olarak aÃ§Ä±k mÄ± olmalÄ±dÄ±r? \n \n AÃ§Ä±k BankacÄ±lÄ±k mÃ¼Återiye bir kanal olarak sunuluyorsa mÃ¼Återinin kanal ayarÄ±nÄ± aÃ§Ä±p kapatabileceÄi bir ekran olmasÄ± gerekmektedir. Ãretim ortamÄ±na ilk Ã§Ä±kÄ±ldÄ±ÄÄ±nda default olarak aÃ§Ä±k olmalÄ±dÄ±r. MÃ¼Återi dilerse kendi kapatabilmelidir.   https://ohvps.github.io/v1.1.0/contents/temel-prensipler.html  temel prensipler baÅlÄ±ÄÄ± altÄ±ndan inceleyebilirsiniz. \n \n 29) Sadece web uygulamamÄ±z Ã¼zerinden ÃHVPS APIâlarÄ±nÄ± kullanmak istiyoruz. Sorun olur mu? \n \n HHS olunan rolde tarayÄ±cÄ± tabanlÄ± yÃ¶nlendirme yapÄ±lmasÄ± zorunlu olmakla beraber 1 Ekim 2023 itibarÄ±yla HHSânin uygulamasÄ± varsa uygulama tabanlÄ± yÃ¶nlendirme hizmeti vermesi de zorunludur. \n \n 30) Daha Ã¶nce sorulan katÄ±lÄ±mcÄ± sorularÄ±na nereden ulaÅabiliriz? \n \n Trip/Tripsit > BKM Online > ÃHVPS > DokÃ¼manlar menÃ¼sÃ¼ altÄ±ndan ulaÅabilirsiniz. \n \n 31) ÃHVPS Ãretim ortamÄ± katÄ±lÄ±mcÄ±larÄ±nÄ±n iletiÅim adreslerine nereden ulaÅabiliriz? \n \n Trip/Tripsit > BKM Online > ÃHVPS > Ä°letiÅim Listesi altÄ±ndan bulabilirsiniz. Bu menÃ¼ye eriÅim saÄlayamÄ±yorsanÄ±z  [email protected]  adresinden yetki talep edebilirsiniz. \n \n 32) Sertifikasyon iÃ§in yeni sÃ¼rÃ¼m olan V 2.0.0 sÃ¼rÃ¼mÃ¼ne gelmek zorunda mÄ±yÄ±z? Eski sÃ¼rÃ¼m ile sertifikasyona gelebilir miyiz? \n \n 1 EylÃ¼l 2025 tarihinden sonra sertifikasyon talebinde bulunan tÃ¼m katÄ±lÄ±mcÄ±larÄ±n V 2.0.0 aktif sÃ¼rÃ¼mÃ¼ne gelme zorunluluÄu bulunmaktadÄ±r.\nMevcutta 1.1.0 sÃ¼rÃ¼mÃ¼ ile Ã¼retim ortamÄ±nda hizmet veren katÄ±lÄ±mcÄ±larÄ±n V 2.0 iÃ§in hangi tarihlerde sertifikasyona geleceÄi ve Ã¼retime geÃ§iÅ yapacaÄÄ± bilgisi  https://ohvps.github.io/  linkinde yer almaktadÄ±r. \n \n 33) SÃ¼rÃ¼m 2.0 sertifikasyonu

16nu almak iÃ§in SÃ¼rÃ¼m 1.1 sertifikasyonunu almak gerekiyor mu? AÃ§Ä±k bankacÄ±lÄ±k sistemine 2.0 versiyonu ile dahil olunabilir mi? \n \n ÃHVPS kapsamÄ±nda ilk kez sertifikasyona gelecek olan kurumlar aktif sÃ¼rÃ¼m olan 2.0 sÃ¼rÃ¼mÃ¼ ile sertifikasyona gelmeleri yeterlidir. Sertifikasyon senaryolarÄ± listeleme ekranÄ±nda versiyon gÃ¼ncelleme seÃ§eneÄini seÃ§meden hizmet verecek kanal ve mÃ¼Återi bazÄ±nda senaryolarÄ± listlemeli ve ilgili senaryolarÄ± koÅarak sertifikasyona gelmelidir. \n \n 34) AyrÄ±k GKD bilgilendirme mesajÄ± kullanÄ±cÄ±ya iletilmezse sÃ¼reci nasÄ±l yÃ¶netebiliriz? \n \n \n MÃ¼Återinin ne Åekilde bilgilendirileceÄi HHS inisiyatifindedir. AÅaÄÄ±da paylaÅmÄ±Å olduÄumuz linkte detaylÄ± bilgi yer almaktadÄ±r. Linkte yer alan detaya istinaden HHS olarak iÅlemi red etmeniz uygundur. YÃS olarak ise hata almÄ±Å bir ayrÄ±k GKD iÅlemini yÃ¶nlendirmeli akÄ±Åa Ã§evirip tekrar iletebilirsiniz. \n https://ohvps.github.io/v2.0.0/contents/gkd.html#_5-2-ayr%C4%B1k-guclu-kimlik-dogrulama \n \n \n 35) AyrÄ±k GKD sadece mobil uygulamaya mÄ± bildirim gÃ¶nderilebilir? Sms iÃ§erisinde webe yÃ¶nlenecek universal link verebilir mi? \n \n AyrÄ±k GKD sÃ¼recinde HHS tarafÄ±nda sadece mobil uygulama Ã¼zerinden GKD yapÄ±lmalÄ±dÄ±r. ÃHKânÄ±n web uygulamasÄ±na yÃ¶nlendirme yapmamasÄ± gerekmektedir. SMS iletilecekse sms iÃ§erisindeki universal link sadece mobile yÃ¶nlendirilmelidir.  https://ohvps.github.io/v2.0.0/contents/gkd.html#_5-2-ayr%C4%B1k-guclu-kimlik-dogrulama  adresinden detaylÄ± inceleyebilirsiniz. \n \n 36) Mevcut sistemimizde GSM birden fazla mÃ¼Återide tanÄ±mlÄ±dÄ±r. Bu noktada AyrÄ±k GKD Tek seferlik Ã¶deme akÄ±ÅÄ±nda hangi mÃ¼Återiye bildirim gÃ¶nderilmesi gerektiÄini ayÄ±rt edemeyeceÄimizden sorun oluÅturmaktadÄ±r. Bu nedenle GSM iÃ§in muafiyet talep edilebilir mi? \n \n Mevcut durumda ilgili cep numarasÄ±na nasÄ±l bildirim gÃ¶nderiliyorsa aynÄ± yÃ¶ntem izlenebilir. (Yetkili kiÅi atamasÄ± yapÄ±labilir vs.) \n \n 37) Hesap Bilgisi Hizmeti ve Ãdeme Emri BaÅlatma Hizmeti akÄ±ÅlarÄ±nda default olarak yÃ¶nlendirmeli akÄ±Å tercih edilebilir mi? Yoksa ayrÄ±k GKD sunan HHSâler iÃ§in, YÃSâÃ¼n de ayrÄ±k GKDâyi tercih etmesi zorunlu mudur? \n \n YÃSâÃ¼n kendi insiyatifindedir.  https://ohvps.github.io/v2.0.0/contents/gkd.html#_5-2-ayr%C4%B1k-guclu-kimlik-dogrulama  detaylÄ± bilgiye eriÅebilirsiniz. \n \n 38) Kurumumuzun YÃS olduÄu durumda karÅÄ± HHS AyrÄ±k GKD'yi desteklese dahi kullanÄ±cÄ±da HHS'ye ait mobil uygulama olmadÄ±ÄÄ± takdirde nasÄ±l ilerlememiz beklenmektedir? \n \n https://ohvps.github.io/v2.0.0/contents/gkd.html#_5-2-ayr%C4%B1k-guclu-kimlik-dogrulama  adresinden detaylÄ± senaryolarÄ± inceleyebilirsiniz. \n \n 39) YÃS olduÄumuz durumda ayrÄ±k GKD kimlik doÄrulama web akÄ±ÅÄ±ndan baÅlayabilir mi yoksa mobil uygulamada olma zorunluluÄu var mÄ±dÄ±r? \n \n Her iki kanaldan iÅlem baÅlatÄ±labilmektedir. \n \n 40) Yeni sÃ¼rÃ¼m (V 2.0) kapsamÄ±nda Olay Bildirim Servisâlerinin kullanÄ±lmasÄ± zorunlu mudur? \n \n Olay Dinleme APIânÄ±n (ODS) servis olarak sunulmasÄ± HHS ve YÃSâler iÃ§in zorunludur. Olay Abonelik Servisleriânin (OAS) kullanÄ±mÄ± YÃS insiyatifindedir. YÃS, AyrÄ±k GKD yÃ¶ntemi kullanacaksa ise AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in de abonelik oluÅturulmasÄ± gerekir.  https://ohvps.github.io/v2.0.0/contents/olay-bildirim.html  detaylÄ± inceleyebilirsiniz. \n \n 41) Sertifikasyon senaryolarÄ± iÃ§erisinde yer alan sistem olay dinlemeyi nasÄ±l test edebiliriz? Bu konuda yÃ¶nlendirebilir misiniz? \n \n KullanmÄ±Å olduÄunuz YÃS simÃ¼latÃ¶rÃ¼ iÃ§in Tripsit Ã¼zerinden gÃ¼ncelleme yapÄ±lmasÄ± saÄlanarak HHS tarafÄ±na sistem olay dinleme kaydÄ± oluÅturabilirsiniz. \n \n 42) ÃHVPS API kullanÄ±mlarÄ± iÃ§in Ã¼cretlendirme olacak mÄ±dÄ±r? Ãcretlendirme kapsamÄ±nda nasÄ±l bir yol haritasÄ± izlenecektir? \n \n Sorgulama yÃ¶nteminin ne Åekilde devam edeceÄi YÃS'Ã¼n inisiyatifindedir. API sorgulamalarÄ± Ã¼zerinden Ã¼cret alÄ±nmaya devam edecektir. Olay bildirimi ile YÃS'lerin api sorgulamasÄ± arasÄ±nda bir baÄlantÄ± olmamakla beraber TCMB'nin belirlediÄi tarihten itibaren Ã¼cretlendirme devreye alÄ±nacaktÄ±r. \n TCMB'nin daha evvel bilgi verdiÄi Ã¼cretlendirme iÃ§eriÄi ile ilgili detaylar Ã¶nÃ¼mÃ¼zdeki gÃ¼nlerde Trip>ÃHVPS dokÃ¼manlarÄ± altÄ±nda yer alan ÃHVPS Uygulama KurallarÄ± DokÃ¼manÄ±nda detaylandÄ±rÄ±lacaktÄ±r. \n \n 43) Olay Bildirim devreye alÄ±ndÄ±ktan sonra bankalarÄ±n sorgulamalarÄ± devam edebilecek mi, o sorgulamalardan Ã¼cret alÄ±nabilir mi? \n \n Sorgulama yÃ¶nteminin ne Åekilde devam edeceÄi YÃS'Ã¼n inisiyatifindedir. API sorgulamalarÄ± Ã¼zerinden Ã¼cret alÄ±nmaya devam edecektir. Olay bildirim ile YÃS'lerin api sorgulamasÄ± arasÄ±nda bir baÄlantÄ± olmamakla beraber TCMB'nin belirlediÄi tarihten itibaren Ã¼cretlendirme devreye alÄ±nacaktÄ±r. \n \n 44) Sertifikasyonu tamamlayarak Ã¼retim ortamÄ±na geÃ§iÅ yaptÄ±ktan sonra hizmet vermeyi durdurabilir miyiz? Evet ise, ne kadar sÃ¼re ile hizmet vermeyebiliriz? \n \n HHS olunan rolde hizmet durdurulmasÄ± gibi b

16ir durum sÃ¶z konusu deÄildir. \n \n 45) BKM AÃ§Ä±k BankacÄ±lÄ±k Deney AlanÄ± Nedir? \n \n AÃ§Ä±k BankacÄ±lÄ±k Deney AlanÄ±, ÃHVPS (Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri) kapsamÄ±ndaki aÃ§Ä±k bankacÄ±lÄ±k hizmetlerinin katÄ±lÄ±mcÄ±lar (HHS ve YÃS) ve katÄ±lÄ±mcÄ± olmayan kuruluÅlar ve finansal teknoloji giriÅimleri tarafÄ±ndan belirli Ã§erÃ§evelerde deneyebileceÄi, test amaÃ§lÄ± kullanÄ±lan aÃ§Ä±k simÃ¼latÃ¶rlerin bulunduÄu bir test ortamÄ±dÄ±r. Ä°lgili alana  https://ohvps.github.io/v2.0.0/deneyalani/genel-bilgiler.html  linkinden eriÅebilirsiniz. \n \n 46) AÃ§Ä±k BankacÄ±lÄ±k Kurumsal BankacÄ±lÄ±k tarafÄ±nda tÃ¼zel kiÅilerin hesaplarÄ±nÄ±n yetkilendirilmesi (mÃ¼nferit/mÃ¼Återek) nasÄ±l yapÄ±lmalÄ±, nereden bilgi alabilirim? \n \n TÃ¼zel taraftaki MÃ¼Återi yetkileri iÃ§in BKM tarafÄ±nda bir yÃ¶nlendirme yapÄ±lamamaktadÄ±r. Banka iÃ§inde bu kiÅilerin neye yetkisi varsa ÃHVPS kapsamÄ±nda da aynÄ± mÃ¼Återi deneyimini yansÄ±tacak Åekilde Ã§Ã¶zÃ¼m Ã¼retmeniz beklenir. \n \n 47) FAST katÄ±lÄ±mcÄ±sÄ± olan kurumlarÄ±n HHS olma zorunluluÄu bulunmakta mÄ±dÄ±r? Nezdinde Ã¶deme hesabÄ± bulunduran kuruluÅlar ÃHVPS kapsamÄ±nda HHS olarak hizmet verme zorunluluÄu bulunuyor mu? \n \n ÃHVPS API ilke ve KurallarÄ± dokÃ¼manÄ±nda da ifade edildiÄi Ã¼zere, YÃ¶netmelik ve TebliÄde yapÄ±lan 28 Mart 2025 tarihli deÄiÅiklik itibarÄ±yla;\n \n FAST Sistemine katÄ±lÄ±mcÄ± olan Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n 31 AralÄ±k 2025 tarihine kadar teknik sertifikasyonlarÄ±nÄ± baÅarÄ±yla tamamlayarak GEÃÄ°Tâe baÄlantÄ± saÄlamalarÄ± gerekmektedir (HHSâleri ilgilendirmektedir.) \n \n \n \n 48) HHS 1.1 sÃ¼rÃ¼mÃ¼ tamamlanamadÄ±ysa, yalnÄ±zca HHS 2.0 iÃ§in hazÄ±rlanan senaryolarÄ± Ã§alÄ±ÅtÄ±rmak yeterli olur mu? \n \n S1.1 ile Ã¼retim ortamÄ±nda hizmet verilmiyor ise sertifikasyon senaryolarÄ±nÄ± listelerken versiyon gÃ¼ncelleme seÃ§meden (en baÅtan tÃ¼m senaryolar koÅulacaktÄ±r) S2.0 sertifikasyonuna gelinmelidir. \n \n 49) Test otomasyon adÄ±mÄ±nÄ± âsertifikasyon Ã¶ncesi test sÃ¼reciâ olarak adlandÄ±rabilir miyiz? Bu adÄ±m zorunlu bir adÄ±mdÄ±r mÄ±? \n \n HHS'lerin S2.0 sertifikasyonunu geÃ§ebilmeleri iÃ§in test otomasyon adÄ±mÄ±nÄ± baÅarÄ±lÄ± bir Åekilde tamamlamalarÄ± beklenmektedir. Sertifikasyon Onay Ä°steÄi Ã§alÄ±ÅtÄ±rÄ±ldÄ±ktan sonra onaya gÃ¶nderme aÅamasÄ±nda Ã§alÄ±ÅtÄ±rÄ±lan test otomasyon id bilgileri talep edilmektedir. \n \n 50) Slot (zaman dilimi) iÃ§inde yapÄ±lan incelemeler sonucunda sertifikasyon baÅarÄ±sÄ±z olursa ve yeniden koÅulmasÄ± istenirse, yeni bir slot alÄ±nmasÄ± gerekir mi? Yeni bir slot bulunamazsa ne tÃ¼r bir yol izlenmelidir? \n \n Revize sÃ¼reÃ§leri kapsamÄ±nda tekrardan slot alÄ±nmasÄ±na gerek yoktur. Sadece ilk kez sertifikasyon onayÄ± gÃ¶nderilecek durum iÃ§in slot alÄ±nmasÄ± gereklidir. \n \n 51) Sertifikasyon senaryolarÄ± ve test otomasyon testleri slot tarih aralÄ±ÄÄ±nda mÄ± Ã¶ncesinde mi koÅulacaktÄ±r? \n \n Slot tarihi seritifikasyon kontrollerinin gerÃ§ekleÅtirileceÄi tarih olup bu kapsamda slot tarihinden Ã¶nce sertifikasyon onayÄ± ve test otomasyon koÅumu gerÃ§ekleÅtirilmelidir. \n \n 52) Demo kontrolleri iÃ§in Ã¶nce sertifikasyon onayÄ± alÄ±nmasÄ± mÄ± gerekmektedir? \n \n Demo, Ã¼retim ortamÄ±nda gerÃ§ekleÅtirilen; sistemlerinizin baÅarÄ±lÄ± Ã§alÄ±ÅÄ±p Ã§alÄ±ÅmadÄ±ÄÄ±nÄ±n kontrolÃ¼ yapÄ±lan uygulamadÄ±r. Bu kapsamda, Ã¶nce sertifikasyon onayÄ± alÄ±nmasÄ± ÅarttÄ±r. \n \n 53) Ãdeme emri test otomasyonu senaryosunda KOLAS ya da AyrÄ±k GKD desteklemeyen bir katÄ±lÄ±mcÄ± ne yapmalÄ±? \n \n HHS'lerin FAST katÄ±lÄ±mcÄ± olma ÅartÄ± bulunduÄu iÃ§in KOLAS desteklenmesi beklenmektedir. EÄer mobil uygulamanÄ±z var ise yine AyrÄ±k GKD desteklenmesi gerekiyor. Bu ÅartlarÄ±n dÄ±ÅÄ±nda farklÄ± bir durumunuz var ise desteklemediÄiniz akÄ±ÅlarÄ± otomasyonda koÅmayabilirsiniz. \n \n 54) Kurum olarak mevcut yapÄ±mÄ±zda kart hizmeti vermediÄimiz durum iÃ§in kartlarla ilgili senaryolarÄ±Ä± ve adÄ±mlarÄ± atlayabilir miyiz? \n \n HHS olarak ilgili hizmet desteklenmiyor ise kapsam dÄ±ÅÄ± aÃ§Ä±klamasÄ± girerek kapsam dÄ±ÅÄ±na alabilirsiniz. YÃS olarak dilediÄiniz hizmet ve Ã¶zellik iÃ§in sertifikasyona gelebilirsiniz. \n \n 55) Kurumsal bir firmayÄ±z bireysel hesaplarÄ±mÄ±z bulunmamaktadÄ±r. Buna istinaden sertifikasyon isteÄimizi kurumsal/web olarak talep ettik ancak HHS olarak bireysel mÃ¼Återiler iÃ§inde bir sÃ¼reÃ§ koÅmalÄ± mÄ±yÄ±z? \n \n Mevcutta HHS rolÃ¼ iÃ§in hangi kanal ve mÃ¼Återi tipi Ã¼zerinden hizmet veriliyorsa aÃ§Ä±k bankacÄ±lÄ±k kapsamÄ±nda da ilgili hizmetler verilmelidir. YÃS rolÃ¼ iÃ§in herhangi bir zorunluluk bulunmamaktadÄ±r. \n \n 56) Ä°leri tarihli Ã¶deme ve dÃ¼zenli Ã¶deme hizmetleri zorunlu mudur? Bu hizmetlerden muaf olunabilir mi? \n \n HHS olarak mevcut durumda kendi kanallarÄ±nÄ±zdan vermiÅ olduÄunuz hizmetleri ÃHVPS kapsamÄ±nda da vermek zorundasÄ±nÄ±z. \n \n 57) Mevcut olmayan bir Ã¶zelliÄi sonradan eklersek nasÄ±l sertifikasyona gelmemiz gerekecek? ÃrneÄin sonradan kurumsal eklemesi yapÄ±ldÄ±. \n \n Sadece ilgili senaryolar iÃ§in tekrar sertifikasyona gelmeniz beklenmektedir. \n \n 58) HHS olarak banka olmayan bir

16kuruluÅ sertifikasyona girdiÄinde Ã¶deme servislerinde Kolas ve QR ile Ã¶deme gibi yÃ¶ntemleri muaf olabilir mi? \n \n Kurumunuzun mevcut yapÄ±sÄ±nda ilgili servisler desteklenmiyor ise kapsam dÄ±ÅÄ±na alabilirsiniz. \n \n 59) YÃS olarak daha Ã¶nce mobil sÃ¼reÃ§leri devreye almadÄ±ÄÄ±mÄ±z durumda 2.0.0 kapsamÄ±nda da muaf olabilir miyiz? S2.0 kapsamÄ±nda mobil zorunlu mudur? \n \n YÃSâler iÃ§in kanal zorunluluÄu bulunmamaktadÄ±r. Sertifikasyona dilediÄiniz kanaldan gelebilirsiniz. \n \n 60) YÃS olarak alÄ±nacak kart bilgileri ve hareketleri iÃ§in uygulamamÄ±zda kullanÄ±cÄ±ya bir kart gÃ¶rseli gÃ¶stermek zorunda mÄ±yÄ±z? Kart gÃ¶rseli gÃ¶stermesek olmaz mÄ±? \n \n Kart gÃ¶rseli iÃ§in belirlenmiÅ olan standartlar bulunmaktadÄ±r. Sertifikasyon dokÃ¼manlarÄ±ndan ilgili bilgiye eriÅebilirsiniz. \n \n 61) AsÄ±l kart sahibi ek karta da rÄ±za verebilir mi? \n \n \n HHS ekranlarÄ±nda kart seÃ§imi yapÄ±larak rÄ±za verilirken asÄ±l kart seÃ§ilmeden ilgili asÄ±l karta baÄlÄ± sanal ve ek kartlarÄ±n ayrÄ±ca seÃ§ilerek rÄ±za verilmesine izin verilmemelidir. HHS mevcut kanallarÄ±nda ek ve sanal kart hareketlerini asÄ±l karttan ayÄ±rt etmeden mÃ¼Återisine gÃ¶steriyor ise asÄ±l kart seÃ§imi ile birlikte asÄ±l karta baÄlÄ± sanal ve/veya ek kart seÃ§imini zorunlu kÄ±lmalÄ±dÄ±r. AsÄ±l kart hamili dÄ±ÅÄ±nda bir kiÅi iÃ§in ek kart Ã§Ä±kartÄ±ldÄ±ÄÄ± durumda ek kart sahibi HHS'de asÄ±l kartÄ± gÃ¶rmeyecek olduÄundan sadece kendisine Ã§Ä±kartÄ±lan ek kartÄ± listelenecek ve seÃ§erek rÄ±za vermesi saÄlanacaktÄ±r. Ek kart hamilinin asÄ±l kart hamilinden farklÄ± olduÄu durumda asÄ±l karta ait bir rÄ±za olmasa da ek karta rÄ±za verilebilir. \n DetaylÄ± bilgi iÃ§in  https://ohvps.github.io/v2.0.0/contents/hesap-bilgisi-hizmeti.html#_9-9-adim-4-kart-bilgilerinin-sorgulanmas%C4%B1 . \n \n \n 62) YÃS ortamÄ±nda aynÄ± anda hem hesap hem de kart rÄ±za izni verilebiliyor mu? RÄ±za izinleri 1-6 ve ek olarak 7-9 gibi ayrÄ± gruplar halinde mi sunuluyor; bu izinler ayrÄ± ayrÄ± mÄ± gÃ¶nderilmeli? \n \n Hesap ve kart izinleri alÄ±nmak isteniyor ise aynÄ± anda hesap rÄ±za isteÄi verilmelidir. YÃS olarak sadece hesap ya da kart hizmeti de sunabilirsiniz. \n \n 63) Hesaba rÄ±za verilip karta verilmediÄi durumda HHS rolÃ¼nde rÄ±za altÄ±nda tÃ¼m kartlar gÃ¶rÃ¼ntÃ¼lenecek midir? \n \n HayÄ±r, sadece hesap iÃ§in izin tÃ¼rleri iletildi ise HHS tarafÄ±ndan sadece hesaplar listelenmelidir. YÃS Ã¼zerinden iletilen izin tÃ¼rleri kapsamÄ±nda hesaplar listelemelidir. \n \n 64) Hesap bilgisi gÃ¼ncelleme akÄ±ÅÄ±nda, daha Ã¶nce hesap rÄ±zasÄ± vermiÅ bir mÃ¼Återi aynÄ± iÅlem sÄ±rasÄ±nda kartlara da rÄ±za verebilir mi? \n \n Evet, belirttiÄiniz Åekilde yapÄ±labilmektedir. Ancak mÃ¼Återiye mevcut rÄ±zadaki bilgiler default gÃ¶sterilmeli; mÃ¼Återi istediÄi kartlarÄ± da ekleyebilmelidir. \n \n 65) Hem Hesap Ä°zni Hem de kart iznini veren bir kullanÄ±cÄ± kart Ã¶zelinde iznini kaldÄ±rdÄ±ÄÄ±nda / yenilediÄinde hesap izni de kaldÄ±rÄ±lacak mÄ±? Yoksa hesap izni devam edecek mi? \n \n Hesaplar ve kartlar iÃ§in tek hesap bilgi rÄ±zasÄ± Ã¼zerinden izin verilmektedir. KullanÄ±cÄ± sadece kartlara iznini kaldÄ±rÄ±r, hesap iÃ§in devam etmesini istiyor ise hesap izinleri devam edecektir. \n \n 66) Kart numarasÄ±nÄ±n deÄiÅtiÄi durumda (KayÄ±p/ÃalÄ±ntÄ± sebebiyle A kartÄ±nÄ±n B kart numarasÄ±na dÃ¶ndÃ¼ÄÃ¼ durum) mÃ¼Återinin kartÄ±na verdiÄi rÄ±za devam etmeli mi? \n \n Kart ref ID deÄiÅmediÄi sÃ¼rece mevcut rÄ±za devam etmelidir. \n \n 67) Talimat Durumu statÃ¼leri servisten mi dÃ¶nmektedir, diÄer HHSâlerden bu bilgi alÄ±nacak mÄ±dÄ±r? \n \n Ä°TÃ'de Ã¶deme durumu yer almaktadÄ±r. DTÃ'de de Ã¶deme planÄ± iÃ§erisinde Ã¶deme durumu yer almaktadÄ±r. API dokÃ¼manÄ±nÄ± inceleyebilirsiniz. \n \n 68) Kart Detay servisindeki kalanToplamTaksitTutari parametresi iÃ§in kredi kartÄ± mevcut yapÄ±mÄ±zda YP (yabancÄ± para) iÅlemlerde taksitli iÅlem bulunmadÄ±ÄÄ± durumda ilgili alanda dÃ¶nÃ¼lmesi gereken bilgi nedir? \n \n YP'de taksit Ã§Ã¶zÃ¼mÃ¼nÃ¼n olmamasÄ± durumunda bu alanÄ±n 0 olarak dÃ¶nmesi beklenecektir. \n \n 69) DÃ¼zenli tekrarlÄ± Ã¶demelerde Ã¶deme planÄ± iÃ§erisinde bulunan herhangi bir tekil Ã¶deme, dÃ¼zenli Ã¶deme rÄ±zasÄ±ndan baÄÄ±msÄ±z Åekilde dÃ¼zenlenebilecek midir? \n \n HHS'ler Ã¶deme planÄ±nda gÃ¼ncelleme yapÄ±labilir; gÃ¼ncelleme yapÄ±ldÄ±ÄÄ± bilgisi olay bildirimi ile YÃSâe iletilmelidir. \n \n 70) Kart hareketleri raporunda âDÃ¶nem Taksit TutarÄ±â ifadesi, ilgili dÃ¶neme giren taksitli iÅlemlerin toplamÄ±nÄ± mÄ± ifade etmektedir? \n \n Ä°lgili dÃ¶nem deÄeri iÃ§erisindeki toplam taksit tutar bilgisi iletilmelidir. \n \n 71. Kart durumu \"Pasif\" olacak kartlar iÃ§in hangi durumlarÄ± dahil etmeliyiz? Blokeli olan ve geÃ§ici kapalÄ± olan kartlar da \"pasif\" olarak mÄ± deÄerlendirilmelidir? \n \n Tekrar aktif/aÃ§Ä±k hale gelme ihtimali olan kartlar pasif kart olarak deÄerlendirilmelidir. \n \n 72) DÃ¼zenli Ãdeme Emri iÃ§in YÃS ekranÄ±ndan kullanÄ±cÄ±dan hangi bilgiler alÄ±nmalÄ±dÄ±r? Tutar, tarih veya transfer sÄ±klÄ±ÄÄ± (HaftalÄ±k/AylÄ±k) seÃ§ilecek midir? Yoksa tÃ¼m bilgiler HHS Ã¼zerinden mi YÃS'lere gelecek? \n \n Talimat tutarÄ± dahil talimata dair tÃ¼m bilgiler HHS ekranlarÄ±ndan alÄ±nacak olup, HHS ekranlarÄ±ndan gÃ¼ncelleme yapÄ±labilecektir. \n \n"},{title:"ÃDEME HÄ°ZMETLERÄ° VERÄ° PAYLAÅIM SERVÄ°SLERÄ° (ÃHVPS) UYUM TARÄ°HLERÄ°",frontmatter:{},regularPath:"/uyum-tarihleri.html",relativePath:"uyum-tarihleri.md",key:"v-81b8a67a",path:"/uyum-tarihleri.html",content:" ÃDEME HÄ°ZMETLERÄ° VERÄ° PAYLAÅIM SERVÄ°SLERÄ° (ÃHVPS) UYUM TARÄ°HLERÄ° \n Hesap Hizmeti SaÄlayÄ±cÄ±lar ve Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±n ÃHVPS standartlarÄ±na uyumu iÃ§in tarihler, Ãdeme Hizmetleri ve Elektronik Para Ä°hracÄ± ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± HakkÄ±nda YÃ¶netmelik ile

16Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri Ä°le Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄâde belirlenmiÅtir. \n YÃ¶netmeliÄin 59 uncu maddesinin beÅinci fÄ±krasÄ±nda belirlenen yÃ¼kÃ¼mlÃ¼lÃ¼kler, nezdinde Ã¶deme hesabÄ± bulunduran ve bu hesaplar iÃ§in mÃ¼Återilerine doÄrudan Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄlayan hesap hizmeti saÄlayÄ±cÄ±larÄ±ndan \n \n FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi (FAST) Sistemine katÄ±lÄ±mcÄ± olan Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ± ile \n FAST Sistemine katÄ±lÄ±mcÄ± olmayan kuruluÅlardan her yÄ±l ayrÄ±ca hesaplanmak Ã¼zere Ã¶deme hacmi bakÄ±mÄ±ndan ilk on arasÄ±nda yer alanlar\niÃ§in geÃ§erlidir. \n \n Kapsamda yer alan Hesap Hizmeti SaÄlayÄ±cÄ±lar iÃ§in YÃ¶netmelik ve TebliÄde ÃHVPS uyum tarihleri aÅaÄÄ±daki Åekilde belirlenmiÅtir: \n \n \n FAST Sistemine katÄ±lÄ±mcÄ± olmayan Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n, katÄ±lÄ±mcÄ± olmalarÄ± halinde, katÄ±lÄ±mcÄ± olduklarÄ± tarihten itibaren 6 ay iÃ§erisinde teknik sertifikasyonlarÄ±nÄ± baÅarÄ±yla tamamlayarak GEÃÄ°Tâe baÄlantÄ± saÄlamalarÄ± gerekmektedir (HHSâleri ilgilendirmektedir.). \n \n \n FAST Sistemine katÄ±lÄ±mcÄ± olmayan Ã¶deme ve elektronik para kuruluÅlarÄ±ndan her yÄ±l ayrÄ±ca hesaplanmak Ã¼zere bir Ã¶nceki takvim yÄ±lÄ±nda gerÃ§ekleÅen iÅlemlere gÃ¶re Ã¶deme hacmi bakÄ±mÄ±ndan ilk on arasÄ±nda yer alan ve; \n â¢\t    Nezdinde bulunan Ã¶deme hesaplarÄ± iÃ§in mÃ¼Återilerine doÄrudan Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄlayan kuruluÅlarÄ±n, iÃ§inde bulunulan yÄ±lÄ±n sonuna kadar teknik sertifikasyonlarÄ±nÄ± baÅarÄ±yla tamamlayarak GEÃÄ°Tâe baÄlantÄ± saÄlamalarÄ± gerekmektedir (HHSâleri ilgilendirmektedir.). \n â¢\tNezdinde bulunan Ã¶deme hesaplarÄ± iÃ§in mÃ¼Återilerine doÄrudan Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄlamayan kuruluÅlarÄ±n ise, iÃ§inde bulunulan yÄ±l sonuna kadar Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄlamalarÄ± halinde Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄladÄ±klarÄ± tarihten itibaren 6 ay iÃ§erisinde teknik sertifikasyonlarÄ±nÄ± baÅarÄ±yla tamamlayarak GEÃÄ°Tâe baÄlantÄ± saÄlamalarÄ± gerekmektedir (HHSâleri ilgilendirmektedir.). \n \n \n YÃ¶netmelik ve TebliÄde yapÄ±lan 28 Mart 2025 tarihli deÄiÅiklik itibarÄ±yla; \n â¢\tFAST Sistemine katÄ±lÄ±mcÄ± olan Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n 31 AralÄ±k 2025 tarihine kadar teknik sertifikasyonlarÄ±nÄ± baÅarÄ±yla tamamlayarak GEÃÄ°Tâe baÄlantÄ± saÄlamalarÄ± gerekmektedir (HHSâleri ilgilendirmektedir.). \n â¢\tFAST Sistemine katÄ±lÄ±mcÄ± olmayan ve 2024 takvim yÄ±lÄ± Ã¶deme hacmi bakÄ±mÄ±ndan ilk on arasÄ±nda yer alan kuruluÅlardan; \n \n \n Nezdinde bulunan Ã¶deme hesaplarÄ± iÃ§in mÃ¼Återilerine doÄrudan Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄlayanlarÄ±n 31 AralÄ±k 2025 tarihine kadar teknik sertifikasyonlarÄ±nÄ± baÅarÄ±yla tamamlayarak GEÃÄ°Tâe baÄlantÄ± saÄlamalarÄ± gerekmektedir (HHSâleri ilgilendirmektedir.). \n \n \n Nezdinde bulunan Ã¶deme hesaplarÄ± iÃ§in mÃ¼Återilerine doÄrudan Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄlamayanlarÄ±n 2025 yÄ±lÄ± sonuna kadar Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄlamalarÄ± halinde Ã§evrim iÃ§i eriÅim imkÃ¢nÄ± saÄladÄ±klarÄ± tarihten itibaren 6 ay iÃ§erisinde teknik sertifikasyonlarÄ±nÄ± baÅarÄ±yla tamamlayarak GEÃÄ°Tâe baÄlantÄ± saÄlamalarÄ± gerekmektedir (HHSâleri ilgilendirmektedir.). \n \n \n FAST Sistemine katÄ±lÄ±mcÄ± olmayan ve 2024 takvim yÄ±lÄ± Ã¶deme hacmi bakÄ±mÄ±ndan ilk 10 arasÄ±nda yer alan kuruluÅlar aÅaÄÄ±daki gibidir: \n \n \n \n KuruluÅ Kod \n KuruluÅ Unvan \n \n \n \n \n 0855 \n Elekse Elektronik Para ve Ãdeme KuruluÅu A.Å. \n \n \n 0853 \n UPT Ãdeme Hizmetleri ve Elektronik Para A.Å. \n \n \n 0850 \n BPN Ãdeme ve Elektronik Para Hizmetleri A.Å. \n \n \n 0830 \n D Ãdeme Elektronik Para ve Ãdeme Hizmetleri A.Å. \n \n \n 0852 \n N Kolay Ãdeme ve Elektronik Para KuruluÅu A.Å. \n \n \n 0863 \n Paytr Ãdeme ve Elektronik Para KuruluÅu A.Å. \n \n \n \n \n \n \n \n 6493 SayÄ±lÄ± Kanunâun GeÃ§ici 3 Ã¼ncÃ¼ maddesinin Ã¼Ã§Ã¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca TCMBâye faaliyet izni baÅvurusunda bulunmuÅ olup faaliyet izni sÃ¼reci devam edenler ile TCMBâden faaliyet izni almÄ±Å olan KuruluÅlara teknik gereklilikleri belirlenmiÅ veri paylaÅÄ±m hizmetleri, standart olmayan servislerle 30 Haziran 2024 tarihine kadar sunulabilir. (HHSâleri ilgilendirmektedir.) \n \n \n 6493 SayÄ±lÄ± Kanunâun GeÃ§ici 3 Ã¼ncÃ¼ maddesinin Ã¼Ã§Ã¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca TCMBâye faaliyet izni baÅvurusunda bulunmuÅ olup faaliyet izni deÄerlendirme sÃ¼reci devam edenler, teknik gereklilikleri belirlenmiÅ veri paylaÅÄ±m hizmetlerini, 30 Haziran 2024 tarihine kadar standart olmayan servisleri kullanarak verebilir. (YÃSâleri ilgilendirmektedir.) \n \n \n 5411 sayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar ile teknik gereklilikleri belirlenmiÅ veri paylaÅÄ±m  hizmetlerini sunmak Ã¼zere TCMBâden izin almÄ±Å olan kuruluÅlar (YÃSâler), TCMB Ãdeme Sistemlerinde 2020 yÄ±lÄ± iÃ§erisinde gerÃ§ekleÅtirilen hesaba Ã¶deme iÅlemleri aÃ§Ä±sÄ±ndan, toplam adedine gÃ¶re ilk on katÄ±lÄ±mcÄ± arasÄ±nda yer almayan Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ± nezdinde bulunan Ã¶deme hesaplarÄ± ile ilgili olarak, teknik gereklilikleri belirlenmiÅ veri paylaÅÄ±m servisleri hizmetlerini 30 Haziran 2024 tarihine kadar standart olmayan servisleri kullanarak verebilir. (YÃSâleri ilgilendirmektedir.) \n \n \n Teknik gereklilikleri henÃ¼z belirlenmemiÅ veri paylaÅÄ±m servisi hizmetleri, gereklilikler belirleninceye kadar standart olmayan servisler kullanÄ±larak verilmeye devam edilir. Banka tarafÄ±ndan teknik ve operasyonel gerekliliklerin belirlenmesinin ardÄ±ndan bu hizmetler iÃ§in de en geÃ§ bir yÄ±l iÃ§erisinde uyum saÄlanarak, hizmetler sÃ¶z konusu gerekliliklere uygun olarak yÃ¼rÃ¼tÃ¼lmeye baÅlanÄ±r. \n \n \n Referanslar: \n 6493 SayÄ±lÄ± Ãdeme ve Menkul KÄ±ymet Mutabakat Sistemleri, Ãdeme Hizmetleri ve Elektronik Para KuruluÅlarÄ± HakkÄ±nda Kanun   \

16n Ãdeme Hizmetleri ve Elektronik Para Ä°hracÄ± ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± HakkÄ±nda YÃ¶netmelik   \n Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri Ä°le Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄ \n"},{title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",frontmatter:{},regularPath:"/v1.0.1/contents/ekler.html",relativePath:"v1.0.1/contents/ekler.md",key:"v-48317b86",path:"/v1.0.1/contents/ekler.html",headers:[{level:2,title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",slug:"ek-1-istek-cevap-mesajlarÄ±nda-kullanÄ±lacak-nesne-yapÄ±larÄ±"},{level:2,title:"EK-2: SÄ±ralÄ± Veri TÃ¼rleri",slug:"ek-2-sÄ±ralÄ±-veri-turleri"},{level:2,title:"EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi",slug:"ek-3-istemci-sertifikalarÄ±nÄ±n-tanÄ±m-ve-yonetimi"},{level:2,title:"EK-4: Sunucu SertifikalarÄ±",slug:"ek-4-sunucu-sertifikalarÄ±"},{level:2,title:"EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±",slug:"ek-5-mesaj-imzalama-akÄ±sÄ±"},{level:3,title:"Ä°mzalama KurallarÄ± (YÃS)",slug:"imzalama-kurallarÄ±-yos"},{level:2,title:"EK-6: HHS/YÃS API Mimarisi",slug:"ek-6-hhs-yos-api-mimarisi"}],content:' EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ± \n AÃ§Ä±k BankacÄ±lÄ±k simÃ¼latÃ¶r uygulamasÄ± Ã¼zerinde swagger dÃ¶kÃ¼manlarÄ±nÄ±n gÃ¼ncel sÃ¼rÃ¼mlerine eriÅim saÄlanabilir. \n EK-2: SÄ±ralÄ± Veri TÃ¼rleri \n \n \n \n Kod \n AÃ§Ä±klama \n \n \n \n \n TR.OHVPS.DataCode.KimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) Y , YKN , N11 P , PNO , AN7..9 \n \n \n TR.OHVPS.DataCode.KurumKimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) V , VKN , N10 \n \n \n TR.OHVPS.DataCode.OhkTur \n Kod: B: Bireysel  K: Kurumsal \n \n \n TR.OHVPS.DataCode.KolasTur \n MÃ¼Återinin sorgulama istediÄi Kolay Adres Tipi deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r: T: Telefon NumarasÄ± E: E-Posta K: TCKN V: VKN Y: YKN P: Pasaport NumarasÄ± \n \n \n TR.OHVPS.DataCode.KareKodAksTur \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulamalÄ± hizmet alÄ±nan iÅyeri Ã¶demesi 02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulamalÄ± iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n TR.OHVPS.DataCode.OdemeKaynak \n I: Ä°nternet bankacÄ±lÄ±ÄÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. A: Otomatik para makineleri (ATM) ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. T: Telefon bankacÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. K: Kiosklar aracÄ±lÄ±ÄÄ±yla gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. S: Åubeden girilen Ã¶demelerde kullanÄ±lÄ±r. M: Mobil uygulamadan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. D: YukarÄ±dakiler dÄ±ÅÄ±ndaki Ã¶deme kaynaklarÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.  O: AÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. \n \n \n TR.OHVPS.DataCode.OdemeAmaci \n Ãdemenin AmacÄ±na yÃ¶nelik olarak aÅaÄÄ±daki deÄerlerden birini alÄ±r: 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aidat Ã¶demesi \n \n \n TR.OHVPS.DataCode.OdemeDurumu \n Ãdemenin durumunu gÃ¶sterir. AlabileceÄi deÄerler: 01: GerÃ§ekleÅti (Ãdeme ilgili Ã¶deme sistemine iletildi ve alÄ±cÄ± hesabÄ±na ulaÅtÄ±.)  02: GÃ¶nderildi (Ãdeme ilgili Ã¶deme sistemine iletildi ancak alÄ±cÄ± hesabÄ±na ulaÅtÄ±ÄÄ±na dair teyit alÄ±nmadÄ±.)Ä°Ålemin son durumunun teyidi iÃ§in YÃS sorgulama yapmalÄ±dÄ±r. 03- GerÃ§ekleÅmedi (Ãdemenin ilgili Ã¶deme sistemine iÅletiminde veya iÅlenmesi sÄ±rasÄ±nda hata, zaman aÅÄ±mÄ±, sistemin gÃ¼n sonu iÅlemlerine baÅlamasÄ± vb. durum oluÅtu ve Ã¶deme gereÃ§eklemedi veya iade edildi.) 04- Onayda bekliyor (Ãdeme emri alÄ±ndÄ±. Ãoklu onay akÄ±ÅÄ±nÄ±n tamamlanmasÄ± bekleniyor.) 05- Ä°Åleme AlÄ±ndÄ± ( Ãdeme emri alÄ±ndÄ±. ) YÃS tarafÄ±ndan mÃ¼Återiye gÃ¶sterilmeyen bir koddur. Bu kod dÃ¶nÃ¼ldÃ¼ÄÃ¼nde YÃS uygulamasÄ±nda ÃHKâya Ã¶deme durumu 02-GÃ¶nderildi  olarak gÃ¶sterilir. Ä°Ålemin son durumunun teyidi iÃ§in YÃS sorgulama yapmalÄ±dÄ±r. \n \n \n TR.OHVPS.DataCode.IslemAmaci \n Ãdemenin AmacÄ±na yÃ¶nelik olarak aÅaÄÄ±daki deÄerlerden birini alÄ±r: 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aid

16at Ã¶demesi 12: DiÄer \n \n \n TR.OHVPS.DataCode.RizaDurumu \n B: Yetki Bekleniyor Y: Yetkilendirildi K: Yetki KullanÄ±ldÄ± E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ S: Yetki SonlandÄ±rÄ±ldÄ± I :Yetki Iptal \n \n \n TR.OHVPS.DataCode.GkdTur \n GKD yapÄ±lmasÄ±nÄ± gerekli bulduÄu durumda HHS, YÃSâÃ¼n belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi GKD yÃ¶ntemini bildirir: Y: YÃ¶nlendirmeli GKD A: AyrÄ±k GKD \n \n \n TR.OHVPS.DataCode.RizaTip \n H: Hesap Bilgisi RÄ±zasÄ± O: Ãdeme Emri RÄ±zasÄ± \n \n \n TR.OHVPS.DataCode.IzinTur \n 01: Temel Hesap Bilgisi 02: AyrÄ±ntÄ±lÄ± Hesap Bilgisi 03: Bakiye Bilgisi 04: Temel Ä°Ålem (Hesap Hareketleri) Bilgisi 05: AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n \n \n TR.OHVPS.DataCode.OdemeSistemi \n Ä°Ålemin yÃ¶nlendirildiÄi Ãdeme Sistemine gÃ¶re aÅaÄÄ±daki deÄerlerden birini alabilir: H: Havale F: FAST E: EFT (PÃS) deÄerlerinden birini alabilir. \n \n \n TR.OHVPS.DataCode.IslemTuru \n Hesap hareketleri (iÅlemler) sorgusunda dÃ¶nÃ¼len Ä°Ålem TÃ¼rÃ¼ (islTur) parametresi aÅaÄÄ±daki deÄerlerden birini alabilir: HAVALE EFT FAST PARA_YATIRMA PARA_CEKME YABANCI_PARA_HAVALE YATIRIM_HESABINA_AKTARIM YATIRIM_HESABINDAN_AKTARIM KURUM_FATURA_ODEMESI CEK SENET SIGORTA_ODEMESI UCRET_KOMISYON_FAIZ SGK_ODEMESI VERGI_ODEMESI DOVIZ_ALIM DOVIZ_SATIM KREDI_ODEMESI KREDI_KULLANIM KK_ODEMESI KK_NAKIT_AVANS SANS_OYUNU UYE_ISYERI_ISLEMLERI HGS_OGS_ISLEMLERI DOGRUDAN_BORCLANDIRMA_SISTEMI DIGER \n \n \n TR.OHVPS.DataCode.HspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.KolasHspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.HspTip \n Hesap Ã§eÅidini belirtir: VADESIZ VADELI KREDILI MEVDUAT HESABI POS CEK YATIRIM \n \n \n TR.OHVPS.DataCode.HspDrm \n HesabÄ±n durumunu belirtir: AKTIF PASIF KAPALI \n \n \n TR.OHVPS.DataCode.YetTip \n AlabileceÄi deÄerlere gÃ¶re hangi belirtecin dÃ¶neceÄine karar verilir. yet_kod yenileme_belirteci \n \n \n TR.OHVPS.DataCode.BrcAlc \n Ä°Ålemin hesabÄ± borÃ§landÄ±rdÄ±ÄÄ± ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. B : BorÃ§ A : Alacak \n \n \n TR.OHVPS.DataCode.RizaIptDtyKod \n â01â :Yeni RÄ±za Talebi ile Ä°ptal â02â :KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal â03â :KullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal â04â :SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor â05â :SÃ¼re AÅÄ±mÄ± : Yetkilendirildi â06â :SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi â07â :GKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± â08â :GKD iptali : RÄ±zano ile TCKN uyuÅmamasÄ± â09â :GKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor â10â :GKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± â11â :GKD iptali : Hesap Yetki Sorunu â12â :GKD iptali : ÃHK HHS mÃ¼Återisi deÄil â13â :GKD iptali : ÃHK HHS kontrollerini aÅamadÄ± â14â :GKD iptali : BaÅarÄ±sÄ±z GKD â15â :GKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi â16â :GKD iptali : DiÄer \n \n \n TR.OHVPS.DataCode.PSUInitiated \n âEâ : Evet âHâ : HayÄ±r \n \n \n TR.OHVPS.DataCode.HHSYOSSrlmKrtr \n âkodâ : Kod,âunvâ : Unvan \n \n \n TR.OHVPS.DataCode. SrlmYon \n âAâ: Azalan deÄerle sÄ±ralama âYâ: Artan deÄerle sÄ±ralama \n EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi \n YÃS rolÃ¼ ile gelen katÄ±lÄ±mcÄ±lar BKM API GeÃ§idi eriÅimlerini kendileri ile BKM tarafÄ±ndan Ã¶nden paylaÅÄ±lacak olan istemci sertifikalarÄ±nÄ± kullanarak saÄlayacaklardÄ±r. \n Bu sertifikalar BKM bÃ¼nyesinde oluÅturulacak ve eriÅimde bulunacak olan kuruma Ã¶zel olarak hazÄ±rlanacaktÄ±r. HazÄ±rlanan istemci sertifikalarÄ± gÃ¼venli FTP veya e-posta aracÄ±lÄ±ÄÄ± ile Ã¶nden ilgili kiÅiler ile paylaÅÄ±lacaktÄ±r. \n Sertifika doÄrulama iÅlemi API GeÃ§idi Ã¼zerinde yapÄ±lacak olup, istemci tarafÄ±nda web isteÄinin ilgili sertifika ile iliÅkilendirilerek oluÅturulmasÄ± gerekecektir. \n Uzun dÃ¶nemli olarak hazÄ±rlanacak olan sertifikalar test, sertifikasyon ve Ã¼retim ortamlarÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi bu aÅamalarda  sÄ±nanacaktÄ±r. \n BKM API GeÃ§idi Ã§Ã¶zÃ¼mÃ¼nÃ¼n test ve Ã¼retim ortamlarÄ± ayrÄ±mÄ±nda istemci sertifikalarÄ±, HHS Listeleme API eriÅimleri ve  Sertifikasyon baÄlantÄ±larÄ± Åekil 15-HHS/YÃS API Mimarisi DiagramÄ±nda resmedilmiÅtir. \n OpenSSL ile CSR (Certificate Signing Request) OluÅturma \nAÅaÄÄ±daki komut ile 2048-bit RSA private key ve CSR oluÅturulur. \nopenssl req -new -newkey rsa:2048 -nodes -keyout PRIVATEKEY.key -out CSR.csr \n CSR ile ilgili detay bilgilerin giriÅinde; \nOrganization Unit Name (OU) olarak BKM tarafÄ±ndan size iletilen clientId deÄeri, \nCommon Name (CN) olarak 4 karakterli yosKod deÄeri, \nDiÄer alanlar iÃ§in de kurum bilgilerinize gÃ¶re giriÅ yapÄ±lÄ±r. \n TÃ¼m bilgilerin girilmesinden sonra CSR dosyasÄ± imzalanmak Ã¼zere BKM ye iletilir. \n EK-4: Sunucu SertifikalarÄ± \n Sunucu sertifikalarÄ±nÄ±n endpoint bilgisini (Fqdn) iÃ§erecek ve global bir Certification Authority tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir.\nÃrneÄin; entegrasyon formu iÃ§erinde yer alan URL bilgisinin (test.xbank.com.tr) sertifika iÃ§erisinde tanÄ±mlÄ± olmasÄ± ve bu sertifikanÄ±n global bir CA Ã¶rneÄin Verisign tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir. \n EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ± \n Dijital imzalama yapÄ±sÄ±,

16ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini saÄlamak amacÄ±yla kurgulanmÄ±ÅtÄ±r.\nBu kapsamda imzalama akÄ±ÅÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r: \n \n HHS ya da YÃS Ã¶ncelikle Ã¶zel ve aÃ§Ä±k anahtarlarÄ±nÄ± oluÅturmalÄ±dÄ±r. Bu anahtarlarÄ± oluÅturmak iÃ§in aÅaÄÄ±da âopensslâ kullanÄ±larak oluÅturma Ã¶rneÄi paylaÅÄ±lmÄ±ÅtÄ±r.  Bu anahtarlardan Ã¶zel olan anahtar mesajÄ± imzalamak iÃ§in kullanÄ±lacak olup, aÃ§Ä±k anahtar ise mesajÄ± doÄrulamak amacÄ±yla mesajÄ±n alÄ±cÄ±sÄ± tarafÄ±ndan kullanÄ±lacaktÄ±r. \n \n private_key.pem ve public_key.pem dosyasinin iÃ§erikleri kod tarafÄ±nda kullanÄ±lacaktÄ±r. \n --private.pem => Ãzel anahtarÄ±n ismi\nopenssl genrsa -out private.pem 2048 \n --public_key.pem => AÃ§Ä±k anahtarÄ±n ismi\nopenssl rsa -in private.pem -pubout -outform PEM -out public_key.pem \n --private_key.pem => Ãzel anahtarÄ±n PCKS8 formatÄ±na Ã§evrilmesi (Java aÃ§Ä±sÄ±ndan PCKS8 formatÄ±nda olma ihtiyacÄ± nedeniyle) openssl pkcs8 -topk8 -inform PEM -in private.pem -out private_key.pem -nocrypt \n \n \n AÃ§Ä±k ve Ãzel anahtarlar oluÅturulduktan sonra AÃ§Ä±k Anahtar BKM ile paylaÅÄ±lÄ±r. BKM bu aÃ§Ä±k anahtarÄ± diÄer katÄ±lÄ±mcÄ±larÄ±n ulaÅabilmesi ve alabilmesi iÃ§in bir Anahtar Deposu yaklaÅÄ±mÄ± ile bÃ¼nyesinde tutar. Ä°lgili anahtarÄ± iletebilmek ve alabilmek iÃ§in kullanÄ±lacak HHS/YOS API ye eriÅim detaylarÄ± EK-6 bÃ¶lÃ¼mÃ¼nde detaylÄ± olarak paylaÅÄ±lmÄ±ÅtÄ±r.  EÄer kurumun ilgili anahtar Ã§iftinin yenilenme durumu sÃ¶z konusu ise yenilemenin hemen ardÄ±ndan aÃ§Ä±k anahtar yeni bir imzalama yapÄ±lmadan Ã¶nce mutlaka BKM ile paylaÅÄ±lmalÄ±dÄ±r. \n \n \n Ä°mzalÄ± mesajÄ± aÃ§acak olan kurum mesajÄ± imzalayan kurumun aÃ§Ä±k anahtarÄ±nÄ± her sorguda yeniden almak durumunda deÄildir. Belirli periyodlarda kendi ortamÄ±ndaki anahtarÄ± yenileyerek sistemi iÅletebilir. Ancak imzalayan kurum anahtar Ã§ifti yenilemesi yaptÄ±ÄÄ±nda BKM ile aÃ§Ä±k anahtarÄ±nÄ± paylaÅsa dahi imzalÄ± mesajÄ± doÄrulayacak taraf eski aÃ§Ä±k anahtar ile doÄrulama yapmaya Ã§alÄ±ÅtÄ±ÄÄ± iÃ§in hata alacaktÄ±r. Bu ilk hata durumunda hÄ±zlÄ±ca BKM Ã¼zerinden yeni anahtarÄ± alÄ±p mesajÄ± tekrar doÄrulamayÄ± denemelidir. EÄer yine hata alÄ±yor ise doÄrulama iÅlemini hata statÃ¼sÃ¼ne almalÄ±dÄ±r. Bu sebeple anahtar yenileyen kurum yeni aÃ§Ä±k anahtarÄ±nÄ± yeni bir mesaj imzalama yapmadan Ã¶nce mutlaka BKM ile paylaÅmalÄ±dÄ±r. \n Ä°mzalama KurallarÄ± (YÃS) \n Bir YÃS Ã¼zerinden baÅlayan akÄ±Å Ã¶rnek olarak paylaÅÄ±lmÄ±ÅtÄ±r. \n \n \n YÃS, mesaj imzalama gerektiren her API isteÄinin HTTP gÃ¶vdesini (request body) kendi Ã¶zel anahtarÄ± ile Åifreleyerek imza bilgisini oluÅturur. \n \n \n ArdÄ±ndan bu imza verisini, gÃ¶ndereceÄi mesajÄ±n istek baÅlÄ±ÄÄ±nda yer alan X-JWS-Signature alanÄ±nda gÃ¶ndermelidir. \n \n \n X-JWS-Signature alanÄ±nda gÃ¶nderilecek olan bilgi aÅaÄÄ±daki yÃ¶ntem ile oluÅturulmalÄ±dÄ±r. \n \n \n Bu alana yazÄ±lacak olan bilgi JWT formatÄ±nda oluÅturulmalÄ±dÄ±r. \n \n \n Bir JWT, header-payload-signature alanlarÄ±ndan oluÅmaktadÄ±r. \n \n Header alanÄ±nda JWTâyi imzalamak iÃ§in kullanÄ±lacak algoritma belirtilmelidir.  Standartlar kapsamÄ±nda RS256 kullanÄ±lacaktÄ±r. \n Payload kÄ±smÄ±nda Ã¶zel olarak oluÅturulacak olan âbodyâ claim alanÄ±na istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ± yazÄ±lmalÄ±dÄ±r. \n JSON payload oluÅturulurken RFC 7519 baz alÄ±nmalÄ±dÄ±r. "iss" (Issuer) Claim, "exp" (Expiration Time) Claim, "iat" (Issued At) Claim, âbodyâ Claim alanlarÄ±nÄ±n gÃ¶nderilmesi zorunludur. ^RFC7519 \na.\t"iss" (Issuer) Claim : Kurumunuza Ã¶zel bilgidir. \nb.\t"exp" (Expiration Time) Claim: Saniye cinsinden (Unix time) imzanÄ±n son geÃ§erli olduÄu tarih. \nc.\t"iat" (Issued At) Claim : Saniye cinsinden (Unix time) imzanÄ±n oluÅturulduÄu tarih \nd.\tâbodyâ Claim : istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ±. \n Signature alanÄ±nda da Ã¶zel anahtar ile imzalanmÄ±Å olan imza iÃ§eriÄi yer alacaktÄ±r. \n \n X-JWS-Signature:   JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir. \n Ãrnek X-JWS-Signature Payload DeÄeri \n { \n"iss": "https://apigw.bkm.com.tr", \n"exp": 1646832405, \n"iat": 1646746005, \n"body": "c543072f97a761a1d891dc81acc380bc1e6f61ca6541bd93ebfdece338457922" \n} \n \n \n \n \n YÃS, isteÄi gÃ¶nderir. Sadece mesajÄ±n bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ ve doÄruluÄunu teyit amacÄ± ile istek gÃ¶vdesi (request body) SHA256 hash deÄeri imzalanarak X-JWS-Signature alanÄ±nda bu imza iletilir. Ä°steÄin gÃ¶vde (request body) kÄ±smÄ± aÃ§Ä±k ve Åifresiz olarak gÃ¶nderilmektedir. \n \n \n HHS, isteÄi alÄ±r, talebi gerÃ§ekleÅtirmeden Ã¶nce aldÄ±ÄÄ± API isteklerinin imzasÄ±nÄ± doÄrulamalÄ±dÄ±r. X-JWS-Signature alanÄ±ndaki JWT aÅaÄÄ±daki adÄ±mlarla doÄrulanmalÄ±dÄ±r. \n \n Header kÄ±smÄ±ndaki algoritmanin RS256 olduÄu kontrol edilir. \n GÃ¶nderen kurumun aÃ§Ä±k anahtarÄ± ile JWT verify (doÄrulama) iÅlemi yapÄ±lÄ±r. \n YukarÄ±daki iÅlemlerin doÄruluÄunun ardÄ±ndan JWTânin payload kÄ±smÄ±ndaki âbodyâ claim alanÄ±ndaki bilginin, isteÄin gÃ¶vde verisinin SHA256 hash deÄerlerinin aynÄ± olduÄu kontrol edilir. \n \n \n \n YukarÄ±daki iÅlemler ile doÄruluÄu teyit edilmiÅ olan isteÄin talebi gerÃ§ekleÅtirir. \n \n \n EÄer istek doÄrulanamÄ±yor ise gÃ¶nderen kurumun aÃ§Ä±k ve Ã¶zel anahtar Ã§ifti yenilenmiÅ olabilir. \n \n \n BKM HHS API  Ã¼zerinden ilgili kurumun bilgilerini (kurum ko

16du vs) kullanarak kurumun detay bilgileri Ã§eker ve kendi ortamÄ±nda yeniler. \n \n \n ArdÄ±ndan imzayÄ± tekrar aÃ§Ä±k anahtar ile doÄrulayarak kontroller gerÃ§ekleÅtirilir. (EÄer halen doÄrulama iÅlemi baÅarÄ±sÄ±z ise bu istek iÃ§in hata akÄ±ÅÄ± Ã§alÄ±ÅtÄ±rÄ±lÄ±r.  TR.OHVPS.Resource.InvalidSignature  kodu ile hata Ã¼retilebilir.) \n \n \n Ä°mza bilgisinin beklendiÄi (x-jws-signature) servislerde, bu bilginin iletilmediÄi durumlarda  TR.OHVPS.Resource.MissingSignature  hatasÄ± Ã¼retilebilir. \n \n \n HHS isteÄi iÅledikten sonra cevabÄ± oluÅtururken de yukarÄ±daki akÄ±Ålar ile gÃ¶ndereceÄi cevabÄ± imzalamalÄ±dÄ±r. \n EK-6: HHS/YÃS API Mimarisi \n HHS/YÃS API Uygulama Mimarisinde Test ve Ãretim ortamlarÄ±nda aÅaÄÄ±daki alanda yer almaktadÄ±r. \n \n Åekil 15: HHS/YÃS API Mimarisi \n'},{title:"POST /erisim-belirteci",frontmatter:{},regularPath:"/v1.0.1/contents/erisim-belirteci.html",relativePath:"v1.0.1/contents/erisim-belirteci.md",key:"v-23bd824f",path:"/v1.0.1/contents/erisim-belirteci.html",content:' POST /erisim-belirteci \n Ä°STEK: \n YÃS erisim-belirteci eriÅim adresini 2 amaÃ§la kullanÄ±r: \n \n \n Bir Ã¶nceki adÄ±mdan aldÄ±ÄÄ± rizaNo, rizaTip (Ã¶deme emri baÅlatma hizmetinde âOâ, hesap bilgisi hizmetinde âHâ) ve GKD sonrasÄ± dÃ¶nÃ¼len yetKod bilgilerini kullanarak HHS nezdinde ErisimBelirteci nesnesi oluÅturmak Ã¼zere istekte bulunur. YÃSâÃ¼n istekte bulunabilmesi iÃ§in GKD adÄ±mÄ±nÄ±n baÅarÄ±lÄ± bir Åekilde tamamlanmasÄ± rizaDrm bilgisinin âyetkilendirildiâ olmasÄ± gerekir. EriÅim Belirteci nesnesi ile rÄ±zasÄ± nesnesi (Ãdeme Emri RÄ±zasÄ± veya Hesap Bilgisi RÄ±zasÄ±) arasÄ±ndaki iliÅki rÄ±za numarasÄ± Ã¼zerinden saÄlanÄ±r. \n \n \n AldÄ±ÄÄ± eriÅim belirtecinin GeÃ§erlilik SÃ¼resinin dolduÄu durumda, yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci almasÄ± gerekmektedir. \n \n \n POST /erisim-belirteci isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âErisimBelirteciIstegiâ nesnesi (Tablo-23) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âErisimBelirteciâ nesnesi (Tablo 24) oluÅturulur veya (Yenileme Belirteci iÃ§in) gÃ¼ncellenir. RÄ±za durumu âYetki KullanÄ±ldÄ±â olarak gÃ¼ncellenir. \n Tablo 23: âErisimBelirteciIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±zaNo \n rizaNo \n AN1..128 \n Z \n RÄ±za nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n RÄ±za Tipi \n rizaTip \n AN1 \n Z \n O veya H (TR.OHVPS.DataCode.RizaTip) \n \n \n Yetki Tipi \n yetTip \n AN1..50 \n Z \n âyet_kodâ yada âyenileme_belirteciâ deÄerini alabilir.  (TR.OHVPS.DataCode.YetTip) \n \n \n Yetki Kodu \n yetKod \n AN1..255 \n K \n GKD iÅleminden dÃ¶nen yetkilendirme kodudur. Tek kullanÄ±mlÄ±k olup, aynÄ± yetKod ile birden fazla token alÄ±namaz. yetKod Parametresinin yaÅam Ã¶mrÃ¼ 5 dakika olmalÄ±dÄ±r. yetTip = âyet_kodâ ise zorunludur. \n \n \n Yenilenme Belirteci \n yenilemeBelirteci \n AN1..4096 \n K \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r. yetTip = âyenileme_belirteciâ ise kullanÄ±mÄ± zorunludur. \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âerisimBelirteciâ nesnesinde (Tablo-19) bulunan eriÅim belirteci deÄeri Ã¶deme emrinin baÅlatÄ±lmasÄ± esnasÄ±nda kullanÄ±lÄ±r. \n Tablo 24: "ErisimBelirteci" nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n EriÅim Belirteci \n erisimBelirteci \n AN1..4096 \n Z \n Yetkilendirme Kodu karÅÄ±lÄ±ÄÄ±nda HHS tarafÄ±ndan dÃ¶nÃ¼len ve sonraki hesap bilgisi ve Ã¶deme emri servislerine eriÅimde kullanÄ±lan bilgidir. \n \n \n GeÃ§erlilik SÃ¼resi \n gecerlilikSuresi \n N1..9 \n Z \n EriÅim Belirtecini saniye cinsinden geÃ§erlilik sÃ¼residir.  EriÅim belirteci geÃ§erli olduÄu son tarih ; Hesap Bilgisi RÄ±zasÄ± iÃ§in 30 gÃ¼n olmalÄ±dÄ±r. EriÅimin GeÃ§erli OlduÄu Son Tarih 30âdan kÃ¼Ã§Ã¼k ise bu sÃ¼re deÄeri ile sÄ±nÄ±rlÄ±dÄ±r. Ãdeme BaÅlatma RÄ±zasÄ± iÃ§in 5 dakika olmalÄ±dÄ±r. \n \n \n Yenileme Belirteci \n yenilemeBelirteci \n AN1..4096 \n Z \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r. \n \n \n Yenileme Belirteci GeÃ§erlik SÃ¼resi \n yenilemeBelirteciGecerlilikSuresi \n N1..9 \n Z \n Yenileme belirtecinin saniye cinsinden geÃ§erlilik sÃ¼residir. Yenileme belirtecinin geÃ§erli olduÄu son tarih ; Hesap Bilgisi iÃ§in EriÅimin GeÃ§erli OlduÄu Son Tarih ile sÄ±nÄ±rlÄ± olmalÄ±dÄ±r. Bu tarih geldiÄi zaman Hesap Bilgisi RÄ±za Durumunu âYetki SonlandÄ±rÄ±ldÄ±â statÃ¼sÃ¼ne Ã§ekilmesi gerekir. Ãdeme BaÅlatma iÃ§in RÄ±za OluÅturma ZamanÄ±ndan 15 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. 15 gÃ¼n sÃ¼resi sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. Ä°leri vadeli iÅlemler bu kapsamda deÄildir.  Ãdeme emri 5 dakika iÃ§inde gerÃ§ekleÅtirilmelidir. GerÃ§ekleÅmediÄinde 4.2.8 bÃ¶lÃ¼mÃ¼nde aktarÄ±lan rÄ±za statÃ¼ gÃ¼ncellemesi yapÄ±lmalÄ±dÄ±r. \n \n \n \n erisim-belirteci erisim noktasÄ±ndan alÄ±nan elde edilen erisimBelirteci iliÅkilendiriliÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda x-access-token alanÄ±nda iletilir.\nYenilenme Belirteci (refreshToken) kullanÄ±larak EriÅim Belirteci (accessToken) alÄ±ndÄ±ÄÄ±nda, dÃ¶ne

16n yanÄ±ttaki Yenileme Belirteci ve Yenileme Belirteci GeÃ§erlik SÃ¼resi deÄiÅmez. \n EriÅim Belirteci API Ã§aÄrÄ±mÄ± sÄ±rasÄ±nda rÄ±za durumlarÄ± kontrol edilmelidir. Bu kontrollerin nasÄ±l yapÄ±lmasÄ± gerektiÄi 4-RÄ±za DurumlarÄ± bÃ¶lÃ¼mÃ¼nde aktarÄ±lmÄ±ÅtÄ±r. \n'},{title:"7.\tHesap Bilgisi Hizmeti",frontmatter:{},regularPath:"/v1.0.1/contents/hesap-bilgisi-hizmeti.html",relativePath:"v1.0.1/contents/hesap-bilgisi-hizmeti.md",key:"v-5b1695dd",path:"/v1.0.1/contents/hesap-bilgisi-hizmeti.html",headers:[{level:2,title:"Genel Bilgiler",slug:"genel-bilgiler"},{level:2,title:"Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri",slug:"hesap-bilgisi-hizmeti-icin-erisim-adresleri"},{level:2,title:"ADIM 0: ÃHK'nÄ±n hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:",slug:"adim-0-ohk-nÄ±n-hesap-bilgilerine-erisim-icin-talepte-bulunmasÄ±"},{level:2,title:"7.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_7-1-adim-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:3,title:"POST /hesap-bilgisi-rizasi",slug:"post-hesap-bilgisi-rizasi"},{level:3,title:"BaÅarÄ±lÄ± Ä°stek:",slug:"basarÄ±lÄ±-istek"},{level:3,title:"BaÅarÄ±lÄ± YanÄ±t:",slug:"basarÄ±lÄ±-yanÄ±t"},{level:2,title:"Ä°zinler",slug:"izinler"},{level:2,title:"7.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi",slug:"_7-2-adim-2-hesap-bilgisi-hizmeti-rÄ±zasÄ±nÄ±n-tesisi"},{level:2,title:"7.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ± (Ä°steÄe BaÄlÄ±)",slug:"_7-3-adim-2-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"7.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali",slug:"_7-4-adim-2-2-hesap-bilgisi-rÄ±zasÄ±nÄ±n-iptali"},{level:2,title:"7.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ±",slug:"_7-5-adim-3-hesap-bilgilerinin-alÄ±nmasÄ±"},{level:2,title:"7.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ±",slug:"_7-6-adim-3-1-ve-3-2-hesap-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"7.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ±",slug:"_7-7-adim-3-3-ve-3-4-hesap-bakiyesinin-sorgulanmasÄ±"},{level:2,title:"7.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ±",slug:"_7-8-adim-3-5-ve-3-6-islemlerin-sorgulanmasÄ±"},{level:2,title:"7.9\tHealthcheck API",slug:"_7-9healthcheck-api"},{level:3,title:"BaÅarÄ±lÄ± YanÄ±t:",slug:"basarÄ±lÄ±-yanÄ±t-2"}],content:" 7.\tHesap Bilgisi Hizmeti  \n Genel Bilgiler \n Hesap bilgisi sorgulama iÃ§in HBHS tarafÄ±ndan mÃ¼Återi rÄ±zasÄ± tesisinin HHS tamamlanmÄ±Å olmasÄ± gerekir. MÃ¼Återi rÄ±zasÄ± tesisi tamamlandÄ±ktan sonra, HBHS sorgulamak istediÄi hesaba ait verileri ilgili eriÅim adresi Ã¼zerinden sorgular. \n \n \n Åekil 10: Hesap Bilgisi Hizmeti Ãst DÃ¼zey AkÄ±ÅÄ± \n Åekil-10âda sunulan hesap bilgisi hizmeti 5 temel akÄ±Åtan oluÅur: \n 0.\tMÃ¼Återinin hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:  ÃHK ÃBHS mobil uygulama ya da web sitesinden hesap bilgilerine eriÅim iÅlemini baÅlatÄ±r. \n 1.\tHesap Bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n hazÄ±rlanmasÄ±: \n HBHS, âhesap bilgilerine eriÅimâ iÃ§in mÃ¼Återi rÄ±zasÄ± tesisi amacÄ±yla HHSâdeki hesap bilgisi rÄ±zasÄ± eriÅim adresine bir POST isteÄinde bulunur ve bir hesap bilgisi rÄ±zasÄ± nesnesi oluÅturur. HHS hesap bilgisi rÄ±zasÄ± nesnesi iÃ§in biricik tanÄ±mlayacÄ± dÃ¶ner (RÄ±zaNo). Hesap bilgisi rÄ±zasÄ±, mÃ¼Återinin HBHSânin hesap bilgilerine eriÅim izin verdiÄi alanlarÄ± iÃ§erir: \n \n Ä°zinler - eriÅim iÃ§in izin verilen veri kÃ¼melerinin listesi. \n EriÅimin GeÃ§erli OlduÄu Son Tarih - HBHS'nin mÃ¼Återinin hesap bilgilerine eriÅebileceÄi isteÄe baÄlÄ± seÃ§ilebilen son tarih. \n Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± â MÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden itibaren geriye dÃ¶nÃ¼k olarak HBHSânin hesap bilgilerine eriÅebileceÄi sÃ¼reyi \n Ä°Ålem Sorgulama BitiÅ ZamanÄ± - MÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden itibaren ileriye dÃ¶nÃ¼k olarak HBHSânin hesap bilgilerine eriÅebileceÄi sÃ¼reyi \n \n 2.\tHesap bilgisi hizmeti mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi: \n HHS, Hesap Bilgisi RÄ±zasÄ± servisi ile ÃHK Ã¶zelinde âYetki bekleniyorâ statÃ¼sÃ¼nde bir rÄ±za nesnesi hazÄ±rlar. HHS, GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda hesap bilgisi rÄ±zasÄ± nesnesinin yetkilendirildiÄini belirtmek iÃ§in RÄ±za Durumunu âRÄ±za Yetkilendirildiâ olarak gÃ¼nceller. Nesne yetkilendirildikten s

16onra HHS nesne ile bir eriÅim belirteci (access token) iliÅkilendirir, RÄ±za Durumunu âYetki KullanÄ±ldÄ±â yapar ve bu belirteci HBHSâye geri dÃ¶ner.  BÃ¶ylece mÃ¼Återi rÄ±za tesisi saÄlanmÄ±Å olur. \n Hesap bilgisi iÃ§in mÃ¼Återi rÄ±zasÄ±na iliÅkin temel ilkeler ÅunlardÄ±r: \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de Yetki Bekleniyor, Yetkilendirildi, Yetki KullanÄ±ldÄ± statÃ¼sÃ¼nde 1 rÄ±zasÄ± olabilir. \n MÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± ÃHK ile HBHS arasÄ±nda belirlenir. Bu nedenle mÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± HHS ekranÄ±nda deÄiÅtirilmemelidir. \n ÃHK, hesap eriÅim izni ayrÄ±ntÄ±larÄ±nÄ± yalnÄ±zca bir bÃ¼tÃ¼n olarak yetkilendirebilir veya geri alabilir. \n MÃ¼Återi rÄ±zasÄ± tesisi esnasÄ±nda, mÃ¼Återi HHS arayÃ¼zÃ¼nde eriÅim iÃ§in yetkilendirecek hesaplarÄ± seÃ§er. \n \n 2.1\tHesap bilgisi rÄ±zasÄ±nÄ±n sorgulanmasÄ±:  MÃ¼Återi rÄ±zasÄ±  GET/hesap-bilgisi-rizasi/{RizaNo}  Ã§aÄrÄ±sÄ± yapÄ±larak sorgulanÄ±r. \n 2.2\tHesap bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n iptali:  MÃ¼Återi rÄ±zasÄ±  DELETE/hesap-bilgisi-rizasi/{RizaNo}  Ã§aÄrÄ±sÄ± yapÄ±larak iptal edilir. \n 3.\tHesap bilgilerinin alÄ±nmasÄ±:  Hesap bilgileri ilgili kaynaÄa (hesaplar, bakiye, iÅlemler) GET isteÄi yapÄ±larak gerÃ§ekleÅtirilir. HBHS, mÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden sonrasÄ±nda (geÃ§erli bir eriÅim belirticine sahip olduÄunda) Ã¶ncelikle  GET/hesaplar  Ã§aÄrÄ±sÄ± yapacaktÄ±r. \n Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n hesap-bilgisi-rizasi \n POST \n /hesap-bilgisi-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n HesapBilgisiRizasiIstegi \n HesapBilgisiRizasi \n \n \n 2 \n erisim-belirteci  (GKD iÃ§in) \n POST \n POST/erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n \n HesapBilgisiRizasi \n \n \n 2.2 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n \n \n \n \n \n \n 3.1 \n hesaplar \n GET \n /hesaplar \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n HesapBilgileri(birden Ã§ok hesap) \n \n \n 3.2 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n HesapBilgileri(tek  hesap) \n \n \n 3.3 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n BakiyeBilgileri(tek  hesap) \n \n \n 3.4 \n bakiye \n GET \n /bakiye \n Ä° \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n BakiyeBilgileri(birden Ã§ok hesap) \n \n \n 3.5 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n IslemBilgileri (tek hesap) \n \n \n \n Tablo 11: Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n ADIM 0: ÃHK'nÄ±n hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±: \n ÃHK, HBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) hesap bilgilerine eriÅim iÃ§in talepte bulunur. \n 7.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n Bu API Ã§aÄrÄ±sÄ± HBHS'nin HHS'de yeni bir âHesapBilgisiRizasiâ nesnesi oluÅturmasÄ±nÄ± ve nesneye eriÅmek iÃ§in benzersiz bir rÄ±za numarasÄ± ({RizaNo}) dÃ¶nÃ¼lmesini saÄlar. \n API Ã§aÄrÄ±sÄ±nÄ±n baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± yeterlidir.\nBaÅarÄ±yla oluÅturulan hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n rÄ±za durumu âYetki Bekleniyorâ olarak dÃ¼zenlenir.\nÃHK daha Ã¶nce aldÄ±ÄÄ± rÄ±zaya iliÅkin eriÅim tarihleri, izin tÃ¼rlerini ve hesap bilgilerini gÃ¼ncellemek isterse, HBHS Ã¶nce HHS nezdindeki rÄ±zayÄ± iptal etmeli ve sonrasÄ±nda yeni bir rÄ±za talebinde bulunmalÄ±dÄ±r.\n \n \n Åekil 11: Hesap Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n POST /hesap-bilgisi-rizasi isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âHesapBilgisiRizasÄ±Istegiâ nesnesi (Tablo-12) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âHesapBilgisiRizasiâ (Tablo-13) nesnesi oluÅturulur. \n  POST /hesap-bilgisi-rizasi \n BaÅarÄ±lÄ± Ä°stek: \n Ä°STEK: \n HBHS, bu API eriÅim adresinden HHSâye yeni bir HesapBilgisiRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n HBHS, ÃHKânÄ±n hesap bilgilerine yÃ¶nelik rÄ±za baÅlatma isteÄi olduÄunu HHSâye bildirir. \n HBHS, ÃHKânÄ±n, HBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n API dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk ve uzunluk kontrollerini y

16apar. (Zorunlu) \n HHS; YÃS API ile alÄ±nan HBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme ve bildirim adresleri ile Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) \n HHS; kimlik bilgileri nesnesinde iletilen kimlik bilgileri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (Zorunlu) \n EriÅimin GeÃ§erli OlduÄu Son Tarih, Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, Ä°Ålem Sorgulama BitiÅ ZamanÄ± alanlarÄ± ile ilgili Tablo 12âde belirtilen kontroller yapÄ±lmalÄ±dÄ±r. (Zorunlu) \n HHS, benzersiz âRizaNoâ ile âHesapBilgisiRizasiâ nesnesi oluÅturur ve HBHSâye dÃ¶ner. \n HHS, HesapBilgisiRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n \n EriÅimin GeÃ§erli OlduÄu Son Tarih, Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, Ä°Ålem Sorgulama BitiÅ ZamanÄ± alanlarÄ±nda zaman aralÄ±klarÄ± mÃ¼Återi deneyimi penceresinden deÄerlendirilerek ay cinsinden belirtilmiÅtir. Bu konuda aÅaÄÄ±daki gibi oluÅabilecek uÃ§ Ã¶rneklere dikkat edilmesi gerekmektedir. \n BugÃ¼n : 31.08.2019 \nBugÃ¼n + 6 Ay : 29.02.2020 \nBugÃ¼n : 30.08.2020 \nBugÃ¼n + 6 Ay : 28.02.2021 \n Tablo 12: âHesapBilgisiRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. Hata durumunda TR.OHVPS.Connection.InvalidASPSP hata kodunu dÃ¶ner. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda TR.OHVPS.Connection.InvalidTPP hata kodunu dÃ¶ner. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Yetkilendirme yÃ¶ntemi, HBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur.  YÃS YÃ¶nlendirmeli GKD yÃ¶ntemi ile akÄ±ÅÄ± destekliyorsa, yetYntm deÄiÅkeninden baÄÄ±msÄ±z olarak yÃ¶nlendirme adresini iletmelidir. Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur.  YÃS AyrÄ±k GKD yÃ¶ntemi ile akÄ±ÅÄ± destekliyorsa, yetYntm deÄiÅkeninden baÄÄ±msÄ±z olarak bildirim adresini iletmelidir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, ayrÄ±k GKD sonrasÄ± bu alanda belirtilen adrese otorizasyon kodunu (authentication code) iletir. \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r.   TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n \n Hesap Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n \n >Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih.   MÃ¼Återi YÃS ekranÄ±ndan bu deÄeri belirleyebilir.   VarsayÄ±lan deÄer : RÄ±za verilen tarih + 6 ay   AlabileceÄi maksimum deÄer : RÄ±za tarihi + 6 ay    AlabileceÄi minimum deÄer : RÄ±za tarihi + 1 gÃ¼n   ÃrneÄin 23/09/202

161âde minimum 24/09/2021 seÃ§ilebilir. Bu durumda izin 24/09/2021 23:59:59âda bitecek Åekilde olmalÄ±dÄ±r. \n Bu alanda bir deÄer bulunmadÄ±ÄÄ± durumda HHS hata dÃ¶nmelidir. \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geÃ§miÅe dÃ¶nÃ¼k en fazla 12 ay olabilir, daha eski olmamasÄ± gerekir.   VarsayÄ±lan deÄeri rÄ±za verilen tarih (iÅlem zamanÄ±) â 12 aydÄ±r.   ÃHK bu alana bir deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.   Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  - 12 ay    Maksimum tarih: RÄ±zanÄ±n veriliÅ tarihi +  12 ay    Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve  Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geleceÄe dÃ¶nÃ¼k en fazla 12 ay sonrasÄ± olabilir, daha ileri bir tarih olmamasÄ± gerekir.   VarsayÄ±lan deÄeri: RÄ±za verilen tarih + 12 aydÄ±r.  ÃHK bu alana bir deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.  Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  â 12 ay  Maksimum tarihi :  RÄ±zanÄ±n veriliÅ tarihi + 12 ay   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. EÄer dolu gÃ¶nderilirse HHS tarafÄ±ndan uygun hata mesajÄ± iletilmelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve Ä°Ålem Sorgulama BitiÅ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez.   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n BaÅarÄ±lÄ± YanÄ±t: \n Tablo 13: HesapBilgisiRizasi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. Ãrn; hesap bilgi rÄ±zasÄ±nÄ±n tesisine dair ilk istek mesajÄ±na dÃ¶nÃ¼Åte âB: Yetki Bekleniyorâ deÄerini almasÄ± beklenir. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n K \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r.  TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n HHS, ayrÄ±k GKD sonrasÄ± bu alanda belirtilen YÃS adresine otorizasyon kodunu (authentication code) iletir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.  HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir. RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Hesap Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n > Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HBHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi baÅlangÄ±Ã§ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi bitiÅ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n > AyrÄ±ntÄ± Bilgi \n ayrBlg \n Kompleks: AyrintiBilgi \n Ä° \n \n \n \n > ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n Ä°zinler \n Bir hesap bilgisi mÃ¼Återi rÄ±zasÄ± kaynaÄÄ± Ã§aÄrÄ±sÄ±na yanÄ±t olarak dÃ¶ndÃ¼rÃ¼len verileri sÄ±nÄ±rlamak iÃ§in izin kodlarÄ± kullanÄ±lÄ±r: \n \n Temel Hesap Bilgisi \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n Bakiye Bilgisi \n Temel Ä°Ålem (Hesap Hareketleri) Bilgisi \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n \n ÃHKâya sunulacak seÃ§imler ve kurallarÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r. \n \n \n \n SeÃ§im \n Kural \n \n \n \n \n Temel Hesap Bilgisi \n ÃHK seÃ§imine sunulmamalÄ±dÄ±r. DeÄiÅtirilemez Åekilde seÃ§ili gÃ¶sterilmelidir. \n \n \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Bakiye Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Temel Ä°Ålem (Hesap Hareketleri)  Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n ÃHK seÃ§im yapabilir. AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi seÃ§imi Temel Ä°Ålem Bilgisi seÃ§imini kapsar. (AyrÄ±ntÄ±lÄ± Ä°Ålem bilgisi seÃ§ildiÄinde Temel Ä°Ålem Bilgisi de seÃ§ili olmalÄ±dÄ±r.) \n \n \n \n AÅaÄÄ±daki durumlarda, izin kombinasyonlarÄ±na izin verilmez. HHS, bu hesap eriÅim onaylarÄ±nÄ± 400 (HatalÄ± Ä°stek) yanÄ±t koduyla reddetmelidir: \n \n Ä°zin dizisinin herhangi bir izin tÃ¼rÃ¼ iÃ§ermemesi durumu, \n Ä°zin dizisinde HHS tarafÄ±ndan desteklenmeyen bir izin kodunun yer almasÄ± durumu \n 7.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi \n \n \n Åekil 12: Hesap Bilgisi ÃHK RÄ±zasÄ±nÄ±n Tesisi \n RÄ±za tesisinin baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± ve ardÄ±ndan mÃ¼Återinin HHS tarafÄ±ndan yÃ¶nlendirmeli veya ayrÄ±k GKD ile doÄrulanmasÄ± gerekir. HHS'de oluÅturulan ve rÄ±za durumu âYetki Bekleniyorâ olan bir hesap bilgisi rÄ±zasÄ±, G

16KD sonrasÄ± âYetkilendirildiâ statÃ¼sÃ¼ne gÃ¼ncellenir. HBHS, eriÅim saÄlayacaÄÄ± hesaplarÄ± hesap bilgisi rÄ±zasÄ±nÄ±n tesisinden Ã¶nce seÃ§er. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda, HBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n \n HBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n \n \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n ÃHKâyÄ± doÄrularsa, \n \n \n ÃHK HBHS Ã¼zerinden iÅlem yapÄ±lmasÄ±na izin vereceÄi hesap seÃ§imini yapar. HBHS Ã¼zerinden ÃHKânÄ±n verdiÄi izin bilgilerini ve eriÅim izninin bitiÅ tarihi bilgilerini, HHS bilgilendirme amaÃ§lÄ± ÃHKâya gÃ¶sterir. \n \n \n HHS hesap bilgisiri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=H&drmKod=zzz\n \n \n \n ÃHKâyÄ± doÄrulayamazsa, \n \n \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I &rizaNo=yy&rizaTip=H&rizaIptDtyKod=11&drmKod=zzz\n \n \n \n \n \n \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda, HHS, ÃHKânÄ±n hesap bilgisi hizmetini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister. \n \n AyrÄ±k akÄ±Å HBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek hesap bilgisi rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, Ã¶deme hizmeti kullanÄ±cÄ±sÄ±nÄ± doÄrular. \n ÃHK verdiÄi izin tipi dahilinde bilgileri paylaÅÄ±lacak olan hesaplarÄ± seÃ§er. \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS,  hesap bilgisi rÄ±zasÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. RÄ±za tesisi saÄlanmÄ±Å olur. \n 7.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ± (Ä°steÄe BaÄlÄ±) \n GET /hesap-bilgisi-rizasi/{RizaNo} \n ÃHK, HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir veya ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.  Bu durumlarda HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir HesapBilgisiRizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 13âde belirtilen âHesapBilgisiRizasiâ nesnesini dÃ¶nmektedir. \n Durum \nHesapBilgisiRizasi kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki S

16onlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n 7.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali \n \n \n \n Åekil 13: Hesap Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n Geri AlÄ±nmasÄ± \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \n DELETE /hesap-bilgisi-rizasi Ã§aÄrÄ±sÄ±, bir HBHS'nin Ã¶nceden oluÅturulmuÅ bir hesap eriÅim rÄ±zasÄ±nÄ± (yetkili olsun veya olmasÄ±n) silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, HBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \nBu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin HBHS Ã¼zerinden hesap bilgisi rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki hesap bilgisi rÄ±zasÄ± nesnesinin silinmesini saÄlar. \nMÃ¼Återinin HBHSânin veri eriÅim iznini iptal etmesi durumunda HBHS, HHSâde mevcut olan HesapBilgisiRizasi kaynaÄÄ±nÄ± pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. HBHS ayrÄ±ca, sisteminden Hesap EriÅim Ä°zni kaynaklarÄ±nÄ± da temizlemelidir. \nSÃ¶z konusu silme iÅlemi, kayÄ±tlarÄ±n statÃ¼sÃ¼nÃ¼n pasife Ã§ekilmesi ile gerÃ§ekleÅtirilmelidir. SÃ¶z konusu kayÄ±tlar, denetim izlerinin oluÅturulmasÄ± ve saklanmasÄ±na iliÅkin ikincil dÃ¼zenleme hÃ¼kÃ¼mleri kapsamÄ±nda gÃ¼venli Åekilde tutulmalÄ±dÄ±r. \nServis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r. \nÃHK rÄ±zasÄ± baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ olarak gÃ¼ncellenir ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir. \nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir: \nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (HBHS) \n 7.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ± \n    \n \n   \n Åekil 14: Hesap Bilgilerinin AlÄ±nmasÄ± \n Ä°STEK: \nMÃ¼Återi rÄ±zasÄ± tesis edilmiÅ kullanÄ±cÄ± iÃ§in HBHS API eriÅim adresinden HHSâye eriÅilebilir hesap bilgilerini GET isteÄi ile sorgular: \n \n RizaDurumu âYetki KullanÄ±ldÄ±â ise iÅleme baÅlanÄ±r. RizaDurumu farklÄ± bir deÄerde ise âTR.OHVPS.Resource.ConsentMismatchâ hatasÄ±nÄ±n iletilmesi gerekir. \n GET verisinin modele gÃ¶re kontrolÃ¼ yapÄ±lÄ±r (ÃrneÄin: Alan kontrolleri) \n \n GET verisinin mantÄ±ksal kontrolleri yapÄ±lÄ±r. \n 7.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ± \n GET /hesaplar ve GET /hesaplar/{hspRef} \n Bu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bilgilerinin sorgulanÄ±r. Hesap bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re (Temel Hesap Bilgisi veya DetaylÄ± Hesap Bilgisi) yanÄ±tÄ±nda dÃ¶nÃ¼len HesapBilgileri nesnesinin iÃ§eriÄi deÄiÅir.  Tablo 15âte HesapBilgileri nesnesinin iÃ§eriÄi verilmiÅtir. \n Hesap Bilgisi Sorgu ÃrneÄi (TÃ¼m Hesaplar) =  /hesaplar \nHesap Bilgisi Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef} \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 14: Hesap Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa NumarasÄ± \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 15: âHesapBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n Hesap Temel \n hspTml \n Kompleks: HesapTemel \n Z \n Temel Hesap Bilgileri (Temel Hesap Bilgisi varsayÄ±lan izin tÃ¼rÃ¼ olduÄundan Hesap Temel nesnesi zorunlu olarak yanÄ±tta bulunur) \n \n \n > Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. \n \n \n > Hesap NumarasÄ± \n hspNo \n AN26 \n K \n EÄer varsa Ã¶deme hesabÄ±na ait IBAN bilgisi \n \n \n > Hesap Sahibi UnvanÄ± \n hspShb \n AN3..140 \n Z \n Hesap sahibi ya da hesap sahiplerinin ad-soyadÄ±, ticari unvanÄ± \n \n \n > Åube AdÄ± \n subeAdi \n AN3..50 \n K \n EÄer varsa Ã¶deme hesabÄ±nÄ±n baÄlÄ± olduÄu Åubenin adÄ± \n \n \n > KÄ±sa Ad \n kisaAd \n AN3..50 \n K \n EÄer hesap sahibi hesaba ait bir ad tanÄ±mladÄ±ysa, tanÄ±mlanan hesap adÄ± \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi. \n \n \n > Hesap TÃ¼rÃ¼ \n hspTur \n AN1 \n Z \n HesabÄ±n tÃ¼rÃ¼ (bireysel veya ticari). TR.OHVPS.DataCode.HspTur sÄ±rali veri deÄerlerinden birini alÄ±r. \n \n \n > Hesap Tipi \n hspTip \n AN1..32 \n Z \n HesabÄ±n tipi (VADESÄ°Z, KREDÄ°LÄ° vb.).TR.OHVPS.DataCode.HspTip sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >

16Hesap ÃrÃ¼n AdÄ± \n hspUrunAdi \n AN1..140 \n Ä° \n HHS tarafÄ±ndan atanmÄ±Å olan Ã¼rÃ¼n adÄ± bilgisidir. HBHS tarafÄ±ndan ÃHKâya gÃ¶sterilmesi kullanÄ±m kolaylÄ±ÄÄ± saÄlayacaktÄ±r. \n \n \n > Hesap Durumu \n hspDrm \n AN5..50 \n Z \n HesabÄ±n durumunu belirtir. TR.OHVPS.DataCode.HspDrm sÄ±ralÄ± veri tÃ¼rlerinden birini alÄ±r. \n \n \n Hesap Detay \n hspDty \n Kompleks: HesapDetay \n K \n Detay Hesap Bilgileri (Temel Hesap Bilgisine ek olarak Detay Hesap Bilgisi izin tÃ¼rÃ¼ de seÃ§ilmiÅse Hesap Detay nesnesi koÅullu olarak yanÄ±tta bulunur) \n \n \n > AÃ§Ä±lÄ±Å Tarihi \n hspAclsTrh \n ISODateTime \n Z \n Belirtilen hesabÄ±n aÃ§Ä±lÄ±Å tarihi. \n 7.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ± \n GET /bakiye ve GET /hesaplar/{hspRef}/bakiye \nBu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bakiyesi sorgulanÄ±r. \nÄ°stek Ã§aÄrÄ±sÄ±na dÃ¶nÃ¼len âBakiyeBilgileriâ nesnesi Tablo 17âde verilmiÅtir. \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /bakiye?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 16: âBakiyeBilgileriâ Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 17: âBakiyeBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. \n \n \n Bakiye \n bky \n Kompleks:Bakiye \n Z \n \n \n \n > Hesap Bakiye TutarÄ± \n bkyTtr \n N1..18 \n Z \n HesabÄ±n bakiyesi.  ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir \n \n \n > Blokeli Tutar \n blkTtr \n N1..18 \n K \n Varsa hesapta blokeli tutar bilgisi.  ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n > Bakiye Ä°letilme ZamanÄ± \n bkyZmn \n ISODateTime \n Z \n Bakiyenin iletildiÄi zaman bilgisi. \n \n \n > KrediliHesap \n krdHsp \n Kompleks: KrediliHesap \n K \n \n \n \n >> Kredili Mevduat HesabÄ± Bakiyesi \n kulKrdTtr \n N1..18 \n Z \n KullanÄ±labilir kredili mevduat tutarÄ±. Kredili bir hesap ise zorunlu. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir \n \n \n >> Kredi Dahil GÃ¶stergesi \n krdDhlGstr \n AN1 \n Z \n Kredili bir hesap ise zorunlu. Bakiye tutarÄ±nÄ±n kullanÄ±labilir kredi tutarÄ± dahil edilerek ya da edilmeden iletildiÄini gÃ¶sterir.  0: Kredi tutarÄ± dahil edilmeden bakiye bilgisi iletilmesi durumu 1: Kredi tutarÄ± dahil edilerek bakiye bilgisi iletilmesi durumu \n 7.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ± \n GET /hesaplar/{hspRef}/islemler \n Belirli bir hesaba iliÅkin iÅlem bilgileri Tablo 1âdaki istek parametrelerine gÃ¶re sorgulanÄ±r. \nÄ°Ålem bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re yanÄ±tta dÃ¶nen IslemBilgileri nesnesinin (Temel Ä°Ålem Bilgisi veya Temel Ä°Ålem Bilgisi ve DetaylÄ± Ä°Ålem Bilgisi) iÃ§eriÄi deÄiÅir. \nÄ°Ålemler servisi hem ÃHKânÄ±n talebi ile YÃS uygulamasÄ± Ã¼zerinden Ã§aÄrÄ±labileceÄi gibi, YÃSâÃ¼n ÃHKâsÄ±z baÅlatabileceÄi otomatik Ã§aÄrÄ±larÄ± ile de yanÄ±t dÃ¶nebilmektedir. \nHHS, iÅlemin sistemsel yapÄ±lÄ±p yapÄ±lmadÄ±ÄÄ±nÄ±, istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir.\nÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \nYÃS, otomatik yapacaÄÄ± sorgularda; \n \n Bireysel ÃHKâlar iÃ§in hesap bazÄ±nda gÃ¼nde en fazla 4 adet sorgulama yapabilir. \n Kurumsal ÃHKâlar iÃ§in hesap bazÄ±nda saatte en fazla 12 adet sorgulama yapabilir. \n \n HHS, tutacaÄÄ± sayaÃ§ bilgisi ile bu sayÄ±larÄ± kontrol ederek daha fazla sorgulama yapÄ±lmasÄ±na izin vermeyebilir. \n AynÄ± istek parametreleri ile yapÄ±lan sorgu sonucunda dÃ¶necek toplam kayÄ±t sayÄ±sÄ± 100âÃ¼ aÅtÄ±ÄÄ±nda, sayfalama yÃ¶ntemi ile HHSânin cevap dÃ¶nmesi beklenmektedir.  Her bir sayfa iÃ§in iÅlemler servisi tekrar Ã§aÄrÄ±lsa da, bu Ã§aÄrÄ±m HHSânin tuttuÄu sayaÃ§ deÄerini arttÄ±rmaz. HHSânin tutacaÄÄ± sayaÃ§Ä±n kontrol parametreleri YÃS kodu, hesap numarasÄ± ya da referansÄ± olmalÄ±dÄ±r. Sayfa no parametresi varsa ve 1'den bÃ¼yÃ¼k ise iÅlem sayacÄ±nÄ± arttÄ±rmamalÄ±dÄ±r. \n ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden tetiklediÄi iÅlemlerde ise;\nbireysel ÃHKâlar  iÃ§in en fazla 1 aylÄ±k,\nkurumsal ÃHKâlar iÃ§in ise en fazla 1 haftalÄ±k bir pencere aralÄ±ÄÄ±nda sorgulama yapÄ±labilir. \n YÃS, otomatik yapacaÄÄ± sorgularda hem bireysel hem de kurumsal ÃHKâlar iÃ§in 24 saatlik bir pencere aralÄ±ÄÄ±nda sorgulama yapabilir. \n Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /hes

16aplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-06-02T23:59:59+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A \n Tablo 18: Ä°Ålem Listesi Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin baÅlangÄ±Ã§ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. ÃHK tarafÄ±ndan tetiklenen sorgularda;hesapIslemBslTrh ve hesapIslemBtsTrh arasÄ± fark bireysel ÃHKâlar iÃ§in en fazla 1 ay,kurumsal ÃHKâlar iÃ§in ise en fazla 1 hafta olabilir. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;son 24 saat sorgulanabilir. Bu yÃ¼zden hesapIslemBtsTrh-24 saatâten daha uzun bir aralÄ±k sorgulanamaz olmalÄ±dÄ±r. Ä°stek baÅlÄ±ÄÄ±nda yer alan PSU-Initiated alanÄ± âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n \n \n Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin bitiÅ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;Ä°leri vadeli iÅlem emirleri dahil olmadÄ±ÄÄ± iÃ§in; Ä°Ålem Sorgulama BitiÅ ZamanÄ±, her zaman, sorgulama zaman damgasÄ±nÄ± iletecek Åekilde (datetime (now)) iletilmelidir. \n \n \n En DÃ¼ÅÃ¼k Ä°Ålem TutarÄ± \n minIslTtr \n N1..18 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en dÃ¼ÅÃ¼k iÅlem tutarÄ±.ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n En YÃ¼ksek Ä°Ålem TutarÄ± \n mksIslTtr \n N1..18 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en yÃ¼ksek iÅlem tutarÄ±.ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n BorÃ§ Alacak GÃ¶stergesi \n brcAlc \n AN1 \n Ä° \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Hesaba borÃ§ yaratan iÅlem.A: Hesaba alacak yaratan iÅlem.{âBâ,âAâ} \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âislGrckZamanâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini islGrckZaman olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 19: âIslemBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap Referans NumarasÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. \n \n \n Islemler \n isller \n Kompleks:Islem[Array] \n K \n Hesaba iliÅkin hareketler varsa Ä°Ålemler nesnesi dizisi olarak dÃ¶nÃ¼lÃ¼r. Ä°Ålemler nesnesi Temel Ä°Ålem Bilgileri ve Detay Ä°Ålem Bilgileri nesnesinden meydana gelir. Ä°zin tÃ¼rÃ¼ varsayÄ±lan olarak Temel Ä°Ålem Bilgilerini iÃ§erir. Detay Ä°Ålem Bilgileri izin tÃ¼rÃ¼ de seÃ§ildi ise Temel Ä°Ålem Bilgilerine ek olarak Detay Ä°Ålem Bilgileri de gÃ¶nderilir. \n \n \n > Temel Ä°Ålem Bilgileri \n islTml \n Kompleks:IslemTemel \n Z \n Temel Ä°Ålem Bilgileri varsayÄ±lan olarak dÃ¶nÃ¼lÃ¼r. \n \n \n >> Ä°Ålem NumarasÄ± \n islNo \n AN3..50 \n Z \n Hesap hareketinin oluÅturulmasÄ± sÄ±rasÄ±nda atanan ve borÃ§ (veya alacak) hareketini tekilleÅtiren HHS bazÄ±nda tekil tanÄ±mlayÄ±cÄ±dÄ±r. Bu deÄer tek baÅÄ±na tekil olabileceÄi gibi b

16irden fazla deÄerin bir araya getirilmesiyle de tekilliÄi saÄlanmÄ±Å olabilir. Bu deÄerin en azÄ±ndan hesap numarasÄ± (hesNo) bazÄ±nda tekil olmasÄ± beklenir. Genellikle kullanÄ±lan Ã¶rnekleri; Instance_Id, Transaction_Id, Transaction_Num, Transaction_TimeStamp,dekont numarasÄ± \n \n \n >> Ä°Ålem Referans NumarasÄ± \n refNo \n AN3..50 \n Z \n Ä°Ålemi uÃ§tan uca tanÄ±mlayan tekil tanÄ±mlayÄ±cÄ±dÄ±r. BorÃ§ ve alacak hareketinden oluÅan bir veya birden fazla iÅlemler bÃ¼tÃ¼nÃ¼ iÃ§in atanmÄ±Å olan ve bu bÃ¼tÃ¼nÃ¼ tekilleÅtiren (bir biri ile iliÅkisini tutan) deÄerdir.Bu deÄer hem YÃSâten gelen deÄer olabilir (Ã¶deme iÅlemlerinde kullanÄ±lan kkodRef ya da refBlg alanÄ±) hem de HHS iÃ§inde takip edilmek iÃ§in Ã¼retilmiÅ bir deÄer olabilir. HHS sisteminde 2 deÄerin de bulunmasÄ± durumunda;refNo alanÄ±nÄ± doldurmak iÃ§in, HHSânin YÃSâten gelen deÄere Ã¶ncelik vermesi beklenmektedir. YÃSâten gelen veri Ã¶rneÄi: SipariÅ NumarasÄ±, Fatura NumarasÄ±, Karekod ReferansÄ± vb. HHSâte Ã¼retilen veri Ã¶rneÄi: MasraflÄ± havale iÅleminde hem havale iÅleminin hem de masraf iÅleminin aynÄ± referans numarasÄ±na sahip olmasÄ± da Ã¶rnek olarak gÃ¶sterilebilir. \n \n \n >> Ä°Ålem TutarÄ± \n islTtr \n N1..18 \n Z \n Ä°Ålem tutarÄ±. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n >> Ä°Ålem GerÃ§ekleÅme ZamanÄ± \n islGrckZaman \n ISODateTime \n Z \n Ä°Ålemin gerÃ§ekleÅme zamanÄ±. \n \n \n >> Ä°Ålem KanalÄ± \n kanal \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeKaynak sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> BorÃ§landÄ±rma AlacaklandÄ±rma GÃ¶stergesi \n brcAlc \n AN1 \n Z \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Ä°Ålemin hesabÄ± borÃ§ ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. \n \n \n >> Ä°Ålem TÃ¼rÃ¼ \n islTur \n AN3..50 \n Z \n HHSânin iÅleme ait iliÅkilendirdiÄi iÅlem tÃ¼rÃ¼ deÄeri. TR.OHVPS.DataCode.IslemTuru sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Ä°Ålem AmacÄ± \n islAmc \n AN2 \n Z \n TR.OHVPS.DataCode.IslemAmaci sÄ±rali veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Ãdeme Sistemi No \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. FAST iÅlemleri iÃ§in MesRefBlg deÄeri atanÄ±r. Ãdeme Hizmeti kullancÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir. \n \n \n > Detay Ä°Ålem Bilgileri \n islDty \n Kompleks: IslemDetay \n K \n Detay Ä°Ålem Bilgileri dizi olarak gÃ¶nderilmelidir. \n \n \n >> Ä°Ålem AÃ§Ä±klamasÄ± \n islAcklm \n AN1..150 \n Z \n HHS tarafÄ±ndan atanan iÅlem aÃ§Ä±klamasÄ±.HHS kendi iÅlem hareketlerine yansÄ±ttÄ±ÄÄ± aÃ§Ä±klamayÄ± buraya yansÄ±tmalÄ±dÄ±r. \n \n \n >> KarÅÄ± Taraf \n krsTrf \n Kompleks:  KarsiTaraf \n K \n KullanÄ±mÄ± iÅlem bazÄ±nda deÄiÅmektedir. Ãrnek: FAST iÅleminde karÅÄ± taraf alÄ±cÄ±nÄ±n bilgileridir. Vergi Ã¶demesinde kurum IBAN bilgisi mÃ¼Återiye gÃ¶sterilemeyebileceÄinden bu alanÄ±n boÅ gelmesi HHS insiyatifindedir. \n \n \n >>> KarÅÄ± Maskeli IBAN \n krsMskIBAN \n AN26 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n maskeli IBAN bilgisi. \n \n \n >>> KarÅÄ± Maskeli Unvan \n krsMskUnvan \n AN3..140 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n maskeli ad-soyad ya da ticari unvan bilgisi. \n 7.9\tHealthcheck API \n GET /health \n HHSâlerin sunacaÄÄ± bu servis, dÃ¼zenli olarak BKM tarafÄ±ndan Ã§aÄÄ±rÄ±larak servislerin ayakta olup olmadÄ±klarÄ±nÄ±n kontrolÃ¼nÃ¼n saÄlanmasÄ± planlanmaktadÄ±r \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lmelidir. \n BaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir \n \n \n \n"},{title:"5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama",frontmatter:{},regularPath:"/v1.0.1/contents/gkd.html",relativePath:"v1.0.1/contents/gkd.md",key:"v-822cf8c6",path:"/v1.0.1/contents/gkd.html",headers:[{level:2,title:"5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-1-yonlendirmeli-guclu-kimlik-dogrulama"},{level:2,title:"5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-2-ayrÄ±k-guclu-kimlik-dogrulama"},{level:2,title:"5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi",slug:"_5-3-yonlendirme-bildirim-adresleri-ve-durum-kodu-parametresi"},{level:2,title:"5.4\tHealthcheck API",slug:"_5-4healthcheck-api"},{level:2,title:"5.5  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri",slug:"_5-5-guclu-kimlik-dogrulama-kontrolleri"}],content:" 5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n MÃ¼Återi iÃ§in gÃ¼Ã§lÃ¼ kimlik doÄrulama, ÃHKânÄ±n (mÃ¼Återinin) kimliÄinin doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin âbildiÄiâ, âsahip olduÄuâ veya âbiyometrik bir karakteristiÄi olanâ bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntemi tanÄ±mlar. \n Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄ uyarÄ±nca hesap bilgisi hizmetinde mÃ¼Återinin onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda ve Ã¶deme emri baÅlatma hizmetinde her bir Ã¶deme emri baÅlatma iÅleminde  HHS tarafÄ±ndan mÃ¼Återiye gÃ¼Ã

16§lÃ¼ kimlik doÄrulama (GKD) uygulanmasÄ± esastÄ±r.  Buna gÃ¶re: \n \n \n Hesap bilgisi hizmetinde ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda  TebliÄin 26 ncÄ± maddesinin 1 inci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya GKD uygulanÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 2 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanÄ±r ve iÅlem doÄrulama kodu ile ÃHKânÄ±n onayÄ± alÄ±nÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 3 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanmasÄ±na iliÅkin istisna veya ilave gÃ¼venlik Ã¶nlemleri iÅbu API Ä°lke ve KurallarÄ± belgesinde tanÄ±mlanÄ±r. \n \n \n HHS, gÃ¼Ã§lÃ¼ kimlik doÄrulama sÃ¼recinde ÃHKânin sahip olduÄu bileÅen sÄ±nÄ±fÄ± olarak SMS OTP ya da SMS ile iÅlem doÄrulama kodu kullanabilir. \n \n \n HHS, aÅaÄÄ±daki hallerde veya  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re tek bileÅen ile kimlik doÄrulama yapabilir. \n \n Ãdemenin gÃ¶ndereni ve alÄ±cÄ±sÄ±nÄ±n aynÄ± olmasÄ±, \n Daha Ã¶nce tanÄ±mlanmÄ±Å gÃ¼venli alÄ±cÄ±lar listesine Ã¶deme yapÄ±lmasÄ±, \n ÃHKânin talimatÄ±na istinaden gerÃ§ekleÅtirilen dÃ¼zenli bir Ã¶deme olmasÄ±. \n \n \n \n Tek bileÅen ile kimlik doÄrulama yapÄ±lan bu iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin mÃ¼Återi tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye ait olur. \n \n \n Ä°Ålem DoÄrulamada  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± ÄÄ bendindeki  iÅlem bilgisi tanÄ±mÄ±na uygun olarak aÅaÄÄ±daki bilgiler ile  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  tanÄ±mlanan iÅleme Ã¶zel Ã¼retilmiÅ iÅlem doÄrulama kodu birlikte kullanÄ±lÄ±r. \n \n AlÄ±cÄ± Unvan (Kolas akÄ±ÅÄ±nda maskeli olarak)  (Ã¶deme emri baÅlatma hizmeti) \n Tutar (Ã¶deme emri baÅlatma hizmeti) \n Referans bilgisi (8 karakterden kÃ¼Ã§Ã¼k ise alanÄ±n tÃ¼m deÄeri, bÃ¼yÃ¼k ise ilk 4 ve son 4 hanesi) \n \n Ä°Åleme ait yukarÄ±daki bilgilerden en az biri deÄiÅtiÄi zaman  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  belirtildiÄi gibi yeni bir iÅlem doÄrulama kodu Ã¼retilecek Åekilde akÄ±Å kurgulanmalÄ±dÄ±r. \n \n \n Ä°Ålem doÄrulama kodunun gÃ¶nderilmesinden HHS sorumludur. HHS,  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re iÅlem doÄrulama kodu kullanmaksÄ±zÄ±n ÃHKânÄ±n onayÄ±nÄ± alabilir. Ä°Ålem doÄrulama kodu kullanÄ±lmayan iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin ÃHK tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye aittir. \n \n \n ÃHVPS API standartÄ± kapsamÄ±nda iki adet GÃ¼Ã§lÃ¼ Kimlik DoÄrulama (GKD) yÃ¶ntemi kullanÄ±lacaktÄ±r: \n \n YÃ¶nlendirmeli (Redirect) GKD YÃ¶ntemi \n AyrÄ±k (Decoupled) GKD YÃ¶ntemi \n \n \n \n HHS asgari olarak tarayÄ±cÄ± tabanlÄ± YÃ¶nlendirmeli GKD yÃ¶ntemini desteklemek zorundadÄ±r. \n \n \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemleri sadece YÃ¶nlendirmeli GKD yÃ¶ntemi ile gerÃ§ekleÅtirilebilir. \n 5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n YÃ¶nlendirmeli GKD YÃ¶nteminde, mÃ¼Återi kimlik doÄrulama iÃ§in YÃS tarafÄ±ndan HHS arayÃ¼zÃ¼ne yÃ¶nlendirilir. \n MÃ¼Återi HHSâye (uygulama veya web arayÃ¼zÃ¼ vasÄ±tasÄ±yla) yÃ¶nlendirildikten sonra mÃ¼Återinin gÃ¼Ã§lÃ¼ kimlik doÄrulamasÄ± adÄ±m adÄ±m ve doÄrudan HHS ile mÃ¼Återi arasÄ±nda yÃ¼rÃ¼tÃ¼lÃ¼r. GKDânin tamamlanmasÄ±ndan sonra mÃ¼Återi tekrar YÃS uygulamasÄ±na yÃ¶nlendirilir. \n YÃ¶nlendirmeli GKD YÃ¶ntemi iÃ§in Ã¼st dÃ¼zey Ã¶rnek iÅ akÄ±ÅÄ± aÅaÄÄ±daki adÄ±mlardan oluÅur: \n \n YÃS, GKD iÃ§in HHS tarafÄ±ndan tanÄ±mlanan arayÃ¼ze (tarayÄ±cÄ± ya da uygulama) yÃ¶nlendirme yapar. \n MÃ¼Återi, YÃS arayÃ¼zÃ¼nden ayrÄ±lÄ±r, yÃ¶nlendirildiÄi HHS arayÃ¼zÃ¼ Ã¼zerinde kimlik doÄrulama iÅlemlerini gerÃ§ekleÅtirir. \n GKD tamamlandÄ±ktan sonra mÃ¼Återi, YÃS arayÃ¼zÃ¼ne tekrar yÃ¶nlendirilir ve iÅlem sonucu gÃ¶rÃ¼ntÃ¼lenir. \n \n YÃ¶nlendirmeli GKD iÃ§in temel gereklilikler ÅunlardÄ±r: \n \n Ãdeme hizmeti (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) tarayÄ±cÄ± ya da uygulama tabanlÄ± bir Åekilde sunulabilir. Bu nedenle,  YÃS ve HHSâlerin YÃ¶nlendirmeli GKD iÃ§in asgari olarak tarayÄ±cÄ± tabanlÄ± yÃ¶nlendirme akÄ±ÅÄ±nÄ± desteklemeleri gerekmektedir. \n ÃerÃ§eve sÃ¶zleÅme (ÃS) kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemleri sadece YÃ¶nlendirmeli GKD yÃ¶ntemi ile gerÃ§ekleÅtirilebilir. \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n HHSânin web arayÃ¼zÃ¼ne, \n \n HHSânin mobil uygulamasÄ±nÄ±n olmadÄ±ÄÄ±, \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) sunduÄu mobil cihazda HHS uygulamasÄ±nÄ±n yÃ¼klÃ¼ olmadÄ±ÄÄ±, \ndurumlarda yÃ¶nlendirme yapÄ±lÄ±r. \n \n YÃSâÃ¼n mobil uygulamasÄ± varsa mobil cihazda uygulamadan tarayÄ±cÄ±ya, YÃSâÃ¼n mobil uygulamasÄ± yoksa Ã¶deme hizmetinin sunduÄu cihazda (KiÅisel Bilgisayar veya Mobil Cihaz) tarayÄ±cÄ± Ã¼zerinden yÃ¶nlendirme yapÄ±lÄ±r. \n Uygulama TabanlÄ± YÃ¶nlendirme \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) YÃSâÃ¼n mobil uygulamasÄ± ile kullanÄ±yorsa, aynÄ± mobil cihazda HHSânin mobil uygulamasÄ±nÄ±n yÃ¼klenmiÅ olmasÄ± durumunda, ÃHK doÄrulamasÄ±nÄ±n HHS mobil uygulamasÄ± tarafÄ±ndan yapÄ±lmasÄ± iÃ§in uygulama tabanlÄ± yÃ¶nlendirme yapÄ±lÄ±r. BÃ¶ylece ÃHK, Ã¶deme hizmetine eriÅim iÃ§in HHSânin mobil kanalÄ±na eriÅim sÄ±rasÄ±nda kullandÄ±ÄÄ± doÄrulama yÃ¶ntemini ile doÄrulanabilir. \n Tablo 5: YÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama KanallarÄ± \n \n \n \n DoÄrulama YÃ¶ntemi \n YÃS OlasÄ± Ortam \n HHS OlasÄ± Ortam \n \n \n \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼)/Mobil Cihaz \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼) / Mobil Cihaz \n \n \n Uygulama TabanlÄ± YÃ¶nlendirme \n Mobil Cihaz \n Mobil Cihaz \n 5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n AyrÄ±k GKD YÃ¶ntemi iÅ akÄ±ÅÄ±, YÃ¶nlendirmeli GKD YÃ¶nteminin iÅlem akÄ±ÅÄ±na benzer. Fark, HHS'nin, Ã§evrimiÃ§i arayÃ¼zÃ¼nden baÄÄ±msÄ±z olan herhangi bir uygulama veya cihaz aracÄ±lÄ±ÄÄ±yla Ã¶deme iÅlemi ayrÄ±ntÄ±larÄ±nÄ± iÃ§eren bir anlÄ±k bildirim (push notification) gÃ¶ndererek mÃ¼Återiden kimlik doÄrulamasÄ± istemesidir. AyrÄ±k GKD YÃ¶ntemine dayalÄ± bir iÅlem iÃ§in (Ã§ok basitleÅtirilmiÅ) Ã¼st dÃ¼zey Ã¶rnek bilgi akÄ±ÅÄ± Åu Åekildedir: \n \n MÃ¼Återi, YÃS arayÃ¼zÃ¼nde iÅlemini baÅlatÄ±r. \n YÃS, talebini mÃ¼Återiye ait TCKN, VKN, YKN gibi tekil tanÄ±mlayÄ±cÄ± kimlik numarasÄ± bilgisi iÃ§erecek Åekilde HHSâye iletilir. \n HHS tekil tanÄ±mlayÄ±cÄ± bilgisini kullanarak farklÄ± bir cihaz veya uygulama Ã¼zerinden mÃ¼Återiye anlÄ±k bildirim gÃ¶nderir ve doÄrulama yapÄ±lmasÄ±nÄ± saÄlar. Bu Åekilde HHS kendi mobil uygulamasÄ±na eriÅim iÃ§in kullanÄ±lan doÄrulama yÃ¶ntemini aynen kullanabilecektir. \n YÃS, herhangi bir yere yÃ¶nlendirme yapmadan iÅlemin sonucunu bekler, mÃ¼Återi YÃS arayÃ¼zÃ¼nden ayrÄ±lmaz (arayÃ¼z aynÄ± kalÄ±r). \n Kimlik doÄrulama sonrasÄ±, YÃS arayÃ¼zÃ¼nde iÅlem sonucu gÃ¶rÃ¼ntÃ¼lenir. \n 5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi \n CSRF AtaklarÄ±ndan korunmak iÃ§in ve YÃS uygulamasÄ±nÄ±n bir Ã¶nceki durumunu restore edebilmesi iÃ§in; YÃS tarafÄ±ndan iletilen yÃ¶nlendirme ve bildirim adreslerine , Oauth2 standartlarÄ±ndaki state parametresine eÅdeÄer,   durum ko

16du (drmKod)  parametresinin eklenmesi gerekmektedir. Durum kodu parametresi YÃS tarafÄ±ndan Ã¼retilen, tekil ve kolay tahmin edilemeyen bir deÄer olmalÄ±dÄ±r. RÄ±za isteÄi gÃ¶nderimi aÅamasÄ±nda oluÅturulmalÄ±dÄ±r. YÃS uygulamasÄ±nda uygun bir yerde saklanmalÄ±dÄ±r (cookie, session, local storage gibi) . \n Durum kodu, rÄ±za isteÄindeki yÃ¶nlendirme adresine parametre olarak eklenir.  GKD sÃ¼reci sonrasÄ±nda yetki kodu ile birlikte bu bilgi, HHS tarafÄ±ndan YÃSâe iletilir. YÃS sakladÄ±ÄÄ± deÄer ile parametre olarak gelen deÄerin eÅitliÄini kontrol eder. AynÄ± ise eriÅim belirteci almak Ã¼zere akÄ±ÅÄ± ilerletir. FarklÄ± ise iÅlemi keser. \n 5.4\tHealthcheck API \n GET /health \n HHSâlerin sunacaÄÄ± bu servis, dÃ¼zenli olarak BKM tarafÄ±ndan Ã§aÄÄ±rÄ±larak servislerin ayakta olup olmadÄ±klarÄ±nÄ±n kontrolÃ¼nÃ¼n saÄlanmasÄ± planlanmaktadÄ±r. \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lmelidir. \nBaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n KoÅullu  / Ä°steÄe BaÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir. \n 5.5  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri \n ÃHK, GKD iÃ§in HHS uygulamasÄ±na yÃ¶nlendirildiÄinde, HHSânin Ã§eÅitli kontroller yaparak iÅlemin doÄruluÄunu teyit etmesi gerekmektedir. YapÄ±lmasÄ± gereken kontrollere ait temel senaryolar aÅaÄÄ±daki tabloda belirtilmiÅtir. Bu senaryolar baz alÄ±narak HHSâler tarafÄ±ndan zenginleÅtirilebilir. \n Zorunlu olarak belirtilen hata durumlarÄ±nÄ±n HHSâler tarafÄ±ndan gerÃ§eklenmesini ve uygun hata kodlarÄ±nÄ±n YÃSâe iletilmesi; ileride oluÅabilecek mutabakatlaÅma sorunlarÄ±nÄ± ortadan kaldÄ±rabilecek, yapÄ±lacak raporlamalar kapsamÄ±nda sistem ve sÃ¼reÃ§ iyileÅtirmelerine katkÄ± saÄlayacak, son kullanÄ±cÄ± aÃ§Ä±sÄ±ndan da alÄ±nan hataya yÃ¶nelik bilgilendirici iÃ§erik saÄlayacaktÄ±r. \n Hata aÃ§Ä±klamalarÄ±; hata koduna uygun ya da uyumlu olmak kaydÄ±yla, HHS ve YÃS tarafÄ±ndan farklÄ± Åekillerde sunulabilir. \n GKD SÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller \n \n \n \n RÄ±za Ä°ptal Detay Kodu \n HHS hata aÃ§Ä±klamasÄ±* \n YÃ¶s ekranÄ±nda listelenecek Ã¶rnek mesaj metni* \n Ãrnek Senaryo \n Zorunlu / Opsiyonel \n \n \n \n \n 07 \n RÄ±za durumunun \"Yetkilendirildi\" , \"Yetki KullanÄ±ldÄ±\" olduÄu durum \n Yetki HatasÄ± \n ÃHK,  GKD iÅlemi tamamlandÄ±ktan sonra  YÃS ekranÄ±nda ileri- geri yaparak ya da ÃHK'nÄ±n yÃ¶nlendirme adresini kopyalayarak tarayÄ±cÄ±ya yapÄ±ÅtÄ±rmasÄ± ile tekrar HHS'ye yÃ¶nlendirir. Bu durumda HHS bu hata mesajÄ±nÄ± iletir. \n Zorunlu \n \n \n 08 \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±. \n Ä°Åleminiz gerÃ§ekleÅtirilememiÅtir. \n YÃS tarafÄ±ndan baÅlatÄ±lan rÄ±za iÃ§erisinde yer alan kimlik bilgisi (TCKN) ile HHS'de GKD yapÄ±lan ÃHK'nÄ±n bilgilerinin uyuÅmadÄ±ÄÄ± durumda \n Zorunlu \n \n \n 09 \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) \n GÃ¶sterilebilecek hesap/kart bulunamamÄ±ÅtÄ±r. \n ÃHK'nÄ±n uygun statÃ¼lÃ¼ hesabÄ±nÄ±n olmadÄ±ÄÄ± durumda \n Zorunlu \n \n \n 10 \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r. \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r. \n AÃ§Ä±k bankacÄ±lÄ±ÄÄ± ayrÄ± bir kanal olarak tanÄ±mlamÄ±Å HHS'lerde, ÃHK'nÄ±n iÅlemlerini AB kanalÄ±na kapatmasÄ± durumunda \n Opsiyonel \n \n \n 11 \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu \n Yetkiniz bulunmamaktadÄ±r. \n 1- Kurumsal firma kullanÄ±cÄ±larÄ±nÄ±n hesaplar Ã¼zerinde iÅlem yetkisinin olmamasÄ± durumunda 2- Bireysel ortak hesaplarda hesap kÄ±sÄ±tÄ± bulunuyorsa (para Ã§Ä±kÄ±ÅÄ±na izin verilmediÄi durum) \n Zorunlu \n \n \n 12 \n ÃHK'nÄ±n ilgili HHS mÃ¼Återisi olmadÄ±ÄÄ± durum \n Yetkiniz bulunmamaktadÄ±r. \n Tek seferlik Ã¶demelerde rÄ±za isteÄinde ÃHK kimlik bilgileri bulunmamaktadÄ±r. DiÄer akÄ±Ålarda rÄ±za isteÄinde mÃ¼Återi olma kontrolÃ¼ yapÄ±labilir. \n Zorunlu \n \n \n 13 \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum \n Yetkiniz bulunmamaktadÄ±r \n HHS'nin, ÃHK iÃ§in iÃ§ sistemlerinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ±. ÃrneÄin: MÃ¼Återinin henÃ¼z bankacÄ±lÄ±k hizmet sÃ¶zleÅmesi gibi Internet Åubesi Ã¼zerinde iÅlem yapmasÄ±nÄ± engelleyen eksikleri olmasÄ± durumunda veya kurumsal kullanÄ±cÄ±da vekalet sÃ¼resinin dolmasÄ±/eksik dokÃ¼man olmasÄ± durumunda kanal Ã¼zerinde iÅlem yapamadÄ±ÄÄ± durum \n Zorunlu \n \n \n 14 \n BaÅarÄ±sÄ±z GKD \n Yetkiniz bulunmamaktadÄ±r \n 1-ÃHK'nÄ±n GKD iÃ§in gerekli 2FA bilgilerini saÄlayamamasÄ±   2- HHS risk algÄ±sÄ±na gÃ¶re 12 nolu hata kodunu dÃ¶nmek yerine 14 nolu hata kodunu da YÃSâe dÃ¶nebilir. \n Zorunlu \n \n \n 15 \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum (Ãr: HHS ekranÄ±nda yer alan VAZGEÃ butonuna basmÄ±Å olabilir. ) \n MÃ¼Återi iÅlemden vazgeÃ§miÅtir. \n 1- HHS ekranÄ±nda yer alan VAZGEÃ butonuna basÄ±lmasÄ± durumu (Hem ÃHK login olmadan Ã¶nce hem de GKD sonrasÄ± (rÄ±za verme Ã¶ncesi) VAZGEÃ butonu olabilir.)  2-MÃ¼Återi Banka login ekranÄ±nda herhangi bir aksiyon almadan beklemiÅtir ve HHS GKD zaman aÅÄ±mÄ± sÃ¼resi 5 dakikadan kÄ±sadÄ±r. \n Zorunlu \n \n \n 16 \n DiÄer \n Ä°Åleminiz gerÃ§ekleÅtirilememiÅtir. \n - \n Opsiyonel \n \n \n \n GKD sÄ±rasÄ±nda iletilen rÄ±za no eÄer HHSânin sisteminde bulunamazsa durumu gÃ¼ncellenecek bir rÄ±za no da olmayacaktÄ±r. HHS kendi Ã¶nyÃ¼zÃ¼nde bu duruma uygun bir mesaj gÃ¶sterebilir. YÃSâe de DiÄer hata kodu ile bu durumu iletebilir. \n"},{title:"2.Kapsam ve Dayanak",frontmatter:{},regularPath:"/v1.0.1/contents/kapsam-ve-dayanak.html",relativePath:"v1.0.1/contents/kapsam-ve-dayanak.md",key:"v-7e81b77d",path:"/v1.0.1/contents/kapsam-ve-dayanak.html",content:" 2.Kapsam ve Dayanak \n 12 KasÄ±m 2019âda gÃ¼ncellenen â 6493 sayÄ±lÄ± Ãdeme ve Menkul KÄ±ymet Mutabakat Sistemleri, Ãdeme Hizmetleri ve Elektronik Para KuruluÅlarÄ± HakkÄ±nda Kanun âun (Kanun) 12ânci maddesine yeni eklenen ve  Ãdeme Hizmetleri Direktifi 2 'de (Payment Services Directive 2, PSD2) bulunan iki yeni Ã¶deme hizmeti aÅaÄÄ±daki gibi tanÄ±mlanmÄ±ÅtÄ±r (Åekil-1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri): \n \n Ãdeme Emri BaÅlatma Hizmeti : ÃHKânÄ±n isteÄi Ã¼zerine baÅka bir Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nda bulunan  Ã¶deme hesabÄ±yla  ilgili sunulan Ã¶deme emri baÅlatma hizmeti [Madde 12, birinci fÄ±kra, (f) bendi] \n Hesap Bilgisi Hizmeti : ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± koÅuluyla, ÃHKânÄ±n Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ± nezdinde bulunan bir veya daha fazla  Ã¶deme hesabÄ±na  iliÅkin konsolide edilmiÅ bilgilerin Ã§evrim iÃ§i platformlarda sunulmasÄ± hizmeti [Madde 12, birinci fÄ±kra, (g) bendi] \n \n   \n Åekil 1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS)- tanÄ±tÄ±m \n Kanunun 14/A maddesinin ikinci fÄ±krasÄ±na gÃ¶re , Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetleri ile ilgili iÅlemlerin yÃ¼rÃ¼tÃ¼lmesine iliÅkin usul ve esaslar ile taraflarca uyulmasÄ± gereken teknik ve operasyonel gereklilikler ikincil dÃ¼zenlemeler uyarÄ±nca TÃ¼rkiye Cumhuriyet Merkez BankasÄ± (TCMB) tarafÄ±ndan belirlenir. Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri  Ã¶deme hizmetleri veri paylaÅÄ±m servisleri (ÃHVPS)  olarak adlandÄ±rÄ±lmaktadÄ±r. \n Ãdeme Hizmetleri ve Elektronik Para Ä°hracÄ± ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± HakkÄ±nda YÃ¶netmelikâin (YÃ¶netmelik) 59âuncu maddesinin birinci fÄ±krasÄ± uyarÄ±nca hazÄ±rlanan bu belgede sÃ¶z konusu Ã¶deme hizmetlerini sunacak Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, Ã¶deme hesabÄ±nÄ±n bulunduÄu Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, varsa ilgili diÄer taraflarÄ±n ve bu hizmetlerin sunulmasÄ± iÃ§in taraflar arasÄ±nda kurulacak baÄlantÄ±nÄ±n teknik ve operasyonel gereklilikleri aÃ§Ä±klanmaktadÄ±r. \n DÃ¼zenlemeler kapsamÄ±nda yetkilendirilen Ã¼Ã§Ã¼ncÃ¼ taraf hizmet saÄlayÄ±cÄ±sÄ±  (Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ±, YÃS) , Ã¶deme hizmeti kullanÄ±cÄ±larÄ±nÄ±n  Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS)  nezdindeki Ã¶deme hesaplarÄ±na ulaÅarak Ã¶deme emri baÅlatma ve hesap bilgisi saÄlama hizmetlerinden (Ã¶deme hizmetleri veri paylaÅÄ±m servislerinden) faydalanmasÄ±na aracÄ±lÄ±k eder. Ãdeme hizmetleri veri paylaÅÄ±m servisleri kapsamÄ±nda iki tip YÃS bulunmaktadÄ±r:  1) Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ve 2) Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS). \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ÃHKânÄ±n farklÄ± Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS) nezdindeki hesaplarÄ±nÄ±n bilgilerini derleyerek Ã§evrim iÃ§i platformlarda  toplu Åekilde  sunar. Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS) ise talebi Ã¼zerine ÃHKânÄ±n HHSâde bulunan Ã¶deme hesabÄ±ndan Ã¶deme iÅlemi baÅlatÄ±r. \n ÃHVPSânin Ã¼st dÃ¼zey gÃ¶sterimi Åekil-2âde verilmiÅtir. \n   \n Åekil 2: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS) -Ã¼st dÃ¼zey gÃ¶sterim \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servislerinin HHSâler tarafÄ±ndan  BKM API GeÃ§idi  vasÄ±tasÄ±yla sunulduÄu uygulama mimarisi ise Åekil-3âte sunulmuÅtur. \n  \n Åekil 3: ÃHVPS'nin BKM API GeÃ§idi vasÄ±tasÄ±yla sunumu \n"},{title:"HHS ve YÃS API",frontmatter:{},regularPath:"/v1.0.1/contents/hhs-yos-api.html",relativePath:"v1.0.1/contents/hhs-yos-api.md",key:"v-4888cd9d",path:"/v1.0.1/contents/hhs-yos-api.html",headers:[{level:2,title:"HHS API",slug:"hhs-api"},{level:2,title:"YOS API",slug:"yos-api"},{level:2,title:"Healthcheck API",slug:"healthcheck-api"}],content:' HHS ve YÃS API \n HHS API, HHSâlerin detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. HHS API iÃ§in âhhs_readâ scope bilgisi kullanÄ±lÄ±r. \n Production ortamÄ±nda HHS / YOS API iÃ§erisinde sisteme dahil olmuÅ, sertifikasyonu baÅarÄ± ile tamamlamÄ±Å paydaÅlar listelenecektir. HHS tarafÄ±ndan desteklenen API sÃ¼rÃ¼mleri listelenecektir. \n YÃSâler HHS APIâsini sorgulayabilir ancak YÃS APIâsini sorgulayamazlar. \nBenzer Åekilde HHSâler YÃS APIâsini sorgulayabilir, HHS APIâsini sorgulayamazlar. \n HHS API \n GET /hhs/{hhsKod} \n Ä°Ålem Sorgu ÃrneÄi =  /hhs  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m HHSâlerin dizi Åeklinde verileri listelenir. \nÄ°Ålem Sorgu ÃrneÄi =  /hhs/2001   â¨ bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan hhsKoduâna ait bilgiler listelenir. Ya da â404 Not Foundâ hatasÄ± alÄ±r. \nHHS ve YÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir. \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hhs?srlmKrtr=kod&srlmYon=A \n Tablo 20: HHS ve YÃS API Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âkodâ, âunvâ

16} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, sÄ±ralama kriteri âunvâ olarak belirlenmelidir. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 21: HHS Bilgileri Sorgulama YanÄ±tÄ± âHhsâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n hhs kodu \n kod \n AN4 \n Z \n HHS nin kod bilgisi \n \n \n hhs unvanÄ± \n unv \n AN3..140 \n Z \n HHS nin unvan bilgisi \n \n \n hhs markasÄ± \n marka \n AN1..140 \n Z \n ÃHK\'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. HHS tarafÄ±ndan belirlenecektir. \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n HHSânin mesaj imzalama iÃ§in paylaÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n HHS Api Bilgileri \n apiBilgileri \n Kompleks: HhsApiBilgi[Array][0..N] \n Z \n Desteklenen Api ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > api \n api \n AN1..20 \n Z \n Api Ä°smi Ãrnek :obh, hbh,gkd \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s2.0 s1.0 \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n HHSâye ait logo bilgileri. Logotur = Original  formatÄ±ndaki logonun minimumda gÃ¶nderimi zorunludur. \n \n \n >logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur alabileceÄi deÄerler  ORIGINAL , WHITE_OVERLAY , BLACK_OVERLAY , GRAY_OVERLAY \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n HHS tarafÄ±nda tutulan ve YÃSâlerle paylaÅÄ±lacak olan url adres bilgisidir. \n \n \n \n Hem YOS hem de HHS API iÃ§in geÃ§erli olacak; logo gÃ¶nderiminde dikkat edilmesi gerekenler Åu Åekilde tariflenmiÅtir: \n \n LogolarÄ±n ham dosya yerine kurumun yayÄ±nlayacaÄÄ± bir URL Ã¼zerinden sunulmasÄ± gerekmektedir. (Ãrn: logoURL  =  https://kurumadi.com.tr/logo.png) Logo BKM tarafÄ±nda host edilmeyecektir.) \n PNG formatÄ±nda (PNG-24) olmalÄ±dÄ±r. \n 72 DPI Ã§Ã¶zÃ¼nÃ¼rlÃ¼kte olmalÄ±dÄ±r. \n 500 x 500 boyutlarÄ±nda, yatayda veya dikeyde taÅma paysÄ±z tam oturacak, sÄ±nÄ±r boyutlarÄ±nÄ± geÃ§meyecek ve ortalanmÄ±Å yerleÅime sahip olmalÄ±dÄ±r. \n Logo arka planÄ± renkli olmamalÄ±, arka plan transparan olmalÄ±dÄ±r. \n YÃS uygulamasÄ±nda gÃ¶sterim esnasÄ±nda logolarÄ±n hÄ±zlÄ± yÃ¼klenmesi ve dÃ¼ÅÃ¼k veri tÃ¼ketmesi aÃ§Ä±sÄ±ndan; logo boyutu 250 KBâÄ±n altÄ±nda olmalÄ±dÄ±r. \n DÃ¶rt adet logo tÃ¼rÃ¼ belirlenmiÅtir. Bu 4 tÃ¼r iÃ§in de logo dÃ¶nÃ¼lmesi zorunludur. \n Logo urlâin public eriÅilebilir url olmasÄ± gereklidir. \n \n YÃS API, YÃS statÃ¼sundeki kurumlarÄ±n detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. YÃS API iÃ§in âyos_readâ scope bilgisi kullanÄ±lÄ±r. \n YÃS API yanÄ±tÄ±nda, listelenen yÃ¶nlendirme ve bildirim adresleri bulunmaktadÄ±r. HHS, iÅlem anÄ±nda iletilen yonAdr ya da bldrAdr alanlarÄ±nda gÃ¶nderilen adreslere yetKod deÄerini iletmelidir. YÃS API iÃ§erisinde yer alan adresleri, rÄ±za isteÄinde gÃ¶nderilen adreslerin doÄruluÄunu kontrol etme amacÄ±yla kullanÄ±lmalÄ±dÄ±r. Bu nedenle YÃS API iÃ§erisinde listelenen adreslerin hostname seviyesinde yer almasÄ± yeterlidir. \n YOS API \n GET /yos/{yosKod} \n Ä°Ålem Sorgu ÃrneÄi =  /yos   ï  bu sorgu yÃ¶ntemi ile tÃ¼m yos lerin dizi Åeklinde verileri listelenir. \n Ä°Ålem Sorgu ÃrneÄi =  /yos/2501   ï  bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan yosKoduâna ait bilgiler listelenir ya da â404 Not Foundâ hatasÄ± alÄ±r.\nYÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir.\nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /yos?srlmKrtr=kod&srlmYon=A \n Tablo 22: YOS Bilgileri Sorgulama YanÄ±tÄ± âYosâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n YÃ¶s kodu \n kod \n AN4 \n Z \n YÃS\'Ã¼n kod bilgisi \n \n \n YÃ¶s unvanÄ± \n unv \n AN3..140 \n Z \n YÃS unvan bilgisi \n \n \n YÃ¶s markasÄ± \n marka \n AN1..140 \n Z \n ÃHK\'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. YÃS tarafÄ±ndan belirlenecektir. \n \n \n YÃS rolleri \n roller \n Array[AN4] \n Z \n YÃSâun rollerini belirten deÄer. Ãrnek: [ "obhs", "hbhs" ]  - obhs - Ãdeme Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼  - hbhs - Hesap Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼ \n \n \n Adresler \n adresler \n Kompleks:Adres[Array] [1..N] \n Z \n --- \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. Adres detaylarÄ±nÄ±n hangi GKD tÃ¼rÃ¼ne ait olduÄunu belirtir. \n \n \n >Adres DetaylarÄ± \n adresDetaylari \n adresDetaylari\tKompleks: AdresDetayi[Array] [1..N] \n Z \n \n \n \n >>Temel Adres \n tmlAdr \n AN1..1024 \n Z \n yetYntm deÄeri âYâ olarak iletildiÄinde YÃ¶nlendirmeli GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. yetYntm deÄeri âAâ olarak iletildiÄinde AyrÄ±k GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. Riza isteklerinde bu deÄer ile uyumluluÄu kontrol edilmelidir. Ãrnek: https://example.com https://example2.com/path deepLink://example/test deepLink://example2/test \n \n \n >>AÃ§Ä±klama \n aciklama \n AN1..1024 \n Ä° \n YÃSâÃ¼n gÃ¶nderdiÄi adrese yÃ¶nelik vermek istediÄi aÃ§Ä±klama Ãrnek: WEB bireysel , WEB kurumsal  , APP \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n YÃSâÃ¼n mesaj imzalama iÃ§in payla

16ÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n YOSâe ait logo bilgileri. Logotur = Original formatÄ±ndaki logonun minimumda gÃ¶nderimi zorunludur. \n \n \n >logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur alabileceÄi deÄerler  ORIGINAL , WHITE_OVERLAY , BLACK_OVERLAY , GRAY_OVERLAY \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n YÃS tarafÄ±nda tutulan ve HHSâlerle paylaÅÄ±lacak olan url adres bilgisidir. Ãrnek: https://via.placeholder.com/150?text=0001 \n Healthcheck API \n GET /health \n HHS ve YÃS API iÃ§in health servisleri aÅaÄÄ±daki servislerle kontrol edilebilir. \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lecektir\nBaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir \n \n \n \n'},{title:"4. RÄ±za DurumlarÄ±",frontmatter:{},regularPath:"/v1.0.1/contents/riza-durumlari.html",relativePath:"v1.0.1/contents/riza-durumlari.md",key:"v-7301a6d1",path:"/v1.0.1/contents/riza-durumlari.html",headers:[{level:2,title:"4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri",slug:"_4-1-hesap-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"},{level:2,title:"4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri",slug:"_4-2-odeme-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"}],content:" 4. RÄ±za DurumlarÄ± \n ÃHK, Ãdeme Emri BaÅlatma Hizmetine ya da Hesap Bilgisi Hizmetine mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi ile baÅlar. ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden yaptÄ±ÄÄ± iÅlemler neticesinde rÄ±za durumlarÄ± deÄiÅebilir.\nRÄ±zaânÄ±n alabileceÄi durum kodlarÄ± Åu Åekilde belirlenmiÅtir. \n B: Yetki Bekleniyor  â Ä°lk rÄ±za talebinde \n Y: Yetkilendirildi  â BaÅarÄ±lÄ± GKD sonrasÄ± yetKod Ã¼retildiÄinde \n K: Yetki KullanÄ±ldÄ±  â EriÅim Belirteci alÄ±ndÄ±ÄÄ±nda \n E: Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼  â ÃBHS iÃ§in \n S: Yetki SonlandÄ±rÄ±ldÄ± \nÂ Â Â Â HBHS iÃ§in : EriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde \nÂ Â Â Â ÃBHS iÃ§in : Yenileme belirteci Son Tarihi geldiÄinde \n I :Yetki Ä°ptal \nRÄ±za iptal durumu ise gerek raporlama gerekse mÃ¼Återi deneyimi perspektifinden doÄru   bilgilendirmeler yapÄ±labilmesi aÃ§Ä±sÄ±ndan aÅaÄÄ±daki gibi detay kodlarÄ± ile zenginleÅtirilmiÅtir: \n \n RÄ±za Ä°ptal Detay Kodu: \n \n \n \n â01â :\tYeni RÄ±za Talebi ile Ä°ptal \n â02â :\tKullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal \n â03â :\tKullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal \n â04â :\tSÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor \n â05â :\tSÃ¼re AÅÄ±mÄ± : Yetkilendirildi \n â06â :\tSÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi \n â07â :\tGKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± \n â08â :\tGKD iptali : RÄ±zano ile TCKN uyuÅmamasÄ± \n â09â :\tGKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor \n â10â :\tGKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n â11â :\tGKD iptali : Hesap Yetki Sorunu \n â12â :\tGKD iptali : ÃHK HHS mÃ¼Återisi deÄil \n â13â :\tGKD iptali : ÃHK HHS kontrollerini aÅamadÄ± \n â14â :\tGKD iptali : BaÅarÄ±sÄ±z GKD \n â15â :\tGKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi \n â16â :\tGKD iptali : DiÄer \n \n \n 4.1 ve 4.2 bÃ¶lÃ¼mlerinde detaylandÄ±rÄ±lan rÄ±za durum deÄiÅikliklerinde rÄ±za iptal detay kodlarÄ± kullanÄ±lmÄ±ÅtÄ±r. \n ÃrneÄin Bâ¨ I/01 denildiÄinde âYetki Bekleniyorâ rÄ±za durumundan âYetki Ä°ptalâ rÄ±za durumuna RÄ±za Ä°ptal Detay Kodu da â01â yani âYeni RÄ±za Talebi ile Ä°ptalâ olarak gÃ¼ncellenmelidir ifade edilmiÅtir. \n ÃHK verdiÄi rÄ±za sÄ±rasÄ±nda seÃ§tiÄi hesaplarÄ±ndan biri kapatÄ±lÄ±rsa, diÄer hesaplara ait bilgileri gÃ¶rmeye devam eder. Ancak ÃHKânÄ±n hesabÄ±na ait bilgilerinin YÃS'e iletilmesini istemediÄi durumda, rÄ±zasÄ±nÄ± tamamen iptal ederek yeni hesap listesi

16ile yeni rÄ±za vermesi gerekmektedir. Yani hesap kapanmasÄ± nedeniyle rÄ±za geÃ§erliliÄini yitirmez. ÃHK'nÄ±n proaktif olarak bu hesabÄ± rÄ±zadan Ã§Ä±karmasÄ± durumunda rÄ±za iptali olur. \n RÄ±za iptal edilmediÄi ve geÃ§erli olduÄu sÃ¼rece kapalÄ± hesaplar iÃ§in diÄer Ã§evrimiÃ§i kanallarda uygulanan yÃ¶ntem izlenmelidir. DiÄer Ã§evrimiÃ§i kanallarda kapalÄ± hesaplara iliÅkin bilgi dÃ¶nÃ¼lmÃ¼yor ise ÃHVPS'den de dÃ¶nÃ¼Å yapÄ±lmaz. ÃHKânÄ±n rÄ±za onayÄ± verdiÄi aÃ§Ä±k hesaplarÄ±nÄ±n tÃ¼mÃ¼ HHS tarafÄ±nda kapatÄ±ldÄ±ÄÄ± durumda, yine aynÄ± Åekilde HHS Ã§evrimiÃ§i kanallarÄ±nda koyduÄu kurallara gÃ¶re bu hesaplarÄ±nÄ±n YÃS uygulamasÄ±nda gÃ¶sterilmesine karar verir. \n Hesap kapama ve ticari kullanÄ±cÄ±larÄ±n hesaplar Ã¼zerindeki yetki deÄiÅiklikleri HHS'nin iÃ§ sistemleri tarafÄ±ndan yapÄ±lan kontrollerle yÃ¶netilir. Buradaki deÄiÅiklikler ile HHS sistemsel olarak rÄ±za iptali gerÃ§ekleÅtiremez. ÃHK izni ve onayÄ± dahilinde rÄ±za iptal gerÃ§ekleÅtirilmesi gerekmektedir. \n 4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n, bir YÃS iÃ§in, bir HHS'de Y, K, B rÄ±za durumlarÄ±nda tek bir rÄ±zasÄ± olabilir.\nBir ÃHK hem kiÅisel olarak hem de bir kurumun kullanÄ±cÄ±sÄ± olabilir. Bu durumda kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Hesap Bilgisi RÄ±zasÄ± isteÄi HHSâye iletilir. \na.\tHHS ÃHK'ya ait iÃ§eride rÄ±za var mÄ± kontrol eder. EÄer yoksa  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \nb.\tEÄer iÃ§eride rÄ±za varsa \nÂ Â Â Â  i. RÄ±za durumu Yetki Bekleniyor - B ise; \nÂ Â Â Â     HHS, sistemde Yetki Bekleniyor - B rÄ±za durumuna sahip kayÄ±t olduÄu iÃ§in, Ã¶ncelikle eski kaydÄ± Yetki Ä°ptal - I durumuna getirir.  RÄ±za Ä°ptal Detay Kodu âYeni RÄ±za Talebi ile iptalâ olmalÄ±dÄ±r.  B â¨ I / 01  SonrasÄ±nda,  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \n Â Â Â Â  ii. RÄ±za durumu Yetkilendirildi - Y veya Yetki KullanÄ±ldÄ± - K ise; \nÂ Â Â Â ÃHK'nÄ±n halihazÄ±rda verilmiÅ bir rÄ±zasÄ± vardÄ±r. HHS, Ã¶nce mevcut rÄ±zanÄ±n iptalinin yapÄ±lmasÄ± gerektiÄine dair hata dÃ¶ner.  TR.OHVPS.Resource.ConsentMismatch \n Â Â Â Â  iii.\tRÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise Yetki Bekleniyor - B durumunda yeni rÄ±za no oluÅturur. \n Â Â Â Â  iv.\tRÄ±za durumu Yetki Ä°ptal - I ise  Yetki Bekleniyor - B  durumunda yeni rÄ±za no oluÅturur. \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda RÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.  B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: TarayÄ±cÄ±yÄ± kapatmÄ±Å olabilir) RÄ±za Yetki Bekleniyor - B rÄ±za durumunda kalÄ±r.  5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B rÄ±za durumundaki kayÄ±tlar Yetki Ä°ptal  : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir.   B â¨ I / 04  Bkz. 9. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine  rizaIptDtyKod  deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n ÃHK'nÄ±n ilgili HHS mÃ¼Återisi olmadÄ±ÄÄ± durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 12 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 13 \n \n \n ÃHK kendini doÄrulayamamÄ±Å olabilir. BaÅarÄ±sÄ±z GKD Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 15 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 16 \n \n \n \n \n \n \n ÃHK, hesaplarÄ±nda/izin tÃ¼rlerinde/EriÅimin GeÃ§erli OlduÄu Son Tarih bilgilerinden bir ya da birden fazlasÄ±nda gÃ¼ncelleme yapmak iÃ§in YÃS ekranÄ±na girer. \n \n \n Â Â Â Â a.\tYÃS Ã¶nce RÄ±za Ä°ptal API'sini Ã§aÄÄ±rÄ±r. Sonra yeni deÄerlerle yeni bir rÄ±za isteÄinde bulunur. Tekrar GKD gerekir. \n Â Â Â Â b.\tYÃS rÄ±za iptal yapmadan yeni rÄ±za alma akÄ±ÅÄ±na baÅlarsa 1.b akÄ±ÅÄ± devreye girer. \n Â Â Â Â c.\tRÄ±za gÃ¼ncelleme ilerleyen sÃ¼rÃ¼mlerde ele alÄ±nacaktÄ±r. \n \n \n EriÅim Belirteci API \n a. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda;

16 \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetki KullanÄ±ldÄ± - K  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Sorgulama: HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir hesap bilgisi-rizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. RÄ±za numarasÄ± ile sorgulama yapÄ±lÄ±r. \n \n \n Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali: HBHS Ã¼zerinden ya da HHS Ã¼zerinden yapÄ±lan rÄ±za iptallerinde RÄ±za durumu  Yetki Ä°ptal - I olarak gÃ¼ncellenir. RÄ±za numarasÄ± ile iptal saÄlanÄ±r. \n a. HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir.  RÄ±za durumu sorgulanÄ±r. \n RÄ±za numarasÄ± Yetki Bekleniyor - B ve Yetkilendirildi - Y ve Yetki KullanÄ±ldÄ± - K durumlarÄ±nda ise Yetki Ä°ptal durumuna getirilir. RÄ±za gnclzmn timestamp ile gÃ¼ncellenir.\nHHS, RÄ±za iptalinde aynÄ± zamanda eriÅim belirtecini de invalid hale getirmelidir. \n B â¨ I / 02 \n Y â¨ I / 02 \n K â¨ I / 02 \n b.\tYÃS Ã¼zerinden yapÄ±lacak iptal iÅleminde yine Y ve B ve K rÄ±za durumlarÄ±nda ise iptal edilebilir. \n B â¨ I / 03 \n Y â¨ I / 03 \n K â¨ I / 03 \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise iptal gerÃ§ekleÅmez. âRÄ±za durumunuz iptal etmeye uygun deÄildir.â hatasÄ± ÃHK'ya yansÄ±tÄ±lÄ±r.  TR.OHVPS.Resource.ConsentMismatch \n \n \n ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.\nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde RÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ± durumuna Ã§ekilmelidir.   K â¨ S \n \n \n Hesaplar, Bakiye ve Ä°Ålemler servislerinde eriÅim belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.\nGeÃ§erli bir eriÅim belirteci yok ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n YÃS'Ã¼n; RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda Hesaplar, Bakiye ve Ä°Ålemler servislerini Ã§aÄÄ±rmamasÄ± beklenir. HHS'nin bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda  TR.OHVPS.Resource.ConsentRevoked  hatasÄ±nÄ± dÃ¶nmesi gereklidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K dÄ±ÅÄ±nda ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± verilmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K ise servis akÄ±ÅlarÄ±na devam edilir. \n RÄ±za sorgulama API'sinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound hatasÄ±  verilmelidir. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir âYetki Bekleniyorâ durumunda kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor  â¨ RÄ±za Ä°ptal  / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir âYetkilendirildiâ durumunda kalan kayÄ±tlar gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ±: Yetkilendirildi  B â¨ I / 05 \nYukarÄ±da bahsedilen, YÃS SÃ¼re AÅÄ±mÄ± nedeniyle rÄ±za iptal durum gÃ¼ncellemelerini y

16apmadan Ã¶nce HHSâyi sorgulayarak rÄ±za durumunu Ã¶Ärenmeli ve sÃ¼re aÅÄ±mÄ± dÄ±ÅÄ±nda bir kodu varsa aynÄ± kodla kendi sistemini gÃ¼ncellemelidir. \nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde rÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ±âya gÃ¼ncellenir.  K â¨ S \n 4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n bir YÃS iÃ§in bir HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n Kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ± isteÄi HHSâye iletilir. Ä°Ã§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za no oluÅturur. \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda rÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.   B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: BrowserÄ± kapatmÄ±Å olabilir)\nRÄ±za durumu Yetki Bekleniyor'dur. 5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B durumundaki kayÄ±tlar RÄ±za Ä°ptal : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir. Bkz. 8. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine rizaIptDtyKod deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n ÃHK'nÄ±n ilgili HHS mÃ¼Återisi olmadÄ±ÄÄ± durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 12 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 13 \n \n \n ÃHK, kendini doÄrulayamamÄ±Å olabilir. BaÅarÄ±sÄ±z GKD Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 15 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 16 \n \n \n \n \n \n \n GKD muafiyeti olduÄunda YÃS HHSâden arka planda onay alÄ±r. Bu onay sÄ±rasÄ±nda rÄ±za durumu  Yetkilendirildi  yapÄ±lÄ±r.  B â¨ Y \n \n \n EriÅim Belirteci API \na. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda; \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B , Yetki KullanÄ±ldÄ± - K  ya da Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K veya Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Ãdeme BaÅlatma API Ã¶nce eriÅim belirteci ve sonrasÄ±nda rÄ±za kontolÃ¼ yapÄ±larak gerÃ§ekleÅtirilmelidir \n \n Ãncelikle EriÅim Belirteci kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir EriÅim Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki S

16onlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Bekleniyor - B , Yetkilendirildi - Y, Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda Ã¶deme emri gerÃ§ekleÅtirilir.  RÄ±za durumu Yetki KullanÄ±ldÄ± - K'dan Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E yapÄ±lmalÄ±dÄ±r.   K â¨E \n \n \n \n Sorgulama: GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlarda, Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle, Ã¶demeEmriRizasi nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r.\nRÄ±za sorgulama, Ãdeme Emri Sorgulama API'lerinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound  hatasÄ± verilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ±nÄ±n Ä°ptali bulunmamaktadÄ±r. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir Yetki Bekleniyor'da kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir Yetkilendirildi'de kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetkilendirildi  B â¨ I / 05 \n 5 dakikadan uzun sÃ¼redir Yetki kullanÄ±ldÄ±'da kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetki kullanÄ±ldÄ± â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi  B â¨ I / 06 \n Yenileme belirteci Son Tarih geldiÄinde rÄ±za durumu Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼âden Yetki SonlandÄ±rÄ±ldÄ±'ya gÃ¼ncellenir. \n E â¨ S \n \n \n GKD muafiyeti sadece Ã¶deme baÅlatma servislerinde bulunmaktadÄ±r. \n \n \n"},{frontmatter:{},regularPath:"/v1.0.1/contents/tanim-ve-kisitlamalar.html",relativePath:"v1.0.1/contents/tanim-ve-kisitlamalar.md",key:"v-1178fa5d",path:"/v1.0.1/contents/tanim-ve-kisitlamalar.html",content:"  1.\tTanÄ±m ve KÄ±saltmalar   \n Tablo 1: TanÄ±m ve KÄ±saltmalar \n \n \n \n KÄ±saltma \n TanÄ±m \n AÃ§Ä±klama \n Ä°ngilizce AÃ§Ä±klama \n Ä°ngilizce KÄ±saltma \n \n \n \n \n ÃS \n ÃerÃ§eve SÃ¶zleÅme \n Ãdeme hizmeti saÄlayÄ±cÄ±sÄ± ile mÃ¼Återi arasÄ±nda tekil veya sÃ¼reklilik arz eden Ã¶deme iÅlemlerinin yÃ¼rÃ¼tÃ¼lmesine ve mÃ¼mkÃ¼n olan durumlarda Ã¶deme hesabÄ±nÄ±n aÃ§Ä±lmasÄ±na iliÅkin usul ve esaslarÄ± belirleyen sÃ¶zleÅme \n \n \n \n \n EPK \n Elektronik Para KuruluÅu \n Kanun kapsamÄ±nda elektronik para ihraÃ§ etme yetkisi verilen tÃ¼zel kiÅi \n Electronic Money Institution \n EMI \n \n \n FAST \n FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi \n TCMB tarafÄ±ndan iÅletilen FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi Sistemi \n \n \n \n \n FAST TR-Karekod \n FAST-TR Karekod Teknik Ä°lke ve Kurallar Rehberi \n TR Karekodâun FAST Sistemi aracÄ±lÄ±ÄÄ±yla gerÃ§ekleÅecek iÅlemlerde kullanÄ±lmasÄ±na iliÅkin detaylÄ± teknik ilke ve kurallarÄ±nÄ± iÃ§eren dokÃ¼man \n \n \n \n \n GKD \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n Kimlik doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin bildiÄi, sahip olduÄu veya biyometrik bir karakteristiÄi olan bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntem \n Strong Customer Authentication \n SCA \n \n \n Ä°B \n Ä°Ålem Bilgisi \n GerÃ§ekleÅtirilen iÅleme iliÅkin iÅlem zamanÄ±nÄ±, iÅlemin niteliÄini ve Ã¶deme iÅlemi iÃ§in Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve Ã¶demenin gÃ¶ndereni ile alÄ±cÄ±sÄ±nÄ± veya toplu Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve gÃ¶ndereni ile alÄ±cÄ±larÄ±nÄ± iÃ§eren bilgi \n \n \n \n \n Ä°DK \n Ä°Ålem DoÄrulama Kodu \n Kimlik doÄrulama yÃ¶ntemlerinden biriyle kendisini sisteme tanÄ±tan bir mÃ¼Återinin gerÃ§ekleÅtirmek istediÄi

16iÅleme Ã¶zgÃ¼ olmak ve belirli bir geÃ§erlilik sÃ¼resi iÃ§inde iÅlem onayÄ±nda kullanÄ±lmak Ã¼zere oluÅturulan, finansal sonuÃ§ doÄrunan iÅlemlerde kiÅiye onay anÄ±nda ilgili iÅlem bilgisi (Ä°B) ile birlikte gÃ¶sterilen, alÄ±cÄ± veya tutarÄ±n deÄiÅmesiyle geÃ§ersiz hale gelen bilgi \n Authentication Code \n AC \n \n \n KOLAS \n Kolay Adresleme Servisi \n Fon transferlerinde hesap numarasÄ± ile ad soyad yerine kullanÄ±lan ve belirli bir hesap ile eÅleÅtirilmiÅ telefon numarasÄ±, e-posta adresi, T.C. Kimlik NumarasÄ± (TCKN), Vergi Kimlik NumarasÄ± (VKN), YabancÄ± Kimlik NumarasÄ± veya Pasaport NumarasÄ± gibi Kolay Adres bilgilerinin kaydedilmesini, gÃ¼ncellenmesini ve sorgulamasÄ±nÄ± saÄlayan katman servis \n \n \n \n \n HBHS \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (g) bendinde tanÄ±mlanan Ã¶deme hizmetini (hesap bilgisi hizmetini) sunan tÃ¼zel kiÅi \n Account Information Service Provider \n AISP \n \n \n HHS \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± \n Nezdinde Ã¶deme hesabÄ± bulunan Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± \n Account Servicing Payment Service Provider \n ASPSP \n \n \n ÃBHS \n Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (f) bendinde tanÄ±mlanan Ã¶deme hizmetini (Ã¶deme emri baÅlatma hizmetini) sunan tÃ¼zel kiÅi \n Payment Initiation Service Provider \n PISP \n \n \n ÃDK \n Ãdeme KuruluÅu \n Ãdeme hizmeti saÄlamak ve gerÃ§ekleÅtirmek iÃ§in Kanun kapsamÄ±nda yetkilendirilmiÅ tÃ¼zel kiÅi \n Payment Institution \n PI \n \n \n ÃH \n Ãdeme HesabÄ± \n Ãdeme hizmeti kullanÄ±cÄ±sÄ± adÄ±na aÃ§Ä±lan ve Ã¶deme iÅleminin yÃ¼rÃ¼tÃ¼lmesinde kullanÄ±lan hesap \n Payment Account \n PA \n \n \n ÃHK \n Ãdeme Hizmeti KullanÄ±cÄ±sÄ± (MÃ¼Återi) \n GÃ¶nderen, alÄ±cÄ± veya her ikisi sÄ±fatÄ±yla belirli bir Ã¶deme hizmetinden faydalanan gerÃ§ek veya tÃ¼zel kiÅi \n Payment Service User \n PSU \n \n \n ÃHS \n Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n 5411 sayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar, EPK, ÃDK ve Posta ve Telgraf TeÅkilatÄ± Anonim Åirketi(PTT) \n Payment Service Provider \n PSP \n \n \n ÃHVPS \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri \n Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri \n \n \n \n \n PÃS \n Perakende Ãdeme Sistemi \n TCMB tarafÄ±ndan iÅletilen, iÅlemlerin TÃ¼rk LirasÄ± Ã¼zerinden gerÃ§ekleÅtiÄi MÃ¼Återiler ArasÄ± TÃ¼rk LirasÄ± AktarÄ±m Sistemi \n \n \n \n \n TR-Karekod \n TR-Karekod Ä°lke ve KurallarÄ± \n Ulusal karekod (TR Karekod) ilke ve kurallarÄ±nÄ±n belirlendiÄi belge \n \n \n \n \n YÃS \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n Ãdeme emri baÅlatma hizmeti ve/veya hesap bilgisi hizmeti sunan tÃ¼zel kiÅi \n Third Party Payment Service Providers \n TPP \n \n \n \n"},{title:"6.\tÃdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v1.0.1/contents/odeme-emri-baslatma-hizmeti.html",relativePath:"v1.0.1/contents/odeme-emri-baslatma-hizmeti.md",key:"v-01c649bd",path:"/v1.0.1/contents/odeme-emri-baslatma-hizmeti.html",headers:[{level:3,title:"Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi",slug:"_6-1-adim-0-odeme-emri-baslatma-istegi"},{level:2,title:"6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_6-2-adim-1-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_6-3-adim-2-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_6-4-adim-2-1-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ±",slug:"_6-5-adim-3-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_6-6-adim-3-1-odeme-emri-sorgusu-istege-baglÄ±"},{level:3,title:"GET /odeme-emri/{odemeEmriNo}",slug:"get-odeme-emri-odemeemrino"},{level:2,title:"6.7\tHealthcheck API",slug:"_6-7healthcheck-api"},{level:3,title:"GET /health",slug:"get-health"}],content:" 6.\tÃdeme Emri BaÅlatma Hizmeti \n Ãdeme emri baÅlatma iÅlemi havale, FAST ya da PÃS Ã¶demesiyle sonuÃ§lanabilir. Ãdeme iÅleminin amacÄ± kiÅiden kiÅiye para transferi, e-ticaret Ã¶demesi gibi farklÄ± Ã¶deme tÃ¼rleri olabilir. Ãdemenin amacÄ±na gÃ¶re ÃBHSânin ileteceÄi veri setinde farklÄ±laÅmalar olabilir. \n Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n Ãdeme Emri BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden Ã¶deme emrini baÅlatÄ±r. \n Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âÃdeme Emri BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âÃ¶deme emriâni HHSâye iletir. \n Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n \n \n Åekil 4: Ãdeme Emri BaÅlatma Hizmeti Ãst DÃ¼zey Ä°Å AkÄ±ÅÄ± \n Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. \n Tablo 6: Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n odeme-emri-rizasi \n POST \n POST /odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriRizasiIstegi \n OdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n POST/erisim-belirteci /odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n odeme-emri-rizasi \n GET \n GET /odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmriRizaYaniti \n \n \n 3 \n odeme-emri \n POST \n POST /odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n OdemeEmriIstegi \n OdemeEmri \n \n \n 3.1 \n odeme-emri \n GET \n GET /odeme-emri

16/{odemeEmriNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmri \n 6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) Ã¶deme emri baÅlatma iÅlemine onay verir. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil 5: Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (odemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ mi? \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahip mi? \n Ä°stekte bulunulan HHS kodu doÄru mu? \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren odemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir OdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n API dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme ve bildirim adresleri ile Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) \n HHS; kimlik bilgileri nesnesinde eÄer kimlik bilgileri iletilmiÅ ise; bu veri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (KoÅullu Zorunlu) \n HHS kimlik bilgisi ile gÃ¶nderen unvanÄ±nÄ±n uyumlu olduÄunun kontrol eder. (Zorunlu) \n GÃ¶nderen Hesap NumarasÄ± ile ilgili Tablo7âde belirtilen kontroller yapÄ±lmalÄ±dÄ±r. (Zorunlu) \n HHS, Ã¶deme iÃ§in benzersiz âRizaNoâ ile âOdemeEmriRizasiâ nesnesi oluÅturur ve ÃBHSâye dÃ¶ner. \n HHS, OdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \nBu aÅamada ÃHKânÄ±n HHS tarafÄ±ndan tanÄ±mlanmÄ±Å ve isteÄin veri alanÄ±nda gÃ¶nderen hesaba (borÃ§landÄ±rÄ±lacak hesaba) iliÅkin bir bilgisinin olmasÄ± gerekmez. \nHesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n \n POST /odeme-emri-rizasi  isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âodemeEmriRizasiIstegiâ nesnesi (Tablo-7) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âodemeEmriRizasiâ (Tablo-8) nesnesi oluÅturulur. \n  BAÅARILI Ä°STEK: \n Tablo 7: âOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidASPSP  hata kodunu dÃ¶ner. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. Hata durumunda  TR.OHVPS.Connection.InvalidTPP  hata kodunu dÃ¶ner. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  YÃS YÃ¶nlendirmeli GKD yÃ¶ntemi ile akÄ±ÅÄ± destekliyorsa, yetYntm deÄiÅkeninden baÄÄ±msÄ±z olarak yÃ¶nlendirme adresini iletmelidir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. YÃSâÃ¼n ileteceÄi adrestir.  YÃS AyrÄ±k GKD yÃ¶ntemi ile akÄ±ÅÄ± destekliyorsa, yetYntm deÄiÅkeninden baÄÄ±msÄ±z olarak bildirim adresini iletmelidir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, ayrÄ±k GKD sonrasÄ± bu alanda belirtilen adrese otorizasyon kodunu (authentication code) iletir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir para birimi olduÄu kontrol eder. \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n Ä° \n GÃ¶nderenin unvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  TR.OHVPS.Business.InvalidContent  hatasÄ± verilmelidir. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir.  Kontrol baÅarÄ±sÄ±z olduÄunda  TR.OHVPS.Business. InvalidAccount  hatasÄ± YÃSâe iletilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, HspRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n unvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r.  FAST-TR Karekod dÄ±ÅÄ±ndaki iÅ yeri Ã¶demelerinde; yine Unvan alanÄ±nda iÅyeri adÄ± bilgisi gÃ¶nderilmelidir. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n HHS geÃ§erli bir Ãdeme KaynaÄÄ± kodu kullanÄ±ldÄ±ÄÄ±nÄ± kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK iÃ§in biricik olarak oluÅturan referans bilgisi  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tKarekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..50 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi. \n \n \n \n > ÃBHS Masraf TutarÄ± \n obhsMsrfTtr \n Kompleks:Tutar \n Ä° \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n ÃBHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n Ä° \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r. \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n Ä° \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir.  4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n Ä° \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n Ä° \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriRizasiâ nesnesi Tablo-8âdeki parametrelerden oluÅur: \n Tablo 8: âOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄ

16u durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r. \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n >> Unvan \n unv \n AN3..140 \n Ä° \n GÃ¶nderenin unvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlattÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK iÃ§in biricik olarak oluÅturan referans bilgisi  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tKarekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..50 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem sa

16atleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisidir. Bu alan ileri vadeli Ã¶demeler iÃ§in dÃ¼ÅÃ¼nÃ¼lmÃ¼ÅtÃ¼r. Ä°lk fazda doldurulmasÄ±na gerek olmadÄ±ÄÄ± dÃ¼ÅÃ¼nÃ¼lmektedir. \n \n \n > ÃBHS Masraf TutarÄ± \n obhsMsrfTtr \n Kompleks:Tutar \n Ä° \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n ÃBHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n \n \n > HHS Masraf TutarÄ± \n hhsMsrfTtr \n Kompleks:Tutar \n Ä° \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n HHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n Ä° \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n Ä° \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n Ä° \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n Ä° \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil 6: Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n Ã¶deme emrini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra;

16 HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âodemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle,  OdemeEmriRizasi  nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  OdemeEmriRizasi  nesnesine iÅler. \n GET /odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  OdemeEmriRizasi  kaynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n Durum \n OdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /odeme-emri-rizasi/{RizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-8âde yer alan parametreleri iÃ§eren âOdemeEmriRizasiâ oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /odeme-emri-rizasi/{RizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemlerinde, Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgilerinin Ã¶deme emri rÄ±zasÄ± sÄ±rasÄ±nda gÃ¶nderimi zorunlu deÄildir. BaÅarÄ±lÄ± GKD sonrasÄ±, yani eriÅim belirteci alÄ±ndÄ±ÄÄ±nda, Ã¶deme emri oluÅmadan Ã¶nce, YÃSâÃ¼n Ã¶deme emri rÄ±zasÄ±nÄ± sorgulayarak bu bilgileri almasÄ± ve Ã¶deme emrini oluÅtururken Kimlik TÃ¼rÃ¼ ve Kimlik Verisi alanlarÄ±nÄ± dolu olarak gÃ¶ndermesi beklenmektedir.  Ancak rÄ±za durumu âYetki Bekleniyor - Bâ, âYetkilendirildi - Yâ ve âYetki Ä°ptal - Iâ statÃ¼lerinde ise, Ã¶deme emri rÄ±zasÄ± sorgulamasÄ±nda, HHSânin Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgisini YÃS ile paylaÅmamasÄ± gerekmektedir. \n 6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Ãdeme Emrinin OluÅturulmasÄ± \n POST /odeme-emri \n \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS OdemeEmri kaynaÄÄ±nÄ± oluÅturur. \n Ãdeme emri (OdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r.\n \n POST HHS tarafÄ±ndan iÅlenir: RizaDurumu âYetki KullanÄ±ldÄ±â ise iÅleme baÅlanÄ±r. \n POST /odeme-emri-rizasi ile POST /odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r.POST verisindeki GÃ¶nderen Hesap NumarasÄ± ve AlÄ±cÄ± Hesap NumarasÄ±nÄ±n aynÄ± bankaya aitse HAVALE deÄilse FAST veya PÃS iÅ akÄ±ÅÄ±na geÃ§ilir. \n POST verisinin modele gÃ¶re kontrolÃ¼ yapÄ±lÄ±r (alan kontrolleri) \n POST verisinin mantÄ±ksal kontrolleri yapÄ±lÄ±r (IBAN kontrolÃ¼, Ã§apraz alan kontroller) \n OdemeEmriDurumu âGerÃ§ekleÅtiâ / âGÃ¶nderildiâ / âGerÃ§ekleÅmediâ olarak gÃ¼ncellenir. \n \n \n POST baÅarÄ±lÄ± olursa, iÃ§erisinde OdemeEmriNo ve OdemeEmriDurumu deÄiÅkenleri de bulunan OdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n \n BAÅARILI Ä°STEK: \n Tablo 9: âOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidASPSP  hata kodunu dÃ¶ner. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidTPP  hata kodunu dÃ¶ner. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi \n \n \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde, 1. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n Ãdeme Emri RizasÄ± Nesnesindeki Ä°Ålem TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS iÅlem tutarÄ± Ã¶deme mesajÄ±nda (Havale/FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n Ttr \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari unvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>>

16 Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Ãdemeye Ã¶zel Referans Bilgisi alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK iÃ§in biricik olarak oluÅturan referans bilgisi -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ± -\tKarekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ± -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ± verilerinden biri kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. FAST:  KareKod ile baÅlatÄ±lan iÅlemlerde FAST A01 mesajÄ±ndaki Karekod ReferansÄ± (KrkdRef) alanÄ±na karÅÄ±lÄ±k gelir. Bu durumda, FAST A01 mesajÄ± alanlarÄ± âFAST Mesaj YapÄ±sÄ± ve Ä°Ålem TÃ¼rleriâ belgesin uygun Åekilde oluÅturulur: KareKod (KrKd) bÃ¶lÃ¼mÃ¼ndeki Karekod AkÄ±Å TÃ¼rÃ¼ (KrkdAksTur) ve Karekod ReferansÄ± (KrkdRef) alanlarÄ± doldurulmalÄ±dÄ±r.  KiÅiden kiÅiye fon aktarÄ±mlarÄ±nda ve e-ticaret iÅlemelerinde Referans Bilgisi (RefBlg) alanÄ± doldurulur. \n FAST (KrkdRef) ve (RefBlg) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlattÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK iÃ§in biricik olarak oluÅturan referans bilgisi  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tKarekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n FAST (KrkdRef) ve (RefBlg) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..50 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi. \n \n FAST/PÃS Acklm \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme Sistemi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem sa

16atleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n \n \n > ÃBHS Masraf TutarÄ± \n obhsMsrfTtr \n Kompleks:Tutar \n Ä° \n \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n Ãdeme Emri RizasÄ± Nesnesindeki ÃBHS Masraf Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n ÃBHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n Ãdeme Emri RizasÄ± Nesnesindeki ÃBHS Masraf TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > HHS Masraf TutarÄ± \n hhsMsrfTtr \n Kompleks:Tutar \n Ä° \n \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n Ãdeme Emri RizasÄ± Nesnesindeki HHS Masraf Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n HHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n Ãdeme Emri RizasÄ± Nesnesindeki HHS Masraf TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n Ä° \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r. \n \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n Ä° \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n Ä° \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n Ä° \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n \n \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Emir Bilgileri \n emrBlg \n Kompleks: EmirBilgileri \n Z \n \n \n \n > Ãdeme Emri NumarasÄ± \n odmEmriNo \n AN1..128 \n Z \n Ãdeme Emri nesnesinin UID'sidir. OdemeEmrine Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Ãdeme Emri Zaman \n odmEmriZmn \n ISODateTime \n Z \n Ãdeme emrinin FAST, PÃS, havale gibi gerÃ§ekleÅtirileceÄi ilgili Ã¶deme sistemine iletilme tarihi. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari unvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Ãdeme Durumu \n odmDrm \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK iÃ§in biricik olarak oluÅturan referans bilgisi  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tKarekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..50 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Ãdeme Sistem NumarasÄ± \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. FAST iÅlemleri iÃ§in MesRefBlg deÄeri atanÄ±r. Ãdeme Hizmeti kullancÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n > ÃBHS Masraf TutarÄ± \n obhsMsrfTtr \n Kompleks:Tutar \n Ä° \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n ÃBHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n \n \n > HHS Masraf TutarÄ± \n hhsMsrfTtr \n Kompleks:Tutar \n Ä° \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n >> Tutar \n ttr \n N1..18 \n Z \n HHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir. \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n Ä° \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n Ä° \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n Ä° \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n Ä° \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Ãdeme Emri Sorgusu \n GET /odeme-emri

16/{odemeEmriNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla Ã¶deme emrini sorgulayabilir. \n BAÅARILI YANIT: \n GET /odeme-emri/{odemeEmriNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âOdemeEmriâ nesnesi dÃ¶ner. \n 6.7\tHealthcheck API \n GET /health \n HHSâlerin sunacaÄÄ± bu servis, dÃ¼zenli olarak BKM tarafÄ±ndan Ã§aÄÄ±rÄ±larak servislerin ayakta olup olmadÄ±klarÄ±nÄ±n kontrolÃ¼nÃ¼n saÄlanmasÄ± planlanmaktadÄ±r \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lmelidir. \n BaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir \n \n \n \n"},{title:"3. Temel Prensipler",frontmatter:{},regularPath:"/v1.0.1/contents/temel-prensipler.html",relativePath:"v1.0.1/contents/temel-prensipler.md",key:"v-432b5bd6",path:"/v1.0.1/contents/temel-prensipler.html",headers:[{level:2,title:"3.1 Genel",slug:"_3-1-genel"},{level:2,title:"3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum",slug:"_3-2-istem-cagrÄ±-ve-oturum"},{level:2,title:"3.3.\tRESTful API",slug:"_3-3-restful-api"},{level:2,title:"3.4.\tSÃ¼rÃ¼m YÃ¶netimi",slug:"_3-4-surum-yonetimi"},{level:2,title:"3.5.\tKaynak URI Yol YapÄ±sÄ±",slug:"_3-5-kaynak-uri-yol-yapÄ±sÄ±"},{level:2,title:"3.6.\tKarakter Kodlama",slug:"_3-6-karakter-kodlama"},{level:2,title:"3.7.\tVeri FormatÄ±",slug:"_3-7-veri-formatÄ±"},{level:2,title:"3.8.\tÄ°stemci Sertifika YÃ¶netimi",slug:"_3-8-istemci-sertifika-yonetimi"},{level:2,title:"3.9.\tYetkilendirme TÃ¼rleri",slug:"_3-9-yetkilendirme-turleri"},{level:2,title:"3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ±",slug:"_3-10-istek-cevap-mesajlarÄ±nda-kullanÄ±lan-nesne-yapÄ±larÄ±"},{level:2,title:"3.11. SayfalandÄ±rma ve Filtreleme",slug:"_3-11-sayfalandÄ±rma-ve-filtreleme"},{level:2,title:"3.12. Mesaj Ä°mzalama",slug:"_3-12-mesaj-imzalama"},{level:2,title:"3.13. Durum Kodu",slug:"_3-13-durum-kodu"},{level:2,title:"3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ±",slug:"_3-14-gereksinimlerinin-sÄ±nÄ±flandÄ±rÄ±lmasÄ±"},{level:2,title:"3.15. Ä°stek BaÅlÄ±ÄÄ±",slug:"_3-15-istek-baslÄ±gÄ±"},{level:2,title:"3.16. YanÄ±t BaÅlÄ±ÄÄ±",slug:"_3-16-yanÄ±t-baslÄ±gÄ±"},{level:2,title:"3.17. Idempotency KurallarÄ±",slug:"_3-17-idempotency-kurallarÄ±"},{level:2,title:"3.18. HTTP Durum KodlarÄ±",slug:"_3-18-http-durum-kodlarÄ±"},{level:2,title:"3.19. Maskeleme KurallarÄ±",slug:"_3-19-maskeleme-kurallarÄ±"},{level:2,title:"3.20. Fonksiyonel Olmayan Gereksinimler",slug:"_3-20-fonksiyonel-olmayan-gereksinimler"}],content:' 3. Temel Prensipler  \n Bu bÃ¶lÃ¼mde Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (Hesap Bilgisi Hizmeti, Ãdeme Emri BaÅlatma Hizmeti) iÃ§in tanÄ±mlanan temel prensipler aÃ§Ä±klanmaktadÄ±r. \n 3.1 Genel \n \n \n HHSâler YÃ¶netmeliÄin 59. maddesinin beÅinci fÄ±krasÄ± ve Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄin (TebliÄ) 23. maddesinin birinci fÄ±krasÄ± uyarÄ±nca, Ã¶deme hizmetleri veri paylaÅÄ±m servislerini BKM API GeÃ§idi aracÄ±lÄ±ÄÄ±yla HBHS ve ÃBHSâye sunmakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n \n \n TebliÄin 23. maddesinin ikinci fÄ±krasÄ± uyarÄ±nca Ã¶deme emri baÅlatma hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± ÃBHS ile HHSâdir. \n \n \n TebliÄin 23. maddesinin Ã¼Ã§Ã¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca hesap bilgisi hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± HBHS ile HHSâdir. \n \n \n YÃ¶netmeliÄin 60. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, Ã¶deme emri baÅlatma hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n YÃ¶netmeliÄin 61. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, hesap bilgisi hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n TebliÄin 25. maddesi uyarÄ±nca HHS ve YÃS (ÃBHS ve HBHS) arasÄ±nda baÄlantÄ± uÃ§tan uca gÃ¼venli bir Åekilde saÄlanÄ±r. Bu amaÃ§la iletim katmanÄ±nda TLS (asgari 1.2 sÃ¼rÃ¼mÃ¼) ile Åifreli iletiÅim saÄlanÄ±r. \n \n \n TebliÄin 23. maddesinin dÃ¶rdÃ¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca HHS tarafÄ±ndan sunulan Ã¶deme hizmetleri veri paylaÅÄ±m servislerini kullanan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n TCMB tarafÄ±ndan ilgili Ã¶deme hizmeti iÃ§in yetkilendirilmiÅ olduÄu kontrol edilir. \n \n \n TebliÄin 25. maddesinin beÅinci fÄ±krasÄ± uyarÄ±nca zaman damgasÄ±, 15/1/2004 tarihli 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunu kapsamÄ±nda tanÄ±mlanan zaman damgasÄ±na dayanÄ±r. \n \n \n API alan isimleri TÃ¼rkÃ§e olarak tanÄ±mlanmÄ±ÅtÄ±r. Ancak API baÅlÄ±ÄÄ± (header) alanÄ±ndaki alan isimleri Ã¶zelinde, API GeÃ§itleri tarafÄ±ndan otomatik olarak tanÄ±nabilmesi gÃ¶zetilerek, Ä°ngilizce isimlendirme tercih edilmiÅtir. \n 3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum \n \n \n Her istek biricik istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± iÃ§erir. Birden fazla istek iÃ§eren iÅlem YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi (istek numarasÄ±: x-request-id) ve iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi (iÅlem grup numarasÄ±: x-group-id) deÄerleri kullanÄ±larak HHS tarafÄ±ndan bir oturum yaklaÅÄ±mÄ± ile sÃ¼rdÃ¼rÃ¼lÃ¼r (Bknz. 3.15 Ä°stek BaÅlÄ±ÄÄ±). \n \n \n Oturum takibi ise iÅlem grup numarasÄ± ile yapÄ±lÄ±r. Ä°Ålem grup numarasÄ± da ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± ile birlikte ilgili tÃ¼m iÅlem verilerini iÃ§erecek Åekilde k

16ayÄ±t altÄ±na alÄ±nÄ±r. \n \n \n ÃrneÄin, bir Ã¶deme emri baÅlatma iÅlemi birden fazla istekten oluÅur. Her istek yukarÄ±da belirtildiÄi gibi biricik istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± iÃ§erir. Ancak iÅlemin oturum bÃ¼tÃ¼nlÃ¼ÄÃ¼ iÅlem grup numarasÄ± ile saÄlanÄ±r. \n \n \n Taraflar aÃ§tÄ±klarÄ± oturumu iÅlem bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ saÄlayacak sÃ¼re iÃ§erisinde aÃ§Ä±k tutar ve iÅlem biter bitmez kapatÄ±r. \n 3.3.\tRESTful API \n APIâler, dÃ¼nya Ã¶lÃ§eÄinde yaygÄ±n bir Åekilde kullanÄ±lan Temsili Durum Transferi (Representational State Transfer, REST) mimari tarzÄ± ve JavaScript Nesne Notasyonu (JavaScript Object Notation, JSON) veri formatlarÄ±na uygun olarak geliÅtirilir. En Ã¼st seviye Veri TanÄ±mlama Dili (Data Description Language) ve en iyi uygulama Ã¶rnekleri iÃ§in  ^JSON ÅemasÄ±  temel alÄ±nÄ±r. \n 3.4.\tSÃ¼rÃ¼m YÃ¶netimi \n API sonraki aÅamalarda doÄabilecek gereksinimleri ve daha karmaÅÄ±k kullanÄ±m durumlarÄ±nÄ± karÅÄ±lamak iÃ§in sÃ¼rÃ¼mler halinde geliÅtirilir ve bu durum tasarÄ±m sÄ±rasÄ±nda gÃ¶z Ã¶nÃ¼nde bulundurulur. \n API v1.0 sÃ¼rÃ¼mÃ¼nde ; \n \n Kapsamdaki Ã¶deme hesaplarÄ± : Vadesiz TL, yabancÄ± para hesaplarÄ± (gerÃ§ek ve tÃ¼zel kiÅilere ait Ã¶deme hesaplarÄ±), Kredili Mevduat HesabÄ± \n Tekil Ã¶deme (Virman/Havale/FAST/MÃ¼ÅterilerarasÄ± TL AktarÄ±m Sistemi)\n \n Virman ve havale iÅlemleri kapsamÄ±nda yabancÄ± para transferi yapÄ±labilir. \n \n \n Hesap bilgisi hizmetleri\n \n Temel veya ayrÄ±ntÄ±lÄ± hesap bilgisi \n Bakiye \n GerÃ§ekleÅen iÅlemler iÃ§in Hesap hareketleri \n \n \n Karekodlu Ã¶demelerdeki 01, 02 ve 03 akÄ±Å tÃ¼rleri\nyer almaktadÄ±r. \n \n Her sÃ¼rÃ¼m deÄiÅikliÄinde bir Ã¶nceki sÃ¼rÃ¼m belirli bir sÃ¼re desteklenecektir. DiÄer bir ifadeyle, sadece belirli bir sÃ¼re iÃ§in mevcut ve bir Ã¶nceki sÃ¼rÃ¼m aynÄ± anda eriÅilebilir olacaktÄ±r. \n 3.5.\tKaynak URI Yol YapÄ±sÄ± \n YÃSâlerin baÅlattÄ±ÄÄ± Ã§aÄrÄ±larda URI yolu aÅaÄÄ±daki yapÄ±yÄ± takip eder: \n [hhs-yol-Ã¶n-eki]/ohvps/ [kaynak-grubu]/ [sÃ¼rÃ¼m]/ [kaynak]/[kaynak-no]/[alt-kaynak] \n Bu, aÅaÄÄ±daki unsurlardan oluÅur: \n \n [hhs-yol-Ã¶n-eki] \nÄ°steÄe baÄlÄ±, HHS\'ye Ã¶zgÃ¼ yol Ã¶n ekini ifade eder. \nBKM API geÃ§idi Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda BKM tarafÄ±ndan belirlenen sistem adÄ± ve yol Ã¶n eki kullanÄ±lÄ±r. \n ohvps \nSabit metin âohvpsâ (Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri kÄ±saltmasÄ±) \n [kaynak-grubu] \nKaynak grubu, APIâye eriÅmek iÃ§in kullanÄ±lan Ã¶deme hizmetine (HBH, ÃBH) gÃ¶re eriÅim adresi (end point) grubunu tanÄ±mlar (âhbhâ veya âobhâ). \n [sÃ¼rÃ¼m] \nAPI sÃ¼rÃ¼mÃ¼nÃ¼ ifade eder (â/s[ana-sÃ¼rÃ¼m].[alt-sÃ¼rÃ¼m]/â). \n [kaynak]/[kaynak-no] \nKaynak detaylarÄ±nÄ± ifade eder. \n [alt-kaynak] \nAlt kaynak detaylarÄ±nÄ± ifade eder. \n \n HHS, tÃ¼m kaynaklarÄ± iÃ§in aynÄ± katÄ±lÄ±mcÄ± yolu Ã¶n ekini ve sistem adÄ±nÄ± kullanmalÄ±dÄ±r. \n BKM APIâlerine eriÅmek isteyen uygulamalarÄ±n yetkilerine gÃ¶re aÅaÄÄ±daki APIâlere abone olmalarÄ± gerekmektedir: \n OBH: \n https://apigw-prod.bkm.com.tr/api/main/ohvps/obh/s1.0/odeme-emri-rizasi \n https://apigw-prod.bkm.com.tr/api/main/ohvps/obh/s1.0/odeme-emri \nHBH: \n https://apigw-prod.bkm.com.tr/api/main/ohvps/hbh/s1.0/hesap-bilgisi-rizasi \n https://apigw-prod.bkm.com.tr/api/main/ohvps/hbh/s1.0/hesaplar \n https://apigw-prod.bkm.com.tr/api/main/ohvps/hbh/s1.0/hesaplar/1234/islemler \n https://apigw-prod.bkm.com.tr/api/main/ohvps/hbh/s1.0/hesaplar/1234/bakiye \nGKD \n https://apigw-prod.bkm.com.tr/api/main/ohvps/gkd/s1.0/erisim-belirteci \nHHS â YÃS API \n https://apigw-prod.bkm.com.tr/api/main/hhs-api/s1.0/hhs \n https://apigw-prod.bkm.com.tr/api/main/hhs-api/s1.0/hhs/1234 \n https://apigw-prod.bkm.com.tr/api/main/yos-api/s1.0/yos \n https://apigw-prod.bkm.com.tr/api/main/yos-api/s1.0/yos/1234 \n HHSâlerin saÄlayacaklarÄ± APIâlerdeki URI Ã§evrimi Ã¶rnekleri aÅaÄÄ±daki gibidir. \n \n https://xbank.com.tr/api-portal/ohvps/obh/s1.0/odeme-emri \n https://apigw-prod.bkm.com.tr/api/main/ohvps/obh/s1.0/odeme-emri  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.0/hesap-bilgisi-rizasi \n https://apigw-prod.bkm.com.tr/api/main/ohvps/hbh/s1.0/hesap-bilgisi-rizasi  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.1/hesaplar \n https://apigw-prod.bkm.com.tr/api/main/ohvps/hbh/s1.1/hesaplar   (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.1/hesaplar/1234 \n https://apigw-prod.bkm.com.tr/api/main/ohvps/hbh/s1.1/hesaplar/1234  (BKM API) \n \n BKM API GeÃ§idi Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda, istek baÅlÄ±ÄÄ±nda bulunan âx-aspsp-codeâ (isteÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodu) deÄerine gÃ¶re HHS APIâde standart olarak tanÄ±mlanmÄ±Å olan âbasePathâ bilgisine servis uzantÄ±sÄ± eklenerek HHSâye yÃ¶nlendirme yapÄ±lÄ±r. \n ÃrneÄin, istek baÅlÄ±ÄÄ±nda  xbank âÄ±n kodu varsa, YÃS tarafÄ±ndan yapÄ±lan \n https://apigw-prod.bkm.com.tr/api/main/ohvps/hbh/s1.0/hesap-bilgisi-rizasi \nÃ§aÄrÄ±sÄ± BKM API GeÃ§idi tarafÄ±ndan karÅÄ±lanarak \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.0/hesap-bilgisi-rizasi \nadresine yÃ¶nlendirilir. \n Bu Ã¶rnekte,  https://xbank.com.tr/api-portal  basePath bilgisi HHS tarafÄ±ndan HHS APIâye girilen deÄerdir. \n 3.6.\tKarakter Kodlama \n API istekleri ve yanÄ±tlarÄ±nda UTF-8 karakter kodlamasÄ± kullanÄ±lÄ±r. Bu, JSON iÃ§in varsayÄ±lan karakter kodlamasÄ±dÄ±r. \n Ancak, bir HHS\'nin kendi uygulamalarÄ± ve Ã¶deme baÅlattÄ±ÄÄ± Ã¶deme sistemi (FAST vb.)  bazÄ± UTF-8 karakterlerini kabul etmeyebilir. HHS, UTF-8 kodlamasÄ± iÃ§eren bir mesajÄ± iÅleyemez ve reddederse, HTTP 400 (HatalÄ± Ä°stek) durum ko

16du ile yanÄ±t vermelidir. \n 3.7.\tVeri FormatÄ± \n \n AÃ§Ä±k bankacÄ±lÄ±k kapsamÄ±ndaki zaman damgasÄ±, ISO 8601 standartÄ±na uygun olarak yerel saat bilgisini ve timezone bilgisini de iÃ§erecek Åekilde " yyyy-MM-ddâTâHH:mm:ssXXX " formattaki haliyle hazÄ±rlanmalÄ±dÄ±r. \n \n Ãrnek:  "timestamp": "2021-05-30T20:34:15+03:00" \nyyyy : 4 hane yÄ±l \nMM : BaÅa â0â eklenmiÅ, toplam 2 hane ay \ndd    : BaÅa â0â eklenmiÅ, toplam 2 hane gÃ¼n \nHH    : BaÅa â0â eklenmiÅ, toplam 2 hane saat (0-23 arasÄ± deÄer alabilir.) \nmm : BaÅa â0â eklenmiÅ, toplam 2 hane dakika \nss    : BaÅa â0â eklenmiÅ, toplam 2 hane saniye \nXXX : ISO 8601 Time zone \n \n JWT veri paketlerinde kullanÄ±lan zaman damgalarÄ±, 1 Ocak 1970 Saat 00:00:00 (UTC) anÄ±ndan itibaren geÃ§en saniye sayÄ±sÄ± deÄerini (Unix Time) kullanÄ±r. \n Bir HHS, tarihi yanlÄ±Å biÃ§imlendirilmiÅ bir istek aldÄ±ÄÄ±nda, 400 (HatalÄ± Ä°stek) durum kodu ve ilgili hata kodu ile yanÄ±t verir. \n TÃ¼m tutar alanlarÄ± tam sayÄ± olarak, para birimleri ise ISO4217âdeki 3 harfli kodla iletilir. Tutar alanÄ±, tutara iliÅkin para biriminin ISO4217âde tanÄ±mlÄ± olan tam sayÄ±dan sonraki uzunluÄuna gÃ¶re formatlanarak okunmalÄ±dÄ±r. ÃrneÄin 1,20 TRY iÃ§in tutar alanÄ±nda â120â deÄeri iletilir, para birimi TRY olduÄu iÃ§in son iki basamaÄÄ±n kuruÅ olduÄu sonucuna ulaÅÄ±lacaktÄ±r. 12000 Japon Yeni iÃ§in, ISO4217âde JPY para biriminin ondalÄ±k kÄ±smÄ± olmadÄ±ÄÄ±ndan tutar alanÄ±nda 12000 deÄeri iletilir. \n SÄ±ralÄ± veri tipleri bÃ¼yÃ¼k kÃ¼Ã§Ã¼k harfe duyarlÄ±dÄ±r. \n AltÄ±n para birimi ISO4217âye uygun biÃ§imde âXAUâ cinsinde ve virgÃ¼lden sonra 2 basamak olacak Åekilde iletilmelidir. ÃrneÄin iÃ§erisinde "13,5 gr" altÄ±n olan hesap iÃ§in bakiye 1350 gÃ¶nderilmelidir. \n 3.8.\tÄ°stemci Sertifika YÃ¶netimi \n ÃHVPS kapsamÄ±nda YÃS ve HHSâlerin gÃ¼venli bir Åekilde tanÄ±mlanmasÄ± amacÄ±yla elektronik sertifikalar kullanÄ±lÄ±r. \n ÃHVPS kapsamÄ±nda taraflarÄ±n gÃ¼venli bir Åekilde tanÄ±mlamasÄ±, uÃ§tan uca gÃ¼venli iletiÅim, mesaj Åifreleme ve mesaj imzalama iÅlevleri 15/1/2004 tarihli ve 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunuânda aÃ§Ä±klanan elektronik sertifikalar kullanÄ±larak saÄlanÄ±r. Elektronik sertifikada TÃ¼rkiye Cumhuriyet Merkez BankasÄ± tarafÄ±ndan verilen kuruluÅ kodu ve kuruluÅun tÃ¼rÃ¼ne dair bilgiler bulunur. \n BKM API GeÃ§idi Ã¼zerinden yapÄ±lan eriÅimlerde YÃS ve HHSâlere Ã¶nceden daÄÄ±tÄ±lmÄ±Å olan istemci sertifikalarÄ± kullanÄ±larak taraflarÄ±n (sunucu) kimliklerinin doÄrulanmasÄ± saÄlanacaktÄ±r. Ä°stemci sertifikalarÄ± hem test hem de Ã¼retim ortamÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi sertifikasyon sÃ¼recinde de sÄ±nanacaktÄ±r. SÃ¶z konusu sertifikalarÄ±n daÄÄ±tÄ±m prosedÃ¼rleri ve kullanÄ±mlara yÃ¶nelik aÃ§Ä±klamalar EK-3âte yer verilmiÅtir. \n 3.9.\tYetkilendirme TÃ¼rleri \n BKM API GeÃ§idi Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda iki temel yetkilendirme tÃ¼rÃ¼ kullanÄ±lÄ±r: \n 1.\tÄ°stemci Kimlik Bilgileri:  MÃ¼Återi onayÄ±nÄ±n gerekmediÄi, sadece YÃSâÃ¼n tanÄ±mlanÄ±p doÄrulandÄ±ÄÄ± API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. YÃSâÃ¼n yetkilendirilmiÅ olduÄu ve faaliyet izninin yaptÄ±ÄÄ± hizmet Ã§aÄrÄ±sÄ±na uygun olduÄu kontrol edilir.  Bu amaÃ§la, YÃSâlere clientId ve clientSecret tahsis edilecektir. YÃSâler ilgili clientId ve clientSecret ile sadece yetkilendirilmiÅ olduklarÄ± servislere eriÅebileceklerdir. YÃSâler kendilerine BKM tarafÄ±ndan sunulacak APIâyi, kendi clientID ve clientSecret deÄerleri ile sorgulayarak âÄ°stemci Kimlik Bilgileriâ belirtecini (access token) elde edeceklerdir.\nHHSâler de BKM API geÃ§idi Ã¼zerindeki YÃS APIâsini sorgulama maksadÄ± ile BKM API GeÃ§idine geldiklerinde, kendilerine atanmÄ±Å olan clientID ve clientSecret bilgileri ile yetki kontrolleri yapÄ±lÄ±r.\nHHSâler kendilerinden alÄ±nacak username ve password deÄerleri kullanÄ±larak oluÅturulacak basic authentication metodu ile servislerini sunacaklardÄ±r. \n 2.\tYetkilendirme Kodu:  YÃSâÃ¼n doÄrulanmasÄ±nÄ±n yanÄ±sÄ±ra mÃ¼Återinin GKD ile doÄrulanmasÄ± gereken API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. MÃ¼Återi doÄrulanarak yetkilendirme kodu oluÅturulmasÄ± HHSânin yetkilendirme arayÃ¼zÃ¼ne yÃ¶nlendirilir. GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda yetkilendirme kodu YÃSâe dÃ¶nÃ¼lÃ¼r. YÃS daha sonra HHSânin  eriÅim belirteci  (access token) eriÅim adresini (EK-3: POST /erisim-belirteci) Ã§aÄÄ±rmak suretiyle yetkilendirme kodunu bir eriÅim belirteci (access token) ile deÄiÅtirerek ilgili kaynaklarÄ± kullanabilir. \n Ãdeme emri baÅlatma ve hesap bilgisi hizmetlerinde hangi yetkilendirme tÃ¼rlerinin kullanÄ±lacaÄÄ± bilgisi, ilgili baÅlÄ±klardaki eriÅim adresleri (endpoints) tablolarÄ±nda yer almaktadÄ±r. \n erisim-belirteci  erisim noktasÄ±ndan elde edilen  erisimBelirteci  iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda  x-access-token  alanÄ±nda iletilir.\nBelirli bir sÃ¼re iÃ§in tanÄ±mlanan eriÅim belirteci (access token) deÄerinin yenileme belirteci (refresh token) ile yenilenmesi gerekir. \n EriÅim adreslerinde kullanÄ±lan yetkilendirme tÃ¼rÃ¼ ilgili eriÅim adresi tablolarÄ±nda belirtilmiÅtir. \n 3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ± \n Ä°stek ve Cevap mesajlarÄ±nda kullanÄ±lacak olan nesneler tÃ¼m elemanlarÄ±nÄ± kapsayacak Åekilde Ek-1 de listelenmiÅtir. TÃ¼m listelenen elemanlar aÃ§Ä±sÄ±ndan (UÃ§ nokta mesaj yapÄ±larÄ±nÄ±n belirtildiÄi tablolarda belirtildiÄi Ã¼zere) alanÄ±n Zorunlu (z) veya Ä°steÄe BaÄlÄ± (Ä°) olma durumlarÄ±na gÃ¶re bazÄ± alanlar gÃ¶nderilebilir veya gÃ¶nderilmeyebilir. \n 3.11. SayfalandÄ±rma ve Filtreleme \n SayfalandÄ±rma \n ÃaÄrÄ±ya dÃ¶nÃ¼len kaynak nesnesi iÃ§erisindeki kayÄ±tlar bir sayfalandÄ±rma yapÄ±sÄ± ile Ã§

16aÄrÄ±lacak Åekilde istek oluÅturulur. \n OluÅturulacak isteÄin iÃ§erisinde parametreler ile filtreleme, sayfa baÅÄ±na gÃ¶sterilecek kayÄ±t sayÄ±sÄ± ve hangi sayfanÄ±n Ã¶nyÃ¼zde gÃ¶sterileceÄi bilgileri eriÅim noktasÄ±na iletilir ve ilgili kayÄ±tlar cevap olarak alÄ±nÄ±r. \n Filtreleme \n HHS, birden Ã§ok kayÄ±t dÃ¶nÃ¼lmesi gereken GET Ã§aÄrÄ±larÄ±nda sÄ±nÄ±rlÄ± filtreleme desteÄi saÄlamalÄ±dÄ±r. Filtre parametreleri her zaman kaynak nesnesinin belirli alanlarÄ±na Ã¶zgÃ¼dÃ¼r ve nesne iÃ§in tanÄ±mlanan kurallara uymalÄ±dÄ±r. \n 3.12. Mesaj Ä°mzalama \n Elektronik imzalar, ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini destekler. Ä°mzalarÄ±n kaynak bazÄ±nda hangi istek ve yanÄ±tlara uygulandÄ±ÄÄ± belirlidir. \n API yalnÄ±zca TLS\'ye dayanÄ±rsa, dijital kayÄ±tlarÄ± ve inkÃ¢r edilemezlik kanÄ±tlarÄ±nÄ± tutmak zor olur. Bu nedenle, TLS\'ye dayanmayan bir inkÃ¢r edilemezlik Ã§Ã¶zÃ¼mÃ¼ olarak API isteÄinin HTTP baÅlÄ±ÄÄ±nda bir JWS kullanÄ±larak saÄlanabilir. \n HTTP isteÄinin gÃ¶vdesinin hash fonksiyonu (SHA256) ile Ã¶zeti alÄ±nacaktÄ±r. Elde edilen Ã¶zet, asimetrik anahtarlarÄ± destekleyen bir algoritma kullanÄ±larak imzalanacak ve JWS elde edilecektir. \n Bir istek, YÃS\'nin Ã¶zel anahtarÄ± ile imzalanacak ve bu isteÄe karÅÄ±lÄ±k gelen yanÄ±t, HHS\'nin Ã¶zel anahtarÄ± tarafÄ±ndan imzalanacaktÄ±r. \n TÃ¼m API istekleri ve yanÄ±tlarÄ± imzalanmaz. Mesaj imzalamanÄ±n zorunlu olup olmadÄ±ÄÄ±, desteklenip desteklenmediÄi her API Ã¶zelinde belirlenir. \n Anahtar Deposu \n HHS\'ler ve YÃS\'ler tarafÄ±ndan gÃ¼venilen bir GÃ¼ven Otoritesi (Trust Anchor), taraflar iÃ§in bir genel anahtar deposu saÄlamaktan sorumludur. \n GÃ¼ven Otoritesi, taraflardan herhangi birisinin oluÅturduÄu bir anahtar Ã§iftinin aÃ§Ä±k bÃ¶lÃ¼mÃ¼nÃ¼ saklayan merkezi bir dizin (BKM tarafÄ±ndan tutulan merkezi kayÄ±t sistemi vb.) olacaktÄ±r. \n MesajlarÄ± doÄrulamak iÃ§in taraflarÄ±n genel anahtarlarÄ±nÄ±n paylaÅÄ±lmasÄ± iÃ§in BKM bir servis saÄlayacaktÄ±r. HHS API olarak adlandÄ±rÄ±lÄ±mÄ±Å olan bu servis ile HHS ve YÃS listelerine ulaÅÄ±labildiÄi gibi doÄrulama iÅlemi iÃ§in ihtiyaÃ§ duyulacak olan genel anahtarlara da bu servis Ã¼zerinden eriÅilebilinecektir. \n Ä°lgili Mesaj Åifreleme iÃ§in genel akÄ±Å, Ek-5 bÃ¶lÃ¼mÃ¼nde detaylarÄ±yla paylaÅÄ±lmaktadÄ±r. \n 3.13. Durum Kodu \n APIâler, iki farklÄ± amaca hizmet eden iki durum kodu kullanÄ±r: \n \n HTTP Durum Kodu, API Ã§aÄrÄ±sÄ±nÄ±n (kaynaktaki HTTP iÅlemi) sonucunu yansÄ±tÄ±r. \n BazÄ± kaynak payloadâlarÄ±ndaki Durum alanÄ±, kaynaklarÄ±n durumunu yansÄ±tÄ±r. \n 3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ± \n EriÅim adreslerinin ve alanlarÄ±n kullanÄ±mÄ± Zorunlu(Z), Ä°steÄe BaÄlÄ±(Ä°) veya KoÅullu(K) olabilir. KullanÄ±mlara iliÅkin durumlar ve kullanÄ±mÄ±n (K) koÅullu olduÄu duruma iliÅkin aÃ§Ä±klamalar ilgili tablolarda belirtilmiÅtir. \n Ä°stek ve yanÄ±tta kullanÄ±lacak baÅlÄ±k isimleri, ilgili RFC dokÃ¼manlarÄ±nda ve aÅaÄÄ±daki tabloda yer aldÄ±ÄÄ± Åekilde kullanÄ±lacaktÄ±r.  Uygulamaya Ã¶zelleÅmiÅ baÅlÄ±klar "X-" ile baÅlayacaktÄ±r. BaÅlÄ±k isimlerinde yer alacak kÄ±saltmalar (Ã¶rn. PSU, ASPSP gibi) tamamÄ± bÃ¼yÃ¼k harfle yazÄ±lacak Åekilde tanÄ±mlanacaktÄ±r. BaÅlÄ±k isimleri bÃ¼yÃ¼k â kÃ¼Ã§Ã¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin x-request-id ya da X-Request-ID olarak gÃ¶nderilmiÅ olan bir istek baÅlÄ±ÄÄ± deÄiÅkeni, sunucu tarafÄ±nda hata vermeyecek Åekilde iÅlenebilmelidir. \n 3.15. Ä°stek BaÅlÄ±ÄÄ± \n Tablo 2: Ä°stek BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n POST \n GET \n DELETE \n \n \n \n \n X-Request-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±.   Ãrnek: Ãdeme emri baÅlatma iÅ akÄ±ÅÄ±nÄ±n her adÄ±mda farklÄ± âx-request-idâ deÄeri kullanÄ±lÄ±r.   ÃaÄrÄ±larÄ±n aynÄ± yanÄ±tÄ± dÃ¶nmesinin beklendiÄi durumlarda (idempotent iÅlemlerde) aynÄ± deÄer ile Ã§aÄrÄ± yapÄ±lÄ±r. \n Z \n Z \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±.  AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± x-group-id bilgisi deÄeri gÃ¶nderilmelidir. Ãrnek: Ãdeme emri baÅlatma/hesap bilgisi iÅ akÄ±ÅÄ±nÄ±n her adÄ±mÄ±nda aynÄ± âx-group-idâ deÄeri kullanÄ±lÄ±r. \n Z \n Z \n Z \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder: application/json  (BaÅka bir deÄere ayarlanÄ±rsa, HHS, 415 Desteklenmeyen Ortam TÃ¼rÃ¼ (Unsupported Media Type) ile yanÄ±t vermelidir) \n Ä° \n - \n

16- \n \n \n X-ASPSP-Code \n AN4 \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n Z \n Z \n \n \n X-TPP-Code \n AN4 \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n Z \n Z \n \n \n PSU-Auth-Date \n ISODateTime \n ÃHKânÄ±n YÃS Ã¼zerinde en son oturum aÃ§tÄ±ÄÄ± saat. [RFC7231] ÃrneÄin:  auth-date: Tue, 11 Sep 2012 19:43:31 GMT \n Ä° \n Ä° \n Ä° \n \n \n PSU-IP-Adress \n AN7..15 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n IP adresi. \n Ä° \n Ä° \n Ä° \n \n \n PSU-IP-Port \n AN1..5 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n Port adresi. \n Ä° \n Ä° \n Ä° \n \n \n PSU-GEO-Location \n AN1..36 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n konum bilgisi. RFC2426 standartÄ±na uygun olarak paylaÅÄ±lmalÄ±dÄ±r. ÃrneÄin  GEO:"<enlem >, <boylam>GEO:52.506931,13.144558 \n Ä° \n Ä° \n Ä° \n \n \n PSU-User-Agent \n AN 1.. 255 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n saÄladÄ±ÄÄ± user-agent bilgisi. (TarayÄ±cÄ±, versiyon, iÅletim sistemi bilgileri) \n Ä° \n Ä° \n Ä° \n \n \n PSU-Timestamp \n ISODateTime \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n tarih saat iÃ§eren zaman bilgisi. \n Ä° \n Ä° \n Ä° \n \n \n PSU-Device-ID \n AN5..40 \n ÃHK iÅlemi mobil uygulama aracÄ±lÄ±ÄÄ±yla baÅlattÄ±ysa, kullanÄ±lan mobil uygulama ilk yÃ¼klendiÄinde oluÅturulan tekil cihaz veya uygulama belirteci. ÃHK cihazÄ±nÄ±n UUID deÄeri kullanÄ±labilir. \n Ä° \n Ä° \n Ä° \n \n \n PSU-Device-Data \n AN1..1024 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± mobil cihaza ait veriler.  Ãrnek alanlar:   - Platform - (Android, iOS, Windows 10 Mobile)  - Device Model   - OS Name   - OS Version - Locale - Time zone \n Ä° \n Ä° \n Ä° \n \n \n PSU-Initiated \n AN1 \n Ä°Ålemin ÃHK tarafÄ±ndan baÅlatÄ±lmasÄ± durumunda E , sistem tarafÄ±ndan baÅlatÄ±ldÄ±ÄÄ± durumda H deÄerini almasÄ± beklenir.   Ä°Ålemler servisinde yapÄ±lacak sistemsel sorgulardaki iÅlem limitlerini kontrol amacÄ±yla kullanÄ±lÄ±r. \n Z \n Z \n Z \n \n \n Authorization \n AN1..4096 \n YÃS ile BKM API Gateway arasÄ±ndaki otorizasyon iÃ§in kullanÄ±lan token bilgisidir.  Yekilendirme tÃ¼rlerinden Ä°stemci Kimlik Bilgileriâni adresler. \n Z \n Z \n Z \n \n \n X-Access-Token \n AN1..4096 \n ÃHKânÄ±n GKD sÃ¼recinde doÄrulanmasÄ± sonrasÄ±nda kullanÄ±lan eriÅim simgesi. Yetkilendirme tÃ¼rlerinden Yetkilendirme Kodu (GKD)ânu adresler. \n Ä° \n Ä° \n Ä° \n \n \n X-JWS-Signature \n AN1..4096 \n Payload gÃ¶vdesinin ayrÄ±lmÄ±Å bir JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi.  Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir. \n K (KullanÄ±lan API ve methoda gÃ¶re kullanÄ±lÄ±r.) \n K \n K \n 3.16. YanÄ±t BaÅlÄ±ÄÄ± \n Tablo 3: YanÄ±t BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n KullanÄ±m Durumu \n \n \n \n \n X-Request-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±    Ä°lgili istek baÅlÄ±ÄÄ±ndaki bilgi geri dÃ¶nÃ¼lÃ¼r. \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±. Ä°lgili istek baÅlÄ±ÄÄ±ndaki bu deÄer geri dÃ¶nÃ¼lÃ¼r. \n Z \n \n \n X-ASPSP-Code \n AN4 \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n \n \n X-TPP-Code \n AN4 \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder:  application/json \n Ä° \n \n \n X-JWS-Signature \n AN1..4096 \n JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n hangi yanÄ±tlar iÃ§in kullanÄ±lmasÄ± gerektiÄi ilgili endpoint iÃ§in belirtilmiÅtir. \n K \n \n \n Retry-After \n AN 1..255 \n YÃSâÃ¼n bir isteÄi yeniden denemeden Ã¶nce beklemesi gereken sÃ¼reyi (saniye cinsinden) gÃ¶sterir. HHS, 429 HTTP durum ko

16du (Too Many Requests) ile dÃ¶ndÃ¼ÄÃ¼ yanÄ±tlarÄ±n baÅlÄ±ÄÄ±nda bu bilgiyi dÃ¶nmelidir. \n K \n \n \n x-total-count \n N 1..18 \n Hesaplar, Ä°Ålemler ve Bakiye servislerinde sayfalama kullanÄ±ldÄ±ÄÄ± durumda, sorgu sonucu dÃ¶necek toplam kayÄ±t sayÄ±sÄ± bilgisi, bu alanda HHS isteÄine baÄlÄ± olarak gÃ¶nderilebilir. \n Ä° \n \n \n Link \n 1..4096 \n âLinkâ alanÄ±nÄ±n Ã§oklu sayfa yapÄ±sÄ± olmasÄ± durumunda gÃ¶nderilmesi zorunludur.  Sayfalama yapÄ±sÄ± kullanÄ±ldÄ±ÄÄ±nda gelen yanÄ±tta birden fazla sayfa var ise; Ã¶nceki, sonraki, ilk, son sayfalara gitmek iÃ§in gerekli referanslar link headerÄ±nda aÅaÄÄ±daki Ã¶rnekteki gibi doldurulabilir.  x-total-count alanÄ±nÄ±n gÃ¶nderimi isteÄe baÄlÄ± olduÄu iÃ§in; Link iÃ§erisindeki son sayfa bilgisi  (last) isteÄe baÄlÄ± hale getirilmiÅtir. âÃncekiâ( prev) ve âSonrakiâ (next) adÄ±mlarÄ±nÄ±n uygun olan her durumda yer almasÄ± zorunludur. Ä°lk sayfada âÃncekiâ seÃ§eneÄi olmamalÄ±, son sayfada ise âSonrakiâ seÃ§eneÄi olmamalÄ±dÄ±r.    </ohvps/hbh/s1.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=6&syfKytSayi=100>; rel="next",  </ohvps/hbh/s1.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=4&syfKytSayi=100>; rel="prev",  </ohvps/hbh/s1.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=14&syfKytSayi=100>; rel="last",  </ohvps/hbh/s1.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=0&syfKytSayi=100>; rel="first" \n K \n 3.17. Idempotency KurallarÄ± \n YÃSâÃ¼n aÅaÄÄ±daki durumlarda aynÄ± istek numarasÄ± (x-request-id) ve aynÄ± veri gÃ¶vdesiyle Ã§aÄrÄ±yÄ± tekrarlamasÄ±; HHSânin de bu durumlarda aynÄ± yanÄ±tÄ± dÃ¶nmesi gereklidir. \n \n HHSânin yanÄ±tÄ± kesinti/arÄ±za nedeniyle YÃSâe ulaÅmaz ve zaman aÅÄ±mÄ± sÃ¶z konusu olmasÄ±, \n ÃHK, YÃS uygulamasÄ± Ã¼zerinden Ã§ift tÄ±klama ile mÃ¼kerrer defa HHS APIâlerini Ã§aÄÄ±rÄ±lmasÄ±,\n(API kontrollerinden Ã¶nce YÃS uygulamasÄ±nÄ±n, Ã§ift tÄ±klama kontrolÃ¼ yapmasÄ± Ã¶nerilmektedir.) \n YÃS, yanÄ±t almasÄ±na raÄmen iÅleyemeden kaybedilmesi, \n \n durumlarÄ±nda HHS aÅaÄÄ±daki kurallarÄ± iÅletir: \n \n HHS gelen istek numarasÄ±nÄ± ve veri gÃ¶vdesini birleÅtirerek checksum deÄeri Ã¼retir. \nchesksum deÄeri x-request-id|request.body ânin hash algoritmalarÄ±ndan (CRC32,MD5 vb)  geÃ§irilerek Ã¼retilebilir. \n HHS bu checksum deÄeri ile YÃSâe dÃ¶nmÃ¼Å olduÄu yanÄ±tÄ± 5 dk boyunca saklar.  Saklama yÃ¶ntemi olarak veri tabanÄ± veya Ã¶nbellek araÃ§larÄ± kullanÄ±labilir. \n YÃS aynÄ± istek numarasÄ± ve aynÄ± veri gÃ¶vdesi ile yeni bir Ã§aÄrÄ± yaptÄ±ÄÄ±nda, aynÄ± checksum deÄeri Ã¼retileceÄi iÃ§in 5dk boyunca bu deÄere karÅÄ±lÄ±k gelen yanÄ±tÄ± dÃ¶ner. \n 5 dk sonrasÄ±nda istek numarasÄ± veya veri gÃ¶vdesi deÄiÅmemiÅ olsa dahi bu HHS tarafÄ±ndan yeni istek olarak kabul edilir. \n \n AÅaÄÄ±daki Public Post iÅlemleri iÃ§in bu kural setinin iÅletilmesi gerekmektedir: \n 1- Ãdeme emri rÄ±zasÄ± oluÅturma \n2- EriÅim belirteci oluÅturma \n3- Ãdeme emri \n4- Hesap bilgisi rÄ±zasÄ± oluÅturma \n 3.18. HTTP Durum KodlarÄ± \n RFC 2616\'da belirlenmiÅ olan durum kodlarÄ± (status code) gÃ¶nderilen isteÄin durumunu YÃSâa standart bir Åekilde ifade eder. EÄer bir hata varsa hatayÄ±, gÃ¶nderilen istek baÅarÄ±lÄ± bir Åekilde iÅlem gÃ¶rdÃ¼yse ona iliÅkin durumu aktarÄ±r. Durum kodlarÄ± genel olarak 5 kategoridedir. \n \n 1xx Bilgi \n 2xx BaÅarÄ±lÄ± \n 3xx YÃ¶nlendirme \n 4xx Ä°stemci HatasÄ± \n 5xx Sunucu HatasÄ± \n \n SÄ±ralÄ± (Enumarated) Hata Tipleri: \n \n TR.OHVPS.Resource \n \n â¨\tInvalidFormat \n â¨\tConsentMismatch \n â¨\tNotFound \n â¨\tInvalidSignature \n â¨\tMissingSignature \n â¨\tMethodNotAllowed \n â¨\tNotAcceptable \n â¨\tUnsupportedMediaType \n â¨\tConsentRevoked \n \n \n \n TR.OHVPS.Business \n \n â¨\tInvalidContent \n â¨\tInvalidAccount \n \n \n \n TR.OHVPS.Connection \n \n â¨\tInvalidCertificate \n â¨\tExceededRate \n â¨\tInvalidTPP \n â¨\tInvalidASPSP \n â¨\tInvalidToken \n â¨\tInvalidTPPRole \n \n \n \n TR.OHVPS.Server \n \n â¨\tInternalError \n â¨\tServiceUnavailable \n \n \n TR.OHVPS.Resource.InvalidFormat hatasÄ± alÄ±ndÄ±ÄÄ± durumda; fieldErrors nesnesi iÃ§erisinde verilecek hata kodlarÄ± : \n \n TR.OHVPS.Field \n \n â¨\tMissing \n â¨\tInvalid \n \n \n Veri Tipi ÃrneÄi: \n { \n   "id" :   "2b5f0fb2-730b-11e8-adc0-fa7ae01bbebc" , \n   "path" :   "/ohvps/s1.1/obh/odeme-emri-rizasi" , \n   "timestamp" :   "2020-06-13T18:24

16:38" , \n   "httpCode" :   400 , \n   "httpMessage" :   "Bad Request" , \n   "moreInformation" :   "Resource Schema validation error" , \n   "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n    "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" , \n   \n   "fieldErrors" :   [ \n            { \n                  "objectName" :   "odemeEmriRizasi" , \n                  "field" :   "kmlkNo" , \n                  "messageTr" :   "boyut \'6\' ile \'30\' arasÄ±nda olmalÄ±" , \n                  "message" :   "size must be between \'6\' and \'30\'" , \n                  "code" :   "TR.OHVPS.Field.Invalid" \n               } , \n               { \n                  "objectName" :   "odemeEmriRizasi" , \n                   "field" :   "prBrm" , \n                   "messageTr" :   "boÅ deÄer olamaz" , \n                   "message" :   "must not be null" , \n                   "code" :   "TR.OHVPS.Field.Missing" \n               } ] \n } \n \n Veri Tipi ÃrneÄi: \n Zorunlu header alanlarÄ±ndan biri ya da birkaÃ§Ä± eksik olarak gÃ¶nderilirse aÅaÄÄ±daki gibi bir hata dÃ¶nÃ¼ÅÃ¼ gerÃ§ekleÅebilir. \n \n { \n     "httpCode" :   "400" , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "One or more required API parameters are missing in the API request." \n } \n\n \n Tablo 4: HTTP Durum KodlarÄ± \n \n \n \n HTTP Durum \n Ä°stek Sonucu ve AÃ§Ä±klamalar \n POST \n GET \n DELETE \n \n \n \n \n 200 OK \n Ä°stek BaÅarÄ±yla TamamlandÄ±. Kaynak gÃ¼ncellemek iÃ§in yapÄ±lan (Ã¶rneÄin, PUT) ve baÅarÄ±yla tamamlanan isteklerinde kullanÄ±lÄ±r. \n H \n H \n H \n \n \n 201 Created \n Ä°stek BaÅarÄ±lÄ± Oldu. Kaynak yaratma isteÄi (Ã¶rneÄin, POST /Ã¶deme-emri-rizasi) baÅarÄ±yla sonuÃ§landÄ±. \n E \n H \n H \n \n \n 204 No Content \n Silme iÅlemi baÅarÄ±yla tamamlandÄ±. Kaynak silme isteÄi (Ã¶rneÄin,  DELETE /hesap-rizasi/{RizaNo} ) baÅarÄ±yla sonuÃ§landÄ±. \n H \n H \n E \n \n \n 400 Bad Request \n Ä°stekte bozuk, eksik veya uyumlu olmayan JSON gÃ¶vdesi, URL parametreleri veya baÅlÄ±k alanlarÄ± var.  Ä°stekle baÅlatÄ±lan iÅlem yapÄ±sal bozukluk, eksik veya tutarsÄ±z veri veya HHS tarafÄ±ndaki kontrollerin hatalÄ± sonuÃ§lanmasÄ± nedeniyle hata ile sonuÃ§lanÄ±r ve hataya iliÅkin veriler hata nesnesi iÃ§erisinde dÃ¶nÃ¼lÃ¼r. \n E \n E \n E \n \n \n 401 Unauthorized \n Yetkilendirme baÅlÄ±ÄÄ± eksik, hatalÄ± veya geÃ§ersiz olduÄundan istek yetkilendirilmediÄinde ve eriÅim reddedildiÄinde http 401 kodu dÃ¶nÃ¼lmelidir. \n E \n E \n E \n \n \n 403 Forbidden \n EriÅim belirtecinin veya rÄ±zanÄ±n kapsamÄ± uyuÅmuyor. YÃS bir hesaba/iÅlem kaynaÄÄ±na eriÅmeye Ã§alÄ±ÅÄ±r ve YÃS, istenen kaynaÄa eriÅmek iÃ§in geÃ§erli izinlere sahip bir rÄ±zasÄ± yoktur.  ÃrneÄin; hesap bilgisi rÄ±zasÄ± bakiye izni almamÄ±ÅtÄ±r ancak /bakiyeler adresinden istekte bulunmuÅtur. \n \n \n \n \n \n 404 Not Found \n **HHS geÃ§erli bir API eriÅim adresini saÄlamÄ±yorsa, o URL\'ye gelen istekler iÃ§in 404 (BulunamadÄ±) ile yanÄ±t vermelidir.**YÃS, uygulama esaslarÄ±nda tanÄ±mlanmayan bir

16kaynak iÃ§in bir URL\'ye eriÅmeye Ã§alÄ±ÅÄ±rsa (Ã¶rneÄin, GET /yurtdisi-odeme), HHS, 404 (BulunamadÄ±) ile yanÄ±t vermeyi seÃ§ebilir. \n E \n E \n E \n \n \n 405 Method Not Allowed \n YÃS, desteklenmeyen bir yÃ¶ntemle kaynaÄa eriÅmeye Ã§alÄ±ÅtÄ±. \n E \n E \n E \n \n \n 406 Not Acceptable \n Ä°stek, geÃ§ersiz bir karakter kÃ¼mesi iÃ§eriyor. \n E \n E \n E \n \n \n 415 Unsupported Media Type \n Ä°stek gÃ¶vdesi hedef kaynakta bu yÃ¶ntem tarafÄ±ndan desteklenmeyen bir biÃ§imde oluÅturulduÄu iÃ§in iÅlem reddedildi \n E \n H \n H \n \n \n 429 Too Many Requests \n Belirli bir sÃ¼re iÃ§inde Ã§ok fazla talepte bulunulduÄu iÃ§in iÅlem reddedildi.  HHSâler adil kullanÄ±m politikalarÄ±nÄ± aÅan talepleri kÄ±sÄ±tlayabilir. \n E \n E \n E \n \n \n 500 Internal Server Error \n API sunucu / servis katmanÄ±nda sorun oluÅtu. Ä°Ålem baÅarÄ±sÄ±z. \n E \n E \n E \n \n \n 503 Service Unavailable \n Hizmet sÃ¼rÃ¼mÃ¼ kullanÄ±mdan kaldÄ±rÄ±ldÄ±.  Bir API\'nin kullanÄ±mdan kaldÄ±rÄ±ldÄ±ÄÄ± ve artÄ±k bir HHS tarafÄ±ndan operasyonel olarak desteklenmediÄi durumlarda, URI yolu hala etkin olabilir ve API isteklerini kabul edebilir.  Bu durumda, YÃS\'Ã¼n API sÃ¼rÃ¼mÃ¼nÃ¼n Ã§evrimdÄ±ÅÄ± olduÄunun farkÄ±nda olmasÄ± iÃ§in 503 Hizmet KullanÄ±lamÄ±yor dÃ¶nmesi Ã¶nerilir. \n E \n E \n E \n \n \n \n Hata Ãrnekleri: \n 400 Bad Request \n TR.OHVPS.Business.InvalidContent  hatasÄ± HHS tarafÄ±ndan yapÄ±lacak iÅ kuralÄ± kontrollerinin baÅarÄ±sÄ±z olduÄu durumda verilmelidir. \n TR.OHVPS.Resource.InvalidFormat  hatasÄ± Åema validasyonu, alan uzunluk ve varlÄ±k kontrollerinin baÅarÄ±sÄ±z olduÄu durumda verilmelidir. \n httpCode :   400 \nhttpMessage :  âBad Requestâ\nmoreInformation :  âResource Schema validation errorâ\nmoreInformationTr :  âÅema Kontrolleri BaÅarÄ±sÄ±zâ \nerrorCode :   "TR.OHVPS.Resource.InvalidFormat" \n\nfieldErrors :   \n         code :   { "TR.OHVPS.Field.Invalid" , \n                     "TR.OHVPS.Field.Missing" } \n\n \n Ãrn; GET /odeme-emri/22289 Ã§aÄrÄ±sÄ± durumunda 22289 geÃ§erli bir Ã¶deme kaynaÄÄ± deÄilse, HHS, 400 koduyla cevap vermelidir. \n { \n   "id" :   "2b5f0fb2-730b-11e8-adc0-fa7ae01bbebc" , \n   "path" :   "/ohvps/s1.1/obh/odeme-emri-rizasi" , \n   "timestamp" :   "2020-06-13T18:24:38" , \n   "httpCode" :   400 , \n   "httpMessage" :   "Bad Request" , \n   "moreInformation" :   "Resource Schema validation error" , \n   "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n    "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" , \n   \n   "fieldErrors" :   [ \n { \n "objectName" :   "odemeEmriRizasi" , \n "field" :   "kmlkNo" , \n "messageTr" :   "boyut \'6\' ile \'30\' arasÄ±nda olmalÄ±" , \n "message" :   "size must be between \'6\' and \'30\'" , \n "code" :   "TR.OHVPS.Field.Invalid" \n } , \n { \n "objectName" :   "odemeEmriRizasi" , \n  "field" :   "prBrm" , \n  "messageTr" :   "boÅ deÄer olamaz" , \n  "message" :   "must not be null" , \n  "code" :   "TR.OHVPS.Field.Missing" \n } \n ] \n } \n\n\nerrorCode :   "TR.OHVPS.Connection.InvalidTPP" \nmoreInformation :  âInvalid TPP Codeâ\nmoreInformationTr :  âGeÃ§ersiz YÃ¶s Koduâ \n\nerrorCode :   "TR.OHVPS.Connection.InvalidASPSP" \nmoreInformation :  âInvalid ASPSP Codeâ\nmoreInformationTr :  âGeÃ§ersiz HHS Koduâ \n\nerrorCode :   "TR.OHVPS.Connection. InvalidTPPRole" \nmoreInformation :  âInvalid TPP Roleâ \nmoreInformationTr :  âHatalÄ± YÃ¶s RolÃ¼â \n \n 401 Unauthorized \n YÃS, sÃ¼resi dolmuÅ bir eriÅim belirteci kullandÄ±ÄÄ±nda, HHS 401 (Yetkisiz) http kodu ile aÅaÄÄ±daki hata kodunu dÃ¶nmelidir.  AÅaÄÄ±daki nedenlerden herhangi biri nedeniyle bir EriÅim Belirtecinin sÃ¼resi dolduÄunda bu durum ortaya Ã§Ä±kabilir: \n \n RÄ±zanÄ±n sÃ¼resi doldu (Son Kullanma Tarihi geÃ§ti) \n EriÅim Belirtecinin ÅÃ¼pheli kullanÄ±mÄ± veya sahtekarlÄ±k ÅÃ¼phesi \n RÄ±zada belirlenen gÃ¼n sayÄ±sÄ±nÄ±n aÅÄ±mÄ±\nBu hata, mÃ¼Återiden doÄru izinlerle yeniden kimlik doÄrulamasÄ± isteyerek Ã§Ã¶zÃ¼lebilir. \n \n errorCode :   " TR.OHVPS.Connection.InvalidToken " \nmoreInformation :  âInvalid Tokenâ\nmoreInformationTr :  âGeÃ§ersiz Tokenâ \n \n 403 Forbidden \n httpCode :   403 \nhttpMessage :  âForbiddenâ\n\nerrorCode :   "TR.OHVPS.Resource.Forbidden" \nmoreInformation :  âInsufficient rightsâ\nmoreInformationTr :  âÄ°zin verilmedi.â\n \n 404 Not Found \n httpCode :   404 \nhttpMessage :  âNot Foundâ\n\nerrorCode :   "TR.OHVPS.Resource.NotFound" \nmoreInformation :  âResource not foundâ\nmoreInformationTr :  âKayÄ±t bulunamadÄ±â\n \n 405 Method Not Allowed \n httpCode :   405 \nhttpMessage :  âMethod  Not Foundâ\n\nerrorCode :   "TR.OHVPS.Resource.MethodNotAllowed" \nmoreInformation :  âMethod Not Allowedâ\nmoreInformationTr :  âÄ°stek yapÄ±lan URL iÃ§in izin verilmeyen metotâ \n \n 406 Not Acceptable \n httpCode :   406 \nhttpMessage :  âNot Acceptableâ\n\nerrorCode :   " TR.OHVPS.Resource.NotAcceptable" \nmoreInformation :  âAccept Headers not supportedâ\nmoreInformationTr :  âDesteklenmeyen kabul baÅlÄ±klarÄ±â \n \n 415 Unsupported Media Type \n httpCode :   415 \nhttpMessage :  âUnsupported Media Typeâ\n\nerrorCode :   " TR.OHVPS.Resource.UnsupportedMediaType" \nmoreInformation :  âContent type not supportedâ\nmoreInformationTr :  âDesteklenmeyen iÃ§erik tipiâ \n \n 429 Too Many Requests \n httpCode :   429 \nhttpMessage :  âToo Many Requestsâ\n\nerrorCode :   " TR.OHVPS.Connection.ExceededRate" \nmoreInformation :  âThe rate limit has been exceeded for the plan or operation being usedâ\nmoreInformationTr :  âPlanda tanÄ±mlanmÄ±Å olan Ã§aÄrÄ± limiti aÅÄ±ldÄ±â\n \n 500 Internal Server Error \n httpCode :   500 \nhttpMessage :  âInternal Server Errorâ\n\nerrorCode :   "TR.OHVPS.Server.InternalError" \nmoreInformation :  âUnexpected condition was encounteredâ\nmoreInformationTr :  âBeklenmedik bir durumla karÅÄ±laÅÄ±ldÄ±.â \n \n 503 Service Unavailable \n httpCode :   503 \nhttpMessage :  âService Unavailableâ\n\nerrorCode :   "TR.OHVPS.Server.ServiceUnavailable " \nmoreInformation :  âAPI is currently unable to handle the requestâ\nmoreInformationTr :  âAPI Åu anda isteÄi iÅleyemiyorâ \n 3.19. Maskeleme KurallarÄ± \n Maskeli olarak iletilmesi gereken verilerin maskeleme kurallarÄ± Åu Åekildedir: \n \n IBAN verileri Hesap NumarasÄ± : Ä°lk 4 ve son 4 karakteri aÃ§Ä±k, diÄer karakterler maskeli olmalÄ±dÄ±r. Ãrnek: TR54******************4812 \n Ad-SoyadÄ± / Ticari Unvan : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet â â karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r.\nÃrneÄin: âFATÄ°H SERKAN ERENâ ifadesi âFA *** SE**** ER****â Åeklinde gÃ¶sterilmelidir. \n Tabela UnvanÄ± : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet â â karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r. ÃrneÄin âBANKALARARASI KART MERKEZÄ° ANONÄ°M ÅÄ°RKETÄ°â ifadesi âBA *** KA**

16** ME**** AN**** ÅÄ°****â Åeklinde gÃ¶sterilmelidir. \n YÃSâten girilen unvan ve iban bilgileri Ã¶deme emri rÄ±zasÄ± ve Ã¶deme emri yanÄ±tÄ±nda aÃ§Ä±k dÃ¶nÃ¼lÃ¼r, Kolas akÄ±ÅÄ±nda Ã¶deme emri rÄ±zasÄ± yanÄ±tÄ± ve Ã¶deme emri istek ve yanÄ±tÄ±nda maskeli taÅÄ±nÄ±r. \n 3.20. Fonksiyonel Olmayan Gereksinimler \n \n \n HHSâlerin sunuyor olduklarÄ± servisleri en fazla 3000 ms iÃ§inde yanÄ±t dÃ¶necek Åekilde tasarlamalÄ±dÄ±r. \n \n \n YÃS tarafÄ±ndan kullanÄ±cÄ±nÄ±n baÅlatmadÄ±ÄÄ± otomatize sorgular iÃ§in aÅaÄÄ±daki limitler belirlenmiÅtir. \n \n YÃS, Bireysel ÃHKâlar iÃ§in hesap bazÄ±nda gÃ¼nde en fazla 4 adet sorgulama yapabilir. \n YÃS, Kurumsal ÃHKâlar iÃ§in hesap bazÄ±nda saatte en fazla 12 adet sorgulama yapabilir \nDiÄer taraftan kullanÄ±cÄ±nÄ±n baÅlattÄ±ÄÄ± Hesap Bilgisi Hizmeti kapsamÄ±ndaki sorgular HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde tanÄ±mlanabilir. \n \n \n \n HHSâlerin sunuyor olduklarÄ± servislere sistemin gÃ¼venlik ve sÃ¼rekliliÄini saÄlamak adÄ±na rate limit koyma ihtiyaÃ§larÄ± olur ise, standartlar ve ihtiyaÃ§lara uygun Åekilde bir konfigÃ¼rasyon yapabilirler. Ãr: YÃS - KullanÄ±cÄ± bazÄ±nda gÃ¼nde X sorgu v.b.\nÄ°steÄin kullanÄ±cÄ± tarafÄ±ndan baÅlatÄ±ldÄ±ÄÄ± Request Header iÃ§erisinde yer alan Payment Service User (PSU) alanlarÄ±ndan anlaÅÄ±labilir. \n \n \n HHSâler aynÄ± zamanda servislerin ayakta olup olmadÄ±ÄÄ±na yÃ¶nelik olarak bir healthcheck servisi kurmalÄ±dÄ±r.  HHSâlerin bu servis ile tÃ¼m network ve veritabanÄ± ya da servislerinin ihtiyaÃ§ duyduklarÄ± altyapÄ±sal eriÅimleri modellemeli ve bu servisi BKM ile paylaÅmalarÄ± beklenmektedir. Bu servis dÃ¼zenli olarak BKM tarafÄ±ndan Ã§aÄÄ±rÄ±larak servislerin ayakta olup olmadÄ±klarÄ±nÄ±n kontrolÃ¼nÃ¼n saÄlanmasÄ± planlanmaktadÄ±r. \n \n \n Sunulan her API iÃ§in /health endpointi ile aÅaÄÄ±daki bilgileri vermeleri beklenmektedir. \n GET /{api ismi}/{versiyon}/health \n Ãrnek: \n GET /obh/s1.0/health \n GET /hbh/s1.0/health \n GET /gkd/s1.0/health \n HHS ve YÃS API iÃ§in health servisleri aÅaÄÄ±daki servislerle kontrol edilebilir. \n GET /hhs-api/s1.0/health \n GET /yos-api/s1.0/health \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lmelidir. \nBaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n KoÅullu  / Ä°steÄe BaÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir. \n \n \n \n Health servisinden yanÄ±t alÄ±namamasÄ±, hata almasÄ± ya da status DOWN gelmesi durumunda API Gatewayden istek HHS tarafÄ±na iletilmeyecektir. \n \n \n ÃHVPS servisleri ile ilgili olarak HHSâler, BKM tarafÄ±ndan dÃ¼zenli olarak sorgulanacaktÄ±r, eriÅilebilirlik ve kullanÄ±m oranlarÄ± takip edilecektir. \n \n \n HHSâlerin servislerini eriÅim yÃ¼zdeleri aÃ§Ä±sÄ±ndan yÄ±l bazÄ±nda %99.75 oranÄ±nda ayakta olmalarÄ±nÄ± saÄlayacak Åekilde kurgulamalarÄ± gerekmektedir. \n \n \n'},{title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",frontmatter:{},regularPath:"/v1.0.2/contents/ekler.html",relativePath:"v1.0.2/contents/ekler.md",key:"v-bc107546",path:"/v1.0.2/contents/ekler.html",headers:[{level:2,title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",slug:"ek-1-istek-cevap-mesajlarÄ±nda-kullanÄ±lacak-nesne-yapÄ±larÄ±"},{level:2,title:"EK-2: SÄ±ralÄ± Veri TÃ¼rleri",slug:"ek-2-sÄ±ralÄ±-veri-turleri"},{level:2,title:"EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi",slug:"ek-3-istemci-sertifikalarÄ±nÄ±n-tanÄ±m-ve-yonetimi"},{level:2,title:"EK-4: Sunucu SertifikalarÄ±",slug:"ek-4-sunucu-sertifikalarÄ±"},{level:2,title:"EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±",slug:"ek-5-mesaj-imzalama-akÄ±sÄ±"},{level:3,title:"Ä°mzalama KurallarÄ± (YÃS)",slug:"imzalama-kurallarÄ±-yos"},{level:2,title:"EK-6: HHS/YÃS API Mimarisi",slug:"ek-6-hhs-yos-api-mimarisi"}],content:' EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ± \n AÃ§Ä±k BankacÄ±lÄ±k simÃ¼latÃ¶r uygulamasÄ± Ã¼zerinde swagger dÃ¶kÃ¼manlarÄ±nÄ±n gÃ¼ncel sÃ¼rÃ¼mlerine eriÅim saÄlanabilir. \n EK-2: SÄ±ralÄ± Veri TÃ¼rleri \n \n \n \n Kod \n AÃ§Ä±klama \n \n \n \n \n TR.OHVPS.DataCode.KimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) Y , YKN , N11 P , PNO , AN7..9 \n \n \n TR.OHVPS.DataCode.KurumKimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) V , VKN , AN10 \n \n \n TR.OHVPS.DataCode.OhkTur \n Kod: B: Bireysel  K: Kurumsal \n \n \n TR.OHVPS.DataCode.KolasTur \n MÃ¼Återinin sorgulama istediÄi Kolay Adres Tipi deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r: T: Telefon NumarasÄ± E: E-Posta K: TCKN V: VKN Y: YKN P: Pasaport NumarasÄ± \n \n \n TR.OHVPS.DataCode.KareKodAksTur \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulamalÄ± hizmet alÄ±nan iÅyeri Ã¶demesi 02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulamalÄ± iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n TR.OHVPS.DataCode.OdemeKaynak \n I: Ä°nternet bankacÄ±lÄ±ÄÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. A: Otomatik para makineleri (ATM) ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. T: Telefon bankacÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. K: Kiosklar aracÄ±lÄ±ÄÄ±yla gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. S: Åubeden girilen Ã¶demelerde kullanÄ±lÄ±r. M: Mobil uygulamadan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. D: YukarÄ±dakiler dÄ±ÅÄ±ndaki Ã¶deme kaynaklarÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.  O: AÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. \n \n \n TR.OHVPS.DataCode.OdemeAmaci \n Ãdemenin AmacÄ±na yÃ¶nelik olarak aÅaÄÄ±daki deÄerlerden birini alÄ±r: 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aid

16at Ã¶demesi \n \n \n TR.OHVPS.DataCode.OdemeDurumu \n Ãdemenin durumunu gÃ¶sterir. AlabileceÄi deÄerler: 01: GerÃ§ekleÅti (Ãdeme ilgili Ã¶deme sistemine iletildi ve alÄ±cÄ± hesabÄ±na ulaÅtÄ±.)  02: GÃ¶nderildi (Ãdeme ilgili Ã¶deme sistemine iletildi ancak alÄ±cÄ± hesabÄ±na ulaÅtÄ±ÄÄ±na dair teyit alÄ±nmadÄ±.)Ä°Ålemin son durumunun teyidi iÃ§in YÃS sorgulama yapmalÄ±dÄ±r. 03- GerÃ§ekleÅmedi (Ãdemenin ilgili Ã¶deme sistemine iÅletiminde veya iÅlenmesi sÄ±rasÄ±nda hata, zaman aÅÄ±mÄ±, sistemin gÃ¼n sonu iÅlemlerine baÅlamasÄ± vb. durum oluÅtu ve Ã¶deme gereÃ§eklemedi veya iade edildi.) 04- Onayda bekliyor (Ãdeme emri alÄ±ndÄ±. Ãoklu onay akÄ±ÅÄ±nÄ±n tamamlanmasÄ± bekleniyor.) 05- Ä°Åleme AlÄ±ndÄ± ( Ãdeme emri alÄ±ndÄ±. ) YÃS tarafÄ±ndan mÃ¼Återiye gÃ¶sterilmeyen bir koddur. Bu kod dÃ¶nÃ¼ldÃ¼ÄÃ¼nde YÃS uygulamasÄ±nda ÃHKâya Ã¶deme durumu 02-GÃ¶nderildi  olarak gÃ¶sterilir. Ä°Ålemin son durumunun teyidi iÃ§in YÃS sorgulama yapmalÄ±dÄ±r. \n \n \n TR.OHVPS.DataCode.IslemAmaci \n Ãdemenin AmacÄ±na yÃ¶nelik olarak aÅaÄÄ±daki deÄerlerden birini alÄ±r: 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aidat Ã¶demesi 12: DiÄer \n \n \n TR.OHVPS.DataCode.RizaDurumu \n B: Yetki Bekleniyor Y: Yetkilendirildi K: Yetki KullanÄ±ldÄ± E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ S: Yetki SonlandÄ±rÄ±ldÄ± I :Yetki Iptal \n \n \n TR.OHVPS.DataCode.GkdTur \n GKD yapÄ±lmasÄ±nÄ± gerekli bulduÄu durumda HHS, YÃSâÃ¼n belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi GKD yÃ¶ntemini bildirir: Y: YÃ¶nlendirmeli GKD A: AyrÄ±k GKD \n \n \n TR.OHVPS.DataCode.RizaTip \n H: Hesap Bilgisi RÄ±zasÄ± O: Ãdeme Emri RÄ±zasÄ± \n \n \n TR.OHVPS.DataCode.IzinTur \n 01: Temel Hesap Bilgisi 02: AyrÄ±ntÄ±lÄ± Hesap Bilgisi 03: Bakiye Bilgisi 04: Temel Ä°Ålem (Hesap Hareketleri) Bilgisi 05: AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n \n \n TR.OHVPS.DataCode.OdemeSistemi \n Ä°Ålemin yÃ¶nlendirildiÄi Ãdeme Sistemine gÃ¶re aÅaÄÄ±daki deÄerlerden birini alabilir: H: Havale F: FAST E: EFT (PÃS) deÄerlerinden birini alabilir. \n \n \n TR.OHVPS.DataCode.IslemTuru \n Hesap hareketleri (iÅlemler) sorgusunda dÃ¶nÃ¼len Ä°Ålem TÃ¼rÃ¼ (islTur) parametresi aÅaÄÄ±daki deÄerlerden birini alabilir: HAVALE EFT FAST PARA_YATIRMA PARA_CEKME YABANCI_PARA_HAVALE YATIRIM_HESABINA_AKTARIM YATIRIM_HESABINDAN_AKTARIM KURUM_FATURA_ODEMESI CEK SENET SIGORTA_ODEMESI UCRET_KOMISYON_FAIZ SGK_ODEMESI VERGI_ODEMESI DOVIZ_ALIM DOVIZ_SATIM KREDI_ODEMESI KREDI_KULLANIM KK_ODEMESI KK_NAKIT_AVANS SANS_OYUNU UYE_ISYERI_ISLEMLERI HGS_OGS_ISLEMLERI DOGRUDAN_BORCLANDIRMA_SISTEMI DIGER \n \n \n TR.OHVPS.DataCode.HspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.KolasHspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.HspTip \n Hesap Ã§eÅidini belirtir: VADESIZ VADELI KREDILI_MEVDUAT_HESABI POS CEK YATIRIM \n \n \n TR.OHVPS.DataCode.HspDrm \n HesabÄ±n durumunu belirtir: AKTIF PASIF KAPALI \n \n \n TR.OHVPS.DataCode.YetTip \n AlabileceÄi deÄerlere gÃ¶re hangi belirtecin dÃ¶neceÄine karar verilir. yet_kod yenileme_belirteci \n \n \n TR.OHVPS.DataCode.BrcAlc \n Ä°Ålemin hesabÄ± borÃ§landÄ±rdÄ±ÄÄ± ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. B : BorÃ§ A : Alacak \n \n \n TR.OHVPS.DataCode.RizaIptDtyKod \n â01â :Yeni RÄ±za Talebi ile Ä°ptal â02â :KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal â03â :KullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal â04â :SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor â05â :SÃ¼re AÅÄ±mÄ± : Yetkilendirildi â06â :SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi â07â :GKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± â08â :GKD iptali : RÄ±zano ile TCKN uyuÅmamasÄ± â09â :GKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor â10â :GKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± â11â :GKD iptali : Hesap Yetki S

16orunu â12â :GKD iptali : ÃHK HHS kontrollerini aÅamadÄ± â13â :GKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi â14â :GKD iptali : Fraud ÅÃ¼phesi â99â :GKD iptali : DiÄer \n \n \n TR.OHVPS.DataCode.PSUInitiated \n âEâ : Evet âHâ : HayÄ±r \n \n \n TR.OHVPS.DataCode.HHSYOSSrlmKrtr \n âkodâ : Kod,âunvâ : Unvan \n \n \n TR.OHVPS.DataCode.SrlmYon \n âAâ: Azalan deÄerle sÄ±ralama âYâ: Artan deÄerle sÄ±ralama \n \n \n TR.OHVPS.DataCode.ZmnAralik \n 0 : KayÄ±t Yok  1 : 0-2 saat 2 : 2-24 saat  3 : 1-3 gÃ¼n   4 : 3-15 gÃ¼n\t  5 : 15 gÃ¼n ve Ã¼stÃ¼ \n \n \n TR.OHVPS.DataCode.VarYok \n 0 : KayÄ±t Yok   1 : KayÄ±t Var \n \n \n TR.OHVPS.DataCode.HHSDurumu \n A : AÃ§Ä±k. Ãretim OrtamÄ±nda HHSânin aktif bir Åekilde hizmet vermesi durumu.  Y : YaygÄ±nlaÅtÄ±rma. Ãretim OrtamÄ±nda HHSânin kendisi tarafÄ±ndan tanÄ±mlanmÄ±Å kÄ±sÄ±tlÄ± ÃHKâya hizmet vermesi durumu.    G : GeÃ§ici Hizmet Veremiyor. HHS servislerinde teknik bir sorun olmasÄ± nedeniyle HHSânin hizmet verememesi durumu.  K: KapalÄ±. HHSânin hizmet vermeme durumu. \n EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi \n TÃ¼m katÄ±lÄ±mcÄ±larÄ±n BKM API GeÃ§idine eriÅebilmesi iÃ§in, BKM tarafÄ±ndan yapÄ±lan istemci sertifika doÄrulamasÄ±ndan geÃ§mesi gerekmektedir. Ä°stemci sertifikasÄ± Ã¼retilmeden Ã¶nce katÄ±lÄ±mcÄ±larÄ±n CSR Ã¼retme akÄ±ÅÄ±nÄ± tamamlamasÄ± gerekmektedir. \n OpenSSL ile CSR (Certificate Signing Request) OluÅturma \nAÅaÄÄ±daki komut ile 2048-bit RSA private key ve CSR oluÅturulur. \nopenssl req -new -newkey rsa:2048 -nodes -keyout PRIVATEKEY.key -out CSR.csr \n CSR ile ilgili detay bilgilerin giriÅinde; \nCommon Name (CN) olarak 4 karakterli hhsKod ya da yosKod deÄeri ile, \ndiÄer alanlar iÃ§in de kurum bilgileriniz ile giriÅ yapÄ±lÄ±r. \n TÃ¼m bilgilerin girilmesinden sonra oluÅan private key dosyasÄ± kurumunuzda saklanÄ±r.\nCSR dosyasÄ± ise istemci sertifika Ã¼retmek Ã¼zere kullanÄ±lÄ±r. Bu aÅamada takip edilmesi gereken adÄ±mlar Åu Åekildedir: \n KatÄ±lÄ±mcÄ±larÄ±n, TRIP ortamÄ± Ã¼zerinden, BKM TarafÄ±ndan yetki verilmiÅ kullanÄ±cÄ±larÄ±nÄ±n gÃ¶rebileceÄi "Ä°stemci Sertifika Talebi" menÃ¼ adÄ±mÄ±na giriÅ yapmalarÄ± beklenir. AÃ§Ä±lan ekranda,"CSR DosyasÄ± YÃ¼kleme" alanÄ± iÃ§erisine, katÄ±lÄ±mcÄ±nÄ±n Ã¼retmiÅ olduÄu csr dosyasÄ± yÃ¼klenir. YaklaÅÄ±k 1 dakika iÃ§erisinde kuruma Ã¶zel olarak Ã¼retilmiÅ olan client sertifikasÄ± indirilmeye hazÄ±r hale gelecektir. "Ä°ndir" butonu ile client sertifika indirilir. Ä°stemci tarafÄ±nda web isteÄinin ilgili sertifika ile iliÅkilendirilerek oluÅturulmasÄ± gerekmektedir. \n Uzun dÃ¶nemli olarak hazÄ±rlanacak olan sertifikalar sertifikasyon ve Ã¼retim ortamlarÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi bu aÅamalarda sÄ±nanacaktÄ±r. \n BKM API GeÃ§idi Ã§Ã¶zÃ¼mÃ¼nÃ¼n test ve Ã¼retim ortamlarÄ± ayrÄ±mÄ±nda istemci sertifikalarÄ±, HHS Listeleme API eriÅimleri ve Sertifikasyon baÄlantÄ±larÄ± Åekil 15-HHS/YÃS API Mimarisi DiagramÄ±nda resmedilmiÅtir. \n EK-4: Sunucu SertifikalarÄ± \n Sunucu sertifikalarÄ±nÄ±n endpoint bilgisini (Fqdn) iÃ§erecek ve global bir Certification Authority tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir.\nÃrneÄin; entegrasyon formu iÃ§erinde yer alan URL bilgisinin (test.xbank.com.tr) sertifika iÃ§erisinde tanÄ±mlÄ± olmasÄ± ve bu sertifikanÄ±n global bir CA Ã¶rneÄin Verisign tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir. \n Hizmet saÄlayÄ±cÄ± olan HHS\'ler tarafÄ±ndan sunucu sertifikalarÄ± uygulanmalÄ±dÄ±r. \n EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ± \n Dijital imzalama yapÄ±sÄ±, ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini saÄlamak amacÄ±yla kurgulanmÄ±ÅtÄ±r.\nBu kapsamda imzalama akÄ±ÅÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r: \n \n HHS ya da YÃS Ã¶ncelikle Ã¶zel ve aÃ§Ä±k anahtarlarÄ±nÄ± oluÅturmalÄ±dÄ±r. Bu anahtarlarÄ± oluÅturmak iÃ§in aÅaÄÄ±da âopensslâ kullanÄ±larak oluÅturma Ã¶rneÄi paylaÅÄ±lmÄ±ÅtÄ±r.  Bu anahtarlardan Ã¶zel olan anahtar mesajÄ± imzalamak iÃ§in kullanÄ±lacak olup, aÃ§Ä±k anahtar ise mesajÄ± doÄrulamak amacÄ±yla mesajÄ±n alÄ±cÄ±sÄ± tarafÄ±ndan kullanÄ±lacaktÄ±r. \n \n private_key.pem ve public_key.pem dosyasinin iÃ§erikleri kod tarafÄ±nda kullanÄ±lacaktÄ±r. \n --private.pem => Ãzel anahtarÄ±n ismi\nopenssl genrsa -out private.pem 2048 \n --public_key.pem => AÃ§Ä±k anahtarÄ±n ismi\nopenssl rsa -in private.pem -pubout -outform PEM -out public_key.pem \n --private_key.pem => Ãzel anahtarÄ±n PCKS8 formatÄ±na Ã§evrilmesi (Java aÃ§Ä±sÄ±ndan PCKS8 formatÄ±nda olma ihtiyacÄ± nedeniyle) openssl pkcs8 -topk8 -inform PEM -in private.pem -out private_key.pem -nocrypt \n \n \n AÃ§Ä±k ve Ãzel anahtarlar oluÅturulduktan sonra AÃ§Ä±k Anahtar BKM ile paylaÅÄ±lÄ±r. BKM bu aÃ§Ä±k anahtarÄ± diÄer katÄ±lÄ±mcÄ±larÄ±n ulaÅabilmesi ve alabilmesi iÃ§in bir Anahtar Deposu yaklaÅÄ±mÄ± ile bÃ¼nyesinde tutar. Ä°lgili anahtarÄ± iletebilmek ve alabilmek iÃ§in kullanÄ±lacak HHS/YOS API ye eriÅim detaylarÄ± EK-6 bÃ¶lÃ¼mÃ¼nde detaylÄ± olarak paylaÅÄ±lmÄ±ÅtÄ±r.  EÄer kurumun ilgili anahtar Ã§iftinin yenilenme durumu sÃ¶z konusu ise yenilemenin hemen ardÄ±ndan aÃ§Ä±k anahtar yeni bir imzalama yapÄ±lmadan Ã¶nce mutlaka BKM ile paylaÅÄ±lmalÄ±dÄ±r. \n \n \n Ä°mzalÄ± mesajÄ± aÃ§acak olan kurum mesajÄ± imzalayan kurumun aÃ§Ä±k anahtarÄ±nÄ± her sorguda yeniden almak durumunda deÄildir. Belirli periyodlarda kendi ortamÄ±ndaki anahtarÄ± yenileyerek sistemi iÅletebilir. Ancak imzalayan kurum anahtar Ã§ifti yenilemesi yaptÄ±ÄÄ±nda BKM ile aÃ§Ä±k anahtarÄ±nÄ± paylaÅsa dahi

16imzalÄ± mesajÄ± doÄrulayacak taraf eski aÃ§Ä±k anahtar ile doÄrulama yapmaya Ã§alÄ±ÅtÄ±ÄÄ± iÃ§in hata alacaktÄ±r. Bu ilk hata durumunda hÄ±zlÄ±ca BKM Ã¼zerinden yeni anahtarÄ± alÄ±p mesajÄ± tekrar doÄrulamayÄ± denemelidir. EÄer yine hata alÄ±yor ise doÄrulama iÅlemini hata statÃ¼sÃ¼ne almalÄ±dÄ±r. Bu sebeple anahtar yenileyen kurum yeni aÃ§Ä±k anahtarÄ±nÄ± yeni bir mesaj imzalama yapmadan Ã¶nce mutlaka BKM ile paylaÅmalÄ±dÄ±r. \n \n \n PSU-Fraud-Check alanÄ± iÃ§in de JWT formatÄ±nda Ã§Ä±ktÄ± hazÄ±rlanmasÄ± beklenmektedir. Ãrnek bir PSU-Fraud-Check payload deÄeri aÅaÄÄ±daki gibidir; \n {"AnomalyFlag": "0", \n"LastPasswordChangeFlag": "1", \n"FirstLoginFlag": "1", \n"DeviceFirstLoginFlag": "1", \n"BlacklistFlag": "0", \n"MalwareFlag": "0", \n"UnsafeAccountFlag": "0", \n"exp": 1663424479, \n"iat": 1663338079, \n"iss": "[https://apigw.bkm.com.tr|https://apigw.bkm.com.tr/]" } \n Ä°mzalama KurallarÄ± (YÃS) \n Bir YÃS Ã¼zerinden baÅlayan akÄ±Å Ã¶rnek olarak paylaÅÄ±lmÄ±ÅtÄ±r. \n \n \n YÃS, mesaj imzalama gerektiren her API isteÄinin HTTP gÃ¶vdesini (request body) kendi Ã¶zel anahtarÄ± ile Åifreleyerek imza bilgisini oluÅturur. \n \n \n ArdÄ±ndan bu imza verisini, gÃ¶ndereceÄi mesajÄ±n istek baÅlÄ±ÄÄ±nda yer alan X-JWS-Signature alanÄ±nda gÃ¶ndermelidir. \n \n \n X-JWS-Signature alanÄ±nda gÃ¶nderilecek olan bilgi aÅaÄÄ±daki yÃ¶ntem ile oluÅturulmalÄ±dÄ±r. \n \n \n Bu alana yazÄ±lacak olan bilgi JWT formatÄ±nda oluÅturulmalÄ±dÄ±r. \n \n \n Bir JWT, header-payload-signature alanlarÄ±ndan oluÅmaktadÄ±r. \n \n Header alanÄ±nda JWTâyi imzalamak iÃ§in kullanÄ±lacak algoritma belirtilmelidir.  Standartlar kapsamÄ±nda RS256 kullanÄ±lacaktÄ±r. \n Payload kÄ±smÄ±nda Ã¶zel olarak oluÅturulacak olan âbodyâ claim alanÄ±na istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ± yazÄ±lmalÄ±dÄ±r. \n JSON payload oluÅturulurken RFC 7519 baz alÄ±nmalÄ±dÄ±r. "iss" (Issuer) Claim, "exp" (Expiration Time) Claim, "iat" (Issued At) Claim, âbodyâ Claim alanlarÄ±nÄ±n gÃ¶nderilmesi zorunludur. ^RFC7519 \na.\t"iss" (Issuer) Claim : Kurumunuza Ã¶zel bilgidir. \nb.\t"exp" (Expiration Time) Claim: Saniye cinsinden (Unix time) imzanÄ±n son geÃ§erli olduÄu tarih. Bu tarih  mevcut sunucu saatinizden 60 dakika sonra olacak Åekilde kullanÄ±lmalÄ±dÄ±r. \nc.\t"iat" (Issued At) Claim : Saniye cinsinden (Unix time) imzanÄ±n oluÅturulduÄu tarih. Bu tarih  mevcut sunucu saatinizden 5 dakika Ã¶nce olacak Åekilde kullanÄ±lmalÄ±dÄ±r. \nd.\tâbodyâ Claim : istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ±. \n Signature alanÄ±nda da Ã¶zel anahtar ile imzalanmÄ±Å olan imza iÃ§eriÄi yer alacaktÄ±r. \n \n X-JWS-Signature:   JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir. \n Ãrnek X-JWS-Signature Payload DeÄeri \n { \n"iss": "https://apigw.bkm.com.tr", \n"exp": 1646832405, \n"iat": 1646746005, \n"body": "c543072f97a761a1d891dc81acc380bc1e6f61ca6541bd93ebfdece338457922" \n} \n \n \n \n \n YÃS, isteÄi gÃ¶nderir. Sadece mesajÄ±n bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ ve doÄruluÄunu teyit amacÄ± ile istek gÃ¶vdesi (request body) SHA256 hash deÄeri imzalanarak X-JWS-Signature alanÄ±nda bu imza iletilir. Ä°steÄin gÃ¶vde (request body) kÄ±smÄ± aÃ§Ä±k ve Åifresiz olarak gÃ¶nderilmektedir. \n \n \n HHS, isteÄi alÄ±r, talebi gerÃ§ekleÅtirmeden Ã¶nce aldÄ±ÄÄ± API isteklerinin imzasÄ±nÄ± doÄrulamalÄ±dÄ±r. X-JWS-Signature alanÄ±ndaki JWT aÅaÄÄ±daki adÄ±mlarla doÄrulanmalÄ±dÄ±r. \n \n Header kÄ±smÄ±ndaki algoritmanin RS256 olduÄu kontrol edilir. \n GÃ¶nderen kurumun aÃ§Ä±k anahtarÄ± ile JWT verify (doÄrulama) iÅlemi yapÄ±lÄ±r. \n YukarÄ±daki iÅlemlerin doÄruluÄunun ardÄ±ndan JWTânin payload kÄ±smÄ±ndaki âbodyâ claim alanÄ±ndaki bilginin, isteÄin gÃ¶vde verisinin SHA256 hash deÄerlerinin aynÄ± olduÄu kontrol edilir. \n Ãrnek checksum deÄeri   "a64b19f95eeb1fb0a0a3e2dbbc6e3d8472c52184d4543417ddc6d156fc5c5571" veya   "A64B19F95EEB1FB0A0A3E2DBBC6E3D8472C52184D4543417DDC6D156FC5C5571" Åeklinde olabilir. Ä°ki hali de aynÄ± deÄere sahiptir. Kontrollerde buna dikkat edilmesi gerekmektedir. \n \n \n \n YukarÄ±daki iÅlemler ile doÄruluÄu teyit edilmiÅ olan isteÄin talebi gerÃ§ekleÅtirir. \n \n \n EÄer istek doÄrulanamÄ±yor ise gÃ¶nderen kurumun aÃ§Ä±k ve Ã¶zel anahtar Ã§ifti yenilenmiÅ olabilir. \n \n \n BKM HHS API  Ã¼zerinden ilgili kurumun bilgilerini (kurum ko

16du vs) kullanarak kurumun detay bilgileri Ã§eker ve kendi ortamÄ±nda yeniler. \n \n \n ArdÄ±ndan imzayÄ± tekrar aÃ§Ä±k anahtar ile doÄrulayarak kontroller gerÃ§ekleÅtirilir. (EÄer halen doÄrulama iÅlemi baÅarÄ±sÄ±z ise bu istek iÃ§in hata akÄ±ÅÄ± Ã§alÄ±ÅtÄ±rÄ±lÄ±r.  TR.OHVPS.Resource.InvalidSignature  kodu ile hata Ã¼retilebilir.) \n \n \n Ä°mza bilgisinin beklendiÄi (x-jws-signature) servislerde, bu bilginin iletilmediÄi durumlarda  TR.OHVPS.Resource.MissingSignature  hatasÄ± Ã¼retilebilir. \n \n \n HHS isteÄi iÅledikten sonra cevabÄ± oluÅtururken de yukarÄ±daki akÄ±Ålar ile gÃ¶ndereceÄi cevabÄ± imzalamalÄ±dÄ±r. \n \n \n Ä°stek yanÄ±t gÃ¶vdesinin SHA256 checksum deÄeri iÃ§in hexadecimal Ã§Ä±ktÄ± kullanÄ±lacaktÄ±r. OluÅacak Ã§Ä±ktÄ±nÄ±n 64 karakter olmasÄ± beklenmektedir. Kontrol iÃ§in "^[A-Fa-f0-9]{64}$" RegEx tarifini kullanabilirsiniz. \n \n \n Ãrnek bir gÃ¶vde: \n {"katilimciBlg":{"hhsKod":"8000","yosKod":"8000"},"gkd":{"yetYntm":"Y","yonAdr":"https://boss-test.bkm.com.tr/boss/ab/yosSimulator/8000?drmKod=6021de9f-55e7-454a-94be-2044866b22e1"},"kmlk":{"kmlkTur":"M","kmlkVrs":"123456","ohkTur":"B"},"hspBlg":{"iznBlg":{"iznTur":["01","02","03","04","05"],"erisimIzniSonTrh":"2022-10-12T23:59:59+03:00","hesapIslemBslZmn":"2021-10-10T00:00:00+03:00","hesapIslemBtsZmn":"2023-10-10T23:59:59+03:00"}}}\n \n Bu gÃ¶vdenin checksum\'Ä±: \n a64b19f95eeb1fb0a0a3e2dbbc6e3d8472c52184d4543417ddc6d156fc5c5571\n \n Bu checksum\'Ä±n iletildiÄi x-jws-signature baÅlÄ±k deÄeri: \n eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwczovL2FwaWd3LmJrbS5jb20udHIiLCJleHAiOjE2NjU0NzU1NjIsImlhdCI6MTY2NTM4OTE2MiwiYm9keSI6ImE2NGIxOWY5NWVlYjFmYjBhMGEzZTJkYmJjNmUzZDg0NzJjNTIxODRkNDU0MzQxN2RkYzZkMTU2ZmM1YzU1NzEifQ.Q65PI_1fTEzzBMirvmJvXgVX3orhhZ4_UqujtGdHkU7me-1ymIjvPrzy3kfyER1pedFb7HDCBuPvYoqjX8eUnpiiZsxfzCiEa0McIhoFeUOggq-O8VihItp8bLr2DWwQ9JHN1-WXB2mL31KAKFAL1VY9-DXuAdT-RfE_SLYsl2ycmNy4ti4XvfDvvlE56ZsieFZ727VuwR8wi7F0kKDc6UhjaMF9xcUeAM1fxX-bmcOaOo1NZGC0vvgjNZKz_OJrN-q8VhWYnQPiJ7wY7S9IG8bHIkBImKSVf8LuOEvl8u0BZzADLH1iOBd9x2l1plyI_NLPTrnOqhWhKlljkkJBCg\n \n EÄer PSU-Fraud-Check iÃ§in baÅlÄ±k gÃ¶nderilecekse, yine JWT formatÄ±nda imza Ã¼retilmelidir. Ãrnek bir psu-fraud-check baÅlÄ±k deÄeri: \n eyJhbGciOiJSUzI1NiJ9.eyJBbm9tYWx5RmxhZyI6IjAiLCJMYXN0UGFzc3dvcmRDaGFuZ2VGbGFnIjoiMSIsIkZpcnN0TG9naW5GbGFnIjoiMSIsIkRldmljZUZpcnN0TG9naW5GbGFnIjoiMSIsIkJsYWNrbGlzdEZsYWciOiIwIiwiTWFsd2FyZUZsYWciOiIwIiwiVW5zYWZlQWNjb3VudEZsYWciOiIwIiwiZXhwIjoxNjY1NDc1NTU2LCJpYXQiOjE2NjUzODkxNTYsImlzcyI6Imh0dHBzOi8vYXBpZ3cuYmttLmNvbS50ciJ9.DhUh_nsXDuNIrvsQ3KOhOXdVcJg6fTDVW8K1oea8kLtmb7n-_hJHY3mWX5zzobu-Vh2VvFzIxPhHtol6gLHFktmIMiQ9TDHb_mRZFXgJB4ToNfqc3Fy9mi5bS8By2IYi1HxDaCStstaZDaunzXfHCtqybfZXyk6teDrf-iIf6lqX9Keo7GZO-Y7mP7C13-c_QwyNKrZK4TZwUQbecRqXYn1DcEHM7kukQHTar_hKBWkXPmNpScY0J2rKksr4ejR1uLhdQm-Pdwoe9y6qrNEB79vMLBkRNtbuV0vc1GYHp_YKkzBKBI_58uuB2GD9877CsrcRnHMQb88xpxiPKh6-ew\n EK-6: HHS/YÃS API Mimarisi \n HHS/YÃS API Uygulama Mimarisinde Test ve Ãretim ortamlarÄ±nda aÅaÄÄ±daki alanda yer almaktadÄ±r. \n \n Åekil 15: HHS/YÃS API Mimarisi \n'},{title:"5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama",frontmatter:{},regularPath:"/v1.0.2/contents/gkd.html",relativePath:"v1.0.2/contents/gkd.md",key:"v-d80dcb06",path:"/v1.0.2/contents/gkd.html",headers:[{level:2,title:"5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-1-yonlendirmeli-guclu-kimlik-dogrulama"},{level:2,title:"5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-2-ayrÄ±k-guclu-kimlik-dogrulama"},{level:2,title:"5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi",slug:"_5-3-yonlendirme-bildirim-adresleri-ve-durum-kodu-parametresi"},{level:2,title:"5.4\tHealthcheck API",slug:"_5-4healthcheck-api"},{level:2,title:"5.5  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri",slug:"_5-5-guclu-kimlik-dogrulama-kontrolleri"}],content:" 5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n MÃ¼Återi iÃ§in gÃ¼Ã§lÃ¼ kimlik doÄrulama, ÃHKânÄ±n (mÃ¼Återinin) kimliÄinin doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin âbildiÄiâ, âsahip olduÄuâ veya âbiyometrik bir karakteristiÄi olanâ bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntemi tanÄ±mlar. \n Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄ uyarÄ±nca hesap bilgisi hizmetinde mÃ¼Återinin onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda ve Ã¶deme emri baÅlatma hizmetinde her bir Ã¶deme emri baÅlatma iÅleminde  HHS tarafÄ±ndan mÃ¼Återiye gÃ¼Ã

16§lÃ¼ kimlik doÄrulama (GKD) uygulanmasÄ± esastÄ±r.  Buna gÃ¶re: \n \n \n Hesap bilgisi hizmetinde ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda  TebliÄin 26 ncÄ± maddesinin 1 inci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya GKD uygulanÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 2 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanÄ±r ve iÅlem doÄrulama kodu ile ÃHKânÄ±n onayÄ± alÄ±nÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 3 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanmasÄ±na iliÅkin istisna veya ilave gÃ¼venlik Ã¶nlemleri iÅbu API Ä°lke ve KurallarÄ± belgesinde tanÄ±mlanÄ±r. \n \n \n HHS, gÃ¼Ã§lÃ¼ kimlik doÄrulama sÃ¼recinde ÃHKânin sahip olduÄu bileÅen sÄ±nÄ±fÄ± olarak SMS OTP ya da SMS ile iÅlem doÄrulama kodu kullanabilir. \n \n \n HHS, aÅaÄÄ±daki hallerde veya  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re tek bileÅen ile kimlik doÄrulama yapabilir. \n \n Ãdemenin gÃ¶ndereni ve alÄ±cÄ±sÄ±nÄ±n aynÄ± olmasÄ±, \n Daha Ã¶nce tanÄ±mlanmÄ±Å gÃ¼venli alÄ±cÄ±lar listesine Ã¶deme yapÄ±lmasÄ±, \n ÃHKânin talimatÄ±na istinaden gerÃ§ekleÅtirilen dÃ¼zenli bir Ã¶deme olmasÄ±. \n \n \n \n Tek bileÅen ile kimlik doÄrulama yapÄ±lan bu iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin mÃ¼Återi tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye ait olur. \n \n \n Ä°Ålem DoÄrulamada  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± ÄÄ bendindeki  iÅlem bilgisi tanÄ±mÄ±na uygun olarak aÅaÄÄ±daki bilgiler ile  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  tanÄ±mlanan iÅleme Ã¶zel Ã¼retilmiÅ iÅlem doÄrulama kodu birlikte kullanÄ±lÄ±r. \n \n AlÄ±cÄ± Unvan (Kolas akÄ±ÅÄ±nda maskeli olarak)  (Ã¶deme emri baÅlatma hizmeti) \n Tutar (Ã¶deme emri baÅlatma hizmeti) \n Referans bilgisi (8 karakterden kÃ¼Ã§Ã¼k ise alanÄ±n tÃ¼m deÄeri, bÃ¼yÃ¼k ise ilk 4 ve son 4 hanesi) \n \n Ä°Åleme ait yukarÄ±daki bilgilerden en az biri deÄiÅtiÄi zaman  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  belirtildiÄi gibi yeni bir iÅlem doÄrulama kodu Ã¼retilecek Åekilde akÄ±Å kurgulanmalÄ±dÄ±r. \n \n \n Ä°Ålem doÄrulama kodunun gÃ¶nderilmesinden HHS sorumludur. HHS,  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re iÅlem doÄrulama kodu kullanmaksÄ±zÄ±n ÃHKânÄ±n onayÄ±nÄ± alabilir. Ä°Ålem doÄrulama kodu kullanÄ±lmayan iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin ÃHK tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye aittir. \n \n \n ÃHVPS API standartÄ± kapsamÄ±nda iki adet GÃ¼Ã§lÃ¼ Kimlik DoÄrulama (GKD) yÃ¶ntemi kullanÄ±lacaktÄ±r: \n \n YÃ¶nlendirmeli (Redirect) GKD YÃ¶ntemi \n AyrÄ±k (Decoupled) GKD YÃ¶ntemi \n \n \n \n HHS asgari olarak tarayÄ±cÄ± tabanlÄ± YÃ¶nlendirmeli GKD yÃ¶ntemini desteklemek zorundadÄ±r. \n \n \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemleri sadece YÃ¶nlendirmeli GKD yÃ¶ntemi ile gerÃ§ekleÅtirilebilir. \n 5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n YÃ¶nlendirmeli GKD YÃ¶nteminde, mÃ¼Återi kimlik doÄrulama iÃ§in YÃS tarafÄ±ndan HHS arayÃ¼zÃ¼ne yÃ¶nlendirilir. \n MÃ¼Återi HHSâye (uygulama veya web arayÃ¼zÃ¼ vasÄ±tasÄ±yla) yÃ¶nlendirildikten sonra mÃ¼Återinin gÃ¼Ã§lÃ¼ kimlik doÄrulamasÄ± adÄ±m adÄ±m ve doÄrudan HHS ile mÃ¼Återi arasÄ±nda yÃ¼rÃ¼tÃ¼lÃ¼r. GKDânin tamamlanmasÄ±ndan sonra mÃ¼Återi tekrar YÃS uygulamasÄ±na yÃ¶nlendirilir.YÃ¶nlendirmenin aynÄ± sayfada HTTP 302 yanÄ±t koduyla yapÄ±lmasÄ± gerekmektedir. \n YÃ¶nlendirmeli GKD YÃ¶ntemi iÃ§in Ã¼st dÃ¼zey Ã¶rnek iÅ akÄ±ÅÄ± aÅaÄÄ±daki adÄ±mlardan oluÅur: \n \n YÃS, GKD iÃ§in HHS tarafÄ±ndan tanÄ±mlanan arayÃ¼ze (tarayÄ±cÄ± ya da uygulama) yÃ¶nlendirme yapar. \n MÃ¼Återi, YÃS arayÃ¼zÃ¼nden ayrÄ±lÄ±r, yÃ¶nlendirildiÄi HHS arayÃ¼zÃ¼ Ã¼zerinde kimlik doÄrulama iÅlemlerini gerÃ§ekleÅtirir. \n GKD tamamlandÄ±ktan sonra mÃ¼Återi, YÃS arayÃ¼zÃ¼ne tekrar yÃ¶nlendirilir ve iÅlem sonucu gÃ¶rÃ¼ntÃ¼lenir. \n \n YÃ¶nlendirmeli GKD iÃ§in temel gereklilikler ÅunlardÄ±r: \n \n Ãdeme hizmeti (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) tarayÄ±cÄ± ya da uygulama tabanlÄ± bir Åekilde sunulabilir. Bu nedenle,  YÃS ve HHSâlerin YÃ¶nlendirmeli GKD iÃ§in asgari olarak tarayÄ±cÄ± tabanlÄ± yÃ¶nlendirme akÄ±ÅÄ±nÄ± desteklemeleri gerekmektedir. \n ÃerÃ§eve sÃ¶zleÅme (ÃS) kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemleri sadece YÃ¶nlendirmeli GKD yÃ¶ntemi ile gerÃ§ekleÅtirilebilir. \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n HHSânin web arayÃ¼zÃ¼ne, \n \n HHSânin mobil uygulamasÄ±nÄ±n olmadÄ±ÄÄ±, \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) sunduÄu mobil cihazda HHS uygulamasÄ±nÄ±n yÃ¼klÃ¼ olmadÄ±ÄÄ±, \ndurumlarda yÃ¶nlendirme yapÄ±lÄ±r. \n \n YÃSâÃ¼n mobil uygulamasÄ± varsa mobil cihazda uygulamadan tarayÄ±cÄ±ya, YÃSâÃ¼n mobil uygulamasÄ± yoksa Ã¶deme hizmetinin sunduÄu cihazda (KiÅisel Bilgisayar veya Mobil Cihaz) tarayÄ±cÄ± Ã¼zerinden yÃ¶nlendirme yapÄ±lÄ±r. \n Uygulama TabanlÄ± YÃ¶nlendirme \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) YÃSâÃ¼n mobil uygulamasÄ± ile kullanÄ±yorsa, aynÄ± mobil cihazda HHSânin mobil uygulamasÄ±nÄ±n yÃ¼klenmiÅ olmasÄ± durumunda, ÃHK doÄrulamasÄ±nÄ±n HHS mobil uygulamasÄ± tarafÄ±ndan yapÄ±lmasÄ± iÃ§in uygulama tabanlÄ± yÃ¶nlendirme yapÄ±lÄ±r. BÃ¶ylece ÃHK, Ã¶deme hizmetine eriÅim iÃ§in HHSânin mobil kanalÄ±na eriÅim sÄ±rasÄ±nda kullandÄ±ÄÄ± doÄrulama yÃ¶ntemini ile doÄrulanabilir. \n Tablo 5: YÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama KanallarÄ± \n \n \n \n DoÄrulama YÃ¶ntemi \n YÃS OlasÄ± Ortam \n HHS OlasÄ± Ortam \n \n \n \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼)/Mobil Cihaz \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼) / Mobil Cihaz \n \n \n Uygulama TabanlÄ± YÃ¶nlendirme \n Mobil Cihaz \n Mobil Cihaz \n 5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n AyrÄ±k GKD YÃ¶ntemi iÅ akÄ±ÅÄ±, YÃ¶nlendirmeli GKD YÃ¶nteminin iÅlem akÄ±ÅÄ±na benzer. Fark, HHS'nin, Ã§evrimiÃ§i arayÃ¼zÃ¼nden baÄÄ±msÄ±z olan herhangi bir uygulama veya cihaz aracÄ±lÄ±ÄÄ±yla Ã¶deme iÅlemi ayrÄ±ntÄ±larÄ±nÄ± iÃ§eren bir anlÄ±k bildirim (push notification) gÃ¶ndererek mÃ¼Återiden kimlik doÄrulamasÄ± istemesidir. AyrÄ±k GKD YÃ¶ntemine dayalÄ± bir iÅlem iÃ§in (Ã§ok basitleÅtirilmiÅ) Ã¼st dÃ¼zey Ã¶rnek bilgi akÄ±ÅÄ± Åu Åekildedir: \n \n MÃ¼Återi, YÃS arayÃ¼zÃ¼nde iÅlemini baÅlatÄ±r. \n YÃS, talebini mÃ¼Återiye ait TCKN, VKN, YKN gibi tekil tanÄ±mlayÄ±cÄ± kimlik numarasÄ± bilgisi iÃ§erecek Åekilde HHSâye iletilir. \n HHS tekil tanÄ±mlayÄ±cÄ± bilgisini kullanarak farklÄ± bir cihaz veya uygulama Ã¼zerinden mÃ¼Återiye anlÄ±k bildirim gÃ¶nderir ve doÄrulama yapÄ±lmasÄ±nÄ± saÄlar. Bu Åekilde HHS kendi mobil uygulamasÄ±na eriÅim iÃ§in kullanÄ±lan doÄrulama yÃ¶ntemini aynen kullanabilecektir. \n YÃS, herhangi bir yere yÃ¶nlendirme yapmadan iÅlemin sonucunu bekler, mÃ¼Återi YÃS arayÃ¼zÃ¼nden ayrÄ±lmaz (arayÃ¼z aynÄ± kalÄ±r). \n Kimlik doÄrulama sonrasÄ±, YÃS arayÃ¼zÃ¼nde iÅlem sonucu gÃ¶rÃ¼ntÃ¼lenir. \n 5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi \n CSRF AtaklarÄ±ndan korunmak iÃ§in ve YÃS uygulamasÄ±nÄ±n bir Ã¶nceki durumunu restore edebilmesi iÃ§in; YÃS tarafÄ±ndan iletilen yÃ¶nlendirme ve bildirim adreslerine , Oauth2 standartlarÄ±ndaki state parametresine eÅdeÄer,   durum ko

16du (drmKod)  parametresinin eklenmesi gerekmektedir. Durum kodu parametresi YÃS tarafÄ±ndan Ã¼retilen, tekil ve kolay tahmin edilemeyen bir deÄer olmalÄ±dÄ±r. RÄ±za isteÄi gÃ¶nderimi aÅamasÄ±nda oluÅturulmalÄ±dÄ±r. YÃS uygulamasÄ±nda uygun bir yerde saklanmalÄ±dÄ±r (cookie, session, local storage gibi) . \n Durum kodu, rÄ±za isteÄindeki yÃ¶nlendirme adresine parametre olarak eklenir.  GKD sÃ¼reci sonrasÄ±nda yetki kodu ile birlikte bu bilgi, HHS tarafÄ±ndan YÃSâe iletilir. YÃS sakladÄ±ÄÄ± deÄer ile parametre olarak gelen deÄerin eÅitliÄini kontrol eder. AynÄ± ise eriÅim belirteci almak Ã¼zere akÄ±ÅÄ± ilerletir. FarklÄ± ise iÅlemi keser. \n 5.4\tHealthcheck API \n GET /health \n HHSâlerin sunacaÄÄ± bu servis, dÃ¼zenli olarak BKM tarafÄ±ndan Ã§aÄÄ±rÄ±larak servislerin ayakta olup olmadÄ±klarÄ±nÄ±n kontrolÃ¼nÃ¼n saÄlanmasÄ± planlanmaktadÄ±r. \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lmelidir. \nBaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n KoÅullu  / Ä°steÄe BaÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir. \n 5.5  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri \n ÃHK, GKD iÃ§in HHS uygulamasÄ±na yÃ¶nlendirildiÄinde, HHSânin Ã§eÅitli kontroller yaparak iÅlemin doÄruluÄunu teyit etmesi gerekmektedir.\nYapÄ±lmasÄ± gereken kontrollere ait temel senaryolar aÅaÄÄ±daki tabloda belirtilmiÅtir. Bu senaryolar baz alÄ±narak HHSâler tarafÄ±ndan zenginleÅtirilebilir. \n AÅaÄÄ±daki tabloda yer alan 07-13 arasÄ± RÄ±za Ä°ptal Detay KodlarÄ±nÄ±n oluÅtuÄu senaryolar, HHS uygulamasÄ±nda yapÄ±lan kullanÄ±cÄ± doÄrulama Ã¶ncesi ve sonrasÄ± olarak iki adÄ±mda incelenmelidir. \n HHS tarafÄ±nda, kullanÄ±cÄ± doÄrulama Ã¶ncesinde yapÄ±lan kontroller neticesinde verilemeyen rÄ±zalar iÃ§in â04â : SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor iptal kodu atanÄ±r. HHS'nin YÃS uygulamasÄ±na 04 kodunu iletmesi beklenmez. YÃS zaman aÅÄ±mÄ± neticesinde rÄ±za statÃ¼sÃ¼nÃ¼ sorgulayarak Ã¶Ärenir. \nKullanÄ±cÄ± doÄrulandÄ±ktan sonra rÄ±za verilemiyorsa ilgili hata kodunun YÃS'e iletilmesi beklenmektedir. KullanÄ±cÄ± doÄrulama sonrasÄ± YÃS'e iletilen rÄ±za iptal detay kodu ile HHS veri modelinde tutulan rÄ±za ile iliÅkili rÄ±za iptal detay kodu, aynÄ± deÄeri alacak Åekilde gÃ¼ncellenmelidir. YÃS, HHS tarafÄ±ndan kendine iletilen rÄ±za iptal detay kodunu kendi veri modelinde gÃ¼ncellemelidir. \n Zorunlu olarak belirtilen hata durumlarÄ±nÄ±n HHSâler tarafÄ±ndan gerÃ§eklenmesi ve uygun hata kodlarÄ±nÄ±n YÃSâe iletilmesi; ileride oluÅabilecek mutabakatlaÅma sorunlarÄ±nÄ± ortadan kaldÄ±rabilecek, yapÄ±lacak raporlamalar kapsamÄ±nda sistem ve sÃ¼reÃ§ iyileÅtirmelerine katkÄ± saÄlayacak, son kullanÄ±cÄ± aÃ§Ä±sÄ±ndan da alÄ±nan hataya yÃ¶nelik bilgilendirici iÃ§erik saÄlayacaktÄ±r. \n Hata aÃ§Ä±klamalarÄ±; hata koduna uygun ya da uyumlu olmak kaydÄ±yla, HHS ve YÃS tarafÄ±ndan farklÄ± Åekillerde sunulabilir. \n GKD SÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller \n \n \n \n RÄ±za Ä°ptal Detay Kodu \n HHS hata aÃ§Ä±klamasÄ±* \n YÃ¶s ekranÄ±nda listelenecek Ã¶rnek mesaj metni* \n Ãrnek Senaryo \n Zorunlu / Opsiyonel \n \n \n \n \n 07 \n RÄ±za mevcut ve durumu \"Yetkilendirildi\" veya \"Yetki KullanÄ±ldÄ±\" \n Yetki HatasÄ± \n ÃHK,  kullanÄ±cÄ± doÄrulama iÅlemi tamamlandÄ±ktan sonra  YÃS ekranÄ±nda ileri - geri yaparak ya da ÃHK'nÄ±n yÃ¶nlendirme adresini kopyalayarak tarayÄ±cÄ±ya yapÄ±ÅtÄ±rmasÄ± ile tekrar HHS'ye yÃ¶nlendirir. Bu durumda HHS bu rÄ±za iptal detay kodunu iletir. HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 08 \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±. \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n YÃS tarafÄ±ndan baÅlatÄ±lan rÄ±za iÃ§erisinde yer alan kimlik bilgisi (Ã¶rn:TCKN) ile HHS'de baÅarÄ±lÄ± kimlik doÄrulama yapÄ±lan ÃHK'nÄ±n bilgilerinin uyuÅmadÄ±ÄÄ± durumda  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 09 \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) \n GÃ¶sterilebilecek hesap/kart bulunamamÄ±ÅtÄ±r. \n HHS, kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra, ÃHK'nÄ±n uygun statÃ¼lÃ¼ hesabÄ±nÄ±n olmadÄ±ÄÄ± durumda  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 10 \n ÃHK'nÄ±n AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n ÃHK'nÄ±n AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n AÃ§Ä±k bankacÄ±lÄ±ÄÄ± ayrÄ± bir kanal olarak tanÄ±mlamÄ±Å HHS'lerde,

16ÃHK kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra yapÄ±lan kontrollerde, ÃHK'nÄ±n iÅlemlerini AB kanalÄ±na kapatmÄ±Å olmasÄ± durumunda   HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Opsiyonel \n \n \n 11 \n ÃHK'nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmamasÄ± \n Yetki hatasÄ± \n 1- Kurumsal firma kullanÄ±cÄ±larÄ±nÄ±n hesaplar Ã¼zerinde iÅlem yetkisinin olmamasÄ± durumunda   2- Bireysel ortak hesaplarda hesap kÄ±sÄ±tÄ± bulunuyorsa (para Ã§Ä±kÄ±ÅÄ±na izin verilmediÄi durum)  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 12 \n HHSânin,  ÃHK Ã¶zelinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ± \n Yetki hatasÄ± \n HHS'nin, kullanÄ±cÄ± doÄrulama sonrasÄ± ÃHK iÃ§in iÃ§ sistemlerinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ±. ÃrneÄin: MÃ¼Återinin henÃ¼z bankacÄ±lÄ±k hizmet sÃ¶zleÅmesi gibi Internet Åubesi Ã¼zerinde iÅlem yapmasÄ±nÄ± engelleyen eksikleri olmasÄ± durumunda veya kurumsal kullanÄ±cÄ±da vekalet sÃ¼resinin dolmasÄ±/eksik dokÃ¼man olmasÄ± durumunda kanal Ã¼zerinde iÅlem yapamadÄ±ÄÄ± durum  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Opsiyonel \n \n \n 13 \n ÃHK isteÄi ile GKDâden vazgeÃ§ilmesi \n MÃ¼Återi iÅlemden vazgeÃ§miÅtir. \n HHS ekranÄ±nda yer alan VAZGEÃ butonuna basÄ±lmasÄ± durumu (ÃHK,HHS uygulamasÄ±nda kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra VAZGEÃ butonu olabilir.) \n Zorunlu \n \n \n 14 \n GKD Ä°ptali: Fraud ÅÃ¼phesi \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n HHS Fraud ÅÃ¼phesi nedeniyle iÅlemin devamÄ±na izin vermez. HHS'nin, fraud kontrollerinin Ã¶deme baÅlatma hizmeti iÃ§in yapmasÄ± ve â14- GKD Ä°ptali: Fraud ÅÃ¼phesiâ ile rÄ±za iptalini gerÃ§ekleÅtirmelidir. HBH servislerinde HHS'nin rÄ±za iptal kodu 14 ile iÅlemi kesmesi HHS'nin kendi insiyatifindedir yani opsiyoneldir. \n KoÅullu \n \n \n 99 \n DiÄer \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n OluÅabilecek diÄer senaryolar. \n Zorunlu \n \n \n \n GKD sÄ±rasÄ±nda iletilen rÄ±za no eÄer HHSânin sisteminde bulunamazsa durumu gÃ¼ncellenecek bir rÄ±za no da olmayacaktÄ±r. HHS kendi Ã¶nyÃ¼zÃ¼nde bu duruma uygun bir mesaj gÃ¶sterebilir. YÃSâe de DiÄer hata kodu ile bu durumu iletebilir. \n"},{title:"POST /erisim-belirteci",frontmatter:{},regularPath:"/v1.0.2/contents/erisim-belirteci.html",relativePath:"v1.0.2/contents/erisim-belirteci.md",key:"v-485bbe8d",path:"/v1.0.2/contents/erisim-belirteci.html",content:" POST /erisim-belirteci \n Ä°STEK: \n YÃS erisim-belirteci eriÅim adresini 2 amaÃ§la kullanÄ±r: \n \n \n Bir Ã¶nceki adÄ±mdan aldÄ±ÄÄ± rizaNo, rizaTip (Ã¶deme emri baÅlatma hizmetinde âOâ, hesap bilgisi hizmetinde âHâ) ve GKD sonrasÄ± dÃ¶nÃ¼len yetKod bilgilerini kullanarak HHS nezdinde ErisimBelirteci nesnesi oluÅturmak Ã¼zere istekte bulunur. YÃSâÃ¼n istekte bulunabilmesi iÃ§in GKD adÄ±mÄ±nÄ±n baÅarÄ±lÄ± bir Åekilde tamamlanmasÄ± rizaDrm bilgisinin âyetkilendirildiâ olmasÄ± gerekir. EriÅim Belirteci nesnesi ile rÄ±zasÄ± nesnesi (Ãdeme Emri RÄ±zasÄ± veya Hesap Bilgisi RÄ±zasÄ±) arasÄ±ndaki iliÅki rÄ±za numarasÄ± Ã¼zerinden saÄlanÄ±r. \n \n \n AldÄ±ÄÄ± eriÅim belirtecinin GeÃ§erlilik SÃ¼resinin dolduÄu durumda, yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci almasÄ± gerekmektedir. \n \n \n POST /erisim-belirteci isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âErisimBelirteciIstegiâ nesnesi (Tablo-23) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âErisimBelirteciâ nesnesi (Tablo 24) oluÅturulur veya (Yenileme Belirteci iÃ§in) gÃ¼ncellenir. RÄ±za durumu âYetki KullanÄ±ldÄ±â olarak gÃ¼ncellenir. \n EriÅim Belirteci POST iÅlemi sonucunda HTTP 200 dÃ¶nÃ¼lmesi gerekmektedir. \n Tablo 23: âErisimBelirteciIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±zaNo \n rizaNo \n AN1..128 \n Z \n RÄ±za nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n RÄ±za Tipi \n rizaTip \n AN1 \n Z \n O veya H (TR.OHVPS.DataCode.RizaTip) \n \n \n Yetki Tipi \n yetTip \n AN1..50 \n Z \n âyet_kodâ yada âyenileme_belirteciâ deÄerini alabilir.  (TR.OHVPS.DataCode.YetTip) \n \n \n Yetki Kodu \n yetKod \n AN1..255 \n K \n GKD iÅleminden dÃ¶nen yetkilendirme kodudur. Tek kullanÄ±mlÄ±k olup, aynÄ± yetKod ile birden fazla token alÄ±namaz. yetKod Parametresinin yaÅam Ã¶mrÃ¼ 5 dakika olmalÄ±dÄ±r. yetTip = âyet_kodâ ise zorunludur. \n \n \n Yenilenme Belirteci \n yenilemeBelirteci \n AN1..4096 \n K \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r. yetTip = âyenileme_belirteciâ ise kullanÄ±mÄ± zorunludur. \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âerisimBelirteciâ nesnesinde (Tablo-19) bulunan eriÅim belirteci deÄeri Ã¶deme emrinin baÅlatÄ±lmasÄ± esnasÄ±nda kullanÄ±lÄ±r. \n Tablo 24: \"ErisimBelirteci\" nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n EriÅim Belirteci \n erisimBelirteci \n AN1..4096 \n Z \n Yetkilendirme Kodu karÅÄ±lÄ±ÄÄ±nda HHS tarafÄ±ndan dÃ¶nÃ¼len ve sonraki hesap bilgisi ve Ã¶deme emri servislerine eriÅimde kullanÄ±lan bilgidir. \n \n \n GeÃ§erlilik SÃ¼resi \n gecerlilikSuresi \n N1..9 \n Z \n EriÅim Belirtecini saniye cinsinden geÃ§erlilik sÃ¼residir.  EriÅim belirteci geÃ§erli olduÄu son tarih ; Hesap Bilgisi RÄ±zasÄ± iÃ§in en fazla 30 gÃ¼n olmalÄ±dÄ±r. EriÅimin GeÃ§erli OlduÄu Son Tarih(erisimIzniSonTrh); EriÅim Belirteci GeÃ§erlilik SÃ¼resi'nden kÃ¼Ã§Ã¼k ise EriÅimin GeÃ§erli OlduÄu Son Tarih deÄeri ile sÄ±nÄ±rlÄ±dÄ±r. Ãdeme BaÅlatma RÄ±zasÄ± iÃ§in 5 dakika olmalÄ±dÄ±r. \n \n \n Yenileme Belirteci \n yenilemeBelirteci \n AN1..4096 \n Z \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r. \n \n \n Yenileme Belirteci GeÃ§erlik SÃ¼resi \n yenilemeBelirteciGecerlilikSuresi \n N1..9 \n Z \n Yenileme belirtecinin saniye cinsinden geÃ§erlilik sÃ¼residir. Yenileme belirtecinin geÃ§erli olduÄu son tarih ; Hesap Bilgisi iÃ§in EriÅimin GeÃ§erli OlduÄu Son Tarih ile sÄ±nÄ±rlÄ± olmalÄ±dÄ±r. Bu tarih geldiÄi zaman Hesap Bilgisi RÄ±za Durumunu âYetki SonlandÄ±rÄ±ldÄ±â statÃ¼sÃ¼ne Ã§ekilmesi gerekir. Ãdeme BaÅlatma iÃ§in RÄ±za OluÅturma ZamanÄ±ndan 15 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. 15 gÃ¼n sÃ¼resi sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. Ä°leri vadeli iÅlemler bu kapsamda deÄildir.  Ãdeme emri 5 dakika iÃ§inde gerÃ§ekleÅtirilmelidir. GerÃ§ekleÅmediÄinde 4.2.8 bÃ¶lÃ¼mÃ¼nde aktarÄ±lan rÄ±za statÃ¼ gÃ¼ncellemesi yapÄ±lmalÄ±dÄ±r. \n \n \n \n erisim-belirteci erisim noktasÄ±ndan elde edilen erisimBelirteci, iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda x-access-token alanÄ±nda iletilir. \n Yenilenme Belirteci (refreshToken) kullanÄ±larak EriÅim Belirteci (accessToken) alÄ±ndÄ±ÄÄ±nda, dÃ¶ne

16n yanÄ±ttaki Yenileme Belirteci GeÃ§erlik SÃ¼resi (yenilemeBelirteciGecerlilikSuresi) geÃ§en sÃ¼re eksiltilerek, kalan zamanÄ±n saniye cinsinden hesaplanmasÄ±yla iletilmelidir. \n Yenileme Belirteci ile EriÅim Belirteci gÃ¼ncellendiÄinde, HHS'den dÃ¶nen yenilemeBelirteci deÄeri deÄiÅebilir, YÃS bu gÃ¼ncel anahtarÄ± saklamalÄ± ve sonraki erisimBelirteci isteÄini yenilenmiÅ olan yenilemeBelirteci ile yapmalÄ±dÄ±r. \n EriÅim Belirteci API Ã§aÄrÄ±mÄ± sÄ±rasÄ±nda rÄ±za durumlarÄ± kontrol edilmelidir. Bu kontrollerin nasÄ±l yapÄ±lmasÄ± gerektiÄi 4-RÄ±za DurumlarÄ± bÃ¶lÃ¼mÃ¼nde aktarÄ±lmÄ±ÅtÄ±r. \n Yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda hata alÄ±nmasÄ± durumunda, HHS'nin dÃ¶ndÃ¼ÄÃ¼ hata yanÄ±tÄ±nda httpCode = 401 ve errorCode = \"TR.OHVPS.Connection.InvalidToken\" geldiÄi durumda, YÃS tarafÄ±ndan HHS'ye ilgili rÄ±za iÃ§in sistemsel olarak iptal isteÄi gÃ¶nderilmelidir. \n"},{title:"2.Kapsam ve Dayanak",frontmatter:{},regularPath:"/v1.0.2/contents/kapsam-ve-dayanak.html",relativePath:"v1.0.2/contents/kapsam-ve-dayanak.md",key:"v-3539d41d",path:"/v1.0.2/contents/kapsam-ve-dayanak.html",content:" 2.Kapsam ve Dayanak \n 12 KasÄ±m 2019âda gÃ¼ncellenen â 6493 sayÄ±lÄ± Ãdeme ve Menkul KÄ±ymet Mutabakat Sistemleri, Ãdeme Hizmetleri ve Elektronik Para KuruluÅlarÄ± HakkÄ±nda Kanun âun (Kanun) 12ânci maddesine yeni eklenen ve  Ãdeme Hizmetleri Direktifi 2 'de (Payment Services Directive 2, PSD2) bulunan iki yeni Ã¶deme hizmeti aÅaÄÄ±daki gibi tanÄ±mlanmÄ±ÅtÄ±r (Åekil-1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri): \n \n Ãdeme Emri BaÅlatma Hizmeti : ÃHKânÄ±n isteÄi Ã¼zerine baÅka bir Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nda bulunan  Ã¶deme hesabÄ±yla  ilgili sunulan Ã¶deme emri baÅlatma hizmeti [Madde 12, birinci fÄ±kra, (f) bendi] \n Hesap Bilgisi Hizmeti : ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± koÅuluyla, ÃHKânÄ±n Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ± nezdinde bulunan bir veya daha fazla  Ã¶deme hesabÄ±na  iliÅkin konsolide edilmiÅ bilgilerin Ã§evrim iÃ§i platformlarda sunulmasÄ± hizmeti [Madde 12, birinci fÄ±kra, (g) bendi] \n \n   \n Åekil 1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS)- tanÄ±tÄ±m \n Kanunun 14/A maddesinin ikinci fÄ±krasÄ±na gÃ¶re , Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetleri ile ilgili iÅlemlerin yÃ¼rÃ¼tÃ¼lmesine iliÅkin usul ve esaslar ile taraflarca uyulmasÄ± gereken teknik ve operasyonel gereklilikler ikincil dÃ¼zenlemeler uyarÄ±nca TÃ¼rkiye Cumhuriyet Merkez BankasÄ± (TCMB) tarafÄ±ndan belirlenir. Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri  Ã¶deme hizmetleri veri paylaÅÄ±m servisleri (ÃHVPS)  olarak adlandÄ±rÄ±lmaktadÄ±r. \n Ãdeme Hizmetleri ve Elektronik Para Ä°hracÄ± ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± HakkÄ±nda YÃ¶netmelikâin (YÃ¶netmelik) 59âuncu maddesinin birinci fÄ±krasÄ± uyarÄ±nca hazÄ±rlanan bu belgede sÃ¶z konusu Ã¶deme hizmetlerini sunacak Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, Ã¶deme hesabÄ±nÄ±n bulunduÄu Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, varsa ilgili diÄer taraflarÄ±n ve bu hizmetlerin sunulmasÄ± iÃ§in taraflar arasÄ±nda kurulacak baÄlantÄ±nÄ±n teknik ve operasyonel gereklilikleri aÃ§Ä±klanmaktadÄ±r. \n DÃ¼zenlemeler kapsamÄ±nda yetkilendirilen Ã¼Ã§Ã¼ncÃ¼ taraf hizmet saÄlayÄ±cÄ±sÄ±  (Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ±, YÃS) , Ã¶deme hizmeti kullanÄ±cÄ±larÄ±nÄ±n  Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS)  nezdindeki Ã¶deme hesaplarÄ±na ulaÅarak Ã¶deme emri baÅlatma ve hesap bilgisi saÄlama hizmetlerinden (Ã¶deme hizmetleri veri paylaÅÄ±m servislerinden) faydalanmasÄ±na aracÄ±lÄ±k eder. Ãdeme hizmetleri veri paylaÅÄ±m servisleri kapsamÄ±nda iki tip YÃS bulunmaktadÄ±r:  1) Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ve 2) Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS). \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ÃHKânÄ±n farklÄ± Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS) nezdindeki hesaplarÄ±nÄ±n bilgilerini derleyerek Ã§evrim iÃ§i platformlarda  toplu Åekilde  sunar. Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS) ise talebi Ã¼zerine ÃHKânÄ±n HHSâde bulunan Ã¶deme hesabÄ±ndan Ã¶deme iÅlemi baÅlatÄ±r. \n ÃHVPSânin Ã¼st dÃ¼zey gÃ¶sterimi Åekil-2âde verilmiÅtir. \n   \n Åekil 2: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS) -Ã¼st dÃ¼zey gÃ¶sterim \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servislerinin HHSâler tarafÄ±ndan  BKM API GeÃ§idi  vasÄ±tasÄ±yla sunulduÄu uygulama mimarisi ise Åekil-3âte sunulmuÅtur. \n  \n Åekil 3: ÃHVPS'nin BKM API GeÃ§idi vasÄ±tasÄ±yla sunumu \n"},{title:"7.\tHesap Bilgisi Hizmeti",frontmatter:{},regularPath:"/v1.0.2/contents/hesap-bilgisi-hizmeti.html",relativePath:"v1.0.2/contents/hesap-bilgisi-hizmeti.md",key:"v-f0808a06",path:"/v1.0.2/contents/hesap-bilgisi-hizmeti.html",headers:[{level:2,title:"Genel Bilgiler",slug:"genel-bilgiler"},{level:2,title:"Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri",slug:"hesap-bilgisi-hizmeti-icin-erisim-adresleri"}

16,{level:2,title:"ADIM 0: ÃHK'nÄ±n hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:",slug:"adim-0-ohk-nÄ±n-hesap-bilgilerine-erisim-icin-talepte-bulunmasÄ±"},{level:2,title:"7.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_7-1-adim-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:3,title:"POST /hesap-bilgisi-rizasi",slug:"post-hesap-bilgisi-rizasi"},{level:3,title:"BaÅarÄ±lÄ± Ä°stek:",slug:"basarÄ±lÄ±-istek"},{level:3,title:"BaÅarÄ±lÄ± YanÄ±t:",slug:"basarÄ±lÄ±-yanÄ±t"},{level:2,title:"Ä°zinler",slug:"izinler"},{level:2,title:"7.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi",slug:"_7-2-adim-2-hesap-bilgisi-hizmeti-rÄ±zasÄ±nÄ±n-tesisi"},{level:2,title:"7.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ±",slug:"_7-3-adim-2-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±"},{level:2,title:"7.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali",slug:"_7-4-adim-2-2-hesap-bilgisi-rÄ±zasÄ±nÄ±n-iptali"},{level:2,title:"7.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ±",slug:"_7-5-adim-3-hesap-bilgilerinin-alÄ±nmasÄ±"},{level:2,title:"7.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ±",slug:"_7-6-adim-3-1-ve-3-2-hesap-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"7.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ±",slug:"_7-7-adim-3-3-ve-3-4-hesap-bakiyesinin-sorgulanmasÄ±"},{level:2,title:"7.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ±",slug:"_7-8-adim-3-5-ve-3-6-islemlerin-sorgulanmasÄ±"},{level:2,title:"7.9\tHealthcheck API",slug:"_7-9healthcheck-api"},{level:3,title:"BaÅarÄ±lÄ± YanÄ±t:",slug:"basarÄ±lÄ±-yanÄ±t-2"}],content:" 7.\tHesap Bilgisi Hizmeti  \n Genel Bilgiler \n Hesap bilgisi sorgulama iÃ§in HBHS tarafÄ±ndan mÃ¼Återi rÄ±zasÄ± tesisinin HHS tamamlanmÄ±Å olmasÄ± gerekir. MÃ¼Återi rÄ±zasÄ± tesisi tamamlandÄ±ktan sonra, HBHS sorgulamak istediÄi hesaba ait verileri ilgili eriÅim adresi Ã¼zerinden sorgular. \n \n \n Åekil 10: Hesap Bilgisi Hizmeti Ãst DÃ¼zey AkÄ±ÅÄ± \n Åekil-10âda sunulan hesap bilgisi hizmeti 5 temel akÄ±Åtan oluÅur: \n 0.\tMÃ¼Återinin hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:  ÃHK ÃBHS mobil uygulama ya da web sitesinden hesap bilgilerine eriÅim iÅlemini baÅlatÄ±r. \n 1.\tHesap Bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n hazÄ±rlanmasÄ±: \n HBHS, âhesap bilgilerine eriÅimâ iÃ§in mÃ¼Återi rÄ±zasÄ± tesisi amacÄ±yla HHSâdeki hesap bilgisi rÄ±zasÄ± eriÅim adresine bir POST isteÄinde bulunur ve bir hesap bilgisi rÄ±zasÄ± nesnesi oluÅturur. HHS hesap bilgisi rÄ±zasÄ± nesnesi iÃ§in biricik tanÄ±mlayacÄ± dÃ¶ner (RÄ±zaNo). Hesap bilgisi rÄ±zasÄ±, mÃ¼Återinin HBHSânin hesap bilgilerine eriÅim izin verdiÄi alanlarÄ± iÃ§erir: \n \n Ä°zinler - eriÅim iÃ§in izin verilen veri kÃ¼melerinin listesi. \n EriÅimin GeÃ§erli OlduÄu Son Tarih - HBHS'nin mÃ¼Återinin hesap bilgilerine eriÅebileceÄi isteÄe baÄlÄ± seÃ§ilebilen son tarih. \n Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± â MÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden itibaren geriye dÃ¶nÃ¼k olarak HBHSânin hesap bilgilerine eriÅebileceÄi sÃ¼reyi \n Ä°Ålem Sorgulama BitiÅ ZamanÄ± - MÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden itibaren ileriye dÃ¶nÃ¼k olarak HBHSânin hesap bilgilerine eriÅebileceÄi sÃ¼reyi \n \n 2.\tHesap bilgisi hizmeti mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi: \n HHS, Hesap Bilgisi RÄ±zasÄ± servisi ile ÃHK Ã¶zelinde âYetki bekleniyorâ statÃ¼sÃ¼nde bir rÄ±za nesnesi hazÄ±rlar. HHS, GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda hesap bilgisi rÄ±zasÄ± nesnesinin yetkilendirildiÄini belirtmek iÃ§in RÄ±za Durumunu âRÄ±za Yetkilendirildiâ olarak gÃ¼nceller. Nesne yetkilendirildikten sonra HHS nesne ile bir eriÅim belirteci (access token) iliÅkilendirir, RÄ±za Durumunu âYetki KullanÄ±ldÄ±â yapar ve bu belirteci HBHSâye geri dÃ¶ner.  BÃ¶ylece mÃ¼Återi rÄ±za tesisi saÄlanmÄ±Å olur. \n Hesap bilgisi iÃ§in mÃ¼Återi rÄ±zasÄ±na iliÅkin temel ilkeler ÅunlardÄ±r: \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de Yetki Bekleniyor, Yetkilendirildi, Yetki KullanÄ±ldÄ± statÃ¼sÃ¼nde 1 rÄ±zasÄ± olabilir. \n MÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± ÃHK ile HBHS arasÄ±nda belirlenir. Bu nedenle mÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± HHS ekranÄ±nda deÄiÅtirilmemelidir. \n ÃHK, hesap eriÅim izni ayrÄ±ntÄ±larÄ±nÄ± yalnÄ±zca bir bÃ¼tÃ¼n olarak yetkilendirebilir veya geri alabilir. \n MÃ¼Återi rÄ±zasÄ± tesisi esnasÄ±nda, mÃ¼Återi HHS arayÃ¼zÃ¼nde eriÅim iÃ§in yetkilendirecek hesaplarÄ± seÃ§er. \n \n 2.1\tHesap bilgisi rÄ±zasÄ±nÄ±n sorgulanmasÄ±:  MÃ¼Återi rÄ±zasÄ±  GET/hesap-bilgisi-rizasi/{RizaNo}  Ã§aÄrÄ±sÄ± yapÄ±larak sorgulanÄ±r. \n 2.2\tHesap bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n iptali:  MÃ¼Återi rÄ±zasÄ±  DELETE/hesap-bilgisi-rizasi/{RizaNo}

16  Ã§aÄrÄ±sÄ± yapÄ±larak iptal edilir. \n 3.\tHesap bilgilerinin alÄ±nmasÄ±:  Hesap bilgileri ilgili kaynaÄa (hesaplar, bakiye, iÅlemler) GET isteÄi yapÄ±larak gerÃ§ekleÅtirilir. HBHS, mÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden sonrasÄ±nda (geÃ§erli bir eriÅim belirticine sahip olduÄunda) Ã¶ncelikle  GET/hesaplar  Ã§aÄrÄ±sÄ± yapacaktÄ±r. \n Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n hesap-bilgisi-rizasi \n POST \n /hesap-bilgisi-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n HesapBilgisiRizasiIstegi \n HesapBilgisiRizasi \n \n \n 2 \n erisim-belirteci  (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n \n HesapBilgisiRizasi \n \n \n 2.2 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n \n \n \n \n \n \n 3.1 \n hesaplar \n GET \n /hesaplar \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n HesapBilgileri(birden Ã§ok hesap) \n \n \n 3.2 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n HesapBilgileri(tek  hesap) \n \n \n 3.3 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n BakiyeBilgileri(tek  hesap) \n \n \n 3.4 \n bakiye \n GET \n /bakiye \n Ä° \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n BakiyeBilgileri(birden Ã§ok hesap) \n \n \n 3.5 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n IslemBilgileri (tek hesap) \n \n \n \n Tablo 11: Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n ADIM 0: ÃHK'nÄ±n hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±: \n ÃHK, HBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) hesap bilgilerine eriÅim iÃ§in talepte bulunur. \n 7.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n Bu API Ã§aÄrÄ±sÄ± HBHS'nin HHS'de yeni bir âHesapBilgisiRizasiâ nesnesi oluÅturmasÄ±nÄ± ve nesneye eriÅmek iÃ§in benzersiz bir rÄ±za numarasÄ± ({RizaNo}) dÃ¶nÃ¼lmesini saÄlar. \n API Ã§aÄrÄ±sÄ±nÄ±n baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± yeterlidir.\nBaÅarÄ±yla oluÅturulan hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n rÄ±za durumu âYetki Bekleniyorâ olarak dÃ¼zenlenir.\nÃHK daha Ã¶nce aldÄ±ÄÄ± rÄ±zaya iliÅkin eriÅim tarihleri, izin tÃ¼rlerini ve hesap bilgilerini gÃ¼ncellemek isterse, HBHS Ã¶nce HHS nezdindeki rÄ±zayÄ± iptal etmeli ve sonrasÄ±nda yeni bir rÄ±za talebinde bulunmalÄ±dÄ±r.\n \n \n Åekil 11: Hesap Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n POST /hesap-bilgisi-rizasi isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âHesapBilgisiRizasÄ±Istegiâ nesnesi (Tablo-12) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âHesapBilgisiRizasiâ (Tablo-13) nesnesi oluÅturulur. \n  POST /hesap-bilgisi-rizasi \n BaÅarÄ±lÄ± Ä°stek: \n Ä°STEK: \n HBHS, bu API eriÅim adresinden HHSâye yeni bir HesapBilgisiRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n HBHS, ÃHKânÄ±n hesap bilgilerine yÃ¶nelik rÄ±za baÅlatma isteÄi olduÄunu HHSâye bildirir. \n HBHS, ÃHKânÄ±n, HBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n API dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk ve uzunluk kontrollerini yapar. (Zorunlu) \n HHS; YÃS API ile alÄ±nan HBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme ve bildirim adresleri ile Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini y

16apar. (Zorunlu) \n HHS; kimlik bilgileri nesnesinde iletilen kimlik bilgileri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (Zorunlu) \n EriÅimin GeÃ§erli OlduÄu Son Tarih, Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, Ä°Ålem Sorgulama BitiÅ ZamanÄ± alanlarÄ± ile ilgili Tablo 12âde belirtilen kontroller yapÄ±lmalÄ±dÄ±r. (Zorunlu) \n HHS, benzersiz âRizaNoâ ile âHesapBilgisiRizasiâ nesnesi oluÅturur ve HBHSâye dÃ¶ner. \n HHS, HesapBilgisiRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n \n EriÅimin GeÃ§erli OlduÄu Son Tarih, Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, Ä°Ålem Sorgulama BitiÅ ZamanÄ± alanlarÄ±nda zaman aralÄ±klarÄ± mÃ¼Återi deneyimi penceresinden deÄerlendirilerek ay cinsinden belirtilmiÅtir. Bu konuda aÅaÄÄ±daki gibi oluÅabilecek uÃ§ Ã¶rneklere dikkat edilmesi gerekmektedir. \n BugÃ¼n : 31.08.2019 \nBugÃ¼n + 6 Ay : 29.02.2020 \nBugÃ¼n : 30.08.2020 \nBugÃ¼n + 6 Ay : 28.02.2021\nBugÃ¼n : 30.09.2022 \nBugÃ¼n + 3 Ay : 30.12.2022\nBugÃ¼n : 14.07.2022 \nBugÃ¼n + 3 Ay : 14.10.2022 \n Tablo 12: âHesapBilgisiRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. Hata durumunda TR.OHVPS.Connection.InvalidASPSP hata kodunu dÃ¶ner. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda TR.OHVPS.Connection.InvalidTPP hata kodunu dÃ¶ner. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Yetkilendirme yÃ¶ntemi, HBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur.  YÃS YÃ¶nlendirmeli GKD yÃ¶ntemi ile akÄ±ÅÄ± destekliyorsa, yetYntm deÄiÅkeninden baÄÄ±msÄ±z olarak yÃ¶nlendirme adresini iletmelidir. Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur.  YÃS AyrÄ±k GKD yÃ¶ntemi ile akÄ±ÅÄ± destekliyorsa, yetYntm deÄiÅkeninden baÄÄ±msÄ±z olarak bildirim adresini iletmelidir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, ayrÄ±k GKD sonrasÄ± bu alanda belirtilen adrese otorizasyon kodunu (authentication code) iletir. \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r.   TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n \n Hesap Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n \n >Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih.   MÃ¼Återi YÃS ekranÄ±ndan bu deÄeri belirleyebilir.   VarsayÄ±lan deÄer : RÄ±za verilen tarih + 6 ay   AlabileceÄi maksimum deÄer : RÄ±za tarihi + 6 ay    AlabileceÄi minimum deÄer : RÄ±za tarihi + 1 gÃ¼n   ÃrneÄin 23/09/202

161âde minimum 24/09/2021 seÃ§ilebilir. Bu durumda izin 24/09/2021 23:59:59âda bitecek Åekilde olmalÄ±dÄ±r. \n Bu alanda bir deÄer bulunmadÄ±ÄÄ± durumda HHS hata dÃ¶nmelidir. \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geÃ§miÅe dÃ¶nÃ¼k en fazla 12 ay olabilir, daha eski olmamasÄ± gerekir.   VarsayÄ±lan deÄeri rÄ±za verilen tarih (iÅlem zamanÄ±) â 12 aydÄ±r.   ÃHK bu alana bir deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.   Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  - 12 ay    Maksimum tarih: RÄ±zanÄ±n veriliÅ tarihi +  12 ay    Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve  Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geleceÄe dÃ¶nÃ¼k en fazla 12 ay sonrasÄ± olabilir, daha ileri bir tarih olmamasÄ± gerekir.   VarsayÄ±lan deÄeri: RÄ±za verilen tarih + 12 aydÄ±r.  ÃHK bu alana bir deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.  Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  â 12 ay  Maksimum tarihi :  RÄ±zanÄ±n veriliÅ tarihi + 12 ay   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. EÄer dolu gÃ¶nderilirse HHS tarafÄ±ndan uygun hata mesajÄ± iletilmelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve Ä°Ålem Sorgulama BitiÅ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez.   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n BaÅarÄ±lÄ± YanÄ±t: \n Tablo 13: HesapBilgisiRizasi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. Ãrn; hesap bilgi rÄ±zasÄ±nÄ±n tesisine dair ilk istek mesajÄ±na dÃ¶nÃ¼Åte âB: Yetki Bekleniyorâ deÄerini almasÄ± beklenir. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n K \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r.  TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n HHS, ayrÄ±k GKD sonrasÄ± bu alanda belirtilen YÃS adresine otorizasyon kodunu (authentication code) iletir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.  HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir. RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Hesap Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n > Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HBHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi baÅlangÄ±Ã§ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi bitiÅ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n > AyrÄ±ntÄ± Bilgi \n ayrBlg \n Kompleks: AyrintiBilgi \n Ä° \n \n \n \n > ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n Ä°zinler \n Bir hesap bilgisi mÃ¼Återi rÄ±zasÄ± kaynaÄÄ± Ã§aÄrÄ±sÄ±na yanÄ±t olarak dÃ¶ndÃ¼rÃ¼len verileri sÄ±nÄ±rlamak iÃ§in izin kodlarÄ± kullanÄ±lÄ±r: \n \n Temel Hesap Bilgisi \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n Bakiye Bilgisi \n Temel Ä°Ålem (Hesap Hareketleri) Bilgisi \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n \n ÃHKâya sunulacak seÃ§imler ve kurallarÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r. \n \n \n \n SeÃ§im \n Kural \n \n \n \n \n Temel Hesap Bilgisi \n ÃHK seÃ§imine sunulmamalÄ±dÄ±r. DeÄiÅtirilemez Åekilde seÃ§ili gÃ¶sterilmelidir. \n \n \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Bakiye Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Temel Ä°Ålem (Hesap Hareketleri)  Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n ÃHK seÃ§im yapabilir. AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi seÃ§imi Temel Ä°Ålem Bilgisi seÃ§imini kapsar. (AyrÄ±ntÄ±lÄ± Ä°Ålem bilgisi seÃ§ildiÄinde Temel Ä°Ålem Bilgisi de seÃ§ili olmalÄ±dÄ±r.) \n \n \n \n AÅaÄÄ±daki durumlarda, izin kombinasyonlarÄ±na izin verilmez. HHS, bu hesap eriÅim onaylarÄ±nÄ± 400 (HatalÄ± Ä°stek) yanÄ±t koduyla reddetmelidir: \n \n Ä°zin dizisinin herhangi bir izin tÃ¼rÃ¼ iÃ§ermemesi durumu, \n Ä°zin dizisinde HHS tarafÄ±ndan desteklenmeyen bir izin kodunun yer almasÄ± durumu \n 7.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi \n \n \n Åekil 12: Hesap Bilgisi ÃHK RÄ±zasÄ±nÄ±n Tesisi \n RÄ±za tesisinin baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± ve ardÄ±ndan mÃ¼Återinin HHS tarafÄ±ndan yÃ¶nlendirmeli veya ayrÄ±k GKD ile doÄrulanmasÄ± gerekir. HHS'de oluÅturulan ve rÄ±za durumu âYetki Bekleniyorâ olan bir hesap bilgisi rÄ±zasÄ±, G

16KD sonrasÄ± âYetkilendirildiâ statÃ¼sÃ¼ne gÃ¼ncellenir. HBHS, eriÅim saÄlayacaÄÄ± hesaplarÄ± hesap bilgisi rÄ±zasÄ±nÄ±n tesisinden Ã¶nce seÃ§er. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda, HBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n \n HBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n \n \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n ÃHKâyÄ± doÄrularsa, \n \n \n ÃHK HBHS Ã¼zerinden iÅlem yapÄ±lmasÄ±na izin vereceÄi hesap seÃ§imini yapar. HBHS Ã¼zerinden ÃHKânÄ±n verdiÄi izin bilgilerini ve eriÅim izninin bitiÅ tarihi bilgilerini, HHS bilgilendirme amaÃ§lÄ± ÃHKâya gÃ¶sterir. \n \n \n HHS hesap bilgisiri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=H&drmKod=zzz\n \n \n \n ÃHKâyÄ± doÄrulayamazsa, \n \n \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I &rizaNo=yy&rizaTip=H&rizaIptDtyKod=11&drmKod=zzz\n \n \n \n \n \n \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda, HHS, ÃHKânÄ±n hesap bilgisi hizmetini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister. \n \n AyrÄ±k akÄ±Å HBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek hesap bilgisi rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, Ã¶deme hizmeti kullanÄ±cÄ±sÄ±nÄ± doÄrular. \n ÃHK verdiÄi izin tipi dahilinde bilgileri paylaÅÄ±lacak olan hesaplarÄ± seÃ§er. \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS,  hesap bilgisi rÄ±zasÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. RÄ±za tesisi saÄlanmÄ±Å olur. \n 7.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ± \n GET /hesap-bilgisi-rizasi/{RizaNo} \n ÃHK, HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir veya ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.  Bu durumlarda HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir HesapBilgisiRizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 13âde belirtilen âHesapBilgisiRizasiâ nesnesini dÃ¶nmektedir. \n Durum \nHesapBilgisiRizasi kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki S

16onlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n 7.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali \n \n \n \n Åekil 13: Hesap Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n Geri AlÄ±nmasÄ± \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \n DELETE /hesap-bilgisi-rizasi Ã§aÄrÄ±sÄ±, bir HBHS'nin Ã¶nceden oluÅturulmuÅ bir hesap eriÅim rÄ±zasÄ±nÄ± (yetkili olsun veya olmasÄ±n) silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, HBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \nBu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin HBHS Ã¼zerinden hesap bilgisi rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki hesap bilgisi rÄ±zasÄ± nesnesinin silinmesini saÄlar. \nMÃ¼Återinin HBHSânin veri eriÅim iznini iptal etmesi durumunda HBHS, HHSâde mevcut olan HesapBilgisiRizasi kaynaÄÄ±nÄ± pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. HBHS ayrÄ±ca, sisteminden Hesap EriÅim Ä°zni kaynaklarÄ±nÄ± da temizlemelidir. \nSÃ¶z konusu silme iÅlemi, kayÄ±tlarÄ±n statÃ¼sÃ¼nÃ¼n pasife Ã§ekilmesi ile gerÃ§ekleÅtirilmelidir. SÃ¶z konusu kayÄ±tlar, denetim izlerinin oluÅturulmasÄ± ve saklanmasÄ±na iliÅkin ikincil dÃ¼zenleme hÃ¼kÃ¼mleri kapsamÄ±nda gÃ¼venli Åekilde tutulmalÄ±dÄ±r. \nServis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r. \nÃHK rÄ±zasÄ± baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ olarak gÃ¼ncellenir ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir. \nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir: \nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (HBHS) \n 7.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ± \n    \n \n   \n Åekil 14: Hesap Bilgilerinin AlÄ±nmasÄ± \n Ä°STEK: \nMÃ¼Återi rÄ±zasÄ± tesis edilmiÅ kullanÄ±cÄ± iÃ§in HBHS API eriÅim adresinden HHSâye eriÅilebilir hesap bilgilerini GET isteÄi ile sorgular: \n \n RizaDurumu âYetki KullanÄ±ldÄ±â ise iÅleme baÅlanÄ±r. RizaDurumu farklÄ± bir deÄerde ise âTR.OHVPS.Resource.ConsentMismatchâ hatasÄ±nÄ±n iletilmesi gerekir. \n GET verisinin modele gÃ¶re kontrolÃ¼ yapÄ±lÄ±r (ÃrneÄin: Alan kontrolleri) \n \n GET verisinin mantÄ±ksal kontrolleri yapÄ±lÄ±r. \n 7.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ± \n GET /hesaplar ve GET /hesaplar/{hspRef} \n Bu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bilgilerinin sorgulanÄ±r. Hesap bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re (Temel Hesap Bilgisi veya DetaylÄ± Hesap Bilgisi) yanÄ±tÄ±nda dÃ¶nÃ¼len HesapBilgileri nesnesinin iÃ§eriÄi deÄiÅir.  Tablo 15âte HesapBilgileri nesnesinin iÃ§eriÄi verilmiÅtir. \n Hesap Bilgisi Sorgu ÃrneÄi (TÃ¼m Hesaplar) =  /hesaplar \nHesap Bilgisi Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef} \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 14: Hesap Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa NumarasÄ± \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 15: âHesapBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n Hesap Temel \n hspTml \n Kompleks: HesapTemel \n Z \n Temel Hesap Bilgileri (Temel Hesap Bilgisi varsayÄ±lan izin tÃ¼rÃ¼ olduÄundan Hesap Temel nesnesi zorunlu olarak yanÄ±tta bulunur) \n \n \n > Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. \n \n \n > Hesap NumarasÄ± \n hspNo \n AN26 \n K \n EÄer varsa Ã¶deme hesabÄ±na ait IBAN bilgisi \n \n \n > Hesap Sahibi UnvanÄ± \n hspShb \n AN3..140 \n Z \n Hesap sahibi ya da hesap sahiplerinin ad-soyadÄ±, ticari unvanÄ± \n \n \n > Åube AdÄ± \n subeAdi \n AN3..50 \n K \n EÄer varsa Ã¶deme hesabÄ±nÄ±n baÄlÄ± olduÄu Åubenin adÄ± \n \n \n > KÄ±sa Ad \n kisaAd \n AN3..50 \n K \n EÄer hesap sahibi hesaba ait bir ad tanÄ±mladÄ±ysa, tanÄ±mlanan hesap adÄ± \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi. \n \n \n > Hesap TÃ¼rÃ¼ \n hspTur \n AN1 \n Z \n HesabÄ±n tÃ¼rÃ¼ (bireysel veya ticari). TR.OHVPS.DataCode.HspTur sÄ±rali veri deÄerlerinden birini alÄ±r. \n \n \n > Hesap Tipi \n hspTip \n AN1..32 \n Z \n HesabÄ±n tipi (VADESÄ°Z, KREDÄ°LÄ° vb.).TR.OHVPS.DataCode.HspTip sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >

16Hesap ÃrÃ¼n AdÄ± \n hspUrunAdi \n AN1..140 \n Ä° \n HHS tarafÄ±ndan atanmÄ±Å olan Ã¼rÃ¼n adÄ± bilgisidir. HBHS tarafÄ±ndan ÃHKâya gÃ¶sterilmesi kullanÄ±m kolaylÄ±ÄÄ± saÄlayacaktÄ±r. \n \n \n > Hesap Durumu \n hspDrm \n AN5..50 \n Z \n HesabÄ±n durumunu belirtir. TR.OHVPS.DataCode.HspDrm sÄ±ralÄ± veri tÃ¼rlerinden birini alÄ±r. \n \n \n Hesap Detay \n hspDty \n Kompleks: HesapDetay \n K \n Detay Hesap Bilgileri (Temel Hesap Bilgisine ek olarak Detay Hesap Bilgisi izin tÃ¼rÃ¼ de seÃ§ilmiÅse Hesap Detay nesnesi koÅullu olarak yanÄ±tta bulunur) \n \n \n > AÃ§Ä±lÄ±Å Tarihi \n hspAclsTrh \n ISODateTime \n Z \n Belirtilen hesabÄ±n aÃ§Ä±lÄ±Å tarihi. \n 7.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ± \n GET /bakiye ve GET /hesaplar/{hspRef}/bakiye \nBu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bakiyesi sorgulanÄ±r. \nÄ°stek Ã§aÄrÄ±sÄ±na dÃ¶nÃ¼len âBakiyeBilgileriâ nesnesi Tablo 17âde verilmiÅtir. \n Hesap bakiyelerinin gÃ¶sterilmesi sÄ±rasÄ±nda aÅaÄÄ±da verilen Ã¶rnekler gÃ¶zÃ¶nÃ¼nde bulundurulmalÄ±dÄ±r. \n Ãrnek 1 : ÃHK  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  0 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  -1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 2 : ÃHK  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  1 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  2000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 3 : ÃHK  Hesap Bakiye TutarÄ±  1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  0 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 4 : ÃHK  Hesap Bakiye TutarÄ±  1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  1 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  3000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /bakiye?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 16: âBakiyeBilgileriâ Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 17: âBakiyeBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. \n \n \n Bakiye \n bky \n Kompleks:Bakiye \n Z \n \n \n \n > Hesap Bakiye TutarÄ± \n bkyTtr \n AN1..25 \n Z \n HesabÄ±n bakiyesi. Bloke tutar dÃ¼ÅÃ¼lmeden iletilmelidir.   Tutar alanÄ± regex patterni Åu Åekildedir:  '^-?\\d{1,18}$|^-?\\d{1,18}\\.\\d{1,5}$' \n \n \n > Blokeli Tutar \n blkTtr \n AN1..24 \n K \n Varsa hesapta blokeli tutar bilgisi.     Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n > Bakiye Ä°letilme ZamanÄ± \n bkyZmn \n ISODateTime \n Z \n Bakiyenin iletildiÄi zaman bilgisi. \n \n \n > KrediliHesap \n krdHsp \n Kompleks: KrediliHesap \n K \n \n \n \n >> Kredili Mevduat HesabÄ± Bakiyesi \n kulKrdTtr \n AN1..24 \n Z \n Kredili mevduat tutarÄ±. Kredili bir hesap ise zorunlu.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n >> Kredi Dahil GÃ¶stergesi \n krdDhlGstr \n AN1 \n Z \n Kredili bir hesap ise zorunlu. Bakiye tutarÄ±nÄ±n kredi tutarÄ± dahil edilerek ya da edilmeden iletildiÄini gÃ¶sterir.   0: Kredi tutarÄ± dahil edilmeden bakiye bilgisi iletilmesi durumu   1: Kredi tutarÄ± dahil edilerek bakiye bilgisi iletilmesi durumu \n 7.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ± \n GET /hesaplar/{hspRef}/islemler \n Belirli bir hesaba iliÅkin iÅlem bilgileri Tablo 1âdaki istek parametrelerine gÃ¶re sorgulanÄ±r. \nÄ°Ålem bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re yanÄ±tta dÃ¶nen IslemBilgileri nesnesinin (Temel Ä°Ålem Bilgisi veya Temel Ä°Ålem Bilgisi ve DetaylÄ± Ä°Ålem Bilgisi) iÃ§eriÄi deÄiÅir. \nÄ°Ålemler servisi hem ÃHKânÄ±n talebi ile YÃS uygulamasÄ± Ã¼zerinden Ã§aÄrÄ±labileceÄi gibi, YÃSâÃ¼n ÃHKâsÄ±z baÅlatabileceÄi otomatik Ã§aÄrÄ±larÄ± ile de yanÄ±t dÃ¶nebilmektedir. \nHHS, iÅlemin sistemsel yapÄ±lÄ±p yapÄ±lmadÄ±ÄÄ±nÄ±, istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir.\nÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \nYÃS, otomatik yapacaÄÄ± sorgularda; \n \n Bireysel ÃHKâlar iÃ§in hesap bazÄ±nda gÃ¼nde en fazla 4 adet baÅarÄ± ile sonuÃ§lanan sorgulama yapabilir. \n Kurumsal ÃHKâlar iÃ§in hesap bazÄ±nda saatte en fazla 12 adet baÅarÄ± ile sonuÃ§lanan sorgulama yapabilir. \n \n HHS, tutacaÄÄ± sayaÃ§ bilgisi ile bu sayÄ±larÄ± kontrol ederek daha fazla sorgulama yapÄ±lmasÄ±na izin vermeyebilir. \n AynÄ± istek parametreleri ile yapÄ±lan sorgu sonucunda dÃ¶necek toplam kayÄ±t sayÄ±sÄ± 100âÃ¼ aÅtÄ±ÄÄ±nda, sayfalama yÃ¶ntemi ile HHSânin cevap dÃ¶nmesi beklenmektedir.  Her bir sayfa iÃ§in iÅlemler servisi tekrar Ã§aÄrÄ±lsa da, bu Ã§aÄrÄ±m HHSânin tuttuÄu sayaÃ§ deÄerini arttÄ±rmaz. HHSânin tutacaÄÄ± sayaÃ§Ä±n kontrol parametreleri YÃS kodu, hesap numarasÄ± ya da referansÄ± olmalÄ±dÄ±r. Sayfa no parametresi varsa ve 1'den bÃ¼yÃ¼k ise iÅlem sayacÄ±nÄ± arttÄ±rmamalÄ±dÄ±r. \n ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden tetiklediÄi iÅlemlerde ise;\nbireysel ÃHKâlar  iÃ§in en fazla 1 aylÄ±k,\nkurumsal ÃHKâlar iÃ§in ise en fazla 1 haftalÄ±k bir pencere aralÄ±ÄÄ±nda sorgulama yapÄ±labilir. \n YÃS, otomatik yapacaÄÄ± sorgularda hem bireysel hem de kurumsal ÃHKâlar iÃ§in 24 saatlik bir pencere aralÄ±ÄÄ±nda sorgulama yapabilir. \n Hesap kapalÄ± olduÄu durumda hesap hareketlerini iletmek istemeyen HHS'lerin  TR.OHVPS.Business.InvalidAccount  hatasÄ± vermeleri beklenir. \n Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /hes

16aplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-06-02T23:59:59+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A \n Tablo 18: Ä°Ålem Listesi Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin baÅlangÄ±Ã§ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. ÃHK tarafÄ±ndan tetiklenen sorgularda;hesapIslemBslTrh ve hesapIslemBtsTrh arasÄ± fark bireysel ÃHKâlar iÃ§in en fazla 1 ay,kurumsal ÃHKâlar iÃ§in ise en fazla 1 hafta olabilir. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;son 24 saat sorgulanabilir. Bu yÃ¼zden hesapIslemBtsTrh-24 saatâten daha uzun bir aralÄ±k sorgulanamaz olmalÄ±dÄ±r. Ä°stek baÅlÄ±ÄÄ±nda yer alan PSU-Initiated alanÄ± âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n \n \n Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin bitiÅ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;Ä°leri vadeli iÅlem emirleri dahil olmadÄ±ÄÄ± iÃ§in; Ä°Ålem Sorgulama BitiÅ ZamanÄ±, her zaman, sorgulama zaman damgasÄ±nÄ± iletecek Åekilde (datetime (now)) iletilmelidir. \n \n \n En DÃ¼ÅÃ¼k Ä°Ålem TutarÄ± \n minIslTtr \n AN1..24 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en dÃ¼ÅÃ¼k iÅlem tutarÄ±.      Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n En YÃ¼ksek Ä°Ålem TutarÄ± \n mksIslTtr \n AN1..24 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en yÃ¼ksek iÅlem tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n BorÃ§ Alacak GÃ¶stergesi \n brcAlc \n AN1 \n Ä° \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Hesaba borÃ§ yaratan iÅlem.A: Hesaba alacak yaratan iÅlem.{âBâ,âAâ} \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âislGrckZamanâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini islGrckZaman olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 19: âIslemBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap Referans NumarasÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. \n \n \n Islemler \n isller \n Kompleks:Islem[Array] \n K \n Hesaba iliÅkin hareketler varsa Ä°Ålemler nesnesi dizisi olarak dÃ¶nÃ¼lÃ¼r. Ä°Ålemler nesnesi Temel Ä°Ålem Bilgileri ve Detay Ä°Ålem Bilgileri nesnesinden meydana gelir. Ä°zin tÃ¼rÃ¼ varsayÄ±lan olarak Temel Ä°Ålem Bilgilerini iÃ§erir. Detay Ä°Ålem Bilgileri izin tÃ¼rÃ¼ de seÃ§ildi ise Temel Ä°Ålem Bilgilerine ek olarak Detay Ä°Ålem Bilgileri de gÃ¶nderilir. \n \n \n > Temel Ä°Ålem Bilgileri \n islTml \n Kompleks:IslemTemel \n Z \n Temel Ä°Ålem Bilgileri varsayÄ±lan olarak dÃ¶nÃ¼lÃ¼r. \n \n \n >> Ä°Ålem NumarasÄ± \n islNo \n AN3..50 \n Z \n Hesap hareketinin oluÅturulmasÄ± sÄ±rasÄ±nda atanan ve borÃ§ (veya alacak) hareketini tekilleÅtiren HHS bazÄ±nda tekil tanÄ±mlayÄ±cÄ±dÄ±r. Bu deÄer tek baÅÄ±na tekil olabileceÄi gibi b

16irden fazla deÄerin bir araya getirilmesiyle de tekilliÄi saÄlanmÄ±Å olabilir. Bu deÄerin en azÄ±ndan hesap numarasÄ± (hesNo) bazÄ±nda tekil olmasÄ± beklenir. Genellikle kullanÄ±lan Ã¶rnekleri; Instance_Id, Transaction_Id, Transaction_Num, Transaction_TimeStamp,dekont numarasÄ± \n \n \n >> Ä°Ålem Referans NumarasÄ± \n refNo \n AN3..50 \n Z \n Ä°Ålemi uÃ§tan uca tanÄ±mlayan tekil tanÄ±mlayÄ±cÄ±dÄ±r. BorÃ§ ve alacak hareketinden oluÅan bir veya birden fazla iÅlemler bÃ¼tÃ¼nÃ¼ iÃ§in atanmÄ±Å olan ve bu bÃ¼tÃ¼nÃ¼ tekilleÅtiren (bir biri ile iliÅkisini tutan) deÄerdir.Bu deÄer hem YÃSâten gelen deÄer olabilir (Ã¶deme iÅlemlerinde kullanÄ±lan kkodRef ya da refBlg alanÄ±) hem de HHS iÃ§inde takip edilmek iÃ§in Ã¼retilmiÅ bir deÄer olabilir. HHS sisteminde 2 deÄerin de bulunmasÄ± durumunda;refNo alanÄ±nÄ± doldurmak iÃ§in, HHSânin YÃSâten gelen deÄere Ã¶ncelik vermesi beklenmektedir. YÃSâten gelen veri Ã¶rneÄi: SipariÅ NumarasÄ±, Fatura NumarasÄ±, Karekod ReferansÄ± vb. HHSâte Ã¼retilen veri Ã¶rneÄi: MasraflÄ± havale iÅleminde hem havale iÅleminin hem de masraf iÅleminin aynÄ± referans numarasÄ±na sahip olmasÄ± da Ã¶rnek olarak gÃ¶sterilebilir. \n \n \n >> Ä°Ålem TutarÄ± \n islTtr \n AN1..24 \n Z \n Ä°Ålem tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n >> Ä°Ålem GerÃ§ekleÅme ZamanÄ± \n islGrckZaman \n ISODateTime \n Z \n Ä°Ålemin gerÃ§ekleÅme zamanÄ±. \n \n \n >> Ä°Ålem KanalÄ± \n kanal \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeKaynak sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> BorÃ§landÄ±rma AlacaklandÄ±rma GÃ¶stergesi \n brcAlc \n AN1 \n Z \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Ä°Ålemin hesabÄ± borÃ§ ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. \n \n \n >> Ä°Ålem TÃ¼rÃ¼ \n islTur \n AN3..50 \n Z \n HHSânin iÅleme ait iliÅkilendirdiÄi iÅlem tÃ¼rÃ¼ deÄeri. TR.OHVPS.DataCode.IslemTuru sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Ä°Ålem AmacÄ± \n islAmc \n AN2 \n Z \n TR.OHVPS.DataCode.IslemAmaci sÄ±rali veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Ãdeme Sistemi No \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. \n \n \n > Detay Ä°Ålem Bilgileri \n islDty \n Kompleks: IslemDetay \n K \n Detay Ä°Ålem Bilgileri dizi olarak gÃ¶nderilmelidir. \n \n \n >> Ä°Ålem AÃ§Ä±klamasÄ± \n islAcklm \n AN1..150 \n Z \n HHS tarafÄ±ndan atanan iÅlem aÃ§Ä±klamasÄ±.HHS kendi iÅlem hareketlerine yansÄ±ttÄ±ÄÄ± aÃ§Ä±klamayÄ± buraya yansÄ±tmalÄ±dÄ±r. \n \n \n >> KarÅÄ± Taraf \n krsTrf \n Kompleks:  KarsiTaraf \n K \n KullanÄ±mÄ± iÅlem bazÄ±nda deÄiÅmektedir. Ãrnek: FAST iÅleminde karÅÄ± taraf alÄ±cÄ±nÄ±n bilgileridir. Vergi Ã¶demesinde kurum IBAN bilgisi mÃ¼Återiye gÃ¶sterilemeyebileceÄinden bu alanÄ±n boÅ gelmesi HHS insiyatifindedir. \n \n \n >>> KarÅÄ± Maskeli IBAN \n krsMskIBAN \n AN26 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n maskeli IBAN bilgisi. \n \n \n >>> KarÅÄ± Maskeli Unvan \n krsMskUnvan \n AN3..140 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n maskeli ad-soyad ya da ticari unvan bilgisi. \n 7.9\tHealthcheck API \n GET /health \n HHSâlerin sunacaÄÄ± bu servis, dÃ¼zenli olarak BKM tarafÄ±ndan Ã§aÄÄ±rÄ±larak servislerin ayakta olup olmadÄ±klarÄ±nÄ±n kontrolÃ¼nÃ¼n saÄlanmasÄ± planlanmaktadÄ±r \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lmelidir. \n BaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir \n \n \n \n"},{title:"4. RÄ±za DurumlarÄ±",frontmatter:{},regularPath:"/v1.0.2/contents/riza-durumlari.html",relativePath:"v1.0.2/contents/riza-durumlari.md",key:"v-1be15362",path:"/v1.0.2/contents/riza-durumlari.html",headers:[{level:2,title:"4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri",slug:"_4-1-hesap-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"},{level:2,title:"4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri",slug:"_4-2-odeme-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"}],content:" 4. RÄ±za DurumlarÄ± \n ÃHK, Ãdeme Emri BaÅlatma Hizmetine ya da Hesap Bilgisi Hizmetine mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi ile baÅlar. ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden yaptÄ±ÄÄ± iÅlemler neticesinde rÄ±za durumlarÄ± deÄiÅebilir.\nRÄ±zaânÄ±n alabileceÄi durum ko

16dlarÄ± Åu Åekilde belirlenmiÅtir. \n B: Yetki Bekleniyor  â Ä°lk rÄ±za talebinde \n Y: Yetkilendirildi  â BaÅarÄ±lÄ± GKD sonrasÄ± yetKod Ã¼retildiÄinde \n K: Yetki KullanÄ±ldÄ±  â EriÅim Belirteci alÄ±ndÄ±ÄÄ±nda \n E: Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼  â ÃBHS iÃ§in \n S: Yetki SonlandÄ±rÄ±ldÄ± \nÂ Â Â Â HBHS iÃ§in : EriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde \nÂ Â Â Â ÃBHS iÃ§in : Yenileme belirteci Son Tarihi geldiÄinde \n I :Yetki Ä°ptal \nRÄ±za iptal durumu ise gerek raporlama gerekse mÃ¼Återi deneyimi perspektifinden doÄru   bilgilendirmeler yapÄ±labilmesi aÃ§Ä±sÄ±ndan aÅaÄÄ±daki gibi detay kodlarÄ± ile zenginleÅtirilmiÅtir: \n \n RÄ±za Ä°ptal Detay Kodu: \n \n \n \n â01â :\tYeni RÄ±za Talebi ile Ä°ptal \n â02â :\tKullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal \n â03â :\tKullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal \n â04â :\tSÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor \n â05â :\tSÃ¼re AÅÄ±mÄ± : Yetkilendirildi \n â06â :\tSÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi \n â07â :\tGKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± \n â08â :\tGKD iptali : RÄ±zano ile TCKN uyuÅmamasÄ± \n â09â :\tGKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor \n â10â :\tGKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n â11â :\tGKD iptali : Hesap Yetki Sorunu \n â12â :\tGKD iptali : ÃHK HHS kontrollerini aÅamadÄ± \n â13â :\tGKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi \n â14â :\tGKD iptali : Fraud ÅÃ¼phesi \n â99â :\tGKD iptali : DiÄer \n \n \n 4.1 ve 4.2 bÃ¶lÃ¼mlerinde detaylandÄ±rÄ±lan rÄ±za durum deÄiÅikliklerinde rÄ±za iptal detay kodlarÄ± kullanÄ±lmÄ±ÅtÄ±r. \n ÃrneÄin Bâ¨ I/01 denildiÄinde âYetki Bekleniyorâ rÄ±za durumundan âYetki Ä°ptalâ rÄ±za durumuna RÄ±za Ä°ptal Detay Kodu da â01â yani âYeni RÄ±za Talebi ile Ä°ptalâ olarak gÃ¼ncellenmelidir ifade edilmiÅtir. \n ÃHK verdiÄi rÄ±za sÄ±rasÄ±nda seÃ§tiÄi hesaplarÄ±ndan biri kapatÄ±lÄ±rsa, diÄer hesaplara ait bilgileri gÃ¶rmeye devam eder. Ancak ÃHKânÄ±n hesabÄ±na ait bilgilerinin YÃS'e iletilmesini istemediÄi durumda, rÄ±zasÄ±nÄ± tamamen iptal ederek yeni hesap listesi

16ile yeni rÄ±za vermesi gerekmektedir. Yani hesap kapanmasÄ± nedeniyle rÄ±za geÃ§erliliÄini yitirmez. ÃHK'nÄ±n proaktif olarak bu hesabÄ± rÄ±zadan Ã§Ä±karmasÄ± durumunda rÄ±za iptali olur. \n RÄ±za iptal edilmediÄi ve geÃ§erli olduÄu sÃ¼rece kapalÄ± hesaplar iÃ§in diÄer Ã§evrimiÃ§i kanallarda uygulanan yÃ¶ntem izlenmelidir. DiÄer Ã§evrimiÃ§i kanallarda kapalÄ± hesaplara iliÅkin bilgi dÃ¶nÃ¼lmÃ¼yor ise ÃHVPS'den de dÃ¶nÃ¼Å yapÄ±lmaz. ÃHKânÄ±n rÄ±za onayÄ± verdiÄi aÃ§Ä±k hesaplarÄ±nÄ±n tÃ¼mÃ¼ HHS tarafÄ±nda kapatÄ±ldÄ±ÄÄ± durumda, yine aynÄ± Åekilde HHS Ã§evrimiÃ§i kanallarÄ±nda koyduÄu kurallara gÃ¶re bu hesaplarÄ±nÄ±n YÃS uygulamasÄ±nda gÃ¶sterilmesine karar verir. \n Hesap kapama ve ticari kullanÄ±cÄ±larÄ±n hesaplar Ã¼zerindeki yetki deÄiÅiklikleri HHS'nin iÃ§ sistemleri tarafÄ±ndan yapÄ±lan kontrollerle yÃ¶netilir. Buradaki deÄiÅiklikler ile HHS sistemsel olarak rÄ±za iptali gerÃ§ekleÅtiremez. ÃHK izni ve onayÄ± dahilinde rÄ±za iptal gerÃ§ekleÅtirilmesi gerekmektedir. \n HHS'ler sunmuÅ olduklarÄ± RÄ±za Ä°ptal ekranÄ±nÄ± (sadece Hesap Bilgisi RÄ±zasÄ± iÃ§in), hangi ortamlardan GKD yapÄ±lmasÄ±na izin veriliyorsa (web/mobil) aynÄ± ortamdan ÃHK'ya sunmalÄ±dÄ±r.  ÃrneÄin bir HHS bireysel mÃ¼Återileri iÃ§in web ve mobil, kurumsal mÃ¼Återiler iÃ§in web Ã¼zerinden GKD imkanÄ± sunuyor ise, minimumda bireysel mÃ¼Återiler iÃ§in web ve mobil ortamlarÄ±ndan, kurumsal mÃ¼Återiler iÃ§in web ortamÄ±ndan RÄ±za Ä°ptal ekranÄ± aracÄ±lÄ±ÄÄ± ile rÄ±za iptaline izin vermelidir. Bunun dÄ±ÅÄ±nda Ã§aÄrÄ± merkezi ya da Åube gibi ortamlardan sunacaÄÄ± RÄ±za Ä°ptal imkanÄ± HHS inisiyatifindedir. Bahsi geÃ§en zorunluluk Ãdeme Emri RÄ±za Ä°ptal ekranÄ± iÃ§in geÃ§erli deÄildir. \n Benzer Åekilde YÃS'ler hangi ortamlardan (web/mobil) hizmet veriyorsa, aynÄ± ortam Ã¼zerinden RÄ±za Ä°ptal ekranÄ±nÄ± sunmalÄ±dÄ±r. \n 4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n, bir YÃS iÃ§in, bir HHS'de Y, K, B rÄ±za durumlarÄ±nda tek bir rÄ±zasÄ± olabilir.\nBir ÃHK hem kiÅisel olarak hem de bir kurumun kullanÄ±cÄ±sÄ± olabilir. Bu durumda kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Hesap Bilgisi RÄ±zasÄ± isteÄi HHSâye iletilir. \na.\tHHS ÃHK'ya ait iÃ§eride rÄ±za var mÄ± kontrol eder. EÄer yoksa  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \nb.\tEÄer iÃ§eride rÄ±za varsa \nÂ Â Â Â  i. RÄ±za durumu Yetki Bekleniyor - B ise; \nÂ Â Â Â     HHS, sistemde Yetki Bekleniyor - B rÄ±za durumuna sahip kayÄ±t olduÄu iÃ§in, Ã¶ncelikle eski kaydÄ± Yetki Ä°ptal - I durumuna getirir.  RÄ±za Ä°ptal Detay Kodu âYeni RÄ±za Talebi ile iptalâ olmalÄ±dÄ±r.  B â¨ I / 01  SonrasÄ±nda,  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \n Â Â Â Â  ii. RÄ±za durumu Yetkilendirildi - Y veya Yetki KullanÄ±ldÄ± - K ise; \nÂ Â Â Â ÃHK'nÄ±n halihazÄ±rda verilmiÅ bir rÄ±zasÄ± vardÄ±r. HHS, Ã¶nce mevcut rÄ±zanÄ±n iptalinin yapÄ±lmasÄ± gerektiÄine dair   TR.OHVPS.Resource.ConsentMismatch  hatasÄ±nÄ± dÃ¶ner. YÃS, HHS ya da YÃS uygulamasÄ± Ã¼zerinden bu rÄ±zanÄ±n iptal edilmesi gerektiÄine dair ÃHK'ya bilgilendirme yapar. \n Â Â Â Â  iii.\tRÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise Yetki Bekleniyor - B durumunda yeni rÄ±za no oluÅturur. \n Â Â Â Â  iv.\tRÄ±za durumu Yetki Ä°ptal - I ise  Yetki Bekleniyor - B  durumunda yeni rÄ±za no oluÅturur. \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda RÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.  B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: TarayÄ±cÄ±yÄ± kapatmÄ±Å olabilir) RÄ±za Yetki Bekleniyor - B rÄ±za durumunda kalÄ±r.  5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B rÄ±za durumundaki kayÄ±tlar Yetki Ä°ptal  : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir.   B â¨ I / 04  Bkz. 9. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine  rizaIptDtyKod  deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 12 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 13 \n \n \n Fraud ÅÃ¼phesi Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 99 \n \n \n \n \n \n \n ÃHK, hesaplarÄ±nda/izin tÃ¼rlerinde/EriÅimin GeÃ§erli OlduÄu Son Tarih bilgilerinden bir ya da birden fazlasÄ±nda gÃ¼ncelleme yapmak iÃ§in YÃS ekranÄ±na girer. \n \n \n Â Â Â Â a.\tYÃS Ã¶nce RÄ±za Ä°ptal API'sini Ã§aÄÄ±rÄ±r. Sonra yeni deÄerlerle yeni bir rÄ±za isteÄinde bulunur. Tekrar GKD gerekir. \n Â Â Â Â b.\tYÃS rÄ±za iptal yapmadan yeni rÄ±za alma akÄ±ÅÄ±na baÅlarsa 1.b akÄ±ÅÄ± devreye girer. \n Â Â Â Â c.\tRÄ±za gÃ¼ncelleme ilerleyen sÃ¼rÃ¼mlerde ele alÄ±nacaktÄ±r. \n \n \n EriÅim Belirteci API \n a. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda;

16 \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetki KullanÄ±ldÄ± - K  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Sorgulama: HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir hesap bilgisi-rizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. RÄ±za numarasÄ± ile sorgulama yapÄ±lÄ±r. \n \n \n Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali: HBHS Ã¼zerinden ya da HHS Ã¼zerinden yapÄ±lan rÄ±za iptallerinde RÄ±za durumu  Yetki Ä°ptal - I olarak gÃ¼ncellenir. RÄ±za numarasÄ± ile iptal saÄlanÄ±r. \n a. HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir.  RÄ±za durumu sorgulanÄ±r. \n RÄ±za numarasÄ± Yetki Bekleniyor - B ve Yetkilendirildi - Y ve Yetki KullanÄ±ldÄ± - K durumlarÄ±nda ise Yetki Ä°ptal durumuna getirilir. RÄ±za gnclzmn timestamp ile gÃ¼ncellenir.\nHHS, RÄ±za iptalinde aynÄ± zamanda eriÅim belirtecini de invalid hale getirmelidir. \n B â¨ I / 02 \n Y â¨ I / 02 \n K â¨ I / 02 \n b.\tYÃS Ã¼zerinden yapÄ±lacak iptal iÅleminde yine Y ve B ve K rÄ±za durumlarÄ±nda ise iptal edilebilir. \n B â¨ I / 03 \n Y â¨ I / 03 \n K â¨ I / 03 \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise iptal gerÃ§ekleÅmez. âRÄ±za durumunuz iptal etmeye uygun deÄildir.â hatasÄ± ÃHK'ya yansÄ±tÄ±lÄ±r.  TR.OHVPS.Resource.ConsentRevoked \n \n \n ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.\nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde RÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ± durumuna Ã§ekilmelidir.   K â¨ S \n \n \n Hesaplar, Bakiye ve Ä°Ålemler servislerinde eriÅim belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.\nGeÃ§erli bir eriÅim belirteci yok ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n YÃS'Ã¼n; RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda Hesaplar, Bakiye ve Ä°Ålemler servislerini Ã§aÄÄ±rmamasÄ± beklenir. HHS'nin bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda  TR.OHVPS.Resource.ConsentRevoked  hatasÄ±nÄ± dÃ¶nmesi gereklidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K dÄ±ÅÄ±nda ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± verilmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K ise servis akÄ±ÅlarÄ±na devam edilir. \n RÄ±za sorgulama API'sinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound hatasÄ±  verilmelidir. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir âYetki Bekleniyorâ durumunda kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor  â¨ RÄ±za Ä°ptal  / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir âYetkilendirildiâ durumunda kalan kayÄ±tlar gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ±: Yetkilendirildi  B â¨ I / 05 \nYukarÄ±da bahsedilen, YÃS SÃ¼re AÅÄ±mÄ± nedeniyle rÄ±za iptal durum gÃ¼ncellemelerini y

16apmadan Ã¶nce HHSâyi sorgulayarak rÄ±za durumunu Ã¶Ärenmeli ve sÃ¼re aÅÄ±mÄ± dÄ±ÅÄ±nda bir kodu varsa aynÄ± kodla kendi sistemini gÃ¼ncellemelidir. \nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde rÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ±âya gÃ¼ncellenir.  K â¨ S \n 4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n bir YÃS iÃ§in bir HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n Kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ± isteÄi HHSâye iletilir. Ä°Ã§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za no oluÅturur. \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda rÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.   B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: BrowserÄ± kapatmÄ±Å olabilir)\nRÄ±za durumu Yetki Bekleniyor'dur. 5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B durumundaki kayÄ±tlar RÄ±za Ä°ptal : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir. Bkz. 8. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine rizaIptDtyKod deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 12 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 13 \n \n \n Fraud ÅÃ¼phesi Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 99 \n \n \n \n \n \n \n GKD muafiyeti olduÄunda YÃS HHSâden arka planda onay alÄ±r. Bu onay sÄ±rasÄ±nda rÄ±za durumu  Yetkilendirildi  yapÄ±lÄ±r.  B â¨ Y \n \n \n EriÅim Belirteci API \na. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda; \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B , Yetki KullanÄ±ldÄ± - K  ya da Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K veya Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Ãdeme BaÅlatma API Ã¶nce eriÅim belirteci ve sonrasÄ±nda rÄ±za kontolÃ¼ yapÄ±larak gerÃ§ekleÅtirilmelidir \n \n Ãncelikle EriÅim Belirteci kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir EriÅim Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki S

16onlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Bekleniyor - B , Yetkilendirildi - Y, Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda Ã¶deme emri gerÃ§ekleÅtirilir.  RÄ±za durumu Yetki KullanÄ±ldÄ± - K'dan Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E yapÄ±lmalÄ±dÄ±r.   K â¨E \n \n \n \n Sorgulama: GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlarda, Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle, Ã¶demeEmriRizasi nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r.\nRÄ±za sorgulama, Ãdeme Emri Sorgulama API'lerinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound  hatasÄ± verilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ±nÄ±n Ä°ptali bulunmamaktadÄ±r. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir Yetki Bekleniyor'da kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir Yetkilendirildi'de kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetkilendirildi  B â¨ I / 05 \n 5 dakikadan uzun sÃ¼redir Yetki kullanÄ±ldÄ±'da kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetki kullanÄ±ldÄ± â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi  B â¨ I / 06 \n Yenileme belirteci Son Tarih geldiÄinde rÄ±za durumu Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼âden Yetki SonlandÄ±rÄ±ldÄ±'ya gÃ¼ncellenir. \n E â¨ S \n \n \n GKD muafiyeti sadece Ã¶deme baÅlatma servislerinde bulunmaktadÄ±r. \n \n \n"},{frontmatter:{},regularPath:"/v1.0.2/contents/tanim-ve-kisitlamalar.html",relativePath:"v1.0.2/contents/tanim-ve-kisitlamalar.md",key:"v-3e221f7d",path:"/v1.0.2/contents/tanim-ve-kisitlamalar.html",content:"  1.\tTanÄ±m ve KÄ±saltmalar   \n Tablo 1: TanÄ±m ve KÄ±saltmalar \n \n \n \n KÄ±saltma \n TanÄ±m \n AÃ§Ä±klama \n Ä°ngilizce AÃ§Ä±klama \n Ä°ngilizce KÄ±saltma \n \n \n \n \n ÃS \n ÃerÃ§eve SÃ¶zleÅme \n Ãdeme hizmeti saÄlayÄ±cÄ±sÄ± ile mÃ¼Återi arasÄ±nda tekil veya sÃ¼reklilik arz eden Ã¶deme iÅlemlerinin yÃ¼rÃ¼tÃ¼lmesine ve mÃ¼mkÃ¼n olan durumlarda Ã¶deme hesabÄ±nÄ±n aÃ§Ä±lmasÄ±na iliÅkin usul ve esaslarÄ± belirleyen sÃ¶zleÅme \n \n \n \n \n EPK \n Elektronik Para KuruluÅu \n Kanun kapsamÄ±nda elektronik para ihraÃ§ etme yetkisi verilen tÃ¼zel kiÅi \n Electronic Money Institution \n EMI \n \n \n FAST \n FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi \n TCMB tarafÄ±ndan iÅletilen FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi Sistemi \n \n \n \n \n FAST TR-Karekod \n FAST-TR Karekod Teknik Ä°lke ve Kurallar Rehberi \n TR Karekodâun FAST Sistemi aracÄ±lÄ±ÄÄ±yla gerÃ§ekleÅecek iÅlemlerde kullanÄ±lmasÄ±na iliÅkin detaylÄ± teknik ilke ve kurallarÄ±nÄ± iÃ§eren dokÃ¼man \n \n \n \n \n GKD \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n Kimlik doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin bildiÄi, sahip olduÄu veya biyometrik bir karakteristiÄi olan bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntem \n Strong Customer Authentication \n SCA \n \n \n Ä°B \n Ä°Ålem Bilgisi \n GerÃ§ekleÅtirilen iÅleme iliÅkin iÅlem zamanÄ±nÄ±, iÅlemin niteliÄini ve Ã¶deme iÅlemi iÃ§in Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve Ã¶demenin gÃ¶ndereni ile alÄ±cÄ±sÄ±nÄ± veya toplu Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve gÃ¶ndereni ile alÄ±cÄ±larÄ±nÄ± iÃ§eren bilgi \n \n \n \n \n Ä°DK \n Ä°Ålem DoÄrulama Kodu \n Kimlik doÄrulama yÃ¶ntemlerinden biriyle kendisini sisteme tanÄ±tan bir mÃ¼Återinin gerÃ§ekleÅtirmek istediÄi

16iÅleme Ã¶zgÃ¼ olmak ve belirli bir geÃ§erlilik sÃ¼resi iÃ§inde iÅlem onayÄ±nda kullanÄ±lmak Ã¼zere oluÅturulan, finansal sonuÃ§ doÄrunan iÅlemlerde kiÅiye onay anÄ±nda ilgili iÅlem bilgisi (Ä°B) ile birlikte gÃ¶sterilen, alÄ±cÄ± veya tutarÄ±n deÄiÅmesiyle geÃ§ersiz hale gelen bilgi \n Authentication Code \n AC \n \n \n KOLAS \n Kolay Adresleme Servisi \n Fon transferlerinde hesap numarasÄ± ile ad soyad yerine kullanÄ±lan ve belirli bir hesap ile eÅleÅtirilmiÅ telefon numarasÄ±, e-posta adresi, T.C. Kimlik NumarasÄ± (TCKN), Vergi Kimlik NumarasÄ± (VKN), YabancÄ± Kimlik NumarasÄ± veya Pasaport NumarasÄ± gibi Kolay Adres bilgilerinin kaydedilmesini, gÃ¼ncellenmesini ve sorgulamasÄ±nÄ± saÄlayan katman servis \n \n \n \n \n HBHS \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (g) bendinde tanÄ±mlanan Ã¶deme hizmetini (hesap bilgisi hizmetini) sunan tÃ¼zel kiÅi \n Account Information Service Provider \n AISP \n \n \n HHS \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± \n Nezdinde Ã¶deme hesabÄ± bulunan Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± \n Account Servicing Payment Service Provider \n ASPSP \n \n \n ÃBHS \n Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (f) bendinde tanÄ±mlanan Ã¶deme hizmetini (Ã¶deme emri baÅlatma hizmetini) sunan tÃ¼zel kiÅi \n Payment Initiation Service Provider \n PISP \n \n \n ÃDK \n Ãdeme KuruluÅu \n Ãdeme hizmeti saÄlamak ve gerÃ§ekleÅtirmek iÃ§in Kanun kapsamÄ±nda yetkilendirilmiÅ tÃ¼zel kiÅi \n Payment Institution \n PI \n \n \n ÃH \n Ãdeme HesabÄ± \n Ãdeme hizmeti kullanÄ±cÄ±sÄ± adÄ±na aÃ§Ä±lan ve Ã¶deme iÅleminin yÃ¼rÃ¼tÃ¼lmesinde kullanÄ±lan hesap \n Payment Account \n PA \n \n \n ÃHK \n Ãdeme Hizmeti KullanÄ±cÄ±sÄ± (MÃ¼Återi) \n GÃ¶nderen, alÄ±cÄ± veya her ikisi sÄ±fatÄ±yla belirli bir Ã¶deme hizmetinden faydalanan gerÃ§ek veya tÃ¼zel kiÅi \n Payment Service User \n PSU \n \n \n ÃHS \n Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n 5411 sayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar, EPK, ÃDK ve Posta ve Telgraf TeÅkilatÄ± Anonim Åirketi(PTT) \n Payment Service Provider \n PSP \n \n \n ÃHVPS \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri \n Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri \n \n \n \n \n PÃS \n Perakende Ãdeme Sistemi \n TCMB tarafÄ±ndan iÅletilen, iÅlemlerin TÃ¼rk LirasÄ± Ã¼zerinden gerÃ§ekleÅtiÄi MÃ¼Återiler ArasÄ± TÃ¼rk LirasÄ± AktarÄ±m Sistemi \n \n \n \n \n TR-Karekod \n TR-Karekod Ä°lke ve KurallarÄ± \n Ulusal karekod (TR Karekod) ilke ve kurallarÄ±nÄ±n belirlendiÄi belge \n \n \n \n \n YÃS \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n Ãdeme emri baÅlatma hizmeti ve/veya hesap bilgisi hizmeti sunan tÃ¼zel kiÅi \n Third Party Payment Service Providers \n TPP \n \n \n \n"},{title:"6.\tÃdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v1.0.2/contents/odeme-emri-baslatma-hizmeti.html",relativePath:"v1.0.2/contents/odeme-emri-baslatma-hizmeti.md",key:"v-1ef8939d",path:"/v1.0.2/contents/odeme-emri-baslatma-hizmeti.html",headers:[{level:3,title:"Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi",slug:"_6-1-adim-0-odeme-emri-baslatma-istegi"},{level:2,title:"6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_6-2-adim-1-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_6-3-adim-2-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_6-4-adim-2-1-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ±",slug:"_6-5-adim-3-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_6-6-adim-3-1-odeme-emri-sorgusu-istege-baglÄ±"},{level:3,title:"GET /odeme-emri/{odemeEmriNo}",slug:"get-odeme-emri-odemeemrino"},{level:2,title:"6.7\tHealthcheck API",slug:"_6-7healthcheck-api"},{level:3,title:"GET /health",slug:"get-health"}],content:" 6.\tÃdeme Emri BaÅlatma Hizmeti \n Ãdeme emri baÅlatma iÅlemi havale, FAST ya da PÃS Ã¶demesiyle sonuÃ§lanabilir. Ãdeme iÅleminin amacÄ± kiÅiden kiÅiye para transferi, e-ticaret Ã¶demesi gibi farklÄ± Ã¶deme tÃ¼rleri olabilir. Ãdemenin amacÄ±na gÃ¶re ÃBHSânin ileteceÄi veri setinde farklÄ±laÅmalar olabilir. \n Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n Ãdeme Emri BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden Ã¶deme emrini baÅlatÄ±r. \n Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âÃdeme Emri BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âÃ¶deme emriâni HHSâye iletir. \n Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n \n \n Åekil 4: Ãdeme Emri BaÅlatma Hizmeti Ãst DÃ¼zey Ä°Å AkÄ±ÅÄ± \n Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. \n Tablo 6: Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n odeme-emri-rizasi \n POST \n /odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriRizasiIstegi \n OdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n odeme-emri-rizasi \n GET \n /odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmriRizaYaniti \n \n \n 3 \n odeme-emri \n POST \n /odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriIstegi \n OdemeEmri \n \n \n 3.1 \n odeme-emri \n GET \n /odeme-emri

16/{odemeEmriNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmri \n 6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) Ã¶deme emri baÅlatma iÅlemine onay verir. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil 5: Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (odemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ mi? \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahip mi? \n Ä°stekte bulunulan HHS kodu doÄru mu? \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren odemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir OdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n API dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme ve bildirim adresleri ile Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) \n HHS; kimlik bilgileri nesnesinde eÄer kimlik bilgileri iletilmiÅ ise; bu veri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (KoÅullu Zorunlu) \n HHS kimlik bilgisi ile gÃ¶nderen unvanÄ±nÄ±n uyumlu olduÄunun kontrol eder. HHS'ler EFT/FAST iÅlemlerinde kabul ettikleri kontrol kriterleri ile iÅleme izin verebilirler. (Zorunlu) \n GÃ¶nderen Hesap NumarasÄ± ile ilgili Tablo7âde belirtilen kontroller yapÄ±lmalÄ±dÄ±r. (Zorunlu) \n HHS, Ã¶deme iÃ§in benzersiz âRizaNoâ ile âOdemeEmriRizasiâ nesnesi oluÅturur ve ÃBHSâye dÃ¶ner. \n HHS, OdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \nBu aÅamada ÃHKânÄ±n HHS tarafÄ±ndan tanÄ±mlanmÄ±Å ve isteÄin veri alanÄ±nda gÃ¶nderen hesaba (borÃ§landÄ±rÄ±lacak hesaba) iliÅkin bir bilgisinin olmasÄ± gerekmez. \nHesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n \n POST /odeme-emri-rizasi  isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âodemeEmriRizasiIstegiâ nesnesi (Tablo-7) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âodemeEmriRizasiâ (Tablo-8) nesnesi oluÅturulur. \n Tek Seferlik Ãdeme \nTek seferlik Ã¶deme akÄ±ÅÄ± YÃS'ten HHS'ye giden istekte, gÃ¶nderen kimlik bilgilerinin olmadÄ±ÄÄ± durumda gerÃ§ekleÅir. GÃ¶nderen kimlik bilgisi olmadÄ±ÄÄ±nda, KOLAS sorgusu yapÄ±lamayacaÄÄ±ndan Ã¶tÃ¼rÃ¼, HHS tarafÄ±ndan TR.OHVPS.Business.InvalidContent hatasÄ± dÃ¶nÃ¼lmelidir. \nTek seferlik Ã¶deme akÄ±ÅÄ± hem iÅyeri Ã¶demelerinde hem de kiÅiden kiÅiye para transferlerinde kullanÄ±labilen bir akÄ±ÅtÄ±r.\nAÅaÄÄ±daki senaryolar tek seferlik Ã¶demeye Ã¶rnek olarak gÃ¶sterilebilir. \nÄ°Åyeri Ãdemesi akÄ±ÅÄ± Ã¶rneÄi: Bir e-ticaret sitesinde, Ã¼ye olmadan alÄ±ÅveriÅ yapÄ±lmasÄ± ve Ã¶demenin YÃS tarafÄ±ndan kimlik bilgisi olmadan baÅlatÄ±lmasÄ± \nKiÅiden kiÅiye para transferi akÄ±ÅÄ± Ã¶rneÄi: QR veya diÄer yÃ¶ntemler ile alÄ±cÄ± bilgilerinin gÃ¶nderici ile paylaÅÄ±lmasÄ± ve YÃS Ã¼zerinden gÃ¶nderici bilgileri olmadan alÄ±cÄ±ya para transferi yapÄ±lmasÄ± iÃ§in rÄ±za verilmesi \n  BAÅARILI Ä°STEK: \n Tablo 7: âOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidASPSP  hata kodunu dÃ¶ner. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. Hata durumunda  TR.OHVPS.Connection.InvalidTPP  hata kodunu dÃ¶ner. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  YÃS YÃ¶nlendirmeli GKD yÃ¶ntemi ile akÄ±ÅÄ± destekliyorsa, yetYntm deÄiÅkeninden baÄÄ±msÄ±z olarak yÃ¶nlendirme adresini iletmelidir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. YÃSâÃ¼n ileteceÄi adrestir.  YÃS AyrÄ±k GKD yÃ¶ntemi ile akÄ±ÅÄ± destekliyorsa, yetYntm deÄiÅkeninden baÄÄ±msÄ±z olarak bildirim adresini iletmelidir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, ayrÄ±k GKD sonrasÄ± bu alanda belirtilen adrese otorizasyon kodunu (authentication code) iletir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir para birimi olduÄu kontrol eder. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n Ä° \n GÃ¶nderenin unvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  TR.OHVPS.Business.InvalidContent  hatasÄ± verilmelidir. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir.  Kontrol baÅarÄ±sÄ±z olduÄunda  TR.OHVPS.Business. InvalidAccount  hatasÄ± YÃSâe iletilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, HspRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n unvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r.  FAST-TR Karekod dÄ±ÅÄ±ndaki iÅ yeri Ã¶demelerinde; yine Unvan alanÄ±nda iÅyeri adÄ± bilgisi gÃ¶nderilmelidir. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n Tek seferlik Ã¶demelerde ( kimlik bilgileri boÅ iletildiÄinde) KOLAS nesnesi dolu iletiliyorsa; HHS tarafÄ±ndan TR.OHVPS.Business.InvalidContent hatasÄ± dÃ¶nÃ¼lmelidir \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n HHS, YÃS'Ã¼n API deseninde \"O\" kodunu ilettiÄini kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarÄ±nda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.   -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tÄ°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n YÃS bu deÄeri ÃHKâyÄ± HHSâye yÃ¶nlendirmeden Ã¶nceki ekranda gÃ¶stermeli, ve HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak yine ÃHKâya gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..50 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi. \n \n \n \n > ÃBHS Masraf TutarÄ± \n obhsMsrfTtr \n Kompleks:Tutar \n Ä° \n API Ä°lke ve KurallarÄ± 1.0 sÃ¼rÃ¼mÃ¼nde bu nesnenin API deseninde gÃ¶nderilmemesi gerekmektedir. \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n Ä° \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r.  Ä°Åyeri Ãdeme Bilgileri, YÃS uygulama Ã¶nyÃ¼zÃ¼nde ÃHKânÄ±n bildiÄi ve giriÅi yapÄ±lmasÄ± beklenen bir bilgi olmamalÄ±dÄ±r. YÃS tarafÄ±ndan sistemsel olarak doldurulmasÄ± gereklidir. \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n Ä° \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir.  4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n Ä° \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n Ä° \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriRizasiâ nesnesi Tablo-8âdeki parametrelerden oluÅur: \n Tablo 8: âOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄ

16u durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n >> Unvan \n unv \n AN3..140 \n Ä° \n GÃ¶nderenin unvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..50 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem sa

16atleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisidir. Bu alan ileri vadeli Ã¶demeler iÃ§in dÃ¼ÅÃ¼nÃ¼lmÃ¼ÅtÃ¼r. Ä°lk fazda doldurulmasÄ±na gerek olmadÄ±ÄÄ± dÃ¼ÅÃ¼nÃ¼lmektedir. \n \n \n > ÃBHS Masraf TutarÄ± \n obhsMsrfTtr \n Kompleks:Tutar \n Ä° \n API Ä°lke ve KurallarÄ± 1.0 sÃ¼rÃ¼mÃ¼nde bu nesnenin API deseninde gÃ¶nderilmemesi gerekmektedir. \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > HHS Masraf TutarÄ± \n hhsMsrfTtr \n Kompleks:Tutar \n Ä° \n API Ä°lke ve KurallarÄ± 1.0 sÃ¼rÃ¼mÃ¼nde bu nesnenin API deseninde gÃ¶nderilmemesi gerekmektedir. \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n HHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n Ä° \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n Ä° \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n Ä° \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n Ä° \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil 6: Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n Ã¶deme emrini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra;

16 HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âodemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle,  OdemeEmriRizasi  nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  OdemeEmriRizasi  nesnesine iÅler. \n GET /odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  OdemeEmriRizasi  kaynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n Durum \n OdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /odeme-emri-rizasi/{RizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-8âde yer alan parametreleri iÃ§eren âOdemeEmriRizasiâ oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /odeme-emri-rizasi/{RizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemlerinde, Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgilerinin Ã¶deme emri rÄ±zasÄ± sÄ±rasÄ±nda gÃ¶nderimi zorunlu deÄildir. BaÅarÄ±lÄ± GKD sonrasÄ±, yani eriÅim belirteci alÄ±ndÄ±ÄÄ±nda, Ã¶deme emri oluÅmadan Ã¶nce, YÃSâÃ¼n Ã¶deme emri rÄ±zasÄ±nÄ± sorgulayarak bu bilgileri almasÄ± ve Ã¶deme emrini oluÅtururken Kimlik TÃ¼rÃ¼ ve Kimlik Verisi alanlarÄ±nÄ± dolu olarak gÃ¶ndermesi beklenmektedir.  Ancak rÄ±za durumu âYetki Bekleniyor - Bâ, âYetkilendirildi - Yâ ve âYetki Ä°ptal - Iâ statÃ¼lerinde ise, Ã¶deme emri rÄ±zasÄ± sorgulamasÄ±nda, HHSânin Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgisini YÃS ile paylaÅmamasÄ± gerekmektedir. \n 6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Ãdeme Emrinin OluÅturulmasÄ± \n POST /odeme-emri \n \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS OdemeEmri kaynaÄÄ±nÄ± oluÅturur. \n Ãdeme emri (OdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r.\n \n POST HHS tarafÄ±ndan iÅlenir: RizaDurumu âYetki KullanÄ±ldÄ±â ise iÅleme baÅlanÄ±r. \n POST /odeme-emri-rizasi ile POST /odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r.POST verisindeki GÃ¶nderen Hesap NumarasÄ± ve AlÄ±cÄ± Hesap NumarasÄ±nÄ±n aynÄ± bankaya aitse HAVALE deÄilse FAST veya PÃS iÅ akÄ±ÅÄ±na geÃ§ilir. \n POST verisinin modele gÃ¶re kontrolÃ¼ yapÄ±lÄ±r (alan kontrolleri) \n POST verisinin mantÄ±ksal kontrolleri yapÄ±lÄ±r (IBAN kontrolÃ¼, Ã§apraz alan kontroller) \n OdemeEmriDurumu âGerÃ§ekleÅtiâ / âGÃ¶nderildiâ / âGerÃ§ekleÅmediâ olarak gÃ¼ncellenir. \n \n \n POST baÅarÄ±lÄ± olursa, iÃ§erisinde OdemeEmriNo ve OdemeEmriDurumu deÄiÅkenleri de bulunan OdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n \n BAÅARILI Ä°STEK: \n Tablo 9: âOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidASPSP  hata kodunu dÃ¶ner. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidTPP  hata kodunu dÃ¶ner. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi \n \n \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde, 1. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Ãdeme Emri RizasÄ± Nesnesindeki Ä°Ålem TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS iÅlem tutarÄ± Ã¶deme mesajÄ±nda (Havale/FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n Ttr \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari unvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>>

16 Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n KolasRef ( hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. \n RefBlg (Hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..50 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi. \n \n FAST/PÃS Acklm \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme Sistemi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem sa

16atleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n \n \n > ÃBHS Masraf TutarÄ± \n obhsMsrfTtr \n Kompleks:Tutar \n Ä° \n API Ä°lke ve KurallarÄ± 1.0 sÃ¼rÃ¼mÃ¼nde bu nesnenin API deseninde gÃ¶nderilmemesi gerekmektedir. \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n Ãdeme Emri RizasÄ± Nesnesindeki ÃBHS Masraf Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Ãdeme Emri RizasÄ± Nesnesindeki ÃBHS Masraf TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > HHS Masraf TutarÄ± \n hhsMsrfTtr \n Kompleks:Tutar \n Ä° \n API Ä°lke ve KurallarÄ± 1.0 sÃ¼rÃ¼mÃ¼nde bu nesnenin API deseninde gÃ¶nderilmemesi gerekmektedir. \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n Ãdeme Emri RizasÄ± Nesnesindeki HHS Masraf Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n HHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Ãdeme Emri RizasÄ± Nesnesindeki HHS Masraf TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n Ä° \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r.  Ä°Åyeri Ãdeme Bilgileri, YÃS uygulama Ã¶nyÃ¼zÃ¼nde ÃHKânÄ±n bildiÄi ve giriÅi yapÄ±lmasÄ± beklenen bir bilgi olmamalÄ±dÄ±r. YÃS tarafÄ±ndan sistemsel olarak doldurulmasÄ± gereklidir. \n \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n Ä° \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n Ä° \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n Ä° \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n \n \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n > Bildirim Adresi \n bldAdr \n AN1..1024 \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Emir Bilgileri \n emrBlg \n Kompleks: EmirBilgileri \n Z \n \n \n \n > Ãdeme Emri NumarasÄ± \n odmEmriNo \n AN1..128 \n Z \n odemeEmri nesnesinin UID'sidir. OdemeEmrine Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Ãdeme Emri Zaman \n odmEmriZmn \n ISODateTime \n Z \n odemeEmri nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari unvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ  deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme Durumu \n odmDrm \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r.      Ãdeme Durumu alanÄ± ile ilgili olarak HHSâler tarafÄ±ndan YÃSâlere  OdemeEmri servisi yanÄ±tÄ±nda 02:GÃ¶nderildi, 04:Onayda Bekliyor,05:Ä°Åleme AlÄ±ndÄ± yanÄ±tlarÄ± gÃ¶nderilebilir.   05:Ä°Åleme AlÄ±ndÄ±  durumu YÃS tarafÄ±ndan mÃ¼Återiye gÃ¶sterilmeyen bir koddur. Bu kod dÃ¶nÃ¼ldÃ¼ÄÃ¼nde YÃS uygulamasÄ±nda ÃHKâya Ã¶deme durumu  02:GÃ¶nderildi  olarak gÃ¶sterilir. Ä°Ålemin son durumunun teyidi iÃ§in YÃS Ã¶deme emri sorgulamasÄ± yapmalÄ±dÄ±r.   02:GÃ¶nderildi  durumu oluÅtuktan sonra YÃS tarafÄ±ndan Ã¶deme emri sorgulamasÄ± yapÄ±larak Ã¶deme durumunun gÃ¼ncel deÄeri Ã¶Ärenilir. GÃ¼ncel deÄerler  01:GerÃ§ekleÅti,03:GerÃ§ekleÅmedi  durumlarÄ± olabilir. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..50 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Ãdeme Sistem NumarasÄ± \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n > ÃBHS Masraf TutarÄ± \n obhsMsrfTtr \n Kompleks:Tutar \n Ä° \n API Ä°lke ve KurallarÄ± 1.0 sÃ¼rÃ¼mÃ¼nde bu nesnenin API deseninde gÃ¶nderilmemesi gerekmektedir. \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > HHS Masraf TutarÄ± \n hhsMsrfTtr \n Kompleks:Tutar \n Ä° \n API Ä°lke ve KurallarÄ± 1.0 sÃ¼rÃ¼mÃ¼nde bu nesnenin API deseninde gÃ¶nderilmemesi gerekmektedir. \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi (TRY, USD, EUR vb.). \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n HHSânin iÅlemle ilgili ÃHKânÄ±n borÃ§landÄ±rÄ±lmasÄ±nÄ± belirttiÄi masraf tutarÄ±. Ä°Ålem TutarÄ± ile aynÄ± para biriminde olmalÄ±dÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n Ä° \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi

16iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n Ä° \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n Ä° \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n Ä° \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Ãdeme Emri Sorgusu \n GET /odeme-emri/{odemeEmriNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla Ã¶deme emrini sorgulayabilir. \n BAÅARILI YANIT: \n GET /odeme-emri/{odemeEmriNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âOdemeEmriâ nesnesi dÃ¶ner. \n 6.7\tHealthcheck API \n GET /health \n HHSâlerin sunacaÄÄ± bu servis, dÃ¼zenli olarak BKM tarafÄ±ndan Ã§aÄÄ±rÄ±larak servislerin ayakta olup olmadÄ±klarÄ±nÄ±n kontrolÃ¼nÃ¼n saÄlanmasÄ± planlanmaktadÄ±r \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lmelidir. \n BaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir \n \n \n \n"},{title:"3. Temel Prensipler",frontmatter:{},regularPath:"/v1.0.2/contents/temel-prensipler.html",relativePath:"v1.0.2/contents/temel-prensipler.md",key:"v-03088e53",path:"/v1.0.2/contents/temel-prensipler.html",headers:[{level:2,title:"3.1 Genel",slug:"_3-1-genel"},{level:2,title:"3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum",slug:"_3-2-istem-cagrÄ±-ve-oturum"},{level:2,title:"3.3.\tRESTful API",slug:"_3-3-restful-api"},{level:2,title:"3.4.\tSÃ¼rÃ¼m YÃ¶netimi",slug:"_3-4-surum-yonetimi"},{level:2,title:"3.5.\tKaynak URI Yol YapÄ±sÄ±",slug:"_3-5-kaynak-uri-yol-yapÄ±sÄ±"},{level:2,title:"3.6.\tKarakter Kodlama",slug:"_3-6-karakter-kodlama"},{level:2,title:"3.7.\tVeri FormatÄ±",slug:"_3-7-veri-formatÄ±"},{level:2,title:"3.8.\tÄ°stemci Sertifika YÃ¶netimi",slug:"_3-8-istemci-sertifika-yonetimi"},{level:2,title:"3.9.\tYetkilendirme TÃ¼rleri",slug:"_3-9-yetkilendirme-turleri"},{level:2,title:"3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ±",slug:"_3-10-istek-cevap-mesajlarÄ±nda-kullanÄ±lan-nesne-yapÄ±larÄ±"},{level:2,title:"3.11. SayfalandÄ±rma ve Filtreleme",slug:"_3-11-sayfalandÄ±rma-ve-filtreleme"},{level:2,title:"3.12. Mesaj Ä°mzalama",slug:"_3-12-mesaj-imzalama"},{level:2,title:"3.13. Durum Kodu",slug:"_3-13-durum-kodu"},{level:2,title:"3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ±",slug:"_3-14-gereksinimlerinin-sÄ±nÄ±flandÄ±rÄ±lmasÄ±"},{level:2,title:"3.15. Ä°stek BaÅlÄ±ÄÄ±",slug:"_3-15-istek-baslÄ±gÄ±"},{level:2,title:"3.16. YanÄ±t BaÅlÄ±ÄÄ±",slug:"_3-16-yanÄ±t-baslÄ±gÄ±"},{level:2,title:"3.17. Idempotency KurallarÄ±",slug:"_3-17-idempotency-kurallarÄ±"},{level:2,title:"3.18. HTTP Durum KodlarÄ±",slug:"_3-18-http-durum-kodlarÄ±"},{level:2,title:"3.19. Maskeleme KurallarÄ±",slug:"_3-19-maskeleme-kurallarÄ±"},{level:2,title:"3.20. Fonksiyonel Olmayan Gereksinimler",slug:"_3-20-fonksiyonel-olmayan-gereksinimler"},{level:2,title:"3.21. Otomatik Sorgular",slug:"_3-21-otomatik-sorgular"}],content:' 3. Temel Prensipler  \n Bu bÃ¶lÃ¼mde Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (Hesap Bilgisi Hizmeti, Ãdeme Emri BaÅlatma Hizmeti) iÃ§in tanÄ±mlanan temel prensipler aÃ§Ä±klanmaktadÄ±r. \n 3.1 Genel \n \n \n HHSâler YÃ¶netmeliÄin 59. maddesinin beÅinci fÄ±krasÄ± ve Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄin (TebliÄ) 23. maddesinin birinci fÄ±krasÄ± uyarÄ±nca, Ã¶deme hizmetleri veri paylaÅÄ±m servislerini BKM API GeÃ§idi aracÄ±lÄ±ÄÄ±yla HBHS ve ÃBHSâye sunmakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n \n \n TebliÄin 23. maddesinin ikinci fÄ±krasÄ± uyarÄ±nca Ã¶deme emri baÅlatma hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± ÃBHS ile HHSâdir. \n \n \n TebliÄin 23. maddesinin Ã¼Ã§Ã¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca hesap bilgisi hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± HBHS ile HHSâdir. \n \n \n YÃ¶netmeliÄin 60. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, Ã¶deme emri baÅlatma hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n YÃ¶netmeliÄin 61. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, hesap bilgisi hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n TebliÄin 25. maddesi uyarÄ±nca HHS ve YÃS (ÃBHS ve HBHS) arasÄ±nda baÄlantÄ± uÃ§tan uca gÃ¼venli bir Åekilde saÄlanÄ±r. Bu amaÃ§la iletim katmanÄ±nda TLS (asgari 1.2 sÃ¼rÃ¼mÃ¼) ile Åifreli iletiÅim saÄlanÄ±r. \n \n \n TebliÄin 23. maddesinin dÃ¶rdÃ¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca HHS tarafÄ±ndan sunulan Ã¶deme hizmetleri veri paylaÅÄ±m servislerini kullanan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n TCMB tarafÄ±ndan ilgili Ã¶deme hizmeti iÃ§in yetkilendirilmiÅ olduÄu kontrol edilir. \n \n \n TebliÄin 25. maddesinin beÅinci fÄ±krasÄ± uyarÄ±nca zaman damgasÄ±, 15/1/2004 tarihli 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunu kapsamÄ±nda tanÄ±mlanan zaman damgasÄ±na dayanÄ±r. \n \n \n API alan isimleri TÃ¼rkÃ§e olarak tanÄ±mlanmÄ±ÅtÄ±r. Ancak API baÅlÄ±ÄÄ± (header) alanÄ±ndaki alan isimleri Ã¶zelinde, API GeÃ§itleri tarafÄ±ndan otomatik olarak tanÄ±nabilmesi gÃ¶zetilerek, Ä°ngilizce isimlendirme tercih edilmiÅtir. \n \n \n ÃHK halihazÄ±rda Ã¶deme hesaplarÄ±na, Ã§evrim iÃ§i (mobil bankacÄ±lÄ±k, internet bankacÄ±lÄ±ÄÄ± vb.) eriÅebilir durumda ise, HHS\'nin varsa AÃ§Ä±k BankacÄ±lÄ±k kanal veya yetki tanÄ±mÄ±nÄ± varsayÄ±lan deÄeri AÃIK olacak Åekilde sunmasÄ± gerekmektedir. HHSânin, Bireysel/Kurumsal/Ticari mÃ¼Återi ayrÄ±mÄ± yapmaksÄ±zÄ±n tÃ¼m mÃ¼Återileri iÃ§in, Ã§evrim iÃ§i kanallarda hesap hareketlerine eriÅim ve Ã¶deme yapabilme yetkisi bulunmasÄ± durumunda, yine aynÄ± Åekilde AÃ§Ä±k BankacÄ±lÄ±k kanal veya yetki tanÄ±mÄ±nÄ± da varsayÄ±lan deÄeri AÃIK olacak Åekilde sunmasÄ± gerekmektedir. \n 3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum \n \n \n Her istek tekil istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) iÃ§erir. Birden fazla istek iÃ§eren iÅlem YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi (istek numarasÄ±: X-Request-ID) ve rÄ±za sÃ¼recine Ã¶zgÃ¼ talep kimliÄi (iÅlem grup numarasÄ±: X-Group-ID) deÄerleri kullanÄ±lmalÄ±dÄ±r. AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± X-Group-ID bilgisi deÄeri gÃ¶nderilmelidir. \n \n \n Oturum takibi ise PSU-Session-ID ile yapÄ±lÄ±r. Oturum numarasÄ± (PSU-Session-ID) ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) ile birlikte ilgili tÃ¼m iÅlem verilerini iÃ§erecek Åekilde k

16ayÄ±t altÄ±na alÄ±nÄ±r. \n \n \n ÃrneÄin, bir Ã¶deme emri baÅlatma iÅlemi birden fazla istekten oluÅur. Her istek yukarÄ±da belirtildiÄi gibi biricik istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) iÃ§erir. Ancak iÅlemin oturum bÃ¼tÃ¼nlÃ¼ÄÃ¼ PSU-Session-ID ile saÄlanÄ±r. \n \n \n Taraflar aÃ§tÄ±klarÄ± oturumu iÅlem bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ saÄlayacak sÃ¼re iÃ§erisinde aÃ§Ä±k tutar ve iÅlem biter bitmez kapatÄ±r. \n 3.3.\tRESTful API \n APIâler, dÃ¼nya Ã¶lÃ§eÄinde yaygÄ±n bir Åekilde kullanÄ±lan Temsili Durum Transferi (Representational State Transfer, REST) mimari tarzÄ± ve JavaScript Nesne Notasyonu (JavaScript Object Notation, JSON) veri formatlarÄ±na uygun olarak geliÅtirilir. En Ã¼st seviye Veri TanÄ±mlama Dili (Data Description Language) ve en iyi uygulama Ã¶rnekleri iÃ§in  ^JSON ÅemasÄ±  temel alÄ±nÄ±r. \n Ä°stek ve yanÄ±t mesajlarÄ±nda, isteÄe baÄlÄ± veya koÅullu bir alan, deÄer iÃ§ermiyorsa, bu alan JSON payloadunda yer almamalÄ±dÄ±r. \n Ãrnek kod bloÄu. \n "rzBlg":{\n         "rizaNo":"aa9bd7e7-0ccd-4edc-9639-5a358dbf2335",\n         "olusZmn":"2022-11-28T12:00:21+03:00",\n         "gnclZmn":null,    --\x3e hatalÄ±\n         "rizaDrm":"K",\n         "rizaIptDtyKod":"" --\x3e hatalÄ± \n      },\n \n Ãrnek kod bloÄu: \n \n         "alc":{\n            "hspNo": "TR800800004162387689546019",\n            "unv": "AHMET YILMAZ", \n            "kolas":{}  --\x3e nesne gÃ¶nderimi hatalÄ±\n         },\n 3.4.\tSÃ¼rÃ¼m YÃ¶netimi \n API sonraki aÅamalarda doÄabilecek gereksinimleri ve daha karmaÅÄ±k kullanÄ±m durumlarÄ±nÄ± karÅÄ±lamak iÃ§in sÃ¼rÃ¼mler halinde geliÅtirilir ve bu durum tasarÄ±m sÄ±rasÄ±nda gÃ¶z Ã¶nÃ¼nde bulundurulur. \n API v1.0 sÃ¼rÃ¼mÃ¼nde ; \n \n Kapsamdaki Ã¶deme hesaplarÄ± : Vadesiz TL, yabancÄ± para hesaplarÄ± (gerÃ§ek ve tÃ¼zel kiÅilere ait Ã¶deme hesaplarÄ±), Kredili Mevduat HesabÄ± \n Tekil Ã¶deme (Virman/Havale/FAST/MÃ¼ÅterilerarasÄ± TL AktarÄ±m Sistemi)\n \n Virman ve havale iÅlemleri kapsamÄ±nda yabancÄ± para transferi yapÄ±labilir. \n \n \n Hesap bilgisi hizmetleri\n \n Temel veya ayrÄ±ntÄ±lÄ± hesap bilgisi \n Bakiye \n GerÃ§ekleÅen iÅlemler iÃ§in Hesap hareketleri \n \n \n Karekodlu Ã¶demelerdeki 01, 02 ve 03 akÄ±Å tÃ¼rleri\nyer almaktadÄ±r. \n \n Her sÃ¼rÃ¼m deÄiÅikliÄinde bir Ã¶nceki sÃ¼rÃ¼m belirli bir sÃ¼re desteklenecektir. DiÄer bir ifadeyle, sadece belirli bir sÃ¼re iÃ§in mevcut ve bir Ã¶nceki sÃ¼rÃ¼m aynÄ± anda eriÅilebilir olacaktÄ±r. \n 3.5.\tKaynak URI Yol YapÄ±sÄ± \n YÃSâlerin baÅlattÄ±ÄÄ± Ã§aÄrÄ±larda URI yolu aÅaÄÄ±daki yapÄ±yÄ± takip eder: \n [hhs-yol-Ã¶n-eki]/ohvps/ [kaynak-grubu]/ [sÃ¼rÃ¼m]/ [kaynak]/[kaynak-no]/[alt-kaynak] \n Bu, aÅaÄÄ±daki unsurlardan oluÅur: \n \n [hhs-yol-Ã¶n-eki] \nÄ°steÄe baÄlÄ±, HHS\'ye Ã¶zgÃ¼ yol Ã¶n ekini ifade eder. \nBKM API geÃ§idi Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda BKM tarafÄ±ndan belirlenen sistem adÄ± ve yol Ã¶n eki kullanÄ±lÄ±r. \n ohvps \nSabit metin âohvpsâ (Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri kÄ±saltmasÄ±) \n [kaynak-grubu] \nKaynak grubu, APIâye eriÅmek iÃ§in kullanÄ±lan Ã¶deme hizmetine (HBH, ÃBH) gÃ¶re eriÅim adresi (end point) grubunu tanÄ±mlar (âhbhâ veya âobhâ). \n [sÃ¼rÃ¼m] \nAPI sÃ¼rÃ¼mÃ¼nÃ¼ ifade eder (â/s[ana-sÃ¼rÃ¼m].[alt-sÃ¼rÃ¼m]/â). \n [kaynak]/[kaynak-no] \nKaynak detaylarÄ±nÄ± ifade eder. \n [alt-kaynak] \nAlt kaynak detaylarÄ±nÄ± ifade eder. \n \n HHS, tÃ¼m kaynaklarÄ± iÃ§in aynÄ± katÄ±lÄ±mcÄ± yolu Ã¶n ekini ve sistem adÄ±nÄ± kullanmalÄ±dÄ±r. \n BKM APIâlerine eriÅmek isteyen uygulamalarÄ±n yetkilerine gÃ¶re aÅaÄÄ±daki APIâlere abone olmalarÄ± gerekmektedir: \n OBH: \n https://secure.api-preprod.bkm.com.tr/ohvps/obh/s1.0/odeme-emri-rizasi \n https://secure.api-preprod.bkm.com.tr/ohvps/obh/s1.0/odeme-emri \nHBH: \n https://secure.api-preprod.bkm.com.tr/ohvps/hbh/s1.0/hesap-bilgisi-rizasi \n https://secure.api-preprod.bkm.com.tr/ohvps/hbh/s1.0/hesaplar \n https://secure.api-preprod.bkm.com.tr/ohvps/hbh/s1.0/hesaplar/1234/islemler \n https://secure.api-preprod.bkm.com.tr/ohvps/hbh/s1.0/hesaplar/1234/bakiye \nGKD \n https://secure.api-preprod.bkm.com.tr/ohvps/gkd/s1.0/erisim-belirteci \nHHS â YÃS API \n https://secure.api-preprod.bkm.com.tr/hhs-api/s1.0/hhs \n https://secure.api-preprod.bkm.com.tr/hhs-api/s1.0/hhs/1234 \n https://secure.api-preprod.bkm.com.tr/yos-api/s1.0/yos \n https://secure.api-preprod.bkm.com.tr/yos-api/s1.0/yos/1234 \n HHSâlerin saÄlayacaklarÄ± APIâlerdeki URI Ã§evrimi Ã¶rnekleri aÅaÄÄ±daki gibidir. \n \n https://xbank.com.tr/api-portal/ohvps/obh/s1.0/o

16deme-emri \n https://secure.api-preprod.bkm.com.tr/ohvps/obh/s1.0/odeme-emri  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.0/hesap-bilgisi-rizasi \n https://secure.api-preprod.bkm.com.tr/ohvps/hbh/s1.0/hesap-bilgisi-rizasi  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.1/hesaplar \n https://secure.api-preprod.bkm.com.tr/ohvps/hbh/s1.1/hesaplar   (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.1/hesaplar/1234 \n https://secure.api-preprod.bkm.com.tr/ohvps/hbh/s1.1/hesaplar/1234  (BKM API) \n \n BKM API GeÃ§idi Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda, istek baÅlÄ±ÄÄ±nda bulunan âx-aspsp-codeâ (isteÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodu) deÄerine gÃ¶re HHS APIâde standart olarak tanÄ±mlanmÄ±Å olan âbasePathâ bilgisine servis uzantÄ±sÄ± eklenerek HHSâye yÃ¶nlendirme yapÄ±lÄ±r. \n ÃrneÄin, istek baÅlÄ±ÄÄ±nda  xbank âÄ±n kodu varsa, YÃS tarafÄ±ndan yapÄ±lan \n https://secure.api-preprod.bkm.com.tr/ohvps/hbh/s1.0/hesap-bilgisi-rizasi \nÃ§aÄrÄ±sÄ± BKM API GeÃ§idi tarafÄ±ndan karÅÄ±lanarak \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.0/hesap-bilgisi-rizasi \nadresine yÃ¶nlendirilir. \n Bu Ã¶rnekte,  https://xbank.com.tr/api-portal  basePath bilgisi HHS tarafÄ±ndan HHS APIâye girilen deÄerdir. \n 3.6.\tKarakter Kodlama \n API istekleri ve yanÄ±tlarÄ±nda UTF-8 karakter kodlamasÄ± kullanÄ±lÄ±r. Bu, JSON iÃ§in varsayÄ±lan karakter kodlamasÄ±dÄ±r. \n Ancak, bir HHS\'nin kendi uygulamalarÄ± ve Ã¶deme baÅlattÄ±ÄÄ± Ã¶deme sistemi (FAST vb.)  bazÄ± UTF-8 karakterlerini kabul etmeyebilir. HHS, UTF-8 kodlamasÄ± iÃ§eren bir mesajÄ± iÅleyemez ve reddederse, HTTP 400 (HatalÄ± Ä°stek) durum kodu ile yanÄ±t vermelidir. \n 3.7.\tVeri FormatÄ± \n \n AÃ§Ä±k bankacÄ±lÄ±k kapsamÄ±ndaki zaman damgasÄ±, ISO 8601 standartÄ±na uygun olarak yerel saat bilgisini ve timezone bilgisini de iÃ§erecek Åekilde " yyyy-MM-ddâTâHH:mm:ssXXX " formattaki haliyle hazÄ±rlanmalÄ±dÄ±r. \n \n Ãrnek:  "timestamp": "2021-05-30T20:34:15+03:00" \nyyyy : 4 hane yÄ±l \nMM : BaÅa â0â eklenmiÅ, toplam 2 hane ay \ndd    : BaÅa â0â eklenmiÅ, toplam 2 hane gÃ¼n \nHH    : BaÅa â0â eklenmiÅ, toplam 2 hane saat (0-23 arasÄ± deÄer alabilir.) \nmm : BaÅa â0â eklenmiÅ, toplam 2 hane dakika \nss    : BaÅa â0â eklenmiÅ, toplam 2 hane saniye \nXXX : ISO 8601 Time zone \n \n \n JWT veri paketlerinde kullanÄ±lan zaman damgalarÄ±, 1 Ocak 1970 Saat 00:00:00 (UTC) anÄ±ndan itibaren geÃ§en saniye sayÄ±sÄ± deÄerini (Unix Time) kullanmalÄ±dÄ±r. \n \n \n Bir HHS, tarihi yanlÄ±Å biÃ§imlendirilmiÅ bir istek aldÄ±ÄÄ±nda, 400 (HatalÄ± Ä°stek) durum kodu ve ilgili hata kodu ile yanÄ±t vermelidir. \n \n \n ISO 4217 StandartÄ±nda para birimleri ve kaÃ§ basamak ondalÄ±k deÄer iÃ§erebilecekleri belirlenmiÅtir. \n https://www.iso.org/iso-4217-currency-codes.html   adresinden Ã¼cretsiz olarak listeye eriÅilebilir.  \nAPI StandartlarÄ±nda da para birimleri  ISO 4217âde tanÄ±mlanmÄ±Å olan 3 harfli kodlarla iletilir.   TÃ¼m tutar alanlarÄ± ISO 4217\'de tanÄ±mlanmÄ±Å para birimlerinin ondalÄ±k basamak deÄerleri de gÃ¶z Ã¶nÃ¼nde bulundurularak iletilmelidir. Tutar alanlarÄ± artÄ± ya da eksi deÄer alabileceÄi iÃ§in API deseninde tanÄ±mlanmÄ±Å regular expressionlar dikkate alÄ±nmalÄ±dÄ±r. \nÃrneÄin; Bakiye API\'sindeki "Kredili Mevduat HesabÄ± Bakiyesi" alanÄ± "-100.25" ve "Para Birimi" alanÄ± "TRY" olarak iletildiÄinde 25 deÄerinin kuruÅ olduÄu anlaÅÄ±lmalÄ±dÄ±r. \nÃdeme Emri RÄ±zasÄ± API\'sinde yer alan "Ä°Ålem TutarÄ±" alanÄ± "104.75" TRY olarak iletildiÄinde "75" deÄerinin kuruÅ olduÄu anlaÅÄ±lmalÄ±dÄ±r. \n"12000" Japon Yeni iÃ§in, ISO 4217âde JPY para biriminin ondalÄ±k kÄ±smÄ± olmadÄ±ÄÄ±ndan "Ä°Ålem TutarÄ±" alanÄ±nda "12000" ve "Para Birimi" alanÄ±nda "JPY" deÄeri  iletilmelidir. \n \n \n AltÄ±n para birimi Ã¶zelinde ISO 4217âye uygun olarak "XAU" cinsinde ve 2 basamak ondalÄ±k rakam iÃ§erecek Åekilde iletilmelidir. ÃrneÄin iÃ§erisinde "13,50 gr" altÄ±n olan hesap iÃ§in bakiye "13.50", para birimi "XAU" olarak gÃ¶nderilmelidir. \n \n \n DiÄer madenlerde ondalÄ±k basamak ISO 4217 standartÄ±nda tanÄ±mlandÄ±ÄÄ± gibi olmalÄ±dÄ±r. \n \n \n SÄ±ralÄ± veri tipleri bÃ¼yÃ¼k kÃ¼Ã§Ã¼k harfe duyarlÄ± olmalÄ±dÄ±r. \n 3.8.\tÄ°stemci Sertifika YÃ¶netimi \n ÃHVPS kapsamÄ±nda YÃS ve HHSâlerin gÃ¼venli bir Åekilde tanÄ±mlanmasÄ± amacÄ±yla elektronik sertifikalar kullanÄ±lÄ±r. \n ÃHVPS kapsamÄ±nda taraflarÄ±n gÃ¼venli bir Åekilde tanÄ±mlamasÄ±, uÃ§tan uca gÃ¼venli iletiÅim, mesaj Åifreleme ve mesaj imzalama iÅlevleri 15/1/2004 tarihli ve 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunuânda aÃ§Ä±klanan elektronik sertifikalar kullanÄ±larak saÄlanÄ±r. Elektronik sertifikada TÃ¼rkiye Cumhuriyet Merkez BankasÄ± tarafÄ±ndan verilen kuruluÅ kodu ve kuruluÅun tÃ¼rÃ¼ne dair bilgiler bulunur. \n BKM API GeÃ§idi Ã¼zerinden yapÄ±lan eriÅimlerde YÃS ve HHSâlere Ã¶nceden daÄÄ±tÄ±lmÄ±Å olan istemci sertifikalarÄ± kullanÄ±larak taraflarÄ±n (sunucu) kimlikler

16inin doÄrulanmasÄ± saÄlanacaktÄ±r. Ä°stemci sertifikalarÄ± hem test hem de Ã¼retim ortamÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi sertifikasyon sÃ¼recinde de sÄ±nanacaktÄ±r. SÃ¶z konusu sertifikalarÄ±n daÄÄ±tÄ±m prosedÃ¼rleri ve kullanÄ±mlara yÃ¶nelik aÃ§Ä±klamalar EK-3âte yer verilmiÅtir. \n 3.9.\tYetkilendirme TÃ¼rleri \n BKM API GeÃ§idi Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda iki temel yetkilendirme tÃ¼rÃ¼ kullanÄ±lÄ±r: \n 1.\tÄ°stemci Kimlik Bilgileri:  MÃ¼Återi onayÄ±nÄ±n gerekmediÄi, sadece YÃSâÃ¼n tanÄ±mlanÄ±p doÄrulandÄ±ÄÄ± API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. YÃSâÃ¼n yetkilendirilmiÅ olduÄu ve faaliyet izninin yaptÄ±ÄÄ± hizmet Ã§aÄrÄ±sÄ±na uygun olduÄu kontrol edilir.  Bu amaÃ§la, YÃSâlere clientId ve clientSecret tahsis edilecektir. YÃSâler ilgili clientId ve clientSecret ile sadece yetkilendirilmiÅ olduklarÄ± servislere eriÅebileceklerdir. YÃSâler kendilerine BKM tarafÄ±ndan sunulacak APIâyi, kendi clientID ve clientSecret deÄerleri ile sorgulayarak âÄ°stemci Kimlik Bilgileriâ belirtecini (access token) elde edeceklerdir.\nHHSâler de BKM API geÃ§idi Ã¼zerindeki YÃS APIâsini sorgulama maksadÄ± ile BKM API GeÃ§idine geldiklerinde, kendilerine atanmÄ±Å olan clientID ve clientSecret bilgileri ile yetki kontrolleri yapÄ±lÄ±r.\nHHSâler kendilerinden alÄ±nacak username ve password deÄerleri kullanÄ±larak oluÅturulacak basic authentication metodu ile servislerini sunacaklardÄ±r. \n 2.\tYetkilendirme Kodu:  YÃSâÃ¼n doÄrulanmasÄ±nÄ±n yanÄ±sÄ±ra mÃ¼Återinin GKD ile doÄrulanmasÄ± gereken API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. MÃ¼Återi doÄrulanarak yetkilendirme kodu oluÅturulmasÄ± HHSânin yetkilendirme arayÃ¼zÃ¼ne yÃ¶nlendirilir. GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda yetkilendirme kodu YÃSâe dÃ¶nÃ¼lÃ¼r. YÃS daha sonra HHSânin  eriÅim belirteci  (access token) eriÅim adresini (EK-3: POST /erisim-belirteci) Ã§aÄÄ±rmak suretiyle yetkilendirme kodunu bir eriÅim belirteci (access token) ile deÄiÅtirerek ilgili kaynaklarÄ± kullanabilir. \n Ãdeme emri baÅlatma ve hesap bilgisi hizmetlerinde hangi yetkilendirme tÃ¼rlerinin kullanÄ±lacaÄÄ± bilgisi, ilgili baÅlÄ±klardaki eriÅim adresleri (endpoints) tablolarÄ±nda yer almaktadÄ±r. \n erisim-belirteci  erisim noktasÄ±ndan elde edilen  erisimBelirteci  iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda  x-access-token  alanÄ±nda iletilir.\nBelirli bir sÃ¼re iÃ§in tanÄ±mlanan eriÅim belirteci (access token) deÄerinin yenileme belirteci (refresh token) ile yenilenmesi gerekir. \n EriÅim adreslerinde kullanÄ±lan yetkilendirme tÃ¼rÃ¼ ilgili eriÅim adresi tablolarÄ±nda belirtilmiÅtir. \n 3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ± \n Ä°stek ve Cevap mesajlarÄ±nda kullanÄ±lacak olan nesneler tÃ¼m elemanlarÄ±nÄ± kapsayacak Åekilde Ek-1 de listelenmiÅtir. TÃ¼m listelenen elemanlar aÃ§Ä±sÄ±ndan (UÃ§ nokta mesaj yapÄ±larÄ±nÄ±n belirtildiÄi tablolarda belirtildiÄi Ã¼zere) alanÄ±n Zorunlu (z) veya Ä°steÄe BaÄlÄ± (Ä°) olma durumlarÄ±na gÃ¶re bazÄ± alanlar gÃ¶nderilebilir veya gÃ¶nderilmeyebilir. \n 3.11. SayfalandÄ±rma ve Filtreleme \n SayfalandÄ±rma \n ÃaÄrÄ±ya dÃ¶nÃ¼len kaynak nesnesi iÃ§erisindeki kayÄ±tlar bir sayfalandÄ±rma yapÄ±sÄ± ile Ã§aÄrÄ±lacak Åekilde istek oluÅturulur. \n OluÅturulacak isteÄin iÃ§erisinde parametreler ile filtreleme, sayfa baÅÄ±na gÃ¶sterilecek kayÄ±t sayÄ±sÄ± ve hangi sayfanÄ±n Ã¶nyÃ¼zde gÃ¶sterileceÄi bilgileri eriÅim noktasÄ±na iletilir ve ilgili kayÄ±tlar cevap olarak alÄ±nÄ±r. \n Filtreleme \n HHS, birden Ã§ok kayÄ±t dÃ¶nÃ¼lmesi gereken GET Ã§aÄrÄ±larÄ±nda sÄ±nÄ±rlÄ± filtreleme desteÄi saÄlamalÄ±dÄ±r. Filtre parametreleri her zaman kaynak nesnesinin belirli alanlarÄ±na Ã¶zgÃ¼dÃ¼r ve nesne iÃ§in tanÄ±mlanan kurallara uymalÄ±dÄ±r. \n 3.12. Mesaj Ä°mzalama \n Elektronik imzalar, ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini destekler. Ä°mzalarÄ±n kaynak bazÄ±nda hangi istek ve yanÄ±tlara uygulandÄ±ÄÄ± belirlidir. \n API yalnÄ±zca TLS\'ye dayanÄ±rsa, dijital kayÄ±tlarÄ± ve inkÃ¢r edilemezlik kanÄ±tlarÄ±nÄ± tutmak zor olur. Bu nedenle, TLS\'ye dayanmayan bir inkÃ¢r edilemezlik Ã§Ã¶zÃ¼mÃ¼ olarak API isteÄinin HTTP baÅlÄ±ÄÄ±nda bir JWS kullanÄ±larak saÄlanabilir. \n HTTP isteÄinin gÃ¶vdesinin hash fonksiyonu (SHA256) ile Ã¶zeti alÄ±nacaktÄ±r. Elde edilen Ã¶zet, asimetrik anahtarlarÄ± de

16stekleyen bir algoritma kullanÄ±larak imzalanacak ve JWS elde edilecektir. \n Bir istek, YÃS\'nin Ã¶zel anahtarÄ± ile imzalanacak ve bu isteÄe karÅÄ±lÄ±k gelen yanÄ±t, HHS\'nin Ã¶zel anahtarÄ± tarafÄ±ndan imzalanacaktÄ±r. \n TÃ¼m API istekleri ve yanÄ±tlarÄ± imzalanmaz. Mesaj imzalamanÄ±n zorunlu olup olmadÄ±ÄÄ±, desteklenip desteklenmediÄi her API Ã¶zelinde belirlenir. \n Anahtar Deposu \n HHS\'ler ve YÃS\'ler tarafÄ±ndan gÃ¼venilen bir GÃ¼ven Otoritesi (Trust Anchor), taraflar iÃ§in bir genel anahtar deposu saÄlamaktan sorumludur. \n GÃ¼ven Otoritesi, taraflardan herhangi birisinin oluÅturduÄu bir anahtar Ã§iftinin aÃ§Ä±k bÃ¶lÃ¼mÃ¼nÃ¼ saklayan merkezi bir dizin (BKM tarafÄ±ndan tutulan merkezi kayÄ±t sistemi vb.) olacaktÄ±r. \n MesajlarÄ± doÄrulamak iÃ§in taraflarÄ±n genel anahtarlarÄ±nÄ±n paylaÅÄ±lmasÄ± iÃ§in BKM bir servis saÄlayacaktÄ±r. HHS API olarak adlandÄ±rÄ±lÄ±mÄ±Å olan bu servis ile HHS ve YÃS listelerine ulaÅÄ±labildiÄi gibi doÄrulama iÅlemi iÃ§in ihtiyaÃ§ duyulacak olan genel anahtarlara da bu servis Ã¼zerinden eriÅilebilinecektir. \n Ä°lgili Mesaj Åifreleme iÃ§in genel akÄ±Å, Ek-5 bÃ¶lÃ¼mÃ¼nde detaylarÄ±yla paylaÅÄ±lmaktadÄ±r. \n 3.13. Durum Kodu \n APIâler, iki farklÄ± amaca hizmet eden iki durum kodu kullanÄ±r: \n \n HTTP Durum Kodu, API Ã§aÄrÄ±sÄ±nÄ±n (kaynaktaki HTTP iÅlemi) sonucunu yansÄ±tÄ±r. \n BazÄ± kaynak payloadâlarÄ±ndaki Durum alanÄ±, kaynaklarÄ±n durumunu yansÄ±tÄ±r. \n 3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ± \n EriÅim adreslerinin ve alanlarÄ±n kullanÄ±mÄ± Zorunlu(Z), Ä°steÄe BaÄlÄ±(Ä°) veya KoÅullu(K) olabilir. KullanÄ±mlara iliÅkin durumlar ve kullanÄ±mÄ±n (K) koÅullu olduÄu duruma iliÅkin aÃ§Ä±klamalar ilgili tablolarda belirtilmiÅtir. \n ÃHVPS API\'lerinin (HBH,ÃBH,GKD) istek ve yanÄ±tta kullanÄ±lacak baÅlÄ±k isimleri, ilgili RFC dokÃ¼manlarÄ±nda ve aÅaÄÄ±daki tabloda yer aldÄ±ÄÄ± Åekilde kullanÄ±lacaktÄ±r.  Uygulamaya Ã¶zelleÅmiÅ baÅlÄ±klar "X-" ile baÅlayacaktÄ±r. BaÅlÄ±k isimlerinde yer alacak kÄ±saltmalar (Ã¶rn. PSU, ASPSP gibi) tamamÄ± bÃ¼yÃ¼k harfle yazÄ±lacak Åekilde tanÄ±mlanacaktÄ±r. BaÅlÄ±k isimleri bÃ¼yÃ¼k â kÃ¼Ã§Ã¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin x-request-id ya da X-Request-ID olarak gÃ¶nderilmiÅ olan bir istek baÅlÄ±ÄÄ± deÄiÅkeni, sunucu tarafÄ±nda hata vermeyecek Åekilde iÅlenebilmelidir. \n 3.15. Ä°stek BaÅlÄ±ÄÄ± \n \n "BaÅlÄ±k isimleri" yorumlanÄ±rken kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin "x-ReQuEsT-Id" geÃ§erli bir baÅlÄ±k ismidir. \n "BaÅlÄ±k deÄerleri" yorumlanÄ±rken ise kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harf duyarlÄ±lÄ±ÄÄ± olmalÄ±dÄ±r. ÃrneÄin "xyz123" ile "XYZ123" deÄerleri farklÄ±dÄ±r. \n BaÅlÄ±k deÄerlerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r. ÃrneÄin "PSU-Device-Data" deÄerinde "Ä°OS12" yazmak, bÃ¼yÃ¼k "Ä°" harfinin ISO-8859-1 iÃ§erisinde yer almamasÄ±ndan dolayÄ±, hataya yol aÃ§acaktÄ±r. \n \n Tablo 2: Ä°stek BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n POST \n GET \n DELETE \n \n \n \n \n X-Request-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±.   Ãrnek: Ãdeme emri baÅlatma iÅ akÄ±ÅÄ±nÄ±n her adÄ±mda farklÄ± âx-request-idâ deÄeri kullanÄ±lÄ±r.   ÃaÄrÄ±larÄ±n aynÄ± yanÄ±tÄ± dÃ¶nmesinin beklendiÄi durumlarda (idempotent iÅlemlerde) aynÄ± deÄer ile Ã§aÄrÄ± yapÄ±lÄ±r. \n Z \n Z \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±.  AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± x-group-id bilgisi deÄeri gÃ¶nderilmelidir. Ãrnek: Ãdeme emri baÅlatma/hesap bilgisi iÅ akÄ±ÅÄ±nÄ±n her adÄ±mÄ±nda aynÄ± âx-group-idâ deÄeri kullanÄ±lÄ±r. \n Z \n Z \n Z \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder. Bu deÄerin application/json olarak gÃ¶nderilmesi gerekmektedir.  (BaÅka bir deÄere ayarlanÄ±rsa, HHS, 415 Desteklenmeyen Ortam TÃ¼rÃ¼ (Unsupported Media Type) ile yanÄ±t vermelidir) \n Z \n - \n

16- \n \n \n X-ASPSP-Code \n AN4 \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n Z \n Z \n \n \n X-TPP-Code \n AN4 \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n Z \n Z \n \n \n PSU-Auth-Date \n ISODateTime \n ÃHKânÄ±n YÃS Ã¼zerinde en son oturum aÃ§tÄ±ÄÄ± saat. [RFC7231] ÃrneÄin:  auth-date: Tue, 11 Sep 2012 19:43:31 GMT \n Ä° \n Ä° \n Ä° \n \n \n PSU-IP-Adress \n AN7..15 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n IP adresi. \n Ä° \n Ä° \n Ä° \n \n \n PSU-IP-Port \n AN1..5 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n Port adresi. \n Ä° \n Ä° \n Ä° \n \n \n PSU-GEO-Location \n AN1..36 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n konum bilgisi. RFC2426 standartÄ±na uygun olarak paylaÅÄ±lmalÄ±dÄ±r. ÃrneÄin  GEO:"<enlem >, <boylam>GEO:52.506931,13.144558 \n Ä° \n Ä° \n Ä° \n \n \n PSU-User-Agent \n AN 1.. 255 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n saÄladÄ±ÄÄ± user-agent bilgisi. (TarayÄ±cÄ±, versiyon, iÅletim sistemi bilgileri) \n Ä° \n Ä° \n Ä° \n \n \n PSU-Timestamp \n ISODateTime \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n tarih saat iÃ§eren zaman bilgisi. \n Ä° \n Ä° \n Ä° \n \n \n PSU-Device-ID \n AN5..40 \n ÃHK iÅlemi mobil uygulama aracÄ±lÄ±ÄÄ±yla baÅlattÄ±ysa, kullanÄ±lan mobil uygulama ilk yÃ¼klendiÄinde oluÅturulan tekil cihaz veya uygulama belirteci. ÃHK cihazÄ±nÄ±n UUID deÄeri kullanÄ±labilir. \n Ä° \n Ä° \n Ä° \n \n \n PSU-Device-Data \n AN1..1024 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± mobil cihaza ait veriler.  Ãrnek alanlar:   - Platform - (Android, iOS, Windows 10 Mobile)  - Device Model   - OS Name   - OS Version - Locale - Time zone \n Ä° \n Ä° \n Ä° \n \n \n PSU-Fraud-Check \n AN1..4096 \n YÃS\'lerin Ã§eÅitli gÃ¼venlik kontrollerini gerÃ§ekleÅtirerek, Ã¶nemli gÃ¶rÃ¼len aÅaÄÄ±daki bilgileri HHS\'ler ile paylaÅmalarÄ± gerekmektedir. Bu bilgiler Ä±ÅÄ±ÄÄ±nda mÃ¼Återinin profili oluÅturulmasÄ±na katkÄ± saÄlanacaktÄ±r.   ÃHKâlÄ± iÅlemlerde (PSU-Initiated = E gÃ¶nderildiÄi durumlarda) gÃ¶nderilmesi zorunludur.  Sistemsel yapÄ±lan API Ã§aÄrÄ±mlarÄ±mda ve HHS-YÃS API Ã§aÄrÄ±mlarÄ±nda gÃ¶nderilmesine gerek bulunmamaktadÄ±r.  PaylaÅÄ±lacak bilgiler Åu Åekildedir.   FirstLoginFlag  : ÃHK\'nÄ±n, mÃ¼Återilik Ã¶mrÃ¼nde ilgili YÃS sistemine (mobil ya da web uygulamasÄ±) ilk login olma sÃ¼resini ifade eden deÄer. ÃHK\'nÄ±n ilk yaptÄ±ÄÄ± HBH ya da ÃBH iÅlemi deÄil, YÃS sisteminde kendini aktifleÅtirme tarih aralÄ±ÄÄ± bilgisidir.   YÃS, kullanÄ±cÄ±nÄ±n ilk login bilgisini tutarak sonraki iÅlemlerinde bu bilgiyi belirlenen format ile HHS\'ye aktaracaktÄ±r. ÃrneÄin; YÃS\'Ã¼n 7 aydÄ±r mÃ¼Återisi olan bir kullanÄ±cÄ± iÃ§in bu alan "5" olarak YÃS tarafÄ±ndan beslenecektir. Burada amaÃ§; ilgili kullanÄ±cÄ±nÄ±n YÃS\'Ã¼n eski bir mÃ¼Återisi mi, yoksa yeni bir mÃ¼Återisi mi olup olmadÄ±ÄÄ±nÄ± anlamaktÄ±r.   GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   DeviceFirstLoginFlag  : ÃHK\'nÄ±n, mÃ¼Återilik Ã¶mrÃ¼nde iÅlem anÄ±nda kullandÄ±ÄÄ± cihazla YÃS uygulamasÄ±na (web ya da uygulama tabanlÄ±) ilk login olma sÃ¼resini ifade eden deÄer. ÃHK cihaz deÄiÅikliÄi yaparsa FirstLoginFlag deÄeri sabit kalmalÄ±  ancak DeviceFirstLoginFlag deÄeri deÄiÅmelidir.  FirstloginFlag deÄeri ile ÃHKânÄ±n YÃS uygulamasÄ±na ilk login tarih bilgisi ile ilgili bilgi verilirken, DeviceFirstLoginFlag ile de ÃHKânÄ±n YÃS uygulamasÄ±na farklÄ± bir cihaz aracÄ±lÄ±ÄÄ± ile ilk login tarihinin bilgisi verilmektedir.  ÃrneÄin; ÃHK 7 aydÄ±r YÃS\'Ã¼n mÃ¼Återisi olabilir, bÃ¶yle bir durumda FirstLoginFlag deÄeri "5" olacaktÄ±r. Ancak son iÅlemini daha Ã¶nce hiÃ§ kullanmadÄ±ÄÄ± bir cihazdan yapmÄ±ÅtÄ±r. Yeni cihazdaki login sÃ¼re aralÄ±ÄÄ± 0-2 saat aralÄ±ÄÄ±nda  olduÄu iÃ§in DeviceFirstLoginFlag deÄeri "1" olacaktÄ±r.FirstLoginFlag deÄeri yine "5" olarak kalmaya devam edecektir.Bu bilgi ile YÃS, ilgili HHS\'ye ilk kez geliyor olsa bile;

16 HHS, mÃ¼Återinin YÃS\'Ã¼ uzun sÃ¼redir kullandÄ±ÄÄ±nÄ± ama yeni bir cihazla iÅlemlerine devam ettiÄini anlayabilecektir. Bir ÃHK, farklÄ± cihazlar veya platformlar Ã¼zerinden YÃS ile etkileÅime girebilir.  KullanÄ±cÄ± ve YÃS arasÄ±nda bir oturum baÅlatÄ±lmÄ±Å ise YÃSâÃ¼n tutarlÄ± ve kalÄ±cÄ± bir kimlik (device id) atamasÄ± beklenmektedir.  Device ID: Web sitesi veya mobil uygulama kullanÄ±cÄ±larÄ± iÃ§in Ã¼retilen, tarayÄ±cÄ± ya da mobil uygulama tabanlÄ± benzersiz (tekil) tanÄ±mlayÄ±cÄ± deÄer. Mobil uygulamalar iÃ§in ÃHKânÄ±n ilk defa ilgili cihaza aktivasyon yaptÄ±ÄÄ± tarih bilgisi alÄ±nmalÄ±dÄ±r.   Device ID bilgileri YÃS uygulama ortamÄ± (web ya da uygulama tabanlÄ±) ve ÃHK cihazÄ± bazÄ±nda tutulmalÄ±dÄ±r. YÃSâten baÅlatÄ±lan iÅlem hangi uygulama ortamÄ±na ait ise ilgili ortamala iliÅkili tutulan Device IDânin ilk login tarihine bakÄ±larak gÃ¼ncel flag deÄeri hesaplanmalÄ±dÄ±r.  GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   LastPasswordChangeFlag  : ÃHK\'nÄ±n, YÃS (cihaz baÄÄ±msÄ±z)  uygulamasÄ±na login olduÄu Åifre bilgisinin en son deÄiÅtirildiÄi sÃ¼reyi ifade eden deÄer. MÃ¼Återinin en son ne zaman Åifre deÄiÅikliÄi yaptÄ±ÄÄ±nÄ± anlamak iÃ§in kullanÄ±lan alandÄ±r. Yeni mÃ¼Återi ve hiÃ§ Åifre deÄiÅikliÄi yapmamÄ±Å olabilir, bÃ¶yle bir durumda ilgili alan "0" olarak beslenecektir.   GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   BlacklistFlag  : ÃHK\'nÄ±n herhangi bir sebeple YÃS\'Ã¼n sakÄ±ncalÄ± mÃ¼Återiler listesinde bulunup bulunmadÄ±ÄÄ±nÄ± ifade eden deÄer.   Burada amaÃ§ herhangi bir sebeple YÃS tarafÄ±nda yasaklÄ± olarak kayÄ±tlÄ± olan ÃHK bilgisinin, dolandÄ±rÄ±cÄ±lÄ±ÄÄ± Ã¶nceden tespit etmek amaÃ§lÄ± HHS\'ye aktarÄ±lmasÄ± olarak aÃ§Ä±klanabilir. ÃrneÄin, YÃS tarafÄ±ndan tespit edilen dolandÄ±rÄ±cÄ± kullancÄ±lara ait device id bilgisi, bu kara listede tutulur daha sonra aynÄ± cihazla baÅka bir ÃHK iÅlem yapacak olsa bile bu alanda ilgili bilgi "1" deÄeri ile HHS\'ye aktarÄ±lÄ±r. HHS\'de olmayÄ±p YÃS tarafÄ±nda olan bu Ã¶rnekteki sakÄ±ncalÄ± mÃ¼Återi/cihaz bilgisinin, dolaylÄ± yoldan HHS\'ye aktarÄ±lmasÄ± amaÃ§lanmaktadÄ±r.  GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.VarYok sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   MalwareFlag  : YÃS uygulamasÄ±nÄ±n Ã§alÄ±ÅtÄ±ÄÄ± cihaz Ã¼zerindeki son 21 gÃ¼ne ait zararlÄ± yazÄ±lÄ±m tespit bilgisini ifade eden deÄer. ÃrneÄin ÃHK\'nÄ±n cihazÄ±nda zararlÄ± yazÄ±lÄ±m olduÄu ayÄ±n 1\'inde YÃS tarafÄ±ndan tespit edildi. ZararlÄ± yazÄ±lÄ±m tespitinden 2 saat sonra YÃS Ã¼zerinden login olan ÃHK\'nÄ±n durumu,  "1" olarak iletilecektir. Bir gÃ¼n sonra ayÄ±n 2\'sinde, yeni bir zararlÄ± yazÄ±lÄ±m tespiti yok ancak mevcut zararlÄ± yazÄ±lÄ±m aktifse alan "2" deÄeri ile iletilecektir. SÃ¼reler artarak 21 gÃ¼ne kadar TR.OHVPS.DataCode.ZmnAralik deÄerlerine gÃ¶re iletilecektir.Son 21 gÃ¼n iÃ§inde yeni bir tespit yoksa ayÄ±n 22\'sinden itibaren ilgili alan  "0" deÄeri ile beslenecektir. Not: ZararlÄ± yazÄ±lÄ±m, bankacÄ±lÄ±k iÅlemlerinin yapÄ±ldÄ±ÄÄ± uygulamalara giriÅte kullanÄ±lan bilgilerin (Åifre, kullanÄ±cÄ± kodu gibi) ele geÃ§irilmesi amacÄ±yla kullanÄ±lan bir uygulama ya da kod parÃ§acÄ±ÄÄ± olabilir. Bu amaÃ§lar dÄ±ÅÄ±nda kullanÄ±lan (bankacÄ±lÄ±Äa yÃ¶nelik bir zararlÄ± yazÄ±lÄ±m olmayan) yazÄ±lÄ±m tespitleri iletilmemelidir. YÃS kanallarÄ±na her bir loginde, kullanÄ±lan cihazda bir zararlÄ± yazÄ±lÄ±m var mÄ± yok mu kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.   GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   AnomallyFlag  : DiÄer ÅÃ¼pheli durumlarÄ±n varlÄ±ÄÄ±nÄ± ifade eden deÄer. GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.VarYok sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   UnsafeAccountFlag : HHS tarafÄ±ndan aktarÄ±lan bilgi ile son 21 gÃ¼n iÃ§inde ÃHK\'nÄ±n dolandÄ±rÄ±cÄ±lÄ±k maÄduru olmasÄ± durumunu ifade eden deÄer. ÃrneÄin; HHS 1, ayÄ±n 1\'inde sÃ¼phe veya sahtekarlÄ±k nedeniyle bir Ã¶deme iÅlemine izin vermediÄi durumda, bu bilgiyi rÄ±za iptal detay kodu ile YÃS\'e aktarmÄ±Å olur. Bu bilgiyi tutan YÃS, ilgili mÃ¼Återinin 15 dakika sonra HHS 2\'de yaptÄ±ÄÄ± iÅlem iÃ§in ilgili alanÄ± "1" deÄeri ile besler. BÃ¶ylece HHS 2, ÃHK\'nÄ±n farklÄ± bir HHS\'de son 15 dakika iÃ§inde ÅÃ¼pheli veya sahte bir iÅlemi olduÄunu anlayabilecektir. AyÄ±n 22\'sinde yeni bir tespit/kayÄ±t yoksa bu alan YÃS tarafÄ±ndan "0" olarak beslenecektir. GÃ¶nderilmesi Opsiyonel alandÄ±r.TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.     Flaglar JWT claims iÃ§ine key value Åeklinde eklenerek gÃ¶nderilecektir. EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±\'nda belirtilen yÃ¶ntemle imzalanarak oluÅturulan JWT PSU-Fraud-Check alanÄ±na konularak YÃS\'ler tarafÄ±ndan HHS\'ye iletilmelidir. \n K \n K \n Z \n \n \n PSU-Initiated \n AN1 \n Ä°Ålemin ÃHK tarafÄ±ndan baÅlatÄ±lmasÄ± durumunda E , sistem tarafÄ±ndan baÅlatÄ±ldÄ±ÄÄ± durumda H deÄerini almasÄ± beklenir.   Ä°Ålemler servisinde yapÄ±lacak sistemsel sorgulardaki iÅlem limitlerini kontrol amacÄ±yla kullanÄ±lÄ±r. \n Z \n Z \n Z \n \n \n PSU-Session-ID \n AN1..100 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen oturuma Ã¶zgÃ¼ talep kimliÄi. ÃHK\'nÄ±n YÃS uygulamasÄ± Ã¼zerinden kimlik doÄrulama mekanizmasÄ± ile bilgi sistemlerine dÃ¢hil olmalarÄ±ndan iÅlemlerini tamamlayÄ±p sistemden ayrÄ±lmalarÄ±na kadar geÃ§ecek tÃ¼m sÃ¼re

16ci kapsayacak Åekilde aynÄ± deÄeri almalÄ±dÄ±r. Tek seferlik Ã¶deme gibi ÃHKânÄ±n tanÄ±nmadan baÅlatÄ±ldÄ±ÄÄ± iÅlemlerde bu deÄer boÅ olarak iletilmelidir. \n Ä° \n Ä° \n Ä° \n \n \n Authorization \n AN1..4096 \n YÃS ile BKM API Gateway arasÄ±ndaki otorizasyon iÃ§in kullanÄ±lan token bilgisidir.  Yekilendirme tÃ¼rlerinden Ä°stemci Kimlik Bilgileriâni adresler. \n Z \n Z \n Z \n \n \n X-Access-Token \n AN1..4096 \n ÃHKânÄ±n GKD sÃ¼recinde doÄrulanmasÄ± sonrasÄ±nda kullanÄ±lan eriÅim simgesi. Yetkilendirme tÃ¼rlerinden Yetkilendirme Kodu (GKD)ânu adresler. \n Ä° \n Ä° \n Ä° \n \n \n X-JWS-Signature \n AN1..4096 \n Payload gÃ¶vdesinin ayrÄ±lmÄ±Å bir JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi.  Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir. \n K (KullanÄ±lan API ve methoda gÃ¶re kullanÄ±lÄ±r.) \n K \n K \n 3.16. YanÄ±t BaÅlÄ±ÄÄ± \n \n "BaÅlÄ±k isimleri" yorumlanÄ±rken kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin "x-ReQuEsT-Id" geÃ§erli bir baÅlÄ±k ismidir. \n "BaÅlÄ±k deÄerleri" yorumlanÄ±rken ise kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harf duyarlÄ±lÄ±ÄÄ± olmalÄ±dÄ±r. ÃrneÄin "xyz123" ile "XYZ123" deÄerleri farklÄ±dÄ±r. \n BaÅlÄ±k deÄerlerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r. ÃrneÄin "Link" deÄerinde "Ä°OS12" yazmak, bÃ¼yÃ¼k "Ä°" harfinin ISO-8859-1 iÃ§erisinde yer almamasÄ±ndan dolayÄ±, hataya yol aÃ§acaktÄ±r. \n \n Tablo 3: YanÄ±t BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n KullanÄ±m Durumu \n \n \n \n \n X-Request-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±    Ä°lgili istek baÅlÄ±ÄÄ±ndaki bilgi geri dÃ¶nÃ¼lÃ¼r. \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±. Ä°lgili istek baÅlÄ±ÄÄ±ndaki bu deÄer geri dÃ¶nÃ¼lÃ¼r. \n Z \n \n \n X-ASPSP-Code \n AN4 \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n \n \n X-TPP-Code \n AN4 \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder:  application/json \n Z \n \n \n X-JWS-Signature \n AN1..4096 \n JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n hangi yanÄ±tlar iÃ§in kullanÄ±lmasÄ± gerektiÄi ilgili endpoint iÃ§in belirtilmiÅtir.  Hata durumlarÄ±nda, yanÄ±t gÃ¶vdesi deÄeri dÃ¶nÃ¼lÃ¼yor ise imzalanmalÄ± ve imza bilgisi x-jws-signature alanÄ±nda iletilmelidir.  Ancak uygulama katmanÄ± tarafÄ±ndan yakalanamayan dolayÄ±sÄ± ile imzalanamayan hata durumlarÄ±nda x-jws-signature alanÄ± HHS\'ler tarafÄ±ndan boÅ gÃ¶nderilebilir. \n K \n \n \n X-RateLimit-Limit \n N 1..18 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde en fazla kaÃ§ adet istek yapÄ±labileceÄini gÃ¶sterir. KÄ±sÄ±t uygulanan servislerde bu baÅlÄ±ÄÄ±n dÃ¶nmesi zorunludur. \n K \n \n \n X-RateLimit-Remaining \n N 1..18 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde k

16aÃ§ adet istek hakkÄ± kaldÄ±ÄÄ±nÄ± gÃ¶sterir. KÄ±sÄ±t uygulanan servislerde bu baÅlÄ±ÄÄ±n dÃ¶nmesi zorunludur. \n K \n \n \n X-RateLimit-Reset \n AN 1..255 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde Ã§aÄrÄ±m hakkÄ± bittikten sonra yeniden denemeden Ã¶nce beklemesi gereken sÃ¼reyi (saniye cinsinden) gÃ¶sterir. HTTP 429 durum kodu (Too Many Requests) ile dÃ¶nÃ¼len yanÄ±tlarÄ±n baÅlÄ±ÄÄ±nda dÃ¶nÃ¼lmesi zorunludur.  YÃS olarak yaptÄ±ÄÄ±nÄ±z sistemsel sorgularda; HTTP 429 durum kodu (Too Many Requests) ile dÃ¶nÃ¼len yanÄ±t aldÄ±ÄÄ±nÄ±zda tekrar sorgu yapmadan Ã¶nce âX-RateLimit-Resetâ yanÄ±t baÅlÄ±ÄÄ±nÄ± kontrol ederek, bu baÅlÄ±ktaki sÃ¼re kadar bekledikten sonra yeniden sorgulama yapÄ±lmasÄ± gerekmektedir. \n K \n \n \n x-total-count \n N 1..18 \n Hesaplar, Ä°Ålemler ve Bakiye servislerinde sayfalama kullanÄ±ldÄ±ÄÄ± durumda, sorgu sonucu dÃ¶necek toplam kayÄ±t sayÄ±sÄ± bilgisi, bu alanda HHS isteÄine baÄlÄ± olarak gÃ¶nderilebilir. \n Ä° \n \n \n Link \n 1..4096 \n âLinkâ alanÄ±nÄ±n Ã§oklu sayfa yapÄ±sÄ± olmasÄ± durumunda gÃ¶nderilmesi zorunludur.  Sayfalama yapÄ±sÄ± kullanÄ±ldÄ±ÄÄ±nda gelen yanÄ±tta birden fazla sayfa var ise; Ã¶nceki, sonraki, ilk, son sayfalara gitmek iÃ§in gerekli referanslar link headerÄ±nda aÅaÄÄ±daki Ã¶rnekteki gibi doldurulabilir.  x-total-count alanÄ±nÄ±n gÃ¶nderimi isteÄe baÄlÄ± olduÄu iÃ§in; Link iÃ§erisindeki son sayfa bilgisi  (last) isteÄe baÄlÄ± hale getirilmiÅtir. âÃncekiâ( prev) ve âSonrakiâ (next) adÄ±mlarÄ±nÄ±n uygun olan her durumda yer almasÄ± zorunludur. Ä°lk sayfada âÃncekiâ seÃ§eneÄi olmamalÄ±, son sayfada ise âSonrakiâ seÃ§eneÄi olmamalÄ±dÄ±r.    </ohvps/hbh/s1.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=6&syfKytSayi=100>; rel="next",  </ohvps/hbh/s1.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=4&syfKytSayi=100>; rel="prev",  </ohvps/hbh/s1.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=14&syfKytSayi=100>; rel="last",  </ohvps/hbh/s1.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=0&syfKytSayi=100>; rel="first" \n K \n 3.17. Idempotency KurallarÄ± \n YÃSâÃ¼n aÅaÄÄ±daki durumlarda aynÄ± istek numarasÄ± (x-request-id) ve aynÄ± veri gÃ¶vdesiyle Ã§aÄrÄ±yÄ± tekrarlamasÄ±; HHSânin de bu durumlarda aynÄ± yanÄ±tÄ± dÃ¶nmesi gereklidir. \n \n HHSânin yanÄ±tÄ± kesinti/arÄ±za nedeniyle YÃSâe ulaÅmaz ve zaman aÅÄ±mÄ± sÃ¶z konusu olmasÄ±, \n ÃHK, YÃS uygulamasÄ± Ã¼zerinden Ã§ift tÄ±klama ile mÃ¼kerrer defa HHS APIâlerini Ã§aÄÄ±rÄ±lmasÄ±,\n(API kontrollerinden Ã¶nce YÃS uygulamasÄ±nÄ±n, Ã§ift tÄ±klama kontrolÃ¼ yapmasÄ± Ã¶nerilmektedir.) \n YÃS, yanÄ±t almasÄ±na raÄmen iÅleyemeden kaybedilmesi, \n \n durumlarÄ±nda HHS aÅaÄÄ±daki kurallarÄ± iÅletir: \n \n HHS gelen istek numarasÄ±nÄ± ve veri gÃ¶vdesini birleÅtirerek checksum deÄeri Ã¼retir. \nchesksum deÄeri x-request-id|request.body ânin hash algoritmalarÄ±ndan (CRC32,MD5 vb)  geÃ§irilerek Ã¼retilebilir. \n HHS bu checksum deÄeri ile YÃSâe dÃ¶nmÃ¼Å olduÄu yanÄ±tÄ± 5 dk boyunca saklar.  Saklama yÃ¶ntemi olarak veri tabanÄ± veya Ã¶nbellek araÃ§larÄ± kullanÄ±labilir. \n YÃS aynÄ± istek numarasÄ± ve aynÄ± veri gÃ¶vdesi ile yeni bir Ã§aÄrÄ± yaptÄ±ÄÄ±nda, aynÄ± checksum deÄeri Ã¼retileceÄi iÃ§in 5dk boyunca bu deÄere karÅÄ±lÄ±k gelen yanÄ±tÄ± dÃ¶ner. \n 5 dk sonrasÄ±nda istek numarasÄ± veya veri gÃ¶vdesi deÄiÅmemiÅ olsa dahi bu HHS tarafÄ±ndan yeni istek olarak kabul edilir. \n \n AÅaÄÄ±daki Public Post iÅlemleri iÃ§in bu kural setinin iÅletilmesi gerekmektedir: \n 1- Ãdeme emri rÄ±zasÄ± oluÅturma \n2- EriÅim belirteci oluÅturma \n3- Ãdeme emri \n4- Hesap bilgisi rÄ±zasÄ± oluÅturma \n 3.18. HTTP Durum KodlarÄ± \n RFC 2616\'da belirlenmiÅ olan durum ko

16dlarÄ± (status code) gÃ¶nderilen isteÄin durumunu YÃSâa standart bir Åekilde ifade eder. EÄer bir hata varsa hatayÄ±, gÃ¶nderilen istek baÅarÄ±lÄ± bir Åekilde iÅlem gÃ¶rdÃ¼yse ona iliÅkin durumu aktarÄ±r. Durum kodlarÄ± genel olarak 5 kategoridedir. \n \n 1xx Bilgi \n 2xx BaÅarÄ±lÄ± \n 3xx YÃ¶nlendirme \n 4xx Ä°stemci HatasÄ± \n 5xx Sunucu HatasÄ± \n \n errorCode AlanÄ±nda KullanÄ±labilecek SÄ±ralÄ± Hata Tipleri : \n \n TR.OHVPS.Resource \n \n â¨\tInvalidFormat \n â¨\tConsentMismatch \n â¨\tNotFound \n â¨\tInvalidSignature \n â¨\tMissingSignature \n â¨\tMethodNotAllowed \n â¨\tNotAcceptable \n â¨\tUnsupportedMediaType \n â¨\tConsentRevoked \n \n \n \n TR.OHVPS.Business \n \n â¨\tInvalidContent \n â¨\tInvalidAccount \n \n \n \n TR.OHVPS.Connection \n \n â¨\tInvalidCertificate \n â¨\tExceededRate \n â¨\tInvalidTPP \n â¨\tInvalidASPSP \n â¨\tInvalidToken \n â¨\tInvalidTPPRole \n \n \n \n TR.OHVPS.Server \n \n â¨\tInternalError \n â¨\tServiceUnavailable \n \n \n TR.OHVPS.Resource.InvalidFormat hatasÄ± alÄ±ndÄ±ÄÄ± durumda; fieldErrors nesnesi iÃ§erisinde verilecek hata kodlarÄ± : \n \n TR.OHVPS.Field \n \n â¨\tMissing \n â¨\tInvalid \n \n \n Veri Tipi ÃrneÄi: \n { \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n     "id" :   "d8bd4e5f-f094-48a6-aee1-3a800e2709d9" , \n     "timestamp" :   "2022-12-22T10:33:15+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "fieldErrors" :   [ \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.islTtr.prBrm" , \n             "messageTr" :   "boÅ deÄer olamaz" , \n             "message" :   "must not be null" , \n             "code" :   "TR.OHVPS.Field.Missing" \n         } , \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.kmlk.kmlkVrs" , \n             "messageTr" :   "boyut \'1\' ile \'30\' arasÄ±nda olmalÄ±" , \n             "message" :   "size must be between 1 and 30" , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } \n     ] , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" \n }  \n \n Tablo 4: HTTP Durum KodlarÄ± \n \n \n \n HTTP Durum \n Ä°stek Sonucu ve AÃ§Ä±klamalar \n POST \n GET \n DELETE \n \n \n \n \n 200 OK \n Ä°stek BaÅarÄ±yla TamamlandÄ±. Kaynak gÃ¼ncellemek iÃ§in yapÄ±lan (Ã¶rneÄin, GET) ve baÅarÄ±yla tamamlanan isteklerinde kullanÄ±lÄ±r. \n H \n E \n H \n \n \n 201 Created \n Ä°stek BaÅarÄ±lÄ± Oldu. Kaynak yaratma isteÄi (Ã¶rneÄin, POST /Ã¶deme-emri-rizasi) baÅarÄ±yla sonuÃ§landÄ±. \n E \n H \n H \n \n \n 204 No Content \n Silme iÅlemi baÅarÄ±yla tamamlandÄ±. Kaynak silme isteÄi (Ã¶rneÄin,  DELETE /hesap-rizasi/{RizaNo} ) baÅarÄ±yla sonuÃ§landÄ±. \n H \n H \n E \n \n \n 400 Bad Request \n Ä°stekte bozuk, eksik veya uyumlu olmayan JSON gÃ¶vdesi, URL parametreleri veya baÅlÄ±k alanlarÄ± var.  Ä°stekle baÅlatÄ±lan iÅlem yapÄ±sal bozukluk, eksik veya tutarsÄ±z veri veya HHS tarafÄ±ndaki kontrollerin hatalÄ± sonuÃ§lanmasÄ± nedeniyle hata ile sonuÃ§lanÄ±r ve hataya iliÅkin veriler hata nesnesi iÃ§erisinde dÃ¶nÃ¼lÃ¼r. \n E \n E \n E \n \n \n 401 Unauthorized \n Yetkilendirme baÅlÄ±ÄÄ± eksik, hatalÄ± veya geÃ§ersiz olduÄundan istek yetkilendirilmediÄinde ve eriÅim reddedildiÄinde http 401 kodu dÃ¶nÃ¼lmelidir. \n E \n E \n E \n \n \n 403 Forbidden \n EriÅim belirtecinin veya rÄ±zanÄ±n kapsamÄ± uyuÅmuyor. YÃS bir hesaba/iÅlem kaynaÄÄ±na eriÅmeye Ã§alÄ±ÅÄ±r ve YÃS, istenen kaynaÄa eriÅmek iÃ§in geÃ§erli izinlere sahip bir rÄ±zasÄ± yoktur.  ÃrneÄin; hesap bilgisi rÄ±zasÄ± bakiye izni almamÄ±ÅtÄ±r ancak /bakiyeler adresinden istekte bulunmuÅtur. \n \n \n \n \n \n 404 Not Found \n **HHS geÃ§erli bir API eriÅim adresini saÄlamÄ±yorsa, o URL\'ye gelen istekler iÃ§in 404 (BulunamadÄ±) ile yanÄ±t vermelidir.**YÃS, uygulama esaslarÄ±nda tanÄ±mlanmayan bir

16kaynak iÃ§in bir URL\'ye eriÅmeye Ã§alÄ±ÅÄ±rsa (Ã¶rneÄin, GET /yurtdisi-odeme), HHS, 404 (BulunamadÄ±) ile yanÄ±t vermeyi seÃ§ebilir. \n E \n E \n E \n \n \n 405 Method Not Allowed \n YÃS, desteklenmeyen bir yÃ¶ntemle kaynaÄa eriÅmeye Ã§alÄ±ÅtÄ±. \n E \n E \n E \n \n \n 406 Not Acceptable \n Ä°stek, geÃ§ersiz bir karakter kÃ¼mesi iÃ§eriyor. \n E \n E \n E \n \n \n 415 Unsupported Media Type \n Ä°stek gÃ¶vdesi hedef kaynakta bu yÃ¶ntem tarafÄ±ndan desteklenmeyen bir biÃ§imde oluÅturulduÄu iÃ§in iÅlem reddedildi \n E \n H \n H \n \n \n 429 Too Many Requests \n Belirli bir sÃ¼re iÃ§inde Ã§ok fazla talepte bulunulduÄu iÃ§in iÅlem reddedildi.  HHSâler adil kullanÄ±m politikalarÄ±nÄ± aÅan talepleri kÄ±sÄ±tlayabilir. \n E \n E \n E \n \n \n 500 Internal Server Error \n API sunucu / servis katmanÄ±nda sorun oluÅtu. Ä°Ålem baÅarÄ±sÄ±z.  5XX hata durumlarÄ±nda yanÄ±t gÃ¶vde deÄeri olmadÄ±ÄÄ± iÃ§in mesaj imzalama yapÄ±lamaz ve x-jws-signature alanÄ± boÅ olarak iletilir.  Bu durumda x-jws-signature kontrolÃ¼ yapÄ±lmamalÄ±dÄ±r. \n E \n E \n E \n \n \n 503 Service Unavailable \n Hizmet sÃ¼rÃ¼mÃ¼ kullanÄ±mdan kaldÄ±rÄ±ldÄ±.  Bir API\'nin kullanÄ±mdan kaldÄ±rÄ±ldÄ±ÄÄ± ve artÄ±k bir HHS tarafÄ±ndan operasyonel olarak desteklenmediÄi durumlarda, URI yolu hala etkin olabilir ve API isteklerini kabul edebilir.  Bu durumda, YÃS\'Ã¼n API sÃ¼rÃ¼mÃ¼nÃ¼n Ã§evrimdÄ±ÅÄ± olduÄunun farkÄ±nda olmasÄ± iÃ§in 503 Hizmet KullanÄ±lamÄ±yor dÃ¶nmesi Ã¶nerilir. \n E \n E \n E \n \n \n \n Hata Ãrnekleri: \n 400 Bad Request \n TR.OHVPS.Business.InvalidContent  hatasÄ± HHS tarafÄ±ndan yapÄ±lacak iÅ kuralÄ± kontrollerinin baÅarÄ±sÄ±z olduÄu durumda verilmelidir. \n TR.OHVPS.Resource.InvalidFormat  hatasÄ± Åema validasyonu, alan uzunluk ve varlÄ±k kontrollerinin baÅarÄ±sÄ±z olduÄu durumda verilmelidir. \n \n { \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n     "id" :   "7f115b9c-d7c2-4a2a-bc45-5a9891c79072" , \n     "timestamp" :   "2022-12-22T10:47:57+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "fieldErrors" :   [ \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.alc.unv" , \n             "messageTr" :   "boyut \'3\' ile \'140\' arasÄ±nda olmalÄ±" , \n             "message" :   "size must be between 3 and 140" , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } , \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.islTtr.ttr" , \n             "messageTr" :   "boÅ deÄer olamaz" , \n             "message" :   "must not be null" , \n             "code" :   "TR.OHVPS.Field.Missing" \n         } \n     ] , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" \n }  \n\n \n Zorunlu header alanlarÄ±ndan biri ya da birkaÃ§Ä± eksik olarak gÃ¶nderilirse aÅaÄÄ±daki gibi bir hata dÃ¶nÃ¼ÅÃ¼ gerÃ§ekleÅebilir. \n HHS uygulamasÄ± tarafÄ±ndan dÃ¶nÃ¼lebilecek hata Ã¶rnekleri: \n \n { \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n     "id" :   "2005515d-f0e6-4a07-a439-0ef3b0f56011" , \n     "timestamp" :   "2022-12-22T10:39:26+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" , \n     "fieldErrors" :   [ \n         {          \n             "field" :   "X-Request-ID" , \n             "messageTr" :   "X-Request-ID deÄeri boÅ olamaz." , \n             "message" :   "X-Request-ID cannot be null." , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } \n     ] \n }  \n\n \n Business hata Ã¶rneÄi - 1: \n { \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n     "id" :   "677cfd9d-77c1-4ea3-8bdf-74a6e9887177" , \n     "timestamp" :   "2022-12-22T11:05:59+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "gonUnvan wrong" , \n     "moreInformationTr" :   "GÃ¶nderen Ãnvan hatalÄ±" , \n     "errorCode" :   "TR.OHVPS.Business.InvalidContent" \n }  \n \n Business hata Ã¶rneÄi - 2: \n { \n     "path" :   "/ohvps/obh/s1.0/o

16deme-emri-rizasi" , \n     "id" :   "5df3b402-3aca-4305-a35b-5af0f3184b40" , \n     "timestamp" :   "2022-12-22T11:06:47+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Sender account is disabled or not found." , \n     "moreInformationTr" :   "Gonderen hesap aktif deÄil veya bulunamadÄ±." , \n     "errorCode" :   "TR.OHVPS.Business.InvalidAccount" \n }  \n \n BKM API GeÃ§idi\'nde yapÄ±lan zorunlu header kontrollerinde aÅaÄÄ±daki hatalar dÃ¶nebilir: \n \n { \n     "timestamp" :   "2022-12-22T10:40:28+03:00" , \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n     "id" :   "d4375748-6fc7-4f7e-94f3-6411cab1d59f" , \n     "moreInformationTr" :   "GeÃ§ersiz HHS kodu." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidASPSP" , \n     "moreInformation" :   "Invalid ASPSP Code" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" \n }  \n \n BKM API GeÃ§idi tarafÄ±ndan dÃ¶nÃ¼lecek hata Ã¶rneÄi: \n \n { \n     "timestamp" :   "2022-12-22T10:40:28+03:00" , \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n     "id" :   "d4375748-6fc7-4f7e-94f3-6411cab1d59f" , \n     "moreInformationTr" :   "GeÃ§ersiz HHS kodu." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidTPP" , \n     "moreInformation" :   "Invalid TPP Code" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" \n }  \n \n BKM API GeÃ§idi tarafÄ±ndan dÃ¶nÃ¼lecek hata Ã¶rneÄi: \n \n { \n     "timestamp" :   "2022-12-22T11:14:05+03:00" , \n     "path" :   "/ohvps/hbh/s1.0/hesap-bilgisi-rizasi" , \n     "id" :   "ee1e3ea7-a5e5-468b-bb02-314148f84e6a" , \n     "moreInformationTr" :   "GeÃ§ersiz yÃ¶s rolÃ¼. Ä°lgili api Ã§aÄrÄ±sÄ± iÃ§in yetkisi yok." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidTPPRole" , \n     "moreInformation" :   "Invalid TPP Role" , \n     "httpCode" :   403 , \n     "httpMessage" :   "Forbidden" \n }  \n\n \n 401 Unauthorized \n YÃS, sÃ¼resi dolmuÅ bir eriÅim belirteci kullandÄ±ÄÄ±nda, HHS 401 (Yetkisiz) http kodu ile aÅaÄÄ±daki hata kodunu dÃ¶nmelidir.  AÅaÄÄ±daki nedenlerden herhangi biri nedeniyle bir EriÅim Belirtecinin sÃ¼resi dolduÄunda bu durum ortaya Ã§Ä±kabilir: \n \n RÄ±zanÄ±n sÃ¼resi doldu (Son Kullanma Tarihi geÃ§ti) \n EriÅim Belirtecinin ÅÃ¼pheli kullanÄ±mÄ± veya sahtekarlÄ±k ÅÃ¼phesi \n RÄ±zada belirlenen gÃ¼n sayÄ±sÄ±nÄ±n aÅÄ±mÄ±\nBu hata, mÃ¼Återiden doÄru izinlerle yeniden kimlik doÄrulamasÄ± isteyerek Ã§Ã¶zÃ¼lebilir. \n \n \n { \n     "path" :   "/ohvps/gkd/s1.0/erisim-belirteci" , \n     "id" :   "ed3fd667-fc58-40ad-a982-e8937faccd15" , \n     "timestamp" :   "2022-12-22T11:17:33+03:00" , \n     "httpCode" :   401 , \n     "httpMessage" :   "Unauthorized" , \n     "moreInformation" :   "Refresh token expired or not found in database" , \n     "moreInformationTr" :   "Yenileme belirteci zaman aÅÄ±mÄ±na uÄramÄ±Å veya veri tabanÄ±nda yok" , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidToken" \n }  \n \n\n \n 403 Forbidden \n Ãrn; YÃS yetkisi olmayan rol(ÃBH/HBH) ile iÅlem yapmaya Ã§alÄ±ÅtÄ±ÄÄ± durumda 403 hatasÄ± alarak iÅleme devam edemez. \n { \n   "path" :   "/ohvps/hbh/s1.0/bakiye" , \n   "id" :   "3e48ea98-f889-48b9-aa6e-28aabc6cfb14" , \n   "timestamp" :   "2022-12-22T11:20:05+03:00" , \n   "httpCode" :   403 , \n   "httpMessage" :   "Forbidden" , \n   "moreInformation" :   "Forbidden" , \n   "moreInformationTr" :   "Bakiye Bilgileri iÃ§in ÃHK izni bulunmamaktadÄ±r." , \n   "errorCode" :   "TR.OHVPS.Resource.Forbidden" \n }  \n \n 404 Not Found \n Ãrn; GET /odeme-emri-rizasi/123456 Ã§aÄrÄ±sÄ± durumunda 123456 geÃ§erli bir Ã¶deme kaynaÄÄ± deÄilse, HHS, 404 koduyla cevap vermelidir. \n { \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi/123456" , \n     "id" :   "22f52b2d-d442-4a6a-8f39-d23eba45a34b" , \n     "timestamp" :   "2022-12-22T10:53:53+03:00" , \n     "httpCode" :   404 , \n     "httpMessage" :   "Not Found" , \n     "moreInformation" :   "Resource not found" , \n     "errorCode" :   "TR.OHVPS.Resource.NotFound" , \n     "moreInformationTr" :   "Kaynak bulunamadÄ±" \n }  \n\n \n 405 Method Not Allowed \n { \n     "path" :   "/ohvps/obh/s1.0/o

16deme-emri-rizasi" , \n     "id" :   "3e5c6b28-7ee4-4469-b541-843fb4a94eec" , \n     "timestamp" :   "2022-12-22T11:35:10+03:00" , \n     "httpCode" :   405 , \n     "httpMessage" :   "Method Not Allowed" , \n     "moreInformation" :   "Method not allowed" , \n     "errorCode" :   "TR.OHVPS.Resource.MethodNotAllowed" , \n     "moreInformationTr" :   "Ä°stek yapÄ±lan URL iÃ§in izin verilmeyen metot" \n }  \n \n 406 Not Acceptable \n { \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n     "id" :   "3e5c6b28-7ee4-4469-b541-843fb4a94eec" , \n     "timestamp" :   "2022-12-22T11:35:10+03:00" , \n     "httpCode" :   406 , \n     "httpMessage" :   "Not Acceptable" , \n     "moreInformation" :   "Not Acceptable" , \n     "errorCode" :   "TR.OHVPS.Resource.NotAcceptable" , \n     "moreInformationTr" :   "Kabul edilmedi" \n }  \n \n 415 Unsupported Media Type \n Ä°stek baÅlÄ±ÄÄ±nda content-type, JSON dÄ±ÅÄ±nda bir veri iletilirse bu hata verilebilir. \n \n { \n     "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n     "id" :   "63cc94b6-1b51-4648-9671-95e6e2e7e03d" , \n     "timestamp" :   "2022-12-22T11:37:12+03:00" , \n     "httpCode" :   415 , \n     "httpMessage" :   "Unsupported Media Type" , \n     "moreInformation" :   "Content type not supported" , \n     "errorCode" :   "TR.OHVPS.Resource.UnsupportedMediaType" , \n     "moreInformationTr" :   "Desteklenmeyen iÃ§erik tipiâ" \n }  \n \n 429 Too Many Requests \n { \n   "path" :   "/ohvps/hbh/s1.0/hesaplar/aef6061f-2978-4bb4-980d-b4c634c8055b/islemler" , \n   "id" :   "20473c5f-2f4f-4b2e-8b66-7978aec442f7" , \n   "timestamp" :   "2022-12-22T00:21:07+03:00" , \n   "httpCode" :   429 , \n   "httpMessage" :   "Too Many Requests" , \n   "moreInformation" :   "Exceeded rate" , \n   "moreInformationTr" :   "EriÅim sÄ±klÄ±ÄÄ± limiti aÅÄ±mÄ±" , \n   "errorCode" :   "TR.OHVPS.Connection.ExceededRate" \n }  \n \n 500 Internal Server Error \n { \n   "id" :   "1b90c6dc-0277-4755-8b05-9297ddfab743" , \n   "path" :   "/ohvps/obh/s1.0/odeme-emri-rizasi" , \n   "timestamp" :   "2022-12-22T11:41:34+03:00" , \n   "httpCode" :   500 , \n   "httpMessage" :   "Internal Server Error" , \n   "moreInformation" :   "Unexpected condition was encountered." , \n   "moreInformationTr" :   "Beklenmeyen bir durumla karÅÄ±laÅÄ±ldÄ±." , \n   "errorCode" :   "TR.OHVPS.Server.InternalError" \n }  \n\n \n 503 Service Unavailable \n \n   "timestamp" :   "2022-12-20T23:18:56+03:00" , \n   "path" :   "/ohvps/hbh/s1.0/hesap-bilgisi-rizasi/2a72678ee3d24de2be47887e4903a8c6" , \n   "id" :   "e76315b7-09f4-4295-b6d8-1f7fec632159" , \n   "moreInformationTr" :   "HHS Åu anda hizmet veremiyor." , \n   "errorCode" :   "TR.OHVPS.Server.ServiceUnavailable" , \n   "moreInformation" :   "HHS is currently unavailable" , \n   "httpCode" :   503 , \n   "httpMessage" :   "Service Unavailable" \n 3.19. Maskeleme KurallarÄ± \n Maskeli olarak iletilmesi gereken verilerin maskeleme kurallarÄ± Åu Åekildedir: \n \n IBAN verileri Hesap NumarasÄ± : Ä°lk 4 ve son 4 karakteri aÃ§Ä±k, diÄer karakterler maskeli olmalÄ±dÄ±r. Ãrnek: TR54******************4812 \n Ad-SoyadÄ± / Ticari Unvan : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet â â karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r.\nÃrneÄin: âFATÄ°H SERKAN ERENâ ifadesi âFA *** SE**** ER****â Åeklinde gÃ¶sterilmelidir. \n Tabela UnvanÄ± : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet â â karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r. ÃrneÄin âBANKALARARASI KART MERKEZÄ° ANONÄ°M ÅÄ°RKETÄ°â ifadesi âBA *** KA**

16** ME**** AN**** ÅÄ°****â Åeklinde gÃ¶sterilmelidir. \n YÃSâten girilen unvan ve iban bilgileri Ã¶deme emri rÄ±zasÄ± ve Ã¶deme emri yanÄ±tÄ±nda aÃ§Ä±k dÃ¶nÃ¼lÃ¼r, Kolas akÄ±ÅÄ±nda Ã¶deme emri rÄ±zasÄ± yanÄ±tÄ± ve Ã¶deme emri istek ve yanÄ±tÄ±nda maskeli taÅÄ±nÄ±r. \n 3.20. Fonksiyonel Olmayan Gereksinimler \n \n \n HHSâlerin sunuyor olduklarÄ± servisleri en fazla 3000 ms iÃ§inde yanÄ±t dÃ¶necek Åekilde tasarlamalÄ±dÄ±r. \n \n \n HHS\'ler mevcut online iÅlem kanallarÄ±ndan sunduklarÄ± eriÅilebilirlik ve performans kriterlerinden daha dÃ¼ÅÃ¼k bir hizmet kalitesi sunmamalÄ±dÄ±r. \n \n \n HHSâlerin sunuyor olduklarÄ± servislere sistemin gÃ¼venlik ve sÃ¼rekliliÄini saÄlamak adÄ±na rate limit koyma ihtiyaÃ§larÄ± olur ise, standartlar ve ihtiyaÃ§lara uygun Åekilde bir konfigÃ¼rasyon yapabilirler.  \n \n \n HHS rate limit tanÄ±mÄ± uyguluyor ise; YÃS\'ler arasÄ±nda ayrÄ±m yapmadan, adil ve makul sÄ±nÄ±rlar dahilinde uygulamalÄ±dÄ±r.    \n \n \n YÃS tarafÄ±ndan kullanÄ±cÄ±nÄ±n baÅlatmadÄ±ÄÄ± otomatik sorgu limitleri  3.21 Otomatik Sorgular  bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. HHS\'lerin bu servisler iÃ§in minimumda cevap vermesi gereken sorgu sayÄ±larÄ± belirlenmiÅtir. Bu sayÄ±larÄ±n Ã¼zerinde yapÄ±lan servis Ã§aÄrÄ±sÄ±na yanÄ±t dÃ¶nmek HHS inisiyatifindedir. DiÄer taraftan kullanÄ±cÄ±nÄ±n baÅlattÄ±ÄÄ± istekler iÃ§in uygulanacak limitler, HHS\'nin online iÅlem kanallarÄ±ndan sunulan sorgu limitlerinden daha az olmamalÄ±dÄ±r. \n \n \n HHS\'ler, Ã§aÄrÄ±m limitlerini aÅan istekler iÃ§in HTTP 429 - Too Many Request hatasÄ±nÄ± dÃ¶nmelidir. Ãrnek hata mesajÄ±  3.18 HTTP Durum KodlarÄ±  bÃ¶lÃ¼mÃ¼nde bulunmaktadÄ±r. Rate Limit Ã¶zelinde tanÄ±mlanmÄ±Å parametreler olan X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset alanlarÄ± da   3.16 YanÄ±t BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanmÄ±ÅtÄ±r. YÃS\'ler de HHS\'nin belirlediÄi rate limit kurallarÄ±na uymakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n \n \n HHSâler aynÄ± zamanda servislerin ayakta olup olmadÄ±ÄÄ±na yÃ¶nelik olarak bir healthcheck servisi kurmalÄ±dÄ±r.  HHSâlerin bu servis ile tÃ¼m network ve veritabanÄ± ya da servislerinin ihtiyaÃ§ duyduklarÄ± altyapÄ±sal eriÅimleri modellemeli ve bu servisi BKM ile paylaÅmalarÄ± beklenmektedir. Bu servis dÃ¼zenli olarak BKM tarafÄ±ndan Ã§aÄÄ±rÄ±larak servislerin ayakta olup olmadÄ±klarÄ±nÄ±n kontrolÃ¼nÃ¼n saÄlanmasÄ± planlanmaktadÄ±r. \n \n \n Sunulan her API iÃ§in /health endpointi ile aÅaÄÄ±daki bilgileri vermeleri beklenmektedir. \n GET /{api ismi}/{versiyon}/health \n Ãrnek: \n GET /obh/s1.0/health \n GET /hbh/s1.0/health \n GET /gkd/s1.0/health \n HHS ve YÃS API iÃ§in health servisleri aÅaÄÄ±daki servislerle kontrol edilebilir. \n GET /hhs-api/s1.0/health \n GET /yos-api/s1.0/health \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lmelidir. \nBaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n KoÅullu  / Ä°steÄe BaÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir. \n \n \n \n Health servisinden yanÄ±t alÄ±namamasÄ±, hata almasÄ± ya da status DOWN gelmesi durumunda API Gatewayden istek HHS tarafÄ±na iletilmeyecektir. \n \n \n ÃHVPS servisleri ile ilgili olarak HHSâler, BKM tarafÄ±ndan dÃ¼zenli olarak sorgulanacaktÄ±r, eriÅilebilirlik ve kullanÄ±m oranlarÄ± takip edilecektir. \n \n \n HHSâlerin servislerini eriÅim yÃ¼zdeleri aÃ§Ä±sÄ±ndan yÄ±l bazÄ±nda %99.75 oranÄ±nda ayakta olmalarÄ±nÄ± saÄlayacak Åekilde kurgulamalarÄ± gerekmektedir. \n 3.21. Otomatik Sorgular \n YÃS uygulamasÄ±, ÃHK\'nÄ±n baÅlattÄ±ÄÄ± iÅlemler neticesinde API Ã§aÄrÄ±mÄ± yapabileceÄi gibi, sistemsel bir Åekilde otomatik API Ã§aÄrÄ±mÄ± da yapabilir. \nHHS, API Ã§aÄrÄ±mÄ±nÄ±n ÃHK\'lÄ± ya da ÃHK\'sÄ±z olduÄunu istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n ÃHK YÃS uygulamasÄ±na giriÅ yaptÄ±ÄÄ± andan Ã§Ä±kÄ±Å yaptÄ±ÄÄ± ana kadar yani ÃHK oturumu boyunca yapÄ±lan API Ã§aÄrÄ±mlarÄ±nda, PSU-Initiated  deÄ

16erinin "E" olmasÄ± gerekmektedir.  YÃS uygulamasÄ±nda ÃHK oturumu boyunca,  ÃHK\'nÄ±n bilgilerinden minimumda "bakiye" bilgisinin, uygulama arayÃ¼zlerinde gÃ¼ncel deÄeri ile online sorgularla gÃ¶sterimi YÃS\'Ã¼n insiyatifindedir. \n ÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \n YÃS, aÅaÄÄ±daki API\'leri sistemsel bir Åekilde Ã§aÄÄ±rabilir. \nHHS\'lerin bu servisler iÃ§in minimumda cevap vermesi gereken sorgu sayÄ±larÄ± belirlenmiÅtir. Bu sayÄ±larÄ±n Ã¼zerinde yapÄ±lan servis Ã§aÄrÄ±sÄ±na yanÄ±t dÃ¶nmek HHS inisiyatifindedir. \nHHS tarafÄ±ndan izin verilen sorgu sayÄ±sÄ±nÄ±n Ã¼zerinde yapÄ±lan bir sorgu iÃ§in HTTP 429 durum kodu (Too Many Requests) hatasÄ± dÃ¶nÃ¼lmelidir. YanÄ±t gÃ¶vdesinde tekrar hata nesnesinin oluÅturulmasÄ± HHS inisiyatifindedir.  HHS yanÄ±t headerÄ± alanÄ±nda iletilecek X-RateLimit-Reset (saniye cinsinden) deÄeri kadar sÃ¼re sonunda\nYÃS\'Ã¼n tekrar sorgulama yapmasÄ± beklenmektedir. \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Otomatik Sorgu SayÄ±sÄ± \n \n \n \n \n 1 \n erisim-belirteci \n POST \n /erisim-belirteci \n --- \n \n \n 2 \n odeme-emri-rizasi \n GET \n /odeme-emri-rizasi/{rizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 3 \n odeme-emri \n GET \n /odeme-emri/{odemeEmriNo} \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 4 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 5 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n --- \n \n \n 6 \n hesaplar \n GET \n /hesaplar \n Bireysel gÃ¼nde 4  Kurumsal gÃ¼nde 4 \n \n \n 7 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Bireysel gÃ¼nde 4 Kurumsal gÃ¼nde 4 \n \n \n 8 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 9 \n bakiye \n GET \n /bakiye \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 10 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Bireysel gÃ¼nde 4 Kurumsal ÃHK - saatte 12 \n \n \n \n YÃS ve HHS son 24 saat iÃ§erisindeki sorgu sayÄ±larÄ±nÄ± toplayarak elde ettiÄi sonuÃ§larla limit kontrolÃ¼ yapmalÄ±dÄ±r (Pencere yÃ¶ntemi). \n Ä°Ålemler servisinin Ã§aÄrÄ±m detaylarÄ±na  ^BÃ¶lÃ¼m 7.8  Ã¼zerinden ulaÅÄ±labilir. \n Hesap bilgisi rÄ±zasÄ±nÄ±n YÃS tarafÄ±ndan otomatik bir Åekilde iptal edilmesi durumu  ^BÃ¶lÃ¼m 9 \'da aÃ§Ä±klanmÄ±ÅtÄ±r. \n'},{title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",frontmatter:{},regularPath:"/v1.1.0/contents/ekler.html",relativePath:"v1.1.0/contents/ekler.md",key:"v-cc5a0b86",path:"/v1.1.0/contents/ekler.html",headers:[{level:2,title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",slug:"ek-1-istek-cevap-mesajlarÄ±nda-kullanÄ±lacak-nesne-yapÄ±larÄ±"},{level:2,title:"EK-2: SÄ±ralÄ± Veri TÃ¼rleri",slug:"ek-2-sÄ±ralÄ±-veri-turleri"},{level:2,title:"EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi",slug:"ek-3-istemci-sertifikalarÄ±nÄ±n-tanÄ±m-ve-yonetimi"},{level:2,title:"EK-4: Sunucu SertifikalarÄ±",slug:"ek-4-sunucu-sertifikalarÄ±"},{level:2,title:"EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±",slug:"ek-5-mesaj-imzalama-akÄ±sÄ±"},{level:3,title:"Ä°mzalama KurallarÄ± (YÃS)",slug:"imzalama-kurallarÄ±-yos"},{level:2,title:"EK-6: HHS/YÃS API Mimarisi",slug:"ek-6-hhs-yos-api-mimarisi"}],content:' EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ± \n AÃ§Ä±k BankacÄ±lÄ±k simÃ¼latÃ¶r uygulamasÄ± Ã¼zerinde swagger dÃ¶kÃ¼manlarÄ±nÄ±n gÃ¼ncel sÃ¼rÃ¼mlerine eriÅim saÄlanabilir. \n EK-2: SÄ±ralÄ± Veri TÃ¼rleri \n \n \n \n Kod \n AÃ§Ä±klama \n \n \n \n \n TR.OHVPS.DataCode.BrcAlc \n Ä°Ålemin hesabÄ± borÃ§landÄ±rdÄ±ÄÄ± ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. B : BorÃ§ A : Alacak \n \n \n TR.OHVPS.DataCode.EvetHayir \n E : Evet H : HayÄ±r \n \n \n TR.OHVPS.DataCode.GkdTur \n GKD yapÄ±lmasÄ±nÄ± gerekli bulduÄu durumda HHS, YÃSâÃ¼n belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi GKD yÃ¶ntemini bildirir: Y: YÃ¶nlendirmeli GKD A: AyrÄ±k GKD \n \n \n TR.OHVPS.DataCode.HHSDurumu \n A : AÃ§Ä±k. Ãretim OrtamÄ±nda HHSânin aktif bir Åekilde hizmet vermesi durumu.  Y : YaygÄ±nlaÅtÄ±rma. Ãretim OrtamÄ±nda HHSânin kendisi tarafÄ±ndan tanÄ±mlanmÄ±Å kÄ±sÄ±tlÄ± ÃHKâya hizmet vermesi durumu.    G : GeÃ§ici Hizmet Veremiyor. HHS servislerinde teknik bir sorun olmasÄ± nedeniyle HHSânin hizmet verememesi durumu.  K: KapalÄ±. HHSânin hizmet vermeme durumu. \n \n \n TR.OHVPS.DataCode.HHSYOSSrlmKrtr \n âkodâ : Kod âunvâ : Unvan \n \n \n TR.OHVPS.DataCode.HspDrm \n HesabÄ±n durumunu belirtir: AKTIF PASIF KAPALI \n \n \n TR.OHVPS.DataCode.HspTip \n Hesap Ã§eÅidini belirtir: VADESIZ VADELI KREDILI_MEVDUAT_HESABI POS CEK YATIRIM \n \n \n TR.OHVPS.DataCode.HspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.IslemAmaci \n Ãdemenin AmacÄ±na yÃ¶nelik olarak aÅaÄÄ±daki deÄerlerden birini alÄ±r: 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aid

16at Ã¶demesi 12: DiÄer \n \n \n TR.OHVPS.DataCode.IslemTuru \n Hesap hareketleri (iÅlemler) sorgusunda dÃ¶nÃ¼len Ä°Ålem TÃ¼rÃ¼ (islTur) parametresi aÅaÄÄ±daki deÄerlerden birini alabilir: HAVALE EFT FAST PARA_YATIRMA PARA_CEKME YABANCI_PARA_HAVALE YATIRIM_HESABINA_AKTARIM YATIRIM_HESABINDAN_AKTARIM KURUM_FATURA_ODEMESI CEK SENET SIGORTA_ODEMESI UCRET_KOMISYON_FAIZ SGK_ODEMESI VERGI_ODEMESI DOVIZ_ALIM DOVIZ_SATIM KREDI_ODEMESI KREDI_KULLANIM KK_ODEMESI KK_NAKIT_AVANS SANS_OYUNU UYE_ISYERI_ISLEMLERI HGS_OGS_ISLEMLERI DOGRUDAN_BORCLANDIRMA_SISTEMI DIGER \n \n \n TR.OHVPS.DataCode.IzinTur \n 01: Temel Hesap Bilgisi 02: AyrÄ±ntÄ±lÄ± Hesap Bilgisi 03: Bakiye Bilgisi 04: Temel Ä°Ålem (Hesap Hareketleri) Bilgisi 05: AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi 06: AnlÄ±k Bakiye Bildirimi \n \n \n TR.OHVPS.DataCode.KareKodAksTur \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulamalÄ± hizmet alÄ±nan iÅyeri Ã¶demesi 02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulamalÄ± iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n TR.OHVPS.DataCode.KaynakTip \n HESAP_BILGISI_RIZASI  ODEME_EMRI_RIZASI   ODEME_EMRI    BAKIYE    COKLU_ISLEM_TALEBI    HHS    YOS \n \n \n TR.OHVPS.DataCode.KimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) Y , YKN , N11 P , PNO , AN7..9 \n \n \n TR.OHVPS.DataCode.KolasHspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.KolasTur \n MÃ¼Återinin sorgulama istediÄi Kolay Adres Tipi deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r: T: Telefon NumarasÄ± E: E-Posta K: TCKN V: VKN Y: YKN P: Pasaport NumarasÄ± \n \n \n TR.OHVPS.DataCode.KurumKimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) V , VKN , AN10 \n \n \n TR.OHVPS.DataCode.LogoArkaPlan \n B :  LogolarÄ±n arka planÄ±nÄ±n beyaz olmasÄ± (Erkek Logo)   K : LogolarÄ±n arka planÄ±nÄ±n renkli/koyu olmasÄ± (DiÅi Logo) \n \n \n TR.OHVPS.DataCode.LogoFormat \n SVG :  Logonun svg formatÄ±nda olmasÄ±nÄ± ifade eder. Logonun 1:2 oranÄ±nda olmasÄ± gerekmektedir.   PNG : Logonun png formatÄ±nda olmasÄ±nÄ± ifade eder. Logonun 500 X 1000 px olmasÄ± gerekmektedir. \n \n \n TR.OHVPS.DataCode.LogoTur \n FULL_LOGO   : YazÄ± ve ikon Åekillerin bir arada olduÄu logo   ICON_LOGO : Ä°kon Åekillerin olduÄu ( Sadece gÃ¶rsel olan-yazÄ±sÄ±z ) logo \n \n \n TR.OHVPS.DataCode.OdemeAmaci \n Ãdemenin AmacÄ±na yÃ¶nelik olarak aÅaÄÄ±daki deÄerlerden birini alÄ±r: 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aidat Ã¶demesi 12: Gayrimenkul alÄ±m Ã¶demesi 13: Motorlu taÅÄ±t alÄ±m Ã¶demesi 14: BorÃ§ verme/BorÃ§ Ã¶deme 15: Hediye/baÄÄ±Å/yardÄ±m 16: Vergi/resim/harÃ§ Ã¶demesi 17: Tazminat/sigorta Ã¶demesi 18: AvukatlÄ±k/DanÄ±ÅmanlÄ±k/MÃ¼Åavirlik Ãdemesi 19: SaÄlÄ±k Ã¶demesi 20: Kripto/dijital varlÄ±k 21: Åans oyunlarÄ±/bahis Ã¶demesi 22: EÄlence/sosyal medya Ã¶demesi \n \n \n TR.OHVPS.DataCode.OdemeDurumu \n Ãdemenin durumunu gÃ¶sterir. AlabileceÄi deÄerler: 01: GerÃ§ekleÅti (Ãdeme ilgili Ã¶deme sistemine iletildi ve alÄ±cÄ± hesabÄ±na ulaÅtÄ±.)  02: GÃ¶nderildi (Ãdeme ilgili Ã¶deme sistemine iletildi ancak alÄ±cÄ± hesabÄ±na ulaÅtÄ±ÄÄ±na dair teyit alÄ±nmadÄ±.)Ä°Ålemin son durumunun teyidi iÃ§in YÃS sorgulama yapmalÄ±dÄ±r. 03- GerÃ§ekleÅmedi (Ãdemenin ilgili Ã¶deme sistemine iÅletiminde veya iÅlenmesi sÄ±rasÄ±nda hata, zaman aÅÄ±mÄ±, sistemin gÃ¼n sonu iÅlemlerine baÅlamasÄ± vb. durum oluÅtu ve Ã¶deme gereÃ§eklemedi veya iade edildi.) 04- Onayda bekliyor (Ãdeme emri alÄ±ndÄ±. Ãoklu onay akÄ±ÅÄ±nÄ±n tamamlanmasÄ± bekleniyor.) 05- Ä°Åleme AlÄ±ndÄ± ( Ãdeme emri alÄ±ndÄ±. ) YÃS tarafÄ±ndan mÃ¼Återiye gÃ¶sterilmeyen bir koddur. Bu kod dÃ¶nÃ¼ldÃ¼ÄÃ¼nde YÃS uygulamasÄ±nda ÃHKâya Ã¶deme durumu 02-GÃ¶nderildi  olarak gÃ¶sterilir. Ä°Ålemin son durumunun teyidi iÃ§in YÃS sorgulama yapmalÄ±dÄ±r. \n \n \n TR.OHVPS.DataCode.OdemeKaynak \n I: Ä°nternet bankacÄ±lÄ±ÄÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. A: Otomatik para makineleri (ATM) ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. T: Telefon bankacÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. K: Kiosklar aracÄ±lÄ±ÄÄ±yla gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. S: Åubeden girilen Ã¶demelerde kullanÄ±lÄ±r. M: Mobil uygulamadan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. D: YukarÄ±dakiler dÄ±ÅÄ±ndaki Ã¶deme kaynaklarÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.  O: AÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. \n \n \n TR.OHVPS.DataCode.OdemeSistemi \n Ä°Ålemin yÃ¶nlendirildiÄi Ãdeme Sistemine gÃ¶re aÅaÄÄ±daki deÄerlerden birini alabilir: H: Havale F: FAST E: EFT (PÃS) deÄerlerinden birini alabilir. \n \n \n TR.OHVPS.DataCode.OhkTur \n B: Bireysel  K: Kurumsal \n \n \n TR.OHVPS.DataCode.OhkTanimTip \n TCKN: TCKN Â  (ohkTanimDeger N11 olarak gÃ¶nderilmelidir.)  MNO:  Â  Â    HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ± (OHKTanimDeger AN1..30 olarak gÃ¶nderilmelidir. )   YKN:  Â  Â  YabancÄ± Kimlik NumarasÄ± (OHKTanimDeger N11 olarak gÃ¶nderilmelidir.)    PNO:  Â  Â  Pasaport numarsÄ± (ohkTanimDeger AN7..9 olarak gÃ¶nderilmelidir.)    GSM:  Â  Â   Cep telefonu numarasÄ± (ohkTanimDeger N10 olarak gÃ¶nderilmelidir.)   IBAN:  Â  IBAN numarasÄ± (OHKTanimDeger AN26 olarak gÃ¶nderilmelidir.) \n \n \n TR.OHVPS.DataCode.OlayTip \n KAYNAK_GUNCELLENDI  AYRIK_GKD_BASARILI AYRIK_GKD_BASARISIZ HHS_YOS_GUNCELLENDI \n \n \n TR.OHVPS.DataCode.YOSDurumu \n A : AÃ§Ä±k. Ãretim OrtamÄ±nda YÃSâÃ¼n aktif bir Åekilde hizmet vermesi durumu.   G : GeÃ§ici Hizmet Veremiyor. YÃS servislerinde teknik bir sorun olmasÄ± nedeniyle YÃS\'Ã¼n hizmet verememesi durumu.   K: KapalÄ±. YÃS\'Ã¼n hizmet vermeme durumu. \n \n \n TR.OHVPS.DataCode.PSUInitiated \n âEâ : Evet  âHâ : HayÄ±r   âOâ : Olay Bildirim \n \n \n TR.OHVPS.DataCode.RizaDurumu \n B: Yetki Bekleniyor Y: Yetkilendirildi K: Yetki KullanÄ±ldÄ± E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ S: Yetki S

16onlandÄ±rÄ±ldÄ± I :Yetki Iptal \n \n \n TR.OHVPS.DataCode.RizaIptDtyKod \n â01â :Yeni RÄ±za Talebi ile Ä°ptal â02â :KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal â03â :KullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal â04â :SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor â05â :SÃ¼re AÅÄ±mÄ± : Yetkilendirildi â06â :SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi â07â :GKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± â08â :GKD iptali : RÄ±zano ile TCKN uyuÅmamasÄ± â09â :GKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor â10â :GKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± â11â :GKD iptali : Hesap Yetki Sorunu â12â :GKD iptali : ÃHK HHS kontrollerini aÅamadÄ± â13â :GKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi â14â :GKD iptali : Fraud ÅÃ¼phesi â99â :GKD iptali : DiÄer \n \n \n TR.OHVPS.DataCode.RizaTip \n H: Hesap Bilgisi RÄ±zasÄ± O: Ãdeme Emri RÄ±zasÄ± \n \n \n TR.OHVPS.DataCode.SrlmYon \n âAâ: Azalan deÄerle sÄ±ralama âYâ: Artan deÄerle sÄ±ralama \n \n \n TR.OHVPS.DataCode.VarYok \n 0 : KayÄ±t Yok   1 : KayÄ±t Var \n \n \n TR.OHVPS.DataCode.YetTip \n AlabileceÄi deÄerlere gÃ¶re hangi belirtecin dÃ¶neceÄine karar verilir. yet_kod yenileme_belirteci \n \n \n TR.OHVPS.DataCode.ZmnAralik \n 0 : KayÄ±t Yok  1 : 0-2 saat 2 : 2 saat 1 dakika-24 saat  3 : 1-3 gÃ¼n   4 : 4-15 gÃ¼n\t  5 : 16 gÃ¼n ve Ã¼stÃ¼ \n EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi \n TÃ¼m katÄ±lÄ±mcÄ±larÄ±n GEÃÄ°T\'e eriÅebilmesi iÃ§in, BKM tarafÄ±ndan yapÄ±lan istemci sertifika doÄrulamasÄ±ndan geÃ§mesi gerekmektedir. Ä°stemci sertifikasÄ± Ã¼retilmeden Ã¶nce katÄ±lÄ±mcÄ±larÄ±n CSR Ã¼retme akÄ±ÅÄ±nÄ± tamamlamasÄ± gerekmektedir. \n OpenSSL ile CSR (Certificate Signing Request) OluÅturma \nAÅaÄÄ±daki komut ile 2048-bit RSA private key ve CSR oluÅturulur. \nopenssl req -new -newkey rsa:2048 -nodes -keyout PRIVATEKEY.key -out CSR.csr \n CSR ile ilgili detay bilgilerin giriÅinde; \nCommon Name (CN) olarak 4 karakterli hhsKod ya da yosKod deÄeri ile, \ndiÄer alanlar iÃ§in de kurum bilgileriniz ile giriÅ yapÄ±lÄ±r. \n TÃ¼m bilgilerin girilmesinden sonra oluÅan private key dosyasÄ± kurumunuzda saklanÄ±r.\nCSR dosyasÄ± ise istemci sertifika Ã¼retmek Ã¼zere kullanÄ±lÄ±r. Bu aÅamada takip edilmesi gereken adÄ±mlar Åu Åekildedir: \n KatÄ±lÄ±mcÄ±larÄ±n, TRIP ortamÄ± Ã¼zerinden, BKM TarafÄ±ndan yetki verilmiÅ kullanÄ±cÄ±larÄ±nÄ±n gÃ¶rebileceÄi "Ä°stemci Sertifika Talebi" menÃ¼ adÄ±mÄ±na giriÅ yapmalarÄ± beklenir. AÃ§Ä±lan ekranda,"CSR DosyasÄ± YÃ¼kleme" alanÄ± iÃ§erisine, katÄ±lÄ±mcÄ±nÄ±n Ã¼retmiÅ olduÄu csr dosyasÄ± yÃ¼klenir. YaklaÅÄ±k 1 dakika iÃ§erisinde kuruma Ã¶zel olarak Ã¼retilmiÅ olan client sertifikasÄ± indirilmeye hazÄ±r hale gelecektir. "Ä°ndir" butonu ile client sertifika indirilir. Ä°stemci tarafÄ±nda web isteÄinin ilgili sertifika ile iliÅkilendirilerek oluÅturulmasÄ± gerekmektedir. \n Uzun dÃ¶nemli olarak hazÄ±rlanacak olan sertifikalar sertifikasyon ve Ã¼retim ortamlarÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi bu aÅamalarda sÄ±nanacaktÄ±r. \n GEÃÄ°T\'in test ve Ã¼retim ortamlarÄ± ayrÄ±mÄ±nda istemci sertifikalarÄ±, HHS Listeleme API eriÅimleri ve Sertifikasyon baÄlantÄ±larÄ± Åekil 15-HHS/YÃS API Mimarisi DiagramÄ±nda resmedilmiÅtir. \n EK-4: Sunucu SertifikalarÄ± \n Sunucu sertifikalarÄ±nÄ±n endpoint bilgisini (Fqdn) iÃ§erecek ve global bir Certification Authority tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir.\nÃrneÄin; entegrasyon formu iÃ§erinde yer alan URL bilgisinin (test.xbank.com.tr) sertifika iÃ§erisinde tanÄ±mlÄ± olmasÄ± ve bu sertifikanÄ±n global bir CA Ã¶rneÄin Verisign tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir. \n Hizmet saÄlayÄ±cÄ± olan HHS\'ler tarafÄ±ndan sunucu sertifikalarÄ± uygulanmalÄ±dÄ±r. \n EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ± \n Dijital imzalama yapÄ±sÄ±, ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini saÄlamak amacÄ±yla kurgulanmÄ±ÅtÄ±r.\nBu kapsamda imzalama akÄ±ÅÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r: \n \n HHS ya da YÃS Ã¶ncelikle Ã¶zel ve aÃ§Ä±k anahtarlarÄ±nÄ± oluÅturmalÄ±dÄ±r. Bu anahtarlarÄ± oluÅturmak iÃ§in aÅaÄÄ±da âopensslâ kullanÄ±larak oluÅturma Ã¶rneÄi paylaÅÄ±lmÄ±ÅtÄ±r.  Bu anahtarlardan Ã¶zel olan anahtar mesajÄ± imzalamak iÃ§in kullanÄ±lacak olup, aÃ§Ä±k anahtar ise mesajÄ± doÄrulamak amacÄ±yla mesajÄ±n alÄ±cÄ±sÄ± tarafÄ±ndan kullanÄ±lacaktÄ±r. \n \n private_key.pem ve public_key.pem dosyasinin iÃ§erikleri kod tarafÄ±nda kullanÄ±lacaktÄ±r. \n --private.pem => Ãzel anahtarÄ±n ismi\nopenssl genrsa -out private.pem 2048 \n --public_key.pem => AÃ§Ä±k anahtarÄ±n ismi\nopenssl rsa -in private.pem -pubout -outform PEM -out public_key.pem \n --private_key.pem => Ãzel anahtarÄ±n PCKS8 formatÄ±na Ã§evrilmesi (Java aÃ§Ä±sÄ±ndan PCKS8 formatÄ±nda olma ihtiyacÄ± nedeniyle) openssl pkcs8 -topk8 -inform PEM -in private.pem -out private_key.pem -nocrypt \n \n \n AÃ§Ä±k ve Ãzel anahtarlar oluÅturulduktan sonra AÃ§Ä±k Anahtar BKM ile paylaÅÄ±lÄ±r. BKM bu aÃ§Ä±k anahtarÄ± diÄer katÄ±lÄ±mcÄ±larÄ±n ulaÅabilmesi ve alabilmesi iÃ§in bir Anahtar Deposu yaklaÅÄ±mÄ± ile bÃ¼nyesinde tutar. Ä°lgili anahtarÄ± iletebilmek ve alabilmek iÃ§in kullanÄ±lacak HHS/YOS API ye eriÅim detaylarÄ± EK-6 bÃ¶lÃ¼mÃ¼nde detaylÄ± olarak paylaÅÄ±lmÄ±ÅtÄ±r.  EÄer kurumun ilgili anahtar Ã§iftinin yenilenme durumu sÃ¶z konusu ise yenilemenin hemen ardÄ±ndan aÃ§Ä±k anahtar yeni bir imzalama yapÄ±lmadan Ã¶nce mutlaka BKM ile paylaÅÄ±lmalÄ±dÄ±r. \n \n \n Ä°mzalÄ± mesajÄ± aÃ§acak olan kurum mesajÄ± imzalayan kurumun aÃ§Ä±k anahtarÄ±nÄ± her sorguda yeniden almak durumunda deÄildir. Belirli periyodlarda kendi ortamÄ±ndaki anahtarÄ± yenileyerek sistemi iÅletebilir. Ancak imzalayan kurum anahtar Ã§ifti yenilemesi yaptÄ±ÄÄ±nda BKM ile aÃ§Ä±k anahtarÄ±nÄ± paylaÅsa dahi

16imzalÄ± mesajÄ± doÄrulayacak taraf eski aÃ§Ä±k anahtar ile doÄrulama yapmaya Ã§alÄ±ÅtÄ±ÄÄ± iÃ§in hata alacaktÄ±r. Bu ilk hata durumunda hÄ±zlÄ±ca BKM Ã¼zerinden yeni anahtarÄ± alÄ±p mesajÄ± tekrar doÄrulamayÄ± denemelidir. EÄer yine hata alÄ±yor ise doÄrulama iÅlemini hata statÃ¼sÃ¼ne almalÄ±dÄ±r. Bu sebeple anahtar yenileyen kurum yeni aÃ§Ä±k anahtarÄ±nÄ± yeni bir mesaj imzalama yapmadan Ã¶nce mutlaka BKM ile paylaÅmalÄ±dÄ±r. \n \n \n PSU-Fraud-Check alanÄ± iÃ§in de JWT formatÄ±nda Ã§Ä±ktÄ± hazÄ±rlanmasÄ± beklenmektedir. Ãrnek bir PSU-Fraud-Check payload deÄeri aÅaÄÄ±daki gibidir; \n {"AnomalyFlag": "0", \n"LastPasswordChangeFlag": "1", \n"FirstLoginFlag": "1", \n"DeviceFirstLoginFlag": "1", \n"BlacklistFlag": "0", \n"MalwareFlag": "0", \n"UnsafeAccountFlag": "0", \n"exp": 1663424479, \n"iat": 1663338079, \n"iss": "[https://apigw.bkm.com.tr|https://apigw.bkm.com.tr/]" } \n Ä°mzalama KurallarÄ± (YÃS) \n Bir YÃS Ã¼zerinden baÅlayan akÄ±Å Ã¶rnek olarak paylaÅÄ±lmÄ±ÅtÄ±r. \n \n \n YÃS, mesaj imzalama gerektiren her API isteÄinin HTTP gÃ¶vdesini (request body) kendi Ã¶zel anahtarÄ± ile Åifreleyerek imza bilgisini oluÅturur. \n \n \n ArdÄ±ndan bu imza verisini, gÃ¶ndereceÄi mesajÄ±n istek baÅlÄ±ÄÄ±nda yer alan X-JWS-Signature alanÄ±nda gÃ¶ndermelidir. \n \n \n X-JWS-Signature alanÄ±nda gÃ¶nderilecek olan bilgi aÅaÄÄ±daki yÃ¶ntem ile oluÅturulmalÄ±dÄ±r. \n \n \n Bu alana yazÄ±lacak olan bilgi JWT formatÄ±nda oluÅturulmalÄ±dÄ±r. \n \n \n Bir JWT, header-payload-signature alanlarÄ±ndan oluÅmaktadÄ±r. \n \n Header alanÄ±nda JWTâyi imzalamak iÃ§in kullanÄ±lacak algoritma belirtilmelidir.  Standartlar kapsamÄ±nda RS256 kullanÄ±lacaktÄ±r. \n Payload kÄ±smÄ±nda Ã¶zel olarak oluÅturulacak olan âbodyâ claim alanÄ±na istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ± yazÄ±lmalÄ±dÄ±r. \n JSON payload oluÅturulurken RFC 7519 baz alÄ±nmalÄ±dÄ±r. "iss" (Issuer) Claim, "exp" (Expiration Time) Claim, "iat" (Issued At) Claim, âbodyâ Claim alanlarÄ±nÄ±n gÃ¶nderilmesi zorunludur. ^RFC7519 \na.\t"iss" (Issuer) Claim : Kurumunuza Ã¶zel bilgidir. \nb.\t"exp" (Expiration Time) Claim: Saniye cinsinden (Unix time) imzanÄ±n son geÃ§erli olduÄu tarih. Bu tarih  mevcut sunucu saatinizden 60 dakika sonra olacak Åekilde kullanÄ±lmalÄ±dÄ±r. \nc.\t"iat" (Issued At) Claim : Saniye cinsinden (Unix time) imzanÄ±n oluÅturulduÄu tarih. Bu tarih  mevcut sunucu saatinizden 5 dakika Ã¶nce olacak Åekilde kullanÄ±lmalÄ±dÄ±r. \nd.\tâbodyâ Claim : istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ±. \n Signature alanÄ±nda da Ã¶zel anahtar ile imzalanmÄ±Å olan imza iÃ§eriÄi yer alacaktÄ±r. \n \n X-JWS-Signature:   JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir. \n Ãrnek X-JWS-Signature Payload DeÄeri \n { \n"iss": "https://apigw.bkm.com.tr", \n"exp": 1646832405, \n"iat": 1646746005, \n"body": "c543072f97a761a1d891dc81acc380bc1e6f61ca6541bd93ebfdece338457922" \n} \n \n \n \n \n YÃS, isteÄi gÃ¶nderir. Sadece mesajÄ±n bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ ve doÄruluÄunu teyit amacÄ± ile istek gÃ¶vdesi (request body) SHA256 hash deÄeri imzalanarak X-JWS-Signature alanÄ±nda bu imza iletilir. Ä°steÄin gÃ¶vde (request body) kÄ±smÄ± aÃ§Ä±k ve Åifresiz olarak gÃ¶nderilmektedir. \n \n \n HHS, isteÄi alÄ±r, talebi gerÃ§ekleÅtirmeden Ã¶nce aldÄ±ÄÄ± API isteklerinin imzasÄ±nÄ± doÄrulamalÄ±dÄ±r. X-JWS-Signature alanÄ±ndaki JWT aÅaÄÄ±daki adÄ±mlarla doÄrulanmalÄ±dÄ±r. \n \n Header kÄ±smÄ±ndaki algoritmanin RS256 olduÄu kontrol edilir. \n GÃ¶nderen kurumun aÃ§Ä±k anahtarÄ± ile JWT verify (doÄrulama) iÅlemi yapÄ±lÄ±r. \n YukarÄ±daki iÅlemlerin doÄruluÄunun ardÄ±ndan JWTânin payload kÄ±smÄ±ndaki âbodyâ claim alanÄ±ndaki bilginin, isteÄin gÃ¶vde verisinin SHA256 hash deÄerlerinin aynÄ± olduÄu kontrol edilir. \n Ãrnek checksum deÄeri   "a64b19f95eeb1fb0a0a3e2dbbc6e3d8472c52184d4543417ddc6d156fc5c5571" veya   "A64B19F95EEB1FB0A0A3E2DBBC6E3D8472C52184D4543417DDC6D156FC5C5571" Åeklinde olabilir. Ä°ki hali de aynÄ± deÄere sahiptir. Kontrollerde buna dikkat edilmesi gerekmektedir. \n \n \n \n YukarÄ±daki iÅlemler ile doÄruluÄu teyit edilmiÅ olan isteÄin talebi gerÃ§ekleÅtirir. \n \n \n EÄer istek doÄrulanamÄ±yor ise gÃ¶nderen kurumun aÃ§Ä±k ve Ã¶zel anahtar Ã§ifti yenilenmiÅ olabilir. \n \n \n BKM HHS API  Ã¼zerinden ilgili kurumun bilgilerini (kurum ko

16du vs) kullanarak kurumun detay bilgileri Ã§eker ve kendi ortamÄ±nda yeniler. \n \n \n ArdÄ±ndan imzayÄ± tekrar aÃ§Ä±k anahtar ile doÄrulayarak kontroller gerÃ§ekleÅtirilir. (EÄer halen doÄrulama iÅlemi baÅarÄ±sÄ±z ise bu istek iÃ§in hata akÄ±ÅÄ± Ã§alÄ±ÅtÄ±rÄ±lÄ±r.  TR.OHVPS.Resource.InvalidSignature  kodu ile hata Ã¼retilebilir.) \n \n \n Ä°mza bilgisinin beklendiÄi (x-jws-signature) servislerde, bu bilginin iletilmediÄi durumlarda  TR.OHVPS.Resource.MissingSignature  hatasÄ± Ã¼retilebilir. \n \n \n HHS isteÄi iÅledikten sonra cevabÄ± oluÅtururken de yukarÄ±daki akÄ±Ålar ile gÃ¶ndereceÄi cevabÄ± imzalamalÄ±dÄ±r. \n \n \n Ä°stek yanÄ±t gÃ¶vdesinin SHA256 checksum deÄeri iÃ§in hexadecimal Ã§Ä±ktÄ± kullanÄ±lacaktÄ±r. OluÅacak Ã§Ä±ktÄ±nÄ±n 64 karakter olmasÄ± beklenmektedir. Kontrol iÃ§in "^[A-Fa-f0-9]{64}$" RegEx tarifini kullanabilirsiniz. \n \n \n Ãrnek bir gÃ¶vde: \n {"katilimciBlg":{"hhsKod":"8000","yosKod":"8000"},"gkd":{"yetYntm":"Y","yonAdr":"https://boss-test.bkm.com.tr/boss/ab/yosSimulator/8000?drmKod=6021de9f-55e7-454a-94be-2044866b22e1"},"kmlk":{"kmlkTur":"M","kmlkVrs":"123456","ohkTur":"B"},"hspBlg":{"iznBlg":{"iznTur":["01","02","03","04","05"],"erisimIzniSonTrh":"2022-10-12T23:59:59+03:00","hesapIslemBslZmn":"2021-10-10T00:00:00+03:00","hesapIslemBtsZmn":"2023-10-10T23:59:59+03:00"}}}\n \n Bu gÃ¶vdenin checksum\'Ä±: \n a64b19f95eeb1fb0a0a3e2dbbc6e3d8472c52184d4543417ddc6d156fc5c5571\n \n Bu checksum\'Ä±n iletildiÄi x-jws-signature baÅlÄ±k deÄeri: \n eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwczovL2FwaWd3LmJrbS5jb20udHIiLCJleHAiOjE2NjU0NzU1NjIsImlhdCI6MTY2NTM4OTE2MiwiYm9keSI6ImE2NGIxOWY5NWVlYjFmYjBhMGEzZTJkYmJjNmUzZDg0NzJjNTIxODRkNDU0MzQxN2RkYzZkMTU2ZmM1YzU1NzEifQ.Q65PI_1fTEzzBMirvmJvXgVX3orhhZ4_UqujtGdHkU7me-1ymIjvPrzy3kfyER1pedFb7HDCBuPvYoqjX8eUnpiiZsxfzCiEa0McIhoFeUOggq-O8VihItp8bLr2DWwQ9JHN1-WXB2mL31KAKFAL1VY9-DXuAdT-RfE_SLYsl2ycmNy4ti4XvfDvvlE56ZsieFZ727VuwR8wi7F0kKDc6UhjaMF9xcUeAM1fxX-bmcOaOo1NZGC0vvgjNZKz_OJrN-q8VhWYnQPiJ7wY7S9IG8bHIkBImKSVf8LuOEvl8u0BZzADLH1iOBd9x2l1plyI_NLPTrnOqhWhKlljkkJBCg\n \n EÄer PSU-Fraud-Check iÃ§in baÅlÄ±k gÃ¶nderilecekse, yine JWT formatÄ±nda imza Ã¼retilmelidir. Ãrnek bir psu-fraud-check baÅlÄ±k deÄeri: \n eyJhbGciOiJSUzI1NiJ9.eyJBbm9tYWx5RmxhZyI6IjAiLCJMYXN0UGFzc3dvcmRDaGFuZ2VGbGFnIjoiMSIsIkZpcnN0TG9naW5GbGFnIjoiMSIsIkRldmljZUZpcnN0TG9naW5GbGFnIjoiMSIsIkJsYWNrbGlzdEZsYWciOiIwIiwiTWFsd2FyZUZsYWciOiIwIiwiVW5zYWZlQWNjb3VudEZsYWciOiIwIiwiZXhwIjoxNjY1NDc1NTU2LCJpYXQiOjE2NjUzODkxNTYsImlzcyI6Imh0dHBzOi8vYXBpZ3cuYmttLmNvbS50ciJ9.DhUh_nsXDuNIrvsQ3KOhOXdVcJg6fTDVW8K1oea8kLtmb7n-_hJHY3mWX5zzobu-Vh2VvFzIxPhHtol6gLHFktmIMiQ9TDHb_mRZFXgJB4ToNfqc3Fy9mi5bS8By2IYi1HxDaCStstaZDaunzXfHCtqybfZXyk6teDrf-iIf6lqX9Keo7GZO-Y7mP7C13-c_QwyNKrZK4TZwUQbecRqXYn1DcEHM7kukQHTar_hKBWkXPmNpScY0J2rKksr4ejR1uLhdQm-Pdwoe9y6qrNEB79vMLBkRNtbuV0vc1GYHp_YKkzBKBI_58uuB2GD9877CsrcRnHMQb88xpxiPKh6-ew\n EK-6: HHS/YÃS API Mimarisi \n HHS/YÃS API Uygulama Mimarisinde Test ve Ãretim ortamlarÄ±nda aÅaÄÄ±daki alanda yer almaktadÄ±r. \n \n Åekil 15: HHS/YÃS API Mimarisi \n'},{title:"HHS ve YÃS API",frontmatter:{},regularPath:"/v1.0.2/contents/hhs-yos-api.html",relativePath:"v1.0.2/contents/hhs-yos-api.md",key:"v-0ec6f57d",path:"/v1.0.2/contents/hhs-yos-api.html",headers:[{level:2,title:"HHS API",slug:"hhs-api"},{level:2,title:"YOS API",slug:"yos-api"},{level:2,title:"Healthcheck API",slug:"healthcheck-api"}],content:' HHS ve YÃS API \n HHS API, HHSâlerin detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. HHS API iÃ§in âhhs_readâ scope bilgisi kullanÄ±lÄ±r. \n Production ortamÄ±nda HHS / YOS API iÃ§erisinde sisteme dahil olmuÅ, sertifikasyonu baÅarÄ± ile tamamlamÄ±Å paydaÅlar listelenecektir. HHS tarafÄ±ndan desteklenen API sÃ¼rÃ¼mleri listelenecektir. \n YÃSâler HHS APIâsini sorgulayabilir ancak YÃS APIâsini sorgulayamazlar. \nBenzer Åekilde HHSâler YÃS APIâsini sorgulayabilir, HHS APIâsini sorgulayamazlar. \n HHS API \n GET /hhs/{hhsKod} \n Ä°Ålem Sorgu ÃrneÄi =  /hhs  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m HHSâlerin dizi Åeklinde verileri listelenir. \nÄ°Ålem Sorgu ÃrneÄi =  /hhs/2001   â¨ bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan hhsKoduâna ait bilgiler listelenir. Ya da â404 Not Foundâ hatasÄ± alÄ±r. \nHHS ve YÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir. \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hhs?srlmKrtr=kod&srlmYon=A \n Tablo 20: HHS ve YÃS API Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âkodâ, âunvâ

16} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, sÄ±ralama kriteri âunvâ olarak belirlenmelidir. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 21: HHS Bilgileri Sorgulama YanÄ±tÄ± âHhsâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n hhs kodu \n kod \n AN4 \n Z \n HHS nin kod bilgisi \n \n \n hhs unvanÄ± \n unv \n AN3..140 \n Z \n HHS nin unvan bilgisi \n \n \n hhs markasÄ± \n marka \n AN1..140 \n Z \n ÃHK\'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. HHS tarafÄ±ndan belirlenecektir. \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n HHSânin mesaj imzalama iÃ§in paylaÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n HHS Api Bilgileri \n apiBilgileri \n Kompleks: HhsApiBilgi[Array][0..N] \n Z \n Desteklenen Api ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > api \n api \n AN1..20 \n Z \n Api Ä°smi Ãrnek :obh, hbh,gkd \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s2.0 s1.0 \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n HHSâye ait logo bilgileri. Logotur = Original  formatÄ±ndaki logonun minimumda gÃ¶nderimi zorunludur. \n \n \n >logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur alabileceÄi deÄerler  ORIGINAL , WHITE_OVERLAY , BLACK_OVERLAY , GRAY_OVERLAY \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n HHS tarafÄ±nda tutulan ve YÃSâlerle paylaÅÄ±lacak olan url adres bilgisidir. \n \n \n Durum \n durum \n AN1 \n Z \n HHS\'nin durum bilgisidir.  TR.OHVPS.DataCode.HHSDurumu sÄ±ralÄ± veri tipinde alabileceÄi deÄerler belirtilmiÅtir. \n \n \n \n HHS API\'de; AÃ§Ä±k, YaygÄ±nlaÅtÄ±rma, GeÃ§ici Hizmet Veremiyor, KapalÄ± durumlarÄ±ndaki HHS\'ler listelenecektir.  \nSertifikasyon onayÄ± alan HHS\'ler, Ã¼retim ortamÄ±na geÃ§iÅte "YaygÄ±nlaÅtÄ±rma" durumuna sahip olabilir.  HHS\'nin, hangi YÃS\'ler ile "YaygÄ±nlaÅtÄ±rma" kontrollerini yapacaÄÄ±, HHS yÃ¶netiminde olacaktÄ±r. BÃ¶ylece Ãretim OrtamÄ±nda HHSânin kendisi tarafÄ±ndan tanÄ±mlanmÄ±Å kÄ±sÄ±tlÄ± ÃHKâya hizmet vermesi ve servislerini test etmesi saÄlanabilir olacaktÄ±r. HHS\'ler kendi kurum kontrollerini yapana kadar, "YaygÄ±nlaÅtÄ±rma" durumunda kalabilirler. HHS\'nin BKM\'ye yapacaÄÄ± talep ile, HHS "YaygÄ±nlaÅtÄ±rma" durumundan "AÃ§Ä±k" durumuna geÃ§ebilecektir. \nHHS\'de olasÄ± bir teknik sorun olmasÄ± durumunda, BKM - HHS koordinasyonu ile HHS durumu "GeÃ§ici Hizmet Veremiyor" haline getirilecektir. Sorun giderildiÄinde "AÃ§Ä±k" durumuna geri dÃ¶necektir. \n Hem YOS hem de HHS API iÃ§in geÃ§erli olacak; logo gÃ¶nderiminde dikkat edilmesi gerekenler Åu Åekilde tariflenmiÅtir: \n \n LogolarÄ±n ham dosya yerine kurumun yayÄ±nlayacaÄÄ± bir URL Ã¼zerinden sunulmasÄ± gerekmektedir. (Ãrn: logoURL  =  https://kurumadi.com.tr/logo.png) Logo BKM tarafÄ±nda host edilmeyecektir.) \n PNG formatÄ±nda (PNG-24) olmalÄ±dÄ±r. \n 72 DPI Ã§Ã¶zÃ¼nÃ¼rlÃ¼kte olmalÄ±dÄ±r. \n 500 x 500 boyutlarÄ±nda, yatayda veya dikeyde taÅma paysÄ±z tam oturacak, sÄ±nÄ±r boyutlarÄ±nÄ± geÃ§meyecek ve ortalanmÄ±Å yerleÅime sahip olmalÄ±dÄ±r. \n Logo arka planÄ± renkli olmamalÄ±, arka plan transparan olmalÄ±dÄ±r. \n YÃS uygulamasÄ±nda gÃ¶sterim esnasÄ±nda logolarÄ±n hÄ±zlÄ± yÃ¼klenmesi ve dÃ¼ÅÃ¼k veri tÃ¼ketmesi aÃ§Ä±sÄ±ndan; logo boyutu 250 KBâÄ±n altÄ±nda olmalÄ±dÄ±r. \n DÃ¶rt adet logo tÃ¼rÃ¼ belirlenmiÅtir. Bu 4 tÃ¼r iÃ§in de logo dÃ¶nÃ¼lmesi zorunludur. \n Logo urlâin public eriÅilebilir url olmasÄ± gereklidir. \n \n YÃS API, YÃS statÃ¼sundeki kurumlarÄ±n detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. YÃS API iÃ§in âyos_readâ scope bilgisi kullanÄ±lÄ±r. \n YÃS API yanÄ±tÄ±nda, listelenen yÃ¶nlendirme ve bildirim adresleri bulunmaktadÄ±r. HHS, iÅlem anÄ±nda iletilen yonAdr ya da bldrAdr alanlarÄ±nda gÃ¶nderilen adreslere yetKod deÄerini iletmelidir. YÃS API iÃ§erisinde yer alan adresleri, rÄ±za isteÄinde gÃ¶nderilen adreslerin doÄruluÄunu kontrol etme amacÄ±yla kullanÄ±lmalÄ±dÄ±r. Bu nedenle YÃS API iÃ§erisinde listelenen adreslerin hostname seviyesinde yer almasÄ± yeterlidir. \n YOS API \n YÃS API iÃ§erisinde yer alan YÃS rol bilgileri ve aktiflik/pasiflik durumlarÄ± birbiriyle iliÅkili deÄildir. \n YÃS\'Ã¼n sahip olduÄu Ã¶bhs,hbhs rolleri iÃ§in herhangi bir fraud ya da teknik sebeplerden Ã¶tÃ¼rÃ¼ geÃ§ici sÃ¼reyle geri alÄ±nabilir. \n YÃS aktifliÄini korurken problem Ã§Ã¶zÃ¼lene kadar geÃ§ici olarak alÄ±nan roller(Ã¶bhs,hbhs) tekrardan aktif hale getirilir. \n GET /yos/{yosKod} \n Ä°Ålem Sorgu ÃrneÄi =  /yos   ï  bu sorgu yÃ¶ntemi ile tÃ¼m yos lerin dizi Åeklinde verileri listelenir. \n Ä°Ålem Sorgu ÃrneÄi =  /yos/2501   ï  bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan yosKoduâna ait bilgiler listelenir ya da â404 Not Foundâ hatasÄ± alÄ±r.\nYÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir.\nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /yos?srlmKrtr=kod&srlmYon=A \n Tablo 22: YOS Bilgileri Sorgulama YanÄ±tÄ± âYosâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n YÃ¶s kodu \n kod \n AN4 \n Z \n YÃS\'Ã¼n kod bilgisi \n \n \n YÃ¶s unvanÄ± \n unv \n AN3..140 \n Z \n YÃS unvan bilgisi \n \n \n YÃ¶s markasÄ± \n marka \n AN1..140 \n Z \n ÃHK\'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. YÃS tarafÄ±ndan belirlenecektir. \n \n \n YÃS rolleri \n roller \n Array[AN4] \n Z \n YÃSâun rollerini belirten deÄer. Ãrnek: [ "obhs", "hbhs" ]  - obhs - Ãdeme Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼  - hbhs - Hesap Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼ \n \n \n Adresler \n adresler \n Kompleks:Adres[Array] [1..N] \n Z \n --- \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. Adres detaylarÄ±nÄ±n hangi GKD tÃ¼rÃ¼ne ait olduÄunu belirtir. \n \n \n >Adres DetaylarÄ± \n adresDetaylari \n adresDetaylari\tKompleks: AdresDetayi[Array] [1..N] \n Z \n \n \n \n >>Temel Adres \n tmlAdr \n AN1..1024 \n Z \n yetYntm deÄeri âYâ olarak iletildiÄinde YÃ¶nlendirmeli GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. yetYntm deÄeri âAâ olarak iletildiÄinde AyrÄ±k GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. Riza isteklerinde bu deÄer ile uyumluluÄu kontrol edilmelidir. Ãrnek: https://example.com https://example2.com/path deepLink://example/test deepLink://example2/test \n \n \n >>AÃ§Ä±klama \n aciklama \n AN1..1024 \n Ä° \n YÃSâÃ¼n gÃ¶nderdiÄi adrese yÃ¶nelik vermek istediÄi aÃ§Ä±klama Ãrnek: WEB bireysel , WEB kurumsal  , APP \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n YÃSâÃ¼n mesaj imzalama iÃ§in payla

16ÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n YOSâe ait logo bilgileri. Logotur = Original formatÄ±ndaki logonun minimumda gÃ¶nderimi zorunludur. \n \n \n >logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur alabileceÄi deÄerler  ORIGINAL , WHITE_OVERLAY , BLACK_OVERLAY , GRAY_OVERLAY \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n YÃS tarafÄ±nda tutulan ve HHSâlerle paylaÅÄ±lacak olan url adres bilgisidir. Ãrnek: https://via.placeholder.com/150?text=0001 \n Healthcheck API \n GET /health \n HHS ve YÃS API iÃ§in health servisleri aÅaÄÄ±daki servislerle kontrol edilebilir. \n BaÅarÄ±lÄ± yanÄ±tta Http 200 kodu dÃ¶nÃ¼lecektir\nBaÅarÄ±lÄ± YanÄ±t: \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n status \n status \n AN2..20 \n Z \n âUPâ, âDOWNâ deÄerlerini alabilir \n \n \n \n'},{title:"GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",frontmatter:{},regularPath:"/v1.1.0/contents/erisim-belirteci.html",relativePath:"v1.1.0/contents/erisim-belirteci.md",key:"v-751f6acf",path:"/v1.1.0/contents/erisim-belirteci.html",headers:[{level:2,title:"Yetkilendirme Kodu API",slug:"yetkilendirme-kodu-api"},{level:2,title:"EriÅim Belirteci API",slug:"erisim-belirteci-api"}],content:' GÃ¼Ã§lÃ¼ Kimlik DoÄrulama  \n \n ÃHK\'nÄ±n YÃS uygulamasÄ±ndan HHS uygulamasÄ±na yÃ¶nlendirilmesi ile baÅlanan gÃ¼Ã§lÃ¼ kimlik doÄrulama sÃ¼reci,  Oauth 2.0 standartlarÄ± gereÄi Ã¶ncelikle yetkod deÄerinin YÃS\'e iletilmesi ile baÅlar ve eriÅim belirtecinin alÄ±nmasÄ± sonucunda baÅarÄ± ile sonuÃ§lanmÄ±Å olur. \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ  "odeme_emri" \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n yetkilendirme-kodu \n GET \n /yetkilendirme-kodu \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n \n yetkilendirmeKodu \n \n \n 2 \n erisim-belirteci \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n ErisimBelirteciIstegi \n ErisimBelirteci \n Yetkilendirme Kodu API \n GET /yetkilendirme-kodu \n AyrÄ±k GKD sÃ¼recinde kullanÄ±lacak olan Yetkilendirme Kodu API\'nin  HHS tarafÄ±ndan sunulmasÄ± gerekmektedir. \n AyrÄ±k GKD akÄ±ÅÄ±nda; HHS, YÃS\'Ã¼n olay dinleme servisine "AYRIK_GKD_BASARILI" olay tipi ile olay bildirimi yapar. BÃ¶ylece ÃHK\'nÄ±n kendi sistemine baÅarÄ± ile login olduÄunu ve yetKod deÄerinin ÃHK ile iliÅkilendirildiÄinin bilgisini YÃS\'e iletmiÅ olur.  \nHHS olay bildirimi iÃ§in retry policy sÃ¼reÃ§leri kapsamÄ±nda 1 dakikada 3 kez deneme yapabilir. YÃS\'e olay bildirimi yapÄ±lmamÄ±Å ise, kendisine gelmeyen olay bildirimi iÃ§in yetkod\'un geÃ§erli olduÄu 5 dakika boyunca yetkilendirme-kodu endpointi ile sorgulama yaparak yetkod deÄerini alabilir. \n YÃS, "ODEME_EMRI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=O \n YÃS, "HESAP_BILGISI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=H \n Ä°STEK: \n YÃS, rÄ±za numarasÄ±nÄ± ve isteÄin ÃBH ya da HBH olmasÄ±na gÃ¶re deÄiÅen rÄ±za tipini parametre olarak istek talebine ekler. RÄ±za tipinin alabileceÄi deÄerler  TR.OHVPS.DataCode.RizaTip  sÄ±ralÄ± veri tiplerinde belirtilmiÅtir. \n HHS\'nin, yetkilendirme yÃ¶ntemi "AyrÄ±k Gkd" ise  rÄ±za numarasÄ± ile yetki kodu deÄerini dÃ¶nmesi beklenmektedir. YÃ¶nlendirmeli GKD iÃ§in bu endpoint "yetKod" deÄerini dÃ¶nmemelidir. YÃ¶nlendirmeli GKDâye ait bir rÄ±za no ile yetkilendirme kodu API kullanÄ±larak yet_kod alÄ±nmak istendiÄinde HHS tarafÄ±ndan  TR.OHVPS.Resource.NotFound  hatasÄ± verilmelidir. \n YANIT: \n HHS yanÄ±t nesnesi iÃ§erisinde, ÃHK\'ya ait yetki kodunu, rÄ±za no ve rÄ±za durumu ile birlikte YÃS\'e iletir. \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Yetki Kodu \n yetKod \n AN1..255 \n Z \n GKD sÃ¼recinde Ã¼retilen yetkilendirme kodudur. Tek kullanÄ±mlÄ±k olup, aynÄ± yetKod ile birden fazla token alÄ±namaz. yetKod Parametresinin yaÅam Ã¶mrÃ¼ 5 dakika olmalÄ±dÄ±r. \n \n \n RÄ±zaNo \n rizaNo \n AN1..128 \n Z \n RÄ±za nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n AyrÄ±k GKD sÃ¼recinde, yetkod deÄerini alan YÃS;

16 eriÅim belirteci API ile GKD sÃ¼recini tamamlar. \n EriÅim Belirteci API \n POST /erisim-belirteci \n Ä°STEK: \n YÃS erisim-belirteci eriÅim adresini 2 amaÃ§la kullanÄ±r: \n \n \n Bir Ã¶nceki adÄ±mdan aldÄ±ÄÄ± rizaNo, rizaTip (Ã¶deme emri baÅlatma hizmetinde âOâ, hesap bilgisi hizmetinde âHâ) ve GKD sonrasÄ± dÃ¶nÃ¼len yetKod bilgilerini kullanarak HHS nezdinde ErisimBelirteci nesnesi oluÅturmak Ã¼zere istekte bulunur. YÃSâÃ¼n istekte bulunabilmesi iÃ§in GKD adÄ±mÄ±nÄ±n baÅarÄ±lÄ± bir Åekilde tamamlanmasÄ± rizaDrm bilgisinin âyetkilendirildiâ olmasÄ± gerekir. EriÅim Belirteci nesnesi ile rÄ±zasÄ± nesnesi (Ãdeme Emri RÄ±zasÄ± veya Hesap Bilgisi RÄ±zasÄ±) arasÄ±ndaki iliÅki rÄ±za numarasÄ± Ã¼zerinden saÄlanÄ±r. \n \n \n AldÄ±ÄÄ± eriÅim belirtecinin GeÃ§erlilik SÃ¼resinin dolduÄu durumda, yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci almasÄ± gerekmektedir. \n \n \n POST /erisim-belirteci isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âErisimBelirteciIstegiâ nesnesi (Tablo-23) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âErisimBelirteciâ nesnesi (Tablo 24) oluÅturulur veya (Yenileme Belirteci iÃ§in) gÃ¼ncellenir. RÄ±za durumu âYetki KullanÄ±ldÄ±â olarak gÃ¼ncellenir. \n EriÅim Belirteci POST iÅlemi sonucunda HTTP 200 dÃ¶nÃ¼lmesi gerekmektedir. \n âErisimBelirteciIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±zaNo \n rizaNo \n AN1..128 \n Z \n RÄ±za nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n RÄ±za Tipi \n rizaTip \n AN1 \n Z \n O veya H (TR.OHVPS.DataCode.RizaTip) \n \n \n Yetki Tipi \n yetTip \n AN1..50 \n Z \n âyet_kodâ yada âyenileme_belirteciâ deÄerini alabilir.  (TR.OHVPS.DataCode.YetTip) \n \n \n Yetki Kodu \n yetKod \n AN1..255 \n K \n GKD iÅleminden dÃ¶nen yetkilendirme kodudur. Tek kullanÄ±mlÄ±k olup, aynÄ± yetKod ile birden fazla token alÄ±namaz. yetKod Parametresinin yaÅam Ã¶mrÃ¼ 5 dakika olmalÄ±dÄ±r. yetTip = âyet_kodâ ise zorunludur. \n \n \n Yenilenme Belirteci \n yenilemeBelirteci \n AN1..4096 \n K \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r. yetTip = âyenileme_belirteciâ ise kullanÄ±mÄ± zorunludur. \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âerisimBelirteciâ nesnesinde bulunan eriÅim belirteci deÄeri Ã¶deme emrinin baÅlatÄ±lmasÄ± esnasÄ±nda kullanÄ±lÄ±r. \n "ErisimBelirteci" nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n EriÅim Belirteci \n erisimBelirteci \n AN1..4096 \n Z \n Yetkilendirme Kodu karÅÄ±lÄ±ÄÄ±nda HHS tarafÄ±ndan dÃ¶nÃ¼len ve sonraki hesap bilgisi ve Ã¶deme emri servislerine eriÅimde kullanÄ±lan bilgidir. BÃ¶lÃ¼m 3.6 Karakter Kodlama   bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. Yenileme belirteci ile birden fazla eriÅim belirteci alÄ±nmasÄ± durumunda verilen tÃ¼m eriÅim belirteÃ§lerinin sÃ¼releri bitene kadar geÃ§erli olmalÄ±dÄ±r. \n \n \n GeÃ§erlilik SÃ¼resi \n gecerlilikSuresi \n N1..9 \n Z \n EriÅim Belirtecini saniye cinsinden geÃ§erlilik sÃ¼residir.  EriÅim belirteci geÃ§erli olduÄu son tarih ; Hesap Bilgisi RÄ±zasÄ± iÃ§in en fazla 30 gÃ¼n en az ise 1 gÃ¼n olmalÄ±dÄ±r.  EriÅimin GeÃ§erli OlduÄu Son Tarih(erisimIzniSonTrh); EriÅim Belirteci GeÃ§erlilik SÃ¼resi\'nden kÃ¼Ã§Ã¼k ise EriÅimin GeÃ§erli OlduÄu Son Tarih deÄeri ile sÄ±nÄ±rlÄ±dÄ±r. Ãdeme Emri RÄ±zasÄ± iÃ§in 5 dakika olmalÄ±dÄ±r. \n \n \n Yenileme Belirteci \n yenilemeBelirteci \n AN1..4096 \n Z \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r.   BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir.  Yenileme Belirteci ile EriÅim Belirteci isteÄi yapÄ±ldÄ±ÄÄ±nda HHS\'nin dÃ¶ndÃ¼ÄÃ¼ yanÄ±t iÃ§erisindeki yenilemeBelirteci deÄerini kesinlikle deÄiÅtirmemesi gerekmektedir.Yenileme belirteci rÄ±za sÃ¼resi boyunca gÃ¼ncellenmemelidir. \n \n \n Yenileme Belirteci GeÃ§erlik SÃ¼resi \n yenilemeBelirteciGecerlilikSuresi \n N1..9 \n Z \n Yenileme belirtecinin saniye cinsinden geÃ§erlilik sÃ¼residir. Yenileme belirtecinin geÃ§erli olduÄu son tarih ; Hesap Bilgisi iÃ§in EriÅimin GeÃ§erli OlduÄu Son Tarih ile sÄ±nÄ±rlÄ± olmalÄ±dÄ±r. Bu tarih geldiÄi zaman Hesap Bilgisi RÄ±za Durumunu âYetki SonlandÄ±rÄ±ldÄ±â statÃ¼sÃ¼ne Ã§ekilmesi gerekir. Ãdeme BaÅlatma iÃ§in RÄ±za OluÅturma ZamanÄ±ndan 15 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. 15 gÃ¼n sÃ¼resi sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. Ä°leri vadeli iÅlemler bu kapsamda deÄildir.  Ãdeme emri 5 dakika iÃ§inde gerÃ§ekleÅtirilmelidir. GerÃ§ekleÅmediÄinde 4.2.8 bÃ¶lÃ¼mÃ¼nde aktarÄ±lan rÄ±za statÃ¼ gÃ¼ncellemesi yapÄ±lmalÄ±dÄ±r. \n \n \n \n erisim-belirteci erisim noktasÄ±ndan elde edilen erisimBelirteci, iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda x-access-token alanÄ±nda iletilir. \n Yenilenme Belirteci (refreshToken) kullanÄ±larak EriÅim Belirteci (accessToken) alÄ±ndÄ±ÄÄ±nda, dÃ¶ne

16n yanÄ±ttaki Yenileme Belirteci GeÃ§erlik SÃ¼resi (yenilemeBelirteciGecerlilikSuresi) geÃ§en sÃ¼re eksiltilerek, kalan zamanÄ±n saniye cinsinden hesaplanmasÄ±yla iletilmelidir. \n EriÅim Belirteci API Ã§aÄrÄ±mÄ± sÄ±rasÄ±nda rÄ±za durumlarÄ± kontrol edilmelidir. Bu kontrollerin nasÄ±l yapÄ±lmasÄ± gerektiÄi 4-RÄ±za DurumlarÄ± bÃ¶lÃ¼mÃ¼nde aktarÄ±lmÄ±ÅtÄ±r. \n Yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda HHS\'nin dÃ¶ndÃ¼ÄÃ¼ hata yanÄ±tÄ±nda httpCode = 401 ve errorCode = "TR.OHVPS.Connection.InvalidToken" gelirse YÃS Ã¶nce rÄ±zanÄ±n durumu sorgulamalÄ±dÄ±r.  \nEÄer geÃ§erli bir rÄ±za ise; HHS veya YÃS tarafÄ±nda bir sorun olduÄu anlaÅÄ±lmalÄ±dÄ±r. Sistem tarafÄ±ndan hata Ã¼retilmeli ve sorun incelenmelidir. \nEÄer geÃ§erli bir rÄ±za deÄil ise YÃS tarafÄ±ndaki rÄ±za durumu gÃ¼ncellenmelidir. \n'},{title:"HHS ve YÃS API",frontmatter:{},regularPath:"/v1.1.0/contents/hhs-yos-api.html",relativePath:"v1.1.0/contents/hhs-yos-api.md",key:"v-9cc354c6",path:"/v1.1.0/contents/hhs-yos-api.html",headers:[{level:2,title:"HHS API",slug:"hhs-api"},{level:2,title:"YOS API",slug:"yos-api"}],content:" HHS ve YÃS API \n HHS API, HHSâlerin detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. HHS API iÃ§in âhhs_readâ scope bilgisi kullanÄ±lÄ±r. \n Production ortamÄ±nda HHS / YOS API iÃ§erisinde sisteme dahil olmuÅ, sertifikasyonu baÅarÄ± ile tamamlamÄ±Å paydaÅlar listelenecektir. HHS tarafÄ±ndan desteklenen API sÃ¼rÃ¼mleri listelenecektir. \n YÃSâler HHS APIâsini sorgulayabilir ancak YÃS APIâsini sorgulayamazlar. \nBenzer Åekilde HHSâler YÃS APIâsini sorgulayabilir, HHS APIâsini sorgulayamazlar. \n HHS API \n GET /hhs/{hhsKod} \n Ä°Ålem Sorgu ÃrneÄi =  /hhs  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m HHSâlerin dizi Åeklinde verileri listelenir. \nÄ°Ålem Sorgu ÃrneÄi =  /hhs/2001   â¨ bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan hhsKoduâna ait bilgiler listelenir. Ya da â404 Not Foundâ hatasÄ± alÄ±r. \nHHS ve YÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir. \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hhs?srlmKrtr=kod&srlmYon=A \n Tablo 20: HHS ve YÃS API Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âkodâ, âunvâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, sÄ±ralama kriteri âunvâ olarak belirlenmelidir. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 21: HHS Bilgileri Sorgulama YanÄ±tÄ± âHhsâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n hhs kodu \n kod \n AN4 \n Z \n HHS nin kod bilgisi \n \n \n hhs unvanÄ± \n unv \n AN3..140 \n Z \n HHS nin unvan bilgisi \n \n \n hhs markasÄ± \n marka \n AN1..140 \n Z \n ÃHK'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. HHS tarafÄ±ndan belirlenecektir. \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n HHSânin mesaj imzalama iÃ§in paylaÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n HHS Api Bilgileri \n apiBilgileri \n Kompleks: HhsApiBilgi[Array][0..N] \n Z \n Desteklenen Api ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > api \n api \n AN1..20 \n Z \n Api Ä°smi Ãrnek :obh, hbh,gkd \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s2.0 s1.0 \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n HHS'ye ait logo bilgileri. \n \n \n > logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n HHS tarafÄ±nda tutulan ve YÃS'lerle paylaÅÄ±lacak olan url adres bilgisidir.  Ãrnek: https://via.placeholder.com/150?text=0001 \n \n \n > logoArkaPlan \n logoArkaPlan \n AN1 \n Z \n TR.OHVPS.DataCode.LogoArkaPlan sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoFormat \n logoFormat \n AN3 \n Z \n TR.OHVPS.DataCode.LogoFormat sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n AyrÄ±k GKD \n ayrikGKD \n AN1 \n Z \n HHS'nin AyrÄ±k GKD desteklediÄini BKM'ye bildirmesi

16ile bu alan E deÄerini alÄ±r.  TR.OHVPS.DataCode.EvetHayir sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n Durum \n durum \n AN1 \n Z \n HHS'nin durum bilgisidir.  TR.OHVPS.DataCode.HHSDurumu sÄ±ralÄ± veri tipinde alabileceÄi deÄerler belirtilmiÅtir. \n \n \n \n HHS API'de; AÃ§Ä±k, YaygÄ±nlaÅtÄ±rma, GeÃ§ici Hizmet Veremiyor, KapalÄ± durumlarÄ±ndaki HHS'ler listelenecektir.  \nSertifikasyon onayÄ± alan HHS'ler, Ã¼retim ortamÄ±na geÃ§iÅte \"YaygÄ±nlaÅtÄ±rma\" durumuna sahip olabilir.  HHS'nin, hangi YÃS'ler ile \"YaygÄ±nlaÅtÄ±rma\" kontrollerini yapacaÄÄ±, HHS yÃ¶netiminde olacaktÄ±r. BÃ¶ylece Ãretim OrtamÄ±nda HHSânin kendisi tarafÄ±ndan tanÄ±mlanmÄ±Å kÄ±sÄ±tlÄ± ÃHKâya hizmet vermesi ve servislerini test etmesi saÄlanabilir olacaktÄ±r. HHS'ler kendi kurum kontrollerini yapana kadar, \"YaygÄ±nlaÅtÄ±rma\" durumunda kalabilirler. HHS'nin BKM'ye yapacaÄÄ± talep ile, HHS \"YaygÄ±nlaÅtÄ±rma\" durumundan \"AÃ§Ä±k\" durumuna geÃ§ebilecektir. \n AÅaÄÄ±daki durumlarda HHS'nin statÃ¼sÃ¼ GeÃ§ici KapalÄ± olarak gÃ¼ncellenebilecektir: \n \n HHS'nin talebi ile uzun sÃ¼reli (minimum 1 saati aÅan) yaÅanan teknik sorunlarda G statÃ¼sÃ¼ne alÄ±nabilecektir. G statÃ¼sÃ¼ne alÄ±nma talebinin HHS tarafÄ±ndan [email protected] ye mail atarak iletilmesi beklenmektedir. \n Ä°lgili resmi kurumlardan gelen talep Ã¼zerine HHS G statÃ¼sÃ¼ne alÄ±nabilir. \n \n YÃS'ler hem A hem G statÃ¼sÃ¼nde olan HHS'leri listeleyebilir. Ancak YÃS uygulamasÄ±nda G statÃ¼sÃ¼nde olan bir HHS mÃ¼Återi tarafÄ±ndan seÃ§ilirse mÃ¼Återiye gerekli hata mesajÄ±nÄ±n verilmesi ve ilgili HHS'ye istek atÄ±lmamasÄ± saÄlanmalÄ±dÄ±r. \n Hem YOS hem de HHS API iÃ§in geÃ§erli olacak; logo gÃ¶nderiminde dikkat edilmesi gerekenler Åu Åekilde tariflenmiÅtir: \n \n LogolarÄ±n ham dosya yerine kurumun yayÄ±nlayacaÄÄ± bir URL Ã¼zerinden sunulmasÄ± gerekmektedir. (Ãrn: logoURL = https://kurumadi.com.tr/logo.png) Logo BKM tarafÄ±nda host edilmeyecektir. \n Logo urlâin public eriÅilebilir url olmasÄ± gereklidir. \n Logo, yatayda veya dikeyde taÅma paysÄ±z tam oturacak, sÄ±nÄ±r boyutlarÄ±nÄ± geÃ§meyecek ve ortalanmÄ±Å yerleÅime sahip olmalÄ±dÄ±r. \n YÃS uygulamasÄ±nda gÃ¶sterim esnasÄ±nda logolarÄ±n hÄ±zlÄ± yÃ¼klenmesi ve dÃ¼ÅÃ¼k veri tÃ¼ketmesi aÃ§Ä±sÄ±ndan; logo boyutu 250 KBâÄ±n altÄ±nda olmalÄ±dÄ±r. \n HHS ve YÃSâlerin tÃ¼m logo tÃ¼rlerini (8 farklÄ± tipte logoyu) zorunlu olarak dÃ¶nmesi beklenmektedir. \n Circle logo kullanÄ±lmasÄ± gerektiÄinde ICON_LOGO logo tÃ¼rÃ¼ kullanÄ±lmalÄ±dÄ±r. \n LogolarÄ±nÄ± gÃ¼ncellemek isteyen kurumlarÄ±n en az 3 iÅ gÃ¼nÃ¼ Ã¶ncesinde BKMâye bu deÄiÅikliÄi GEÃÄ°T Test/Ãretim OrtamÄ± Entegrasyon formu ile bildirmesi gereklidir.  BKM de katÄ±lÄ±mcÄ±lara HHS/YÃS API aracÄ±lÄ±ÄÄ± ile gÃ¼ncel logonun Ã§ekilmesi gerektiÄine dair bilgilendirme yapar. \n LogolarÄ± anlÄ±k Ã§eken katÄ±lÄ±mcÄ±larÄ±n, herhangi bir teknik nedenden dolayÄ± gÃ¼ncel logoyu alamadÄ±ÄÄ± durum olabilir. Bu durumda sistemlerine kaydetmiÅ olduÄu kuruma ait ikon logoyu gÃ¶stermesi gereklidir. \n HHS ve YÃSâler API aracÄ±lÄ±ÄÄ± ile almÄ±Å olduklarÄ± logolarÄ±n formatÄ± Ã¼zerinde deÄiÅiklik (kare, yuvarlak hale getirip resize etmek gibi) yapabilirler. Ancak logonun gÃ¶rsel ve yazÄ±larÄ±nÄ± etkileyecek bir  deÄiÅiklik yapmamalÄ±dÄ±rlar. \n YÃS/HHS mobil uygulamasÄ±ndaki dark mode ve light mode kullanÄ±mlarÄ±nda, hangi logonun kullanÄ±lacaÄÄ±na uygulama sahibi karar verecektir. \n YOS API \n YÃS API, YÃS statÃ¼sundeki kurumlarÄ±n detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. YÃS API iÃ§in âyos_readâ scope bilgisi kullanÄ±lÄ±r. \n YÃS API yanÄ±tÄ±nda, listelenen yÃ¶nlendirme ve bildirim adresleri bulunmaktadÄ±r. HHS, iÅlem anÄ±nda iletilen yonAdr ya da bldrAdr alanlarÄ±nda gÃ¶nderilen adreslere yetKod deÄerini iletmelidir. YÃS API iÃ§erisinde yer alan adresleri, rÄ±za isteÄinde gÃ¶nderilen adreslerin doÄruluÄunu kontrol etme amacÄ±yla kullanÄ±lmalÄ±dÄ±r. Bu nedenle YÃS API iÃ§erisinde listelenen adreslerin hostname seviyesinde yer almasÄ± yeterlidir. \n YÃS API iÃ§erisinde yer alan YÃS rol bilgileri ve aktiflik/pasiflik durumlarÄ± birbiriyle iliÅkili deÄildir. \n YÃS'Ã¼n sahip olduÄu Ã¶bhs,hbhs rolleri iÃ§in herhangi bir fraud ya da teknik sebeplerden Ã¶tÃ¼rÃ¼ geÃ§ici sÃ¼reyle geri alÄ±nabilir. \n YÃS'lerin hizmet verememesi durumunda rollerinin ger

16i alÄ±nmasÄ± yapÄ±lmayacaktÄ±r. YÃS rolleri sadece ilgili resmi kurumlardan gelen talep Ã¼zerine alÄ±nabilecektir. \n YÃS aktifliÄini korurken problem Ã§Ã¶zÃ¼lene kadar geÃ§ici olarak alÄ±nan roller(Ã¶bhs,hbhs) tekrardan aktif hale getirilir. \n GET /yos/{yosKod} \n Ä°Ålem Sorgu ÃrneÄi =  /yos  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m YÃS'lerin dizi Åeklinde verileri listelenir. \n Ä°Ålem Sorgu ÃrneÄi =  /yos/2501  â¨  bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan yosKoduâna ait bilgiler listelenir ya da â404 Not Foundâ hatasÄ± alÄ±r.\nYÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir.\nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /yos?srlmKrtr=kod&srlmYon=A \n Tablo 22: YOS Bilgileri Sorgulama YanÄ±tÄ± âYosâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n YÃ¶s kodu \n kod \n AN4 \n Z \n YÃS'Ã¼n kod bilgisi \n \n \n YÃ¶s unvanÄ± \n unv \n AN3..140 \n Z \n YÃS unvan bilgisi \n \n \n YÃ¶s markasÄ± \n marka \n AN1..140 \n Z \n ÃHK'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. YÃS tarafÄ±ndan belirlenecektir. \n \n \n YÃS rolleri \n roller \n Array[AN4] \n Z \n YÃSâun rollerini belirten deÄer. Ãrnek: [ \"obhs\", \"hbhs\" ]  - obhs - Ãdeme Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼  - hbhs - Hesap Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼ \n \n \n Adresler \n adresler \n Kompleks:Adres[Array] [1..N] \n Z \n --- \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. Adres detaylarÄ±nÄ±n hangi GKD tÃ¼rÃ¼ne ait olduÄunu belirtir. \n \n \n > Adres DetaylarÄ± \n adresDetaylari \n adresDetaylari\tKompleks: AdresDetayi[Array] [1..N] \n Z \n \n \n \n >> Temel Adres \n tmlAdr \n AN1..1024 \n Z \n yetYntm deÄeri âYâ olarak iletildiÄinde YÃ¶nlendirmeli GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. yetYntm deÄeri âAâ olarak iletildiÄinde AyrÄ±k GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. Riza isteklerinde bu deÄer ile uyumluluÄu kontrol edilmelidir. Ãrnek: https://example.com https://example2.com/path deepLink://example/test deepLink://example2/test \n \n \n >> AÃ§Ä±klama \n aciklama \n AN1..1024 \n Ä° \n YÃSâÃ¼n gÃ¶nderdiÄi adrese yÃ¶nelik vermek istediÄi aÃ§Ä±klama Ãrnek: WEB bireysel , WEB kurumsal  , APP \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n YÃSâÃ¼n mesaj imzalama iÃ§in paylaÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n YÃS Api Bilgileri \n apiBilgileri \n Kompleks: YosApiBilgi[Array][0..N] \n Z \n Desteklenen Api ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > api \n api \n AN1..20 \n Z \n Api Ä°smi Ãrnek :ods \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s2.0 s1.0 \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n YOSâe ait logo bilgileri. \n \n \n > logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n YÃS tarafÄ±nda tutulan ve HHSâlerle paylaÅÄ±lacak olan url adres bilgisidir.  Ãrnek: https://via.placeholder.com/150?text=0001 \n \n \n > logoArkaPlan \n logoArkaPlan \n AN1 \n Z \n TR.OHVPS.DataCode.LogoArkaPlan sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoFormat \n logoFormat \n AN3 \n Z \n TR.OHVPS.DataCode.LogoFormat sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n Durum \n durum \n AN1 \n Z \n YÃS'Ã¼n durum bilgisidir.  TR.OHVPS.DataCode.YOSDurumu sÄ±ralÄ± veri tipinde alabileceÄi deÄerler belirtilmiÅtir. \n \n \n \n"},{title:"7.\tHesap Bilgisi Hizmeti",frontmatter:{},regularPath:"/v1.1.0/contents/hesap-bilgisi-hizmeti.html",relativePath:"v1.1.0/contents/hesap-bilgisi-hizmeti.md",key:"v-553c6446",path:"/v1.1.0/contents/hesap-bilgisi-hizmeti.html",headers:[{level:2,title:"Genel Bilgiler",slug:"genel-bilgiler"},{level:2,title:"Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri",slug:"hesap-bilgisi-hizmeti-icin-erisim-adresleri"}

16,{level:2,title:"ADIM 0: ÃHK'nÄ±n hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:",slug:"adim-0-ohk-nÄ±n-hesap-bilgilerine-erisim-icin-talepte-bulunmasÄ±"},{level:2,title:"7.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_7-1-adim-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:3,title:"POST /hesap-bilgisi-rizasi",slug:"post-hesap-bilgisi-rizasi"},{level:3,title:"BaÅarÄ±lÄ± Ä°stek:",slug:"basarÄ±lÄ±-istek"},{level:3,title:"BaÅarÄ±lÄ± YanÄ±t:",slug:"basarÄ±lÄ±-yanÄ±t"},{level:2,title:"Ä°zinler",slug:"izinler"},{level:2,title:"7.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi",slug:"_7-2-adim-2-hesap-bilgisi-hizmeti-rÄ±zasÄ±nÄ±n-tesisi"},{level:2,title:"7.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ±",slug:"_7-3-adim-2-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±"},{level:2,title:"7.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali",slug:"_7-4-adim-2-2-hesap-bilgisi-rÄ±zasÄ±nÄ±n-iptali"},{level:2,title:"7.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ±",slug:"_7-5-adim-3-hesap-bilgilerinin-alÄ±nmasÄ±"},{level:2,title:"7.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ±",slug:"_7-6-adim-3-1-ve-3-2-hesap-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"7.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ±",slug:"_7-7-adim-3-3-ve-3-4-hesap-bakiyesinin-sorgulanmasÄ±"},{level:2,title:"7.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ±",slug:"_7-8-adim-3-5-ve-3-6-islemlerin-sorgulanmasÄ±"}],content:" 7.\tHesap Bilgisi Hizmeti  \n Genel Bilgiler \n Hesap bilgisi sorgulama iÃ§in HBHS tarafÄ±ndan mÃ¼Återi rÄ±zasÄ± tesisinin HHS tamamlanmÄ±Å olmasÄ± gerekir. MÃ¼Återi rÄ±zasÄ± tesisi tamamlandÄ±ktan sonra, HBHS sorgulamak istediÄi hesaba ait verileri ilgili eriÅim adresi Ã¼zerinden sorgular. \n \n \n Åekil 10: Hesap Bilgisi Hizmeti Ãst DÃ¼zey AkÄ±ÅÄ± \n Åekil-10âda sunulan hesap bilgisi hizmeti 5 temel akÄ±Åtan oluÅur: \n 0.\tMÃ¼Återinin hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:  ÃHK ÃBHS mobil uygulama ya da web sitesinden hesap bilgilerine eriÅim iÅlemini baÅlatÄ±r. \n 1.\tHesap Bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n hazÄ±rlanmasÄ±: \n HBHS, âhesap bilgilerine eriÅimâ iÃ§in mÃ¼Återi rÄ±zasÄ± tesisi amacÄ±yla HHSâdeki hesap bilgisi rÄ±zasÄ± eriÅim adresine bir POST isteÄinde bulunur ve bir hesap bilgisi rÄ±zasÄ± nesnesi oluÅturur. HHS hesap bilgisi rÄ±zasÄ± nesnesi iÃ§in biricik tanÄ±mlayacÄ± dÃ¶ner (RÄ±zaNo). Hesap bilgisi rÄ±zasÄ±, mÃ¼Återinin HBHSânin hesap bilgilerine eriÅim izin verdiÄi alanlarÄ± iÃ§erir: \n \n Ä°zinler - eriÅim iÃ§in izin verilen veri kÃ¼melerinin listesi. \n EriÅimin GeÃ§erli OlduÄu Son Tarih - HBHS'nin mÃ¼Återinin hesap bilgilerine eriÅebileceÄi isteÄe baÄlÄ± seÃ§ilebilen son tarih. \n Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± â MÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden itibaren geriye dÃ¶nÃ¼k olarak HBHSânin hesap bilgilerine eriÅebileceÄi sÃ¼reyi \n Ä°Ålem Sorgulama BitiÅ ZamanÄ± - MÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden itibaren ileriye dÃ¶nÃ¼k olarak HBHSânin hesap bilgilerine eriÅebileceÄi sÃ¼reyi \n \n 2.\tHesap bilgisi hizmeti mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi: \n HHS, Hesap Bilgisi RÄ±zasÄ± servisi ile ÃHK Ã¶zelinde âYetki bekleniyorâ statÃ¼sÃ¼nde bir rÄ±za nesnesi hazÄ±rlar. HHS, GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda hesap bilgisi rÄ±zasÄ± nesnesinin yetkilendirildiÄini belirtmek iÃ§in RÄ±za Durumunu âRÄ±za Yetkilendirildiâ olarak gÃ¼nceller. Nesne yetkilendirildikten sonra HHS nesne ile bir eriÅim belirteci (access token) iliÅkilendirir, RÄ±za Durumunu âYetki KullanÄ±ldÄ±â yapar ve bu belirteci HBHSâye geri dÃ¶ner.  BÃ¶ylece mÃ¼Återi rÄ±za tesisi saÄlanmÄ±Å olur. \n Hesap bilgisi iÃ§in mÃ¼Återi rÄ±zasÄ±na iliÅkin temel ilkeler ÅunlardÄ±r: \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de Yetki Bekleniyor, Yetkilendirildi, Yetki KullanÄ±ldÄ± statÃ¼sÃ¼nde 1 rÄ±zasÄ± olabilir. \n MÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± ÃHK ile HBHS arasÄ±nda belirlenir. Bu nedenle mÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± HHS ekranÄ±nda deÄiÅtirilmemelidir. \n ÃHK, hesap eriÅim izni ayrÄ±ntÄ±larÄ±nÄ± yalnÄ±zca bir bÃ¼tÃ¼n olarak yetkilendirebilir veya geri alabilir. \n MÃ¼Återi rÄ±zasÄ± tesisi esnasÄ±nda, mÃ¼Återi HHS arayÃ¼zÃ¼nde eriÅim iÃ§in yetkilendirecek hesaplarÄ± seÃ§er. \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN hizmeti sunmayabildikleri iÃ§in hesap referansÄ± ile akÄ±ÅlarÄ±nÄ± kurgulayabilirler. YÃS Ã¶nyÃ¼zlerinde yapÄ±lan bilgilendirmelerde, IBAN harici hesap referansÄ± ile iÅlem yapÄ±labilmesine dikkat edilmelidir. \n \n 2.1\tHesap bilgisi rÄ±zasÄ±nÄ±n sorgulanmasÄ±:  MÃ¼Återi rÄ±zasÄ±  GET/hesap-bilgisi-rizasi/{RizaNo}  Ã§aÄrÄ±sÄ± yapÄ±larak sorgulanÄ±r. \n 2.2\tHesap bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n iptali:  MÃ¼Återi rÄ±zasÄ±  DELETE/hesap-bilgisi-rizasi/{RizaNo}

16  Ã§aÄrÄ±sÄ± yapÄ±larak iptal edilir. \n 3.\tHesap bilgilerinin alÄ±nmasÄ±:  Hesap bilgileri ilgili kaynaÄa (hesaplar, bakiye, iÅlemler) GET isteÄi yapÄ±larak gerÃ§ekleÅtirilir. HBHS, mÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden sonrasÄ±nda (geÃ§erli bir eriÅim belirticine sahip olduÄunda) Ã¶ncelikle  GET/hesaplar  Ã§aÄrÄ±sÄ± yapacaktÄ±r. \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±) mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin HBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini (Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n hesap-bilgisi-rizasi \n POST \n /hesap-bilgisi-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n HesapBilgisiRizasiIstegi \n HesapBilgisiRizasi \n \n \n 2 \n erisim-belirteci  (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n \n HesapBilgisiRizasi \n \n \n 2.2 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n \n \n \n \n \n \n 3.1 \n hesaplar \n GET \n /hesaplar \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n HesapBilgileri(birden Ã§ok hesap) \n \n \n 3.2 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n HesapBilgileri(tek  hesap) \n \n \n 3.3 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n BakiyeBilgileri(tek  hesap) \n \n \n 3.4 \n bakiye \n GET \n /bakiye \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n BakiyeBilgileri(birden Ã§ok hesap) \n \n \n 3.5 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n IslemBilgileri (tek hesap) \n \n \n \n Tablo 11: Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n ADIM 0: ÃHK'nÄ±n hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±: \n ÃHK, HBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) hesap bilgilerine eriÅim iÃ§in talepte bulunur. \n 7.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n Bu API Ã§aÄrÄ±sÄ± HBHS'nin HHS'de yeni bir âHesapBilgisiRizasiâ nesnesi oluÅturmasÄ±nÄ± ve nesneye eriÅmek iÃ§in benzersiz bir rÄ±za numarasÄ± ({RizaNo}) dÃ¶nÃ¼lmesini saÄlar. \n API Ã§aÄrÄ±sÄ±nÄ±n baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± yeterlidir.\nBaÅarÄ±yla oluÅturulan hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n rÄ±za durumu âYetki Bekleniyorâ olarak dÃ¼zenlenir.\nÃHK daha Ã¶nce aldÄ±ÄÄ± rÄ±zaya iliÅkin eriÅim tarihleri, izin tÃ¼rlerini ve hesap bilgilerini gÃ¼ncellemek isterse, HBHS Ã¶nce HHS nezdindeki rÄ±zayÄ± iptal etmeli ve sonrasÄ±nda yeni bir rÄ±za talebinde bulunmalÄ±dÄ±r.\n \n \n Åekil 11: Hesap Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n SÃ¼rÃ¼m 1.1.0 iÃ§in POST /hesap-bilgisi-rizasi isteÄinde 06- AnlÄ±k Bakiye Bildirimi izin tÃ¼rÃ¼ iÃ§in YÃSâÃ¼n BAKÄ°YE kaynak tipinde olay abonelik kaydÄ±nÄ±n olmasÄ± gerekmektedir. BAKÄ°YE kaynak tipinde olay abonelik kaydÄ± olmayan YÃS kurumu ; sÃ¼rÃ¼m 1.1.0 iÃ§in 06 izin tÃ¼rÃ¼nÃ¼ kapsayan Hesap Bilgisi RÄ±zasÄ± isteÄi gÃ¶nderdiÄinde HHS tarafÄ±ndan  TR.OHVPS.Business.EventSubscriptionNotFound  hatasÄ± verilmeli ve rÄ±za oluÅturulmamalÄ±dÄ±r. \n \n \n POST /hesap-bilgisi-rizasi isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âHesapBilgisiRizasÄ±Istegiâ nesnesi (Tablo-12) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âHesapBilgisiRizasiâ (Tablo-13) nesnesi oluÅturulur. \n  POST /hesap-bilgisi-rizasi \n BaÅarÄ±lÄ± Ä°stek: \n Ä°STEK: \n HBHS, bu API eriÅim adresinden HHSâye yeni bir HesapBilgisiRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n HBHS, ÃHKânÄ±n hesap bilgilerine yÃ¶nelik rÄ±za baÅlatma isteÄi olduÄunu HHSâye bildirir. \n HBHS, ÃHKânÄ±n, HBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n API dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk ve uzunluk kontrollerini y

16apar. (Zorunlu) \n HHS; YÃS API ile alÄ±nan HBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme adresleri ile hesap bilgisi rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) \n HHS; kimlik bilgileri nesnesinde iletilen kimlik bilgileri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (Zorunlu) \n EriÅimin GeÃ§erli OlduÄu Son Tarih, Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, Ä°Ålem Sorgulama BitiÅ ZamanÄ± alanlarÄ± ile ilgili Tablo 12âde belirtilen kontroller yapÄ±lmalÄ±dÄ±r. (Zorunlu) \n HHS, benzersiz âRizaNoâ ile âHesapBilgisiRizasiâ nesnesi oluÅturur ve HBHSâye dÃ¶ner. \n HHS, HesapBilgisiRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n \n EriÅimin GeÃ§erli OlduÄu Son Tarih, Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, Ä°Ålem Sorgulama BitiÅ ZamanÄ± alanlarÄ±nda zaman aralÄ±klarÄ± mÃ¼Återi deneyimi penceresinden deÄerlendirilerek ay cinsinden belirtilmiÅtir. Bu konuda aÅaÄÄ±daki gibi oluÅabilecek uÃ§ Ã¶rneklere dikkat edilmesi gerekmektedir. \n Yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saatinin 00:00:00 olduÄu kabul edilmiÅtir. \n BugÃ¼n : 31.08.2019 \nBugÃ¼n + 6 Ay : 01.03.2020 00:00:00 (29.02.2020 tÃ¼m gÃ¼n dahildir.) \nBugÃ¼n : 30.08.2020 \nBugÃ¼n + 6 Ay : 01.03.2020 00:00:00 (28.02.2021 tÃ¼m gÃ¼n dahildir.) \nBugÃ¼n : 30.09.2022 \nBugÃ¼n + 3 Ay : 01.01.2023 00:00:00 (30.12.2022 tÃ¼m gÃ¼n dahildir.) \nBugÃ¼n : 14.07.2022 \nBugÃ¼n + 3 Ay : 15.10.2022 00:00:00 (14.10.2022 tÃ¼m gÃ¼n dahildir.) \n Tablo 12: âHesapBilgisiRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. Hata durumunda TR.OHVPS.Connection.InvalidASPSP hata kodunu dÃ¶ner. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda TR.OHVPS.Connection.InvalidTPP hata kodunu dÃ¶ner. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Yetkilendirme yÃ¶ntemi, HBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.   Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.OHKTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r.   TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n \n Hesap Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n \n >Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih.   MÃ¼Återi YÃS ekranÄ±ndan bu deÄeri belirleyebilir.   VarsayÄ±lan deÄer : RÄ±za verilen tarih + 6 ay   AlabileceÄi maksimum deÄer : RÄ±za tarihi + 6 ay    AlabileceÄi minimum deÄer : RÄ±za tarihi + 1 gÃ¼n    ÃrneÄin  04/02/2023âde minimum 05/02/2023 seÃ§ilebilir. Bu durumda yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saati 00:00:00 olduÄu kabul edildiÄi iÃ§in; erisimIzniSonTrh deÄeri 2023-02-06T00:00:00+03:00 olmalÄ±dÄ±r.  HHS rÄ±za onay ekranlarÄ±nda YÃS'ten iletilen eriÅim izni son tarihi yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saati olarak iletildiÄinden ÃHK'ya gÃ¶sterilecek tarih eriÅim izninin biteceÄi gÃ¼n olarak gÃ¶sterilmelidir.  ÃrneÄe istinaden; ÃHK YÃSâde 05/02/2023 seÃ§miÅ ise HHS rÄ±za onay ekranÄ±nda 06/02/2023 gÃ¶rmemeli, bu iki tarihin aynÄ±, yani 05/02/2023 olacak Åekilde gÃ¶sterilmesi gerekmektedir.      Ãrnek rÄ±za oluÅ zamanÄ±  : 2023-02-04T21:20:20+03:00    1 gÃ¼nlÃ¼k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri:    2023-02-06T00:00:00+03:00 (26 saat 40 sakikalÄ±k rÄ±za vermiÅ oluyor.)    7 gÃ¼nlÃ¼k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri:  2023-02-12T00:00:00+03:00    1 aylÄ±k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri :   2023-03-05-T00:00:00+03:00 \n Bu alanda bir deÄer bulunmadÄ±ÄÄ± durumda HHS hata dÃ¶nmelidir. \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geÃ§miÅe dÃ¶nÃ¼k en fazla 12 ay olabilir, daha eski olmamasÄ± gerekir.   VarsayÄ±lan deÄeri rÄ±za verilen tarih (iÅlem zamanÄ±) â 12 aydÄ±r.   ÃHK bu alana bir deÄer giriÅi saÄlamÄ±Å ise zaman bilgisi Ã¼retilirken ekrandan girilen tarihe 00:00:00 zaman bilgisi eklenmelidir. ÃHK deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.   Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  - 12 ay    Maksimum tarih: RÄ±zanÄ±n veriliÅ tarihi +  12 ay    Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve  Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geleceÄe dÃ¶nÃ¼k en fazla 12 ay sonrasÄ± olabilir, daha ileri bir tarih olmamasÄ± gerekir.   VarsayÄ±lan deÄeri: RÄ±za verilen tarih + 12 aydÄ±r. ÃHK bu alana bir deÄer giriÅi saÄlamÄ±Å ise girdiÄi tarihe 1 gÃ¼n eklenir ve yeni gÃ¼nÃ¼n ilk saati kabul edilen 00:00:00 saat bilgisini ekler.  ÃHK bu alana bir deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.  Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  â 12 ay  Maksimum tarihi :  RÄ±zanÄ±n veriliÅ tarihi + 12 ay   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. EÄer dolu gÃ¶nderilirse HHS tarafÄ±ndan uygun hata mesajÄ± iletilmelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve Ä°Ålem Sorgulama BitiÅ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez.   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n BaÅarÄ±lÄ± YanÄ±t: \n Tablo 13: HesapBilgisiRizasi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. Ãrn; hesap bilgi rÄ±zasÄ±nÄ±n tesisine dair ilk istek mesajÄ±na dÃ¶nÃ¼Åte âB: Yetki Bekleniyorâ deÄerini almasÄ± beklenir. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄ

16u durumda zorunludur. \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir.  TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde\tGKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.  HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir. RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Hesap Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n > Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HBHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi baÅlangÄ±Ã§ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi bitiÅ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n > AyrÄ±ntÄ± Bilgi \n ayrBlg \n Kompleks: AyrintiBilgi \n Ä° \n \n \n \n > ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n Ä°zinler \n Bir hesap bilgisi mÃ¼Återi rÄ±zasÄ± kaynaÄÄ± Ã§aÄrÄ±sÄ±na yanÄ±t olarak dÃ¶ndÃ¼rÃ¼len verileri sÄ±nÄ±rlamak iÃ§in izin kodlarÄ± kullanÄ±lÄ±r: \n \n Temel Hesap Bilgisi \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n Bakiye Bilgisi \n Temel Ä°Ålem (Hesap Hareketleri) Bilgisi \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n AnlÄ±k Bakiye Bildirimi \n \n ÃHKâya sunulacak seÃ§imler ve kurallarÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r. \n \n \n \n SeÃ§im \n Kural \n \n \n \n \n Temel Hesap Bilgisi \n ÃHK seÃ§imine sunulmamalÄ±dÄ±r. DeÄiÅtirilemez Åekilde seÃ§ili gÃ¶sterilmelidir. \n \n \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Bakiye Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Temel Ä°Ålem (Hesap Hareketleri)  Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n ÃHK seÃ§im yapabilir. AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi seÃ§imi Temel Ä°Ålem Bilgisi seÃ§imini kapsar. (AyrÄ±ntÄ±lÄ± Ä°Ålem bilgisi seÃ§ildiÄinde Temel Ä°Ålem Bilgisi de seÃ§ili olmalÄ±dÄ±r.) \n \n \n AnlÄ±k Bakiye Bildirimi \n Bakiye Bilgisi izin tÃ¼rÃ¼ ile birlikte seÃ§ilmesi gereklidir. ÃHK, HHS'de olacak bakiye deÄiÅikliklerinden anlÄ±k haberdar olmak istiyor ise bu izin tÃ¼rÃ¼ seÃ§imi ile rÄ±za baÅlatmasÄ± gereklidir. \n \n \n \n AÅaÄÄ±daki durumlarda, izin kombinasyonlarÄ±na izin verilmez. HHS, bu hesap eriÅim onaylarÄ±nÄ± 400 (HatalÄ± Ä°stek) yanÄ±t ko

16duyla reddetmelidir: \n \n Ä°zin dizisinin herhangi bir izin tÃ¼rÃ¼ iÃ§ermemesi durumu, \n Ä°zin dizisinde HHS tarafÄ±ndan desteklenmeyen bir izin kodunun yer almasÄ± durumu \n 7.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi \n \n \n Åekil 12: Hesap Bilgisi ÃHK RÄ±zasÄ±nÄ±n Tesisi \n RÄ±za tesisinin baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± ve ardÄ±ndan mÃ¼Återinin HHS tarafÄ±ndan yÃ¶nlendirmeli veya ayrÄ±k GKD ile doÄrulanmasÄ± gerekir. HHS'de oluÅturulan ve rÄ±za durumu âYetki Bekleniyorâ olan bir hesap bilgisi rÄ±zasÄ±, GKD sonrasÄ± âYetkilendirildiâ statÃ¼sÃ¼ne gÃ¼ncellenir. HBHS, eriÅim saÄlayacaÄÄ± hesaplarÄ± hesap bilgisi rÄ±zasÄ±nÄ±n tesisinden Ã¶nce seÃ§er. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda, HBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n \n HBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n \n \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n ÃHKâyÄ± doÄrularsa, \n \n \n ÃHK HBHS Ã¼zerinden iÅlem yapÄ±lmasÄ±na izin vereceÄi hesap seÃ§imini, hesap numarasÄ± ya da hesap referansÄ± bilgisi ile yapar. HBHS Ã¼zerinden ÃHKânÄ±n verdiÄi izin bilgilerini ve eriÅim izninin bitiÅ tarihi bilgilerini, HHS bilgilendirme amaÃ§lÄ± ÃHKâya gÃ¶sterir. \n \n \n HHS hesap bilgisiri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=H&drmKod=zzz\n \n \n \n ÃHKâyÄ± doÄrulayamazsa, \n \n \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I &rizaNo=yy&rizaTip=H&rizaIptDtyKod=11&drmKod=zzz\n \n \n \n \n \n \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda, HHS, ÃHKânÄ±n hesap bilgisi hizmetini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister. \n \n AyrÄ±k akÄ±Å HBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek hesap bilgisi rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, Ã¶deme hizmeti kullanÄ±cÄ±sÄ±nÄ± doÄrular. \n ÃHK verdiÄi izin tipi dahilinde bilgileri paylaÅÄ±lacak olan hesaplarÄ± seÃ§er. \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS,  hesap bilgisi rÄ±zasÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. RÄ±za tesisi saÄlanmÄ±Å olur. \n 7.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ± \n GET /hesap-bilgisi-rizasi/{RizaNo} \n ÃHK, HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir veya ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.  Bu durumlarda HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir HesapBilgisiRizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 13âde belirtilen âHesapBilgisiRizasiâ nesnesini dÃ¶nmektedir. \n Durum \nHesapBilgisiRizasi kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n \n Yetki Bekleniyor \n \n \n Yetkilendirildi \n \n \n Yetki KullanÄ±ldÄ± \n \n \n Yetki SonlandÄ±rÄ±ldÄ± \n \n \n Yetki Ä°ptal \n \n \n Hesap bilgisi rÄ±zasÄ± sonlandÄ±rÄ±ldÄ± ve iptal statÃ¼sÃ¼nde olan rÄ±za'larÄ±n gÃ¼ncellenme zamanÄ±ndan(gnclZmn) 6 ay sonrasÄ±na kadar sorgulanabilir olmasÄ± beklenmektedir. HHS'ler ilgili sÃ¼re sonrasÄ±nda yapÄ±lacak rÄ±za sorgularÄ±na TR.OHVPS.Resource.NotFound uyarÄ±sÄ± verebilir. YÃS'ler tarafÄ±ndan iptal ve sonlandÄ±rÄ±ldÄ± statÃ¼sÃ¼nde olan rÄ±zalar iÃ§in sorgulama yapmamalÄ±dÄ±r. \n 7.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali \n \n \n \n Åekil 13: Hesap Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n Geri AlÄ±nmasÄ± \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \n DELETE /hesap-bilgisi-rizasi Ã§aÄrÄ±sÄ±, bir HBHS'nin Ã¶nceden oluÅturulmuÅ bir hesap eriÅim rÄ±zasÄ±nÄ± (yetkili olsun veya olmasÄ±n) silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, HBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \nBu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin HBHS Ã¼zerinden hesap bilgisi rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki hesap bilgisi rÄ±zasÄ± nesnesinin silinmesini saÄlar. \nMÃ¼Återinin HBHSânin veri eriÅim iznini iptal etmesi durumunda HBHS, HHSâde mevcut olan HesapBilgisiRizasi kaynaÄÄ±nÄ± pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. HBHS ayrÄ±ca, sisteminden Hesap EriÅim Ä°zni kaynaklarÄ±nÄ± da temizlemelidir. \nSÃ¶z konusu silme iÅlemi, kayÄ±tlarÄ±n statÃ¼sÃ¼nÃ¼n pasife Ã§ekilmesi ile gerÃ§ekleÅtirilmelidir. SÃ¶z konusu kayÄ±tlar, denetim izlerinin oluÅturulmasÄ± ve saklanmasÄ±na iliÅkin ikincil dÃ¼zenleme hÃ¼kÃ¼mleri kapsamÄ±nda gÃ¼venli Åekilde tutulmalÄ±dÄ±r. \nServis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r. \nÃHK rÄ±zasÄ± baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ olarak gÃ¼ncellenir ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir. \nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir: \nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (HBHS) \n 7.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ± \n    \n \n   \n Åekil 14: Hesap Bilgilerinin AlÄ±nmasÄ± \n Ä°STEK: \nMÃ¼Återi rÄ±zasÄ± tesis edilmiÅ kullanÄ±cÄ± iÃ§in HBHS API eriÅim adresinden HHSâye eriÅilebilir hesap bilgilerini GET isteÄi ile sorgular: \n \n RizaDurumu âYetki KullanÄ±ldÄ±â ise iÅleme baÅlanÄ±r. RizaDurumu farklÄ± bir deÄerde ise âTR.OHVPS.Resource.ConsentMismatchâ hatasÄ±nÄ±n iletilmesi gerekir. \n GET verisinin modele gÃ¶re kontrolÃ¼ yapÄ±lÄ±r (ÃrneÄin: Alan kontrolleri) \n \n GET verisinin mantÄ±ksal kontrolleri yapÄ±lÄ±r. \n \n \n Hesap bilgisi rÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinden herhangi bir hesabÄ±n kapatÄ±lmasÄ± ya da pasife alÄ±nmasÄ± durumunda YÃS tarafÄ±ndan yapÄ±lan hesap isteÄine HHS tarafÄ±ndan hesap bilgisi dÃ¶nÃ¼lmelidir. \n \n \n KapalÄ± hesap iÃ§in TR.OHVPS.DataCode.HspDrm veri tÃ¼rÃ¼nden KAPALI deÄeri ile, pasif hesap iÃ§in TR.OHVPS.DataCode.HspDrm veri tÃ¼rÃ¼nden PASIF deÄeri ile dÃ¶nÃ¼lmelidir. \n 7.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ± \n GET /hesaplar ve GET /hesaplar/{hspRef} \n Bu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bilgilerinin sorgulanÄ±r. Hesap bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re (Temel Hesap Bilgisi veya DetaylÄ± Hesap Bilgisi) yanÄ±tÄ±nda dÃ¶nÃ¼len HesapBilgileri nesnesinin iÃ§eriÄi deÄiÅir.  Tablo 15âte HesapBilgileri nesnesinin iÃ§eriÄi verilmiÅtir. \n Hesap Bilgisi Sorgu ÃrneÄi (TÃ¼m Hesaplar) =  /hesaplar \nHesap Bilgisi Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef} \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 14: Hesap Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼

16yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa NumarasÄ± \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 15: âHesapBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n Hesap Temel \n hspTml \n Kompleks: HesapTemel \n Z \n Temel Hesap Bilgileri (Temel Hesap Bilgisi varsayÄ±lan izin tÃ¼rÃ¼ olduÄundan Hesap Temel nesnesi zorunlu olarak yanÄ±tta bulunur) \n \n \n > Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hspRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n > Hesap NumarasÄ± \n hspNo \n AN26 \n K \n EÄer varsa Ã¶deme hesabÄ±na ait IBAN bilgisi \n \n \n > Hesap Sahibi UnvanÄ± \n hspShb \n AN3..140 \n Z \n Hesap sahibi ya da hesap sahiplerinin ad-soyadÄ±, ticari unvanÄ± \n \n \n > Åube AdÄ± \n subeAdi \n AN3..50 \n K \n EÄer varsa Ã¶deme hesabÄ±nÄ±n baÄlÄ± olduÄu Åubenin adÄ± \n \n \n > KÄ±sa Ad \n kisaAd \n AN3..50 \n K \n EÄer hesap sahibi hesaba ait bir ad tanÄ±mladÄ±ysa, tanÄ±mlanan hesap adÄ± \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi. \n \n \n > Hesap TÃ¼rÃ¼ \n hspTur \n AN1 \n Z \n HesabÄ±n tÃ¼rÃ¼ (bireysel veya ticari). TR.OHVPS.DataCode.HspTur sÄ±rali veri deÄerlerinden birini alÄ±r. \n \n \n > Hesap Tipi \n hspTip \n AN1..32 \n Z \n HesabÄ±n tipi (VADESÄ°Z, KREDÄ°LÄ° vb.).TR.OHVPS.DataCode.HspTip sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >Hesap ÃrÃ¼n AdÄ± \n hspUrunAdi \n AN1..140 \n Ä° \n HHS tarafÄ±ndan atanmÄ±Å olan Ã¼rÃ¼n adÄ± bilgisidir. HBHS tarafÄ±ndan ÃHKâya gÃ¶sterilmesi kullanÄ±m kolaylÄ±ÄÄ± saÄlayacaktÄ±r. \n \n \n > Hesap Durumu \n hspDrm \n AN5..50 \n Z \n HesabÄ±n durumunu belirtir. TR.OHVPS.DataCode.HspDrm sÄ±ralÄ± veri tÃ¼rlerinden birini alÄ±r. \n \n \n Hesap Detay \n hspDty \n Kompleks: HesapDetay \n K \n Detay Hesap Bilgileri (Temel Hesap Bilgisine ek olarak Detay Hesap Bilgisi izin tÃ¼rÃ¼ de seÃ§ilmiÅse Hesap Detay nesnesi koÅullu olarak yanÄ±tta bulunur) \n \n \n > AÃ§Ä±lÄ±Å Tarihi \n hspAclsTrh \n ISODateTime \n Z \n Belirtilen hesabÄ±n aÃ§Ä±lÄ±Å tarihi. \n 7.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ± \n GET /bakiye ve GET /hesaplar/{hspRef}/bakiye \nBu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bakiyesi sorgulanÄ±r. \nÄ°stek Ã§aÄrÄ±sÄ±na dÃ¶nÃ¼len âBakiyeBilgileriâ nesnesi Tablo 17âde verilmiÅtir. \n Hesap Bilgisi RÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinde yer alan hesaplardan kapatÄ±lmÄ±Å ya da pasif duruma alÄ±nmÄ±Å olan hesaplar iÃ§in bakiye isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan bakiye bilgisi dÃ¶nÃ¼lmelidir. \n Hesap bakiyelerinin gÃ¶sterilmesi sÄ±rasÄ±nda aÅaÄÄ±da verilen Ã¶rnekler gÃ¶zÃ¶nÃ¼nde bulundurulmalÄ±dÄ±r. \n Ãrnek 1 : ÃHK  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  0 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  -1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 2 : ÃHK  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  1 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  2000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 3 : ÃHK  Hesap Bakiye TutarÄ±  1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  0 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 4 : ÃHK  Hesap Bakiye TutarÄ±  1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  1 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  3000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /bakiye?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 16: âBakiyeBilgileriâ Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼

16yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 17: âBakiyeBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hspRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n Bakiye \n bky \n Kompleks:Bakiye \n Z \n \n \n \n > Hesap Bakiye TutarÄ± \n bkyTtr \n AN1..25 \n Z \n HesabÄ±n bakiyesi. Bloke tutar dÃ¼ÅÃ¼lmeden iletilmelidir.   Tutar alanÄ± regex patterni Åu Åekildedir:  '^-?\\d{1,18}$|^-?\\d{1,18}\\.\\d{1,5}$' \n \n \n > Blokeli Tutar \n blkTtr \n AN1..24 \n K \n Varsa hesapta blokeli tutar bilgisi.     Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n > Bakiye Ä°letilme ZamanÄ± \n bkyZmn \n ISODateTime \n Z \n Bakiyenin iletildiÄi zaman bilgisi. \n \n \n > KrediliHesap \n krdHsp \n Kompleks: KrediliHesap \n K \n \n \n \n >> Kredili Mevduat HesabÄ± Bakiyesi \n kulKrdTtr \n AN1..24 \n Z \n Kredili mevduat tutarÄ±. Kredili bir hesap ise zorunlu.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n >> Kredi Dahil GÃ¶stergesi \n krdDhlGstr \n AN1 \n Z \n Kredili bir hesap ise zorunlu. Bakiye tutarÄ±nÄ±n kredi tutarÄ± dahil edilerek ya da edilmeden iletildiÄini gÃ¶sterir.   0: Kredi tutarÄ± dahil edilmeden bakiye bilgisi iletilmesi durumu   1: Kredi tutarÄ± dahil edilerek bakiye bilgisi iletilmesi durumu \n 7.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ± \n GET /hesaplar/{hspRef}/islemler \n Belirli bir hesaba iliÅkin iÅlem bilgileri Tablo 1âdaki istek parametrelerine gÃ¶re sorgulanÄ±r. \nHesap Bilgisi RÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinde yer alan hesaplardan kapatÄ±lmÄ±Å ya da pasif duruma alÄ±nmÄ±Å olan hesaplar iÃ§in iÅlemler isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan iÅlemler bilgisi dÃ¶nÃ¼lmelidir. \nÄ°Ålem bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re yanÄ±tta dÃ¶nen IslemBilgileri nesnesinin (Temel Ä°Ålem Bilgisi veya Temel Ä°Ålem Bilgisi ve DetaylÄ± Ä°Ålem Bilgisi) iÃ§eriÄi deÄiÅir. \nÄ°Ålemler servisi hem ÃHKânÄ±n talebi ile YÃS uygulamasÄ± Ã¼zerinden Ã§aÄrÄ±labileceÄi gibi, YÃSâÃ¼n ÃHKâsÄ±z baÅlatabileceÄi otomatik Ã§aÄrÄ±larÄ± ile de yanÄ±t dÃ¶nebilmektedir. \nHHS, iÅlemin sistemsel yapÄ±lÄ±p yapÄ±lmadÄ±ÄÄ±nÄ±, istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir.\nÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \nYÃS, otomatik yapacaÄÄ± sorgularda; \n \n Bireysel ÃHKâlar iÃ§in hesap bazÄ±nda gÃ¼nde en fazla 4 adet baÅarÄ± ile sonuÃ§lanan sorgulama yapabilir. \n Kurumsal ÃHKâlar iÃ§in hesap bazÄ±nda saatte en fazla 12 adet baÅarÄ± ile sonuÃ§lanan sorgulama yapabilir. \n \n HHS, tutacaÄÄ± sayaÃ§ bilgisi ile bu sayÄ±larÄ± kontrol ederek daha fazla sorgulama yapÄ±lmasÄ±na izin vermeyebilir. \n AynÄ± istek parametreleri ile yapÄ±lan sorgu sonucunda dÃ¶necek toplam kayÄ±t sayÄ±sÄ± 100âÃ¼ aÅtÄ±ÄÄ±nda, sayfalama yÃ¶ntemi ile HHSânin cevap dÃ¶nmesi beklenmektedir.  Her bir sayfa iÃ§in iÅlemler servisi tekrar Ã§aÄrÄ±lsa da, bu Ã§aÄrÄ±m HHSânin tuttuÄu sayaÃ§ deÄerini arttÄ±rmaz. HHSânin tutacaÄÄ± sayaÃ§Ä±n kontrol parametreleri YÃS kodu, hesap numarasÄ± ya da referansÄ± olmalÄ±dÄ±r. Sayfa no parametresi varsa ve 1'den bÃ¼yÃ¼k ise iÅlem sayacÄ±nÄ± arttÄ±rmamalÄ±dÄ±r. \n ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden tetiklediÄi iÅlemlerde ise;\nbireysel ÃHKâlar  iÃ§in en fazla 1 aylÄ±k,\nkurumsal ÃHKâlar iÃ§in ise en fazla 1 haftalÄ±k bir pencere aralÄ±ÄÄ±nda sorgulama yapÄ±labilir. \n YÃS, otomatik yapacaÄÄ± sorgularda hem bireysel hem de kurumsal ÃHKâlar iÃ§in 24 saatlik bir pencere aralÄ±ÄÄ±nda sorgulama yapabilir. \n Yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saatinin 00:00:00 olduÄu kabul edilmiÅtir. \n Sorgu Ã¶rnekleri aÅaÄÄ±daki gibidir:  \n 1 gÃ¼nlÃ¼k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-06-02T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n \n 1 haftalÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-06-08T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-02-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-03-01T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-01-31T00:00:00+03:00&\nhesapIslemBtsTrh=2020-02-28T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-02-28T00:00:00+03:00&\nhesapIslemBtsTrh=2020-03-28T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 24 saatlik pencerede yapacaÄÄ± sistemsel sorgu Ã¶rneÄi (Son sorgusunun Ã¼zerine 24 saat eklenmesi)  =\n/hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T14:10:08+03:00&\nhesapIslemBtsTrh=2020-06-02T14:10:08+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n ÃnyÃ¼zden alÄ±nan sorgu parametreleri ile oluÅturulan sorgu Ã¶rneÄi (Ãrnek sorgu tarih aralÄ±ÄÄ± 20.02.2023- 25.02.2023 arasÄ±ndadÄ±r)  =\n/hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2023-02-20T00:00:00+03:00&\nhesapIslemBtsTrh=2023-02-26T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n Tablo 18: Ä°Ålem Listesi Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin baÅlangÄ±Ã§ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. ÃHK tarafÄ±ndan tetiklenen sorgularda;hesapIslemBslTrh ve hesapIslemBtsTrh arasÄ± fark bireysel ÃHKâlar iÃ§in en fazla 1 ay,kurumsal ÃHKâlar iÃ§in ise en fazla 1 hafta olabilir. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;son 24 saat sorgulanabilir. Bu yÃ¼zden hesapIslemBtsTrh-24 saatâten daha uzun bir aralÄ±k sorgulanamaz olmalÄ±dÄ±r. Ä°stek baÅlÄ±ÄÄ±nda yer alan PSU-Initiated alanÄ± âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n \n \n Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin bitiÅ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;Ä°leri vadeli iÅlem emirleri dahil olmadÄ±ÄÄ± iÃ§in (SÃ¼rÃ¼m 1.0.2 kapsamÄ±nda); Ä°Ålem Sorgulama BitiÅ ZamanÄ±, her zaman, sorgulama zaman damgasÄ±nÄ± iletecek Åekilde (datetime (now)) iletilebilir. \n \n \n En DÃ¼ÅÃ¼k Ä°Ålem TutarÄ± \n minIslTtr \n AN1..24 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en dÃ¼ÅÃ¼k iÅlem tutarÄ±.      Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n En YÃ¼ksek Ä°Ålem TutarÄ± \n mksIslTtr \n AN1..24 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en yÃ¼ksek iÅlem tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n BorÃ§ Alacak GÃ¶stergesi \n brcAlc \n AN1 \n Ä° \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Hesaba borÃ§ yaratan iÅlem.A: Hesaba alacak yaratan iÅlem.{âBâ,âAâ} \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼

16yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âislGrckZamanâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini islGrckZaman olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 19: âIslemBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap Referans NumarasÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hspRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n Islemler \n isller \n Kompleks:Islem[Array] \n K \n Hesaba iliÅkin hareketler varsa Ä°Ålemler nesnesi dizisi olarak dÃ¶nÃ¼lÃ¼r. Ä°Ålemler nesnesi Temel Ä°Ålem Bilgileri ve Detay Ä°Ålem Bilgileri nesnesinden meydana gelir. Ä°zin tÃ¼rÃ¼ varsayÄ±lan olarak Temel Ä°Ålem Bilgilerini iÃ§erir. Detay Ä°Ålem Bilgileri izin tÃ¼rÃ¼ de seÃ§ildi ise Temel Ä°Ålem Bilgilerine ek olarak Detay Ä°Ålem Bilgileri de gÃ¶nderilir. \n \n \n > Temel Ä°Ålem Bilgileri \n islTml \n Kompleks:IslemTemel \n Z \n Temel Ä°Ålem Bilgileri varsayÄ±lan olarak dÃ¶nÃ¼lÃ¼r. \n \n \n >> Ä°Ålem NumarasÄ± \n islNo \n AN3..50 \n Z \n Hesap hareketinin oluÅturulmasÄ± sÄ±rasÄ±nda atanan ve borÃ§ (veya alacak) hareketini tekilleÅtiren HHS bazÄ±nda tekil tanÄ±mlayÄ±cÄ±dÄ±r. Bu deÄer tek baÅÄ±na tekil olabileceÄi gibi birden fazla deÄerin bir araya getirilmesiyle de tekilliÄi saÄlanmÄ±Å olabilir. Bu deÄerin en azÄ±ndan hesap numarasÄ± (hesNo) bazÄ±nda tekil olmasÄ± beklenir. Genellikle kullanÄ±lan Ã¶rnekleri; Instance_Id, Transaction_Id, Transaction_Num, Transaction_TimeStamp,dekont numarasÄ± \n \n \n >> Ä°Ålem Referans NumarasÄ± \n refNo \n AN3..50 \n Z \n Ä°Ålemi uÃ§tan uca tanÄ±mlayan tekil tanÄ±mlayÄ±cÄ±dÄ±r. BorÃ§ ve alacak hareketinden oluÅan bir veya birden fazla iÅlemler bÃ¼tÃ¼nÃ¼ iÃ§in atanmÄ±Å olan ve bu bÃ¼tÃ¼nÃ¼ tekilleÅtiren (bir biri ile iliÅkisini tutan) deÄerdir.Bu deÄer hem YÃSâten gelen deÄer olabilir (Ã¶deme iÅlemlerinde kullanÄ±lan kkodRef ya da refBlg alanÄ±) hem de HHS iÃ§inde takip edilmek iÃ§in Ã¼retilmiÅ bir deÄer olabilir. HHS sisteminde 2 deÄerin de bulunmasÄ± durumunda;refNo alanÄ±nÄ± doldurmak iÃ§in, HHSânin YÃSâten gelen deÄere Ã¶ncelik vermesi beklenmektedir. YÃSâten gelen veri Ã¶rneÄi: SipariÅ NumarasÄ±, Fatura NumarasÄ±, Karekod ReferansÄ± vb. HHSâte Ã¼retilen veri Ã¶rneÄi: MasraflÄ± havale iÅleminde hem havale iÅleminin hem de masraf iÅleminin aynÄ± referans numarasÄ±na sahip olmasÄ± da Ã¶rnek olarak gÃ¶sterilebilir. \n \n \n >> Ä°Ålem TutarÄ± \n islTtr \n AN1..24 \n Z \n Ä°Ålem tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n >> GÃ¼ncel Bakiye TutarÄ± \n gnclBky \n AN1..25 \n Z \n Ä°Ålem sonrasÄ± gÃ¼ncel bakiye bilgisi tutarÄ±.   Tutar alanÄ± regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n >> Ä°Ålem GerÃ§ekleÅme ZamanÄ± \n islGrckZaman \n ISODateTime \n Z \n Ä°Ålemin gerÃ§ekleÅme zamanÄ±. \n \n \n >> Ä°Ålem KanalÄ± \n kanal \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeKaynak sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> BorÃ§landÄ±rma AlacaklandÄ±rma GÃ¶stergesi \n brcAlc \n AN1 \n Z \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Ä°Ålemin hesabÄ± borÃ§ ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. \n \n \n >> Ä°Ålem TÃ¼rÃ¼ \n islTur \n AN3..50 \n Z \n HHSânin iÅleme ait iliÅkilendirdiÄi iÅlem tÃ¼rÃ¼ deÄeri. TR.OHVPS.DataCode.IslemTuru sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Ä°Ålem AmacÄ± \n islAmc \n AN2 \n Z \n TR.OHVPS.DataCode.IslemAmaci sÄ±rali veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Ãdeme Sistemi No \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. Havale/FAST/PÃS  Ã¶deme yÃ¶ntemleri iÃ§in tarih alanÄ± yyyy-aa-gg formatÄ±nda 10 karakter olarak

16iletilmelidir. \n \n \n > Detay Ä°Ålem Bilgileri \n islDty \n Kompleks: IslemDetay \n K \n Detay Ä°Ålem Bilgileri dizi olarak gÃ¶nderilmelidir. \n \n \n >> Ä°Ålem AÃ§Ä±klamasÄ± \n islAcklm \n AN1..200 \n Z \n HHS tarafÄ±ndan atanan iÅlem aÃ§Ä±klamasÄ±. HHS kendi iÅlem hareketlerine yansÄ±ttÄ±ÄÄ± aÃ§Ä±klamayÄ± buraya yansÄ±tmalÄ±dÄ±r. HHS'ler tÃ¼m hesap hareketlerini YÃS'ler ile paylaÅmakla yÃ¼kÃ¼mlÃ¼ olup, hassas veri iÃ§eren(Ã¶rn: faiz, komisyon bilgisi iÃ§eren vb.) iÅlem hareketleri de bu kapsamda deÄerlendirilerek iÅlem aÃ§Ä±klamasÄ±nÄ±n maskeli olarak iletilmesi saÄlanÄ±r. Kelimelerin ilk 3 hanesi maskeli olacak Åekilde, ancak sakÄ±ncalÄ± bulunan kelimeler varsa; (Ã¶rn: faiz, komiyon vb.) kelimelerin tamamÄ± maskeli olacak Åekilde gÃ¶sterilebilir. \n \n \n >> KarÅÄ± Taraf \n krsTrf \n Kompleks:  KarsiTaraf \n K \n KullanÄ±mÄ± iÅlem bazÄ±nda deÄiÅmektedir. Ãrnek: FAST iÅleminde karÅÄ± taraf alÄ±cÄ±nÄ±n bilgileridir. Vergi Ã¶demesinde kurum IBAN bilgisi mÃ¼Återiye gÃ¶sterilemeyebileceÄinden bu alanÄ±n boÅ gelmesi HHS insiyatifindedir. \n \n \n >>> KarÅÄ± Maskeli IBAN \n krsMskIBAN \n AN26 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n maskeli IBAN bilgisi. \n \n \n >>> KarÅÄ± Unvan \n krsMskUnvan \n AN3..140 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n ad-soyad ya da ticari unvan bilgisi.Unvan bilgisi maskelenmeden iletilmelidir. \n \n \n >>> KarÅÄ± Taraf Kimlik Bilgisi \n krsKimlikVrs \n AN1..11 \n Ä° \n HHS sorumluluÄunda YÃS ile paylaÅÄ±lan KarÅÄ± Taraf Kimlik Bilgisi(Kimlik/Kurum Kimlik - TCKN/VKN) \n \n \n \n"},{title:"2.Kapsam ve Dayanak",frontmatter:{},regularPath:"/v1.1.0/contents/kapsam-ve-dayanak.html",relativePath:"v1.1.0/contents/kapsam-ve-dayanak.md",key:"v-9e25e106",path:"/v1.1.0/contents/kapsam-ve-dayanak.html",content:" 2.Kapsam ve Dayanak \n 12 KasÄ±m 2019âda gÃ¼ncellenen â 6493 sayÄ±lÄ± Ãdeme ve Menkul KÄ±ymet Mutabakat Sistemleri, Ãdeme Hizmetleri ve Elektronik Para KuruluÅlarÄ± HakkÄ±nda Kanun âun (Kanun) 12ânci maddesine yeni eklenen ve  Ãdeme Hizmetleri Direktifi 2 'de (Payment Services Directive 2, PSD2) bulunan iki yeni Ã¶deme hizmeti aÅaÄÄ±daki gibi tanÄ±mlanmÄ±ÅtÄ±r (Åekil-1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri): \n \n Ãdeme Emri BaÅlatma Hizmeti : ÃHKânÄ±n isteÄi Ã¼zerine baÅka bir Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nda bulunan  Ã¶deme hesabÄ±yla  ilgili sunulan Ã¶deme emri baÅlatma hizmeti [Madde 12, birinci fÄ±kra, (f) bendi] \n Hesap Bilgisi Hizmeti : ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± koÅuluyla, ÃHKânÄ±n Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ± nezdinde bulunan bir veya daha fazla  Ã¶deme hesabÄ±na  iliÅkin konsolide edilmiÅ bilgilerin Ã§evrim iÃ§i platformlarda sunulmasÄ± hizmeti [Madde 12, birinci fÄ±kra, (g) bendi] \n \n   \n Åekil 1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS)- tanÄ±tÄ±m \n Kanunun 14/A maddesinin ikinci fÄ±krasÄ±na gÃ¶re , Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetleri ile ilgili iÅlemlerin yÃ¼rÃ¼tÃ¼lmesine iliÅkin usul ve esaslar ile taraflarca uyulmasÄ± gereken teknik ve operasyonel gereklilikler ikincil dÃ¼zenlemeler uyarÄ±nca TÃ¼rkiye Cumhuriyet Merkez BankasÄ± (TCMB) tarafÄ±ndan belirlenir. Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri  Ã¶deme hizmetleri veri paylaÅÄ±m servisleri (ÃHVPS)  olarak adlandÄ±rÄ±lmaktadÄ±r. \n Ãdeme Hizmetleri ve Elektronik Para Ä°hracÄ± ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± HakkÄ±nda YÃ¶netmelikâin (YÃ¶netmelik) 59âuncu maddesinin birinci fÄ±krasÄ± uyarÄ±nca hazÄ±rlanan bu belgede sÃ¶z konusu Ã¶deme hizmetlerini sunacak Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, Ã¶deme hesabÄ±nÄ±n bulunduÄu Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, varsa ilgili diÄer taraflarÄ±n ve bu hizmetlerin sunulmasÄ± iÃ§in taraflar arasÄ±nda kurulacak baÄlantÄ±nÄ±n teknik ve operasyonel gereklilikleri aÃ§Ä±klanmaktadÄ±r. \n DÃ¼zenlemeler kapsamÄ±nda yetkilendirilen Ã¼Ã§Ã¼ncÃ¼ taraf hizmet saÄlayÄ±cÄ±sÄ±  (Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ±, YÃS) , Ã¶deme hizmeti kullanÄ±cÄ±larÄ±nÄ±n  Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS)  nezdindeki Ã¶deme hesaplarÄ±na ulaÅarak Ã¶deme emri baÅlatma ve hesap bilgisi saÄlama hizmetlerinden (Ã¶deme hizmetleri veri paylaÅÄ±m servislerinden) faydalanmasÄ±na aracÄ±lÄ±k eder. Ãdeme hizmetleri veri paylaÅÄ±m servisleri kapsamÄ±nda iki tip YÃS bulunmaktadÄ±r:  1) Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ve 2) Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS). \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ÃHKânÄ±n farklÄ± Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS) nezdindeki hesaplarÄ±nÄ±n bilgilerini derleyerek Ã§evrim iÃ§i platformlarda  toplu Åekilde  sunar. Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS) ise talebi Ã¼zerine ÃHKânÄ±n HHSâde bulunan Ã¶deme hesabÄ±ndan Ã¶deme iÅlemi baÅlatÄ±r. \n ÃHVPSânin Ã¼st dÃ¼zey gÃ¶sterimi Åekil-2âde verilmiÅtir. \n   \n Åekil 2: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS) -Ã¼st dÃ¼zey gÃ¶sterim \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servislerinin HHSâler tarafÄ±ndan  GEÃÄ°T  vasÄ±tasÄ±yla sunulduÄu uygulama mimarisi ise Åekil-3âte sunulmuÅtur. \n  \n Åekil 3: ÃHVPS'nin GEÃÄ°T vasÄ±tasÄ±yla sunumu \n"},{title:"10.\tOlay Bildirim",frontmatter:{},regularPath:"/v1.1.0/contents/olay-bildirim.html",relativePath:"v1.1.0/contents/olay-bildirim.md",key:"v-206455c6",path:"/v1.1.0/contents/olay-bildirim.html",headers:[{level:2,title:"Genel Bilgiler",slug:"genel-bilgiler"},{level:2,title:"Olay Abonelik Servisleri (OAS)",slug:"olay-abonelik-servisleri-oas"}

16,{level:2,title:"ADIM 1: Olay AboneliÄinin gerÃ§ekleÅtirilmesi",slug:"adim-1-olay-aboneliginin-gerceklestirilmesi"},{level:2,title:"ADIM 2: Olay AboneliÄinin gÃ¼ncellenmesi",slug:"adim-2-olay-aboneliginin-guncellenmesi"},{level:2,title:"ADIM 3: Olay AboneliÄinin sorgulanmasÄ±",slug:"adim-3-olay-aboneliginin-sorgulanmasÄ±"},{level:2,title:"ADIM 4: Olay AboneliÄinin iptali",slug:"adim-4-olay-aboneliginin-iptali"},{level:2,title:"ADIM 5: Olay AboneliÄinin Ä°letilemeyen OlaylarÄ±",slug:"adim-5-olay-aboneliginin-iletilemeyen-olaylarÄ±"},{level:2,title:"ADIM 6: Sistem Olay Dinleme",slug:"adim-6-sistem-olay-dinleme"},{level:2,title:"Olay Dinleme Servisleri (ODS)",slug:"olay-dinleme-servisleri-ods"},{level:2,title:"ADIM 1: Olay Dinleme",slug:"adim-1-olay-dinleme"},{level:2,title:"ADIM 2:  Sistem Olay Dinleme",slug:"adim-2-sistem-olay-dinleme"}],content:" 10.\tOlay Bildirim  \n Genel Bilgiler \n Olay Bildirim Abonelik API servisleri, HHS'lerin sunmuÅ olduklarÄ± olay bildirimlerini takip etmek amacÄ±yla abonelik akÄ±ÅlarÄ±nÄ± tanÄ±mlar. \n YÃS'ler olay bildirimlerini takip edebilmek iÃ§in talep ettikleri abonelik hizmetlerini belirterek HHS'ler Ã¶zelinde bir abonelik kaydÄ± oluÅtururlar. Bu abonelik kaydÄ±nÄ± okuyabilir, gÃ¼ncelleyebilir ya da silebilirler. \n Olay bildirimleri HHS'ler tarafÄ±ndan 2 yÃ¶ntem ile saÄlanÄ±r. Ä°lki olay bildirimlerinin anlÄ±k olarak iletilmesi, diÄeri ise anlÄ±k iletilemeyen olaylarÄ±n toplu olarak iletilmesidir. \n Olay Bildirimi 2 API ile yÃ¶netilecektir. \n 1 - Olay Abonelik Servisleri (OAS) \n2 - Olay Dinleme Servisleri  (ODS) \n Olay Abonelik ve Olay Dinleme API'lerinin istek ve yanÄ±t baÅlÄ±ÄÄ±nda beklenen parametreler ÃBH,HBH,GKD API'lerinden farklÄ±dÄ±r.\n 3.15. Ä°stek BaÅlÄ±ÄÄ±  ve  3.16. YanÄ±t BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mlerinde zorunlu parametreler ve aÃ§Ä±klamalarÄ± belirtilmiÅtir. \n Olay Abonelik Servisleri (OAS) \n Olay abonelik Servisleri; HHS'ler tarafÄ±ndan sunulacak olay bildirim abonelik servislerini ve iletilemeyen olaylar servisini iÃ§ermektedir. \n HHS'nin sunacaÄÄ± bu API ile YÃS'ler Åu adÄ±mlarÄ± gerÃ§ekleÅtirebilir. \n \n YÃS'Ã¼n olay bildirimlerini dinleyebilmek iÃ§in Ã¶ncelikle dinlemek istediÄi olaylara ait olay tipleri ve kaynak tiplerini belirlemesi gerekmektedir. \n Olay tipleri ve kaynak tiplerinin neler olacaÄÄ± \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda belirtilmiÅtir. \n YÃS, belirlediÄi olaylar iÃ§in HHS'ye olay abonelik endpointi aracÄ±lÄ±ÄÄ± ile abonelik baÅlatÄ±r. \n YÃS, abonelik numarasÄ± aracÄ±lÄ±ÄÄ± ile abonelik bilgilerini gÃ¶rÃ¼ntÃ¼leyebilir, gÃ¼ncelleyebilir, silebilir. \n YÃS, olay bildirimlerini bu abonelik sayesinde kendisinin sunacaÄÄ± Olay Dinleme API'si ile dinler. \n HHS anlÄ±k iletemediÄi olaylarÄ±nÄ± biriktirerek, iletilemeyen olaylar endpointi ile YÃS'e sunar. \n \n HHS'ler \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda belirlenen olay ve kaynak tiplerinin tÃ¼mÃ¼ iÃ§in YÃS'lere bildirim sunmak zorundadÄ±r. \n Olay Abonelik Servislerinde Idempotency kurallarÄ±nÄ±n iÅletilmesine gerek bulunmamaktadÄ±r. \n Nezdinde Ã¶deme hesabÄ± bulunduran bazÄ± hesap hizmeti saÄlayÄ±cÄ±lar(EPK, Ãdeme KuruluÅlarÄ±) mÃ¼Återilerine ait hesaplarÄ±, diÄer HHS'lerdeki havuz hesaplarÄ±nÄ± kullanarak yÃ¶netiyor olabilir. Bu durum ilgili hesap hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n, ÃHVPS kapsamÄ±nda HHS olduÄu rolde sunmasÄ± gereken olay bildirim servisleri ile ilgili uymasÄ± gereken kurallarÄ± deÄiÅtirmemektedir. Ä°lgili hesap hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n standartlara uygun Åekilde YÃS'lere bildirimleri yapmasÄ± gerekmektedir. \n YÃS'ler sahip olduklarÄ± rol Ã¶zelinde olay abonelik servislerinden faydalanabilir. Bu yÃ¼zden olay bildirim etki alanÄ± (scope) deÄerleri hesap_bilgisi ve/veya odeme_emri olarak belirlenmiÅtir. \n Olay Abonelik Servisine ait API Endpointleri aÅaÄÄ±daki tabloda listelenmiÅtir. \n Olay Abonelik Servisleri iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ  \"odeme_emri\" \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n olay-abonelik \n POST \n /olay-abonelik \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n OlayAbonelikÄ°stegi \n OlayAbonelik \n \n \n 2 \n olay-abonelik \n GET \n /olay-abonelik \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n

16- \n OlayAbonelik \n \n \n 3 \n olay-abonelik/{olayAbonelikNo} \n PUT \n /olay-abonelik/{olayAbonelikNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n OlayAbonelik \n OlayAbonelik \n \n \n 4 \n olay-abonelik/{olayAbonelikNo} \n DELETE \n /olay-abonelik/{olayAbonelikNo} \n Z \n Ä°stemci Kimlik Bilgileri \n - \n - \n - \n - \n \n \n 5 \n olay-abonelik/{olayAbonelikNo}/iletilemeyen-olaylar \n GET \n /olay-abonelik/{olayAbonelikNo}/iletilemeyen-olaylar \n Z \n Ä°stemci Kimlik Bilgileri \n - \n Sayfalama \n \n Olaylar \n \n \n 6 \n sistem-olay-dinleme \n POST \n sistem-olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n - \n - \n Olaylar \n - \n ADIM 1: Olay AboneliÄinin gerÃ§ekleÅtirilmesi \n POST /olay-abonelik \n HHS'nin olay abonelik hizmeti sunduÄu servistir.\nYÃS, seÃ§eceÄi olay-kaynak tipleri iÃ§in bu servis aracÄ±lÄ±ÄÄ± ile abone olabilir. HHS POST iÅlemi sonucunda, YÃS adÄ±na bir olay abonelik kaynaÄÄ± oluÅturur ve tekil tanÄ±mlayÄ±cÄ± olan olayAbonelikNo deÄerini dÃ¶ner. olayAbonelikNo Ã¼retilirken farklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. olayAbonelikNo evrensel tekil olmalÄ±dÄ±r. \n1 YÃS'Ã¼n 1 HHS'de 1 adet abonelik kaydÄ± olabilir. \nBaÅarÄ±lÄ± POST isteÄi sonucu HTTP 201 cevabÄ± ile iletilmelidir. \n YÃS tarafÄ±ndan daha Ã¶nce oluÅturulmuÅ olay abonelik kaydÄ± varsa \"HTTP 400 -TR.OHVPS.Business.InvalidContent -Kaynak ÃakÄ±ÅmasÄ±\" hatasÄ±yla uyarÄ± mesajÄ±nÄ± dÃ¶ner. \n Olay Abonelik kaydÄ± oluÅturmak isteyen YÃS'Ã¼n ODS API tanÄ±mÄ± HHS tarafÄ±ndan kontrol edilmelidir. YÃS'Ã¼n tanÄ±mÄ± olmamasÄ± halinde \"HTTP 400-TR.OHVPS.Business.InvalidContent\" hatasÄ± verilmelidir. \n Olay Abonelik kaydÄ± oluÅturmak isteyen YÃS tarafÄ±ndan olay tipi ve kaynak tipi iÃ§in iletilen deÄerler olmasÄ± gereken sÄ±ralÄ± veri tÃ¼lerinden(TR.OHVPS.DataCode.OlayTip ve TR.OHVPS.DataCode.KaynakTip) farklÄ± ise HHS tarafÄ±ndan  \"HTTP 400-TR.OHVPS.Resource.InvalidFormat\" hatasÄ± verilmelidir. \n Abonelik Ã¼zerinde gÃ¶rÃ¼ntÃ¼leme, gÃ¼ncelleme, silme iÅlemlerini gerÃ§ekleÅtirebilir.\nYÃS'Ã¼n AboneliÄi devam ettiÄi sÃ¼rece; YÃS'Ã¼n aÃ§acaÄÄ± Olay Dinleme API'sine, HHS tarafÄ±ndan abonelik kapsamÄ±nda olay bildirimleri iletilir. \n BKM'nin sunacaÄÄ± abonelik servisleri iÃ§in HHS ve YÃS'lerin abonelik isteÄi yapmasÄ±na gerek bulunmamaktadÄ±r. BKM Ã¼retim ortamÄ± tanÄ±mlarÄ± yapÄ±lÄ±rken katÄ±lÄ±mcÄ±larÄ± abonelik servislerine Ã¼ye yapacaktÄ±r. BKM'nin sunacaÄÄ± abonelik servislerinin olay tipi \"HHS_YOS_GUNCELLENDI\"dir. HHS ve YÃS API ile sunulan bilgilerde bir deÄiÅiklik olduÄunda yapÄ±lacak olay bildirimlerini saÄlar.\nÃrneÄin; HHS logo bilgilerinde yapÄ±lacak bir deÄiÅiklik sonrasÄ±nda, YÃS'lere yapÄ±lacak bildirim ile logo bilgisini deÄiÅen HHS'nin hhsKod deÄerini iletir. YÃS, HHS API'yi  hhsKod ile Ã§aÄÄ±rarak HHS'nin gÃ¼ncel bilgilerini alÄ±r. GÃ¼ncel bilgiler ile kendi sistemini gÃ¼nceller. \n OlayAbonelikIstegi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n \n \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n YÃS abone olmak istediÄi olay tiplerini TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄer ya da deÄerler ile doldurur. \n \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda \"Olay Bildirim Yapan\" kolonu \"HHS\" olan olay tipleri ile veri giriÅine izin verilir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n Olay tiplerinin tanÄ±mlanabildiÄi kaynak listesi bulunmaktadÄ±r. Bu listeye uygun kaynak tipleri iletilmelidir. \n HHS, YÃS API Ã¼zerinden YÃS'Ã¼n rollerini alarak uygun kaynak tiplerine kayÄ±t olmasÄ±nÄ± saÄlar. \n \n \n \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± iletilebilir. Ä°lk deÄeri olay abonelik oluÅturma zamanÄ± bilgisidir. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n \n \n \n \n Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi \n * AnlÄ±k : Olay gerÃ§ekleÅtikten sonra maksimum 5 saniye iÃ§erisindeki zaman \n \n \n \n Olay Tipleri \n YÃS RolÃ¼ \n Kaynak Tipleri \n Olay OluÅturulma durumu \n KaynakNo \n AsÄ±l verinin elde edileceÄi API \n Olay Bildirimini Yapan \n Olay Bildirim ZamanÄ± \n Retry Policy \n \n \n \n \n KAYNAK_GUNCELLENDI \n ÃBH \n ODEME_EMRI \n TÃ¼m Ã¶deme durum deÄiÅikliklerinde \n odemeEmriNo \n GET /odeme-emri/{odemeEmriNo} \n HHS \n AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n RÄ±za iptal detay kodu â02â : KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal durumunda \n RizaNo \n GET /hesap-bilgisi-rizasi/{RizaNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n HBH \n BAKIYE \n Bakiye nesnesindeki tutarla ilgili bir bilgi deÄiÅtiÄinde ve HBH rÄ±zasÄ± iÃ§erisinde \"06-AnlÄ±k Bakiye Bildirimi\" izin tÃ¼rÃ¼ varsa oluÅturulur. Mevcutta alÄ±nmÄ±Å rÄ±zalar iÃ§in  bakiye kaynak tipi Ã¶zelinde 06 izin tÃ¼rÃ¼ gerektiÄinden; mevcut rÄ±zanÄ±n yenilenmesine dair mÃ¼Återiye bilgilendirme yapÄ±larak 06 izin tÃ¼rÃ¼nÃ¼ kapsayan yeni rÄ±za alÄ±nmasÄ± sÃ¼reci YÃS tarafÄ±ndan gerÃ§ekleÅtirilebilir. Bloke tutar deÄiÅikliÄi iÃ§in olay oluÅturma ve bildirimi HHS inisiyatifindedir. KrdHsp iÃ§erisinde yer alan kulKrdTtr deÄerinin deÄiÅtiÄi durumda olay bildirim gÃ¶nderilmesi gerekmektedir. \n hspRef \n GET /hesaplar/{hspRef}/bakiye, GET /hesaplar/{hspRef}/islemler \n HHS \n Maksimum 10 dakika iÃ§erisinde \n Retry policy uygulanmamalÄ±dÄ±r. Ä°lk istek gÃ¶nderilemediÄi durumda Ä°letilemeyen Olaylara eklenmelidir. \n \n \n \n HBH \n COKLU_ISLEM_TALEBI ( bulk-data) \n Ä°lgili API Ä°lke ve kurallarÄ±na eklendiÄinde gÃ¼ncellenecektir. \n \n \n HHS \n \n 30 Dakika - 3 Deneme \n \n \n AYRIK_GKD_BASARILI \n ÃBH \n ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}}&rizaTip=O \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}&rizaTip=H \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n AYRIK_GKD_BASARISIZ \n ÃBH \n ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /odeme-emri-rizasi/{RizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /hesap-bilgisi-rizasi/{RizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n HHS_YOS_GUNCELLENDI \n \n \n BKM sistemi tarafÄ±ndan Ã¼retilecek olaylarÄ± dinlemek iÃ§in kullanÄ±lacak kaynak tipidir. YÃS ve HHS'lerin BKM'ye abonelik oluÅturmasÄ±na gerek bulunmamaktadÄ±r. BKM HHS ve YÃS Ã¼retim ortamÄ± tanÄ±mÄ± yaparken aboneliklerini baÅlatacaktÄ±r.   (HHS yaygÄ±nlaÅtÄ±rma durumundayken de aboneliÄi baÅlatÄ±lacaktÄ±r.) \n \n \n HHS \n \n \n \n \n \n YÃS \n HHS \n HHS bilgilerinde deÄiÅiklik olduÄunda, YÃS'Ã¼n hhsKod ile sorgulama yapmasÄ± ve deÄiÅen bilgiyi gÃ¼ncellemesi beklenmektedir. \n hhsKod \n GET /hhs/{hhsKod} \n BKM \n *AnlÄ±k \n 5 Dakika - 3 Deneme \n \n \n \n HHS \n YOS \n YÃS bilgilerinde deÄiÅiklik olduÄunda, HHS'nin yosKod ile sorgulama yapmasÄ± ve deÄiÅen bilgiyi gÃ¼ncellemesi beklenmektedir. \n yosKod \n GET /yos/{yosKod} \n BKM \n *AnlÄ±k \n 5 Dakika - 3 Deneme \n \n \n \n * AnlÄ±k : Olay gerÃ§ekleÅtikten sonra maksimum 5 saniye iÃ§erisindeki zaman \n ADIM 2: Olay AboneliÄinin gÃ¼ncellenmesi \n PUT\tolay-abonelik/{olayAbonelikNo} \n YÃS'Ã¼n olay aboneliÄine ait abonelik tiplerini gÃ¼ncelleyebildiÄi servistir. Olay aboneliÄi oluÅturulduÄu zaman HHS tarafÄ±ndan iletilen olayAbonelikNo aracÄ±lÄ±ÄÄ± ile gÃ¼ncelleme iÅlemi yapÄ±lÄ±r. YÃS abone olmak istediÄi olay-kayÄ±t tiplerininin son halini gÃ¼ncelleme servisi ile HHS'ye iletir. HHS bu bilgilerle eski abonelik tiplerinin yerini deÄiÅtirir. \n BaÅarÄ±lÄ± PUT isteÄi sonucu HTTP 200 cevabÄ± ile iletilmelidir. \n OlayAbonelikIstegi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n HHS geÃ§erli bir olay abonelik numarasÄ± olduÄunun kontrolÃ¼nÃ¼ yapar. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n HHS Sisteminde, YÃS'Ã¼n eski abonelikleri yeni aboneliklerle gÃ¼ncellenmelidir. \n \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n YÃS abone olmak istediÄi olay tiplerini TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄer ya da deÄerler ile doldurur. \n \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda \"Olay Bildirim Yapan\" kolonu \"HHS\" olan olay tipleri ile veri giriÅine izin verilir.  Olay tipi AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ iÃ§in, YÃS'Ã¼n ODS API'yi sunmasÄ± zorunludur. HHS, bu olay tipleri Ã¶zelinde YÃS API Ã¼zerinden YÃS'Ã¼n bu API'yi sunduÄunu kontrol eder ve eÄer sunmuyor ise TR.OHVPS.Business.InvalidContent hatasÄ± dÃ¶nerek kayÄ±t iÅlemini gerÃ§ekleÅtirmez. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n Olay tiplerinin tanÄ±mlanabildiÄi kaynak listesi bulunmaktadÄ±r. Bu listeye uygun kaynak tipleri iletilmelidir. \n HHS, YÃS API Ã¼zerinden YÃS'Ã¼n rollerini alarak uygun kaynak tiplerine kayÄ±t olmasÄ±na izin verir. \n \n \n \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n ADIM 3: Olay AboneliÄinin sorgulanmasÄ± \n GET /olay-abonelik \n YÃS olay abonelik bilgilerini sorgulamak isteyebilir. HHS, YÃS'e ait aktif durumdaki abonelik bilgisini iletir.\nBaÅarÄ±lÄ± GET sonucu HTTP 200 kodu ile iletilmelidir. \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n YÃS'Ã¼n abone olduÄ

16u olay - kaynak listesini dÃ¶ner. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄerler iÃ§erir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden deÄerler iÃ§erir. \n ADIM 4: Olay AboneliÄinin iptali \n DELETE /olay-abonelik/olayAbonelikNo \n YÃS'Ã¼n abonelik kaydÄ±nÄ± silmesi iÃ§in HHS'nin sunduÄu servistir.  BaÅarÄ±lÄ± silme iÅlemi sonucu HTTP 204 ile YÃS'e iletilir. \n ADIM 5: Olay AboneliÄinin Ä°letilemeyen OlaylarÄ± \n GET /iletilemeyen-olaylar \n HHS kaynaklar Ã¼zerinde oluÅacak olaylarÄ± YÃS'e POST/olay-dinleme servisi ile gÃ¶nderim saÄlamaktadÄ±r. Bu gÃ¶nderim belli bir yeniden gÃ¶nderim politasÄ± (retry-policy) ile yapÄ±lmalÄ±dÄ±r.  Ancak yine de iletilemeyen olaylar olursa (YÃS servisinden HTTP 202 alamama durumu) YÃS'e iletilemeyen-olaylar servisi Ã¼zerinden sunulmalÄ±dÄ±r. Yani yeniden gÃ¶nderim politikasÄ± sonunda gÃ¶nderilemeyen olaylar bu servis ile sunulmalÄ±dÄ±r. \n AynÄ± kaynak numarasÄ± ile aynÄ± olay-kaynak tipinde, 1 YÃSâe ait, 1 adet iletilemeyen olay kaydÄ± olabilir. \n Bu serviste 1 gÃ¼n Ã¶ncesinden sorgu anÄ±na kadar tÃ¼m kayÄ±tlarÄ±na ait iletilemeyen olaylar listelenmelidir.\nÃrnek sorgu zamanÄ± : 2023-04-06T15:14:00+03:00\nHHS'nin sunacaÄÄ± veri 2023-04-05T00:00:00+03:00  ile 2023-04-06T15:14:00+03:00 arasÄ±nda olmalÄ±dÄ±r.\nSÄ±ralama yÃ¶nÃ¼ olay tarihine gÃ¶re artan Åekilde olmalÄ±dÄ±r. Sayfalama 100'er kayÄ±t dÃ¶nÃ¼lerek yapÄ±lmalÄ±dÄ±r. \n YÃS tarafÄ±ndan iletilemeyen olaylar isteÄi 10 dakikada bir olacak Åekilde yapÄ±labilir. HHS bu limite uygun iÅlem kÄ±sÄ±tÄ± uygulayabilir. \n Ä°Ålem Sorgu ÃrneÄi GET Ä°Ålem Sorgu ÃrneÄi  : /iletilemeyen-olaylar?syfNo=1&olyZmnBslTrh=2024-01-08T16:42:00+03:00&olyZmnBtsTrh=2024-01-09T17:09:00+03:00 \n ÃrneÄin; \n olyZmnBslTrh : 07/01/2024 10:00:00+03:00\n olyZmnBtsTrh : 09/01/2024 16:00:00+03:00\n Sorgu ZamanÄ± : 09/01/2024 10:15:00+03:00 \n YanÄ±t iÃ§erisinde yer alan veriye ait tarih aralÄ±ÄÄ± : 08/01/2024 00:00:00+03:00 - 09/01/2024 10:15:00+03:00 olmalÄ±dÄ±r. \n BaÅlangÄ±Ã§ ve bitiÅ zaman aralÄ±ÄÄ± Ã¶rnekte yer alan Åekilde seÃ§ilse dahi ilgili servis yanÄ±tÄ± iÃ§in Ã¶ncelikle sorgu zamanÄ±na bakÄ±lÄ±p 1 gÃ¼n Ã¶ncesinden sorgu anÄ±na kadar tÃ¼m kayÄ±tlarÄ±n iletilemeyen olaylar iÃ§erisinde listelenmesi saÄlanmalÄ±dÄ±r. \n Ä°lgili tarih aralÄ±ÄÄ±nda uygun veri olmamasÄ± halinde yanÄ±t gÃ¶vdesi boÅ olacak Åekilde dÃ¶nÃ¼lmelidir. \n Ä°letilemeyen Olaylar Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS Ä°letilemeyen Olaylar listesine ait bu sayfadaki kayÄ±tlarÄ± gÃ¶ndermelidir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶ndermelidir. \n \n \n Olay ZamanÄ± BaÅlangÄ±Ã§ Tarihi \n olyZmnBslTrh \n ISODateTime \n Ä° \n Sorgulanacak Olay ZamanÄ±na ait baÅlangÄ±Ã§ tarihi \n HHS'ler iletilemeyen olaylar listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan tetiklenen sorgularda; olyZmnBslTrh iletilmediÄi durumda ya da 1 gÃ¼n Ã¶ncesinin baÅlangÄ±Ã§ saatine gÃ¶re daha geri bir zaman dilimi gÃ¶nderildiÄinde, baÅlangÄ±Ã§ zamanÄ±(olyZmnBslTrh) deÄeri sorgu zamanÄ±ndan 1 gÃ¼n Ã¶ncesine ait gÃ¼nÃ¼n baÅlangÄ±Ã§ zamanÄ± olarak kabul edilmelidir. \n \n \n Olay ZamanÄ± BitiÅ Tarihi \n olyZmnBtsTrh \n ISODateTime \n Ä° \n Sorgulanacak Olay ZamanÄ±na ait bitiÅ tarihi \n HHS'ler iletilemeyen olaylar listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan tetiklenen sorgularda; olyZmnBtsTrh iletilmediÄi durumda ya da sorgu zamanÄ±ndan daha ileri bir zaman dilimi gÃ¶nderildiÄinde, bitiÅ zamanÄ±(olyZmnBtsTrh) deÄeri sorgu zamanÄ± olarak kabul edilmelidir. \n \n \n \n Tablo 17: Olaylar nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Olaylar \n olaylar \n Kompleks: Olaylar \n Z \n \n \n \n >Olay No \n olayNo \n AN1..64 \n Z \n Olaya ait evrensel tekil numaradÄ±r. \n \n \n >Olay Zamani \n olayZamani \n ISODateTime \n Z \n OlayÄ±n oluÅtuÄu tarih bilgisidir. \n \n \n >Olay Tipi \n olayTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >Kaynak NumarasÄ± \n kaynakNo \n AN1..128 \n Z \n GÃ¼ncellenen kaynaÄa ait HHS sistemindeki tekil tanÄ±mlayÄ±cÄ±. \n \n \n \n Kaynak numarasÄ±nda gÃ¶nderilen deÄer ile ilgili kaynaÄÄ± sorgulayarak almak YÃS'Ã¼n insiyatifindedir. \n ADIM 6: Sistem Olay Dinleme \n POST /sistem-olay-dinleme \n HHS'lerin sistem olaylarÄ±nÄ± dinleme amacÄ±yla aÃ§masÄ± gereken endpoint bilgisidir. \n YÃS API iÃ§erisinde yapÄ±lan deÄiÅikliklerde, BKM tarafÄ±ndan HHS'lere olay bildirimlerini yapÄ±lÄ±r. \n Olaylar yanÄ±t nesnesi iÃ§erisinde 1 adet kayÄ±t yer almalÄ±dÄ±r. \n BaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted kodu ile dÃ¶nÃ¼lmelidir. \n HHS'den baÅarÄ±lÄ± yanÄ±t alÄ±namadÄ±ÄÄ± durumda, 5 dakika aralÄ±klarla 3 kez deneme yapÄ±lacaktÄ±r. Hata alÄ±nmaya devam edilmesi durumunda baÅka bir aksiyon alÄ±nmayacaktÄ±r. \n Olay Dinleme Servisleri (ODS) \n YÃS sunacaÄÄ± Olay Dinleme Servisi ile hem HHS'den hem de BKM'den gelen olaylarÄ±n bildirimini dinleyebilir. YÃS'ler HHS'de yer alan olay abonelik kayÄ±tlarÄ±nÄ± iptal edebilir ancak BKM Sistem Olay Dinleme servisinin ileteceÄi bildirimlerin alÄ±nmasÄ± zorunlu olduÄundan ODS API her zaman aktif olmalÄ±dÄ±r. \n HHS'den gelecek olay bildirimlerini olay-dinleme endpointi ile dinlerken, BKM'den gelecek olay bildirimlerini sistem-olay-dinleme endpointi ile dinlemelidir. \n Olay Dinleme Servislerinde Idempotency kurallarÄ±nÄ±n iÅletilmesine gerek bulunmamaktadÄ±r. \n Olay Dinleme Servisine ait API Endpointleri aÅaÄÄ±daki tabloda listelenmiÅtir. \n Olay Dinleme Servisleri iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âolay_dinlemeâ \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n olay-dinleme \n POST \n /olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek \n - \n Olaylar \n - \n \n \n 2 \n sistem-olay-dinleme \n POST \n /olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n

16- \n - \n Olaylar \n - \n ADIM 1: Olay Dinleme \n POST /olay-dinleme \n Olay abonelik servisi ile abone olunan olaylar, olay dinleme servisi ile YÃS'e iletilir.\nOlaylar yanÄ±t nesnesi iÃ§erisinde en fazla 100 kayÄ±t gÃ¶nderilmelidir.\nBaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted ile dÃ¶nÃ¼lmelidir. \n HHS'nin iÅlem hata aldÄ±ÄÄ±nda, baÅarÄ±lÄ± iÅlem olana kadar 3 kez deneme yapÄ±lmasÄ± gerekmektedir.\nÄ°lk istekle son istek arasÄ±nda 30 dakika olacak Åekilde, zamana yayarak bu denemelerin yapÄ±lmasÄ± gerekmektedir. (Exponential backoff policy uygulanmasÄ± beklenmektedir. )\nHHS kendi sistemini yormayacak Åekilde, belirleyeceÄi kurallar dahilinde bu geliÅtirmeyi yapmalÄ±dÄ±r. \n Tablo 17: Olaylar nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n >KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >>Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n >> Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n >Olaylar \n olaylar \n Kompleks: Olaylar \n Z \n \n \n \n >>Olay NumarasÄ± \n olayNo \n AN1..64 \n Z \n Olaya ait atanmÄ±Å tekil kimlik numarasÄ± \n \n \n >>Olay ZamanÄ± \n olayZamani \n ISODateTime \n Z \n OlayÄ±n oluÅma zamanÄ± \n \n \n >>Olay Tipi \n olayTipi \n AN1..36 \n > \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >>Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >>Kaynak NumarasÄ± \n kaynakNo \n AN1..128 \n Z \n GÃ¼ncellenen kaynaÄa ait HHS sistemindeki tekil tanÄ±mlayÄ±cÄ±. \n ADIM 2:  Sistem Olay Dinleme \n POST /sistem-olay-dinleme \n YÃS'lerin sistem olaylarÄ±nÄ± dinleme amacÄ±yla aÃ§masÄ± gereken endpoint bilgisidir. \n HHS API iÃ§erisinde yapÄ±lan deÄiÅikliklerde, BKM tarafÄ±ndan YÃS'lere olay bildirimlerini yapÄ±lÄ±r. \n Olaylar yanÄ±t nesnesi iÃ§erisinde 1 adet kayÄ±t yer almalÄ±dÄ±r. \n BaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted kodu ile dÃ¶nÃ¼lmelidir. \n YÃS'ten baÅarÄ±lÄ± yanÄ±t alÄ±namadÄ±ÄÄ± durumda, 5 dakika aralÄ±klarla 3 kez deneme yapÄ±lacaktÄ±r. Hata alÄ±nmaya devam edilmesi durumunda baÅka bir aksiyon alÄ±nmayacaktÄ±r. \n"},{title:"4. RÄ±za DurumlarÄ±",frontmatter:{},regularPath:"/v1.1.0/contents/riza-durumlari.html",relativePath:"v1.1.0/contents/riza-durumlari.md",key:"v-3358815e",path:"/v1.1.0/contents/riza-durumlari.html",headers:[{level:2,title:"4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri",slug:"_4-1-hesap-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"},{level:2,title:"4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri",slug:"_4-2-odeme-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"}],content:" 4. RÄ±za DurumlarÄ± \n ÃHK, Ãdeme Emri BaÅlatma Hizmetine ya da Hesap Bilgisi Hizmetine mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi ile baÅlar. ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden yaptÄ±ÄÄ± iÅlemler neticesinde rÄ±za durumlarÄ± deÄiÅebilir.\nRÄ±zaânÄ±n alabileceÄi durum kodlarÄ± Åu Åekilde belirlenmiÅtir. \n B: Yetki Bekleniyor  â Ä°lk rÄ±za talebinde \n Y: Yetkilendirildi  â BaÅarÄ±lÄ± GKD sonrasÄ± yetKod Ã¼retildiÄinde \n K: Yetki KullanÄ±ldÄ±  â EriÅim Belirteci alÄ±ndÄ±ÄÄ±nda \n E: Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼  â ÃBHS iÃ§in \n S: Yetki SonlandÄ±rÄ±ldÄ± \nÂ Â Â Â HBHS iÃ§in : EriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde \nÂ Â Â Â ÃBHS iÃ§in : Yenileme belirteci Son Tarihi geldiÄinde \n I :Yetki Ä°ptal \nRÄ±za iptal durumu ise gerek raporlama gerekse mÃ¼Återi deneyimi perspektifinden doÄru   bilgilendirmeler yapÄ±labilmesi aÃ§Ä±sÄ±ndan aÅaÄÄ±daki gibi detay kodlarÄ± ile zenginleÅtirilmiÅtir: \n \n RÄ±za Ä°ptal Detay Kodu: \n \n \n \n â01â :\tYeni RÄ±za Talebi ile Ä°ptal \n â02â :\tKullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal \n â03â :\tKullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal \n â04â :\tSÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor \n â05â :\tSÃ¼re AÅÄ±mÄ± : Yetkilendirildi \n â06â :\tSÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi \n â07â :\tGKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± \n â08â :\tGKD iptali : RÄ±zano ile kimlik bilgileri uyuÅmamasÄ± \n â09â :\tGKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor \n â10â :\tGKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n â11â :\tGKD iptali : Hesap Yetki S

16orunu \n â12â :\tGKD iptali : ÃHK HHS kontrollerini aÅamadÄ± \n â13â :\tGKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi \n â14â :\tGKD iptali : Fraud ÅÃ¼phesi \n â99â :\tGKD iptali : DiÄer \n \n \n 4.1 ve 4.2 bÃ¶lÃ¼mlerinde detaylandÄ±rÄ±lan rÄ±za durum deÄiÅikliklerinde rÄ±za iptal detay kodlarÄ± kullanÄ±lmÄ±ÅtÄ±r. \n ÃrneÄin Bâ¨ I/01 denildiÄinde âYetki Bekleniyorâ rÄ±za durumundan âYetki Ä°ptalâ rÄ±za durumuna RÄ±za Ä°ptal Detay Kodu da â01â yani âYeni RÄ±za Talebi ile Ä°ptalâ olarak gÃ¼ncellenmelidir ifade edilmiÅtir. \n ÃHK verdiÄi rÄ±za sÄ±rasÄ±nda seÃ§tiÄi hesaplarÄ±ndan biri kapatÄ±lÄ±rsa, diÄer hesaplara ait bilgileri gÃ¶rmeye devam eder. Ancak ÃHKânÄ±n hesabÄ±na ait bilgilerinin YÃS'e iletilmesini istemediÄi durumda, rÄ±zasÄ±nÄ± tamamen iptal ederek yeni hesap listesi ile yeni rÄ±za vermesi gerekmektedir. Yani hesap kapanmasÄ± nedeniyle rÄ±za geÃ§erliliÄini yitirmez. ÃHK'nÄ±n proaktif olarak bu hesabÄ± rÄ±zadan Ã§Ä±karmasÄ± durumunda rÄ±za iptali olur. \n RÄ±za iptal edilmediÄi ve geÃ§erli olduÄu sÃ¼rece kapalÄ± hesaplar iÃ§in diÄer Ã§evrimiÃ§i kanallarda uygulanan yÃ¶ntem izlenmelidir. DiÄer Ã§evrimiÃ§i kanallarda kapalÄ± hesaplara iliÅkin bilgi dÃ¶nÃ¼lmÃ¼yor ise ÃHVPS'den de dÃ¶nÃ¼Å yapÄ±lmaz. ÃHKânÄ±n rÄ±za onayÄ± verdiÄi aÃ§Ä±k hesaplarÄ±nÄ±n tÃ¼mÃ¼ HHS tarafÄ±nda kapatÄ±ldÄ±ÄÄ± durumda, yine aynÄ± Åekilde HHS Ã§evrimiÃ§i kanallarÄ±nda koyduÄu kurallara gÃ¶re bu hesaplarÄ±nÄ±n YÃS uygulamasÄ±nda gÃ¶sterilmesine karar verir. \n Hesap kapama ve ticari kullanÄ±cÄ±larÄ±n hesaplar Ã¼zerindeki yetki deÄiÅiklikleri HHS'nin iÃ§ sistemleri tarafÄ±ndan yapÄ±lan kontrollerle yÃ¶netilir. Buradaki deÄiÅiklikler ile HHS sistemsel olarak rÄ±za iptali gerÃ§ekleÅtiremez. ÃHK izni ve onayÄ± dahilinde rÄ±za iptal gerÃ§ekleÅtirilmesi gerekmektedir. \n HHS'ler sunmuÅ olduklarÄ± RÄ±za Ä°ptal ekranÄ±nÄ± (sadece Hesap Bilgisi RÄ±zasÄ± iÃ§in), hangi ortamlardan GKD yapÄ±lmasÄ±na izin veriliyorsa (web/mobil) aynÄ± ortamdan ÃHK'ya sunmalÄ±dÄ±r.  ÃrneÄin bir HHS bireysel mÃ¼Återileri iÃ§in web ve mobil, kurumsal mÃ¼Återiler iÃ§in web Ã¼zerinden GKD imkanÄ± sunuyor ise, minimumda bireysel mÃ¼Återiler iÃ§in web ve mobil ortamlarÄ±ndan, kurumsal mÃ¼Återiler iÃ§in web ortamÄ±ndan RÄ±za Ä°ptal ekranÄ± aracÄ±lÄ±ÄÄ± ile rÄ±za iptaline izin vermelidir. Bunun dÄ±ÅÄ±nda Ã§aÄrÄ± merkezi ya da Åube gibi ortamlardan sunacaÄÄ± RÄ±za Ä°ptal imkanÄ± HHS inisiyatifindedir. Bahsi geÃ§en zorunluluk Ãdeme Emri RÄ±za Ä°ptal ekranÄ± iÃ§in geÃ§erli deÄildir. \n Benzer Åekilde YÃS'ler hangi ortamlardan (web/mobil) hizmet veriyorsa, aynÄ± ortam Ã¼zerinden RÄ±za Ä°ptal ekranÄ±nÄ± sunmalÄ±dÄ±r. \n 4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n, bir YÃS iÃ§in, bir HHS'de Y, K, B rÄ±za durumlarÄ±nda tek bir rÄ±zasÄ± olabilir.\nBir ÃHK hem kiÅisel olarak hem de bir kurumun kullanÄ±cÄ±sÄ± olabilir. Bu durumda kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Hesap Bilgisi RÄ±zasÄ± isteÄi HHSâye iletilir. \na.\tHHS ÃHK'ya ait iÃ§eride rÄ±za var mÄ± kontrol eder. EÄer yoksa  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \nb.\tEÄer iÃ§eride rÄ±za varsa \nÂ Â Â Â  i. RÄ±za durumu Yetki Bekleniyor - B ise; \nÂ Â Â Â     HHS, sistemde Yetki Bekleniyor - B rÄ±za durumuna sahip kayÄ±t olduÄu iÃ§in, Ã¶ncelikle eski kaydÄ± Yetki Ä°ptal - I durumuna getirir.  RÄ±za Ä°ptal Detay Kodu âYeni RÄ±za Talebi ile iptalâ olmalÄ±dÄ±r.  B â¨ I / 01  SonrasÄ±nda,  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \n Â Â Â Â  ii. RÄ±za durumu Yetkilendirildi - Y veya Yetki KullanÄ±ldÄ± - K ise; \nÂ Â Â Â ÃHK'nÄ±n halihazÄ±rda verilmiÅ bir rÄ±zasÄ± vardÄ±r. HHS, Ã¶nce mevcut rÄ±zanÄ±n iptalinin yapÄ±lmasÄ± gerektiÄine dair   TR.OHVPS.Resource.ConsentMismatch  hatasÄ±nÄ± dÃ¶ner. YÃS, HHS ya da YÃS uygulamasÄ± Ã¼zerinden bu rÄ±zanÄ±n iptal edilmesi gerektiÄine dair ÃHK'ya bilgilendirme yapar. \n Â Â Â Â  iii.\tRÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise Yetki Bekleniyor - B durumunda yeni rÄ±za no oluÅturur. \n Â Â Â Â  iv.\tRÄ±za durumu Yetki Ä°ptal - I ise  Yetki Bekleniyor - B  durumunda yeni rÄ±za no oluÅturur. \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda RÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.  B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: TarayÄ±cÄ±yÄ± kapatmÄ±Å olabilir) RÄ±za Yetki Bekleniyor - B rÄ±za durumunda kalÄ±r.  5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B rÄ±za durumundaki kayÄ±tlar Yetki Ä°ptal  : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir.   B â¨ I / 04  Bkz. 9. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine  rizaIptDtyKod  deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 12 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 13 \n \n \n Fraud ÅÃ¼phesi Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 99 \n \n \n \n \n \n \n ÃHK, hesaplarÄ±nda/izin tÃ¼rlerinde/EriÅimin GeÃ§erli OlduÄu Son Tarih bilgilerinden bir ya da birden fazlasÄ±nda gÃ¼ncelleme yapmak iÃ§in YÃS ekranÄ±na girer. \n \n \n Â Â Â Â a.\tYÃS Ã¶nce RÄ±za Ä°ptal API'sini Ã§aÄÄ±rÄ±r. Sonra yeni deÄerlerle yeni bir rÄ±za isteÄinde bulunur. Tekrar GKD gerekir. \n Â Â Â Â b.\tYÃS rÄ±za iptal yapmadan yeni rÄ±za alma akÄ±ÅÄ±na baÅlarsa 1.b akÄ±ÅÄ± devreye girer. \n Â Â Â Â c.\tRÄ±za gÃ¼ncelleme ilerleyen sÃ¼rÃ¼mlerde ele alÄ±nacaktÄ±r. \n \n \n EriÅim Belirteci API \n a. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda;

16 \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetki KullanÄ±ldÄ± - K  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Sorgulama: HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir hesap bilgisi-rizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. RÄ±za numarasÄ± ile sorgulama yapÄ±lÄ±r. \n \n \n Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali: HBHS Ã¼zerinden ya da HHS Ã¼zerinden yapÄ±lan rÄ±za iptallerinde RÄ±za durumu  Yetki Ä°ptal - I olarak gÃ¼ncellenir. RÄ±za numarasÄ± ile iptal saÄlanÄ±r. \n a. HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir.  RÄ±za durumu sorgulanÄ±r. \n RÄ±za numarasÄ± Yetki Bekleniyor - B ve Yetkilendirildi - Y ve Yetki KullanÄ±ldÄ± - K durumlarÄ±nda ise Yetki Ä°ptal durumuna getirilir. RÄ±za gnclzmn timestamp ile gÃ¼ncellenir.\nHHS, RÄ±za iptalinde aynÄ± zamanda eriÅim belirtecini de invalid hale getirmelidir. \n B â¨ I / 02 \n Y â¨ I / 02 \n K â¨ I / 02 \n b.\tYÃS Ã¼zerinden yapÄ±lacak iptal iÅleminde yine Y ve B ve K rÄ±za durumlarÄ±nda ise iptal edilebilir. \n B â¨ I / 03 \n Y â¨ I / 03 \n K â¨ I / 03 \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise iptal gerÃ§ekleÅmez. âRÄ±za durumunuz iptal etmeye uygun deÄildir.â hatasÄ± ÃHK'ya yansÄ±tÄ±lÄ±r.  TR.OHVPS.Resource.ConsentRevoked \n \n \n ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.\nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde RÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ± durumuna Ã§ekilmelidir.   K â¨ S \n \n \n Hesaplar, Bakiye ve Ä°Ålemler servislerinde eriÅim belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.\nGeÃ§erli bir eriÅim belirteci yok ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n YÃS'Ã¼n; RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda Hesaplar, Bakiye ve Ä°Ålemler servislerini Ã§aÄÄ±rmamasÄ± beklenir. HHS'nin bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda  TR.OHVPS.Resource.ConsentRevoked  hatasÄ±nÄ± dÃ¶nmesi gereklidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K dÄ±ÅÄ±nda ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± verilmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K ise servis akÄ±ÅlarÄ±na devam edilir. \n RÄ±za sorgulama API'sinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound hatasÄ±  verilmelidir. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir âYetki Bekleniyorâ durumunda kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor  â¨ RÄ±za Ä°ptal  / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir âYetkilendirildiâ durumunda kalan kayÄ±tlar gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ±: Yetkilendirildi  B â¨ I / 05 \nYukarÄ±da bahsedilen, YÃS SÃ¼re AÅÄ±mÄ± nedeniyle rÄ±za iptal durum gÃ¼ncellemelerini y

16apmadan Ã¶nce HHSâyi sorgulayarak rÄ±za durumunu Ã¶Ärenmeli ve sÃ¼re aÅÄ±mÄ± dÄ±ÅÄ±nda bir kodu varsa aynÄ± kodla kendi sistemini gÃ¼ncellemelidir. \nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde rÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ±âya gÃ¼ncellenir.  K â¨ S \n 4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n bir YÃS iÃ§in bir HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n Kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ± isteÄi HHSâye iletilir. Ä°Ã§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za no oluÅturur. \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda rÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.   B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: BrowserÄ± kapatmÄ±Å olabilir)\nRÄ±za durumu Yetki Bekleniyor'dur. 5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B durumundaki kayÄ±tlar RÄ±za Ä°ptal : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir. Bkz. 8. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine rizaIptDtyKod deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 12 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 13 \n \n \n Fraud ÅÃ¼phesi Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 99 \n \n \n \n \n \n \n GKD muafiyeti olduÄunda YÃS HHSâden arka planda onay alÄ±r. Bu onay sÄ±rasÄ±nda rÄ±za durumu  Yetkilendirildi  yapÄ±lÄ±r.  B â¨ Y \n \n \n EriÅim Belirteci API \na. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda; \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B , Yetki KullanÄ±ldÄ± - K  ya da Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K veya Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Ãdeme BaÅlatma API Ã¶nce eriÅim belirteci ve sonrasÄ±nda rÄ±za kontolÃ¼ yapÄ±larak gerÃ§ekleÅtirilmelidir \n \n Ãncelikle EriÅim Belirteci kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir EriÅim Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki S

16onlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Bekleniyor - B , Yetkilendirildi - Y, Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda Ã¶deme emri gerÃ§ekleÅtirilir.  RÄ±za durumu Yetki KullanÄ±ldÄ± - K'dan Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E yapÄ±lmalÄ±dÄ±r.   K â¨E \n \n \n \n Sorgulama: GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlarda, Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle, Ã¶demeEmriRizasi nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r.\nRÄ±za sorgulama, Ãdeme Emri Sorgulama API'lerinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound  hatasÄ± verilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ±nÄ±n Ä°ptali bulunmamaktadÄ±r. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir Yetki Bekleniyor'da kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir Yetkilendirildi'de kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetkilendirildi  B â¨ I / 05 \n 5 dakikadan uzun sÃ¼redir Yetki kullanÄ±ldÄ±'da kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetki kullanÄ±ldÄ± â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi  B â¨ I / 06 \n Yenileme belirteci Son Tarih geldiÄinde rÄ±za durumu Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼âden Yetki SonlandÄ±rÄ±ldÄ±'ya gÃ¼ncellenir. \n E â¨ S \n \n \n GKD muafiyeti sadece Ã¶deme baÅlatma servislerinde bulunmaktadÄ±r. \n \n \n"},{title:"6.\tÃdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v1.1.0/contents/odeme-emri-baslatma-hizmeti.html",relativePath:"v1.1.0/contents/odeme-emri-baslatma-hizmeti.md",key:"v-7e5b51bd",path:"/v1.1.0/contents/odeme-emri-baslatma-hizmeti.html",headers:[{level:3,title:"Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi",slug:"_6-1-adim-0-odeme-emri-baslatma-istegi"},{level:2,title:"6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_6-2-adim-1-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_6-3-adim-2-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_6-4-adim-2-1-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ±",slug:"_6-5-adim-3-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_6-6-adim-3-1-odeme-emri-sorgusu-istege-baglÄ±"},{level:3,title:"GET /odeme-emri/{odemeEmriNo}",slug:"get-odeme-emri-odemeemrino"}],content:" 6.\tÃdeme Emri BaÅlatma Hizmeti \n Ãdeme emri baÅlatma iÅlemi havale, FAST ya da PÃS Ã¶demesiyle sonuÃ§lanabilir. Ãdeme iÅleminin amacÄ± kiÅiden kiÅiye para transferi, e-ticaret Ã¶demesi gibi farklÄ± Ã¶deme tÃ¼rleri olabilir. Ãdemenin amacÄ±na gÃ¶re ÃBHSânin ileteceÄi veri setinde farklÄ±laÅmalar olabilir. \n Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n Ãdeme Emri BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden Ã¶deme emrini baÅlatÄ±r. \n Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âÃdeme Emri BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âÃ¶deme emriâni HHSâye iletir. \n Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±)  mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin hem HBH hem de ÃBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini(Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n YÃS'ler gÃ¶nderen hesap seÃ§imini aÅaÄÄ±daki yÃ¶ntemlerden biri ya da birkaÃ§Ä± ile saÄlayabilirler: \n \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± HHS ekranÄ±ndan seÃ§tirebilir. \n YÃS, mÃ¼Återisinden Hesap Bilgisi rÄ±zasÄ± alÄ±r. RÄ±za aldÄ±ÄÄ± hesaplar Ã¼zerinden hesap referansÄ± aracÄ±lÄ±ÄÄ± ile Ã¶deme emri baÅlatabilir. \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± elle girmesine olanak tanÄ±yabilir. IBAN'Ä± olmayan HHS'ler Ã¶deme emri rÄ±zasÄ± adÄ±mÄ±nda  TR.OHVPS.Business.IBANNotSupported  hatasÄ±nÄ± vermelidir. IBAN'Ä± olan HHS'lerin bu akÄ±ÅÄ± desteklemesi zorunludur. \n YÃS; mÃ¼Återisinin hesap referansÄ±nÄ± elle girmesini saÄlayabilir. Hesap ReferansÄ± bilgisi ile baÅlatÄ±lan Ã¶deme emri iÅlemlerinde HHS seÃ§imi zorunludur. \n \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in, YÃS'ler hesap referansÄ± ile Ã¶deme baÅlatabilirler. Bu

16nlarÄ±n dÄ±ÅÄ±ndaki HHS'lerin, gÃ¶nderen IBAN veya hesap referansÄ± ile Ã¶deme akÄ±ÅÄ±nÄ± desteklemesi zorunludur. \n \n Åekil 4: Ãdeme Emri BaÅlatma Hizmeti Ãst DÃ¼zey Ä°Å AkÄ±ÅÄ± \n Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. \n Tablo 6: Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n odeme-emri-rizasi \n POST \n /odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriRizasiIstegi \n OdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n odeme-emri-rizasi \n GET \n /odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmriRizaYaniti \n \n \n 3 \n odeme-emri \n POST \n /odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriIstegi \n OdemeEmri \n \n \n 3.1 \n odeme-emri \n GET \n /odeme-emri/{odemeEmriNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmri \n 6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) Ã¶deme emri baÅlatma iÅlemine onay verir. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil 5: Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (odemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ mi? \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahip mi? \n Ä°stekte bulunulan HHS kodu doÄru mu? \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren odemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir OdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme adresleri ile Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini y

16apar. (Zorunlu) \n HHS; kimlik bilgileri nesnesinde eÄer kimlik bilgileri iletilmiÅ ise; bu veri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (KoÅullu Zorunlu) \n HHS kimlik bilgisi ile gÃ¶nderen unvanÄ±nÄ±n uyumlu olduÄunun kontrol eder. HHS'ler EFT/FAST iÅlemlerinde kabul ettikleri kontrol kriterleri ile iÅleme izin verebilirler. (Zorunlu) \n GÃ¶nderen Hesap NumarasÄ± ile ilgili Tablo7âde belirtilen kontroller yapÄ±lmalÄ±dÄ±r. (Zorunlu) \n HHS, Ã¶deme iÃ§in benzersiz âRizaNoâ ile âOdemeEmriRizasiâ nesnesi oluÅturur ve ÃBHSâye dÃ¶ner. \n HHS, OdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \nBu aÅamada ÃHKânÄ±n HHS tarafÄ±ndan tanÄ±mlanmÄ±Å ve isteÄin veri alanÄ±nda gÃ¶nderen hesaba (borÃ§landÄ±rÄ±lacak hesaba) iliÅkin bir bilgisinin olmasÄ± gerekmez. \nHesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n \n POST /odeme-emri-rizasi  isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âodemeEmriRizasiIstegiâ nesnesi (Tablo-7) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âodemeEmriRizasiâ (Tablo-8) nesnesi oluÅturulur. \n Tek Seferlik Ãdeme \nTek seferlik Ã¶deme akÄ±ÅÄ± YÃS'ten HHS'ye giden istekte, gÃ¶nderen kimlik bilgilerinin olmadÄ±ÄÄ± durumda gerÃ§ekleÅir. GÃ¶nderen kimlik bilgisi olmadÄ±ÄÄ±nda, KOLAS sorgusu yapÄ±lamayacaÄÄ±ndan Ã¶tÃ¼rÃ¼, HHS tarafÄ±ndan TR.OHVPS.Business.InvalidContent hatasÄ± dÃ¶nÃ¼lmelidir.  ÃHK'nÄ±n YÃS'Ã¼n mÃ¼Återisi olmadÄ±ÄÄ± durumda tek seferlik Ã¶deme baÅlatÄ±labilir. \nTek seferlik Ã¶deme akÄ±ÅÄ± hem iÅyeri Ã¶demelerinde hem de kiÅiden kiÅiye para transferlerinde kullanÄ±labilen bir akÄ±ÅtÄ±r. Ä°Åyeri tarafÄ±ndan baÅlatÄ±lan tek seferlik Ã¶deme iÅlemlerinde katÄ±lÄ±mcÄ±lar gÃ¶nderen ÃHK'dan Ã¼cret alÄ±namaz.\n Tek seferlik Ã¶deme akÄ±ÅÄ± sadece bireysel mÃ¼Återiler iÃ§in kullanÄ±labilir. \nTek seferlik Ã¶deme akÄ±ÅÄ±nda hem yÃ¶nlendirmeli hem de ayrÄ±k GKD akÄ±ÅÄ± ile mÃ¼Återi yetkilendirmesi saÄlanabilir. \n AÅaÄÄ±daki senaryolar tek seferlik Ã¶demeye Ã¶rnek olarak gÃ¶sterilebilir. \n Ä°Åyeri Ãdemesi akÄ±ÅÄ± Ã¶rneÄi: Bir e-ticaret sitesinde, Ã¼ye olmadan alÄ±ÅveriÅ yapÄ±lmasÄ± ve Ã¶demenin YÃS tarafÄ±ndan kimlik bilgisi olmadan baÅlatÄ±lmasÄ± \nKiÅiden kiÅiye para transferi akÄ±ÅÄ± Ã¶rneÄi: QR veya diÄer yÃ¶ntemler ile alÄ±cÄ± bilgilerinin gÃ¶nderici ile paylaÅÄ±lmasÄ± ve YÃS Ã¼zerinden gÃ¶nderici bilgileri olmadan alÄ±cÄ±ya para transferi yapÄ±lmasÄ± iÃ§in rÄ±za verilmesi \n  BAÅARILI Ä°STEK: \n Tablo 7: âOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidASPSP  hata kodunu dÃ¶ner. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. Hata durumunda  TR.OHVPS.Connection.InvalidTPP  hata kodunu dÃ¶ner. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  Durum ko

16du(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.ohkTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir para birimi olduÄu kontrol eder. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n K \n GÃ¶nderenin unvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.  Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen unvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  TR.OHVPS.Business.InvalidContent  hatasÄ± verilmelidir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir.  Kontrol baÅarÄ±sÄ±z olduÄunda  TR.OHVPS.Business. InvalidAccount  hatasÄ± YÃSâe iletilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, Hs

16pRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n unvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r.  FAST-TR Karekod dÄ±ÅÄ±ndaki iÅ yeri Ã¶demelerinde; yine Unvan alanÄ±nda iÅyeri adÄ± bilgisi gÃ¶nderilmelidir. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n Tek seferlik Ã¶demelerde ( kimlik bilgileri boÅ iletildiÄinde) KOLAS nesnesi dolu iletiliyorsa; HHS tarafÄ±ndan TR.OHVPS.Business.InvalidContent hatasÄ± dÃ¶nÃ¼lmelidir \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n HHS, YÃS'Ã¼n API deseninde \"O\" kodunu ilettiÄini kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarÄ±nda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.   -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tÄ°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n YÃS bu deÄeri ÃHKâyÄ± HHSâye yÃ¶nlendirmeden Ã¶nceki ekranda gÃ¶stermeli, ve HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak yine ÃHKâya gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi

16iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r.  Ä°Åyeri Ãdeme Bilgileri, YÃS uygulama Ã¶nyÃ¼zÃ¼nde ÃHKânÄ±n bildiÄi ve giriÅi yapÄ±lmasÄ± beklenen bir bilgi olmamalÄ±dÄ±r. YÃS tarafÄ±ndan sistemsel olarak doldurulmasÄ± gereklidir. \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir.  4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriRizasiâ nesnesi Tablo-8âdeki parametrelerden oluÅur: \n Tablo 8: âOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n \n \n \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n >> Unvan \n unv \n AN3..140 \n K \n GÃ¶nderenin unvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.   Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen unvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.    Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisidir. Bu alan ileri vadeli Ã¶demeler iÃ§in dÃ¼ÅÃ¼nÃ¼lmÃ¼ÅtÃ¼r. Ä°lk fazda doldurulmasÄ±na gerek olmadÄ±ÄÄ± dÃ¼ÅÃ¼nÃ¼lmektedir. \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil 6: Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS,

16ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n Ã¶deme emrini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âodemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle,  OdemeEmriRizasi  nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  OdemeEmriRizasi  nesnesine iÅler. \n GET /odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  OdemeEmriRizasi  kaynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n Durum \n OdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n Ãdeme Emri RÄ±zasÄ± sonlandÄ±rÄ±ldÄ± ve iptal statÃ¼sÃ¼nde olan rÄ±za'larÄ±n gÃ¼ncellenme zamanÄ±ndan(gnclZmn) 6 ay sonrasÄ±na kadar sorgulanabilir olmasÄ± beklenmektedir. HHS'ler ilgili sÃ¼re sonrasÄ±nda yapÄ±lacak rÄ±za sorgularÄ±na TR.OHVPS.Resource.NotFound uyarÄ±sÄ± verebilir. YÃS'ler tarafÄ±ndan iptal ve sonlandÄ±rÄ±ldÄ± statÃ¼sÃ¼nde olan rÄ±zalar iÃ§in sorgulama yapmamalÄ±dÄ±r. \n Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /odeme-emri-rizasi/{RizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-8âde yer alan parametreleri iÃ§eren âOdemeEmriRizasiâ oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /odeme-emri-rizasi/{RizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemlerinde, Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgilerinin Ã¶deme emri rÄ±zasÄ± sÄ±rasÄ±nda gÃ¶nderimi zorunlu deÄildir. BaÅarÄ±lÄ± GKD sonrasÄ±, yani eriÅim belirteci alÄ±ndÄ±ÄÄ±nda, Ã¶deme emri oluÅmadan Ã¶nce, YÃSâÃ¼n Ã¶deme emri rÄ±zasÄ±nÄ± sorgulayarak bu bilgileri almasÄ± ve Ã¶deme emrini oluÅtururken Kimlik TÃ¼rÃ¼, Kimlik Verisi ve GÃ¶nderen Unvan alanlarÄ±nÄ± dolu olarak gÃ¶ndermesi beklenmektedir.  Ancak rÄ±za durumu âYetki Bekleniyor - Bâ, âYetkilendirildi - Yâ ve âYetki Ä°ptal - Iâ statÃ¼lerinde ise, Ã¶deme emri rÄ±zasÄ± sorgulamasÄ±nda, HHSânin Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgisini Y

16ÃS ile paylaÅmamasÄ± gerekmektedir. \n 6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Ãdeme Emrinin OluÅturulmasÄ± \n POST /odeme-emri \n \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS OdemeEmri kaynaÄÄ±nÄ± oluÅturur. \n Ãdeme emri (OdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r.\n \n POST HHS tarafÄ±ndan iÅlenir: RizaDurumu âYetki KullanÄ±ldÄ±â ise iÅleme baÅlanÄ±r. \n POST /odeme-emri-rizasi ile POST /odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r.POST verisindeki GÃ¶nderen Hesap NumarasÄ± ve AlÄ±cÄ± Hesap NumarasÄ±nÄ±n aynÄ± bankaya aitse HAVALE deÄilse FAST veya PÃS iÅ akÄ±ÅÄ±na geÃ§ilir. \n POST verisinin modele gÃ¶re kontrolÃ¼ yapÄ±lÄ±r (alan kontrolleri) \n POST verisinin mantÄ±ksal kontrolleri yapÄ±lÄ±r (IBAN kontrolÃ¼, Ã§apraz alan kontroller) \n OdemeEmriDurumu âGerÃ§ekleÅtiâ / âGÃ¶nderildiâ / âGerÃ§ekleÅmediâ olarak gÃ¼ncellenir. \n \n \n POST baÅarÄ±lÄ± olursa, iÃ§erisinde OdemeEmriNo ve OdemeEmriDurumu deÄiÅkenleri de bulunan OdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n \n BAÅARILI Ä°STEK: \n Tablo 9: âOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidASPSP  hata kodunu dÃ¶ner. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda  TR.OHVPS.Connection.InvalidTPP  hata kodunu dÃ¶ner. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n >YÃ¶nlendirme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n \n \n \n \n \n \n \n \n \n >AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur. yetYntm = Y iÃ§in bu nesne iletilmemelidir. \n \n \n \n >>OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >>OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n \n \n >Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde,

161. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Ãdeme Emri RizasÄ± Nesnesindeki Ä°Ålem TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS iÅlem tutarÄ± Ã¶deme mesajÄ±nda (Havale/FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n Ttr \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari unvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>>

16 Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n KolasRef ( hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. \n RefBlg (Hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n FAST/PÃS Acklm \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme Sistemi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem sa

16atleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r.  Ä°Åyeri Ãdeme Bilgileri, YÃS uygulama Ã¶nyÃ¼zÃ¼nde ÃHKânÄ±n bildiÄi ve giriÅi yapÄ±lmasÄ± beklenen bir bilgi olmamalÄ±dÄ±r. YÃS tarafÄ±ndan sistemsel olarak doldurulmasÄ± gereklidir. \n \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n \n \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n Z \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Emir Bilgileri \n emrBlg \n Kompleks: EmirBilgileri \n Z \n \n \n \n > Ãdeme Emri NumarasÄ± \n odmEmriNo \n AN1..128 \n Z \n odemeEmri nesnesinin UID'sidir. OdemeEmrine Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Ãdeme Emri Zaman \n odmEmriZmn \n ISODateTime \n Z \n odemeEmri nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari unvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.  Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Unvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari unvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen unvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ  deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme Durumu \n odmDrm \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r.      Ãdeme Durumu alanÄ± ile ilgili olarak HHSâler tarafÄ±ndan YÃSâlere  OdemeEmri servisi yanÄ±tÄ±nda 02:GÃ¶nderildi, 04:Onayda Bekliyor,05:Ä°Åleme AlÄ±ndÄ± yanÄ±tlarÄ± gÃ¶nderilebilir.   05:Ä°Åleme AlÄ±ndÄ±  durumu YÃS tarafÄ±ndan mÃ¼Återiye gÃ¶sterilmeyen bir koddur. Bu kod dÃ¶nÃ¼ldÃ¼ÄÃ¼nde YÃS uygulamasÄ±nda ÃHKâya Ã¶deme durumu  02:GÃ¶nderildi  olarak gÃ¶sterilir. Ä°Ålemin son durumunun teyidi iÃ§in YÃS Ã¶deme emri sorgulamasÄ± yapmalÄ±dÄ±r.   02:GÃ¶nderildi  durumu oluÅtuktan sonra YÃS tarafÄ±ndan Ã¶deme emri sorgulamasÄ± yapÄ±larak Ã¶deme durumunun gÃ¼ncel deÄeri Ã¶Ärenilir. GÃ¼ncel deÄerler  01:GerÃ§ekleÅti,03:GerÃ§ekleÅmedi  durumlarÄ± olabilir. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Ãdeme Sistem NumarasÄ± \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. Havale/FAST/PÃS  Ã¶deme yÃ¶ntemleri iÃ§in tarih alanÄ± yyyy-aa-gg formatÄ±nda 10 karakter olarak iletilmelidir. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi

16iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Ãdeme Emri Sorgusu \n GET /odeme-emri/{odemeEmriNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla Ã¶deme emrini sorgulayabilir. \n BAÅARILI YANIT: \n GET /odeme-emri/{odemeEmriNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âOdemeEmriâ nesnesi dÃ¶ner. \n"},{title:"5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama",frontmatter:{},regularPath:"/v1.1.0/contents/gkd.html",relativePath:"v1.1.0/contents/gkd.md",key:"v-8d4168c6",path:"/v1.1.0/contents/gkd.html",headers:[{level:2,title:"5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-1-yonlendirmeli-guclu-kimlik-dogrulama"},{level:2,title:"5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-2-ayrÄ±k-guclu-kimlik-dogrulama"},{level:3,title:"5.2.1\tStatik Model",slug:"_5-2-1statik-model"},{level:2,title:"5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi",slug:"_5-3-yonlendirme-bildirim-adresleri-ve-durum-kodu-parametresi"},{level:2,title:"5.4  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri",slug:"_5-4-guclu-kimlik-dogrulama-kontrolleri"}],content:" 5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n MÃ¼Återi iÃ§in gÃ¼Ã§lÃ¼ kimlik doÄrulama, ÃHKânÄ±n (mÃ¼Återinin) kimliÄinin doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin âbildiÄiâ, âsahip olduÄuâ veya âbiyometrik bir karakteristiÄi olanâ bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntemi tanÄ±mlar. \n Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄ uyarÄ±nca hesap bilgisi hizmetinde mÃ¼Återinin onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda ve Ã¶deme emri baÅlatma hizmetinde her bir Ã¶deme emri baÅlatma iÅleminde  HHS tarafÄ±ndan mÃ¼Återiye gÃ¼Ã§lÃ¼ kimlik doÄrulama (GKD) uygulanmasÄ± esastÄ±r.  Buna gÃ¶re: \n \n \n Hesap bilgisi hizmetinde ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda  TebliÄin 26 ncÄ± maddesinin 1 inci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya GKD uygulanÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 2 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanÄ±r ve iÅlem doÄrulama kodu ile ÃHKânÄ±n onayÄ± alÄ±nÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 3 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanmasÄ±na iliÅkin istisna veya ilave gÃ¼venlik Ã¶nlemleri iÅbu API Ä°lke ve KurallarÄ± belgesinde tanÄ±mlanÄ±r. \n \n \n HHS, gÃ¼Ã§lÃ¼ kimlik doÄrulama sÃ¼recinde ÃHKânin sahip olduÄu bileÅen sÄ±nÄ±fÄ± olarak SMS OTP ya da SMS ile iÅlem doÄrulama kodu kullanabilir. \n \n \n HHS, aÅaÄÄ±daki hallerde veya  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re tek bileÅen ile kimlik doÄrulama yapabilir. \n \n Ãdemenin gÃ¶ndereni ve alÄ±cÄ±sÄ±nÄ±n aynÄ± olmasÄ±, \n Daha Ã¶nce tanÄ±mlanmÄ±Å gÃ¼venli alÄ±cÄ±lar listesine Ã¶deme yapÄ±lmasÄ±, \n ÃHKânin talimatÄ±na istinaden gerÃ§ekleÅtirilen dÃ¼zenli bir Ã¶deme olmasÄ±. \n \n \n \n Tek bileÅen ile kimlik doÄrulama yapÄ±lan bu iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin mÃ¼Återi tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye ait olur. \n \n \n Ä°Ålem DoÄrulamada  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± ÄÄ bendindeki  iÅlem bilgisi tanÄ±mÄ±na uygun olarak aÅaÄÄ±daki bilgiler ile  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  tanÄ±mlanan iÅleme Ã¶zel Ã¼retilmiÅ iÅlem doÄrulama kodu birlikte kullanÄ±lÄ±r. \n \n AlÄ±cÄ± Unvan (Kolas akÄ±ÅÄ±nda maskeli olarak)  (Ã¶deme emri baÅlatma hizmeti) \n Tutar (Ã¶deme emri baÅlatma hizmeti) \n Referans bilgisi (8 karakterden kÃ¼Ã§Ã¼k ise alanÄ±n tÃ¼m deÄeri, bÃ¼yÃ¼k ise ilk 4 ve son 4 hanesi) \n \n Ä°Åleme ait yukarÄ±daki bilgilerden en az biri deÄiÅtiÄi zaman  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  belirtildiÄi gibi yeni bir iÅlem doÄrulama kodu Ã¼retilecek Åekilde akÄ±Å kurgulanmalÄ±dÄ±r. \n \n \n Ä°Ålem doÄrulama kodunun gÃ¶nderilmesinden HHS sorumludur. HHS,  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re iÅlem doÄrulama kodu kullanmaksÄ±zÄ±n ÃHKânÄ±n onayÄ±nÄ± alabilir. Ä°Ålem doÄrulama kodu kullanÄ±lmayan iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin ÃHK tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye aittir. \n \n \n ÃHVPS API Ä°lke ve KurallarÄ± kapsamÄ±nda iki adet GÃ¼Ã§lÃ¼ Kimlik DoÄrulama (GKD) yÃ¶ntemi kullanÄ±lacaktÄ±r: \n \n YÃ¶nlendirmeli (Redirect) GKD YÃ¶ntemi \n AyrÄ±k (Decoupled) GKD YÃ¶ntemi \n \n \n \n HHS asgari olarak tarayÄ±cÄ± tabanlÄ± YÃ¶nlendirmeli GKD yÃ¶ntemini desteklemek zorundadÄ±r. Hem web hem mobil uygulama hizmeti bulunan katÄ±lÄ±mcÄ±lar iÃ§in her iki uygulama Ã¶zelinde de yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. Web ya da mobil uygulamalardan sadece birinin olmasÄ± durumunda ilgili uygulama Ã¶zelinde yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. \n \n \n HHSânin mobil uygulamasÄ±nÄ±n bulunmasÄ± durumunda tarayÄ±cÄ± tabanlÄ± yÃ¶nlendirmenin y

16anÄ±nda uygulama tabanlÄ± yÃ¶nlendirme yapmasÄ± zorunludur. Uygulama sahiplerinin uygulama tabanlÄ± yÃ¶nlendirme iÃ§in uyumlanma son tarihleri 1 Ekim 2023âtÃ¼r. \n 5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n YÃ¶nlendirmeli GKD YÃ¶nteminde, mÃ¼Återi kimlik doÄrulama iÃ§in YÃS tarafÄ±ndan HHS arayÃ¼zÃ¼ne yÃ¶nlendirilir. \n MÃ¼Återi HHSâye (app veya web arayÃ¼zÃ¼ vasÄ±tasÄ±yla) yÃ¶nlendirildikten sonra mÃ¼Återinin gÃ¼Ã§lÃ¼ kimlik doÄrulamasÄ± adÄ±m adÄ±m ve doÄrudan HHS ile mÃ¼Återi arasÄ±nda yÃ¼rÃ¼tÃ¼lÃ¼r. GKDânin tamamlanmasÄ±ndan sonra mÃ¼Återi tekrar YÃS uygulamasÄ±na yÃ¶nlendirilir. \n YÃ¶nlendirmeli GKD YÃ¶ntemi iÃ§in Ã¼st dÃ¼zey Ã¶rnek iÅ akÄ±ÅÄ± aÅaÄÄ±daki adÄ±mlardan oluÅur: \n \n YÃS, GKD iÃ§in HHS tarafÄ±ndan tanÄ±mlanan arayÃ¼ze (tarayÄ±cÄ± ya da uygulama) yÃ¶nlendirme yapar. \n MÃ¼Återi, YÃS arayÃ¼zÃ¼nden ayrÄ±lÄ±r, yÃ¶nlendirildiÄi HHS arayÃ¼zÃ¼ Ã¼zerinde kimlik doÄrulama iÅlemlerini gerÃ§ekleÅtirir. \n GKD tamamlandÄ±ktan sonra mÃ¼Återi, YÃS arayÃ¼zÃ¼ne tekrar yÃ¶nlendirilir ve iÅlem sonucu gÃ¶rÃ¼ntÃ¼lenir. \n \n YÃ¶nlendirmeli GKD iÃ§in temel gereklilikler ÅunlardÄ±r: \n \n Ãdeme hizmeti (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) tarayÄ±cÄ± ya da uygulama tabanlÄ± bir Åekilde sunulabilir. Bu nedenle, YÃS ve HHSâlerin YÃ¶nlendirmeli GKD iÃ§in asgari olarak tarayÄ±cÄ± tabanlÄ± yÃ¶nlendirme akÄ±ÅÄ±nÄ± desteklemeleri gerekmektedir. Web ya da mobil uygulamalardan sadece birinin olmasÄ± durumunda ilgili uygulama Ã¶zelinde yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n YÃ¶nlendirmeli GKD YÃ¶nteminde; rÄ±za isteÄine baÅarÄ±lÄ± yanÄ±t alÄ±ndÄ±ktan sonra, ÃHK, kimlik doÄrulama iÃ§in YÃS tarafÄ±ndan HHS arayÃ¼zÃ¼ne yÃ¶nlendirilir.\nYÃS, yÃ¶nlendirme akÄ±ÅÄ±nÄ± kendi sunucusundan karÅÄ±layacaÄÄ± bir istek ile baÅlatmalÄ±dÄ±r. YÃS web arayÃ¼zÃ¼ndeki bu yapÄ±, 302 yanÄ±t kodu ve yanÄ±t baÅlÄ±ÄÄ±ndaki Location deÄeri ile ÃHK tarayÄ±cÄ±sÄ±nÄ± HHS adresine yÃ¶nlendirmelidir. Bu sayede GKD, HHS tarafÄ±nda baÅlayabilir. \n YÃS tarafÄ±ndaki yÃ¶nlendirme servisi iÃ§in Ã¶rnek response; \n HTTP/1.1 302 Found\nLocation: {{hhsYonAdr}}\n \n ÃHK, HHSâye (uygulama veya web arayÃ¼zÃ¼ vasÄ±tasÄ±yla) yÃ¶nlendirildikten sonra ÃHK'nin gÃ¼Ã§lÃ¼ kimlik doÄrulamasÄ± HHS ile ÃHK arasÄ±nda yÃ¼rÃ¼tÃ¼lÃ¼r. GKDânin tamamlanmasÄ±ndan sonra ÃHK tekrar YÃS uygulamasÄ±na yÃ¶nlendirilir. \n HHS, yÃ¶nlendirme akÄ±ÅÄ±nÄ± kendi sunucusundan karÅÄ±layacaÄÄ± bir istek ile baÅlatmalÄ±dÄ±r. HHS web/app arayÃ¼zÃ¼ndeki bu yapÄ±, ÃHK'nin oturumunu gÃ¼venli bir Åekilde kapatmalÄ±dÄ±r. ArdÄ±ndan 302 yanÄ±t kodu ve yanÄ±t baÅlÄ±ÄÄ±ndaki Location deÄeri ile ÃHK tarayÄ±cÄ±sÄ±nÄ± YÃS adresine yÃ¶nlendirmelidir. \n HTTP/1.1 302 Found\nLocation: {{yosYonAdr}}&rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O\n \n HHSânin web arayÃ¼zÃ¼ne, \n \n HHSânin mobil uygulamasÄ±nÄ±n olmadÄ±ÄÄ±, \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) sunduÄu mobil cihazda HHS uygulamasÄ±nÄ±n yÃ¼klÃ¼ olmadÄ±ÄÄ±, \ndurumlarda yÃ¶nlendirme yapÄ±lÄ±r. \n \n YÃSâÃ¼n mobil uygulamasÄ± varsa mobil cihazda uygulamadan tarayÄ±cÄ±ya, YÃSâÃ¼n mobil uygulamasÄ± yoksa Ã¶deme hizmetinin sunduÄu cihazda (KiÅisel Bilgisayar veya Mobil Cihaz) tarayÄ±cÄ± Ã¼zerinden yÃ¶nlendirme yapÄ±lÄ±r. \n Uygulama TabanlÄ± YÃ¶nlendirme \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) YÃSâÃ¼n mobil uygulamasÄ± ile kullanÄ±yorsa, aynÄ± mobil cihazda HHSânin mobil uygulamasÄ±nÄ±n yÃ¼klenmiÅ olmasÄ± durumunda, ÃHK doÄrulamasÄ±nÄ±n HHS mobil uygulamasÄ± tarafÄ±ndan yapÄ±lmasÄ± iÃ§in uygulama tabanlÄ± yÃ¶nlendirme yapÄ±lÄ±r. BÃ¶ylece ÃHK, Ã¶deme hizmetine eriÅim iÃ§in HHSânin mobil kanalÄ±na eriÅim sÄ±rasÄ±nda kullandÄ±ÄÄ± doÄrulama yÃ¶ntemini ile doÄrulanabilir. \n HHS'nin mobil uygulamasÄ± olmasÄ± durumunda hhsYonAdr olarak universal link kullanmasÄ± gerekmektedir. \n Tablo 5: YÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama KanallarÄ± \n \n \n \n DoÄrulama YÃ¶ntemi \n YÃS OlasÄ± Ortam \n HHS OlasÄ± Ortam \n \n \n \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼)/Mobil Cihaz \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼) / Mobil Cihaz \n \n \n Uygulama TabanlÄ± YÃ¶nlendirme \n Mobil Cihaz \n Mobil Cihaz \n 5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n AyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama, bir kullanÄ±cÄ±nÄ±n kimliÄinin, bir iÅlem baÅlatÄ±ldÄ±ktan sonra ayrÄ± bir Åekilde doÄrulandÄ±ÄÄ± yÃ¶nteme verilen addÄ±r. Bu GKD modelinde, kimlik doÄrulama iÅlem sÃ¼recinden \"ayrÄ±ÅtÄ±rÄ±lmÄ±ÅtÄ±r\". KullanÄ±cÄ±lar, baÅka bir arayÃ¼ze yÃ¶nlendirilmek yerine ( tarayÄ±cÄ± veya uygulama tabanlÄ± yÃ¶nlendirme gibi), ayrÄ± bir kanal Ã¼zerinden (telefonlarÄ±nda bir uygulama bildirimi gibi) iÅlemi doÄrulamalarÄ± iÃ§in bildirim alÄ±r.\nKullanÄ±cÄ±, iÅlemi tamamen ayrÄ± bir cihaz veya uygulama kullanarak doÄrulayabilir. \n Ä°lk fazda AyrÄ±k GKD'de QRâlÄ± modeller kullanÄ±lmayacaktÄ±r. \n AyrÄ±k GKD uygulamalarÄ±nÄ±n farklÄ± Ã¶rnekleri bulunmaktadÄ±r. Ancak yaygÄ±n olan yaklaÅÄ±m, bir web arayÃ¼zÃ¼ ve bir mobil uygulamanÄ±n komb

16inasyonunu kullanmayÄ± iÃ§erir. \n Mobil uygulamasÄ± bulunan HHS'ler iÃ§in AyrÄ±k GKD desteklenmesi zorunludur.  HHSânin web olduÄu durumda AyrÄ±k GKD akÄ±ÅÄ± uygulanmayacaktÄ±r. Mobil uygulamasÄ± bulunup mÃ¼Återi Ã¶zelinde mobil aktiflik kontrol sÃ¼reci HHS inisiyatifindedir. AyrÄ±k GKD sÃ¼recinde HHS tarafÄ±nda sadece mobil uygulama Ã¼zerinden GKD yapÄ±lmalÄ±dÄ±r. ÃHKânÄ±n web uygulamasÄ±na yÃ¶nlendirme yapmamasÄ± gerekmektedir. \n YÃS rolÃ¼nde AyrÄ±k GKD akÄ±ÅÄ±nÄ±n ÃHKâya sorularak baÅlatÄ±lmasÄ±na gerek bulunmamakla beraber bu bilginin ÃHKâya sorulmasÄ± YÃS inisiyatifindedir. YÃS olarak, AyrÄ±k GKD iÅ akÄ±ÅlarÄ± kapsamÄ±nda ÃHKâya ayrÄ±k GKD Ã¶ncesi HHS mobil uygulamasÄ±nÄ±n varlÄ±ÄÄ± sorularak (bildirim ayarlarÄ±nÄ±n aÃ§Ä±k olmasÄ± gerektiÄi bilgisi de verilebilir) ilerlenebilir. AynÄ± zamanda AyrÄ±k GKD ile rÄ±za sÃ¼recinin baÅlatÄ±lmasÄ± zorunlu deÄildir. RÄ±za sÃ¼reci baÅlatÄ±lÄ±rken yetkilendirme yÃ¶ntemi YÃS inisiyatifindedir. \n Ãrnek bir akÄ±Å Åu Åekildedir: \n \n Ä°Ålem BaÅlatma (YÃS Web/Mobil ArayÃ¼zÃ¼):  ÃHK bir iÅlemi YÃSâÃ¼n web/mobil arayÃ¼zÃ¼nde baÅlatÄ±r. YÃS uygulamasÄ±, ÃHK'nÄ±n tekil bir kullanÄ±cÄ± kimliÄini rÄ±zaya ekleyerek bir rÄ±za baÅlatma iÅlemini HHSâye iletir. HHS, tekil kullanÄ±cÄ± kimliÄini kullanarak ÃHK'nÄ±n mobil uygulamasÄ±na bir bildirim gÃ¶nderir. \n Kimlik DoÄrulama Ä°steÄi (HHS Mobil Uygulama):  ÃHK Mobil uygulama bildirimi alÄ±r ve mobil uygulama ÃHK'ya  kimlik doÄrulama isteÄi sunar. HHSânin BDDK tarafÄ±ndan belirlenmiÅ GKD yÃ¶ntemlerine uygun davranmasÄ± beklenmektedir. \n Kimlik DoÄrulama OnayÄ± (HHS Mobil Uygulama):  Mobil uygulama, ÃHKânÄ±n kimlik doÄrulama giriÅimini doÄrular. BaÅarÄ±lÄ± olursa rÄ±za onayÄ± sonrasÄ± mobil uygulama, 'AyrÄ±k Yetkilendirme BaÅarÄ±lÄ±' olay bildirimini YÃSâe gÃ¶nderir. \n Ä°Ålem OnayÄ± (YÃS Web/Mobil ArayÃ¼zÃ¼):  YÃS,  HHS'den gelen 'AyrÄ±k Yetkilendirme BaÅarÄ±lÄ±' olay bildirimine konu olan rÄ±zayÄ± kullanarak yetkilendirme koduna eriÅir. Bundan sonraki sÃ¼reÃ§ eriÅim belirteci alÄ±nmasÄ± servisi ile devam eder. \n \n AyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulamanÄ±n Olay Bildirim Servisleri ile olan BaÄÄ±mlÄ±lÄ±klarÄ± \n AyrÄ±k GKD sÃ¼recinde; HHS'nin yetkilendirme kodunu YÃS'e iletmesi iÃ§in gerekli Ã¶nkoÅul olan ÃHK doÄrulamasÄ± adÄ±mÄ±nÄ±n tamamlanmasÄ±nÄ± olay bildirimi ile YÃS'e yapmasÄ± gerekmektedir.\nBu nedenle YÃS'lerin eÄer AyrÄ±k GKD sÃ¼recini destekleyecek ise;  /olay-dinleme endpointini aÃ§arak olay bildirimi almasÄ± zorunludur. \n Ãzetle: \n YÃ¶nlendirmeli GKD \n \n HHS mobil uygulamasÄ± olmasÄ± durumunda yÃ¶nlendirme adresi olarak universalLink kullanmalÄ±. \n Bu link tanÄ±mÄ±  uygulama var ise uygulamayÄ± aÃ§ yoksa webden devam et Åeklinde olmalÄ±. \n YÃSâÃ¼n mobilden mi webden mi geldiÄi HHS aÃ§Ä±sÄ±ndan Ã¶nemli deÄildir. HHS olarak YÃS hangi adresi yonAdr deÄerinde gÃ¶ndermiÅ ise yetkilendirme sÃ¼reci bittiÄinde o adrese yÃ¶nlendirme yapÄ±lmalÄ±dÄ±r. \n \n AyrÄ±k GKD \n \n Mobil uygulamasÄ± bulunan HHS'ler iÃ§in AyrÄ±k GKD desteklenmesi zorunludur. HHSânin web olduÄu durumda AyrÄ±k GKD akÄ±ÅÄ± uygulanmayacaktÄ±r. Mobil uygulamasÄ± bulunup mÃ¼Återi Ã¶zelinde mobil aktiflik kontrol sÃ¼reci HHS inisiyatifindedir. AyrÄ±k GKD sÃ¼recinde HHS tarafÄ±nda sadece mobil uygulama Ã¼zerinden GKD yapÄ±lmalÄ±dÄ±r. ÃHKânÄ±n web uygulamasÄ±na yÃ¶nlendirme yapmamasÄ± gerekmektedir. \n ÃHKânin Mobil uygulamasÄ±nÄ±n olmadÄ±ÄÄ±nÄ± tespit edebildiÄiniz her durum iÃ§in rÄ±za oluÅturma aÅamasÄ±nda âTR.OHVPS.Business.CustomerMobileApplicationNotFoundâ hatasÄ± dÃ¶Ã¼lÃ¼r. \n HHS, ÃHKânÄ±n mobil uygulamasÄ±nÄ±n bulunmadÄ±ÄÄ± bilgisine ulaÅamazsa kendisinin belirleyeceÄi bildirim yÃ¶ntemlerinden biri ile ÃHKâye bilgilendirme yapar. Bildirim yÃ¶ntemi SMS ise ÃHKâya mobil uygulamasÄ±nÄ± aÃ§tÄ±racak Åekilde adres iletir, Web uygulamayÄ± aÃ§tÄ±racak bir link iletilmemelidir. ÃHK bu bildirimi dikkate almazsa/alamazsa veya ÃHKâda mobil uygulama yok ise bu durumda rÄ±za sÃ¼re aÅÄ±mÄ±ndan iptal olur. \n ÃHK mevcut bankacÄ±lÄ±k iÅlemlerinde bildirimi nasÄ±l gÃ¶nderiyorsanÄ±z (ÃrneÄin: AnlÄ±k bildirim gÃ¶nderildi, alÄ±nmadÄ±, SMSâe dÃ¶nÃ¼ldÃ¼ gibi.) aynÄ± Åekilde bildirim gÃ¶ndererek ÃHKânin uygulama Ã¼zerinden rÄ±zayÄ± onaylamasÄ± beklenir. Buradaki akÄ±Å HHSânin diÄer Ã¼rÃ¼nleri iÃ§in verdiÄi mÃ¼Återi deneyimi ile paralel olmalÄ±dÄ±r. \n 5.2.1\tStatik Model \n YÃS'Ã¼n ÃHK'yÄ± tanÄ±dÄ±ÄÄ± ve ÃHK'ya ait tanÄ±mlayÄ±cÄ± bilgileri HHS'ye aktarabildiÄi durumda kullanÄ±lmaktadÄ±r. Buradaki ÃHK'ya ait tanÄ±mlayÄ±cÄ± bilgiler TCKN, MNO , YKN, PNO, GSM, IBAN olarak belirlenmiÅtir. \n AkÄ±Å aÅaÄÄ±daki gibi kurgulanmÄ±ÅtÄ±r: \n   \n \n \n ÃHK, YÃS uygulamasÄ± Ã¼zerinde iÅlem baÅlatÄ±r. \n \n \n ÃHK, YÃS uygulamasÄ± iÃ§erisinde, farklÄ± bir ortam Ã¼zerinden HHS doÄrulamasÄ±nÄ± gerÃ§ekleÅtirmek istediÄini belirtir. ÃHK'yÄ± tanÄ±ma tip ve deÄerleri YÃS ÃHK'dan talep edebileceÄi gibi, YÃS sisteminde hali hazÄ±rda kayÄ±tlÄ± bilgilerle de akÄ±ÅÄ± devam ettirebilir.  \n \n \n ÃHK, YÃS'Ã¼n mÃ¼Återisi ve YÃS uygulamasÄ±na login ise tek seferlik Ã¶deme akÄ±ÅÄ± baÅlatamaz. \n \n \n YÃS tarafÄ±ndan baÅlatÄ±lan tek seferlik bir Ãdeme iÅleminin AyrÄ±k GKD ile onaylanacaÄÄ± durumda;\nYÃSâÃ¼n ilgili kullanÄ±cÄ±ya ait âÃHK TanÄ±m DeÄerâ verisinin yanÄ±nda iÅleme ait ve ilgili ÃHK ile eÅleÅtirilmiÅ olan  ve sadece YÃS ile ÃHKânÄ±n bilebileceÄi bir deÄerin daha ÃHK tarafÄ±ndan saÄlanmasÄ± ve YÃS tarafÄ±ndan kontrol edilerek eÅleÅen Ãdeme emrinin HHSâye iletilmesi gerekmektedir. ÃrneÄin; bu deÄer YÃS tarafÄ±nda yapÄ±lan tek seferlik Ã¶deme iÅlemine ait fatura numarasÄ±. \n \n \n YÃS Ã¶nyÃ¼zde ÃHK'dan aldÄ±ÄÄ± ohkTanimTip ve ohkTanimDeger deÄ

16erlerini kimlik tÃ¼r ve kimlik deÄeri alanlarÄ±na atamamalÄ±dÄ±r. \n \n \n YÃS, ayrÄ±k GKD ile iÅlem baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"ayrikGKD\"=\"E\" parametresi ile alabilir. \n \n \n YÃS, ÃHK bilgileri ile rÄ±za oluÅturur. RÄ±za nesnesi iÃ§erisinde yer alan GKD nesnesinde ilgili parametreler aÅaÄÄ±daki Åekilde doldurulur: \n \n \n ohkTanimTip ve ohkTanimDeger parametreleri \nBu metodda; ayrikGkd nesnesi iÃ§erisindeki \"ohkTanimTip\" parametresi TR.OHVPS.DataCode.ohkTanimTip sÄ±ralÄ± veri tiplerinden TCKN, MNO , YKN, PNO, GSM, IBAN deÄerlerinden birini alabilir. ohkTanimDeger parametresi de seÃ§ilen tipe ait ÃHK'ya ait deÄeri iÃ§ermelidir.RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin olduÄu durumlarda; ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r.Kimlik alanÄ± iÃ§ermeyen tek seferlik Ã¶deme emri akÄ±ÅlarÄ±nda bu kural geÃ§erli deÄildir. GSM ve IBAN deÄerleri sadece tek seferlik Ã¶demelerde kullanÄ±labilir. \n YÃS'ten ohkTanimTip olarak gelen IBAN bilgisi sadece ÃHK'yÄ± tanÄ±mak iÃ§in kullanÄ±labilir. TanÄ±m tipi IBAN ile baÅlatÄ±lan bir iÅlemde ÃHK, baÅka bir IBAN ile Ã¶deme baÅlatabilir. \n Kurumsal mÃ¼Återiler iÃ§in kmlkTur ve kmlkVrs alanlarÄ± ohkTanimTip ve ohkTanimDeger alanlarÄ±nda gÃ¶nderilmelidir. \n \n \n yetYntm parametresi \nyetYntm parametresi  AyrÄ±k GKD  akÄ±ÅÄ±nÄ± ifade eden \"A\" deÄerini almalÄ±dÄ±r.  \n \n \n \n \n Ãrnek bir istek : \nPOST/ohvps/obh/s1.1/odeme-emri-rizasi \n RizaNesnesi \n {\n...\n  \"gkd\": {\n    \"yetYntm\": \"A\",\n     \"ayrikGkd\" :{\n         \"ohkTanimTip\" : \"TCKN\" \n         \"ohkTanimDeger\": \"11232123212\"\n     }    \n  },\n...\n}\n \n \n \n YÃS, ayrÄ±k GKD ile iÅlem baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"ayrikGKD\"=\"E\" parametresi ile alabilir.\nYÃS, ayrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.DecoupledAuthenticationNotSupported  hatasÄ± iletilmelidir. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n \n \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda hata mesajÄ± vermelidir. HHS tarafÄ±ndan  TR.OHVPS.Business.CustomerMobileApplicationNotFound  hatasÄ± iletilmelidir. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. HHS, ÃHKânÄ±n mobil uygulamasÄ±nÄ±n bulunmadÄ±ÄÄ± bilgisine ulaÅamazsa kendisinin belirleyeceÄi bildirim yÃ¶ntemlerinden biri ile ÃHKâye bilgilendirme yapar. Bildirim yÃ¶ntemi SMS ise ÃHKâya mobil uygulamasÄ±nÄ± aÃ§tÄ±racak Åekilde adres iletir, Web uygulamayÄ± aÃ§tÄ±racak bir link iletilmemelidir. \n \n \n HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  TR.OHVPS.Business.EventSubscriptionNotFound  hata kodu iletilmelidir. \n \n \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir.   \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  TR.OHVPS.Resource.InvalidFormat  hata kodu iletilmelidir. \n \n \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin olduÄu durumlarda; ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  TR.OHVPS.Business.CustomerInfoMismatch  hatasÄ± iletilmelidir.\nKimlik alanÄ± iÃ§ermeyen tek seferlik Ã¶deme emri akÄ±ÅlarÄ±nda bu kural geÃ§erli deÄildir. GSM ve IBAN deÄerleri sadece tek seferlik Ã¶demelerde kullanÄ±labilir. \n \n \n Tek seferlik Ã¶deme iÅlemlerinde \"ohkTanimTip\" = \"GSM\"/\"IBAN\" olarak gÃ¶nderilmiÅ ise, HHS sisteminde bu GSM/IBAN ile eÅleÅen mÃ¼Återileri taramalÄ±dÄ±r. GSM/IBAN bilgisi ÃHK bazÄ±nda tekil bir kullanÄ±cÄ±ya eriÅim imkanÄ± saÄlamaz ise  TR.OHVPS.Business.InvalidCustomerInfo  hatasÄ±nÄ± iletmelidir. \n \n \n Kontrollerin baÅarÄ±lÄ± olmasÄ± durumunda HHS rÄ±zayÄ± oluÅturur ve ÃHK tekil verisi ile ulaÅtÄ±ÄÄ± ÃHK'ya bilgilendirme mesajÄ± gÃ¶nderir.      Bilgilendirme mesajÄ± kÄ±sa mesaj ya da anlÄ±k bildirim mesajÄ± olabilir. ÃHKânÄ±n birden fazla cihazda aktivasyonu varsa HHSânin iÃ§ sÃ¼reÃ§lerine gÃ¶re mevcut durumda nasÄ±l bir bildirim sÃ¼reci iÅletiliyorsa aynÄ± Åekilde ilerlenebilir.  \n \n \n Kurumsal mÃ¼Återiler iÃ§in, hangi kullacÄ±ya bildirim gitmesi isteniyor ise, rÄ±za aÅamasÄ±nda o kiÅi ayrikGkd nesnesinde gÃ¶nderilir. HHS'nin rÄ±za iÃ§erisindeki ohkTur deÄerine gÃ¶re,  gelen bildirime verilen cevaba uygun uygulamasÄ±nÄ± aÃ§malÄ±dÄ±r. Kurumsal ÃHK iÃ§in rÄ±za geldi ise, kurumsal giriÅ sayfasÄ±; bireysel ÃHK iÃ§in rÄ±za geldi ise bireysel giriÅ sayfasÄ± mÃ¼Återinin Ã¶nÃ¼ne aÃ§Ä±lmalÄ±dÄ±r ve ilgili hesaplara eriÅime izin vermelidir. \n \n \n ÃHK'ya bir bildirim gelmemesi durumunda, HHS kendi sisteminde GKD sÃ¼recine devam edemez. 5 dakika sonunda rÄ±za durumu Yetki Bekleniyor'dan RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± (Ä°ptal kod 04) durumuna Ã§eker. \n \n \n \n \n ÃHK, HHS sisteminden gelen bildirim mesajÄ±nÄ± alÄ±r. HHS sistemine login olduktan sonra iÅleme onay verilmezse veya GKD kontrolleri baÅarÄ±sÄ±z olursa HHS Olay Bildirim servisleri aracÄ±lÄ±ÄÄ± ile GKD sÃ¼recinin sonlandÄ±ÄÄ±nÄ± YÃS'e iletir. Olay tipi \"AYRIK_GKD_BASARISIZ\" olacak Åekilde bir POST /olay-dinleme servis Ã§aÄrÄ±sÄ± yapÄ±lÄ±r.YÃS kendisine gelen olay bildirimi ile\nrÄ±za sorgulamasÄ± yaparak iptal detay kodunu Ã¶Ärenebilir. \n \n \n ÃHK, HHS sisteminde login olduktan sonra iÅleme onay verirse; HHS tarafÄ±ndan rÄ±za ile iliÅkili yetkod deÄeri Ã¼retilir.HHS, YÃS'e ÃHK iÃ§in \"yetkod\" deÄeri Ã¼retildiÄinin bilgisini Olay Bildirim servisleri aracÄ±lÄ±ÄÄ± ile iletir. Olay tipi \"AYRIK_GKD_BASARILI\" olacak Åekilde bir POST /olay-dinleme servis Ã§aÄrÄ±sÄ± yapÄ±lÄ±r. \n \n \n YÃS kendisine gelen olay bildirimi ile \"yetkod\" deÄerinin HHS'de Ã¼retildiÄinin bilgisini alÄ±r. \"yetkod\" deÄerini Ã¶Ärenebilmek iÃ§in HHS'yi sorgulamasÄ± gerekmektedir.  \nHHS'nin aÃ§acaÄÄ±   GET /yetkilendirme-kodu endpointi   ile bu bilgiye eriÅebilir. \n \n \n YÃS, \"yetkod\" ile POST /erisim-belirteci endpointinden eriÅim belirteci alÄ±r. BÃ¶ylelikle ÃHK'nÄ±n AyrÄ±k GKD sÃ¼reci tamamlanmÄ±Å olur. \n 5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi \n CSRF AtaklarÄ±ndan korunmak iÃ§in ve YÃS uygulamasÄ±nÄ±n bir Ã¶nceki durumunu restore edebilmesi iÃ§in; YÃS tarafÄ±ndan iletilen yÃ¶nlendirme ve bildirim adreslerine , Oauth2 standartlarÄ±ndaki state parametresine eÅdeÄer,   durum ko

16du (drmKod)  parametresinin eklenmesi gerekmektedir. Durum kodu parametresi YÃS tarafÄ±ndan Ã¼retilen, tekil ve kolay tahmin edilemeyen bir deÄer olmalÄ±dÄ±r. RÄ±za isteÄi gÃ¶nderimi aÅamasÄ±nda oluÅturulmalÄ±dÄ±r. YÃS uygulamasÄ±nda uygun bir yerde saklanmalÄ±dÄ±r (cookie, session, local storage gibi) . \n Durum kodu, rÄ±za isteÄindeki yÃ¶nlendirme adresine parametre olarak eklenir.  GKD sÃ¼reci sonrasÄ±nda yetki kodu ile birlikte bu bilgi, HHS tarafÄ±ndan YÃSâe iletilir. YÃS sakladÄ±ÄÄ± deÄer ile parametre olarak gelen deÄerin eÅitliÄini kontrol eder. AynÄ± ise eriÅim belirteci almak Ã¼zere akÄ±ÅÄ± ilerletir. FarklÄ± ise iÅlemi keser. \n 5.4  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri \n ÃHK, GKD iÃ§in HHS uygulamasÄ±na yÃ¶nlendirildiÄinde, HHSânin Ã§eÅitli kontroller yaparak iÅlemin doÄruluÄunu teyit etmesi gerekmektedir.\nYapÄ±lmasÄ± gereken kontrollere ait temel senaryolar aÅaÄÄ±daki tabloda belirtilmiÅtir. Bu senaryolar baz alÄ±narak HHSâler tarafÄ±ndan zenginleÅtirilebilir. \n AÅaÄÄ±daki tabloda yer alan 07-13 arasÄ± RÄ±za Ä°ptal Detay KodlarÄ±nÄ±n oluÅtuÄu senaryolar, HHS uygulamasÄ±nda yapÄ±lan kullanÄ±cÄ± doÄrulama Ã¶ncesi ve sonrasÄ± olarak iki adÄ±mda incelenmelidir. \n HHS tarafÄ±nda, kullanÄ±cÄ± doÄrulama Ã¶ncesinde yapÄ±lan kontroller neticesinde verilemeyen rÄ±zalar iÃ§in â04â : SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor iptal kodu atanÄ±r. HHS'nin YÃS uygulamasÄ±na 04 kodunu iletmesi beklenmez. YÃS zaman aÅÄ±mÄ± neticesinde rÄ±za statÃ¼sÃ¼nÃ¼ sorgulayarak Ã¶Ärenir. \nKullanÄ±cÄ± doÄrulandÄ±ktan sonra rÄ±za verilemiyorsa ilgili hata kodunun YÃS'e iletilmesi beklenmektedir. KullanÄ±cÄ± doÄrulama sonrasÄ± YÃS'e iletilen rÄ±za iptal detay kodu ile HHS veri modelinde tutulan rÄ±za ile iliÅkili rÄ±za iptal detay kodu, aynÄ± deÄeri alacak Åekilde gÃ¼ncellenmelidir. YÃS, HHS tarafÄ±ndan kendine iletilen rÄ±za iptal detay kodunu kendi veri modelinde gÃ¼ncellemelidir. \n Zorunlu olarak belirtilen hata durumlarÄ±nÄ±n HHSâler tarafÄ±ndan gerÃ§eklenmesi ve uygun hata kodlarÄ±nÄ±n YÃSâe iletilmesi; ileride oluÅabilecek mutabakatlaÅma sorunlarÄ±nÄ± ortadan kaldÄ±rabilecek, yapÄ±lacak raporlamalar kapsamÄ±nda sistem ve sÃ¼reÃ§ iyileÅtirmelerine katkÄ± saÄlayacak, son kullanÄ±cÄ± aÃ§Ä±sÄ±ndan da alÄ±nan hataya yÃ¶nelik bilgilendirici iÃ§erik saÄlayacaktÄ±r. \n Hata aÃ§Ä±klamalarÄ±; hata koduna uygun ya da uyumlu olmak kaydÄ±yla, HHS ve YÃS tarafÄ±ndan farklÄ± Åekillerde sunulabilir. \n GKD SÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller \n \n \n \n RÄ±za Ä°ptal Detay Kodu \n HHS hata aÃ§Ä±klamasÄ±* \n YÃ¶s ekranÄ±nda listelenecek Ã¶rnek mesaj metni* \n Ãrnek Senaryo \n Zorunlu / Opsiyonel \n \n \n \n \n 07 \n RÄ±za mevcut ve durumu \"Yetkilendirildi\" veya \"Yetki KullanÄ±ldÄ±\" \n Yetki HatasÄ± \n ÃHK,  kullanÄ±cÄ± doÄrulama iÅlemi tamamlandÄ±ktan sonra  YÃS ekranÄ±nda ileri - geri yaparak ya da ÃHK'nÄ±n yÃ¶nlendirme adresini kopyalayarak tarayÄ±cÄ±ya yapÄ±ÅtÄ±rmasÄ± ile tekrar HHS'ye yÃ¶nlendirir. Bu durumda HHS bu rÄ±za iptal detay kodunu iletir. HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 08 \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±. \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n YÃS tarafÄ±ndan baÅlatÄ±lan rÄ±za iÃ§erisinde yer alan kimlik bilgisi (Ã¶rn:TCKN) ile HHS'de baÅarÄ±lÄ± kimlik doÄrulama yapÄ±lan ÃHK'nÄ±n bilgilerinin uyuÅmadÄ±ÄÄ± durumda  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 09 \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) \n GÃ¶sterilebilecek hesap/kart bulunamamÄ±ÅtÄ±r. \n HHS, kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra, ÃHK'nÄ±n uygun statÃ¼lÃ¼ hesabÄ±nÄ±n olmadÄ±ÄÄ± durumda  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 10 \n ÃHK'nÄ±n AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n ÃHK'nÄ±n AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n AÃ§Ä±k bankacÄ±lÄ±ÄÄ± ayrÄ± bir kanal olarak tanÄ±mlamÄ±Å HHS'lerde,  ÃHK kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra yapÄ±lan kontrollerde, ÃHK'nÄ±n iÅlemlerini AB kanalÄ±na kapatmÄ±Å olmasÄ± durumunda   HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Opsiyonel \n \n \n 11 \n ÃHK'nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmamasÄ± \n Yetki hatasÄ± \n 1- Kurumsal firma kullanÄ±cÄ±larÄ±nÄ±n hesaplar Ã¼zerinde iÅlem yetkisinin olmamasÄ± durumunda   2- Bireysel ortak hesaplarda hesap kÄ±sÄ±tÄ± bulunuyorsa (para Ã§Ä±kÄ±ÅÄ±na izin verilmediÄi durum)  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 12 \n HHSânin,  ÃHK Ã¶zelinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ± \n Yetki hatasÄ± \n HHS'nin, kullanÄ±cÄ± doÄrulama sonrasÄ± ÃHK iÃ§in iÃ§ sistemlerinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ±. ÃrneÄin: MÃ¼Återinin henÃ¼z bankacÄ±lÄ±k hizmet sÃ¶zleÅmesi gibi Internet Åubesi Ã¼zerinde iÅlem yapmasÄ±nÄ± engelleyen eksikleri olmasÄ± durumunda veya kurumsal kullanÄ±cÄ±da vekalet sÃ¼resinin dolmasÄ±/eksik dokÃ¼man olmasÄ± durumunda kanal Ã¼zerinde iÅlem yapamadÄ±ÄÄ± durum  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Opsiyonel \n \n \n 13 \n ÃHK isteÄi ile GKDâden vazgeÃ§ilmesi \n MÃ¼Återi iÅlemden vazgeÃ§miÅtir. \n HHS ekranÄ±nda yer alan VAZGEÃ butonuna basÄ±lmasÄ± durumu (ÃHK,HHS uygulamasÄ±nda kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra VAZGEÃ butonu olabilir.) \n Zorunlu \n \n \n 14 \n GKD Ä°ptali: Fraud ÅÃ¼phesi \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n HHS Fraud ÅÃ¼phesi nedeniyle iÅlemin devamÄ±na izin vermez. HHS'nin, fraud kontrollerinin Ã¶deme baÅlatma hizmeti iÃ§in yapmasÄ± ve â14- GKD Ä°ptali: Fraud ÅÃ¼phesiâ ile rÄ±za iptalini gerÃ§ekleÅtirmelidir. HBH servislerinde HHS'nin rÄ±za iptal kodu 14 ile iÅlemi kesmesi HHS'nin kendi insiyatifindedir yani opsiyoneldir. \n KoÅullu \n \n \n 99 \n DiÄer \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n OluÅabilecek diÄer senaryolar. \n Zorunlu \n \n \n \n GKD sÄ±rasÄ±nda iletilen rÄ±za no eÄer HHSânin sisteminde bulunamazsa durumu gÃ¼ncellenecek bir rÄ±za no da olmayacaktÄ±r. HHS kendi Ã¶nyÃ¼zÃ¼nde bu duruma uygun bir mesaj gÃ¶sterebilir. YÃSâe de DiÄer hata kodu ile bu durumu iletebilir. \n"},{frontmatter:{},regularPath:"/v1.1.0/contents/tanim-ve-kisitlamalar.html",relativePath:"v1.1.0/contents/tanim-ve-kisitlamalar.md",key:"v-e8779b46",path:"/v1.1.0/contents/tanim-ve-kisitlamalar.html",content:"  1.\tTanÄ±m ve KÄ±saltmalar   \n Tablo 1: TanÄ±m ve KÄ±saltmalar \n \n \n \n KÄ±saltma \n TanÄ±m \n AÃ§Ä±klama \n Ä°ngilizce AÃ§Ä±klama \n Ä°ngilizce KÄ±saltma \n \n \n \n \n ÃS \n ÃerÃ§eve SÃ¶zleÅme \n Ãdeme hizmeti saÄlayÄ±cÄ±sÄ± ile mÃ¼Återi arasÄ±nda tekil veya sÃ¼reklilik arz eden Ã¶deme iÅlemlerinin yÃ¼rÃ¼tÃ¼lmesine ve mÃ¼mkÃ¼n olan durumlarda Ã¶deme hesabÄ±nÄ±n aÃ§Ä±lmasÄ±na iliÅkin usul ve esaslarÄ± belirleyen sÃ¶zleÅme \n \n \n \n \n EPK \n Elektronik Para KuruluÅu \n Kanun kapsamÄ±nda elektronik para ihraÃ§ etme yetkisi verilen tÃ¼zel kiÅi \n Electronic Money Institution \n EMI \n \n \n FAST \n FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi \n TCMB tarafÄ±ndan iÅletilen FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi Sistemi \n \n \n \n \n FAST TR-Karekod \n FAST-TR Karekod Teknik Ä°lke ve Kurallar Rehberi \n TR Karekodâun FAST Sistemi aracÄ±lÄ±ÄÄ±yla gerÃ§ekleÅecek iÅlemlerde kullanÄ±lmasÄ±na iliÅkin detaylÄ± teknik ilke ve kurallarÄ±nÄ± iÃ§eren dokÃ¼man \n \n \n \n \n GEÃÄ°T \n BKM API GeÃ§idi \n BankalararasÄ± Kart Merkezi (BKM) tarafÄ±ndan geliÅtirilen ve taraflara standart AÃ§Ä±k BankacÄ±lÄ±k iÅlemleri sunulmasÄ±nÄ± saÄlayan API GeÃ§idi uygulamasÄ± \n \n \n \n \n GKD \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n Kimlik doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin bildiÄi, sahip olduÄu veya biyometrik bir karakteristiÄi olan bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntem \n Strong Customer Authentication \n SCA \n \n \n Ä°B \n Ä°Ålem Bilgisi \n GerÃ§ekleÅtirilen iÅleme iliÅkin iÅlem zamanÄ±nÄ±, iÅlemin niteliÄini ve Ã¶deme iÅlemi iÃ§in Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve Ã¶demenin gÃ¶ndereni ile alÄ±cÄ±sÄ±nÄ± veya toplu Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve gÃ¶ndereni ile alÄ±cÄ±larÄ±nÄ± iÃ§eren bilgi \n \n \n \n \n Ä°DK \n Ä°Ålem DoÄrulama Kodu \n Kimlik doÄrulama yÃ¶ntemlerinden biriyle kendisini sisteme tanÄ±tan bir mÃ¼Återinin gerÃ§ekleÅtirmek istediÄi

16iÅleme Ã¶zgÃ¼ olmak ve belirli bir geÃ§erlilik sÃ¼resi iÃ§inde iÅlem onayÄ±nda kullanÄ±lmak Ã¼zere oluÅturulan, finansal sonuÃ§ doÄrunan iÅlemlerde kiÅiye onay anÄ±nda ilgili iÅlem bilgisi (Ä°B) ile birlikte gÃ¶sterilen, alÄ±cÄ± veya tutarÄ±n deÄiÅmesiyle geÃ§ersiz hale gelen bilgi \n Authentication Code \n AC \n \n \n KOLAS \n Kolay Adresleme Servisi \n Fon transferlerinde hesap numarasÄ± ile ad soyad yerine kullanÄ±lan ve belirli bir hesap ile eÅleÅtirilmiÅ telefon numarasÄ±, e-posta adresi, T.C. Kimlik NumarasÄ± (TCKN), Vergi Kimlik NumarasÄ± (VKN), YabancÄ± Kimlik NumarasÄ± veya Pasaport NumarasÄ± gibi Kolay Adres bilgilerinin kaydedilmesini, gÃ¼ncellenmesini ve sorgulamasÄ±nÄ± saÄlayan katman servis \n \n \n \n \n HBHS \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (g) bendinde tanÄ±mlanan Ã¶deme hizmetini (hesap bilgisi hizmetini) sunan tÃ¼zel kiÅi \n Account Information Service Provider \n AISP \n \n \n HHS \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± \n Nezdinde Ã¶deme hesabÄ± bulunan Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± \n Account Servicing Payment Service Provider \n ASPSP \n \n \n ÃBHS \n Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (f) bendinde tanÄ±mlanan Ã¶deme hizmetini (Ã¶deme emri baÅlatma hizmetini) sunan tÃ¼zel kiÅi \n Payment Initiation Service Provider \n PISP \n \n \n ÃDK \n Ãdeme KuruluÅu \n Ãdeme hizmeti saÄlamak ve gerÃ§ekleÅtirmek iÃ§in Kanun kapsamÄ±nda yetkilendirilmiÅ tÃ¼zel kiÅi \n Payment Institution \n PI \n \n \n ÃH \n Ãdeme HesabÄ± \n Ãdeme hizmeti kullanÄ±cÄ±sÄ± adÄ±na aÃ§Ä±lan ve Ã¶deme iÅleminin yÃ¼rÃ¼tÃ¼lmesinde kullanÄ±lan hesap \n Payment Account \n PA \n \n \n ÃHK \n Ãdeme Hizmeti KullanÄ±cÄ±sÄ± (MÃ¼Återi) \n GÃ¶nderen, alÄ±cÄ± veya her ikisi sÄ±fatÄ±yla belirli bir Ã¶deme hizmetinden faydalanan gerÃ§ek veya tÃ¼zel kiÅi \n Payment Service User \n PSU \n \n \n ÃHS \n Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n 5411 sayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar, EPK, ÃDK ve Posta ve Telgraf TeÅkilatÄ± Anonim Åirketi(PTT) \n Payment Service Provider \n PSP \n \n \n ÃHVPS \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri \n Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri \n \n \n \n \n PÃS \n Perakende Ãdeme Sistemi \n TCMB tarafÄ±ndan iÅletilen, iÅlemlerin TÃ¼rk LirasÄ± Ã¼zerinden gerÃ§ekleÅtiÄi MÃ¼Återiler ArasÄ± TÃ¼rk LirasÄ± AktarÄ±m Sistemi \n \n \n \n \n TR-Karekod \n TR-Karekod Ä°lke ve KurallarÄ± \n Ulusal karekod (TR Karekod) ilke ve kurallarÄ±nÄ±n belirlendiÄi belge \n \n \n \n \n YÃS \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n Ãdeme emri baÅlatma hizmeti ve/veya hesap bilgisi hizmeti sunan tÃ¼zel kiÅi \n Third Party Payment Service Providers \n TPP \n \n \n \n"},{frontmatter:{},regularPath:"/v1.1.0/deneyalani/genel-bilgiler.html",relativePath:"v1.1.0/deneyalani/genel-bilgiler.md",key:"v-70a6dc4e",path:"/v1.1.0/deneyalani/genel-bilgiler.html",content:" GENEL BiLGÄ°LER: \n ÃHVPS API Ä°lke ve KurallarÄ± dokÃ¼manÄ±na istinaden geliÅtirmelerini yapan/yapacak olan katÄ±lÄ±mcÄ±lar geliÅtirdikleri sÃ¼rÃ¼me ait APIâlerin nasÄ±l Ã§alÄ±ÅtÄ±klarÄ±nÄ± gÃ¶rmek istediklerinde âDeney AlanÄ±â Ã¼zerinden gÃ¶zlem yapabilirler. Bu kapsamda, Deney AlanÄ± katÄ±lÄ±mcÄ±lara tarayÄ±cÄ± Ã¼zerinden statik verilerle iÅlem baÅlatarak, dÃ¶nen yanÄ±tÄ± inceleme imkanÄ± sunar. \n Deney AlanÄ± ile sunulan imkanlar Åu Åekildedir: \n \n Servisler durum bilgisi iÃ§ermeyecek Åekilde (stateless) olarak sunulmaktadÄ±r. \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama akÄ±ÅlarÄ±nda kurum Ã¶zelinde oluÅturulan yetkilendirme kimlik bilgilerine ihtiyaÃ§ duyulmamaktadÄ±r. \n YanÄ±t veri kÃ¼mesi statiktir. Servislere yapÄ±lan istekler, her zaman aynÄ± yanÄ±tÄ± dÃ¶nmektedir. \n Yeni oluÅturma, gÃ¼ncelleme, silme iÅlemleri kaynak veri Ã¼zerinde deÄiÅiklik yapmamaktadÄ±r. \n Deney alanÄ± genelin kullanÄ±mÄ±na aÃ§Ä±ktÄ±r. Ãyelik kaydÄ± olmaksÄ±zÄ±n Deney AlanÄ± Ã¼zerinden API incelemeleri gerÃ§ekleÅtirilebilmektedir. \n API dokÃ¼manÄ±nda yapÄ±lacak minor deÄiÅiklikler deney alanÄ±na yansÄ±tÄ±lmayacaktÄ±r. \n \n Not: Deney AlanÄ±ânÄ±n kapsamÄ± geniÅletilmiÅ versiyonu â âBKM ÃHVPS SimÃ¼latÃ¶râ uygulamasÄ± hem HHS hem de YÃS katÄ±lÄ±mcÄ±larÄ±nÄ±n; test uygulamalarÄ±nÄ± uÃ§tan uca test edebilebileceÄi bir ortamdÄ±r. SimÃ¼latÃ¶r uygulamasÄ± Ã¼zerinden dinamik veri giriÅi yaparak, geliÅtirilen servisler ile zorunlu senaryolarÄ±n tÃ¼mÃ¼nÃ¼n simÃ¼lasyonu gerÃ§ekleÅtirilebilir. SimÃ¼latÃ¶r ortamÄ±ndaki APIâler, Ã¼retim ortamÄ±nÄ±n bir kopyasÄ± olacak Åekilde oluÅturulmuÅtur ve kurumlarÄ±n Ã¼retim ortamÄ±na hazÄ±r hale gelmelerine aracÄ±lÄ±k eder. Bu uygulama, pÃ¼rÃ¼zsÃ¼z bir Ã¼retim ortamÄ± geÃ§iÅi imkanÄ± saÄlar ve ÃHVPS BKM Teknik Sertifikasyonu geÃ§mek iÃ§in koÅulmasÄ± gereken sertifikasyon senaryolarÄ± BKM ÃHVPS SimÃ¼latÃ¶râÃ¼ Ã¼zerinden sunulmaktadÄ±r. BKM SimÃ¼latÃ¶r kullanÄ±mÄ± iÃ§in ayrÄ± bir sÃ¼reÃ§ iÅletilmekte olup daha fazla detaylÄ± bilgi almak iÃ§in [email protected] adresine taleplerinizi iletmeniz gerekmektedir. \n Ãdeme Emri BaÅlatma API Deney AlanÄ± \n"},{title:"3. Temel Prensipler",frontmatter:{},regularPath:"/v1.1.0/contents/temel-prensipler.html",relativePath:"v1.1.0/contents/temel-prensipler.md",key:"v-2fcc3a95",path:"/v1.1.0/contents/temel-prensipler.html",headers:[{level:2,title:"3.1 Genel",slug:"_3-1-genel"},{level:2,title:"3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum",slug:"_3-2-istem-cagrÄ±-ve-oturum"},{level:2,title:"3.3.\tRESTful API",slug:"_3-3-restful-api"},{level:2,title:"3.4.\tSÃ¼rÃ¼m YÃ¶netimi",slug:"_3-4-surum-yonetimi"},{level:2,title:"3.5.\tKaynak URI Yol YapÄ±sÄ±",slug:"_3-5-kaynak-uri-yol-yapÄ±sÄ±"},{level:2,title:"3.6.\tKarakter Kodlama",slug:"_3-6-karakter-kodlama"},{level:2,title:"3.7.\tVeri FormatÄ±",slug:"_3-7-veri-formatÄ±"},{level:2,title:"3.8.\tÄ°stemci Sertifika YÃ¶netimi",slug:"_3-8-istemci-sertifika-yonetimi"},{level:2,title:"3.9.\tYetkilendirme TÃ¼rleri",slug:"_3-9-yetkilendirme-turleri"},{level:2,title:"3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ±",slug:"_3-10-istek-cevap-mesajlarÄ±nda-kullanÄ±lan-nesne-yapÄ±larÄ±"},{level:2,title:"3.11. SayfalandÄ±rma ve Filtreleme",slug:"_3-11-sayfalandÄ±rma-ve-filtreleme"},{level:2,title:"3.12. Mesaj Ä°mzalama",slug:"_3-12-mesaj-imzalama"},{level:2,title:"3.13. Durum Kodu",slug:"_3-13-durum-kodu"},{level:2,title:"3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ±",slug:"_3-14-gereksinimlerinin-sÄ±nÄ±flandÄ±rÄ±lmasÄ±"},{level:2,title:"3.15. Ä°stek BaÅlÄ±ÄÄ±",slug:"_3-15-istek-baslÄ±gÄ±"},{level:2,title:"3.16. YanÄ±t BaÅlÄ±ÄÄ±",slug:"_3-16-yanÄ±t-baslÄ±gÄ±"},{level:2,title:"3.17. Idempotency KurallarÄ±",slug:"_3-17-idempotency-kurallarÄ±"},{level:2,title:"3.18. HTTP Durum KodlarÄ±",slug:"_3-18-http-durum-kodlarÄ±"},{level:2,title:"3.19. Maskeleme KurallarÄ±",slug:"_3-19-maskeleme-kurallarÄ±"},{level:2,title:"3.20. Fonksiyonel Olmayan Gereksinimler",slug:"_3-20-fonksiyonel-olmayan-gereksinimler"},{level:2,title:"3.21. Otomatik Sorgular",slug:"_3-21-otomatik-sorgular"}],content:' 3. Temel Prensipler  \n Bu bÃ¶lÃ¼mde Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (Hesap Bilgisi Hizmeti, Ãdeme Emri BaÅlatma Hizmeti) iÃ§in tanÄ±mlanan temel prensipler aÃ§Ä±klanmaktadÄ±r. \n 3.1 Genel \n \n \n HHSâler YÃ¶netmeliÄin 59. maddesinin beÅinci fÄ±krasÄ± ve Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄin (TebliÄ) 23. maddesinin birinci fÄ±krasÄ± uyarÄ±nca, Ã¶deme hizmetleri veri paylaÅÄ±m servislerini GEÃÄ°T aracÄ±lÄ±ÄÄ±yla HBHS ve ÃBHSâye sunmakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n \n \n TebliÄin 23. maddesinin ikinci fÄ±krasÄ± uyarÄ±nca Ã¶deme emri baÅlatma hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± ÃBHS ile HHSâdir. \n \n \n TebliÄin 23. maddesinin Ã¼Ã§Ã¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca hesap bilgisi hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± HBHS ile HHSâdir. \n \n \n YÃ¶netmeliÄin 60. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, Ã¶deme emri baÅlatma hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n YÃ¶netmeliÄin 61. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, hesap bilgisi hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n TebliÄin 25. maddesi uyarÄ±nca HHS ve YÃS (ÃBHS ve HBHS) arasÄ±nda baÄlantÄ± uÃ§tan uca gÃ¼venli bir Åekilde saÄlanÄ±r. Bu amaÃ§la iletim katmanÄ±nda TLS (asgari 1.2 sÃ¼rÃ¼mÃ¼) ile Åifreli iletiÅim saÄlanÄ±r. \n \n \n TebliÄin 23. maddesinin dÃ¶rdÃ¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca HHS tarafÄ±ndan sunulan Ã¶deme hizmetleri veri paylaÅÄ±m servislerini kullanan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n TCMB tarafÄ±ndan ilgili Ã¶deme hizmeti iÃ§in yetkilendirilmiÅ olduÄu kontrol edilir. \n \n \n TebliÄin 25. maddesinin beÅinci fÄ±krasÄ± uyarÄ±nca zaman damgasÄ±, 15/1/2004 tarihli 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunu kapsamÄ±nda tanÄ±mlanan zaman damgasÄ±na dayanÄ±r. \n \n \n API alan isimleri TÃ¼rkÃ§e olarak tanÄ±mlanmÄ±ÅtÄ±r. Ancak API baÅlÄ±ÄÄ± (header) alanÄ±ndaki alan isimleri Ã¶zelinde, API GeÃ§itleri tarafÄ±ndan otomatik olarak tanÄ±nabilmesi gÃ¶zetilerek, Ä°ngilizce isimlendirme tercih edilmiÅtir. \n \n \n ÃHK halihazÄ±rda Ã¶deme hesaplarÄ±na, Ã§evrim iÃ§i (mobil bankacÄ±lÄ±k, internet bankacÄ±lÄ±ÄÄ± vb.) eriÅebilir durumda ise, HHS\'nin varsa AÃ§Ä±k BankacÄ±lÄ±k kanal veya yetki tanÄ±mÄ±nÄ± varsayÄ±lan deÄeri AÃIK olacak Åekilde sunmasÄ± gerekmektedir. HHSânin, Bireysel/Kurumsal/Ticari mÃ¼Återi ayrÄ±mÄ± yapmaksÄ±zÄ±n tÃ¼m mÃ¼Återileri iÃ§in, Ã§evrim iÃ§i kanallarda hesap hareketlerine eriÅim ve Ã¶deme yapabilme yetkisi bulunmasÄ± durumunda, yine aynÄ± Åekilde AÃ§Ä±k BankacÄ±lÄ±k kanal veya yetki tanÄ±mÄ±nÄ± da varsayÄ±lan deÄeri AÃIK olacak Åekilde sunmasÄ± gerekmektedir. HHS AÃ§Ä±k BankacÄ±lÄ±k hizmetini kanal/yetki tanÄ±mÄ± ile yÃ¶netmesi durumunda hizmeti verdiÄi ilgili kanallar(web,mobil) Ã¼zerinden mÃ¼Återisine AÃ§ma/Kapama olanaÄÄ± Åeklinde sunmasÄ± gerekmektedir. \n \n \n 5411 SayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar, HHS API iÃ§erisinde Aktif durumda listelenmemiÅken, YÃS API iÃ§erisinde listelenemezler. \n 3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum \n \n \n Her istek tekil istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) iÃ§erir. Birden fazla istek iÃ§eren iÅlem YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi (istek numarasÄ±: X-Request-ID) ve rÄ±za sÃ¼recine Ã¶zgÃ¼ talep kimliÄi (iÅlem grup numarasÄ±: X-Group-ID) deÄerleri kullanÄ±lmalÄ±dÄ±r. AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± X-Group-ID bilgisi deÄeri gÃ¶nderilmelidir. \n \n \n Oturum takibi ise PSU-Session-ID ile yapÄ±lÄ±r. Oturum numarasÄ± (PSU-Session-ID) ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) ile birlikte ilgili tÃ¼m iÅlem verilerini iÃ§erecek Åekilde k

16ayÄ±t altÄ±na alÄ±nÄ±r. \n \n \n ÃrneÄin, bir Ã¶deme emri baÅlatma iÅlemi birden fazla istekten oluÅur. Her istek yukarÄ±da belirtildiÄi gibi biricik istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) iÃ§erir. Ancak iÅlemin oturum bÃ¼tÃ¼nlÃ¼ÄÃ¼ PSU-Session-ID ile saÄlanÄ±r. \n \n \n Taraflar aÃ§tÄ±klarÄ± oturumu iÅlem bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ saÄlayacak sÃ¼re iÃ§erisinde aÃ§Ä±k tutar ve iÅlem biter bitmez kapatÄ±r. \n 3.3.\tRESTful API \n APIâler, dÃ¼nya Ã¶lÃ§eÄinde yaygÄ±n bir Åekilde kullanÄ±lan Temsili Durum Transferi (Representational State Transfer, REST) mimari tarzÄ± ve JavaScript Nesne Notasyonu (JavaScript Object Notation, JSON) veri formatlarÄ±na uygun olarak geliÅtirilir. En Ã¼st seviye Veri TanÄ±mlama Dili (Data Description Language) ve en iyi uygulama Ã¶rnekleri iÃ§in  ^JSON ÅemasÄ±  temel alÄ±nÄ±r. \n Ä°stek ve yanÄ±t mesajlarÄ±nda, isteÄe baÄlÄ± veya koÅullu bir alan, deÄer iÃ§ermiyorsa, bu alan JSON payloadunda yer almamalÄ±dÄ±r. \n Ãrnek kod bloÄu. \n "rzBlg":{\n         "rizaNo":"aa9bd7e7-0ccd-4edc-9639-5a358dbf2335",\n         "olusZmn":"2022-11-28T12:00:21+03:00",\n         "gnclZmn":null,    --\x3e hatalÄ±\n         "rizaDrm":"K",\n         "rizaIptDtyKod":"" --\x3e hatalÄ± \n      },\n \n Ãrnek kod bloÄu: \n \n         "alc":{\n            "hspNo": "TR800800004162387689546019",\n            "unv": "AHMET YILMAZ", \n            "kolas":{}  --\x3e nesne gÃ¶nderimi hatalÄ±\n         },\n 3.4.\tSÃ¼rÃ¼m YÃ¶netimi \n API sonraki aÅamalarda doÄabilecek gereksinimleri ve daha karmaÅÄ±k kullanÄ±m durumlarÄ±nÄ± karÅÄ±lamak iÃ§in sÃ¼rÃ¼mler halinde geliÅtirilir ve bu durum tasarÄ±m sÄ±rasÄ±nda gÃ¶z Ã¶nÃ¼nde bulundurulur. \n API v1.0.2 sÃ¼rÃ¼mÃ¼nde ; \n \n Kapsamdaki Ã¶deme hesaplarÄ± : Vadesiz TL, yabancÄ± para hesaplarÄ± (gerÃ§ek ve tÃ¼zel kiÅilere ait Ã¶deme hesaplarÄ±), Kredili Mevduat HesabÄ± \n Tekil Ã¶deme (Virman/Havale/FAST/MÃ¼ÅterilerarasÄ± TL AktarÄ±m Sistemi)\n \n Virman ve havale iÅlemleri kapsamÄ±nda yabancÄ± para transferi yapÄ±labilir. \n \n \n Hesap bilgisi hizmetleri\n \n Temel veya ayrÄ±ntÄ±lÄ± hesap bilgisi \n Bakiye \n GerÃ§ekleÅen iÅlemler iÃ§in Hesap hareketleri \n \n \n Karekodlu Ã¶demelerdeki 01, 02 ve 03 akÄ±Å tÃ¼rleri\nyer almaktadÄ±r. \n \n API v1.1.0 sÃ¼rÃ¼mÃ¼nde ; \n \n API v1.0.2 sÃ¼rÃ¼mÃ¼ne ek Olay Bildirim ve AyrÄ±k GKD Ã¶zellikleri eklenmiÅtir. SÃ¼reÃ§lerin daha iyi iÅlemesi iÃ§in Ã§eÅitli gÃ¼ncellemeler yapÄ±lmÄ±ÅtÄ±r. \n \n Her sÃ¼rÃ¼m deÄiÅikliÄinde bir Ã¶nceki sÃ¼rÃ¼m belirli bir sÃ¼re desteklenecektir. DiÄer bir ifadeyle, sadece belirli bir sÃ¼re iÃ§in mevcut ve bir Ã¶nceki sÃ¼rÃ¼m aynÄ± anda eriÅilebilir olacaktÄ±r. \n 3.5.\tKaynak URI Yol YapÄ±sÄ± \n YÃSâlerin baÅlattÄ±ÄÄ± Ã§aÄrÄ±larda URI yolu aÅaÄÄ±daki yapÄ±yÄ± takip eder: \n [hhs-yol-Ã¶n-eki]/ohvps/ [kaynak-grubu]/ [sÃ¼rÃ¼m]/ [kaynak]/[kaynak-no]/[alt-kaynak] \n Bu, aÅaÄÄ±daki unsurlardan oluÅur: \n \n [hhs-yol-Ã¶n-eki] \nÄ°steÄe baÄlÄ±, HHS\'ye Ã¶zgÃ¼ yol Ã¶n ekini ifade eder. \nGEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda BKM tarafÄ±ndan belirlenen sistem adÄ± ve yol Ã¶n eki kullanÄ±lÄ±r. \n ohvps \nSabit metin âohvpsâ (Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri kÄ±saltmasÄ±) \n [kaynak-grubu] \nKaynak grubu, APIâye eriÅmek iÃ§in kullanÄ±lan Ã¶deme hizmetine (HBH, ÃBH) gÃ¶re eriÅim adresi (end point) grubunu tanÄ±mlar (âhbhâ veya âobhâ). \n [sÃ¼rÃ¼m] \nAPI sÃ¼rÃ¼mÃ¼nÃ¼ ifade eder (â/s[ana-sÃ¼rÃ¼m].[alt-sÃ¼rÃ¼m]/â). \n [kaynak]/[kaynak-no] \nKaynak detaylarÄ±nÄ± ifade eder. \n [alt-kaynak] \nAlt kaynak detaylarÄ±nÄ± ifade eder. \n \n HHS, tÃ¼m kaynaklarÄ± iÃ§in aynÄ± katÄ±lÄ±mcÄ± yolu Ã¶n ekini ve sistem adÄ±nÄ± kullanmalÄ±dÄ±r. \n BKM APIâlerine eriÅmek isteyen uygulamalarÄ±n yetkilerine gÃ¶re aÅaÄÄ±daki APIâlere abone olmalarÄ± gerekmektedir: \n OBH: \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s1.1/odeme-emri-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s1.1/odeme-emri \nHBH: \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s1.1/hesap-bilgisi-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s1.1/hesaplar \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s1.1/hesaplar/1234/islemler \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s1.1/hesaplar/1234/bakiye \nGKD \n https://gecit-api.bkmtest.com.tr/ohvps/gkd/s1.1/erisim-belirteci \nHHS â YÃS API \n https://gecit-api.bkmtest.com.tr/hhs-api/s1.1/hhs \n https://gecit-api.bkmtest.com.tr/hhs-api/s1.1/hhs/1234 \n https://gecit-api.bkmtest.com.tr/yos-api/s1.1/yos \n https://gecit-api.bkmtest.com.tr/yos-api/s1.1/yos/1234 \n HHSâlerin saÄlayacaklarÄ± APIâlerdeki URI Ã§evrimi Ã¶rnekleri aÅaÄÄ±daki gibidir. \n \n https://xbank.com.tr/api-portal/ohvps/obh/s1.1/odeme-emri \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s1.1/odeme-emri  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.1/hesap-bilgisi-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s1.1/hesap-bilgisi-rizasi  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.1/hesaplar \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s1.1/hesaplar   (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.1/hesaplar/1234 \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s1.1/hesaplar/1234  (BKM API) \n \n GEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda, istek baÅlÄ±ÄÄ±nda bulunan âx-aspsp-codeâ (isteÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodu) deÄerine gÃ¶re HHS APIâde standart olarak tanÄ±mlanmÄ±Å olan âbasePathâ bilgisine servis uzantÄ±sÄ± eklenerek HHSâye yÃ¶nlendirme yapÄ±lÄ±r. \n ÃrneÄin, istek baÅlÄ±ÄÄ±nda  xbank âÄ±n kodu varsa, YÃS tarafÄ±ndan yapÄ±lan \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s1.1/hesap-bilgisi-rizasi \nÃ§aÄrÄ±sÄ± GEÃÄ°T tarafÄ±ndan karÅÄ±lanarak \n https://xbank.com.tr/api-portal/ohvps/hbh/s1.1/hesap-bilgisi-rizasi \nadresine yÃ¶nlendirilir. \n Bu Ã¶rnekte,  https://xbank.com.tr/api-portal  basePath bilgisi HHS tarafÄ±ndan HHS APIâye girilen deÄerdir. \n ÃNEMLÄ° :  URI Query parametreleri GET ile iletilirken deÄerlerde url-encode yapÄ±lmalÄ±dÄ±r. Ãrnek bir API isteÄi; \nGET /ohvps/hbh/s1.1/hesaplar/xxx/islemler?hesapIslemBslTrh=2023-02-07T16:42:38%2B03:00&hesapIslemBtsTrh=2023-02-07T17:09:18%2B03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfKytSayi=10&syfNo=1 \n Burada \'+\' karakterinin boÅluk olarak algÄ±lanmamasÄ± iÃ§in %2B deÄeri ile iletilmiÅtir. \n 3.6.\tKarakter Kodlama \n API istekleri ve yanÄ±tlarÄ±nÄ±n  BaÅlÄ±k  parametrelerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r.  3.15. Ä°stek BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n API istekleri ve yanÄ±tlarÄ±nda  GÃ¶vde  parametrelerinde UTF-8 karakter kodlamasÄ± kullanÄ±lÄ±r. Bu, JSON iÃ§in varsayÄ±lan karakter kodlamasÄ±dÄ±r. \n Ancak, bir HHS\'nin kendi uygulamalarÄ± ve Ã¶deme baÅlattÄ±ÄÄ± Ã¶deme sistemi (Havale vb.) bazÄ± UTF-8 karakterlerini kabul etmeyebilir. HHS, UTF-8 kodlamasÄ± iÃ§eren bir mesajÄ± iÅleyemez ve reddederse, HTTP 400 (HatalÄ± Ä°stek) durum ko

16du ile yanÄ±t vermelidir. \n GÃ¶vde parametrelerinde desteklenen UTF-8 karakter kÃ¼mesi aÅaÄÄ±da listelenmiÅtir. \n \n \n \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n \n \n \n \n \n 20 \n = \n 3d \n X \n 58 \n r \n 72 \n \n \n ! \n 21 \n ? \n 3f \n Y \n 59 \n s \n 73 \n\n 23 \n @ \n 40 \n Z \n 5a \n t \n 74 \n \n \n % \n 25 \n A \n 41 \n [ \n 5b \n u \n 75 \n \n \n & \n 26 \n B \n 42 \n \\ \n 5c \n v \n 76 \n \n \n \' \n 27 \n C \n 43 \n ] \n 5d \n w \n 77 \n \n \n ( \n 28 \n D \n 44 \n ^ \n 5e \n x \n 78 \n \n \n ) \n 29 \n E \n 45 \n _ \n 5f \n y \n 79 \n \n \n * \n 2a \n F \n 46 \n a \n 61 \n z \n 7a \n \n \n + \n 2b \n G \n 47 \n b \n 62 \n { \n 7b \n \n \n , \n 2c \n H \n 48 \n c \n 63 \n } \n 7d \n \n \n - \n 2d \n I \n 49 \n d \n 64 \n Ã \n c3 \n \n \n . \n 2e \n J \n 4a \n e \n 65 \n Ã \n c3 \n \n \n / \n 2f \n K \n 4b \n f \n 66 \n Ã \n c3 \n \n \n 0 \n 30 \n L \n 4c \n g \n 67 \n Ã§ \n c3 \n \n \n 1 \n 31 \n M \n 4d \n h \n 68 \n Ã¶ \n c3 \n \n \n 2 \n 32 \n N \n 4e \n i \n 69 \n Ã¼ \n c3 \n \n \n 3 \n 33 \n O \n 4f \n j \n 6a \n Ä \n c4 \n \n \n 4 \n 34 \n P \n 50 \n k \n 6b \n Ä \n c4 \n \n \n 5 \n 35 \n Q \n 51 \n l \n 6c \n Ä° \n c4 \n \n \n 6 \n 36 \n R \n 52 \n m \n 6d \n Ä± \n c4 \n \n \n 7 \n 37 \n S \n 53 \n n \n 6e \n Å \n c5 \n \n \n 8 \n 38 \n T \n 54 \n o \n 6f \n Å \n c5 \n \n \n 9 \n 39 \n U \n 55 \n p \n 70 \n \n \n \n \n : \n 3a \n V \n 56 \n q \n 71 \n \n \n \n \n ; \n 3b \n W \n 57 \n \n \n \n \n \n \n \n Ancak  EriÅim belirteci, Yenileme belirteci ve Authorization  parametreleri daha dar bir karakter kÃ¼mesi ile doldurulmalÄ±dÄ±r. \n Bearer HTTP Authorization ÅemasÄ± RFC 6750\'de tanÄ±mlanmÄ±ÅtÄ±r.  https://www.rfc-editor.org/rfc/rfc6750#section-2.1  bÃ¶lÃ¼mÃ¼nde izin verilen karakterlerin gÃ¶nderilmesi beklenmektedir. Buradaki standartÄ±n her 3 parametre iÃ§in de uygulanmasÄ±na karar verilmiÅtir. \n RFC 6750 iÃ§erisinde bearer token formatÄ± Åu Åekildedir : 1*( ALPHA / DIGIT / "-" / "." / "_" / "~" / "+" / "/" ) *"=" \nAugmented BNF for Syntax Specifications (ABNF) ile ifade edilen bu formatta token en az 1 adet alfanumerik karakter veya Ã¶zel karakter ("-", "." , "_" , "~" , "+" , "/")  iÃ§ermeli ve 0 ya da daha Ã§ok sayÄ±da "=" karakteri ile bitmelidir. \n ALPHA = A-Z / a-z aralÄ±ÄÄ±ndaki harflerdir. \nDIGIT = 0-9 aralÄ±ÄÄ±ndaki rakamlardÄ±r. \n 3.7.\tVeri FormatÄ± \n \n AÃ§Ä±k bankacÄ±lÄ±k kapsamÄ±ndaki zaman damgasÄ±, ISO 8601 standartÄ±na uygun olarak yerel saat bilgisini ve timezone bilgisini de iÃ§erecek Åekilde " yyyy-MM-ddâTâHH:mm:ssXXX " formattaki haliyle hazÄ±rlanmalÄ±dÄ±r. \n \n Ãrnek:  "timestamp": "2021-05-30T20:34:15+03:00" \nyyyy : 4 hane yÄ±l \nMM : BaÅa â0â eklenmiÅ, toplam 2 hane ay \ndd    : BaÅa â0â eklenmiÅ, toplam 2 hane gÃ¼n \nHH    : BaÅa â0â eklenmiÅ, toplam 2 hane saat (0-23 arasÄ± deÄer alabilir.) \nmm : BaÅa â0â eklenmiÅ, toplam 2 hane dakika \nss    : BaÅa â0â eklenmiÅ, toplam 2 hane saniye \nXXX : ISO 8601 Time zone \n \n \n Zaman damgasÄ± hesaplamalarÄ±nda, yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saatinin 00:00:00 olduÄu kabul edilmiÅtir. \n \n \n JWT veri paketlerinde kullanÄ±lan zaman damgalarÄ±, 1 Ocak 1970 Saat 00:00:00 (UTC) anÄ±ndan itibaren geÃ§en saniye sayÄ±sÄ± deÄerini (Unix Time) kullanmalÄ±dÄ±r. \n \n \n Bir HHS, tarihi yanlÄ±Å biÃ§imlendirilmiÅ bir istek aldÄ±ÄÄ±nda, 400 (HatalÄ± Ä°stek) durum kodu ve ilgili hata kodu ile yanÄ±t vermelidir. \n \n \n ISO 4217 StandartÄ±nda para birimleri ve kaÃ§ basamak ondalÄ±k deÄer iÃ§erebilecekleri belirlenmiÅtir. \n https://www.iso.org/iso-4217-currency-codes.html   adresinden Ã¼cretsiz olarak listeye eriÅilebilir.  \nAPI StandartlarÄ±nda da para birimleri  ISO 4217âde tanÄ±mlanmÄ±Å olan 3 harfli kodlarla iletilir.   TÃ¼m tutar alanlarÄ± ISO 4217\'de tanÄ±mlanmÄ±Å para birimlerinin ondalÄ±k basamak deÄerleri de gÃ¶z Ã¶nÃ¼nde bulundurularak iletilmelidir. Tutar alanlarÄ± artÄ± ya da eksi deÄer alabileceÄi iÃ§in API deseninde tanÄ±mlanmÄ±Å regular expressionlar dikkate alÄ±nmalÄ±dÄ±r. \nÃrneÄin; Bakiye API\'sindeki "Kredili Mevduat HesabÄ± Bakiyesi" alanÄ± "-100.25" ve "Para Birimi" alanÄ± "TRY" olarak

16iletildiÄinde 25 deÄerinin kuruÅ olduÄu anlaÅÄ±lmalÄ±dÄ±r. \nÃdeme Emri RÄ±zasÄ± API\'sinde yer alan "Ä°Ålem TutarÄ±" alanÄ± "104.75" TRY olarak iletildiÄinde "75" deÄerinin kuruÅ olduÄu anlaÅÄ±lmalÄ±dÄ±r. \n"12000" Japon Yeni iÃ§in, ISO 4217âde JPY para biriminin ondalÄ±k kÄ±smÄ± olmadÄ±ÄÄ±ndan "Ä°Ålem TutarÄ±" alanÄ±nda "12000" ve "Para Birimi" alanÄ±nda "JPY" deÄeri  iletilmelidir. \n \n \n AltÄ±n para birimi Ã¶zelinde ISO 4217âye uygun olarak "XAU" cinsinde ve 2 basamak ondalÄ±k rakam iÃ§erecek Åekilde iletilmelidir. ÃrneÄin iÃ§erisinde "13,50 gr" altÄ±n olan hesap iÃ§in bakiye "13.50", para birimi "XAU" olarak gÃ¶nderilmelidir. \n \n \n DiÄer madenlerde ondalÄ±k basamak ISO 4217 standartÄ±nda tanÄ±mlandÄ±ÄÄ± gibi olmalÄ±dÄ±r. \n \n \n SÄ±ralÄ± veri tipleri bÃ¼yÃ¼k kÃ¼Ã§Ã¼k harfe duyarlÄ± olmalÄ±dÄ±r. \n 3.8.\tÄ°stemci Sertifika YÃ¶netimi \n ÃHVPS kapsamÄ±nda YÃS ve HHSâlerin gÃ¼venli bir Åekilde tanÄ±mlanmasÄ± amacÄ±yla elektronik sertifikalar kullanÄ±lÄ±r. \n ÃHVPS kapsamÄ±nda taraflarÄ±n gÃ¼venli bir Åekilde tanÄ±mlamasÄ±, uÃ§tan uca gÃ¼venli iletiÅim, mesaj Åifreleme ve mesaj imzalama iÅlevleri 15/1/2004 tarihli ve 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunuânda aÃ§Ä±klanan elektronik sertifikalar kullanÄ±larak saÄlanÄ±r. Elektronik sertifikada TÃ¼rkiye Cumhuriyet Merkez BankasÄ± tarafÄ±ndan verilen kuruluÅ kodu ve kuruluÅun tÃ¼rÃ¼ne dair bilgiler bulunur. \n GEÃÄ°T Ã¼zerinden yapÄ±lan eriÅimlerde YÃS ve HHSâlere Ã¶nceden daÄÄ±tÄ±lmÄ±Å olan istemci sertifikalarÄ± kullanÄ±larak taraflarÄ±n (sunucu) kimliklerinin doÄrulanmasÄ± saÄlanacaktÄ±r. Ä°stemci sertifikalarÄ± hem test hem de Ã¼retim ortamÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi sertifikasyon sÃ¼recinde de sÄ±nanacaktÄ±r. SÃ¶z konusu sertifikalarÄ±n daÄÄ±tÄ±m prosedÃ¼rleri ve kullanÄ±mlara yÃ¶nelik aÃ§Ä±klamalar EK-3âte yer verilmiÅtir. \n 3.9.\tYetkilendirme TÃ¼rleri \n GEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda iki temel yetkilendirme tÃ¼rÃ¼ kullanÄ±lÄ±r: \n 1.\tÄ°stemci Kimlik Bilgileri:  MÃ¼Återi onayÄ±nÄ±n gerekmediÄi, sadece YÃSâÃ¼n tanÄ±mlanÄ±p doÄrulandÄ±ÄÄ± API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. YÃSâÃ¼n yetkilendirilmiÅ olduÄu ve faaliyet izninin yaptÄ±ÄÄ± hizmet Ã§aÄrÄ±sÄ±na uygun olduÄu kontrol edilir.  Bu amaÃ§la, YÃSâlere clientId ve clientSecret tahsis edilecektir. YÃSâler ilgili clientId ve clientSecret ile sadece yetkilendirilmiÅ olduklarÄ± servislere eriÅebileceklerdir. YÃSâler kendilerine BKM tarafÄ±ndan sunulacak APIâyi, kendi clientID ve clientSecret deÄerleri ile sorgulayarak âÄ°stemci Kimlik Bilgileriâ belirtecini (access token) elde edeceklerdir.\nHHSâler de GEÃÄ°T Ã¼zerindeki YÃS APIâsini sorgulama maksadÄ± ile GEÃÄ°T\'e geldiklerinde, kendilerine atanmÄ±Å olan clientID ve clientSecret bilgileri ile yetki kontrolleri yapÄ±lÄ±r.\nHHSâler kendilerinden alÄ±nacak username ve password deÄerleri kullanÄ±larak oluÅturulacak basic authentication metodu ile servislerini sunacaklardÄ±r. \n 2.\tYetkilendirme Kodu:  YÃSâÃ¼n doÄrulanmasÄ±nÄ±n yanÄ±sÄ±ra mÃ¼Återinin GKD ile doÄrulanmasÄ± gereken API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. MÃ¼Återi doÄrulanarak yetkilendirme kodu oluÅturulmasÄ± HHSânin yetkilendirme arayÃ¼zÃ¼ne yÃ¶nlendirilir. GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda yetkilendirme kodu YÃSâe dÃ¶nÃ¼lÃ¼r. YÃS daha sonra HHSânin  eriÅim belirteci  (access token) eriÅim adresini (EK-3: POST /erisim-belirteci) Ã§aÄÄ±rmak suretiyle yetkilendirme kodunu bir eriÅim belirteci (access token) ile deÄiÅtirerek ilgili kaynaklarÄ± kullanabilir. \n Ãdeme emri baÅlatma ve hesap bilgisi hizmetlerinde hangi yetkilendirme tÃ¼rlerinin kullanÄ±lacaÄÄ± bilgisi, ilgili baÅlÄ±klardaki eriÅim adresleri (endpoints) tablolarÄ±nda yer almaktadÄ±r. \n erisim-belirteci  erisim noktasÄ±ndan elde edilen  erisimBelirteci  iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda  x-access-token  alanÄ±nda iletilir.\nBelirli bir sÃ¼re iÃ§in tanÄ±mlanan eriÅim belirteci (access token) deÄerinin yenileme belirteci (refresh token) ile yenilenmesi gerekir. \n EriÅim adreslerinde kullanÄ±lan yetkilendirme tÃ¼rÃ¼ ilgili eriÅim adresi tablolarÄ±nda belirtilmiÅtir. \n 3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ± \n Ä°stek ve Cevap mesajlarÄ±nda kullanÄ±lacak olan nesneler tÃ¼m elemanlarÄ±nÄ± kapsayacak Åekilde Ek-1 de listelenmiÅtir. TÃ¼m listelenen elemanlar aÃ§Ä±sÄ±ndan (UÃ§ nokta mesaj yapÄ±larÄ±nÄ±n belirtildiÄi tablolarda belirtildiÄi Ã¼zere) alanÄ±n Zorunlu (z) veya Ä°steÄe BaÄlÄ± (Ä°) olma durumlarÄ±na gÃ¶re bazÄ± alanlar gÃ¶nderilebilir veya gÃ¶nderilmeyebilir. \n 3.11. SayfalandÄ±rma ve Filtreleme \n SayfalandÄ±rma \n ÃaÄrÄ±ya dÃ¶nÃ¼len kaynak nesnesi iÃ§erisindeki kayÄ±tlar bir sayfalandÄ±rma yapÄ±sÄ± ile Ã§

16aÄrÄ±lacak Åekilde istek oluÅturulur. \n OluÅturulacak isteÄin iÃ§erisinde parametreler ile filtreleme, sayfa baÅÄ±na gÃ¶sterilecek kayÄ±t sayÄ±sÄ± ve hangi sayfanÄ±n Ã¶nyÃ¼zde gÃ¶sterileceÄi bilgileri eriÅim noktasÄ±na iletilir ve ilgili kayÄ±tlar cevap olarak alÄ±nÄ±r. \n Filtreleme \n HHS, birden Ã§ok kayÄ±t dÃ¶nÃ¼lmesi gereken GET Ã§aÄrÄ±larÄ±nda sÄ±nÄ±rlÄ± filtreleme desteÄi saÄlamalÄ±dÄ±r. Filtre parametreleri her zaman kaynak nesnesinin belirli alanlarÄ±na Ã¶zgÃ¼dÃ¼r ve nesne iÃ§in tanÄ±mlanan kurallara uymalÄ±dÄ±r. \n 3.12. Mesaj Ä°mzalama \n Elektronik imzalar, ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini destekler. Ä°mzalarÄ±n kaynak bazÄ±nda hangi istek ve yanÄ±tlara uygulandÄ±ÄÄ± belirlidir. \n API yalnÄ±zca TLS\'ye dayanÄ±rsa, dijital kayÄ±tlarÄ± ve inkÃ¢r edilemezlik kanÄ±tlarÄ±nÄ± tutmak zor olur. Bu nedenle, TLS\'ye dayanmayan bir inkÃ¢r edilemezlik Ã§Ã¶zÃ¼mÃ¼ olarak API isteÄinin HTTP baÅlÄ±ÄÄ±nda bir JWS kullanÄ±larak saÄlanabilir. \n HTTP isteÄinin gÃ¶vdesinin hash fonksiyonu (SHA256) ile Ã¶zeti alÄ±nacaktÄ±r. Elde edilen Ã¶zet, asimetrik anahtarlarÄ± destekleyen bir algoritma kullanÄ±larak imzalanacak ve JWS elde edilecektir. \n Bir istek, YÃS\'nin Ã¶zel anahtarÄ± ile imzalanacak ve bu isteÄe karÅÄ±lÄ±k gelen yanÄ±t, HHS\'nin Ã¶zel anahtarÄ± tarafÄ±ndan imzalanacaktÄ±r. \n TÃ¼m API istekleri ve yanÄ±tlarÄ± imzalanmaz. Mesaj imzalamanÄ±n zorunlu olup olmadÄ±ÄÄ±, desteklenip desteklenmediÄi her API Ã¶zelinde belirlenir. \n Anahtar Deposu \n HHS\'ler ve YÃS\'ler tarafÄ±ndan gÃ¼venilen bir GÃ¼ven Otoritesi (Trust Anchor), taraflar iÃ§in bir genel anahtar deposu saÄlamaktan sorumludur. \n GÃ¼ven Otoritesi, taraflardan herhangi birisinin oluÅturduÄu bir anahtar Ã§iftinin aÃ§Ä±k bÃ¶lÃ¼mÃ¼nÃ¼ saklayan merkezi bir dizin (BKM tarafÄ±ndan tutulan merkezi kayÄ±t sistemi vb.) olacaktÄ±r. \n MesajlarÄ± doÄrulamak iÃ§in taraflarÄ±n genel anahtarlarÄ±nÄ±n paylaÅÄ±lmasÄ± iÃ§in BKM bir servis saÄlayacaktÄ±r. HHS API olarak adlandÄ±rÄ±lÄ±mÄ±Å olan bu servis ile HHS ve YÃS listelerine ulaÅÄ±labildiÄi gibi doÄrulama iÅlemi iÃ§in ihtiyaÃ§ duyulacak olan genel anahtarlara da bu servis Ã¼zerinden eriÅilebilinecektir. \n Ä°lgili Mesaj Åifreleme iÃ§in genel akÄ±Å, Ek-5 bÃ¶lÃ¼mÃ¼nde detaylarÄ±yla paylaÅÄ±lmaktadÄ±r. \n 3.13. Durum Kodu \n APIâler, iki farklÄ± amaca hizmet eden iki durum kodu kullanÄ±r: \n \n HTTP Durum Kodu, API Ã§aÄrÄ±sÄ±nÄ±n (kaynaktaki HTTP iÅlemi) sonucunu yansÄ±tÄ±r. \n BazÄ± kaynak payloadâlarÄ±ndaki Durum alanÄ±, kaynaklarÄ±n durumunu yansÄ±tÄ±r. \n 3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ± \n EriÅim adreslerinin ve alanlarÄ±n kullanÄ±mÄ± Zorunlu(Z), Ä°steÄe BaÄlÄ±(Ä°) veya KoÅullu(K) olabilir. KullanÄ±mlara iliÅkin durumlar ve kullanÄ±mÄ±n (K) koÅullu olduÄu duruma iliÅkin aÃ§Ä±klamalar ilgili tablolarda belirtilmiÅtir. \n ÃHVPS API\'lerinin (HBH,ÃBH,GKD) istek ve yanÄ±tta kullanÄ±lacak baÅlÄ±k isimleri, ilgili RFC dokÃ¼manlarÄ±nda ve aÅaÄÄ±daki tabloda yer aldÄ±ÄÄ± Åekilde kullanÄ±lacaktÄ±r.  Uygulamaya Ã¶zelleÅmiÅ baÅlÄ±klar "X-" ile baÅlayacaktÄ±r. BaÅlÄ±k isimlerinde yer alacak kÄ±saltmalar (Ã¶rn. PSU, ASPSP gibi) tamamÄ± bÃ¼yÃ¼k harfle yazÄ±lacak Åekilde tanÄ±mlanacaktÄ±r. BaÅlÄ±k isimleri bÃ¼yÃ¼k â kÃ¼Ã§Ã¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin x-request-id ya da X-Request-ID olarak gÃ¶nderilmiÅ olan bir istek baÅlÄ±ÄÄ± deÄiÅkeni, sunucu tarafÄ±nda hata vermeyecek Åekilde iÅlenebilmelidir. \n 3.15. Ä°stek BaÅlÄ±ÄÄ± \n \n "BaÅlÄ±k isimleri" yorumlanÄ±rken kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin "x-ReQuEsT-Id" geÃ§erli bir baÅlÄ±k ismidir. \n "BaÅlÄ±k deÄerleri" yorumlanÄ±rken ise kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harf duyarlÄ±lÄ±ÄÄ± olmalÄ±dÄ±r. ÃrneÄin "xyz123" ile "XYZ123" deÄerleri farklÄ±dÄ±r. \n BaÅlÄ±k deÄerlerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r. ÃrneÄin "PSU-Device-Data" deÄerinde "Ä°OS12" yazmak, bÃ¼yÃ¼k "Ä°" harfinin ISO-8859-1 iÃ§erisinde yer almamasÄ±ndan dolayÄ±, hataya yol aÃ§acaktÄ±r. \n Ä°stek ve YanÄ±t baÅlÄ±ÄÄ±nda yer alan alanlarÄ±n;

16 POST GET DELETE methodlarÄ±nda, OBH,HBH,GKD,OAS,ODS API\'leri bazÄ±nda Zorunlu/KoÅullu/Ä°steÄe BaÄlÄ± kullanÄ±m durumlarÄ± aÅaÄÄ±daki tabloda listelenmiÅtir. \n \n Tablo 2: Ä°stek BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n POST \n GET \n DELETE \n POST \n GET \n DELETE \n \n \n \n \n \n \n \n OBH HBH GKD \n OBH HBH GKD \n OBH HBH GKD \n OAS ODS \n OAS ODS \n OAS ODS \n \n \n X-Request-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±.   Ãrnek: Ãdeme emri baÅlatma iÅ akÄ±ÅÄ±nÄ±n her adÄ±mda farklÄ± âx-request-idâ deÄeri kullanÄ±lÄ±r.   ÃaÄrÄ±larÄ±n aynÄ± yanÄ±tÄ± dÃ¶nmesinin beklendiÄi durumlarda (idempotent iÅlemlerde) aynÄ± deÄer ile Ã§aÄrÄ± yapÄ±lÄ±r. \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±.  AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± x-group-id bilgisi deÄeri gÃ¶nderilmelidir. Ãrnek: Ãdeme emri baÅlatma/hesap bilgisi iÅ akÄ±ÅÄ±nÄ±n her adÄ±mÄ±nda aynÄ± âx-group-idâ deÄeri kullanÄ±lÄ±r. \n Z \n Z \n Z \n - \n - \n - \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder. Bu deÄerin application/json olarak gÃ¶nderilmesi gerekmektedir. Hata durumlarÄ±nda application/problem+json da iletilebilir.  (BaÅka bir deÄere ayarlanÄ±rsa, HHS, 415 Desteklenmeyen Ortam TÃ¼rÃ¼ (Unsupported Media Type) ile yanÄ±t vermelidir) \n Z \n - \n - \n Z \n - \n - \n \n \n X-ASPSP-Code \n AN4 \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n (HHS) kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-TPP-Code \n AN4 \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n PSU-Auth-Date \n ISODateTime \n ÃHKânÄ±n YÃS Ã¼zerinde en son oturum aÃ§tÄ±ÄÄ± saat. [RFC7231] ÃrneÄin:  auth-date: Tue, 11 Sep 2012 19:43:31 GMT \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-IP-Address \n AN7..15 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n IP adresi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-IP-Port \n AN1..5 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n Port adresi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-GEO-Location \n AN1..36 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n konum bilgisi. RFC2426 standartÄ±na uygun olarak paylaÅÄ±lmalÄ±dÄ±r. ÃrneÄin  GEO:"<enlem >, <boylam>GEO:52.506931,13.144558 \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-User-Agent \n AN 1.. 255 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n saÄladÄ±ÄÄ± user-agent bilgisi. (TarayÄ±cÄ±, versiyon, iÅletim sistemi bilgileri) \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Timestamp \n ISODateTime \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n tarih saat iÃ§eren zaman bilgisi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Device-ID \n AN5..40 \n ÃHK iÅlemi mobil uygulama aracÄ±lÄ±ÄÄ±yla baÅlattÄ±ysa, kullanÄ±lan mobil uygulama ilk yÃ¼klendiÄinde oluÅturulan tekil cihaz veya uygulama belirteci. ÃHK cihazÄ±nÄ±n UUID deÄeri kullanÄ±labilir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Device-Data \n AN1..1024 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± mobil cihaza ait veriler.  Ãrnek alanlar:   - Platform - (Android, iOS, Windows 10 Mobile)  - Device Model   - OS Name   - OS Version - Locale - Time zone \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Initiated \n AN1 \n Ä°Ålemin ÃHK tarafÄ±ndan baÅlatÄ±lmasÄ± durumunda E , sistem tarafÄ±ndan baÅlatÄ±ldÄ±ÄÄ± durumda H deÄerini, olay bildirimine istinaden yapÄ±lacak isteklerde O deÄerini almasÄ± beklenir. Ä°Ålemler servisinde yapÄ±lacak sistemsel sorgulardaki iÅlem limitlerini kontrol amacÄ±yla kullanÄ±lÄ±r. O deÄerinin gÃ¶nderilebileceÄi API\'ler  AsÄ±l Verinin Elde EdileceÄi API  olarak ilgili sayfada yer alan Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi tablosunda yer almaktadÄ±r. AsÄ±l verinin elde edileceÄi API\'ler Ã¶zelinde O gÃ¶nderimi yapÄ±labilir. O olarak yapÄ±lan her isteÄe HHS\'nin yanÄ±t vermesi gereklidir. Otomatik sorgularda uygulanan Ã¼st limitler, O gÃ¶nderimi durumunda geÃ§erli deÄildir. \n Z \n Z \n Z \n - \n

16- \n - \n \n \n PSU-Fraud-Check \n AN1..4096 \n YÃS\'lerin Ã§eÅitli gÃ¼venlik kontrollerini gerÃ§ekleÅtirerek, Ã¶nemli gÃ¶rÃ¼len aÅaÄÄ±daki bilgileri HHS\'ler ile paylaÅmalarÄ± gerekmektedir. Bu bilgiler Ä±ÅÄ±ÄÄ±nda mÃ¼Återinin profili oluÅturulmasÄ±na katkÄ± saÄlanacaktÄ±r.   ÃHKâlÄ± iÅlemlerde (PSU-Initiated = E gÃ¶nderildiÄi durumlarda) gÃ¶nderilmesi zorunludur.  Sistemsel yapÄ±lan API Ã§aÄrÄ±mlarÄ±mda, Olay Bildirim Servis ÃaÄrÄ±mlarÄ±nda ve HHS-YÃS API Ã§aÄrÄ±mlarÄ±nda gÃ¶nderilmesine gerek bulunmamaktadÄ±r.  PaylaÅÄ±lacak bilgiler Åu Åekildedir.   FirstLoginFlag  : ÃHK\'nÄ±n, mÃ¼Återilik Ã¶mrÃ¼nde ilgili YÃS sistemine (mobil ya da web uygulamasÄ±) ilk login olma sÃ¼resini ifade eden deÄer. ÃHK\'nÄ±n ilk yaptÄ±ÄÄ± HBH ya da ÃBH iÅlemi deÄil, YÃS sisteminde kendini aktifleÅtirme tarih aralÄ±ÄÄ± bilgisidir.   YÃS, kullanÄ±cÄ±nÄ±n ilk login bilgisini tutarak sonraki iÅlemlerinde bu bilgiyi belirlenen format ile HHS\'ye aktaracaktÄ±r. ÃrneÄin; YÃS\'Ã¼n 7 aydÄ±r mÃ¼Återisi olan bir kullanÄ±cÄ± iÃ§in bu alan "5" olarak YÃS tarafÄ±ndan beslenecektir. Burada amaÃ§; ilgili kullanÄ±cÄ±nÄ±n YÃS\'Ã¼n eski bir mÃ¼Återisi mi, yoksa yeni bir mÃ¼Återisi mi olup olmadÄ±ÄÄ±nÄ± anlamaktÄ±r.   GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   DeviceFirstLoginFlag  : ÃHK\'nÄ±n, mÃ¼Återilik Ã¶mrÃ¼nde iÅlem anÄ±nda kullandÄ±ÄÄ± cihazla YÃS uygulamasÄ±na (web ya da uygulama tabanlÄ±) ilk login olma sÃ¼resini ifade eden deÄer. ÃHK cihaz deÄiÅikliÄi yaparsa FirstLoginFlag deÄeri sabit kalmalÄ±  ancak DeviceFirstLoginFlag deÄeri deÄiÅmelidir.  FirstloginFlag deÄeri ile ÃHKânÄ±n YÃS uygulamasÄ±na ilk login tarih bilgisi ile ilgili bilgi verilirken, DeviceFirstLoginFlag ile de ÃHKânÄ±n YÃS uygulamasÄ±na farklÄ± bir cihaz aracÄ±lÄ±ÄÄ± ile ilk login tarihinin bilgisi verilmektedir.  ÃrneÄin; ÃHK 7 aydÄ±r YÃS\'Ã¼n mÃ¼Återisi olabilir, bÃ¶yle bir durumda FirstLoginFlag deÄeri "5" olacaktÄ±r. Ancak son iÅlemini daha Ã¶nce hiÃ§ kullanmadÄ±ÄÄ± bir cihazdan yapmÄ±ÅtÄ±r. Yeni cihazdaki login sÃ¼re aralÄ±ÄÄ± 0-2 saat aralÄ±ÄÄ±nda  olduÄu iÃ§in DeviceFirstLoginFlag deÄeri "1" olacaktÄ±r.FirstLoginFlag deÄeri yine "5" olarak kalmaya devam edecektir.Bu bilgi ile YÃS, ilgili HHS\'ye ilk kez geliyor olsa bile; HHS, mÃ¼Återinin YÃS\'Ã¼ uzun sÃ¼redir kullandÄ±ÄÄ±nÄ± ama yeni bir cihazla iÅlemlerine devam ettiÄini anlayabilecektir. Bir ÃHK, farklÄ± cihazlar veya platformlar Ã¼zerinden YÃS ile etkileÅime girebilir.  KullanÄ±cÄ± ve YÃS arasÄ±nda bir oturum baÅlatÄ±lmÄ±Å ise YÃSâÃ¼n tutarlÄ± ve kalÄ±cÄ± bir kimlik (device id) atamasÄ± beklenmektedir.  Device ID: Web sitesi veya mobil uygulama kullanÄ±cÄ±larÄ± iÃ§in Ã¼retilen, tarayÄ±cÄ± ya da mobil uygulama tabanlÄ± benzersiz (tekil) tanÄ±mlayÄ±cÄ± deÄer. Mobil uygulamalar iÃ§in ÃHKânÄ±n ilk defa ilgili cihaza aktivasyon yaptÄ±ÄÄ± tarih bilgisi alÄ±nmalÄ±dÄ±r.   Device ID bilgileri YÃS uygulama ortamÄ± (web ya da uygulama tabanlÄ±) ve ÃHK cihazÄ± bazÄ±nda tutulmalÄ±dÄ±r. YÃSâten baÅlatÄ±lan iÅlem hangi uygulama ortamÄ±na ait ise ilgili ortamala iliÅkili tutulan Device IDânin ilk login tarihine bakÄ±larak gÃ¼ncel flag deÄeri hesaplanmalÄ±dÄ±r.  GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   LastPasswordChangeFlag  : ÃHK\'nÄ±n, YÃS (cihaz baÄÄ±msÄ±z)  uygulamasÄ±na login olduÄu Åifre bilgisinin en son deÄiÅtirildiÄi sÃ¼reyi ifade eden deÄer. MÃ¼Återinin en son ne zaman Åifre deÄiÅikliÄi yaptÄ±ÄÄ±nÄ± anlamak iÃ§in kullanÄ±lan alandÄ±r. Yeni mÃ¼Återi ve hiÃ§ Åifre deÄiÅikliÄi yapmamÄ±Å olabilir, bÃ¶yle bir durumda ilgili alan "0" olarak beslenecektir.   GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   BlacklistFlag  : ÃHK\'nÄ±n herhangi bir sebeple YÃS\'Ã¼n sakÄ±ncalÄ± mÃ¼Återiler listesinde bulunup bulunmadÄ±ÄÄ±nÄ± ifade eden deÄer.   Burada amaÃ§ herhangi bir sebeple YÃS tarafÄ±nda yasaklÄ± olarak kayÄ±tlÄ± olan ÃHK bilgisinin, dolandÄ±rÄ±cÄ±lÄ±ÄÄ± Ã¶nceden tespit etmek amaÃ§lÄ± HHS\'ye aktarÄ±lmasÄ± olarak aÃ§Ä±klanabilir. ÃrneÄin, YÃS tarafÄ±ndan tespit edilen dolandÄ±rÄ±cÄ± kullancÄ±lara ait device id bilgisi, bu kara listede tutulur daha sonra aynÄ± cihazla baÅka bir ÃHK iÅlem yapacak olsa bile bu alanda ilgili bilgi "1" deÄeri ile HHS\'ye aktarÄ±lÄ±r. HHS\'de olmayÄ±p YÃS tarafÄ±nda olan bu Ã¶rnekteki sakÄ±ncalÄ± mÃ¼Återi/cihaz bilgisinin, dolaylÄ± yoldan HHS\'ye aktarÄ±lmasÄ± amaÃ§lanmaktadÄ±r.  GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.VarYok sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   MalwareFlag  : YÃS uygulamasÄ±nÄ±n Ã§alÄ±ÅtÄ±ÄÄ± cihaz Ã¼zerindeki son 21 gÃ¼ne ait zararlÄ± yazÄ±lÄ±m tespit bilgisini ifade eden deÄer. ÃrneÄin ÃHK\'nÄ±n cihazÄ±nda zararlÄ± yazÄ±lÄ±m olduÄ

16u ayÄ±n 1\'inde YÃS tarafÄ±ndan tespit edildi. ZararlÄ± yazÄ±lÄ±m tespitinden 2 saat sonra YÃS Ã¼zerinden login olan ÃHK\'nÄ±n durumu,  "1" olarak iletilecektir. Bir gÃ¼n sonra ayÄ±n 2\'sinde, yeni bir zararlÄ± yazÄ±lÄ±m tespiti yok ancak mevcut zararlÄ± yazÄ±lÄ±m aktifse alan "2" deÄeri ile iletilecektir. SÃ¼reler artarak 21 gÃ¼ne kadar TR.OHVPS.DataCode.ZmnAralik deÄerlerine gÃ¶re iletilecektir.Son 21 gÃ¼n iÃ§inde yeni bir tespit yoksa ayÄ±n 22\'sinden itibaren ilgili alan  "0" deÄeri ile beslenecektir. Not: ZararlÄ± yazÄ±lÄ±m, bankacÄ±lÄ±k iÅlemlerinin yapÄ±ldÄ±ÄÄ± uygulamalara giriÅte kullanÄ±lan bilgilerin (Åifre, kullanÄ±cÄ± kodu gibi) ele geÃ§irilmesi amacÄ±yla kullanÄ±lan bir uygulama ya da kod parÃ§acÄ±ÄÄ± olabilir. Bu amaÃ§lar dÄ±ÅÄ±nda kullanÄ±lan (bankacÄ±lÄ±Äa yÃ¶nelik bir zararlÄ± yazÄ±lÄ±m olmayan) yazÄ±lÄ±m tespitleri iletilmemelidir. YÃS kanallarÄ±na her bir loginde, kullanÄ±lan cihazda bir zararlÄ± yazÄ±lÄ±m var mÄ± yok mu kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.   GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   AnomalyFlag  : DiÄer ÅÃ¼pheli durumlarÄ±n varlÄ±ÄÄ±nÄ± ifade eden deÄer. GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.VarYok sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   UnsafeAccountFlag : HHS tarafÄ±ndan aktarÄ±lan bilgi ile son 21 gÃ¼n iÃ§inde ÃHK\'nÄ±n dolandÄ±rÄ±cÄ±lÄ±k maÄduru olmasÄ± durumunu ifade eden deÄer. ÃrneÄin; HHS 1, ayÄ±n 1\'inde sÃ¼phe veya sahtekarlÄ±k nedeniyle bir Ã¶deme iÅlemine izin vermediÄi durumda, bu bilgiyi rÄ±za iptal detay kodu ile YÃS\'e aktarmÄ±Å olur. Bu bilgiyi tutan YÃS, ilgili mÃ¼Återinin 15 dakika sonra HHS 2\'de yaptÄ±ÄÄ± iÅlem iÃ§in ilgili alanÄ± "1" deÄeri ile besler. BÃ¶ylece HHS 2, ÃHK\'nÄ±n farklÄ± bir HHS\'de son 15 dakika iÃ§inde ÅÃ¼pheli veya sahte bir iÅlemi olduÄunu anlayabilecektir. AyÄ±n 22\'sinde yeni bir tespit/kayÄ±t yoksa bu alan YÃS tarafÄ±ndan "0" olarak beslenecektir. GÃ¶nderilmesi Opsiyonel alandÄ±r.TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.     Flaglar JWT claims iÃ§ine key value Åeklinde eklenerek gÃ¶nderilecektir. EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±\'nda belirtilen yÃ¶ntemle imzalanarak oluÅturulan JWT PSU-Fraud-Check alanÄ±na konularak YÃS\'ler tarafÄ±ndan HHS\'ye iletilmelidir. \n K \n K \n Z \n - \n - \n - \n \n \n PSU-Session-ID \n AN1..100 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen oturuma Ã¶zgÃ¼ talep kimliÄi. ÃHK\'nÄ±n YÃS uygulamasÄ± Ã¼zerinden kimlik doÄrulama mekanizmasÄ± ile bilgi sistemlerine dÃ¢hil olmalarÄ±ndan iÅlemlerini tamamlayÄ±p sistemden ayrÄ±lmalarÄ±na kadar geÃ§ecek tÃ¼m sÃ¼reci kapsayacak Åekilde aynÄ± deÄeri almalÄ±dÄ±r. Tek seferlik Ã¶deme gibi ÃHKânÄ±n tanÄ±nmadan baÅlatÄ±ldÄ±ÄÄ± iÅlemlerde bu deÄer boÅ olarak iletilmelidir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n Authorization \n AN1..4096 \n KatÄ±lÄ±mcÄ± ile GEÃÄ°T arasÄ±ndaki otorizasyon iÃ§in kullanÄ±lan token bilgisidir.  Yekilendirme tÃ¼rlerinden Ä°stemci Kimlik Bilgileriâni adresler.    BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-Access-Token \n AN1..4096 \n ÃHKânÄ±n GKD sÃ¼recinde doÄrulanmasÄ± sonrasÄ±nda kullanÄ±lan eriÅim simgesi. Yetkilendirme tÃ¼rlerinden Yetkilendirme Kodu (GKD)ânu adresler.  BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n X-JWS-Signature \n AN1..4096 \n Payload gÃ¶vdesinin ayrÄ±lmÄ±Å bir JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi.  Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir.  Mesaj imzalama kullanÄ±lan API ve methoda gÃ¶re gÃ¶nderimi zorunludur. \n K \n K \n K \n K \n - \n - \n 3.16. YanÄ±t BaÅlÄ±ÄÄ± \n \n "BaÅlÄ±k isimleri" yorumlanÄ±rken kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin "x-ReQuEsT-Id" geÃ§erli bir baÅlÄ±k ismidir. \n "BaÅlÄ±k deÄerleri" yorumlanÄ±rken ise kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harf duy

16arlÄ±lÄ±ÄÄ± olmalÄ±dÄ±r. ÃrneÄin "xyz123" ile "XYZ123" deÄerleri farklÄ±dÄ±r. \n BaÅlÄ±k deÄerlerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r. ÃrneÄin "Link" deÄerinde "Ä°OS12" yazmak, bÃ¼yÃ¼k "Ä°" harfinin ISO-8859-1 iÃ§erisinde yer almamasÄ±ndan dolayÄ±, hataya yol aÃ§acaktÄ±r. \n \n Tablo 3: YanÄ±t BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n KullanÄ±m Durumu  OBH HBH GKD \n KullanÄ±m Durumu  OAS ODS \n \n \n \n \n X-Request-ID \n AN1..36 \n YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±    Ä°lgili istek baÅlÄ±ÄÄ±ndaki bilgi geri dÃ¶nÃ¼lÃ¼r. \n Z \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±. Ä°lgili istek baÅlÄ±ÄÄ±ndaki bu deÄer geri dÃ¶nÃ¼lÃ¼r. \n Z \n - \n \n \n X-ASPSP-Code \n AN4 \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n (HHS) kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n Z \n \n \n X-TPP-Code \n AN4 \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n Z \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder:  application/json \n Z \n Z \n \n \n X-JWS-Signature \n AN1..4096 \n JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n hangi yanÄ±tlar iÃ§in kullanÄ±lmasÄ± gerektiÄi ilgili endpoint iÃ§in belirtilmiÅtir.  Hata durumlarÄ±nda, yanÄ±t gÃ¶vdesi deÄeri dÃ¶nÃ¼lÃ¼yor ise imzalanmalÄ± ve imza bilgisi x-jws-signature alanÄ±nda iletilmelidir.  Ancak uygulama katmanÄ± tarafÄ±ndan yakalanamayan dolayÄ±sÄ± ile imzalanamayan hata durumlarÄ±nda x-jws-signature alanÄ± HHS\'ler tarafÄ±ndan boÅ gÃ¶nderilebilir. \n K \n K \n \n \n X-RateLimit-Limit \n N 1..18 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde en fazla kaÃ§ adet istek yapÄ±labileceÄini gÃ¶sterir. KÄ±sÄ±t uygulanan servislerde bu baÅlÄ±ÄÄ±n dÃ¶nmesi zorunludur. \n K \n - \n \n \n X-RateLimit-Remaining \n N 1..18 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde k

16aÃ§ adet istek hakkÄ± kaldÄ±ÄÄ±nÄ± gÃ¶sterir. KÄ±sÄ±t uygulanan servislerde bu baÅlÄ±ÄÄ±n dÃ¶nmesi zorunludur. \n K \n - \n \n \n X-RateLimit-Reset \n AN 1..255 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde Ã§aÄrÄ±m hakkÄ± bittikten sonra yeniden denemeden Ã¶nce beklemesi gereken sÃ¼reyi (saniye cinsinden) gÃ¶sterir. HTTP 429 durum kodu (Too Many Requests) ile dÃ¶nÃ¼len yanÄ±tlarÄ±n baÅlÄ±ÄÄ±nda dÃ¶nÃ¼lmesi zorunludur.  YÃS olarak yaptÄ±ÄÄ±nÄ±z sistemsel sorgularda; HTTP 429 durum kodu (Too Many Requests) ile dÃ¶nÃ¼len yanÄ±t aldÄ±ÄÄ±nÄ±zda tekrar sorgu yapmadan Ã¶nce âX-RateLimit-Resetâ yanÄ±t baÅlÄ±ÄÄ±nÄ± kontrol ederek, bu baÅlÄ±ktaki sÃ¼re kadar bekledikten sonra yeniden sorgulama yapÄ±lmasÄ± gerekmektedir. \n K \n - \n \n \n x-total-count \n N 1..18 \n Hesaplar, Ä°Ålemler, Bakiye, Ä°letilemeyen Olaylar servislerinde sayfalama kullanÄ±ldÄ±ÄÄ± durumda, sorgu sonucu dÃ¶necek toplam kayÄ±t sayÄ±sÄ± bilgisi, bu alanda HHS isteÄine baÄlÄ± olarak gÃ¶nderilebilir.   KayÄ±t sayÄ±sÄ± 0 olduÄu durumda gÃ¶nderimi zorunludur. \n K \n K \n \n \n Link \n 1..4096 \n âLinkâ alanÄ±nÄ±n  Hesap Bilgisi Hizmeti iÃ§in EriÅim Adresleri    tablosundaki parametre  = Sayfalama olan APIâlerde ve Ä°letilemeyen Olaylar API\'sinde gÃ¶nderim yapÄ±lmasÄ± zorunludur.  Sayfalama yapÄ±sÄ± kullanÄ±ldÄ±ÄÄ±nda gelen yanÄ±tta birden fazla sayfa var ise; Ã¶nceki, sonraki, ilk, son sayfalara gitmek iÃ§in gerekli referanslar link headerÄ±nda aÅaÄÄ±daki Ã¶rnekteki gibi doldurulabilir.  x-total-count alanÄ±nÄ±n gÃ¶nderimi kayÄ±t sayÄ±sÄ± 0 olduÄu durum dÄ±ÅÄ±nda isteÄe baÄlÄ± olduÄu iÃ§in; Link iÃ§erisindeki son sayfa bilgisi  (last) isteÄe baÄlÄ± hale getirilmiÅtir. âÃncekiâ( prev) ve âSonrakiâ (next) adÄ±mlarÄ±nÄ±n uygun olan her durumda yer almasÄ± zorunludur. Ä°lk sayfada âÃncekiâ seÃ§eneÄi olmamalÄ±, son sayfada ise âSonrakiâ seÃ§eneÄi olmamalÄ±dÄ±r.    </ohvps/hbh/s1.1/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=6&syfKytSayi=100>; rel="next",  </ohvps/hbh/s1.1/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=4&syfKytSayi=100>; rel="prev",  </ohvps/hbh/s1.1/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=14&syfKytSayi=100>; rel="last",  </ohvps/hbh/s1.1/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=0&syfKytSayi=100>; rel="first"    HiÃ§ hesap hareketinin olmadÄ±ÄÄ± durumda dÃ¶nen yanÄ±t baÅlÄ±ÄÄ±nÄ±zÄ±n Åu Åekilde olmasÄ± beklenmektedir.  Response body: [] Response header: Link: </ohvps/hbh/s1.1/hesaplar?srlmKrtr=hspRef&srlmYon=A&syfNo=1&syfKytSayi=100>; rel="last",</ohvps/hbh/s1.1/hesaplar?srlmKrtr=hspRef&srlmYon=A&syfNo=1&syfKytSayi=100>; rel="first"  x-total-count alanÄ± da 0 olarak iletilmelidir. \n K \n K \n 3.17. Idempotency KurallarÄ± \n YÃSâÃ¼n aÅaÄÄ±daki durumlarda aynÄ± istek numarasÄ± (x-request-id) ve aynÄ± veri gÃ¶vdesiyle Ã§aÄrÄ±yÄ± tekrarlamasÄ±; HHSânin de bu durumlarda aynÄ± yanÄ±tÄ± dÃ¶nmesi gereklidir. \n \n HHSânin yanÄ±tÄ± kesinti/arÄ±za nedeniyle YÃSâe ulaÅmaz ve zaman aÅÄ±mÄ± sÃ¶z konusu olmasÄ±, \n ÃHK, YÃS uygulamasÄ± Ã¼zerinden Ã§ift tÄ±klama ile mÃ¼kerrer defa HHS APIâlerini Ã§aÄÄ±rÄ±lmasÄ±,\n(API kontrollerinden Ã¶nce YÃS uygulamasÄ±nÄ±n, Ã§ift tÄ±klama kontrolÃ¼ yapmasÄ± Ã¶nerilmektedir.) \n YÃS, yanÄ±t almasÄ±na raÄmen iÅleyemeden kaybedilmesi, \n \n durumlarÄ±nda HHS aÅaÄÄ±daki kurallarÄ± iÅletir: \n \n HHS gelen istek numarasÄ±nÄ± ve veri gÃ¶vdesini birleÅtirerek checksum deÄeri Ã¼retir. \nchesksum deÄeri x-request-id|request.body ânin hash algoritmalarÄ±ndan (CRC32,MD5 vb)  geÃ§irilerek Ã¼retilebilir. \n HHS bu checksum deÄeri ile YÃSâe dÃ¶nmÃ¼Å olduÄu yanÄ±tÄ± 5 dk boyunca saklar.  Saklama yÃ¶ntemi olarak veri tabanÄ± veya Ã¶nbellek araÃ§larÄ± kullanÄ±labilir. \n YÃS aynÄ± istek numarasÄ± ve aynÄ± veri gÃ¶vdesi ile yeni bir Ã§aÄrÄ± yaptÄ±ÄÄ±nda, aynÄ± checksum deÄeri Ã¼retileceÄi iÃ§in 5dk boyunca bu deÄere karÅÄ±lÄ±k gelen yanÄ±tÄ± dÃ¶ner. \n 5 dk sonrasÄ±nda istek numarasÄ± veya veri gÃ¶vdesi deÄiÅmemiÅ olsa dahi bu HHS tarafÄ±ndan yeni istek olarak kabul edilir. \n \n AÅaÄÄ±daki Public Post iÅlemleri iÃ§in bu kural setinin iÅletilmesi gerekmektedir: \n 1- Ãdeme emri rÄ±zasÄ± oluÅturma \n2- EriÅim belirteci oluÅturma \n3- Ãdeme emri \n4- Hesap bilgisi rÄ±zasÄ± oluÅturma \n 3.18. HTTP Durum KodlarÄ± \n RFC 2616\'da belirlenmiÅ olan durum ko

16dlarÄ± (status code) gÃ¶nderilen isteÄin durumunu YÃSâa standart bir Åekilde ifade eder. EÄer bir hata varsa hatayÄ±, gÃ¶nderilen istek baÅarÄ±lÄ± bir Åekilde iÅlem gÃ¶rdÃ¼yse ona iliÅkin durumu aktarÄ±r. Durum kodlarÄ± genel olarak 5 kategoridedir. \n \n 1xx Bilgi \n 2xx BaÅarÄ±lÄ± \n 3xx YÃ¶nlendirme \n 4xx Ä°stemci HatasÄ± \n 5xx Sunucu HatasÄ± \n \n errorCode AlanÄ±nda KullanÄ±labilecek SÄ±ralÄ± Hata Tipleri : \n \n TR.OHVPS.Resource \n \n â¨\tInvalidFormat \n â¨\tConsentMismatch \n â¨\tNotFound \n â¨\tInvalidSignature \n â¨\tMissingSignature \n â¨\tMethodNotAllowed \n â¨\tNotAcceptable \n â¨\tUnsupportedMediaType \n â¨\tConsentRevoked \n \n \n \n TR.OHVPS.Business \n \n â¨\tInvalidContent \n â¨\tInvalidAccount \n \n \n \n TR.OHVPS.Connection \n \n â¨\tInvalidCertificate \n â¨\tExceededRate \n â¨\tInvalidTPP \n â¨\tInvalidASPSP \n â¨\tInvalidToken \n â¨\tInvalidTPPRole \n \n \n \n TR.OHVPS.Server \n \n â¨\tInternalError \n â¨\tServiceUnavailable \n \n \n TR.OHVPS.Resource.InvalidFormat hatasÄ± alÄ±ndÄ±ÄÄ± durumda; fieldErrors nesnesi iÃ§erisinde verilecek hata kodlarÄ± : \n \n TR.OHVPS.Field \n \n â¨\tMissing \n â¨\tInvalid \n \n \n Veri Tipi ÃrneÄi: \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "d8bd4e5f-f094-48a6-aee1-3a800e2709d9" , \n     "timestamp" :   "2022-12-22T10:33:15+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "fieldErrors" :   [ \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.islTtr.prBrm" , \n             "messageTr" :   "boÅ deÄer olamaz" , \n             "message" :   "must not be null" , \n             "code" :   "TR.OHVPS.Field.Missing" \n         } , \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.kmlk.kmlkVrs" , \n             "messageTr" :   "boyut \'1\' ile \'30\' arasÄ±nda olmalÄ±" , \n             "message" :   "size must be between 1 and 30" , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } \n     ] , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" \n }  \n \n Tablo 4: HTTP Durum KodlarÄ± \n \n \n \n HTTP Durum \n Ä°stek Sonucu ve AÃ§Ä±klamalar \n POST \n GET \n DELETE \n \n \n \n \n 200 OK \n Ä°stek BaÅarÄ±yla TamamlandÄ±. Kaynak gÃ¼ncellemek iÃ§in yapÄ±lan (Ã¶rneÄin, GET) ve baÅarÄ±yla tamamlanan isteklerinde kullanÄ±lÄ±r. \n H \n E \n H \n \n \n 201 Created \n Ä°stek BaÅarÄ±lÄ± Oldu. Kaynak yaratma isteÄi (Ã¶rneÄin, POST /Ã¶deme-emri-rizasi) baÅarÄ±yla sonuÃ§landÄ±. \n E \n H \n H \n \n \n 204 No Content \n Silme iÅlemi baÅarÄ±yla tamamlandÄ±. Kaynak silme isteÄi (Ã¶rneÄin,  DELETE /hesap-rizasi/{RizaNo} ) baÅarÄ±yla sonuÃ§landÄ±. \n H \n H \n E \n \n \n 400 Bad Request \n Ä°stekte bozuk, eksik veya uyumlu olmayan JSON gÃ¶vdesi, URL parametreleri veya baÅlÄ±k alanlarÄ± var.  Ä°stekle baÅlatÄ±lan iÅlem yapÄ±sal bozukluk, eksik veya tutarsÄ±z veri veya HHS tarafÄ±ndaki kontrollerin hatalÄ± sonuÃ§lanmasÄ± nedeniyle hata ile sonuÃ§lanÄ±r ve hataya iliÅkin veriler hata nesnesi iÃ§erisinde dÃ¶nÃ¼lÃ¼r. \n E \n E \n E \n \n \n 401 Unauthorized \n Yetkilendirme baÅlÄ±ÄÄ± eksik, hatalÄ± veya geÃ§ersiz olduÄundan istek yetkilendirilmediÄinde ve eriÅim reddedildiÄinde http 401 kodu dÃ¶nÃ¼lmelidir. \n E \n E \n E \n \n \n 403 Forbidden \n EriÅim belirtecinin veya rÄ±zanÄ±n kapsamÄ± uyuÅmuyor. YÃS bir hesaba/iÅlem kaynaÄÄ±na eriÅmeye Ã§alÄ±ÅÄ±r ve YÃS, istenen kaynaÄa eriÅmek iÃ§in geÃ§erli izinlere sahip bir rÄ±zasÄ± yoktur.  ÃrneÄin; hesap bilgisi rÄ±zasÄ± bakiye izni almamÄ±ÅtÄ±r ancak /bakiyeler adresinden istekte bulunmuÅtur. \n \n \n \n \n \n 404 Not Found \n **HHS geÃ§erli bir API eriÅim adresini saÄlamÄ±yorsa, o URL\'ye gelen istekler iÃ§in 404 (BulunamadÄ±) ile yanÄ±t vermelidir.**YÃS, uygulama esaslarÄ±nda tanÄ±mlanmayan bir

16kaynak iÃ§in bir URL\'ye eriÅmeye Ã§alÄ±ÅÄ±rsa (Ã¶rneÄin, GET /yurtdisi-odeme), HHS, 404 (BulunamadÄ±) ile yanÄ±t vermeyi seÃ§ebilir. \n E \n E \n E \n \n \n 405 Method Not Allowed \n YÃS, desteklenmeyen bir yÃ¶ntemle kaynaÄa eriÅmeye Ã§alÄ±ÅtÄ±. \n E \n E \n E \n \n \n 406 Not Acceptable \n Ä°stek, geÃ§ersiz bir karakter kÃ¼mesi iÃ§eriyor. \n E \n E \n E \n \n \n 415 Unsupported Media Type \n Ä°stek gÃ¶vdesi hedef kaynakta bu yÃ¶ntem tarafÄ±ndan desteklenmeyen bir biÃ§imde oluÅturulduÄu iÃ§in iÅlem reddedildi \n E \n H \n H \n \n \n 429 Too Many Requests \n Belirli bir sÃ¼re iÃ§inde Ã§ok fazla talepte bulunulduÄu iÃ§in iÅlem reddedildi.  HHSâler adil kullanÄ±m politikalarÄ±nÄ± aÅan talepleri kÄ±sÄ±tlayabilir. \n E \n E \n E \n \n \n 500 Internal Server Error \n API sunucu / servis katmanÄ±nda sorun oluÅtu. Ä°Ålem baÅarÄ±sÄ±z.  5XX hata durumlarÄ±nda yanÄ±t gÃ¶vde deÄeri olmadÄ±ÄÄ± iÃ§in mesaj imzalama yapÄ±lamaz ve x-jws-signature alanÄ± boÅ olarak iletilir.  Bu durumda x-jws-signature kontrolÃ¼ yapÄ±lmamalÄ±dÄ±r. \n E \n E \n E \n \n \n 503 Service Unavailable \n Hizmet sÃ¼rÃ¼mÃ¼ kullanÄ±mdan kaldÄ±rÄ±ldÄ±.  Bir API\'nin kullanÄ±mdan kaldÄ±rÄ±ldÄ±ÄÄ± ve artÄ±k bir HHS tarafÄ±ndan operasyonel olarak desteklenmediÄi durumlarda, URI yolu hala etkin olabilir ve API isteklerini kabul edebilir.  Bu durumda, YÃS\'Ã¼n API sÃ¼rÃ¼mÃ¼nÃ¼n Ã§evrimdÄ±ÅÄ± olduÄunun farkÄ±nda olmasÄ± iÃ§in 503 Hizmet KullanÄ±lamÄ±yor dÃ¶nmesi Ã¶nerilir. \n E \n E \n E \n \n \n \n Hata Ãrnekleri: \n 400 Bad Request \n TR.OHVPS.Business.InvalidContent  hatasÄ± HHS tarafÄ±ndan yapÄ±lacak iÅ kuralÄ± kontrollerinin baÅarÄ±sÄ±z olduÄu durumda verilmelidir. \n TR.OHVPS.Resource.InvalidFormat  hatasÄ± Åema validasyonu, alan uzunluk ve varlÄ±k kontrollerinin baÅarÄ±sÄ±z olduÄu durumda verilmelidir. \n \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "7f115b9c-d7c2-4a2a-bc45-5a9891c79072" , \n     "timestamp" :   "2022-12-22T10:47:57+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "fieldErrors" :   [ \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.alc.unv" , \n             "messageTr" :   "boyut \'3\' ile \'140\' arasÄ±nda olmalÄ±" , \n             "message" :   "size must be between 3 and 140" , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } , \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.islTtr.ttr" , \n             "messageTr" :   "boÅ deÄer olamaz" , \n             "message" :   "must not be null" , \n             "code" :   "TR.OHVPS.Field.Missing" \n         } \n     ] , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" \n }  \n\n \n Zorunlu header alanlarÄ±ndan biri ya da birkaÃ§Ä± eksik olarak gÃ¶nderilirse aÅaÄÄ±daki gibi bir hata dÃ¶nÃ¼ÅÃ¼ gerÃ§ekleÅebilir. \n HHS uygulamasÄ± tarafÄ±ndan dÃ¶nÃ¼lebilecek hata Ã¶rnekleri: \n \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "2005515d-f0e6-4a07-a439-0ef3b0f56011" , \n     "timestamp" :   "2022-12-22T10:39:26+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" , \n     "fieldErrors" :   [ \n         {          \n             "field" :   "X-Request-ID" , \n             "messageTr" :   "X-Request-ID deÄeri boÅ olamaz." , \n             "message" :   "X-Request-ID cannot be null." , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } \n     ] \n }  \n\n \n Business hata Ã¶rneÄi - 1: \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "677cfd9d-77c1-4ea3-8bdf-74a6e9887177" , \n     "timestamp" :   "2022-12-22T11:05:59+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "gonUnvan wrong" , \n     "moreInformationTr" :   "GÃ¶nderen Ãnvan hatalÄ±" , \n     "errorCode" :   "TR.OHVPS.Business.InvalidContent" \n }  \n \n Business hata Ã¶rneÄi - 2: \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "5df3b402-3aca-4305-a35b-5af0f3184b40" , \n     "timestamp" :   "2022-12-22T11:06:47+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Sender account is disabled or not found." , \n     "moreInformationTr" :   "Gonderen hesap aktif deÄil veya bulunamadÄ±." , \n     "errorCode" :   "TR.OHVPS.Business.InvalidAccount" \n }  \n \n GEÃÄ°T\'te yapÄ±lan zorunlu header kontrollerinde aÅaÄÄ±daki hatalar dÃ¶nebilir: \n \n { \n     "timestamp" :   "2022-12-22T10:40:28+03:00" , \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "d4375748-6fc7-4f7e-94f3-6411cab1d59f" , \n     "moreInformationTr" :   "GeÃ§ersiz HHS kodu." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidASPSP" , \n     "moreInformation" :   "Invalid ASPSP Code" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" \n }  \n \n GEÃÄ°T tarafÄ±ndan dÃ¶nÃ¼lecek hata Ã¶rneÄi: \n \n { \n     "timestamp" :   "2022-12-22T10:40:28+03:00" , \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "d4375748-6fc7-4f7e-94f3-6411cab1d59f" , \n     "moreInformationTr" :   "GeÃ§ersiz HHS kodu." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidTPP" , \n     "moreInformation" :   "Invalid TPP Code" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" \n }  \n \n GEÃÄ°T tarafÄ±ndan dÃ¶nÃ¼lecek hata Ã¶rneÄi: \n \n { \n     "timestamp" :   "2022-12-22T11:14:05+03:00" , \n     "path" :   "/ohvps/hbh/s1.1/hesap-bilgisi-rizasi" , \n     "id" :   "ee1e3ea7-a5e5-468b-bb02-314148f84e6a" , \n     "moreInformationTr" :   "GeÃ§ersiz yÃ¶s rolÃ¼. Ä°lgili api Ã§aÄrÄ±sÄ± iÃ§in yetkisi yok." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidTPPRole" , \n     "moreInformation" :   "Invalid TPP Role" , \n     "httpCode" :   403 , \n     "httpMessage" :   "Forbidden" \n }  \n\n \n 401 Unauthorized \n YÃS, sÃ¼resi dolmuÅ bir eriÅim belirteci kullandÄ±ÄÄ±nda, HHS 401 (Yetkisiz) http kodu ile aÅaÄÄ±daki hata kodunu dÃ¶nmelidir.  AÅaÄÄ±daki nedenlerden herhangi biri nedeniyle bir EriÅim Belirtecinin sÃ¼resi dolduÄunda bu durum ortaya Ã§Ä±kabilir: \n \n RÄ±zanÄ±n sÃ¼resi doldu (Son Kullanma Tarihi geÃ§ti) \n EriÅim Belirtecinin ÅÃ¼pheli kullanÄ±mÄ± veya sahtekarlÄ±k ÅÃ¼phesi \n RÄ±zada belirlenen gÃ¼n s

16ayÄ±sÄ±nÄ±n aÅÄ±mÄ±\nBu hata, mÃ¼Återiden doÄru izinlerle yeniden kimlik doÄrulamasÄ± isteyerek Ã§Ã¶zÃ¼lebilir. \n \n \n { \n     "path" :   "/ohvps/gkd/s1.1/erisim-belirteci" , \n     "id" :   "ed3fd667-fc58-40ad-a982-e8937faccd15" , \n     "timestamp" :   "2022-12-22T11:17:33+03:00" , \n     "httpCode" :   401 , \n     "httpMessage" :   "Unauthorized" , \n     "moreInformation" :   "Refresh token expired or not found in database" , \n     "moreInformationTr" :   "Yenileme belirteci zaman aÅÄ±mÄ±na uÄramÄ±Å veya veri tabanÄ±nda yok" , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidToken" \n }  \n \n\n \n 403 Forbidden \n Ãrn; YÃS yetkisi olmayan rol(ÃBH/HBH) ile iÅlem yapmaya Ã§alÄ±ÅtÄ±ÄÄ± durumda 403 hatasÄ± alarak iÅleme devam edemez. \n { \n   "path" :   "/ohvps/hbh/s1.1/bakiye" , \n   "id" :   "3e48ea98-f889-48b9-aa6e-28aabc6cfb14" , \n   "timestamp" :   "2022-12-22T11:20:05+03:00" , \n   "httpCode" :   403 , \n   "httpMessage" :   "Forbidden" , \n   "moreInformation" :   "Forbidden" , \n   "moreInformationTr" :   "Bakiye Bilgileri iÃ§in ÃHK izni bulunmamaktadÄ±r." , \n   "errorCode" :   "TR.OHVPS.Resource.Forbidden" \n }  \n \n 404 Not Found \n Ãrn; GET /odeme-emri-rizasi/123456 Ã§aÄrÄ±sÄ± durumunda 123456 geÃ§erli bir Ã¶deme kaynaÄÄ± deÄilse, HHS, 404 koduyla cevap vermelidir. \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi/123456" , \n     "id" :   "22f52b2d-d442-4a6a-8f39-d23eba45a34b" , \n     "timestamp" :   "2022-12-22T10:53:53+03:00" , \n     "httpCode" :   404 , \n     "httpMessage" :   "Not Found" , \n     "moreInformation" :   "Resource not found" , \n     "errorCode" :   "TR.OHVPS.Resource.NotFound" , \n     "moreInformationTr" :   "Kaynak bulunamadÄ±" \n }  \n\n \n 405 Method Not Allowed \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "3e5c6b28-7ee4-4469-b541-843fb4a94eec" , \n     "timestamp" :   "2022-12-22T11:35:10+03:00" , \n     "httpCode" :   405 , \n     "httpMessage" :   "Method Not Allowed" , \n     "moreInformation" :   "Method not allowed" , \n     "errorCode" :   "TR.OHVPS.Resource.MethodNotAllowed" , \n     "moreInformationTr" :   "Ä°stek yapÄ±lan URL iÃ§in izin verilmeyen metot" \n }  \n \n 406 Not Acceptable \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "3e5c6b28-7ee4-4469-b541-843fb4a94eec" , \n     "timestamp" :   "2022-12-22T11:35:10+03:00" , \n     "httpCode" :   406 , \n     "httpMessage" :   "Not Acceptable" , \n     "moreInformation" :   "Not Acceptable" , \n     "errorCode" :   "TR.OHVPS.Resource.NotAcceptable" , \n     "moreInformationTr" :   "Kabul edilmedi" \n }  \n \n 415 Unsupported Media Type \n Ä°stek baÅlÄ±ÄÄ±nda content-type, JSON dÄ±ÅÄ±nda bir veri iletilirse bu hata verilebilir. \n \n { \n     "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n     "id" :   "63cc94b6-1b51-4648-9671-95e6e2e7e03d" , \n     "timestamp" :   "2022-12-22T11:37:12+03:00" , \n     "httpCode" :   415 , \n     "httpMessage" :   "Unsupported Media Type" , \n     "moreInformation" :   "Content type not supported" , \n     "errorCode" :   "TR.OHVPS.Resource.UnsupportedMediaType" , \n     "moreInformationTr" :   "Desteklenmeyen iÃ§erik tipiâ" \n }  \n \n 429 Too Many Requests \n { \n   "path" :   "/ohvps/hbh/s1.1/hesaplar/aef6061f-2978-4bb4-980d-b4c634c8055b/islemler" , \n   "id" :   "20473c5f-2f4f-4b2e-8b66-7978aec442f7" , \n   "timestamp" :   "2022-12-22T00:21:07+03:00" , \n   "httpCode" :   429 , \n   "httpMessage" :   "Too Many Requests" , \n   "moreInformation" :   "Exceeded rate" , \n   "moreInformationTr" :   "EriÅim sÄ±klÄ±ÄÄ± limiti aÅÄ±mÄ±" , \n   "errorCode" :   "TR.OHVPS.Connection.ExceededRate" \n }  \n \n 500 Internal Server Error \n { \n   "id" :   "1b90c6dc-0277-4755-8b05-9297ddfab743" , \n   "path" :   "/ohvps/obh/s1.1/odeme-emri-rizasi" , \n   "timestamp" :   "2022-12-22T11:41:34+03:00" , \n   "httpCode" :   500 , \n   "httpMessage" :   "Internal Server Error" , \n   "moreInformation" :   "Unexpected condition was encountered." , \n   "moreInformationTr" :   "Beklenmeyen bir durumla karÅÄ±laÅÄ±ldÄ±." , \n   "errorCode" :   "TR.OHVPS.Server.InternalError" \n }  \n\n \n 503 Service Unavailable \n \n   "timestamp" :   "2022-12-20T23:18:56+03:00" , \n   "path" :   "/ohvps/hbh/s1.1/hesap-bilgisi-rizasi/2a72678ee3d24de2be47887e4903a8c6" , \n   "id" :   "e76315b7-09f4-4295-b6d8-1f7fec632159" , \n   "moreInformationTr" :   "HHS Åu anda hizmet veremiyor." , \n   "errorCode" :   "TR.OHVPS.Server.ServiceUnavailable" , \n   "moreInformation" :   "HHS is currently unavailable" , \n   "httpCode" :   503 , \n   "httpMessage" :   "Service Unavailable" \n 3.19. Maskeleme KurallarÄ± \n Maskeli olarak iletilmesi gereken verilerin maskeleme kurallarÄ± Åu Åekildedir: \n \n IBAN verileri Hesap NumarasÄ± : Ä°lk 4 ve son 4 karakteri aÃ§Ä±k, diÄer karakterler maskeli olmalÄ±dÄ±r. Ãrnek: TR54******************4812 \n Ad-SoyadÄ± / Ticari Unvan : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet â â karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r.\nÃrneÄin: âFATÄ°H SERKAN ERENâ ifadesi âFA *** SE**** ER****â Åeklinde gÃ¶sterilmelidir. \n Tabela UnvanÄ± : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet \' \' karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r. ÃrneÄin âBANKALARARASI KART MERKEZÄ° ANONÄ°M ÅÄ°RKETÄ°â ifadesi âBA *** KA**

16** ME**** AN**** ÅÄ°****â Åeklinde gÃ¶sterilmelidir. \n YÃSâten girilen alÄ±cÄ± unvan ve IBAN bilgileri Ã¶deme emri rÄ±zasÄ± ve Ã¶deme emri yanÄ±tÄ±nda aÃ§Ä±k dÃ¶nÃ¼lÃ¼r, Kolas akÄ±ÅÄ±nda Ã¶deme emri rÄ±zasÄ± yanÄ±tÄ± ve Ã¶deme emri istek ve yanÄ±tÄ±nda maskeli taÅÄ±nÄ±r. \n 3.20. Fonksiyonel Olmayan Gereksinimler \n \n \n HHSâlerin sunuyor olduklarÄ± servisleri en fazla 3000 ms iÃ§inde yanÄ±t dÃ¶necek Åekilde tasarlamalÄ±dÄ±r. \n \n \n HHS\'ler mevcut online iÅlem kanallarÄ±ndan sunduklarÄ± eriÅilebilirlik ve performans kriterlerinden daha dÃ¼ÅÃ¼k bir hizmet kalitesi sunmamalÄ±dÄ±r. \n \n \n HHSâlerin sunuyor olduklarÄ± servislere sistemin gÃ¼venlik ve sÃ¼rekliliÄini saÄlamak adÄ±na rate limit koyma ihtiyaÃ§larÄ± olur ise, standartlar ve ihtiyaÃ§lara uygun Åekilde bir konfigÃ¼rasyon yapabilirler.  \n \n \n HHS rate limit tanÄ±mÄ± uyguluyor ise; YÃS\'ler arasÄ±nda ayrÄ±m yapmadan, adil ve makul sÄ±nÄ±rlar dahilinde uygulamalÄ±dÄ±r.    \n \n \n YÃS tarafÄ±ndan kullanÄ±cÄ±nÄ±n baÅlatmadÄ±ÄÄ± otomatik sorgu limitleri  3.21 Otomatik Sorgular  bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. HHS\'lerin bu servisler iÃ§in minimumda cevap vermesi gereken sorgu sayÄ±larÄ± belirlenmiÅtir. Bu sayÄ±larÄ±n Ã¼zerinde yapÄ±lan servis Ã§aÄrÄ±sÄ±na yanÄ±t dÃ¶nmek HHS inisiyatifindedir. DiÄer taraftan kullanÄ±cÄ±nÄ±n baÅlattÄ±ÄÄ± istekler iÃ§in uygulanacak limitler, HHS\'nin online iÅlem kanallarÄ±ndan sunulan sorgu limitlerinden daha az olmamalÄ±dÄ±r. \n \n \n HHS\'ler, Ã§aÄrÄ±m limitlerini aÅan istekler iÃ§in HTTP 429 - Too Many Request hatasÄ±nÄ± dÃ¶nmelidir. Ãrnek hata mesajÄ±  3.18 HTTP Durum KodlarÄ±  bÃ¶lÃ¼mÃ¼nde bulunmaktadÄ±r. Rate Limit Ã¶zelinde tanÄ±mlanmÄ±Å parametreler olan X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset alanlarÄ± da   3.16 YanÄ±t BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanmÄ±ÅtÄ±r. YÃS\'ler de HHS\'nin belirlediÄi rate limit kurallarÄ±na uymakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n 3.21. Otomatik Sorgular \n YÃS uygulamasÄ±, ÃHK\'nÄ±n baÅlattÄ±ÄÄ± iÅlemler neticesinde API Ã§aÄrÄ±mÄ± yapabileceÄi gibi, sistemsel bir Åekilde otomatik API Ã§aÄrÄ±mÄ± da yapabilir. \nHHS, API Ã§aÄrÄ±mÄ±nÄ±n ÃHK\'lÄ± ya da ÃHK\'sÄ±z olduÄunu istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n ÃHK YÃS uygulamasÄ±na giriÅ yaptÄ±ÄÄ± andan Ã§Ä±kÄ±Å yaptÄ±ÄÄ± ana kadar yani ÃHK oturumu boyunca yapÄ±lan API Ã§aÄrÄ±mlarÄ±nda, PSU-Initiated  deÄerinin "E" olmasÄ± gerekmektedir.  YÃS uygulamasÄ±nda ÃHK oturumu boyunca,  ÃHK\'nÄ±n bilgilerinden minimumda "bakiye" bilgisinin, uygulama arayÃ¼zlerinde gÃ¼ncel deÄeri ile online sorgularla gÃ¶sterimi YÃS\'Ã¼n insiyatifindedir. \n ÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \n YÃS, aÅaÄÄ±daki API\'leri sistemsel bir Åekilde Ã§aÄÄ±rabilir. \nHHS\'lerin bu servisler iÃ§in minimumda cevap vermesi gereken sorgu sayÄ±larÄ± belirlenmiÅtir. Bu sayÄ±larÄ±n Ã¼zerinde yapÄ±lan servis Ã§aÄrÄ±sÄ±na yanÄ±t dÃ¶nmek HHS inisiyatifindedir. \nHHS tarafÄ±ndan izin verilen sorgu sayÄ±sÄ±nÄ±n Ã¼zerinde yapÄ±lan bir sorgu iÃ§in HTTP 429 durum kodu (Too Many Requests) hatasÄ± dÃ¶nÃ¼lmelidir. YanÄ±t gÃ¶vdesinde tekrar hata nesnesinin oluÅturulmasÄ± HHS inisiyatifindedir.  HHS yanÄ±t headerÄ± alanÄ±nda iletilecek X-RateLimit-Reset (saniye cinsinden) deÄeri kadar sÃ¼re sonunda\nYÃS\'Ã¼n tekrar sorgulama yapmasÄ± beklenmektedir. \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Otomatik Sorgu SayÄ±sÄ± \n \n \n \n \n 1 \n erisim-belirteci \n POST \n /erisim-belirteci \n --- \n \n \n 2 \n odeme-emri-rizasi \n GET \n /odeme-emri-rizasi/{rizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 3 \n odeme-emri \n GET \n /odeme-emri/{odemeEmriNo} \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 4 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 5 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n --- \n \n \n 6 \n hesaplar \n GET \n /hesaplar \n Bireysel gÃ¼nde 4  Kurumsal gÃ¼nde 4 \n \n \n 7 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Bireysel gÃ¼nde 4 Kurumsal gÃ¼nde 4 \n \n \n 8 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 9 \n bakiye \n GET \n /bakiye \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 10 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Bireysel gÃ¼nde 4 Kurumsal ÃHK - saatte 12 \n \n \n \n YÃS ve HHS son 24 saat iÃ§erisindeki sorgu sayÄ±larÄ±nÄ± toplayarak elde ettiÄi sonuÃ§larla limit kontrolÃ¼ yapmalÄ±dÄ±r (Pencere yÃ¶ntemi). \n Ä°Ålemler servisinin Ã§aÄrÄ±m detaylarÄ±na  ^BÃ¶lÃ¼m 7.8  Ã¼zerinden ulaÅÄ±labilir. \n Hesap bilgisi rÄ±zasÄ±nÄ±n YÃS tarafÄ±ndan otomatik bir Åekilde iptal edilmesi durumu  ^BÃ¶lÃ¼m 9\'da  aÃ§Ä±klanmÄ±ÅtÄ±r. \n'},{frontmatter:{},regularPath:"/v1.1.0/deneyalani/hesap-bilgisi-api.html",relativePath:"v1.1.0/deneyalani/hesap-bilgisi-api.md",key:"v-3637769d",path:"/v1.1.0/deneyalani/hesap-bilgisi-api.html",content:" \n   \

16n "},{frontmatter:{},regularPath:"/v1.1.0/deneyalani/hhs-yos-api.html",relativePath:"v1.1.0/deneyalani/hhs-yos-api.md",key:"v-3ee390dd",path:"/v1.1.0/deneyalani/hhs-yos-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v1.1.0/deneyalani/olay-bildirim-api.html",relativePath:"v1.1.0/deneyalani/olay-bildirim-api.md",key:"v-642a7506",path:"/v1.1.0/deneyalani/olay-bildirim-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v1.1.0/deneyalani/test.html",relativePath:"v1.1.0/deneyalani/test.md",key:"v-68ac6685",path:"/v1.1.0/deneyalani/test.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v1.1.0/deneyalani/odeme-emri-api.html",relativePath:"v1.1.0/deneyalani/odeme-emri-api.md",key:"v-6480bcc7",path:"/v1.1.0/deneyalani/odeme-emri-api.html",content:" \n   \n "},{title:"8.\tDÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v2.0.0/contents/duzenli-odeme-emri-hizmeti.html",relativePath:"v2.0.0/contents/duzenli-odeme-emri-hizmeti.md",key:"v-f0a9c5f2",path:"/v2.0.0/contents/duzenli-odeme-emri-hizmeti.html",headers:[{level:2,title:"DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"duzenli-odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"8.1.\tADIM 0 - DÃ¼zenli Ãdeme Emri RÄ±zasÄ± BaÅlatma IsteÄi",slug:"_8-1-adim-0-duzenli-odeme-emri-rÄ±zasÄ±-baslatma-istegi"},{level:2,title:"8.2.\tADIM 1 - DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_8-2-adim-1-duzenli-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"8.3.\tADIM 2- DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_8-3-adim-2-duzenli-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"8.4.\tADIM 2.1 â DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_8-4-adim-2-1-duzenli-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"8.5.\tADIM 3- Duzenli Ãdeme Emrinin OluÅturulmasÄ±",slug:"_8-5-adim-3-duzenli-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"8.6.\tADIM 3.1- Duzenli Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_8-6-adim-3-1-duzenli-odeme-emri-sorgusu-istege-baglÄ±"},{level:2,title:"8.7.\tADIM 4- DÃ¼zenli Ãdeme PlanÄ± Sorgulama",slug:"_8-7-adim-4-duzenli-odeme-planÄ±-sorgulama"},{level:2,title:"8.8.\tADIM 5- DÃ¼zenli Ãdeme Emri RÄ±za Ä°ptali",slug:"_8-8-adim-5-duzenli-odeme-emri-rÄ±za-iptali"}],content:" 8.\tDÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti \n Ãdeme hizmeti kullanÄ±cÄ±sÄ±nÄ±n dÃ¼zenli tekrar eden bir Ã¶deme talimatÄ± gerÃ§ekleÅtirmek istediÄi Ã¶deme emirlerinde bu hizmeti kullanabilir. Ãdemenin Havale / PÃS / FAST Ã¶deme sistemlerinden hangisi ile gerÃ§ekleÅeceÄine, Ã¶deme gÃ¼nÃ¼ geldiÄinde HHS karar verir. \n DÃ¼zenli Ã¶deme hizmetini online bankacÄ±lÄ±k sistemlerinde sunan HHS'lerin, ÃHVPS Ã¼zerinden bu hizmetleri sunmasÄ± zorunludur. Mevcutta online kanallarÄ±ndan bu hizmeti sunduklarÄ± mÃ¼Återi segmentine (bireysel,kurumsal vb.), ÃHVPS Ã¼zerinden hizmet sunmaya devam etmeleri gerekmektedir. YÃS, bireysel mÃ¼Återi Ã¶zelinde dÃ¼zenli Ã¶deme hizmeti vermeyen HHS'ye dÃ¼zenli Ã¶deme talimatÄ± rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.IndividualCustomerNotSupported  hatasÄ± , kurumsal mÃ¼Återi Ã¶zelinde dÃ¼zenli Ã¶deme talimatÄ± rÄ±zasÄ± isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  TR.OHVPS.Business.CorporateCustomerNotSupported  hatasÄ± verilmelidir. \n HHS'ler dÃ¼zenli Ã¶deme hizmetini sunuÅ bilgilerini HHS API aracÄ±lÄ±ÄÄ± ile yayÄ±nlayacaklardÄ±r. YÃS, dÃ¼zenli Ã¶deme hizmeti baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\":\"03\" parametresi ile alabilir. YÃS, dÃ¼zenli Ã¶deme hizmeti sunmayan HHS'ye dÃ¼zenli Ã¶deme talimat rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.RegularPaymentOrderNotSupported  hatasÄ± iletilmelidir. \n DÃ¼zenli Ã¶deme emri hizmetinde TRY dÄ±ÅÄ±ndaki yabancÄ± para birimleri iÃ§in HHS tarafÄ±ndan destek verilmemesi durumunda  TR.OHVPS.Business.InvalidCurrencyCode  hataasÄ± verilmelidir. \n DÃ¼zenli Ã¶deme talimatÄ± gÃ¼ncelleme hizmeti YÃS Ã¼zerinden yapÄ±lamayacaktÄ±r. ÃHK aktif olan dÃ¼zenli Ã¶deme talimat rÄ±zasÄ±nÄ± iptal ederek, yeniden oluÅturabilecektir. \n HHS Ã¼zerinden ilgili gÃ¼ncelleme hizmeti saÄlanabilir. Ãdeme planÄ±nda yapÄ±lan gÃ¼ncelleme sonucunda olay bildirim ile YÃS'e bildirim saÄlanacaktÄ±r. HHS Ã¼zerinden gÃ¼ncelleme yapÄ±lÄ±rken son Ã¶deme gÃ¼nÃ¼ iÃ§in ileri bir tarihe gÃ¼ncelleme adÄ±mÄ± olmamalÄ±dÄ±r. Sadece ilk oluÅturulan dÃ¼zenli Ã¶deme emri iÃ§erisindeki son Ã¶deme gÃ¼nÃ¼nden Ã¶ncesi olacak Åekilde gÃ¼ncelleme yapÄ±lmasÄ±na izin verilmelidir. \n DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n DÃ¼zenli Ãdeme Emri RÄ±zasÄ± BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± baÅlatÄ±r. \n DÃ¼zenli Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âDÃ¼zenli Ãdeme Emri RÄ±zasÄ± BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve dÃ¼zenli Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n DÃ¼zenli Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âdÃ¼zenli Ã¶deme emriâni HHSâye iletir. \n DÃ¼zenli Ãdeme Emri RÄ±za Durumu, DÃ¼zenli Ãdeme Emri Durumu, DÃ¼zenli Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, DÃ¼zenli Ãdeme Emri RÄ±za Durumu, DÃ¼zenli Ãdeme Emri Durumu, DÃ¼zenli Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n DÃ¼zenli Ãdeme PlanÄ± SorgularÄ±:  ÃBHS, DÃ¼zenli Ãdeme Emri iÃ§in oluÅturulan talimata dair Ã¶deme planÄ±nÄ± sorgulayabilir. \n \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±)  mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin hem HBH hem de ÃBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini(Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n YÃS'ler gÃ¶nderen hesap seÃ§imini aÅaÄÄ±daki yÃ¶ntemlerden biri ya da birkaÃ§Ä± ile saÄlayabilirler: \n \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± HHS ekranÄ±ndan seÃ§tirebilir. \n YÃS, mÃ¼Återisinden Hesap Bilgisi rÄ±zasÄ± alÄ±r. RÄ±za aldÄ±ÄÄ± hesaplar Ã¼zerinden hesap referansÄ± aracÄ±lÄ±ÄÄ± ile dÃ¼zenli Ã¶deme emri baÅlatabilir. \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± elle girmesine olanak tanÄ±yabilir. IBAN'Ä± olmayan HHS'ler dÃ¼zenli Ã¶deme emri rÄ±zasÄ± adÄ±mÄ±nda  TR.OHVPS.Business.IBANNotSupported  hatasÄ±nÄ± vermelidir. IBAN'Ä± olan HHS'lerin bu akÄ±ÅÄ± desteklemesi zorunludur. \n YÃS; mÃ¼Återisinin hesap referansÄ±nÄ± elle girmesini saÄlayabilir. Hesap ReferansÄ± bilgisi ile baÅlatÄ±lan dÃ¼zenli Ã¶deme emri iÅlemlerinde HHS seÃ§imi zorunludur. \n \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in, YÃS'ler hesap referansÄ± ile Ã¶deme baÅlatabilirler. Bu

16nlarÄ±n dÄ±ÅÄ±ndaki HHS'lerin, gÃ¶nderen IBAN veya hesap referansÄ± ile Ã¶deme akÄ±ÅÄ±nÄ± desteklemesi zorunludur. \n DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. Ãdeme Emri Hizmeti ile aynÄ± etki alanÄ±(scope) kullanÄ±lmaktadÄ±r. \n Tablo : DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n duzenli-odeme-emri-rizasi \n POST \n /duzenli-odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n DuzenliOdemeEmriRizasiIstegi \n DuzenliOdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 3 \n duzenli-odeme-emri-rizasi \n GET \n /duzenli-odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n DuzenliOdemeEmriRizasi \n \n \n 4 \n duzenli-odeme-emri \n POST \n /duzenli-odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n DuzenliOdemeEmriIstegi \n DuzenliOdemeEmri \n \n \n 5 \n duzenli-odeme-emri \n GET \n /duzenli-odeme-emri/{talimatNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n DuzenliOdemeEmri \n \n \n 6 \n duzenli-odeme-emri-rizasi-iptal \n DELETE \n /duzenli-odeme-emri-rizasi/{rizaNo}

16 \n Z \n Ä°stemci Kimlik Bilgileri \n - \n - \n - \n \n \n 7 \n duzenli-odeme-talimat-plani \n GET \n /duzenli-odeme-emri/{talimatNo}/odeme-plani \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n DuzenliOdemeEmriPlani \n 8.1.\tADIM 0 - DÃ¼zenli Ãdeme Emri RÄ±zasÄ± BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) dÃ¼zenli Ã¶deme emri rÄ±zasÄ± sÃ¼recini baÅlatÄ±r. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 8.2.\tADIM 1 - DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil : DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (DuzenliOdemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ olduÄu geÃ§it tarafÄ±ndan kontrol edilir. \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahipliÄi geÃ§it tarafÄ±ndan kontrol edilir. \n HHS tarafÄ±ndan, istek baÅlÄ±ÄÄ±ndaki x-aspsp-code ile katilimciBlg iÃ§erisinde yer alan hhsKod deÄeri ile aynÄ± olduÄunu kontrol edilir. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, dÃ¼zenli Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren DuzenliOdemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1 HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /duzenli-odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir DuzenliOdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, dÃ¼zenli Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n YÃS, dÃ¼zenli Ã¶deme hizmeti sunmayan (HHS API'de yer alan \"hizmetTipi\":\"03\" yok ise) HHS'ye dÃ¼zenli Ã¶deme talimat rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.RegularPaymentOrderNotSupported  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hata kodu iletilmeli ve fieldErrors dolu olacak Åekilde hatalÄ± alanÄ± belirten detaylÄ± aÃ§Ä±klama gÃ¶nderilmelidir. InvalidFormat hata kodlarÄ±nda fieldErrors iÃ§eriÄi gÃ¶nderilmeli ve anlaÅÄ±lÄ±r aÃ§Ä±klama ile message, messageTr alanlarÄ± doldurulmasÄ± zorunludur. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS, bireysel mÃ¼Återi Ã¶zelinde dÃ¼zenli Ã¶deme hizmeti vermeyen HHS'ye dÃ¼zenli Ã¶deme talimatÄ± rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.IndividualCustomerNotSupported\"  hatasÄ± , kurumsal mÃ¼Återi Ã¶zelinde dÃ¼zenli Ã¶deme talimatÄ± rÄ±zasÄ± isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CorporateCustomerNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme adresleri ile dÃ¼zenli Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini y

16apar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.TPPRedirectionAddressMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; kimlik bilgileri nesnesinde yer alan kimlik bilgileri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (KoÅullu Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.CustomerNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n âAÃ§Ä±k BankacÄ±lÄ±k Kanal Yetkiâ tanÄ±mÄ± yok ise  \"TR.OHVPS.Business.OpenBankingChannelClosed\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir. \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.DecoupledAuthenticationNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  \"TR.OHVPS.Business.EventSubscriptionNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin, ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerInfoMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerMobileApplicationNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n HHS kimlik bilgisi ile gÃ¶nderen Ã¼nvanÄ±nÄ±n uyumlu olduÄunu kontrol eder. HHS'ler EFT/FAST iÅlemlerinde kabul ettikleri kontrol kriterleri ile iÅleme izin verebilirler. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.IncorrectSenderTitle\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n GÃ¶nderen Hesap NumarasÄ± ÃBHS tarafÄ±ndan iletildiÄi durumda;\n \n IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.InvalidAccount\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountCodeMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu kontrol edilir.Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.CustomerAccountMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. (Ä°lgili hesabÄ±n para transfer iÅlemine yetkisi olmamasÄ±) Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountUnauthorized\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâde gÃ¶nderen hesabÄ±n aktifliÄi kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountInactive\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n GÃ¶nderen hesap numarasÄ± iÃ§in, Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile dÃ¼zenli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  \"TR.OHVPS.Business.ActiveConsentNotFound\"  hatasÄ± verilmelidir. \n DÃ¼zenli Ã¶deme emri rÄ±zasÄ±nda alÄ±cÄ± hesap bilgileri Karekod ya da Kolas ile belirlenebilir. HHS online kanallarÄ±nda dÃ¼zenli Ã¶deme hizmetini Karekod ve Kolas aracÄ±lÄ±ÄÄ± ile kabul ediyorsa, ÃHVPS servisleri ile de kabul etmek zorundadÄ±r. YÃS tarafÄ±ndan dÃ¼zenli Ã¶deme emri rÄ±zasÄ± isteÄi iÃ§erisinde alÄ±cÄ± bilgisi iÃ§in karekod ya da kolas kompleks alanlarÄ± yer almasÄ± durumunda , destek vermeyen HHS'ler tarafÄ±ndan  \"TR.OHVPS.Business.RecipientAccountTypeNotSupported\"  hatasÄ± verilmelidir. \n AlÄ±cÄ± ve gÃ¶nderen hesabÄ±n aynÄ± olmasÄ± durumunda  âTR.OHVPS.Business.SenderRecipientSameâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n MÃ¼Återinin kendi hesaplarÄ± arasÄ±nda talimat veremeyeceÄi durumlarÄ±n kontrolÃ¼ iÃ§in  âTR.OHVPS.Business.SameAccountTransferRestrictedâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, DuzenliOdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n Bu aÅamada ÃHKânÄ±n HHS tarafÄ±ndan tanÄ±mlanmÄ±Å ve isteÄin veri alanÄ±nda gÃ¶nderen hesaba (borÃ§landÄ±rÄ±lacak hesaba) iliÅkin bir bilgisinin olmasÄ± gerekmez. \nHesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK dÃ¼zenli Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n POST /duzenli-odeme-emri-rizasi  isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âDuzenliOdemeEmriRizasiIstegiâ nesnesi (Tablo) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âDuzenliOdemeEmriRizasiâ (Tablo) nesnesi oluÅturulur. \n  BAÅARILI Ä°STEK: \n Tablo : âDuzenliOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan dÃ¼zenli Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.ohkTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n >

16 GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda dÃ¼zenli Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile dÃ¼zenli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, HspRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n Ã¼nvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n TalimatÄ±n gerÃ§ekleÅeceÄi ana kadar KOLAS tanÄ±mÄ±nÄ±nda deÄiÅiklik olabileceÄi iÃ§in,  KOLAS ile yapÄ±lan dÃ¼zenli Ã¶deme emri iÅlemleri, talimatÄ±n verildiÄi anda Ã§Ã¶zÃ¼len IBAN'a yapÄ±lacaktÄ±r. \n Kolas ile dÃ¼zenli Ã¶deme emri hizmeti desteklenmiyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir. \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n Karekod ile yapÄ±lan dÃ¼zenli iÅlemler, talimatÄ±n verildiÄi anda Ã§Ã¶zÃ¼len IBAN'a yapÄ±lacaktÄ±r. \n Karekod ile dÃ¼zenli Ã¶deme emri hizmeti desteklenmiyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir. \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n HHS, YÃS'Ã¼n API deseninde \"O\" kodunu ilettiÄini kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarÄ±nda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.   -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tÄ°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n YÃS bu deÄeri ÃHKâyÄ± HHSâye yÃ¶nlendirmeden Ã¶nceki ekranda gÃ¶stermeli, ve HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak yine ÃHKâya gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âDuzenliOdemeEmriRizasiâ nesnesi Tabloâda parametrelerden oluÅur: \n Tablo : âDuzenliOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n DuzenliOdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n DuzenliOdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n DuzenliOdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n >

16 GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.   Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen Ã¼nvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.    Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n 8.3.\tADIM 2- DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil : DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n dÃ¼zenli Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=D&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=D&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=D&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK, bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS, dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 8.4.\tADIM 2.1 â DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âDuzenliOdemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda dÃ¼zenli Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgilerinin zorunlu olmasÄ± nedeniyle,  DuzenliOdemeEmriRizasi  nesnesi sorgulanarak bu bilgiler alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  DuzenliOdemeEmriRizasi  nesnesine iÅler. \n \n Sorgulama yapÄ±lan DÃ¼zenli Ãdeme Emri HHS tarafÄ±nda bulunmuyor ise  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n GET /duzenli-odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  DuzenliOdemeEmriRizasi  k

16aynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n Durum \n DuzenliOdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n DÃ¼zenli Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /duzenli-odeme-emri-rizasi/{rizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âDuzenliOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-8âde yer alan parametreleri iÃ§eren âDuzenliOdemeEmriRizasiâ oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âDuzenliOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /duzenli-odeme-emri-rizasi/{rizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âDuzenliOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n 8.5.\tADIM 3- Duzenli Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Duzenli Ãdeme Emrinin OluÅturulmasÄ± \n POST /duzenli-odeme-emri \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS DuzenliOdemeEmri kaynaÄÄ±nÄ± oluÅturur.\nDuzenli Ãdeme emri (DuzenliOdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r. \n \n EriÅim Belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir EriÅim Belirteci yok ise  \"TR.OHVPS.Connection.InvalidToken\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor, Y: Yetkilendirildi  ya da E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n POST /duzenli-odeme-emri-rizasi ile POST /duzenli-odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r. DÃ¼zenli Ãdeme Emri rÄ±zasÄ±nda gÃ¶nderilen deÄerlerden farklÄ± bir deÄer gÃ¶nderildiÄi durumda  âTR.OHVPS.Business.FieldMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra POST baÅarÄ±lÄ± olursa, iÃ§erisinde tlmtNo deÄiÅkeni bulunan DuzenliOdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n BAÅARILI Ä°STEK: \n Tablo 9: âDuzenliOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan dÃ¼zenli Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n >YÃ¶nlendirme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n >AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur. yetYntm = Y iÃ§in bu nesne iletilmemelidir. \n \n \n \n >>OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >>OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n \n \n >Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde, 1. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± dÃ¼zenli Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Duzenli Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >

16 GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Duzenli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Duzenli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda dÃ¼zenli Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi dÃ¼zenli Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Duzenli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Duzenli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n KolasRef ( hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. \n RefBlg (Hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n FAST/PÃS Acklm \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âDuzenliOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âDuzenliOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n Z \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.  Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ  deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n Talimat Bilgileri \n tlmtBlg \n Kompleks: TalimatBilgileri \n

16- \n \n \n \n > Talimat NumarasÄ± \n tlmtNo \n AN1..128 \n Z \n DÃ¼zenli Ãdeme Emri nesnesinin UID'sidir. DÃ¼zenli Ãdeme Emri kaydÄ±'na dair Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Talimat OluÅma ZamanÄ± \n tlmtOlsZmn \n ISODateTime \n Z \n duzenliOdemeEmri nesnesinin oluÅturulma zamanÄ±, talimatÄ±n HHS'de oluÅturulduÄu zaman bilgisidir. \n \n \n > Talimat TutarÄ± \n tlmtTtr \n AN1..24 \n Z \n ÃBHS'nin HHS'de belirlediÄi tutar bilgisidir. Talimata ait ilk Ã¶deme emri kaydÄ±nÄ±n tutar bilgisi iletilmelidir.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n > Ä°lk Ãdeme GÃ¼nÃ¼ \n ilkOdmGn \n ISODate \n Z \n ÃBHS'nin HHS'de belirlediÄi ilk Ã¶deme gÃ¼nÃ¼ bilgisidir.   AlabileceÄi minimum tarih deÄeri dÃ¼zenli Ã¶demenin verildiÄi tarihin 1 gÃ¼n sonrasÄ± olabilir. Maksimum deÄer ise 30 gÃ¼n olacak Åekilde seÃ§ilebilir.  \n \n \n > Son Ãdeme GÃ¼nÃ¼ \n sonOdmGn \n ISODate \n Z \n ÃBHS'nin HHS'de belirlediÄi son Ã¶deme gÃ¼nÃ¼ bilgisidir. AlabileceÄi minimum gÃ¼n deÄeri ilk Ã¶deme gÃ¼nÃ¼nÃ¼n 1 gÃ¼n sonrasÄ± olabilir. Maksimum deÄer ise 2 yÄ±l olmalÄ±dÄ±r.  \n \n \n > Ãdeme SayÄ±sÄ± \n odmSayi \n N3 \n Z \n ÃBHS'nin HHS'de belirlediÄi Ã¶deme sayÄ±sÄ±dÄ±r. Minimum deÄer 2 adet olmalÄ±dÄ±r. \n \n \n > Ãdeme Periyodu \n odmPryt \n AN1 \n Z \n ÃBHS'nin HHS'de belirlediÄi Ã¶deme periyot bilgisidir. TR.OHVPS.DataCode.OdemePeriyodu sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Talimat Rumuzu \n tlmtRmz \n AN1..180 \n Ä° \n ÃBHS'nin HHS'de belirlediÄi talimata dair rumuz aÃ§Ä±klamasÄ±dÄ±r. Ä°lgili alan isteÄe baÄlÄ± olup HHS'lerin inisiyatifindedir. \n 8.6.\tADIM 3.1- Duzenli Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Duzenli Ãdeme Emri Sorgusu \n GET /duzenli-odeme-emri/{tlmtNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla dÃ¼zenli Ã¶deme emrini sorgulayabilir. Maksimum talimata dair son Ã¶deme gÃ¼nÃ¼nÃ¼n 5 gÃ¼n sonrasÄ±na kadar sorgulama yapÄ±labilir. SonrasÄ±nda yapÄ±lacak sorgulamalarda eriÅim belirtecinin yetki sÃ¼resi sonlandÄ±ÄÄ± iÃ§in HHS  TR.OHVPS.Resource.ConsentRevoked Â hatasÄ±nÄ± dÃ¶nmelidir.\nÄ°ptal edilmiÅ talimatÄ±n bilgileri sorgulanmak istendiÄinde de yine  TR.OHVPS.Resource.ConsentRevoked Â hatasÄ± verilmelidir. \n YÃS sadece kendi uygulamasÄ± Ã¼zerinden verilmiÅ dÃ¼zenli Ã¶demeleri sorgulayabilir. EriÅim izni olmayan bir Ã¶deme emri numarasÄ± ile sorgulama yaptÄ±ÄÄ±nda HHS'den  TR.OHVPS.Resource.NotFound  hatasÄ±nÄ± alÄ±r. \n BAÅARILI YANIT: \n GET /duzenli-odeme-emri/{tlmtNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âDuzenliOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âDuzenliOdemeEmriâ nesnesi dÃ¶ner. \n 8.7.\tADIM 4- DÃ¼zenli Ãdeme PlanÄ± Sorgulama \n \n Åekil 10: DÃ¼zenli Ãdeme PlanÄ± Sorgulama \n GET /duzenli-odeme-emri/{talimatNo}/odeme-plani \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla dÃ¼zenli Ã¶deme planÄ±nÄ± gÃ¶rÃ¼ntÃ¼leyebilir. Ä°ptal edilen bir Ã¶deme emri rÄ±zasÄ±na dair talimat Ã¶deme planÄ± gÃ¶rÃ¼ntÃ¼lenemeyecektir. Ä°ptal edilmiÅ bir talimata ait istek geldiÄinde HHS tarafÄ±ndan  \"TR.OHVPS.Resource.ConsentRevoked\"  hatasÄ± dÃ¶nÃ¼lmelidir. \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan \"DuzenliOdemeEmriPlani\" nesnesi Tablo-11âdeki parametrelerden oluÅur: \n Tablo 11: DuzenliOdemeEmriPlani nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Ãdeme SÄ±ra NumarasÄ± \n odmSiraNo \n AN1..999 \

16n Z \n Ãdeme planÄ± iÃ§erisindeki sÄ±rayÄ± belirten deÄerdir. \n \n \n Ãdeme TutarÄ± \n odmTtr \n AN1..24 \n Z \n Ãdeme planÄ± iÃ§erisinde Ã¶deme numarasÄ± kaydÄ±na ait Ã¶denecek tutar bilgisi   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n GerÃ§ekleÅen Ãdeme TutarÄ± \n grckOdmTtr \n AN1..24 \n K \n Ãdeme planÄ± iÃ§erisinde Ã¶deme numarasÄ± kaydÄ±na ait Ã¶denmiÅ  tutar bilgisi. KÄ±smi Ã¶deme yapÄ±lan iÅlemlerde kÄ±smi Ã¶deme tutar bilgisi eklenmelidir. KÄ±smi Ã¶deme yerine Ã¶denecek tutarÄ±n tamamÄ± Ã¶denmesi durumunda ilgili tutar bilgisi iletilmelidir. Ãdeme Durumu 01, 02 ve 06 olan kayÄ±tlar iÃ§in bu alanÄ±n gÃ¶nderilmesi zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n Ãdeme TutarÄ± Para Birimi \n prBrm \n AN3 \n Z \n Tutara ait Para Birimi.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n Ãdeme Talimat Tarihi \n odmTlmtTrh \n ISODate \n Z \n Ãdeme planÄ± iÃ§erisindeki ilgili Ã¶demenin gerÃ§ekleÅmesi beklenen tarih bilgisidir. \n \n \n Ãdeme GerÃ§ekleÅme ZamanÄ± \n odmGrckZmn \n ISODateTime \n K \n Ãdeme planÄ± iÃ§erisindeki ilgili Ã¶demenin gerÃ§ekleÅtiÄi tarih bilgisidir. Ãdeme durumu 01, 02 ve 06 olan kayÄ±tlar iÃ§in bu alanÄ±n gÃ¶nderilmesi zorunludur. \n \n \n Ãdeme Durumu \n odmDrm \n AN2 \n Z \n Ãdeme planÄ± iÃ§erisindeki Ã¶demelere ait durumu belirten deÄerdir.  TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n 8.8.\tADIM 5- DÃ¼zenli Ãdeme Emri RÄ±za Ä°ptali \n \n Åekil 10: DÃ¼zenli Ãdeme Emri RÄ±zasÄ± Ä°ptali \n DELETE /duzenli-odeme-emri-rizasi/{rizaNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± iptal edebilir. \n DELETE /duzenli-odeme-emri-rizasi Ã§aÄrÄ±sÄ±, bir ÃBHS'nin Ã¶nceden oluÅturulmuÅ bir dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, ÃBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \n \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±za, iptal edilen rizaNo bilgisi ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°ptal edilmek istenen DÃ¼zenli Ãdeme Emri RÄ±zasÄ± HHS tarafÄ±nda bulunmuyor ise  âTR.OHVPS.ResourceNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu I ve S olmayan kayÄ±tlar iÃ§in rÄ±za iptali saÄlanacaktÄ±r. I ve S olan kayÄ±tlar iÃ§in rÄ±za iptal edilmek istendiÄinde HHS'ler tarafÄ±ndan  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lecektir. \n \n YukarÄ±da kontroller baÅarÄ±yla tamamlandÄ±ktan sonra sÄ±rasÄ±yla aÅaÄÄ±daki iÅlemler yapÄ±lÄ±r. \n \n DÃ¼zenli Ã¶deme talimat planÄ± iÃ§erisinde yer alan odmDrm deÄeri 04 ve 05 olan kayÄ±tlar 07 durum kodu ile gÃ¼ncellenecektir. DiÄer durum kodlarÄ± iÃ§in 07 durum ko

16d gÃ¼ncellemesi yapÄ±lmayacaktÄ±r. \n Ä°liÅkili dÃ¼zenli Ã¶deme emri talimatÄ± iptal edilmelidir. \n RÄ±za iptal edilmelidir. \n \n Bu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin ÃBHS Ã¼zerinden dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki dÃ¼zenli Ã¶deme emri rÄ±zasÄ± nesnesinin silinmesini saÄlar.\nMÃ¼Återinin ÃBHSânin veri eriÅim iznini iptal etmesi durumunda ÃBHS, HHSâde mevcut olan DuzenliOdemeEmriRizasi'na dair rÄ±za ve talimat bilgilerini pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa\nDELETE /duzenli-odeme-emri-rizasi/{RizaNo}\nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. \n Servis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r.\nÃHK rÄ±zasÄ± baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ olarak ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir.\nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir:\nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (ÃBHS) \n"},{title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",frontmatter:{},regularPath:"/v2.0.0/contents/ekler.html",relativePath:"v2.0.0/contents/ekler.md",key:"v-e89e9b86",path:"/v2.0.0/contents/ekler.html",headers:[{level:2,title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",slug:"ek-1-istek-cevap-mesajlarÄ±nda-kullanÄ±lacak-nesne-yapÄ±larÄ±"},{level:2,title:"EK-2: SÄ±ralÄ± Veri TÃ¼rleri",slug:"ek-2-sÄ±ralÄ±-veri-turleri"},{level:2,title:"EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi",slug:"ek-3-istemci-sertifikalarÄ±nÄ±n-tanÄ±m-ve-yonetimi"},{level:2,title:"EK-4: Sunucu SertifikalarÄ±",slug:"ek-4-sunucu-sertifikalarÄ±"},{level:2,title:"EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±",slug:"ek-5-mesaj-imzalama-akÄ±sÄ±"},{level:3,title:"Ä°mzalama KurallarÄ± (YÃS)",slug:"imzalama-kurallarÄ±-yos"},{level:2,title:"EK-6: HHS/YÃS API Mimarisi",slug:"ek-6-hhs-yos-api-mimarisi"}],content:' EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ± \n AÃ§Ä±k BankacÄ±lÄ±k simÃ¼latÃ¶r uygulamasÄ± Ã¼zerinde swagger dÃ¶kÃ¼manlarÄ±nÄ±n gÃ¼ncel sÃ¼rÃ¼mlerine eriÅim saÄlanabilir. \n EK-2: SÄ±ralÄ± Veri TÃ¼rleri \n \n \n \n Kod \n AÃ§Ä±klama \n \n \n \n \n TR.OHVPS.DataCode.BrcAlc \n Ä°Ålemin hesabÄ± borÃ§landÄ±rdÄ±ÄÄ± ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. B : BorÃ§ A : Alacak N : Finansal Olmayan \n \n \n TR.OHVPS.DataCode.EvetHayir \n E : Evet H : HayÄ±r \n \n \n TR.OHVPS.DataCode.GkdTur \n GKD yapÄ±lmasÄ±nÄ± gerekli bulduÄu durumda HHS, YÃSâÃ¼n belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi GKD yÃ¶ntemini bildirir: Y: YÃ¶nlendirmeli GKD A: AyrÄ±k GKD \n \n \n TR.OHVPS.DataCode.HHSDurumu \n A : AÃ§Ä±k. Ãretim OrtamÄ±nda HHSânin aktif bir Åekilde hizmet vermesi durumu.  Y : YaygÄ±nlaÅtÄ±rma. Ãretim OrtamÄ±nda HHSânin kendisi tarafÄ±ndan tanÄ±mlanmÄ±Å kÄ±sÄ±tlÄ± ÃHKâya hizmet vermesi durumu.    G : GeÃ§ici Hizmet Veremiyor. HHS servislerinde teknik bir sorun olmasÄ± nedeniyle HHSânin hizmet verememesi durumu.  K: KapalÄ±. HHSânin hizmet vermeme durumu. \n \n \n TR.OHVPS.DataCode.HHSYOSSrlmKrtr \n âkodâ : Kod âunvâ : Unvan \n \n \n TR.OHVPS.DataCode.HspDrm \n HesabÄ±n durumunu belirtir: AKTIF PASIF KAPALI \n \n \n TR.OHVPS.DataCode.HspTip \n Hesap Ã§eÅidini belirtir: VADESIZ KREDILI_MEVDUAT_HESABI POS CEK YATIRIM \n \n \n TR.OHVPS.DataCode.HspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.IslemAmaci \n 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aid

16at Ã¶demesi 12: Gayrimenkul alÄ±m Ã¶demesi 13: Motorlu taÅÄ±t alÄ±m Ã¶demesi 14: BorÃ§ verme/BorÃ§ Ã¶deme 15: Hediye/baÄÄ±Å/yardÄ±m 16: Vergi/resim/harÃ§ Ã¶demesi 17: Tazminat/sigorta Ã¶demesi 18: AvukatlÄ±k/DanÄ±ÅmanlÄ±k/MÃ¼Åavirlik Ãdemesi 19: SaÄlÄ±k Ã¶demesi 20: Kripto/dijital varlÄ±k 21: Åans oyunlarÄ±/bahis Ã¶demesi 22: EÄlence/sosyal medya Ã¶demesi 99: DiÄer \n \n \n TR.OHVPS.DataCode.IslemTuru \n Hesap hareketleri (iÅlemler) sorgusunda dÃ¶nÃ¼len Ä°Ålem TÃ¼rÃ¼ (islTur) parametresi aÅaÄÄ±daki deÄerlerden birini alabilir: HAVALE EFT FAST PARA_YATIRMA PARA_CEKME YABANCI_PARA_HAVALE YATIRIM_HESABINA_AKTARIM YATIRIM_HESABINDAN_AKTARIM KURUM_FATURA_ODEMESI CEK SENET SIGORTA_ODEMESI UCRET_KOMISYON_FAIZ SGK_ODEMESI VERGI_ODEMESI DOVIZ_ALIM DOVIZ_SATIM KREDI_ODEMESI KREDI_KULLANIM KK_ODEMESI KK_NAKIT_AVANS SANS_OYUNU UYE_ISYERI_ISLEMLERI HGS_OGS_ISLEMLERI DOGRUDAN_BORCLANDIRMA_SISTEMI DIGER \n \n \n TR.OHVPS.DataCode.IzinTur \n 01: Temel Hesap Bilgisi 02: AyrÄ±ntÄ±lÄ± Hesap Bilgisi 03: Bakiye Bilgisi 04: Temel Ä°Ålem (Hesap Hareketleri) Bilgisi 05: AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi 06: AnlÄ±k Bakiye Bildirimi 07: Temel Kart Bilgisi 08: DetaylÄ± Kart Bilgisi 09: AyrÄ±ntÄ±lÄ± Kart Ä°Ålem Bilgisi \n \n \n TR.OHVPS.DataCode.KareKodAksTur \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulamalÄ± hizmet alÄ±nan iÅyeri Ã¶demesi 02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulamalÄ± iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n TR.OHVPS.DataCode.KaynakTip \n HESAP_BILGISI_RIZASI  ODEME_EMRI_RIZASI   ODEME_EMRI   ILERI_TARIHLI_ODEME_EMRI_RIZASI   ILERI_TARIHLI_ODEME_EMRI   DUZENLI_ODEME_EMRI_RIZASI  DUZENLI_ODEME_PLANI  DUZENLI_ODEME_EMRI   BAKIYE    COKLU_ISLEM_TALEBI    HHS    YOS   KART_BILGILERI \n \n \n TR.OHVPS.DataCode.KimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) Y , YKN , N11 P , PNO , AN7..9 \n \n \n TR.OHVPS.DataCode.KolasHspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.KolasTur \n MÃ¼Återinin sorgulama istediÄi Kolay Adres Tipi deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r: T: Telefon NumarasÄ± E: E-Posta K: TCKN V: VKN Y: YKN P: Pasaport NumarasÄ± \n \n \n TR.OHVPS.DataCode.KurumKimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) V , VKN , AN10 \n \n \n TR.OHVPS.DataCode.LogoArkaPlan \n B :  LogolarÄ±n arka planÄ±nÄ±n beyaz olmasÄ± (Erkek Logo)   K : LogolarÄ±n arka planÄ±nÄ±n renkli/koyu olmasÄ± (DiÅi Logo) \n \n \n TR.OHVPS.DataCode.LogoFormat \n SVG :  Logonun svg formatÄ±nda olmasÄ±nÄ± ifade eder. Logonun 1:2 oranÄ±nda olmasÄ± gerekmektedir.   PNG : Logonun png formatÄ±nda olmasÄ±nÄ± ifade eder. Logonun 500 X 1000 px olmasÄ± gerekmektedir. \n \n \n TR.OHVPS.DataCode.LogoTur \n FULL_LOGO   : YazÄ± ve ikon Åekillerin bir arada olduÄu logo   ICON_LOGO : Ä°kon Åekillerin olduÄu ( Sadece gÃ¶rsel olan-yazÄ±sÄ±z ) logo \n \n \n TR.OHVPS.DataCode.OdemeAmaci \n Ãdemenin AmacÄ±na yÃ¶nelik olarak aÅaÄÄ±daki deÄerlerden birini alÄ±r: 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aidat Ã¶demesi 12: Gayrimenkul alÄ±m Ã¶demesi* 13: Motorlu taÅÄ±t alÄ±m Ã¶demesi* 14: BorÃ§ verme/BorÃ§ Ã¶deme* 15: Hediye/baÄÄ±Å/yardÄ±m* 16: Vergi

16/resim/harÃ§ Ã¶demesi* 17: Tazminat/sigorta Ã¶demesi* 18: AvukatlÄ±k/DanÄ±ÅmanlÄ±k/MÃ¼Åavirlik Ãdemesi* 19: SaÄlÄ±k Ã¶demesi* 20: Kripto/dijital varlÄ±k* 21: Åans oyunlarÄ±/bahis Ã¶demesi* 22: EÄlence/sosyal medya Ã¶demesi*   Liste iÃ§erisinde * ile iÅaretlenen \'Ãdeme AmacÄ±\' deÄiÅiklikleri, TCMB geÃ§iÅ sÃ¼reciyle senkronize Åekilde, 02 Nisan 2026 gÃ¼n sonu ile birlikte devreye alÄ±nacaktÄ±r. \n \n \n TR.OHVPS.DataCode.OdemeDurumu \n Ãdemenin durumunu gÃ¶sterir. AlabileceÄi deÄerler: 01: GerÃ§ekleÅti (Ãdeme ilgili Ã¶deme sistemine iletildi ve alÄ±cÄ± hesabÄ±na ulaÅtÄ±.)  02: GÃ¶nderildi (Ãdeme ilgili Ã¶deme sistemine iletildi ancak alÄ±cÄ± hesabÄ±na ulaÅtÄ±ÄÄ±na dair teyit alÄ±nmadÄ±.)Ä°Ålemin son durumunun teyidi iÃ§in YÃS sorgulama yapmalÄ±dÄ±r. 03- GerÃ§ekleÅmedi (Ãdemenin ilgili Ã¶deme sistemine iÅletiminde veya iÅlenmesi sÄ±rasÄ±nda hata, zaman aÅÄ±mÄ±, sistemin gÃ¼n sonu iÅlemlerine baÅlamasÄ± vb. durum oluÅtu ve Ã¶deme gereÃ§eklemedi veya iade edildi.) 04- Onayda bekliyor (Ã

16deme emri veya ileri tarihli Ã¶deme emri alÄ±ndÄ±. Ãoklu onay akÄ±ÅÄ±nÄ±n tamamlanmasÄ± bekleniyor.) 05- Ãdeme Bekleniyor ( Ãdeme Sistemine gÃ¶nderilmeden Ã¶nceki statÃ¼dÃ¼r.) 06- KÄ±smen GerÃ§ekleÅti ( Ä°leri tarihli ve dÃ¼zenli Ã¶deme talimatlarÄ±nda kÄ±smi Ã¶deme yapÄ±lan iÅlemler iÃ§in geÃ§erli statÃ¼dÃ¼r.) 07- Ä°ptal Edildi ( Ãdeme sistemine gÃ¶nderilmeden Ã¶nce mÃ¼Återi ya da herhangi bir sebepten iptal edilen durumlarda kullanÄ±labilir.) \n \n \n TR.OHVPS.DataCode.OdemeKaynak \n I: Ä°nternet bankacÄ±lÄ±ÄÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. A: Otomatik para makineleri (ATM) ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. T: Telefon bankacÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. K: Kiosklar aracÄ±lÄ±ÄÄ±yla gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. S: Åubeden girilen Ã¶demelerde kullanÄ±lÄ±r. M: Mobil uygulamadan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. D: YukarÄ±dakiler dÄ±ÅÄ±ndaki Ã¶deme kaynaklarÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.  O: AÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. \n \n \n TR.OHVPS.DataCode.OdemeSistemi \n Ä°Ålemin yÃ¶nlendirildiÄi Ãdeme Sistemine gÃ¶re aÅaÄÄ±daki deÄerlerden birini alabilir: H: Havale F: FAST E: EFT (PÃS) deÄerlerinden birini alabilir. \n \n \n TR.OHVPS.DataCode.OhkTur \n B: Bireysel  K: Kurumsal \n \n \n TR.OHVPS.DataCode.OhkTanimTip \n TCKN: TCKN Â  (ohkTanimDeger N11 olarak gÃ¶nderilmelidir.)  MNO:  Â  Â    HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ± (OHKTanimDeger AN1..30 olarak gÃ¶nderilmelidir. )   YKN:  Â  Â  YabancÄ± Kimlik NumarasÄ± (OHKTanimDeger N11 olarak gÃ¶nderilmelidir.)    PNO:  Â  Â  Pasaport numarsÄ± (ohkTanimDeger AN7..9 olarak gÃ¶nderilmelidir.)    GSM:  Â  Â   Cep telefonu numarasÄ± (ohkTanimDeger N10 olarak gÃ¶nderilmelidir.)   IBAN:  Â  IBAN numarasÄ± (OHKTanimDeger AN26 olarak gÃ¶nderilmelidir.) \n \n \n TR.OHVPS.DataCode.OlayTip \n KAYNAK_GUNCELLENDI  AYRIK_GKD_BASARILI AYRIK_GKD_BASARISIZ HHS_YOS_GUNCELLENDI \n \n \n TR.OHVPS.DataCode.YOSDurumu \n A : AÃ§Ä±k. Ãretim OrtamÄ±nda YÃSâÃ¼n aktif bir Åekilde hizmet vermesi durumu.   G : GeÃ§ici Hizmet Veremiyor. YÃS servislerinde teknik bir sorun olmasÄ± nedeniyle YÃS\'Ã¼n hizmet verememesi durumu.   K: KapalÄ±. YÃS\'Ã¼n hizmet vermeme durumu. \n \n \n TR.OHVPS.DataCode.PSUInitiated \n âEâ : Evet  âHâ : HayÄ±r   âOâ : Olay Bildirim \n \n \n TR.OHVPS.DataCode.RizaDurumu \n B: Yetki Bekleniyor Y: Yetkilendirildi K: Yetki KullanÄ±ldÄ± E: Yetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼ S: Yetki SonlandÄ±rÄ±ldÄ± I :Yetki Iptal \n \n \n TR.OHVPS.DataCode.RizaIptDtyKod \n â01â :Yeni RÄ±za Talebi ile Ä°ptal â02â :KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal â03â :KullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal â04â :SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor â05â :SÃ¼re AÅÄ±mÄ± : Yetkilendirildi â06â :SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi â07â :GKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± â08â :GKD iptali : RÄ±zano ile TCKN uyuÅmamasÄ± â09â :GKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor â10â :GKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± â11â :GKD iptali : Hesap Yetki Sorunu â12â :GKD iptali : ÃHK HHS kontrollerini aÅamadÄ± â13â :GKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi â14â :GKD iptali : Fraud ÅÃ¼phesi â15â :Hesap RÄ±za GÃ¼ncelleme Talebi ile Ä°ptal  â99â :GKD iptali : DiÄer \n \n \n TR.OHVPS.DataCode.RizaTip \n H: Hesap Bilgisi RÄ±zasÄ± O: Ãdeme Emri RÄ±zasÄ±  I: Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± D: DÃ¼zenli Ãdeme Emri RÄ±zasÄ± \n \n \n TR.OHVPS.DataCode.SrlmYon \n âAâ: Azalan deÄerle sÄ±ralama âYâ: Artan deÄerle sÄ±ralama \n \n \n TR.OHVPS.DataCode.VarYok \n 0 : KayÄ±t Yok   1 : KayÄ±t Var \n \n \n TR.OHVPS.DataCode.YetTip \n AlabileceÄi deÄerlere gÃ¶re hangi belirtecin dÃ¶neceÄine karar verilir. yet_kod yenileme_belirteci \n \n \n TR.OHVPS.DataCode.ZmnAralik \n 0 : KayÄ±t Yok  1 : 0-2 saat 2 : 2 saat 1 dakika-24 saat  3 : 1-3 gÃ¼n   4 : 4-15 gÃ¼n\t  5 : 16 gÃ¼n ve Ã¼stÃ¼ \n \n \n TR.OHVPS.DataCode.HizmetTipi \n 01 :  AyrÄ±k GKD  02 : Ä°leri Tarihli Ãdeme 03 : DÃ¼zenli Ãdeme \n \n \n TR.OHVPS.DataCode.OdemePeriyodu \n G :  GÃ¼nlÃ¼k  H : HaftalÄ±k A : AylÄ±k D : DiÄer \n \n \n TR.OHVPS.DataCode.KartTip \n B

16: Banka KartÄ±  K : Kredi KartÄ± P : Ãn Ãdemeli(Prepaid) Kart \n \n \n TR.OHVPS.DataCode.AltKartTip \n A : AsÄ±l  E : Ek Kart S : Sanal Kart \n \n \n TR.OHVPS.DataCode.KartStatu \n A : AÃ§Ä±k/Aktif  P : Pasif I : Ä°ptal \n \n \n TR.OHVPS.DataCode.IslemPuanDurumu \n 01 : Puan KazanÄ±mÄ±  02: Puan KullanÄ±mÄ±  03: Puan Ä°ade  04: Puan Ä°ptal \n \n \n TR.OHVPS.DataCode.KartSema \n T : TROY  M : Mastercard V : Visa U : UnionPay A : American Express J : JCB \n \n \n TR.OHVPS.DataCode.KartTuru \n B : Bireysel  T :Ticari \n \n \n TR.OHVPS.DataCode.KartFormu \n F : Fiziksel  D :Dijital \n \n \n TR.OHVPS.DataCode.EkstreStatu \n A : Aktif  P : Pasif \n EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi \n TÃ¼m katÄ±lÄ±mcÄ±larÄ±n GEÃÄ°T\'e eriÅebilmesi iÃ§in, BKM tarafÄ±ndan yapÄ±lan istemci sertifika doÄrulamasÄ±ndan geÃ§mesi gerekmektedir. Ä°stemci sertifikasÄ± Ã¼retilmeden Ã¶nce katÄ±lÄ±mcÄ±larÄ±n CSR Ã¼retme akÄ±ÅÄ±nÄ± tamamlamasÄ± gerekmektedir. \n OpenSSL ile CSR (Certificate Signing Request) OluÅturma \nAÅaÄÄ±daki komut ile 2048-bit RSA private key ve CSR oluÅturulur. \nopenssl req -new -newkey rsa:2048 -nodes -keyout PRIVATEKEY.key -out CSR.csr \n CSR ile ilgili detay bilgilerin giriÅinde; \nCommon Name (CN) olarak 4 karakterli hhsKod ya da yosKod deÄeri ile, \ndiÄer alanlar iÃ§in de kurum bilgileriniz ile giriÅ yapÄ±lÄ±r. \n TÃ¼m bilgilerin girilmesinden sonra oluÅan private key dosyasÄ± kurumunuzda saklanÄ±r.\nCSR dosyasÄ± ise istemci sertifika Ã¼retmek Ã¼zere kullanÄ±lÄ±r. Bu aÅamada takip edilmesi gereken adÄ±mlar Åu Åekildedir: \n KatÄ±lÄ±mcÄ±larÄ±n, TRIP ortamÄ± Ã¼zerinden, BKM TarafÄ±ndan yetki verilmiÅ kullanÄ±cÄ±larÄ±nÄ±n gÃ¶rebileceÄi "Ä°stemci Sertifika Talebi" menÃ¼ adÄ±mÄ±na giriÅ yapmalarÄ± beklenir. AÃ§Ä±lan ekranda,"CSR DosyasÄ± YÃ¼kleme" alanÄ± iÃ§erisine, katÄ±lÄ±mcÄ±nÄ±n Ã¼retmiÅ olduÄu csr dosyasÄ± yÃ¼klenir. YaklaÅÄ±k 1 dakika iÃ§erisinde kuruma Ã¶zel olarak Ã¼retilmiÅ olan client sertifikasÄ± indirilmeye hazÄ±r hale gelecektir. "Ä°ndir" butonu ile client sertifika indirilir. Ä°stemci tarafÄ±nda web isteÄinin ilgili sertifika ile iliÅkilendirilerek oluÅturulmasÄ± gerekmektedir. \n Uzun dÃ¶nemli olarak hazÄ±rlanacak olan sertifikalar sertifikasyon ve Ã¼retim ortamlarÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi bu aÅamalarda sÄ±nanacaktÄ±r. \n GEÃÄ°T\'in test ve Ã¼retim ortamlarÄ± ayrÄ±mÄ±nda istemci sertifikalarÄ±, HHS Listeleme API eriÅimleri ve Sertifikasyon baÄlantÄ±larÄ± Åekil 15-HHS/YÃS API Mimarisi DiagramÄ±nda resmedilmiÅtir. \n EK-4: Sunucu SertifikalarÄ± \n Sunucu sertifikalarÄ±nÄ±n endpoint bilgisini (Fqdn) iÃ§erecek ve global bir Certification Authority tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir.\nÃrneÄin; entegrasyon formu iÃ§erinde yer alan URL bilgisinin (test.xbank.com.tr) sertifika iÃ§erisinde tanÄ±mlÄ± olmasÄ± ve bu sertifikanÄ±n global bir CA Ã¶rneÄin Verisign tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir. \n Hizmet saÄlayÄ±cÄ± olan HHS\'ler tarafÄ±ndan sunucu sertifikalarÄ± uygulanmalÄ±dÄ±r. \n EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ± \n Dijital imzalama yapÄ±sÄ±, ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini saÄlamak amacÄ±yla kurgulanmÄ±ÅtÄ±r.  Ä°mzalarÄ±n kaynak bazÄ±nda hangi istek ve yanÄ±tlara uygulandÄ±ÄÄ± belirlidir. \n API yalnÄ±zca TLS\'ye dayanÄ±rsa, dijital kayÄ±tlarÄ± ve inkÃ¢r edilemezlik kanÄ±tlarÄ±nÄ± tutmak zor olur. Bu nedenle, TLS\'ye dayanmayan bir inkÃ¢r edilemezlik Ã§Ã¶zÃ¼mÃ¼ olarak API isteÄinin HTTP baÅlÄ±ÄÄ±nda bir JWS kullanÄ±larak saÄlanabilir. \n HTTP isteÄinin gÃ¶vdesinin hash fonksiyonu (SHA256) ile Ã¶zeti alÄ±nacaktÄ±r. Elde edilen Ã¶zet, asimetrik anahtarlarÄ± destekleyen bir algoritma kullanÄ±larak imzalanacak ve JWS elde edilecektir. Ä°steÄin kendinize geldiÄi durumda body Ã¼zerinde hiÃ§ bir deÄiÅikliÄe tabi tutmadan (serialize/deserialize, minify, trim, vb yapmadan) doÄrulama yapmanÄ±z gerekmektedir. AynÄ± Åekilde isteÄin kendinizden Ã§Ä±ktÄ±ÄÄ± aÅamada da response body Ã¼zerinde hiÃ§ bir deÄiÅikliÄe tabi tutmadan (serialize/deserialize, minify, trim, vb yapmadan) mesaj imzalama yapÄ±lmalÄ±dÄ±r. \n Bu kapsamda imzalama akÄ±ÅÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r: \n \n HHS ve YÃS Ã¶ncelikle Ã¶zel ve aÃ§Ä±k anahtarlarÄ±nÄ± oluÅturmalÄ±dÄ±r. Bu anahtarlarÄ± oluÅturmak iÃ§in aÅaÄÄ±da âopensslâ kullanÄ±larak oluÅturma Ã¶rneÄi paylaÅÄ±lmÄ±ÅtÄ±r. Bu anahtarlardan Ã¶zel olan anahtar mesajÄ± imzalamak iÃ§in kullanÄ±lacak olup, aÃ§Ä±k anahtar ise mesajÄ± doÄrulamak amacÄ±yla mesajÄ±n alÄ±cÄ±sÄ± tarafÄ±ndan kullanÄ±lacaktÄ±r. \n \n Ãzel anahtarÄ±n oluÅturulmasÄ±. private.pem => Ãzel anahtar  \n openssl genrsa -out private.pem 2048 \n Ãzel anahtardan aÃ§Ä±k anahtarÄ±n oluÅturulmasÄ±. public_key.pem => AÃ§Ä±k anahtar (BKM ile paylaÅÄ±lacak aÃ§Ä±k anahtar) \n openssl rsa -in private.pem -pubout -outform PEM -out public_key.pem \n Opsiyonel olarak Ã¶zel anahtarÄ±n PCKS8 formatÄ±na Ã§evrilmesi (Java aÃ§Ä±sÄ±ndan PCKS8 formatÄ±nda olma ihtiyacÄ± nedeniyle). private_key.pem => Ãzel anahtarÄ±n formatlanmÄ±Å hali.  \n openssl pkcs8 -topk8 -inform PEM -in private.pem -out private_key.pem ânocrypt \n \n \n AÃ§Ä±k ve Ãzel anahtarlar oluÅturulduktan sonra AÃ§Ä±k Anahtar BKM ile paylaÅÄ±lÄ±r. BKM bu aÃ§Ä±k anahtarÄ± diÄer katÄ±lÄ±mcÄ±larÄ±n ulaÅabilmesi ve alabilmesi iÃ§in bir Anahtar Deposu yaklaÅÄ±mÄ± ile bÃ¼nyesinde tutar. Ä°lgili anahtarÄ± iletebilmek ve alabilmek iÃ§in kullanÄ±lacak HHS/YOS API ye eriÅim detaylarÄ± EK-6 bÃ¶lÃ¼mÃ¼nde detaylÄ± olarak paylaÅÄ±lmÄ±ÅtÄ±r.  EÄer kurumun ilgili anahtar Ã§iftinin yenilenme durumu sÃ¶z konusu ise yenilemenin hemen ardÄ±ndan aÃ§Ä±k anahtar yeni bir imzalama yapÄ±lmadan Ã¶nce mutlaka BKM ile paylaÅÄ±lmalÄ±dÄ±r. \n \n \n Ä°mzalÄ± mesajÄ± aÃ§acak olan kurum mesajÄ± imzalayan kurumun aÃ§Ä±k anahtarÄ±nÄ± her sorguda yeniden almak durumunda deÄildir. Belirli periyodlarda kendi ortamÄ±ndaki anahtarÄ± yenileyerek sistemi iÅletebilir. Ancak imzalayan kurum anahtar Ã§ifti yenilemesi yaptÄ±ÄÄ±nda BKM ile aÃ§Ä±k anahtarÄ±nÄ± paylaÅsa dahi

16imzalÄ± mesajÄ± doÄrulayacak taraf eski aÃ§Ä±k anahtar ile doÄrulama yapmaya Ã§alÄ±ÅtÄ±ÄÄ± iÃ§in hata alacaktÄ±r. Bu ilk hata durumunda hÄ±zlÄ±ca BKM Ã¼zerinden yeni anahtarÄ± alÄ±p mesajÄ± tekrar doÄrulamayÄ± denemelidir. EÄer yine hata alÄ±yor ise doÄrulama iÅlemini hata statÃ¼sÃ¼ne almalÄ±dÄ±r. Bu sebeple anahtar yenileyen kurum yeni aÃ§Ä±k anahtarÄ±nÄ± yeni bir mesaj imzalama yapmadan Ã¶nce mutlaka BKM ile paylaÅmalÄ±dÄ±r. \n \n \n PSU-Fraud-Check alanÄ± iÃ§in de JWT formatÄ±nda Ã§Ä±ktÄ± hazÄ±rlanmasÄ± beklenmektedir. Ãrnek bir PSU-Fraud-Check payload deÄeri aÅaÄÄ±daki gibidir; \n {"AnomalyFlag": "0", \n"LastPasswordChangeFlag": "1", \n"FirstLoginFlag": "1", \n"DeviceFirstLoginFlag": "1", \n"BlacklistFlag": "0", \n"MalwareFlag": "0", \n"UnsafeAccountFlag": "0", \n"exp": 1663424479, \n"iat": 1663338079, \n"iss": "[https://apigw.bkm.com.tr|https://apigw.bkm.com.tr/]" } \n Ä°mzalama KurallarÄ± (YÃS) \n Bir YÃS Ã¼zerinden baÅlayan akÄ±Å Ã¶rnek olarak paylaÅÄ±lmÄ±ÅtÄ±r. \n \n \n YÃS, mesaj imzalama gerektiren her API isteÄinin HTTP gÃ¶vdesini (request body) kendi Ã¶zel anahtarÄ± ile Åifreleyerek imza bilgisini oluÅturur. \n \n \n ArdÄ±ndan bu imza verisini, gÃ¶ndereceÄi mesajÄ±n istek baÅlÄ±ÄÄ±nda yer alan X-JWS-Signature alanÄ±nda gÃ¶ndermelidir. \n \n \n X-JWS-Signature alanÄ±nda gÃ¶nderilecek olan bilgi aÅaÄÄ±daki yÃ¶ntem ile oluÅturulmalÄ±dÄ±r. \n \n \n Bu alana yazÄ±lacak olan bilgi JWT formatÄ±nda oluÅturulmalÄ±dÄ±r. \n \n \n Bir JWT, header-payload-signature alanlarÄ±ndan oluÅmaktadÄ±r. \n \n Header alanÄ±nda JWTâyi imzalamak iÃ§in kullanÄ±lacak algoritma belirtilmelidir.  Standartlar kapsamÄ±nda RS256 kullanÄ±lacaktÄ±r. \n Payload kÄ±smÄ±nda Ã¶zel olarak oluÅturulacak olan âbodyâ claim alanÄ±na istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ± yazÄ±lmalÄ±dÄ±r. \n JSON payload oluÅturulurken RFC 7519 baz alÄ±nmalÄ±dÄ±r. "iss" (Issuer) Claim, "exp" (Expiration Time) Claim, "iat" (Issued At) Claim, âbodyâ Claim alanlarÄ±nÄ±n gÃ¶nderilmesi zorunludur. ^RFC7519 \na.\t"iss" (Issuer) Claim : Kurumunuza Ã¶zel bilgidir. \nb.\t"exp" (Expiration Time) Claim: Saniye cinsinden (Unix time) imzanÄ±n son geÃ§erli olduÄu tarih. Bu tarih  mevcut sunucu saatinizden 60 dakika sonra olacak Åekilde kullanÄ±lmalÄ±dÄ±r. \nc.\t"iat" (Issued At) Claim : Saniye cinsinden (Unix time) imzanÄ±n oluÅturulduÄu tarih. Bu tarih  mevcut sunucu saatinizden 5 dakika Ã¶nce olacak Åekilde kullanÄ±lmalÄ±dÄ±r. \nd.\tâbodyâ Claim : istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ±. \n Signature alanÄ±nda da Ã¶zel anahtar ile imzalanmÄ±Å olan imza iÃ§eriÄi yer alacaktÄ±r. \n \n X-JWS-Signature:   JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir. \n Ãrnek X-JWS-Signature Payload DeÄeri \n { \n"iss": "https://apigw.bkm.com.tr", \n"exp": 1646832405, \n"iat": 1646746005, \n"body": "c543072f97a761a1d891dc81acc380bc1e6f61ca6541bd93ebfdece338457922" \n} \n \n \n \n \n YÃS, isteÄi gÃ¶nderir. Sadece mesajÄ±n bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ ve doÄruluÄunu teyit amacÄ± ile istek gÃ¶vdesi (request body) SHA256 hash deÄeri imzalanarak X-JWS-Signature alanÄ±nda bu imza iletilir. Ä°steÄin gÃ¶vde (request body) kÄ±smÄ± aÃ§Ä±k ve Åifresiz olarak gÃ¶nderilmektedir. \n \n \n HHS, isteÄi alÄ±r, talebi gerÃ§ekleÅtirmeden Ã¶nce aldÄ±ÄÄ± API isteklerinin imzasÄ±nÄ± doÄrulamalÄ±dÄ±r. X-JWS-Signature alanÄ±ndaki JWT aÅaÄÄ±daki adÄ±mlarla doÄrulanmalÄ±dÄ±r. \n \n Header kÄ±smÄ±ndaki algoritmanin RS256 olduÄu kontrol edilir. \n GÃ¶nderen kurumun aÃ§Ä±k anahtarÄ± ile JWT verify (doÄrulama) iÅlemi yapÄ±lÄ±r. \n YukarÄ±daki iÅlemlerin doÄruluÄunun ardÄ±ndan JWTânin payload kÄ±smÄ±ndaki âbodyâ claim alanÄ±ndaki bilginin, isteÄin gÃ¶vde verisinin SHA256 hash deÄerlerinin aynÄ± olduÄu kontrol edilir. \n Ãrnek checksum deÄeri   "a64b19f95eeb1fb0a0a3e2dbbc6e3d8472c52184d4543417ddc6d156fc5c5571" veya   "A64B19F95EEB1FB0A0A3E2DBBC6E3D8472C52184D4543417DDC6D156FC5C5571" Åeklinde olabilir. Ä°ki hali de aynÄ± deÄere sahiptir. Kontrollerde buna dikkat edilmesi gerekmektedir. \n \n \n \n YukarÄ±daki iÅlemler ile doÄruluÄu teyit edilmiÅ olan isteÄin talebi gerÃ§ekleÅtirir. \n \n \n EÄer istek doÄrulanamÄ±yor ise gÃ¶nderen kurumun aÃ§Ä±k ve Ã¶zel anahtar Ã§ifti yenilenmiÅ olabilir. \n \n \n BKM HHS API  Ã¼zerinden ilgili kurumun bilgilerini (kurum ko

16du vs) kullanarak kurumun detay bilgileri Ã§eker ve kendi ortamÄ±nda yeniler. \n \n \n ArdÄ±ndan imzayÄ± tekrar aÃ§Ä±k anahtar ile doÄrulayarak kontroller gerÃ§ekleÅtirilir. (EÄer halen doÄrulama iÅlemi baÅarÄ±sÄ±z ise bu istek iÃ§in hata akÄ±ÅÄ± Ã§alÄ±ÅtÄ±rÄ±lÄ±r.  TR.OHVPS.Resource.InvalidSignature  kodu ile hata Ã¼retilebilir.) \n \n \n Ä°mza bilgisinin beklendiÄi (x-jws-signature) servislerde, bu bilginin iletilmediÄi durumlarda  TR.OHVPS.Resource.MissingSignature  hatasÄ± Ã¼retilebilir. \n \n \n HHS isteÄi iÅledikten sonra cevabÄ± oluÅtururken de yukarÄ±daki akÄ±Ålar ile gÃ¶ndereceÄi cevabÄ± imzalamalÄ±dÄ±r. \n \n \n Ä°stek yanÄ±t gÃ¶vdesinin SHA256 checksum deÄeri iÃ§in hexadecimal Ã§Ä±ktÄ± kullanÄ±lacaktÄ±r. OluÅacak Ã§Ä±ktÄ±nÄ±n 64 karakter olmasÄ± beklenmektedir. Kontrol iÃ§in "^[A-Fa-f0-9]{64}$" RegEx tarifini kullanabilirsiniz. \n \n \n Ãrnek bir gÃ¶vde: \n {"katilimciBlg":{"hhsKod":"8000","yosKod":"8000"},"gkd":{"yetYntm":"Y","yonAdr":"https://boss-test.bkm.com.tr/boss/ab/yosSimulator/8000?drmKod=6021de9f-55e7-454a-94be-2044866b22e1"},"kmlk":{"kmlkTur":"M","kmlkVrs":"123456","ohkTur":"B"},"hspBlg":{"iznBlg":{"iznTur":["01","02","03","04","05"],"erisimIzniSonTrh":"2022-10-12T23:59:59+03:00","hesapIslemBslZmn":"2021-10-10T00:00:00+03:00","hesapIslemBtsZmn":"2023-10-10T23:59:59+03:00"}}}\n \n Bu gÃ¶vdenin checksum\'Ä±: \n a64b19f95eeb1fb0a0a3e2dbbc6e3d8472c52184d4543417ddc6d156fc5c5571\n \n Bu checksum\'Ä±n iletildiÄi x-jws-signature baÅlÄ±k deÄeri: \n eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwczovL2FwaWd3LmJrbS5jb20udHIiLCJleHAiOjE2NjU0NzU1NjIsImlhdCI6MTY2NTM4OTE2MiwiYm9keSI6ImE2NGIxOWY5NWVlYjFmYjBhMGEzZTJkYmJjNmUzZDg0NzJjNTIxODRkNDU0MzQxN2RkYzZkMTU2ZmM1YzU1NzEifQ.Q65PI_1fTEzzBMirvmJvXgVX3orhhZ4_UqujtGdHkU7me-1ymIjvPrzy3kfyER1pedFb7HDCBuPvYoqjX8eUnpiiZsxfzCiEa0McIhoFeUOggq-O8VihItp8bLr2DWwQ9JHN1-WXB2mL31KAKFAL1VY9-DXuAdT-RfE_SLYsl2ycmNy4ti4XvfDvvlE56ZsieFZ727VuwR8wi7F0kKDc6UhjaMF9xcUeAM1fxX-bmcOaOo1NZGC0vvgjNZKz_OJrN-q8VhWYnQPiJ7wY7S9IG8bHIkBImKSVf8LuOEvl8u0BZzADLH1iOBd9x2l1plyI_NLPTrnOqhWhKlljkkJBCg\n \n EÄer PSU-Fraud-Check iÃ§in baÅlÄ±k gÃ¶nderilecekse, yine JWT formatÄ±nda imza Ã¼retilmelidir. Ãrnek bir psu-fraud-check baÅlÄ±k deÄeri: \n eyJhbGciOiJSUzI1NiJ9.eyJBbm9tYWx5RmxhZyI6IjAiLCJMYXN0UGFzc3dvcmRDaGFuZ2VGbGFnIjoiMSIsIkZpcnN0TG9naW5GbGFnIjoiMSIsIkRldmljZUZpcnN0TG9naW5GbGFnIjoiMSIsIkJsYWNrbGlzdEZsYWciOiIwIiwiTWFsd2FyZUZsYWciOiIwIiwiVW5zYWZlQWNjb3VudEZsYWciOiIwIiwiZXhwIjoxNjY1NDc1NTU2LCJpYXQiOjE2NjUzODkxNTYsImlzcyI6Imh0dHBzOi8vYXBpZ3cuYmttLmNvbS50ciJ9.DhUh_nsXDuNIrvsQ3KOhOXdVcJg6fTDVW8K1oea8kLtmb7n-_hJHY3mWX5zzobu-Vh2VvFzIxPhHtol6gLHFktmIMiQ9TDHb_mRZFXgJB4ToNfqc3Fy9mi5bS8By2IYi1HxDaCStstaZDaunzXfHCtqybfZXyk6teDrf-iIf6lqX9Keo7GZO-Y7mP7C13-c_QwyNKrZK4TZwUQbecRqXYn1DcEHM7kukQHTar_hKBWkXPmNpScY0J2rKksr4ejR1uLhdQm-Pdwoe9y6qrNEB79vMLBkRNtbuV0vc1GYHp_YKkzBKBI_58uuB2GD9877CsrcRnHMQb88xpxiPKh6-ew\n EK-6: HHS/YÃS API Mimarisi \n HHS/YÃS API Uygulama Mimarisinde Test ve Ãretim ortamlarÄ±nda aÅaÄÄ±daki alanda yer almaktadÄ±r. \n \n Åekil 15: HHS/YÃS API Mimarisi \n'},{title:"GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",frontmatter:{},regularPath:"/v2.0.0/contents/erisim-belirteci.html",relativePath:"v2.0.0/contents/erisim-belirteci.md",key:"v-14ad9962",path:"/v2.0.0/contents/erisim-belirteci.html",headers:[{level:2,title:"Yetkilendirme Kodu API",slug:"yetkilendirme-kodu-api"},{level:2,title:"EriÅim Belirteci API",slug:"erisim-belirteci-api"}],content:' GÃ¼Ã§lÃ¼ Kimlik DoÄrulama  \n \n ÃHK\'nÄ±n YÃS uygulamasÄ±ndan HHS uygulamasÄ±na yÃ¶nlendirilmesi ile baÅlanan gÃ¼Ã§lÃ¼ kimlik doÄrulama sÃ¼reci,  Oauth 2.0 standartlarÄ± gereÄi Ã¶ncelikle yetkod deÄerinin YÃS\'e iletilmesi ile baÅlar ve eriÅim belirtecinin alÄ±nmasÄ± sonucunda baÅarÄ± ile sonuÃ§lanmÄ±Å olur. \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ  "odeme_emri" \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n yetkilendirme-kodu \n GET \n /yetkilendirme-kodu \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n \n yetkilendirmeKodu \n \n \n 2 \n erisim-belirteci \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n ErisimBelirteciIstegi \n ErisimBelirteci \n Yetkilendirme Kodu API \n GET /yetkilendirme-kodu \n AyrÄ±k GKD sÃ¼recinde kullanÄ±lacak olan Yetkilendirme Kodu API\'nin  HHS tarafÄ±ndan sunulmasÄ± gerekmektedir. \n AyrÄ±k GKD akÄ±ÅÄ±nda; HHS, YÃS\'Ã¼n olay dinleme servisine "AYRIK_GKD_BASARILI" olay tipi ile olay bildirimi yapar. BÃ¶ylece ÃHK\'nÄ±n kendi sistemine baÅarÄ± ile login olduÄunu ve yetKod deÄerinin ÃHK ile iliÅkilendirildiÄinin bilgisini Y

16ÃS\'e iletmiÅ olur.  \nHHS olay bildirimi iÃ§in retry policy sÃ¼reÃ§leri kapsamÄ±nda 1 dakikada 3 kez deneme yapabilir. YÃS\'e olay bildirimi yapÄ±lmamÄ±Å ise, kendisine gelmeyen olay bildirimi iÃ§in yetkod\'un geÃ§erli olduÄu 5 dakika boyunca yetkilendirme-kodu endpointi ile sorgulama yaparak yetkod deÄerini alabilir. \n YÃS, "ODEME_EMRI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=O \n YÃS, "ILERI_TARIHLI_ODEME_EMRI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=I \n YÃS, "DUZENLI_TEKRARLI_ODEME_EMRI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=D \n YÃS, "HESAP_BILGISI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=H \n Ä°STEK: \n YÃS, rÄ±za numarasÄ±nÄ± ve isteÄin ÃBH ya da HBH olmasÄ±na gÃ¶re deÄiÅen rÄ±za tipini parametre olarak istek talebine ekler. RÄ±za tipinin alabileceÄi deÄerler  TR.OHVPS.DataCode.RizaTip  sÄ±ralÄ± veri tiplerinde belirtilmiÅtir. \n HHS\'nin, yetkilendirme yÃ¶ntemi "AyrÄ±k Gkd" ise  rÄ±za numarasÄ± ile yetki kodu deÄerini dÃ¶nmesi beklenmektedir. YÃ¶nlendirmeli GKD iÃ§in bu endpoint "yetKod" deÄerini dÃ¶nmemelidir. YÃ¶nlendirmeli GKDâye ait bir rÄ±za no ile yetkilendirme kodu API kullanÄ±larak yet_kod alÄ±nmak istendiÄinde HHS tarafÄ±ndan  TR.OHVPS.Resource.NotFound  hatasÄ± verilmelidir. \n YANIT: \n HHS yanÄ±t nesnesi iÃ§erisinde, ÃHK\'ya ait yetki kodunu, rÄ±za no ve rÄ±za durumu ile birlikte YÃS\'e iletir. \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Yetki Kodu \n yetKod \n AN1..255 \n Z \n GKD sÃ¼recinde Ã¼retilen yetkilendirme kodudur. Tek kullanÄ±mlÄ±k olup, aynÄ± yetKod ile birden fazla token alÄ±namaz. yetKod Parametresinin yaÅam Ã¶mrÃ¼ 5 dakika olmalÄ±dÄ±r. \n \n \n RÄ±zaNo \n rizaNo \n AN1..128 \n Z \n RÄ±za nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n AyrÄ±k GKD sÃ¼recinde, yetkod deÄerini alan YÃS; eriÅim belirteci API ile GKD sÃ¼recini tamamlar. \n EriÅim Belirteci API \n POST /erisim-belirteci \n Ä°STEK: \n YÃS erisim-belirteci eriÅim adresini 2 amaÃ§la kullanÄ±r: \n \n \n Bir Ã¶nceki adÄ±mdan aldÄ±ÄÄ± rizaNo, rizaTip (Ã¶deme emri baÅlatma hizmetinde âOâ, hesap bilgisi hizmetinde âHâ, ileri tarihli Ã¶deme emri baÅlatma hizmetinde "I") ve GKD sonrasÄ± dÃ¶nÃ¼len yetKod bilgilerini kullanarak HHS nezdinde ErisimBelirteci nesnesi oluÅturmak Ã¼zere istekte bulunur. YÃSâÃ¼n istekte bulunabilmesi iÃ§in GKD adÄ±mÄ±nÄ±n baÅarÄ±lÄ± bir Åekilde tamamlanmasÄ± rizaDrm bilgisinin âyetkilendirildiâ olmasÄ± gerekir. EriÅim Belirteci nesnesi ile rÄ±zasÄ± nesnesi (Ãdeme Emri RÄ±zasÄ±, Hesap Bilgisi RÄ±zasÄ± veya Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±) arasÄ±ndaki iliÅki rÄ±za numarasÄ± Ã¼zerinden saÄlanÄ±r. \n \n \n AldÄ±ÄÄ± eriÅim belirtecinin GeÃ§erlilik SÃ¼resinin dolduÄu durumda, yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci almasÄ± gerekmektedir. \n \n \n POST /erisim-belirteci isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âErisimBelirteciIstegiâ nesnesi (Tablo-23) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âErisimBelirteciâ nesnesi (Tablo 24) oluÅturulur veya (Yenileme Belirteci iÃ§in) gÃ¼ncellenir. RÄ±za durumu âYetki KullanÄ±ldÄ±â olarak gÃ¼ncellenir. \n EriÅim Belirteci POST iÅlemi sonucunda HTTP 200 dÃ¶nÃ¼lmesi gerekmektedir. \n âErisimBelirteciIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±zaNo \n rizaNo \n AN1..128 \n Z \n RÄ±za nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n RÄ±za Tipi \n rizaTip \n AN1 \n Z \n O,H,I,D (TR.OHVPS.DataCode.RizaTip) \n \n \n Yetki Tipi \n yetTip \n AN1..50 \n Z \n âyet_kodâ yada âyenileme_belirteciâ deÄerini alabilir.  (TR.OHVPS.DataCode.YetTip) \n \n \n Yetki Kodu \n yetKod \n AN1..255 \n K \n GKD iÅleminden dÃ¶nen yetkilendirme kodudur. Tek kullanÄ±mlÄ±k olup, aynÄ± yetKod ile birden fazla token alÄ±namaz. yetKod Parametresinin yaÅam Ã¶mrÃ¼ 5 dakika olmalÄ±dÄ±r. yetTip = âyet_kodâ ise zorunludur. \n \n \n Yenilenme Belirteci \n yenilemeBelirteci \n AN1..4096 \n K \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r. yetTip = âyenileme_belirteciâ ise kullanÄ±mÄ± zorunludur. \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âerisimBelirteciâ nesnesinde bulunan eriÅim belirteci deÄeri Ã¶deme emrinin baÅlatÄ±lmasÄ± esnasÄ±nda kullanÄ±lÄ±r. \n "

16ErisimBelirteci" nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n EriÅim Belirteci \n erisimBelirteci \n AN1..4096 \n Z \n Yetkilendirme Kodu karÅÄ±lÄ±ÄÄ±nda HHS tarafÄ±ndan dÃ¶nÃ¼len ve sonraki hesap bilgisi ve Ã¶deme emri servislerine eriÅimde kullanÄ±lan bilgidir. BÃ¶lÃ¼m 3.6 Karakter Kodlama   bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. Yenileme belirteci ile birden fazla eriÅim belirteci alÄ±nmasÄ± durumunda verilen tÃ¼m eriÅim belirteÃ§lerinin sÃ¼releri bitene kadar geÃ§erli olmalÄ±dÄ±r. \n \n \n GeÃ§erlilik SÃ¼resi \n gecerlilikSuresi \n N1..9 \n Z \n EriÅim Belirtecini saniye cinsinden geÃ§erlilik sÃ¼residir.  EriÅim belirteci geÃ§erli olduÄu son tarih ; Hesap Bilgisi RÄ±zasÄ± iÃ§in en fazla 30 gÃ¼n en az ise 1 gÃ¼n olmalÄ±dÄ±r.  EriÅimin GeÃ§erli OlduÄu Son Tarih(erisimIzniSonTrh); EriÅim Belirteci GeÃ§erlilik SÃ¼resi\'nden kÃ¼Ã§Ã¼k ise EriÅimin GeÃ§erli OlduÄu Son Tarih deÄeri ile sÄ±nÄ±rlÄ±dÄ±r. Ãdeme Emri RÄ±zasÄ± ,Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± ve DÃ¼zenli TekrarlÄ± Ãdeme Emri RÄ±zasÄ± iÃ§in 5 dakika olmalÄ±dÄ±r. \n \n \n Yenileme Belirteci \n yenilemeBelirteci \n AN1..4096 \n Z \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r.   BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir.  Yenileme Belirteci ile EriÅim Belirteci isteÄi yapÄ±ldÄ±ÄÄ±nda HHS\'nin dÃ¶ndÃ¼ÄÃ¼ yanÄ±t iÃ§erisindeki yenilemeBelirteci deÄerini kesinlikle deÄiÅtirmemesi gerekmektedir.Yenileme belirteci rÄ±za sÃ¼resi boyunca gÃ¼ncellenmemelidir. \n \n \n Yenileme Belirteci GeÃ§erlik SÃ¼resi \n yenilemeBelirteciGecerlilikSuresi \n N1..9 \n Z \n Yenileme belirtecinin saniye cinsinden geÃ§erlilik sÃ¼residir. Yenileme belirtecinin geÃ§erli olduÄu son tarih ; Hesap Bilgisi iÃ§in EriÅimin GeÃ§erli OlduÄu Son Tarih ile sÄ±nÄ±rlÄ± olmalÄ±dÄ±r. Bu tarih geldiÄi zaman Hesap Bilgisi RÄ±za Durumunu âYetki SonlandÄ±rÄ±ldÄ±â statÃ¼sÃ¼ne Ã§ekilmesi gerekir. Ãdeme BaÅlatma iÃ§in RÄ±za OluÅturma ZamanÄ±ndan 15 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. 15 gÃ¼n sÃ¼resi sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. Ãdeme emri 5 dakika iÃ§inde gerÃ§ekleÅtirilmelidir. GerÃ§ekleÅmediÄinde 4.2.8 bÃ¶lÃ¼mÃ¼nde aktarÄ±lan rÄ±za statÃ¼ gÃ¼ncellemesi yapÄ±lmalÄ±dÄ±r.  Yenileme belirteci geÃ§erlilik sÃ¼resi, Ä°leri Tarihli Ãdeme Emri BaÅlatma iÃ§in talimatÄ±n gerÃ§ekleÅeceÄi zamandan 15 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. Talimat gerÃ§ekleÅtikten sonrasÄ± iÃ§in 15 gÃ¼n sÃ¼reyle sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. Yenileme belirteci geÃ§erlilik sÃ¼resi, DÃ¼zenli TekrarlÄ± Ãdeme Emri BaÅlatma iÃ§in talimatÄ±n gerÃ§ekleÅeceÄi  son Ã¶deme gÃ¼nÃ¼  zamanÄ±ndan 5 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. Son talimat gerÃ§ekleÅtikten sonrasÄ± iÃ§in 5 gÃ¼n sÃ¼reyle sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. \n \n \n \n erisim-belirteci erisim noktasÄ±ndan elde edilen erisimBelirteci, iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda x-access-token alanÄ±nda iletilir. \n Yenilenme Belirteci (refreshToken) kullanÄ±larak EriÅim Belirteci (accessToken) alÄ±ndÄ±ÄÄ±nda, dÃ¶nen yanÄ±ttaki Yenileme Belirteci GeÃ§erlik SÃ¼resi (yenilemeBelirteciGecerlilikSuresi) geÃ§en sÃ¼re eksiltilerek, kalan zamanÄ±n saniye cinsinden hesaplanmasÄ±yla iletilmelidir. \n EriÅim Belirteci API Ã§aÄrÄ±mÄ± sÄ±rasÄ±nda rÄ±za durumlarÄ± kontrol edilmelidir. Bu kontrollerin nasÄ±l yapÄ±lmasÄ± gerektiÄi 4-RÄ±za DurumlarÄ± bÃ¶lÃ¼mÃ¼nde aktarÄ±lmÄ±ÅtÄ±r. \n Yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda HHS\'nin dÃ¶ndÃ¼ÄÃ¼ hata yanÄ±tÄ±nda httpCode = 401 ve errorCode = "TR.OHVPS.Connection.InvalidToken" gelirse YÃS Ã¶nce rÄ±zanÄ±n durumu sorgulamalÄ±dÄ±r.  \nEÄer geÃ§erli bir rÄ±za ise; HHS veya YÃS tarafÄ±nda bir sorun olduÄu anlaÅÄ±lmalÄ±dÄ±r. Sistem tarafÄ±ndan hata Ã¼retilmeli ve sorun incelenmelidir. \nEÄer geÃ§erli bir rÄ±za deÄil ise YÃS tarafÄ±ndaki rÄ±za durumu gÃ¼ncellenmelidir. \n'},{title:"HHS ve YÃS API",frontmatter:{},regularPath:"/v2.0.0/contents/hhs-yos-api.html",relativePath:"v2.0.0/contents/hhs-yos-api.md",key:"v-2b71dd9d",path:"/v2.0.0/contents/hhs-yos-api.html",headers:[{level:2,title:"HHS API",slug:"hhs-api"},{level:2,title:"YOS API",slug:"yos-api"}],content:" HHS ve YÃS API \n HHS API, HHSâlerin detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. HHS API iÃ§in âhhs_readâ scope bilgisi kullanÄ±lÄ±r. \n Production ortamÄ±nda HHS / YOS API iÃ§erisinde sisteme dahil olmuÅ, sertifikasyonu baÅarÄ± ile tamamlamÄ±Å paydaÅlar listelenecektir. HHS tarafÄ±ndan desteklenen API sÃ¼rÃ¼mleri listelenecektir. \n YÃSâler HHS APIâsini sorgulayabilir ancak YÃS APIâsini sorgulayamazlar. \nBenzer Åekilde HHSâler YÃS APIâsini sorgulayabilir, HHS APIâsini sorgulayamazlar. \n HHS API \n GET /hhs/{hhsKod} \n Ä°Ålem Sorgu ÃrneÄi =  /hhs  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m HHSâlerin dizi Åeklinde verileri listelenir. \nÄ°Ålem Sorgu ÃrneÄi =  /hhs/2001   â¨ bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan hhsKoduâna ait bilgiler listelenir. Ya da â404 Not Foundâ hatasÄ± alÄ±r. \nHHS ve YÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir. \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hhs?srlmKrtr=kod&srlmYon=A \n Tablo 20: HHS ve YÃS API Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âkodâ, âunvâ

16} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, sÄ±ralama kriteri âunvâ olarak belirlenmelidir. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 21: HHS Bilgileri Sorgulama YanÄ±tÄ± âHhsâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n hhs kodu \n kod \n AN4 \n Z \n HHS nin kod bilgisi \n \n \n hhs unvanÄ± \n unv \n AN3..140 \n Z \n HHS nin unvan bilgisi \n \n \n hhs markasÄ± \n marka \n AN1..140 \n Z \n ÃHK'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. HHS tarafÄ±ndan belirlenecektir. \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n HHSânin mesaj imzalama iÃ§in paylaÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n HHS Api Bilgileri \n apiBilgileri \n Kompleks: HhsApiBilgi[Array][0..N] \n Z \n Desteklenen Api ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > api \n api \n AN1..20 \n Z \n Api Ä°smi Ãrnek :obh, hbh,gkd \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s1.0, s2.0 \n \n \n HHS Hizmet Bilgileri \n hizmetBilgileri \n Kompleks: HhsHizmetBilgi[Array][0..N] \n Z \n Desteklenen hizmet ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > hizmetTipi \n hizmetTipi \n AN1..20 \n Z \n Hizmet Tipi bilgileri.TR.OHVPS.DataCode.HizmetTipi sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s1.1, s2.0 \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n HHS'ye ait logo bilgileri. \n \n \n > logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n HHS tarafÄ±nda tutulan ve YÃS'lerle paylaÅÄ±lacak olan url adres bilgisidir.  Ãrnek: https://via.placeholder.com/150?text=0001 \n \n \n > logoArkaPlan \n logoArkaPlan \n AN1 \n Z \n TR.OHVPS.DataCode.LogoArkaPlan sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoFormat \n logoFormat \n AN3 \n Z \n TR.OHVPS.DataCode.LogoFormat sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n Durum \n durum \n AN1 \n Z \n HHS'nin durum bilgisidir.  TR.OHVPS.DataCode.HHSDurumu sÄ±ralÄ± veri tipinde alabileceÄi deÄerler belirtilmiÅtir. \n \n \n \n HHS API'de; AÃ§Ä±k, YaygÄ±nlaÅtÄ±rma, GeÃ§ici Hizmet Veremiyor, KapalÄ± durumlarÄ±ndaki HHS'ler listelenecektir.  \nSertifikasyon onayÄ± alan HHS'ler, Ã¼retim ortamÄ±na geÃ§iÅte \"YaygÄ±nlaÅtÄ±rma\" durumuna sahip olabilir.  HHS'nin, hangi YÃS'ler ile \"YaygÄ±nlaÅtÄ±rma\" kontrollerini yapacaÄÄ±, HHS yÃ¶netiminde olacaktÄ±r. BÃ¶ylece Ãretim OrtamÄ±nda HHSânin kendisi tarafÄ±ndan tanÄ±mlanmÄ±Å kÄ±sÄ±tlÄ± ÃHKâya hizmet vermesi ve servislerini test etmesi saÄlanabilir olacaktÄ±r. HHS'ler kendi kurum kontrollerini yapana kadar, \"YaygÄ±nlaÅtÄ±rma\" durumunda kalabilirler. HHS'nin BKM'ye yapacaÄÄ± talep ile, HHS \"YaygÄ±nlaÅtÄ±rma\" durumundan \"AÃ§Ä±k\" durumuna geÃ§ebilecektir. \n AÅaÄÄ±daki durumlarda HHS'nin statÃ¼sÃ¼ GeÃ§ici KapalÄ± olarak gÃ¼ncellenebilecektir: \n \n HHS'nin talebi ile uzun sÃ¼reli (minimum 1 saati aÅan) yaÅanan teknik sorunlarda ve BKMâye en az 3 iÅ gÃ¼nÃ¼ Ã¶ncesinde bildirilen planlÄ± kesintilerde G statÃ¼sÃ¼ne alÄ±nabilecektir. \n Ä°lgili resmi kurumlardan gelen talep Ã¼zerine HHS G statÃ¼sÃ¼ne alÄ±nabilir. \n \n YÃS'ler hem A hem G statÃ¼sÃ¼nde olan HHS'leri listeleyebilir. Ancak YÃS uygulamasÄ±nda G statÃ¼sÃ¼nde olan bir HHS mÃ¼Återi tarafÄ±ndan seÃ§ilirse mÃ¼Återiye gerekli hata mesajÄ±nÄ±n verilmesi ve ilgili HHS'ye istek atÄ±lmamasÄ± saÄlanmalÄ±dÄ±r. \n Hem YOS hem de HHS API iÃ§in geÃ§erli olacak; logo gÃ¶nderiminde dikkat edilmesi gerekenler Åu Åekilde tariflenmiÅtir: \n \n LogolarÄ±n ham dosya yerine kurumun yayÄ±nlayacaÄÄ± bir URL Ã¼zerinden sunulmasÄ± gerekmektedir. (Ãrn: logoURL = https://kurumadi.com.tr/logo.png) Logo BKM tarafÄ±nda host edilmeyecektir. \n Logo urlâin public eriÅilebilir url olmasÄ± gereklidir. \n Logo, yatayda veya dikeyde taÅma paysÄ±z tam oturacak, sÄ±nÄ±r boyutlarÄ±nÄ± geÃ§meyecek ve ortalanmÄ±Å yerleÅime sahip olmalÄ±dÄ±r. \n YÃS uygulamasÄ±nda gÃ¶sterim esnasÄ±nda logolarÄ±n hÄ±zlÄ± yÃ¼klenmesi ve dÃ¼ÅÃ¼k veri tÃ¼ketmesi aÃ§Ä±sÄ±ndan; logo boyutu 250 KBâÄ±n altÄ±nda olmalÄ±dÄ±r. \n HHS ve YÃSâlerin tÃ¼m logo tÃ¼rlerini (8 farklÄ± tipte logoyu) zorunlu olarak dÃ¶nmesi beklenmektedir. \n Circle logo kullanÄ±lmasÄ± gerektiÄinde ICON_LOGO logo tÃ¼rÃ¼ kullanÄ±lmalÄ±dÄ±r. \n LogolarÄ±nÄ± gÃ¼ncellemek isteyen kurumlarÄ±n en az 3 iÅ gÃ¼nÃ¼ Ã¶ncesinde BKMâye bu deÄiÅikliÄi GEÃÄ°T Test/Ãretim OrtamÄ± Entegrasyon formu ile bildirmesi gereklidir.  BKM de katÄ±lÄ±mcÄ±lara HHS/YÃS API aracÄ±lÄ±ÄÄ± ile gÃ¼ncel logonun Ã§ekilmesi gerektiÄine dair bilgilendirme yapar. \n LogolarÄ± anlÄ±k Ã§eken katÄ±lÄ±mcÄ±larÄ±n, herhangi bir teknik nedenden dolayÄ± gÃ¼ncel logoyu alamadÄ±ÄÄ± durum olabilir. Bu durumda sistemlerine kaydetmiÅ olduÄu kuruma ait ikon logoyu gÃ¶stermesi gereklidir. \n HHS ve YÃSâler API aracÄ±lÄ±ÄÄ± ile almÄ±Å olduklarÄ± logolarÄ±n formatÄ± Ã¼zerinde deÄiÅiklik (kare, yuvarlak hale getirip resize etmek gibi) yapabilirler. Ancak logonun gÃ¶rsel ve yazÄ±larÄ±nÄ± etkileyecek bir  deÄiÅiklik yapmamalÄ±dÄ±rlar. \n YÃS/HHS mobil uygulamasÄ±ndaki dark mode ve light mode kullanÄ±mlarÄ±nda, hangi logonun kullanÄ±lacaÄÄ±na uygulama sahibi karar verecektir. \n YOS API \n YÃS API, YÃS statÃ¼sundeki kurumlarÄ±n detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. YÃS API iÃ§in âyos_readâ scope bilgisi kullanÄ±lÄ±r. \n YÃS API yanÄ±tÄ±nda, listelenen yÃ¶nlendirme ve bildirim adresleri bulunmaktadÄ±r. HHS, iÅlem anÄ±nda iletilen yonAdr ya da bldrAdr alanlarÄ±nda gÃ¶nderilen adreslere yetKod deÄerini iletmelidir. YÃS API iÃ§erisinde yer alan adresleri, rÄ±za isteÄinde gÃ¶nderilen adreslerin doÄruluÄunu kontrol etme amacÄ±yla kullanÄ±lmalÄ±dÄ±r. Bu nedenle YÃS API iÃ§erisinde listelenen adreslerin hostname seviyesinde yer almasÄ± yeterlidir. \n YÃS API iÃ§erisinde yer alan YÃS rol bilgileri ve aktiflik/pasiflik durumlarÄ± birbiriyle iliÅkili deÄildir. \n YÃS'Ã¼n sahip olduÄu Ã¶bhs,hbhs rolleri iÃ§in herhangi bir fraud ya da teknik sebeplerden Ã¶tÃ¼rÃ¼ geÃ§ici sÃ¼reyle geri alÄ±nabilir. \n YÃS'lerin hizmet verememesi durumunda rollerinin ger

16i alÄ±nmasÄ± yapÄ±lmayacaktÄ±r. YÃS rolleri sadece ilgili resmi kurumlardan gelen talep Ã¼zerine alÄ±nabilecektir. \n YÃS aktifliÄini korurken problem Ã§Ã¶zÃ¼lene kadar geÃ§ici olarak alÄ±nan roller(Ã¶bhs,hbhs) tekrardan aktif hale getirilir. \n GET /yos/{yosKod} \n Ä°Ålem Sorgu ÃrneÄi =  /yos  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m YÃS'lerin dizi Åeklinde verileri listelenir. \n Ä°Ålem Sorgu ÃrneÄi =  /yos/2501  â¨  bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan yosKoduâna ait bilgiler listelenir ya da â404 Not Foundâ hatasÄ± alÄ±r.\nYÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir.\nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /yos?srlmKrtr=kod&srlmYon=A \n Tablo 22: YOS Bilgileri Sorgulama YanÄ±tÄ± âYosâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n YÃ¶s kodu \n kod \n AN4 \n Z \n YÃS'Ã¼n kod bilgisi \n \n \n YÃ¶s unvanÄ± \n unv \n AN3..140 \n Z \n YÃS unvan bilgisi \n \n \n YÃ¶s markasÄ± \n marka \n AN1..140 \n Z \n ÃHK'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. YÃS tarafÄ±ndan belirlenecektir. \n \n \n YÃS rolleri \n roller \n Array[AN4] \n Z \n YÃSâun rollerini belirten deÄer. Ãrnek: [ \"obhs\", \"hbhs\" ]  - obhs - Ãdeme Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼  - hbhs - Hesap Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼ \n \n \n Adresler \n adresler \n Kompleks:Adres[Array] [1..N] \n Z \n --- \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. Adres detaylarÄ±nÄ±n hangi GKD tÃ¼rÃ¼ne ait olduÄunu belirtir. \n \n \n > Adres DetaylarÄ± \n adresDetaylari \n adresDetaylari\tKompleks: AdresDetayi[Array] [1..N] \n Z \n \n \n \n >> Temel Adres \n tmlAdr \n AN1..1024 \n Z \n yetYntm deÄeri âYâ olarak iletildiÄinde YÃ¶nlendirmeli GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. yetYntm deÄeri âAâ olarak iletildiÄinde AyrÄ±k GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. Riza isteklerinde bu deÄer ile uyumluluÄu kontrol edilmelidir. Ãrnek: https://example.com https://example2.com/path deepLink://example/test deepLink://example2/test \n \n \n >> AÃ§Ä±klama \n aciklama \n AN1..1024 \n Ä° \n YÃSâÃ¼n gÃ¶nderdiÄi adrese yÃ¶nelik vermek istediÄi aÃ§Ä±klama Ãrnek: WEB bireysel , WEB kurumsal  , APP \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n YÃSâÃ¼n mesaj imzalama iÃ§in paylaÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n YÃS Api Bilgileri \n apiBilgileri \n Kompleks: YosApiBilgi[Array][0..N] \n Z \n Desteklenen Api ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > api \n api \n AN1..20 \n Z \n Api Ä°smi Ãrnek :ods \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s2.0 s1.0 \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n YOSâe ait logo bilgileri. \n \n \n > logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n YÃS tarafÄ±nda tutulan ve HHSâlerle paylaÅÄ±lacak olan url adres bilgisidir.  Ãrnek: https://via.placeholder.com/150?text=0001 \n \n \n > logoArkaPlan \n logoArkaPlan \n AN1 \n Z \n TR.OHVPS.DataCode.LogoArkaPlan sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoFormat \n logoFormat \n AN3 \n Z \n TR.OHVPS.DataCode.LogoFormat sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n Durum \n durum \n AN1 \n Z \n YÃS'Ã¼n durum bilgisidir.  TR.OHVPS.DataCode.YOSDurumu sÄ±ralÄ± veri tipinde alabileceÄi deÄerler belirtilmiÅtir. \n \n \n \n"},{title:"9.\tHesap Bilgisi Hizmeti",frontmatter:{},regularPath:"/v2.0.0/contents/hesap-bilgisi-hizmeti.html",relativePath:"v2.0.0/contents/hesap-bilgisi-hizmeti.md",key:"v-2c81f446",path:"/v2.0.0/contents/hesap-bilgisi-hizmeti.html",headers:[{level:2,title:"Genel Bilgiler",slug:"genel-bilgiler"},{level:2,title:"Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri",slug:"hesap-bilgisi-hizmeti-icin-erisim-adresleri"}

16,{level:2,title:"ADIM 0: ÃHK'nÄ±n hesap/kart bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:",slug:"adim-0-ohk-nÄ±n-hesap-kart-bilgilerine-erisim-icin-talepte-bulunmasÄ±"},{level:2,title:"9.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_9-1-adim-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:3,title:"POST /hesap-bilgisi-rizasi",slug:"post-hesap-bilgisi-rizasi"},{level:3,title:"BaÅarÄ±lÄ± Ä°stek:",slug:"basarÄ±lÄ±-istek"},{level:3,title:"BaÅarÄ±lÄ± YanÄ±t:",slug:"basarÄ±lÄ±-yanÄ±t"},{level:2,title:"Ä°zinler",slug:"izinler"},{level:2,title:"9.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi",slug:"_9-2-adim-2-hesap-bilgisi-hizmeti-rÄ±zasÄ±nÄ±n-tesisi"},{level:2,title:"9.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ±",slug:"_9-3-adim-2-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±"},{level:2,title:"9.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali",slug:"_9-4-adim-2-2-hesap-bilgisi-rÄ±zasÄ±nÄ±n-iptali"},{level:2,title:"9.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ±",slug:"_9-5-adim-3-hesap-bilgilerinin-alÄ±nmasÄ±"},{level:2,title:"9.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ±",slug:"_9-6-adim-3-1-ve-3-2-hesap-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"9.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ±",slug:"_9-7-adim-3-3-ve-3-4-hesap-bakiyesinin-sorgulanmasÄ±"},{level:2,title:"9.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ±",slug:"_9-8-adim-3-5-ve-3-6-islemlerin-sorgulanmasÄ±"},{level:2,title:"9.9 ADIM 4: Kart Bilgilerinin SorgulanmasÄ±",slug:"_9-9-adim-4-kart-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"9.10 ADIM 4.1: Kart Detay Bilgilerinin SorgulanmasÄ±",slug:"_9-10-adim-4-1-kart-detay-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"9.11 ADIM 4.2: Kart Hareket Bilgilerinin SorgulanmasÄ±",slug:"_9-11-adim-4-2-kart-hareket-bilgilerinin-sorgulanmasÄ±"}],content:" 9.\tHesap Bilgisi Hizmeti  \n Genel Bilgiler \n Bu dokÃ¼manda belirtilen \"Hesap Bilgisi Hizmeti\" ibaresi hem hesap hem de kart rÄ±za sÃ¼reÃ§lerini kapsamaktadÄ±r. \n Hesap bilgisi sorgulama iÃ§in HBHS tarafÄ±ndan mÃ¼Återi rÄ±zasÄ± tesisinin HHS tamamlanmÄ±Å olmasÄ± gerekir. MÃ¼Återi rÄ±zasÄ± tesisi tamamlandÄ±ktan sonra, HBHS sorgulamak istediÄi hesaba ait verileri ilgili eriÅim adresi Ã¼zerinden sorgular. \n \n \n Åekil 10: Hesap Bilgisi Hizmeti Ãst DÃ¼zey AkÄ±ÅÄ± \n Åekil-10âda sunulan hesap bilgisi hizmeti 5 temel akÄ±Åtan oluÅur: \n 0.\tMÃ¼Återinin hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:  ÃHK ÃBHS mobil uygulama ya da web sitesinden hesap bilgilerine eriÅim iÅlemini baÅlatÄ±r. \n 1.\tHesap Bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n hazÄ±rlanmasÄ±: \n HBHS, âhesap/kart bilgilerine eriÅimâ iÃ§in mÃ¼Återi rÄ±zasÄ± tesisi amacÄ±yla HHSâdeki hesap bilgisi rÄ±zasÄ± eriÅim adresine bir POST isteÄinde bulunur ve bir hesap bilgisi rÄ±zasÄ± nesnesi oluÅturur. HHS hesap bilgisi rÄ±zasÄ± nesnesi iÃ§in biricik tanÄ±mlayacÄ± dÃ¶ner (RÄ±zaNo). Hesap bilgisi rÄ±zasÄ±, mÃ¼Återinin HBHSânin hesap/kart bilgilerine eriÅim izin verdiÄi alanlarÄ± iÃ§in 9.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± baÅlÄ±ÄÄ±nda incelenebilir. \n 2.\tHesap bilgisi hizmeti mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi: \n HHS, Hesap Bilgisi RÄ±zasÄ± servisi ile ÃHK Ã¶zelinde âYetki bekleniyorâ statÃ¼sÃ¼nde bir rÄ±za nesnesi hazÄ±rlar. HHS, GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda hesap bilgisi rÄ±zasÄ± nesnesinin yetkilendirildiÄini belirtmek iÃ§in RÄ±za Durumunu âRÄ±za Yetkilendirildiâ olarak gÃ¼nceller. Nesne yetkilendirildikten sonra HHS nesne ile bir eriÅim belirteci (access token) iliÅkilendirir, RÄ±za Durumunu âYetki KullanÄ±ldÄ±â yapar ve bu belirteci HBHSâye geri dÃ¶ner.  BÃ¶ylece mÃ¼Återi rÄ±za tesisi saÄlanmÄ±Å olur. \n Hesap bilgisi rÄ±zasÄ±na iliÅkin temel ilkeler ÅunlardÄ±r: \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de Yetki Bekleniyor, Yetkilendirildi, Yetki KullanÄ±ldÄ± statÃ¼sÃ¼nde 1 rÄ±zasÄ± olabilir. \n MÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± ÃHK ile HBHS arasÄ±nda belirlenir. Bu nedenle mÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± HHS ekranÄ±nda deÄiÅtirilmemelidir. \n ÃHK, hesap ve kart eriÅim izni ayrÄ±ntÄ±larÄ±nÄ± yalnÄ±zca bir bÃ¼tÃ¼n olarak yetkilendirebilir veya geri alabilir. \n MÃ¼Återi rÄ±zasÄ± tesisi esnasÄ±nda, mÃ¼Återi HHS arayÃ¼zÃ¼nde eriÅim iÃ§in yetkilendirecek hesaplarÄ± ve kartlarÄ± seÃ§er. \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN hizmeti sunmayabildikleri iÃ§in hesap referansÄ± ile akÄ±ÅlarÄ±nÄ± kurgulayabilirler. YÃS Ã¶nyÃ¼zlerinde yapÄ±lan bilgilendirmelerde, IBAN harici hesap referansÄ± ile iÅlem yapÄ±labilmesine dikkat edilmelidir. \n \n 2.1\tHesap bilgisi rÄ±zasÄ±nÄ±n sorgulanmasÄ±:  MÃ¼Återi rÄ±zasÄ±  GET/hesap-bilgisi-rizasi/{RizaNo}  Ã§aÄrÄ±sÄ± yapÄ±larak sorgulanÄ±r. \n 2.2\tHesap bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n iptali:  MÃ¼Återi rÄ±zasÄ±  DELETE/hesap-bilgisi-rizasi/{RizaNo}

16  Ã§aÄrÄ±sÄ± yapÄ±larak iptal edilir. \n 3.1\tHesap bilgilerinin alÄ±nmasÄ±:  Hesap bilgileri ilgili kaynaÄa (hesaplar, bakiye, iÅlemler) GET isteÄi yapÄ±larak gerÃ§ekleÅtirilir. HBHS, mÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden sonrasÄ±nda (geÃ§erli bir eriÅim belirticine sahip olduÄunda) Ã¶ncelikle  GET/hesaplar  Ã§aÄrÄ±sÄ± yapacaktÄ±r. \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±) mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin HBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini (Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n 4.\tKart bilgilerinin alÄ±nmasÄ±:   Kart bilgileri ilgili kaynaÄa (kartlar, kart detayÄ±, kart hareketleri) GET isteÄi yapÄ±larak gerÃ§ekleÅtirilir. HBHS, mÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden sonrasÄ±nda (geÃ§erli bir eriÅim belirticine sahip olduÄunda) Ã¶ncelikle  GET/kartlar  Ã§aÄrÄ±sÄ± yapacaktÄ±r. \n Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n hesap-bilgisi-rizasi \n POST \n /hesap-bilgisi-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n HesapBilgisiRizasiIstegi \n HesapBilgisiRizasi \n \n \n 2 \n erisim-belirteci  (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n \n HesapBilgisiRizasi \n \n \n 2.2 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD-KoÅullu) \n \n \n \n \n \n \n 3.1 \n hesaplar \n GET \n /hesaplar \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n HesapBilgileri(birden Ã§ok hesap) \n \n \n 3.2 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n HesapBilgileri(tek  hesap) \n \n \n 3.3 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n BakiyeBilgileri(tek  hesap) \n \n \n 3.4 \n bakiye \n GET \n /bakiye \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n BakiyeBilgileri(birden Ã§ok hesap) \n \n \n 3.5 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n IslemBilgileri (tek hesap) \n \n \n 4 \n kartlar \n GET \n /kartlar \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n KartBilgileri(birden Ã§ok kart) \n \n \n 4.1 \n kartlar \n GET \n /kartlar/{kartRef} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n KartBilgileri(tek kart) \n \n \n 4.2 \n kart-detay \n GET \n /kartlar/{kartRef}/kart-detay \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Filtreleme \n \n KartDetayBilgileri \n \n \n 4.3 \n kart-hareketleri \n GET \n /kartlar/{kartRef}/kart-hareketleri \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n KartHareketleri \n \n \n \n Tablo 11: Hesap/Kart Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n ADIM 0: ÃHK'nÄ±n hesap/kart bilgilerine eriÅim iÃ§in talepte bulunmasÄ±: \n ÃHK, HBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) hesap/kart bilgilerine eriÅim iÃ§in talepte bulunur. \n 9.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n Bu dokÃ¼manda belirtilen hesap bilgisi hizmeti ibaresi hem hesap hem de kart rÄ±za sÃ¼reÃ§lerini kapsamaktadÄ±r. \n Bu API Ã§aÄrÄ±sÄ± HBHS'nin HHS'de yeni bir âHesapBilgisiRizasiâ nesnesi oluÅturmasÄ±nÄ± ve nesneye eriÅmek iÃ§in benzersiz bir rÄ±za numarasÄ± ({rizaNo}) dÃ¶nÃ¼lmesini saÄlar. \n API Ã§aÄrÄ±sÄ±nÄ±n baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± yeterlidir.\nBaÅarÄ±yla oluÅturulan hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n rÄ±za durumu âYetki Bekleniyorâ olarak dÃ¼zenlenir.\nÃHK daha Ã¶nce aldÄ±ÄÄ± rÄ±zaya iliÅkin er

16iÅim tarihleri, izin tÃ¼rlerini ve hesap bilgilerini gÃ¼ncellemek isterse, HBHS Ã¶nce HHS nezdindeki rÄ±zayÄ± iptal etmeli ve sonrasÄ±nda yeni bir rÄ±za talebinde bulunmalÄ±dÄ±r.\n \n \n Åekil 11: Hesap/Kart Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n POST /hesap-bilgisi-rizasi isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âHesapBilgisiRizasÄ±Istegiâ nesnesi (Tablo-12) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âHesapBilgisiRizasiâ (Tablo-13) nesnesi oluÅturulur. \n  POST /hesap-bilgisi-rizasi \n Bu dokÃ¼manda belirtilen hesap bilgisi rÄ±zasÄ± ibaresi hem hesap hem de kart rÄ±za sÃ¼reÃ§lerini kapsamaktadÄ±r. \n BaÅarÄ±lÄ± Ä°stek: \n Ä°STEK: \n HBHS, bu API eriÅim adresinden HHSâye yeni bir HesapBilgisiRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n HBHS, ÃHKânÄ±n hesap/kart bilgilerine yÃ¶nelik rÄ±za baÅlatma isteÄi olduÄunu HHSâye bildirir. YÃS'ler sÃ¼rÃ¼m 2.0 iÃ§in Hesap Bilgisi RÄ±zasÄ± isteÄi gÃ¶nderdiÄinde HHS'nin ÃHK'yÄ± yÃ¶nlendireceÄi mobil uygulama iÃ§erisinde sÃ¼rÃ¼m 2.0 deÄiÅikliklerini iÃ§eren, kart bilgilerinin seÃ§imini yapacaklarÄ± sÃ¼rÃ¼mÃ¼n yÃ¼klÃ¼ olmamasÄ± durumunda HHS'ler tarafÄ±ndan  TR.OHVPS.Business.CustomerMobileApplicationHasOlderVersion  hatasÄ± verilebilir. \n HBHS, ÃHKânÄ±n, HBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n API dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk ve uzunluk kontrollerini yapar.(Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  âTR.OHVPS.Resource.InvalidFormatâ  hata kodu iletilmeli ve fieldErrors dolu olacak Åekilde hatalÄ± alanÄ± belirten detaylÄ± aÃ§Ä±klama gÃ¶nderilmelidir. InvalidFormat hata kodlarÄ±nda fieldErrors iÃ§eriÄi gÃ¶nderilmeli ve anlaÅÄ±lÄ±r aÃ§Ä±klama ile message, messageTr alanlarÄ± doldurulmasÄ± zorunludur. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; YÃS API ile alÄ±nan temel adres bilgilerinde yer alan yÃ¶nlendirme adresleri ile hesap bilgisi rÄ±zasÄ± nesnesi iÃ§erisinde yer alan YÃS  adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  âTR.OHVPS.Business.TPPRedirectionAddressMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; kimlik bilgileri nesnesinde iletilen kimlik bilgileri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.(Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  âTR.OHVPS.Business.CustomerNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Kurumsal mÃ¼Återi ile baÅlatÄ±lan rÄ±zada yer alan mÃ¼Återi bilgisinin karÅÄ± kurumda Kurumsal mÃ¼Återi deÄil; bireysel mÃ¼Återi olduÄu durumda âTR.OHVPS.Business.BusinessCustomerMismatchâ hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Bir ÃHK'nÄ±n 1 YÃS iÃ§in aktif tek bir rÄ±zasÄ± olabilir. ÃHKânÄ±n  âYetkilendirildiâ ve âYetki KullanÄ±ldÄ±â statÃ¼sÃ¼nde rÄ±zasÄ± varken yeni bir rÄ±za isteÄi gÃ¶nderdiÄinde HHS tarafÄ±ndan  TR.OHVPS.Business.ConsentAlreadyExists  hatasÄ± dÃ¶nÃ¼lÃ¼r.  GÃ¼ncelleme isteÄi gÃ¶ndermesi durumunda ise iÅletilmesi gereken akÄ±Ålar âRÄ±za DurumlarÄ±â baÅlÄ±ÄÄ±ndan kontrol edilmelidir. \n Hesap bilgi hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n âAÃ§Ä±k BankacÄ±lÄ±k Kanal Yetkiâ tanÄ±mÄ± yok ise  âTR.OHVPS.Business.OpenBankingChannelClosedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n Hesap bilgi hizmeti rÄ±za isteÄinde 01 ya da 07 izin tÃ¼rÃ¼ olmak zorundadÄ±r. HHS tarafÄ±ndan izin tÃ¼rÃ¼ iÃ§erisinde 01 ya da 07 varlÄ±k durumu kontrol edilir. OlmamasÄ± durumunda  \"TR.OHVPS.Business.IncorrectPermissionTypeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap bilgi hizmeti rÄ±za isteÄinde 01 izin tÃ¼rÃ¼ bulunmuyor ise 02, 03, 04, 05 ya da 06 izin tÃ¼rÃ¼ olmamalÄ±dÄ±r. 01 izin tÃ¼rÃ¼ bulunmadÄ±ÄÄ±nda 02, 03, 04, 05 ya da 06 izin tÃ¼rlerinden biri ya da birkaÃ§Ä± gÃ¶nderildiÄinde  \"TR.OHVPS.Business.IncorrectPermissionTypeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap bilgi hizmeti rÄ±za isteÄinde 07 izin tÃ¼rÃ¼ bulunmuyor ise 08 ya da 09 izin tÃ¼rÃ¼ olmamalÄ±dÄ±r. 07 izin tÃ¼rÃ¼ bulunmadÄ±ÄÄ±nda 08 ya da 09 izin tÃ¼rlerinden biri ya da ikisi gÃ¶nderildiÄinde  \"TR.OHVPS.Business.IncorrectPermissionTypeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n ÃHK, HHS'de olacak bakiye deÄiÅikliklerinden anlÄ±k haberdar olmak istiyor ise 06-AnlÄ±k Bakiye Bildirimi izin tÃ¼rÃ¼ seÃ§imi ile rÄ±za baÅlatmasÄ± gereklidir. 03-Bakiye Bilgisi izin tÃ¼rÃ¼ ile birlikte seÃ§ilmesi gereklidir. 06 izin tÃ¼rÃ¼ seÃ§ilip 03 izin tÃ¼rÃ¼ seÃ§ilmediÄi durumda  âTR.OHVPS.Business.IncorrectPermissionTypeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°zin tÃ¼rÃ¼ â06: AnlÄ±k Bakiye Bildirimiâ seÃ§ilmiÅ ise HHS, YÃS'Ã¼n KAYNAK_GUNCELLENDI olay tipinde olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. Olay abonelik kaydÄ± bulunmuyor ise  âTR.OHVPS.Business.EventSubscriptionNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap bilgi hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n izin verecek hesap ya da kartÄ± yok ise  âTR.OHVPS.Business.ProductNotSuitableâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Ä°ki Ã¼rÃ¼nden biri var ise baÅarÄ±lÄ± yanÄ±t dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n EriÅimin GeÃ§erli OlduÄu Son Tarih bilgisi mÃ¼Återi baÄÄ±msÄ±z alabileceÄi minimum deÄer : RÄ±za tarihi + 1 gÃ¼ndÃ¼r. Maksimum rÄ±za sÃ¼resi bireysel mÃ¼Återiler iÃ§in 6 ay, Kurumsal/TÃ¼zel mÃ¼Återiler iÃ§in 12 ay olacaktÄ±r. Bireysel mÃ¼Återiler iÃ§in 6 aydan fazla, kurumsal mÃ¼Återiler iÃ§in ise 12 aydan fazla iletildiÄi durumda  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, hesap bilgisi rÄ±zasÄ± verilmesinden  geÃ§miÅe  dÃ¶nÃ¼k en fazla 12 ay olabilmektedir. 12 aydan fazla gÃ¶nderilmesi durumunda  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, hesap bilgisi rÄ±zasÄ± verilmesinden  geleceÄe  dÃ¶nÃ¼k en fazla 12 ay sonrasÄ± olabilmektedir. 12 aydan fazla gÃ¶nderilmesi durumunda  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  âTR.OHVPS.Business.DecoupledAuthenticationNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir. \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD ile baÅlatÄ±lan hesap bilgi hizmeti rÄ±za isteÄinde HHS, YÃSâÃ¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  âTR.OHVPS.Business.EventSubscriptionNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  âTR.OHVPS.Business.CustomerInfoMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda hata mesajÄ± vermelidir. HHS tarafÄ±ndan  âTR.OHVPS.Business.CustomerMobileApplicationNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, benzersiz âRizaNoâ ile âHesapBilgisiRizasiâ nesnesi oluÅturur ve HBHSâye dÃ¶ner. \n HHS, HesapBilgisiRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n Tablo 12: âHesapBilgisiRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ãnceki RÄ±za No \n oncekiRizaNo \n AN1..128 \n K \n HesapBilgisiRÄ±zasiIstegi nesnesinin gÃ¼ncelleme sebebiyle oluÅturulmasÄ± esnasÄ±nda ÃHK'nÄ±n gÃ¼ncelleme yapmak istediÄi mevcut rÄ±za no bilgisi. RÄ±za gÃ¼ncelleme yapÄ±lmak istendiÄinde gÃ¶nderilmesi zorunludur. \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. Hata durumunda TR.OHVPS.Connection.InvalidASPSP hata kodunu dÃ¶ner. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda TR.OHVPS.Connection.InvalidTPP hata kodunu dÃ¶ner. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Yetkilendirme yÃ¶ntemi, HBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.   Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.OHKTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r.   TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n \n Hesap/Kart Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n \n >Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih.   MÃ¼Återi YÃS ekranÄ±ndan bu deÄeri belirleyebilir. Bireysel mÃ¼Återiler iÃ§in rÄ±za sÃ¼resi 6 ay, Kurumsal/TÃ¼zel mÃ¼Återiler iÃ§in 12 ay olacaktÄ±r.    Bireysel MÃ¼Återiler iÃ§in varsayÄ±lan deÄer : RÄ±za verilen tarih + 6 ay   Kurumsal MÃ¼Återiler iÃ§in varsayÄ±lan deÄer : RÄ±za verilen tarih + 12 ay  Bireysel MÃ¼Återiler iÃ§in alabileceÄi maksimum deÄer : RÄ±za tarihi + 6 ay  Kurumsal MÃ¼Återiler iÃ§in alabileceÄi maksimum deÄer : RÄ±za tarihi + 12 ay    MÃ¼Återi baÄÄ±msÄ±z alabileceÄi minimum deÄer : RÄ±za tarihi + 1 gÃ¼n    ÃrneÄin  04/02/2023âde minimum 05/02/2023 seÃ§ilebilir. Bu durumda yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saati 00:00:00 olduÄu kabul edildiÄi iÃ§in; erisimIzniSonTrh deÄeri 2023-02-06T00:00:00+03:00 olmalÄ±dÄ±r.  HHS rÄ±za onay ekranlarÄ±nda YÃS'ten iletilen eriÅim izni son tarihi yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saati olarak iletildiÄinden ÃHK'ya gÃ¶sterilecek tarih eriÅim izninin biteceÄi gÃ¼n olarak gÃ¶sterilmelidir.  ÃrneÄe istinaden; ÃHK YÃSâde 05/02/2023 seÃ§miÅ ise HHS rÄ±za onay ekranÄ±nda 06/02/2023 gÃ¶rmemeli, bu iki tarihin aynÄ±, yani 05/02/2023 olacak Åekilde gÃ¶sterilmesi gerekmektedir.      Ãrnek rÄ±za oluÅ zamanÄ±  : 2023-02-04T21:20:20+03:00    1 gÃ¼nlÃ¼k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri:    2023-02-06T00:00:00+03:00 (26 saat 40 sakikalÄ±k rÄ±za vermiÅ oluyor.)    7 gÃ¼nlÃ¼k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri:  2023-02-12T00:00:00+03:00    1 aylÄ±k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri :   2023-03-05-T00:00:00+03:00 \n Bu alanda bir deÄer bulunmadÄ±ÄÄ± durumda HHS hata dÃ¶nmelidir. \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geÃ§miÅe dÃ¶nÃ¼k en fazla 12 ay olabilir, daha eski olmamasÄ± gerekir.   VarsayÄ±lan deÄeri rÄ±za verilen tarih (iÅlem zamanÄ±) â 12 aydÄ±r.   ÃHK bu alana bir deÄer giriÅi saÄlamÄ±Å ise zaman bilgisi Ã¼retilirken ekrandan girilen tarihe 00:00:00 zaman bilgisi eklenmelidir. ÃHK deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.   Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  - 12 ay    Maksimum tarih: RÄ±zanÄ±n veriliÅ tarihi +  12 ay    Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve  Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geleceÄe dÃ¶nÃ¼k en fazla 12 ay sonrasÄ± olabilir, daha ileri bir tarih olmamasÄ± gerekir.   VarsayÄ±lan deÄeri: RÄ±za verilen tarih + 12 aydÄ±r. ÃHK bu alana bir deÄer giriÅi saÄlamÄ±Å ise girdiÄi tarihe 1 gÃ¼n eklenir ve yeni gÃ¼nÃ¼n ilk saati kabul edilen 00:00:00 saat bilgisini ekler.  ÃHK bu alana bir deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.  Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  â 12 ay  Maksimum tarihi :  RÄ±zanÄ±n veriliÅ tarihi + 12 ay   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. EÄer dolu gÃ¶nderilirse HHS tarafÄ±ndan uygun hata mesajÄ± iletilmelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve Ä°Ålem Sorgulama BitiÅ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez.   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n BaÅarÄ±lÄ± YanÄ±t: \n Tablo 13: HesapBilgisiRizasi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Ãnceki RÄ±za No \n oncekiRizaNo \n AN1..128 \n K \n HesapBilgisiRÄ±zasiIstegi nesnesinin gÃ¼ncelleme sebebiyle oluÅturulmasÄ± esnasÄ±nda ÃHK'nÄ±n gÃ¼ncelleme yapmak istediÄi mevcut rÄ±za no bilgisi. RÄ±za gÃ¼ncelleme yapÄ±lmak istendiÄinde gÃ¶nderilmesi zorunludur. Ä°stekte gÃ¶nderilen deÄer aynÄ± Åekilde yanÄ±tta dÃ¶nÃ¼lmelidir. \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. Ãrn; hesap bilgi rÄ±zasÄ±nÄ±n tesisine dair ilk istek mesajÄ±na dÃ¶nÃ¼Åte âB: Yetki Bekleniyorâ deÄerini almasÄ± beklenir. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄ

16u durumda zorunludur. \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir.  TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde\tGKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.  HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir. RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Hesap/Kart Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n > Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HBHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi baÅlangÄ±Ã§ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi bitiÅ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n > AyrÄ±ntÄ± Bilgi \n ayrBlg \n Kompleks: AyrintiBilgi \n Ä° \n \n \n \n > ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n Ä°zinler \n Bir hesap bilgisi rÄ±zasÄ± kaynaÄÄ± Ã§aÄrÄ±sÄ±na yanÄ±t olarak dÃ¶ndÃ¼rÃ¼len verileri sÄ±nÄ±rlamak iÃ§in izin kodlarÄ± kullanÄ±lÄ±r. \n Hesap ve karta dair tÃ¼m bilgiler hesap bilgisi rÄ±zasÄ± altÄ±nda alÄ±nacaktÄ±r. Ä°zin tÃ¼rleri hesap ve karta gÃ¶re ayrÄ±ÅmaktadÄ±r. \n \n Temel Hesap Bilgisi \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n Bakiye Bilgisi \n Temel Ä°Ålem (Hesap Hareketleri) Bilgisi \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n AnlÄ±k Bakiye Bildirimi \n Temel Kart Bilgisi \n DetaylÄ± Kart Bilgisi \n AyrÄ±ntÄ±lÄ± Kart Ä°Ålem Bilgisi \n \n ÃHKâya sunulacak seÃ§imler ve kurallarÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r. \n \n \n \n SeÃ§im \n Kural \n \n \n \n \n Temel Hesap Bilgisi \n ÃHK seÃ§im yapabilir. Temel Kart Bilgisi seÃ§ilmediyse bu izin tÃ¼rÃ¼nÃ¼n seÃ§imi zorunludur. \n \n \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Bakiye Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Temel Ä°Ålem (Hesap Hareketleri)  Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n ÃHK seÃ§im yapabilir. AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi seÃ§imi Temel Ä°Ålem Bilgisi seÃ§imini kapsar. (AyrÄ±ntÄ±lÄ± Ä°Ålem bilgisi seÃ§ildiÄinde Temel Ä°Ålem Bilgisi de seÃ§ili olmalÄ±dÄ±r.) \n \n \n AnlÄ±k Bakiye Bildirimi \n Bakiye Bilgisi izin tÃ¼rÃ¼ ile birlikte seÃ§ilmesi gereklidir. ÃHK, HHS'de olacak bakiye deÄiÅikliklerinden anlÄ±k haberdar olmak istiyor ise bu izin tÃ¼rÃ¼ seÃ§imi ile rÄ±za baÅlatmasÄ± gereklidir. \n \n \n Temel Kart Bilgisi \n ÃHK seÃ§im yapabilir. Temel Hesap Bilgisi seÃ§ilmediyse bu izin tÃ¼rÃ¼nÃ¼n seÃ§imi zorunludur. \n \n \n DetaylÄ± Kart Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n AyrÄ±ntÄ±lÄ± Kart Ä°Ålem Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n \n AÅaÄÄ±daki durumlarda, izin kombinasyonlarÄ±na izin verilmez. HHS, bu hesap eriÅim onaylarÄ±nÄ± 400 (HatalÄ± Ä°stek) yanÄ±t ko

16duyla reddetmelidir: \n \n Ä°zin dizisinin herhangi bir izin tÃ¼rÃ¼ iÃ§ermemesi durumu, \n Ä°zin dizisinde HHS tarafÄ±ndan desteklenmeyen bir izin kodunun yer almasÄ± durumu \n 9.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi \n \n \n Åekil 12: Hesap Bilgisi ÃHK RÄ±zasÄ±nÄ±n Tesisi \n RÄ±za tesisinin baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± ve ardÄ±ndan mÃ¼Återinin HHS tarafÄ±ndan yÃ¶nlendirmeli veya ayrÄ±k GKD ile doÄrulanmasÄ± gerekir. HHS'de oluÅturulan ve rÄ±za durumu âYetki Bekleniyorâ olan bir hesap bilgisi rÄ±zasÄ±, GKD sonrasÄ± âYetkilendirildiâ statÃ¼sÃ¼ne gÃ¼ncellenir. HBHS, eriÅim saÄlayacaÄÄ± hesaplarÄ± ve kartlarÄ± hesap bilgisi rÄ±zasÄ±nÄ±n tesisinden Ã¶nce seÃ§er. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda, HBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n \n HBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n \n \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n ÃHKâyÄ± doÄrularsa, \n \n \n ÃHK HBHS Ã¼zerinden iÅlem yapÄ±lmasÄ±na izin vereceÄi hesap/kart seÃ§imini y

16apar. HBHS Ã¼zerinden ÃHKânÄ±n verdiÄi izin bilgilerini ve eriÅim izninin baÅlangÄ±Ã§/bitiÅ tarihi bilgilerini, HHS'ler bilgilendirme amaÃ§lÄ± ÃHKâya gÃ¶sterir. \n \n \n RÄ±za gÃ¼ncelleme akÄ±ÅÄ± ile baÅlatÄ±lan rÄ±za isteklerinde mevcut rÄ±za iÃ§erisinde seÃ§ili olan hesap/kart bilgileri ÃHK'ya HHS ekranlarÄ±nda aynÄ± Åekilde seÃ§ili olarak getirilmelidir. ÃHK'lar mevcut rÄ±za iÃ§erisinde izin vermiÅ olduÄu hesap/kart bilgilerini seÃ§ili olarak gÃ¶rÃ¼ntÃ¼leyip yeni rÄ±za iÃ§in izin vermek istediÄi hesap/kartlarÄ±n seÃ§imini gÃ¼ncelleyebilmelidir. \n RÄ±za gÃ¼ncelleme sÃ¼recinde;  ÃHKânÄ±n HHSâdeki mevcut rÄ±zasÄ± kapsamÄ±nda YÃSâten gelen rÄ±za izin tÃ¼rlerine gÃ¶re listeleme yapÄ±lmalÄ±dÄ±r. 01,02,03,04,05,06 seÃ§ildiyse hesaplarÄ±n; 07,08,09 seÃ§ildiyse kartlarÄ±n HHSâde listelenmesi gerekmektedir. ÃrneÄin: ÃHKânÄ±n mevcut rÄ±zasÄ±nda hesaplar (01,02,03 rÄ±za tÃ¼rlerinin seÃ§ili olsun) iÃ§in hesap bilgisi rÄ±zasÄ± verilmiÅ olsun eÄer YÃSâten rÄ±za gÃ¼ncelleme kapsamÄ±nda 01,02, 07,08 rÄ±za tÃ¼rleri geldiÄi durumda HHSânin mevcut hesap rÄ±zasÄ±nÄ± ve doÄal olarak hesaplarÄ± listelemesi ek olarak da karta ait rÄ±za tÃ¼rleri seÃ§ildiÄinde kartlarÄ±n listelenmesi gerekecektir. Ancak, ÃHKânÄ±n mevcut rÄ±zasÄ±nda hesaplar (01,02,03 rÄ±za tÃ¼rlerinin seÃ§ili olsun) iÃ§in hesap bilgisi rÄ±zasÄ± verilmiÅ olsun eÄer YÃSâten rÄ±za gÃ¼ncelleme kapsamÄ±nda  07,08, 09 rÄ±za tÃ¼rleri geldiÄi farz edildiÄinde HHSânin mevcut hesap rÄ±zasÄ±nÄ± gÃ¶stermemesi ve sadece karta ait rÄ±za tÃ¼rleri seÃ§ildiÄi iÃ§in kartlarÄ± listelemesi gerekecektir. \n \n \n HHS hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=H&drmKod=zzz\n \n \n \n ÃHKâyÄ± doÄrulayamazsa, \n \n \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I &rizaNo=yy&rizaTip=H&rizaIptDtyKod=11&drmKod=zzz\n \n \n \n \n \n \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda, HHS, ÃHKânÄ±n hesap bilgisi hizmetini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister. \n \n AyrÄ±k akÄ±Å HBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek hesap bilgisi rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, Ã¶deme hizmeti kullanÄ±cÄ±sÄ±nÄ± doÄrular. \n ÃHK verdiÄi izin tipi dahilinde bilgileri paylaÅÄ±lacak olan hesaplarÄ± seÃ§er. RÄ±za gÃ¼ncelleme akÄ±ÅÄ± ile baÅlatÄ±lan isteklerde ÃHK mevcutta vermiÅ olduÄu hesap ve kartlarÄ± seÃ§ili olarak gÃ¶rÃ¼ntÃ¼ler. Ä°lgili seÃ§imler Ã¼zerinde gÃ¼ncelleme saÄlayarak onay verir. \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS,  hesap bilgisi rÄ±zasÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. RÄ±za tesisi saÄlanmÄ±Å olur. \n 9.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ± \n GET /hesap-bilgisi-rizasi/{rizaNo} \n ÃHK, HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir veya ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.  Bu durumlarda HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir HesapBilgisiRizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. \n \n YÃS sadece kendi uygulamasÄ± Ã¼zerinden verilmiÅ hesap bilgi rÄ±zasÄ±nÄ± sorgulayabilir. YÃS'e ait olmayan bir rÄ±za ile sorgulama yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'e ait rÄ±za sorgulama yapÄ±lÄ±rken ilgili rÄ±za kaydÄ± bulunamaz ise  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 13âde belirtilen âHesapBilgisiRizasiâ nesnesini dÃ¶nmektedir. \n Durum \nHesapBilgisiRizasi kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n \n Yetki Bekleniyor \n \n \n Yetkilendirildi \n \n \n Yetki KullanÄ±ldÄ± \n \n \n Yetki S

16onlandÄ±rÄ±ldÄ± \n \n \n Yetki Ä°ptal \n \n \n Hesap bilgisi rÄ±zasÄ± sonlandÄ±rÄ±ldÄ± ve iptal statÃ¼sÃ¼nde olan rÄ±za'larÄ±n gÃ¼ncellenme zamanÄ±ndan(gnclZmn) 6 ay sonrasÄ±na kadar sorgulanabilir olmasÄ± beklenmektedir. HHS'ler ilgili sÃ¼re sonrasÄ±nda yapÄ±lacak rÄ±za sorgularÄ±na  \"TR.OHVPS.Resource.NotFound\"  uyarÄ±sÄ± verebilir. YÃS'ler tarafÄ±ndan iptal ve sonlandÄ±rÄ±ldÄ± statÃ¼sÃ¼nde olan rÄ±zalar iÃ§in sorgulama yapmamalÄ±dÄ±r. \n 9.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali \n \n \n \n Åekil 13: Hesap Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n Geri AlÄ±nmasÄ± \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \n DELETE /hesap-bilgisi-rizasi Ã§aÄrÄ±sÄ±, bir HBHS'nin Ã¶nceden oluÅturulmuÅ bir hesap eriÅim rÄ±zasÄ±nÄ± (yetkili olsun veya olmasÄ±n) silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, HBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \nBu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin HBHS Ã¼zerinden hesap bilgisi rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki hesap bilgisi rÄ±zasÄ± nesnesinin silinmesini saÄlar. \n \n RÄ±za durumunun K olduÄu durumlarda eriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±za, silinen rizaNo bilgisi ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za Ä°ptali API'sinde ilgili rÄ±za kaydÄ± bulunamaz ise  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S veya Yetki Ä°ptal - I ise  \"TR.OHVPS.Resource.ConsentRevoked\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n MÃ¼Återinin HBHSânin veri eriÅim iznini iptal etmesi durumunda HBHS, HHSâde mevcut olan HesapBilgisiRizasi kaynaÄÄ±nÄ± pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. HBHS ayrÄ±ca, sisteminden Hesap/Kart EriÅim Ä°zni kaynaklarÄ±nÄ± da temizlemelidir. \nSÃ¶z konusu silme iÅlemi, kayÄ±tlarÄ±n statÃ¼sÃ¼nÃ¼n pasife Ã§ekilmesi ile gerÃ§ekleÅtirilmelidir. SÃ¶z konusu kayÄ±tlar, denetim izlerinin oluÅturulmasÄ± ve saklanmasÄ±na iliÅkin ikincil dÃ¼zenleme hÃ¼kÃ¼mleri kapsamÄ±nda gÃ¼venli Åekilde tutulmalÄ±dÄ±r. \nServis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r. \nÃHK rÄ±zasÄ± baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ olarak gÃ¼ncellenir ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir. \nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir: \nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (HBHS) \n 9.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ± \n    \n \n   \n Åekil 14: Hesap Bilgilerinin AlÄ±nmasÄ± \n Ä°STEK: \nMÃ¼Återi rÄ±zasÄ± tesis edilmiÅ kullanÄ±cÄ± iÃ§in HBHS API eriÅim adresinden HHSâye eriÅilebilir hesap bilgilerini GET isteÄi ile sorgular: \n \n Parametrede yer alan deÄerlerin doÄru gÃ¶nderildiÄi kontrol edilir. HatalÄ± gÃ¶nderilmesi durumunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Parametrede yer alan deÄerler gÃ¶nderilmediÄi durumda parametredeki varsayÄ±lan deÄerler ile hesap bilgileri dÃ¶nÃ¼lÃ¼r. VarsayÄ±lan deÄerler Tablo 14'de belirtilmiÅtir. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n /hesaplar/{hspRef} ile yapÄ±lan istekte;\n \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen hspRef'ler iÃ§in, hesap bilgisi sorgulanan hspRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili hspRef bulunamaz  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n RÄ±za durumu kontrol edilir.\n \n RizaDurumu B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'Ã¼n;

16 RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda hesap bilgileri servisini Ã§aÄÄ±rmamasÄ± beklenir. Bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âYetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n HHS tarafÄ±ndan ÃHKânÄ±n â01: Temel Hesap Bilgisiâ izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 01 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, \"HesapBilgileri\" nesnesini oluÅturur ve HBHSâye dÃ¶ner. \n \n Hesap bilgisi rÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinden herhangi bir hesabÄ±n kapatÄ±lmasÄ± ya da pasife alÄ±nmasÄ± durumunda YÃS tarafÄ±ndan yapÄ±lan hesap isteÄine HHS tarafÄ±ndan hesap bilgisi dÃ¶nÃ¼lmelidir. RÄ±za iÃ§erisinde tek bir hesap olmasÄ± halinde ilgili hesabÄ±n kapatÄ±lmasÄ± durumunda rÄ±za 09 iptal detay kodu ile iptal edilmelidir.\nKapalÄ± hesap iÃ§in TR.OHVPS.DataCode.HspDrm veri tÃ¼rÃ¼nden KAPALI deÄeri ile, pasif hesap iÃ§in TR.OHVPS.DataCode.HspDrm veri tÃ¼rÃ¼nden PASIF deÄeri ile dÃ¶nÃ¼lmelidir. \n 9.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ± \n GET /hesaplar ve GET /hesaplar/{hspRef} \n Bu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bilgileri sorgulanÄ±r. Hesap bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re (Temel Hesap Bilgisi veya DetaylÄ± Hesap Bilgisi) yanÄ±tÄ±nda dÃ¶nÃ¼len HesapBilgileri nesnesinin iÃ§eriÄi deÄiÅir. Tablo 15âte HesapBilgileri nesnesinin iÃ§eriÄi verilmiÅtir. \n Hesap Bilgisi Sorgu ÃrneÄi (TÃ¼m Hesaplar) =  /hesaplar \nHesap Bilgisi Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef} \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 14: Hesap Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa NumarasÄ± \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 15: âHesapBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n Hesap Temel \n hspTml \n Kompleks: HesapTemel \n Z \n Temel Hesap Bilgileri (Temel Hesap Bilgisi varsayÄ±lan izin tÃ¼rÃ¼ olduÄundan Hesap Temel nesnesi zorunlu olarak yanÄ±tta bulunur) \n \n \n > Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hs

16pRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n > Hesap NumarasÄ± \n hspNo \n AN26 \n K \n EÄer varsa Ã¶deme hesabÄ±na ait IBAN bilgisi \n \n \n > Hesap Sahibi ÃnvanÄ± \n hspShb \n AN3..140 \n Z \n Hesap sahibi ya da hesap sahiplerinin ad-soyadÄ±, ticari Ã¼nvanÄ± \n \n \n > Åube AdÄ± \n subeAdi \n AN3..50 \n K \n EÄer varsa Ã¶deme hesabÄ±nÄ±n baÄlÄ± olduÄu Åubenin adÄ± \n \n \n > KÄ±sa Ad \n kisaAd \n AN3..50 \n K \n EÄer hesap sahibi hesaba ait bir ad tanÄ±mladÄ±ysa, tanÄ±mlanan hesap adÄ± \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi. \n \n \n > Hesap TÃ¼rÃ¼ \n hspTur \n AN1 \n Z \n HesabÄ±n tÃ¼rÃ¼ (bireysel veya ticari). TR.OHVPS.DataCode.HspTur sÄ±rali veri deÄerlerinden birini alÄ±r. \n \n \n > Hesap Tipi \n hspTip \n AN1..32 \n Z \n HesabÄ±n tipi (VADESÄ°Z, KREDÄ°LÄ° vb.).TR.OHVPS.DataCode.HspTip sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >Hesap ÃrÃ¼n AdÄ± \n hspUrunAdi \n AN1..140 \n Ä° \n HHS tarafÄ±ndan atanmÄ±Å olan Ã¼rÃ¼n adÄ± bilgisidir. HBHS tarafÄ±ndan ÃHKâya gÃ¶sterilmesi kullanÄ±m kolaylÄ±ÄÄ± saÄlayacaktÄ±r. \n \n \n > Hesap Durumu \n hspDrm \n AN5..50 \n Z \n HesabÄ±n durumunu belirtir. TR.OHVPS.DataCode.HspDrm sÄ±ralÄ± veri tÃ¼rlerinden birini alÄ±r. \n \n \n Hesap Detay \n hspDty \n Kompleks: HesapDetay \n K \n Detay Hesap Bilgileri (Temel Hesap Bilgisine ek olarak Detay Hesap Bilgisi izin tÃ¼rÃ¼ de seÃ§ilmiÅse Hesap Detay nesnesi koÅullu olarak yanÄ±tta bulunur) \n \n \n > AÃ§Ä±lÄ±Å Tarihi \n hspAclsTrh \n ISODateTime \n Z \n Belirtilen hesabÄ±n aÃ§Ä±lÄ±Å tarihi. \n 9.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ± \n GET /bakiye ve GET /hesaplar/{hspRef}/bakiye \nBu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bakiyesi sorgulanÄ±r.   Ä°stek Ã§aÄrÄ±sÄ±na dÃ¶nÃ¼len âBakiyeBilgileriâ nesnesi Tablo 17âde verilmiÅtir. \n \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n /hesaplar/{hspRef}/bakiye ile yapÄ±lan istekte;\n \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen hspRef'ler iÃ§in, bakiye sorgusundaki hspRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili hspRef bulunamaz  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n RÄ±za durumu kontrol edilir.\n \n RizaDurumu B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'Ã¼n; RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda hesap bakiye servisini Ã§aÄÄ±rmamasÄ± beklenir. Bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âYetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n Hesap Bakiye SorgulanmasÄ± yapÄ±lÄ±rken HHS tarafÄ±ndan ÃHKânÄ±n â03: Bakiye Bilgisiâ izin tÃ¼rÃ¼ sahipliÄi kontrol edilir. 03 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, \"BakiyeBilgileri\" nesnesini oluÅturur ve HBHSâye dÃ¶ner. \n \n Hesap Bilgisi RÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinde yer alan hesaplardan kapatÄ±lmÄ±Å ya da pasif duruma alÄ±nmÄ±Å olan hesaplar iÃ§in bakiye isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan bakiye bilgisi dÃ¶nÃ¼lmelidir. \n \n Hesap bakiyelerinin gÃ¶sterilmesi sÄ±rasÄ±nda aÅaÄÄ±da verilen Ã¶rnekler gÃ¶zÃ¶nÃ¼nde bulundurulmalÄ±dÄ±r. \n Ãrnek 1 : ÃHK  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  0 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  -1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 2 : ÃHK  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  1 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  2000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 3 : ÃHK  Hesap Bakiye TutarÄ±  1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  0 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 4 : ÃHK  Hesap Bakiye TutarÄ±  1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  1 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  3000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /bakiye?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 16: âBakiyeBilgileriâ Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼

16yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 17: âBakiyeBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hspRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n Bakiye \n bky \n Kompleks:Bakiye \n Z \n \n \n \n > Hesap Bakiye TutarÄ± \n bkyTtr \n AN1..25 \n Z \n HesabÄ±n bakiyesi. Bloke tutar dÃ¼ÅÃ¼lmeden iletilmelidir.   Tutar alanÄ± regex patterni Åu Åekildedir:  '^-?\\d{1,18}$|^-?\\d{1,18}\\.\\d{1,5}$' \n \n \n > Blokeli Tutar \n blkTtr \n AN1..24 \n K \n Varsa hesapta blokeli tutar bilgisi.     Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n > Bakiye Ä°letilme ZamanÄ± \n bkyZmn \n ISODateTime \n Z \n Bakiyenin iletildiÄi zaman bilgisi. \n \n \n > KrediliHesap \n krdHsp \n Kompleks: KrediliHesap \n K \n \n \n \n >> Kredili Mevduat HesabÄ± Bakiyesi \n kulKrdTtr \n AN1..24 \n Z \n Kredili mevduat tutarÄ±. Kredili bir hesap ise zorunlu.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n >> Kredi Dahil GÃ¶stergesi \n krdDhlGstr \n AN1 \n Z \n Kredili bir hesap ise zorunlu. Bakiye tutarÄ±nÄ±n kredi tutarÄ± dahil edilerek ya da edilmeden iletildiÄini gÃ¶sterir.   0: Kredi tutarÄ± dahil edilmeden bakiye bilgisi iletilmesi durumu   1: Kredi tutarÄ± dahil edilerek bakiye bilgisi iletilmesi durumu \n 9.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ± \n GET /hesaplar/{hspRef}/islemler \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 19âda belirtilen \"IslemBilgileri\" nesnesini dÃ¶nmektedir. \n \n Belirli bir hesaba iliÅkin iÅlem bilgileri Tablo 18âdeki istek parametrelerine gÃ¶re sorgulanÄ±r. Parametrede yer alan deÄerlerin doÄru gÃ¶nderildiÄi kontrol edilir. HatalÄ± gÃ¶nderilmesi durumunda  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen hspRef'ler iÃ§in, iÅlemler sorgusundaki hspRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili hspRef bulunamaz  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n RizaDurumu B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'Ã¼n;

16 RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda iÅlemler servisini Ã§aÄÄ±rmamasÄ± beklenir. Bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âYetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n HHS tarafÄ±ndan ÃHKânÄ±n â04: Temel Ä°Ålem (Hesap Hareketleri) Bilgisiâ veya \"05: AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi\" izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 04 veya 05 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ   hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n Hesap Bilgisi RÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinde yer alan hesaplardan kapatÄ±lmÄ±Å ya da pasif duruma alÄ±nmÄ±Å olan hesaplar iÃ§in iÅlemler isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan iÅlemler bilgisi dÃ¶nÃ¼lmelidir. \nÄ°Ålem bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re yanÄ±tta dÃ¶nen IslemBilgileri nesnesinin (Temel Ä°Ålem Bilgisi veya Temel Ä°Ålem Bilgisi ve DetaylÄ± Ä°Ålem Bilgisi) iÃ§eriÄi deÄiÅir. \nÄ°Ålemler servisi hem ÃHKânÄ±n talebi ile YÃS uygulamasÄ± Ã¼zerinden Ã§aÄrÄ±labileceÄi gibi, YÃSâÃ¼n ÃHKâsÄ±z baÅlatabileceÄi otomatik Ã§aÄrÄ±larÄ± ile de yanÄ±t dÃ¶nebilmektedir. \nHHS, iÅlemin sistemsel yapÄ±lÄ±p yapÄ±lmadÄ±ÄÄ±nÄ±, istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir.\nÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \nYÃS, otomatik yapacaÄÄ± sorgularda; \n \n Bireysel ÃHKâlar iÃ§in hesap bazÄ±nda gÃ¼nde en fazla 4 adet baÅarÄ± ile sonuÃ§lanan sorgulama yapabilir. 4 adetten fazla yapÄ±lmasÄ± durumunda  âTR.OHVPS.Connection.ExceededRateâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Kurumsal ÃHKâlar iÃ§in hesap bazÄ±nda saatte en fazla 12 adet baÅarÄ± ile sonuÃ§lanan sorgulama yapabilir. 12 adetten fazla yapÄ±lmasÄ± durumunda  âTR.OHVPS.Connection.ExceededRateâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n HHS, tutacaÄÄ± sayaÃ§ bilgisi ile bu sayÄ±larÄ± kontrol ederek daha fazla sorgulama yapÄ±lmasÄ±na izin vermeyebilir. \n AynÄ± istek parametreleri ile yapÄ±lan sorgu sonucunda dÃ¶necek toplam kayÄ±t sayÄ±sÄ± 100âÃ¼ aÅtÄ±ÄÄ±nda, sayfalama yÃ¶ntemi ile HHSânin cevap dÃ¶nmesi beklenmektedir.  Her bir sayfa iÃ§in iÅlemler servisi tekrar Ã§aÄrÄ±lsa da, bu Ã§aÄrÄ±m HHSânin tuttuÄu sayaÃ§ deÄerini arttÄ±rmaz. HHSânin tutacaÄÄ± sayaÃ§Ä±n kontrol parametreleri YÃS kodu, hesap numarasÄ± ya da referansÄ± olmalÄ±dÄ±r. Sayfa no parametresi varsa ve 1'den bÃ¼yÃ¼k ise iÅlem sayacÄ±nÄ± arttÄ±rmamalÄ±dÄ±r. \n ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden tetiklediÄi iÅlemlerde ise;\nbireysel ÃHKâlar  iÃ§in en fazla 1 aylÄ±k,\nkurumsal ÃHKâlar iÃ§in ise en fazla 1 haftalÄ±k bir pencere aralÄ±ÄÄ±nda sorgulama yapÄ±labilir. Belirtilen tarih aralÄ±ÄÄ±ndan farklÄ± deÄer ile sorgulama yapÄ±ldÄ±ÄÄ±nda  âTR.OHVPS.Business.InvalidStartEndTimeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS, otomatik yapacaÄÄ± sorgularda hem bireysel hem de kurumsal ÃHKâlar iÃ§in 24 saatlik bir pencere aralÄ±ÄÄ±nda sorgulama yapabilir. Belirtilen tarih aralÄ±ÄÄ±ndan farklÄ± deÄer ile sorgulama yapÄ±ldÄ±ÄÄ±nda  âTR.OHVPS.Business.InvalidStartEndTimeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saatinin 00:00:00 olduÄu kabul edilmiÅtir. \n Sorgu Ã¶rnekleri aÅaÄÄ±daki gibidir:  \n 1 gÃ¼nlÃ¼k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-06-02T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n \n 1 haftalÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-06-08T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-02-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-03-01T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-01-31T00:00:00+03:00&\nhesapIslemBtsTrh=2020-02-28T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-02-28T00:00:00+03:00&\nhesapIslemBtsTrh=2020-03-28T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 24 saatlik pencerede yapacaÄÄ± sistemsel sorgu Ã¶rneÄi (Son sorgusunun Ã¼zerine 24 saat eklenmesi)  =\n/hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T14:10:08+03:00&\nhesapIslemBtsTrh=2020-06-02T14:10:08+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n ÃnyÃ¼zden alÄ±nan sorgu parametreleri ile oluÅturulan sorgu Ã¶rneÄi (Ãrnek sorgu tarih aralÄ±ÄÄ± 20.02.2023- 25.02.2023 arasÄ±ndadÄ±r)  =\n/hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2023-02-20T00:00:00+03:00&\nhesapIslemBtsTrh=2023-02-26T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n Tablo 18: Ä°Ålem Listesi Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin baÅlangÄ±Ã§ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. ÃHK tarafÄ±ndan tetiklenen sorgularda;hesapIslemBslTrh ve hesapIslemBtsTrh arasÄ± fark bireysel ÃHKâlar iÃ§in en fazla 1 ay,kurumsal ÃHKâlar iÃ§in ise en fazla 1 hafta olabilir. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;son 24 saat sorgulanabilir. Bu yÃ¼zden hesapIslemBtsTrh-24 saatâten daha uzun bir aralÄ±k sorgulanamaz olmalÄ±dÄ±r. Ä°stek baÅlÄ±ÄÄ±nda yer alan PSU-Initiated alanÄ± âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n \n \n Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin bitiÅ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;Ä°leri vadeli iÅlem emirleri dahil olmadÄ±ÄÄ± iÃ§in (SÃ¼rÃ¼m 1.0.2 kapsamÄ±nda); Ä°Ålem Sorgulama BitiÅ ZamanÄ±, her zaman, sorgulama zaman damgasÄ±nÄ± iletecek Åekilde (datetime (now)) iletilebilir. \n \n \n En DÃ¼ÅÃ¼k Ä°Ålem TutarÄ± \n minIslTtr \n AN1..24 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en dÃ¼ÅÃ¼k iÅlem tutarÄ±.      Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n En YÃ¼ksek Ä°Ålem TutarÄ± \n mksIslTtr \n AN1..24 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en yÃ¼ksek iÅlem tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n BorÃ§ Alacak GÃ¶stergesi \n brcAlc \n AN1 \n Ä° \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Hesaba borÃ§ yaratan iÅlem.A: Hesaba alacak yaratan iÅlem.{âBâ,âAâ} \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼

16yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âislGrckZamanâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini islGrckZaman olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 19: âIslemBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap Referans NumarasÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hspRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n Islemler \n isller \n Kompleks:Islem[Array] \n K \n Hesaba iliÅkin hareketler varsa Ä°Ålemler nesnesi dizisi olarak dÃ¶nÃ¼lÃ¼r. Ä°Ålemler nesnesi Temel Ä°Ålem Bilgileri ve Detay Ä°Ålem Bilgileri nesnesinden meydana gelir. Ä°zin tÃ¼rÃ¼ varsayÄ±lan olarak Temel Ä°Ålem Bilgilerini iÃ§erir. Detay Ä°Ålem Bilgileri izin tÃ¼rÃ¼ de seÃ§ildi ise Temel Ä°Ålem Bilgilerine ek olarak Detay Ä°Ålem Bilgileri de gÃ¶nderilir. \n \n \n > Temel Ä°Ålem Bilgileri \n islTml \n Kompleks:IslemTemel \n Z \n Temel Ä°Ålem Bilgileri varsayÄ±lan olarak dÃ¶nÃ¼lÃ¼r. \n \n \n >> Ä°Ålem NumarasÄ± \n islNo \n AN3..50 \n Z \n Hesap hareketinin oluÅturulmasÄ± sÄ±rasÄ±nda atanan ve borÃ§ (veya alacak) hareketini tekilleÅtiren HHS bazÄ±nda tekil tanÄ±mlayÄ±cÄ±dÄ±r. Bu deÄer tek baÅÄ±na tekil olabileceÄi gibi birden fazla deÄerin bir araya getirilmesiyle de tekilliÄi saÄlanmÄ±Å olabilir. Bu deÄerin en azÄ±ndan hesap numarasÄ± (hesNo) bazÄ±nda tekil olmasÄ± beklenir. Genellikle kullanÄ±lan Ã¶rnekleri; Instance_Id, Transaction_Id, Transaction_Num, Transaction_TimeStamp,dekont numarasÄ± \n \n \n >> Ä°Ålem Referans NumarasÄ± \n refNo \n AN3..50 \n Z \n Ä°Ålemi uÃ§tan uca tanÄ±mlayan tekil tanÄ±mlayÄ±cÄ±dÄ±r. BorÃ§ ve alacak hareketinden oluÅan bir veya birden fazla iÅlemler bÃ¼tÃ¼nÃ¼ iÃ§in atanmÄ±Å olan ve bu bÃ¼tÃ¼nÃ¼ tekilleÅtiren (bir biri ile iliÅkisini tutan) deÄerdir.Bu deÄer hem YÃSâten gelen deÄer olabilir (Ã¶deme iÅlemlerinde kullanÄ±lan kkodRef ya da refBlg alanÄ±) hem de HHS iÃ§inde takip edilmek iÃ§in Ã¼retilmiÅ bir deÄer olabilir. HHS sisteminde 2 deÄerin de bulunmasÄ± durumunda;refNo alanÄ±nÄ± doldurmak iÃ§in, HHSânin YÃSâten gelen deÄere Ã¶ncelik vermesi beklenmektedir. YÃSâten gelen veri Ã¶rneÄi: SipariÅ NumarasÄ±, Fatura NumarasÄ±, Karekod ReferansÄ± vb. HHSâte Ã¼retilen veri Ã¶rneÄi: MasraflÄ± havale iÅleminde hem havale iÅleminin hem de masraf iÅleminin aynÄ± referans numarasÄ±na sahip olmasÄ± da Ã¶rnek olarak gÃ¶sterilebilir. \n \n \n >> Ä°Ålem TutarÄ± \n islTtr \n AN1..24 \n Z \n Ä°Ålem tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n >> GÃ¼ncel Bakiye TutarÄ± \n gnclBky \n AN1..25 \n Z \n Ä°Ålem sonrasÄ± gÃ¼ncel bakiye bilgisi tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n >> Ä°Ålem GerÃ§ekleÅme ZamanÄ± \n islGrckZaman \n ISODateTime \n Z \n Ä°Ålemin gerÃ§ekleÅme zamanÄ±. \n \n \n >> Ä°Ålem KanalÄ± \n kanal \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeKaynak sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> BorÃ§landÄ±rma AlacaklandÄ±rma GÃ¶stergesi \n brcAlc \n AN1 \n Z \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Ä°Ålemin hesabÄ± borÃ§ ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. \n \n \n >> Ä°Ålem TÃ¼rÃ¼ \n islTur \n AN3..50 \n Z \n HHSânin iÅleme ait iliÅkilendirdiÄi iÅlem tÃ¼rÃ¼ deÄeri. TR.OHVPS.DataCode.IslemTuru sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Ä°Ålem AmacÄ± \n islAmc \n AN2 \n Z \n TR.OHVPS.DataCode.IslemAmaci sÄ±rali veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Ãdeme Sistemi No \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. Havale/FAST/PÃS  Ã¶deme yÃ¶ntemleri iÃ§in tarih alanÄ± yyyy-aa-gg formatÄ±nda 10 karakter olarak

16iletilmelidir. \n \n \n > Detay Ä°Ålem Bilgileri \n islDty \n Kompleks: IslemDetay \n K \n Detay Ä°Ålem Bilgileri dizi olarak gÃ¶nderilmelidir. \n \n \n >> Ä°Ålem AÃ§Ä±klamasÄ± \n islAcklm \n AN1..200 \n Z \n HHS tarafÄ±ndan atanan iÅlem aÃ§Ä±klamasÄ±. HHS kendi iÅlem hareketlerine yansÄ±ttÄ±ÄÄ± aÃ§Ä±klamayÄ± buraya yansÄ±tmalÄ±dÄ±r.  HHS'ler tÃ¼m hesap hareketlerini YÃS'ler ile paylaÅmakla yÃ¼kÃ¼mlÃ¼ olup, hassas veri iÃ§eren(Ã¶rn: faiz, komisyon bilgisi iÃ§eren vb.) iÅlem hareketleri de bu kapsamda deÄerlendirilerek iÅlem aÃ§Ä±klamasÄ±nÄ±n maskeli olarak iletilmesi saÄlanÄ±r. Kelimelerin ilk 3 hanesi maskeli olacak Åekilde, ancak sakÄ±ncalÄ± bulunan kelimeler varsa; (Ã¶rn: faiz, komiyon vb.) kelimelerin tamamÄ± maskeli olacak Åekilde gÃ¶sterilebilir. \n \n \n >> KarÅÄ± Taraf \n krsTrf \n Kompleks:  KarsiTaraf \n K \n KullanÄ±mÄ± iÅlem bazÄ±nda deÄiÅmektedir. Ãrnek: FAST iÅleminde karÅÄ± taraf alÄ±cÄ±nÄ±n bilgileridir. Vergi Ã¶demesinde kurum IBAN bilgisi mÃ¼Återiye gÃ¶sterilemeyebileceÄinden bu alanÄ±n boÅ gelmesi HHS insiyatifindedir. \n \n \n >>> KarÅÄ± Maskeli IBAN \n krsMskIBAN \n AN26 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n maskeli IBAN bilgisi. \n \n \n >>> KarÅÄ± Ãnvan \n krsUnvan \n AN3..140 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n ad-soyad ya da ticari Ã¼nvan bilgisi. Ãnvan bilgisi maskelenmeden iletilmelidir. \n \n \n >>> KarÅÄ± Taraf Kimlik Bilgisi \n krsKimlikVrs \n AN1..11 \n Ä° \n HHS sorumluluÄunda YÃS ile paylaÅÄ±lan KarÅÄ± Taraf Kimlik Bilgisi(Kimlik/Kurum Kimlik - TCKN/VKN) \n 9.9 ADIM 4: Kart Bilgilerinin SorgulanmasÄ± \n    \n GET /kartlar ve GET /kartlar/{kartRef} \n Bu eriÅim noktalarÄ±ndan tÃ¼m kartlarÄ±n veya belirli bir kartÄ±n bilgileri sorgulanÄ±r ve kart listesi elde edilir. Ä°lgili sorgu iÃ§in 07 izin tÃ¼rÃ¼nÃ¼n verilmesi yeterlidir. HHS ekranlarÄ±nda kart seÃ§imi yapÄ±lÄ±rken sadece aktif/aÃ§Ä±k statÃ¼de olan kartlar listelenecek ve ÃHK'ya seÃ§tirilecektir. KartÄ±n ilgili kanalda listelenme yetkisi bulunmuyorsa ÃHVPS kapsamÄ±nda listelenmeyebilir. ListelendiÄi durumda; asÄ±l kart sahibi ile sanal/ek kart sahiplerinin aynÄ± kiÅi olduÄu dÃ¼ÅÃ¼nÃ¼ldÃ¼ÄÃ¼nde HHS ekranlarÄ±nda kart seÃ§imi yapÄ±larak rÄ±za verilirken asÄ±l kart seÃ§ilmeden ilgili asÄ±l karta baÄlÄ± sanal ve ek kartlarÄ±n ayrÄ±ca seÃ§ilerek rÄ±za verilmesine izin verilmemelidir. HHS mevcut kanallarÄ±nda ek ve sanal kart hareketlerini asÄ±l karttan ayÄ±rt etmeden mÃ¼Återisine gÃ¶steriyor ise asÄ±l kart seÃ§imi ile birlikte asÄ±l karta baÄlÄ± sanal ve/veya ek kart seÃ§imini zorunlu kÄ±lmalÄ±dÄ±r. AsÄ±l kart hamili dÄ±ÅÄ±nda bir kiÅi iÃ§in ek kart Ã§Ä±kartÄ±ldÄ±ÄÄ± durumda ek kart sahibi HHS'de asÄ±l kartÄ± gÃ¶rmeyecek olduÄundan sadece kendisine Ã§Ä±kartÄ±lan ek kartÄ± listelenecek ve seÃ§erek rÄ±za vermesi saÄlanacaktÄ±r. Ek kart hamilinin asÄ±l kart hamilinden farklÄ± olduÄu durumda asÄ±l karta ait bir rÄ±za olmasa da ek karta rÄ±za verilebilir. \n Her durumda onay ekranÄ±nda rÄ±za verilen tÃ¼m kartlarÄ±n listesini ÃHK'ya gÃ¶stermesi zorunludur. KapalÄ± devre Ã§alÄ±Åan kartlar kapsama dahil deÄildir. \n YÃS tarafÄ±ndan baÅlatÄ±lan rÄ±za isteklerinde hesap ve kart izin tÃ¼rlerinin seÃ§ili olmasÄ± durumunda HHS ekranlarÄ±nda hem hesaplarÄ±n hem de kartlarÄ±n listelenmesi saÄlanacaktÄ±r. Ancak hesap ya da kart bilgilerinden en az birinin seÃ§ilmesi yeterlidir. Hem hesap hem kart bilgisi iÃ§in seÃ§im yapÄ±lmasÄ± zorunluluÄu bulunmamaktadÄ±r. YÃS Ã¼zerinden hem hesap hem kart izin tÃ¼rÃ¼ seÃ§ilerek baÅlatÄ±lan rÄ±za akÄ±ÅÄ±nda, mÃ¼Återi HHS ekranÄ±nda yalnÄ±zca hesap seÃ§imi yapmÄ±Å ise, kartlar servisine yapÄ±lan isteklerde HHS tarafÄ±ndan hata yerine boÅ liste dÃ¶nÃ¼lmelidir. \n \n Parametrede yer alan deÄerlerin doÄru gÃ¶nderildiÄi kontrol edilir. HatalÄ± gÃ¶nderilmesi durumunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Parametrede yer alan deÄerler gÃ¶nderilmediÄi durumda parametredeki varsayÄ±lan deÄerler ile kart bilgileri dÃ¶nÃ¼lÃ¼r. VarsayÄ±lan deÄerler Tablo 20'de belirtilmiÅtir. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n RizaDurumu B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'Ã¼n;

16 RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda kartlar servisini Ã§aÄÄ±rmamasÄ± beklenir. Bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âYetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n Ä°lgili rÄ±za numarasÄ±nÄ±n â07: Temel Kart Bilgisiâ izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 07 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS tarafÄ±ndan istek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±za iÃ§erisindeki kart bilgileri dÃ¶nÃ¼lÃ¼r. Kart bilgileri iÃ§in KartBilgileri nesnesinin iÃ§eriÄi Tablo 21'de verilmiÅtir. \n Kart Bilgisi Sorgu ÃrneÄi (TÃ¼m Kartlar) = /kartlar?syfKytSayi=25&syfNo=1?kartTipi=K\nKart Bilgisi Sorgu ÃrneÄi (Belirli Bir Kart) = /kartlar/{kartRef} \n Ä°ptal statÃ¼sÃ¼nde olan banka ve Ã¶n Ã¶demeli kart tipleri HHS tarafÄ±ndan kartlar sorgusunda dÃ¶nÃ¼lmeyecek olup YÃS'ler tarafÄ±ndan ÃHK'ya da gÃ¶sterilemeyecektir. Ä°ptal statÃ¼lÃ¼ kredi kart tipi iÃ§in borÃ§/taksit bilgisi veya artÄ± bakiye olmasÄ± durumunda kartlar listesinde HHS'ler tarafÄ±ndan dÃ¶nÃ¼Å saÄlanacak olup YÃS'ler tarafÄ±ndan ÃHK'ya gÃ¶sterilecektir. Ä°ptal statÃ¼sÃ¼nde olup herhangi bir bakiye ve borÃ§ olmamasÄ± durumunda ilgili kart bilgisi kartlar listesinde HHS tarafÄ±ndan iletilmeyecektir. \n HHS'de aÃ§Ä±k/aktif statÃ¼de yer alan kartlar seÃ§ilip rÄ±za tahsis edildikten sonra kartÄ±n statÃ¼sÃ¼nÃ¼n pasif olmasÄ± durumunda HHS tarafÄ±ndan mevcut kanallarÄ±nda gÃ¶sterilen bilgiler kart liste, detay ve hareket sorgulamalarÄ±nda dÃ¶nÃ¼lmelidir. HHS'de kart seÃ§imi yapÄ±p rÄ±za tahsis edildikten sonra ilgili kartÄ±n gÃ¶sterimi Ã¶zelinde HHS'de kÄ±sÄ±tlama getirilmesi durumlarÄ± iÃ§in Ã¶rnekler aÅaÄÄ±da detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n RÄ±za iÃ§erisinde sadece kart olmasÄ± durumunda ilgili rÄ±zanÄ±n 09 iptal detay kodu ile iptal edilmesi saÄlanacaktÄ±r. \n RÄ±za iÃ§erisinde ilgili kartÄ±n dÄ±ÅÄ±nda hesap/kart olmasÄ± durumunda rÄ±za iptal edilmeyecektir. Ä°lgili kart haricinde kart listesinde farklÄ± bir kart yoksa kart listesi, sorgulandÄ±ÄÄ±nda  TR.OHVPS.Business.RestrictedChannelAccess  hata kodu dÃ¶nÃ¼lecektir. \n \n Tablo 20: Kart Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n Kart Tipi \n kartTipi \n AN1 \n Ä° \n Kart tipleri Ã¶zelinde Banka, Kredi ve Ãn Ãdemeli kartlarÄ±n ayrÄ±ca soruglanmasÄ± saÄlanÄ±r. \n Bu veri gÃ¶nderildiÄi durumda, HHS kart tipine uygun olarak kart bilgilerini dÃ¶ner. \n \n \n \n Tablo 21: âKartBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n Kart Referans NumarasÄ± \n kartRef \n AN5..40 \n Z \n HHS tarafÄ±ndan her bir kart iÃ§in atanan biricik deÄerdir (uuid). Bir kart tek bir kartRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir kartRef tek bir karta karÅÄ±lÄ±k gelmelidir. AynÄ± kart iÃ§in alÄ±nan tÃ¼m rÄ±zalarda kart referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n Kart NumarasÄ± \n kartNo \n AN15..16 \n Z \n Karta ait numara maskeli olarak iletilmelidir. Maskeleme kuralÄ± kart'Ä±n ilk 6 ve son 4 hanesi aÃ§Ä±k olarak gÃ¶rÃ¼necek Åekilde maskelenmelidir. Sanal kart bilgisi iÃ§in de ilgili numara maskeli olarak iletilmelidir. Ãrn: 123456******5678 \n \n \n AsÄ±l Kart NumarasÄ± \n asilKartNo \n AN15..16 \n K \n AsÄ±l kartlar iÃ§in ilgili alan iletilmemelidir. Sanal ve ek kartlar iÃ§in baÄlÄ± olduklarÄ± asÄ±l kart numaralarÄ± iletilmelidir. Ek karta ait sanal kart iÃ§in asÄ±l kart numarasÄ± olarak ek kart numarasÄ± iletilmelidir. Kart numarasÄ± maskeli iletilmelidir. \n \n \n Kart Tipi \n kartTipi \n AN1 \n Z \n KartÄ±n tipini belirten deÄerdir. Kart tipleri olarak alabileceÄi deÄerler  TR.OHVPS.DataCode.KartTip  sÄ±ralÄ± veri tÃ¼rlerinden biridir. \n \n \n Alt Kart Tipi \n altKartTipi \n AN1 \n Z \n Kart Tipleri altÄ±nda yer alan alt kart tipleridir. Alt kart tipleri olarak alabileceÄi deÄerler  TR.OHVPS.DataCode.AltKartTip  sÄ±ralÄ± veri tÃ¼rlerinden biridir.  AsÄ±l banka kartÄ±, sanal banka kartÄ±, ek kredi kartÄ±, asÄ±l kredi kartÄ± gibi tÃ¼m kart tiplerini ayrÄ±ÅtÄ±rmak iÃ§in asÄ±l ve alt kart tipleri kullanÄ±lmaktadÄ±r. \n \n \n Kart Formu \n kartFormu \n AN1 \n Z \n KartÄ±n fiziksel ve dijital olduÄ

16unu belirten deÄerdir. AlabileceÄi deÄerler  TR.OHVPS.DataCode.KartFormu  sÄ±ralÄ± veri tÃ¼rlerinden biridir. \n \n \n Kart TÃ¼rÃ¼ \n kartTuru \n AN1 \n Z \n KartÄ±n tipinin bireysel ya da ticari olmasÄ±na yÃ¶nelik olan deÄerdir.  B:Bireysel, T:Ticari \n \n \n Kart StatÃ¼sÃ¼ \n kartStatu \n AN1 \n Z \n TR.OHVPS.DataCode.KartStatu  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  Kart statÃ¼sÃ¼ iÃ§in gÃ¼ncelleme yapÄ±lamayacak durumda ise iptal statÃ¼sÃ¼ olarak deÄerlendirilmelidir. Kart statÃ¼sÃ¼ gÃ¼ncellenebilir durumda ise aÃ§Ä±k ve pasif olarak deÄerlendirilmelidir. \n \n \n Kart Sahibi Ad/Soyad \n kartSahibi \n AN3..140 \n Z \n Kart sahibi ya da kart sahiplerinin ad-soyadÄ±. \n \n \n Kart Ticari Unvan \n kartTicariUnvan \n AN3..140 \n K \n Kart tÃ¼rÃ¼ ticari ise ilgili alanda ticari unvan iletilmesi zorunludur. \n \n \n Kart ÃrÃ¼n AdÄ± \n kartUrunAdi \n AN3..140 \n Z \n Kart bilgilerinin Ã¼rÃ¼n adÄ±. Ãrn : TROY Business Kart \n \n \n Ekstre TÃ¼rleri \n ekstreTurleri \n Kompleks:EkstreTurleri[Array] \n Z \n Ekstre tÃ¼rleri dizi iÃ§erisinde iletilmelidir. \n \n \n > Ekstre StatÃ¼sÃ¼ \n ekstreStatu \n AN1 \n Z \n TR.OHVPS.DataCode.EkstreStatu  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.Ekstre tÃ¼rÃ¼nÃ¼n durumu iletilmelidir. Pasif olan ekstre tÃ¼rleri de iletilmelidir. A: Aktif : ilgili kartÄ±n ekstre tÃ¼rÃ¼nÃ¼n kullanÄ±ma aÃ§Ä±k olmasÄ±dÄ±r. P: Pasif : Ä°lgili kartÄ±n esktre tÃ¼rÃ¼nÃ¼n eskiden kullanÄ±ldÄ±ÄÄ± ancak Åu an devre dÄ±ÅÄ± durumda olmasÄ±dÄ±r.  Ãrnek olarak: Ä°lgili kredi kartÄ±nÄ±n TRY, USD, EUR ekstre tÃ¼rleri aÃ§Ä±k olduÄu durumda Ã¼Ã§ ekstre tÃ¼rÃ¼nÃ¼n de aktif olarak dÃ¶nmesi beklenmektedir. ÃHK, USD ekstre tÃ¼rÃ¼nÃ¼ kapattÄ±ÄÄ± durumda USD pasif ; TRY ve EUR aktif olarak dÃ¶nmesi beklenmektedir. BÃ¶ylece ÃHKânÄ±n Åu an pasif ama Ã¶nceden aktif olan esktre tÃ¼rlerinin sorgulanmasÄ± saÄlanabilecektir. EÄer bir ekstre tÃ¼rÃ¼ iÃ§in hiÃ§ ekstre Ã¼retilmemiÅse, bu durumda HHSânin ilgili ekstre tÃ¼rÃ¼nÃ¼ hiÃ§ dÃ¶nmemesi gerekmektedir. \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Ä°lgili karta ait ekstre tÃ¼rleri para birimi.(TRY, USD, EUR, GBP) YurtdÄ±ÅÄ± ekstre olan kartlar iÃ§in TRY haricinde de deÄer dÃ¶nÃ¼lmesi gerekmektedir. Banka kartlarÄ±nda ise karta baÄlÄ± olan hesap para birimleri iletilmelidir. \n \n \n Kart Rumuz \n kartRumuz \n AN3..140 \n Ä° \n Kart iÃ§in rumuz bilgisi var ise gÃ¶nderilebilir. \n \n \n Kart ÅemasÄ± \n kartSema \n AN1 \n Z \n TR.OHVPS.DataCode.KartSema  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n 9.10 ADIM 4.1: Kart Detay Bilgilerinin SorgulanmasÄ± \n GET /kartlar/{kartRef}/kart-detay \n KartBilgileri nesnesi ile elde edilen kart listesinde yer alan kartlarÄ±n detayÄ± sorgulanÄ±r. Detay ile birlikte KartDetayBilgileri nesnesinin iÃ§eriÄi Tablo 23'de verilmiÅtir. \n \n Parametrede yer alan ekstreTuru bilgisi Ekstre TÃ¼rleri haricinde uygun olmayan bir deÄer gÃ¶nderildiÄinde  âTR.OHVPS.Business.InvalidCurrencyCodeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Bu alan gÃ¶nderilmiyorsa TRY olarak deÄerlendirilmelidir. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen kartRef'ler iÃ§in, kart detay bilgileri sorgulanan kartRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili kartRef bulunamaz  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n Ä°lgili rÄ±za numarasÄ±nÄ±n â08: DetaylÄ± Kart Bilgisiâ izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 08 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupported\"â  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Alt kart tipi Sanal Kart olanlar iÃ§in detay bilgisi gÃ¶rÃ¼ntÃ¼lenmeyecektir.  Sanal kart Ã¶zelinde detay bilgi sorgulamasÄ± yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CardTypeNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Kart tipi olarak; iptal statÃ¼sÃ¼nde olan banka ve Ã¶n Ã¶demeli kartlar iÃ§in detay sorgulamasÄ± yapÄ±lamayacaktÄ±r. Kart tipi kredi kartÄ± olup iptal statÃ¼sÃ¼nde olan ve  borcu olmayan bir  kart iÃ§in de kart detay sorgulamasÄ± yapÄ±lamayacaktÄ±r. Detay sorgulamasÄ± yapÄ±lamayacak bir kart tipi iÃ§in HHS'ler tarafÄ±ndan  \"TR.OHVPS.Business.InvalidCardStatus\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za iÃ§erisinde kanal gÃ¶rÃ¼ntÃ¼leme yetkisi kapatÄ±lan kart iÃ§in detay bilgisi sorgulandÄ±ÄÄ±nda  TR.OHVPS.Business.RestrictedChannelAccess  hata kodu dÃ¶nÃ¼lecektir. \n Ä°lk kredi kartÄ± oluÅan ÃHK'lar henÃ¼z ekstre oluÅmadÄ±ÄÄ± sebebiyle tarih ve borÃ§ bilgileri de oluÅmamÄ±Å olabilir. Bu sebeple ilgili tutar bilgileri sÄ±fÄ±r olacak Åekilde dÃ¶nÃ¼lmelidir. Tarih bilgileri ise varsayÄ±lan tarih bilgisi olarak dÃ¶nÃ¼lebilir.(Ãrn:01/01/1900) Bu Åekilde gelen bir tarih bilgisi YÃS'ler tarafÄ±ndan ÃHK'ya boÅ olarak gÃ¶sterilebilir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS tarafÄ±ndan  âKartDetayBilgileriâ  nesnesi dÃ¶nÃ¼lÃ¼r. \n HHS'ler kart tipi kredi kartÄ± ise ve karta ait borÃ§/taksit tutar bilgisi bulunuyorsa KartDetayBilgileri nesnesi iÃ§in baÅarÄ±lÄ± yanÄ±t dÃ¶nmek zorundadÄ±r. BorÃ§ bilgisi iÃ§in tutarlar eksi(-) olacak Åekilde iletilmesi beklenmektedir. \n Kart Detay Bilgisi Sorgu ÃrneÄi (Tek Bir Kart) = /kartlar/{kartRef}/kart-detay \n Parametre iÃ§eren Kart Detay Bilgisi Sorgu ÃrneÄi (Tek Bir Kart) =  /kartlar/{kartRef}/kart-detay?ekstreTuru=USD \n Tablo 22: Kart Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ekstre TÃ¼rÃ¼ \n ekstreTuru \n AN3 \n K \n Kart bilgileri yanÄ±tÄ±nda dÃ¶nÃ¼len ekstre tÃ¼rleri deÄerlerini almaktadÄ±r. Para birimine uygun olarak kart detay bilgileri sorgulanmaktadÄ±r. Ekstre parametresi TRY,USD,EUR,GBP olarak gÃ¶nderilebilir. Bu alan gÃ¶nderilmiyorsa TRY deÄerlendirilmelidir. Ä°lgili para birimine Ã¶zel ekstre iÃ§indeki harcama deÄeri dÃ¶nÃ¼lecektir. \n Ekstre tÃ¼rleri haricinde uygun olmayan bir deÄer gÃ¶nderildiÄinde hata verilmelidir. \n \n \n \n Tablo 23: âKartDetayBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n

16Kart Tiplerine Ä°stinaden DetaylÄ± AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n Kart Referans NumarasÄ± \n kartRef \n AN5..40 \n Z \n HHS tarafÄ±ndan her bir kart iÃ§in atanan biricik deÄerdir (uuid). Bir kart tek bir kartRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir kartRef tek bir karta karÅÄ±lÄ±k gelmelidir. AynÄ± kart iÃ§in alÄ±nan tÃ¼m rÄ±zalarda kart referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n \n Ekstre TÃ¼rÃ¼ \n ekstreTuru \n AN3 \n Z \n Ekstre tÃ¼rÃ¼ TRY,USD,EUR,GBP olarak gÃ¶nderilebilir. Ä°stek paremetresinde iletilen deÄer ile aynÄ± deÄer olmalÄ±dÄ±r. \n \n \n \n Toplam Kart Limiti \n toplamLimit \n Kompleks:ToplamLimit \n K \n Karta ait toplam TL limit bilgisi. Toplam kart limiti (+) deÄerde gÃ¶nderilmelidir. Negatif deÄer gÃ¶nderilmemelidir. \n Kart tipi kredi kartÄ± ve Ã¶n Ã¶demeli kart olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. Ãn Ã¶demeli kartlarda, baÄlÄ± bulunduklarÄ± bir hesap olsa bile, sadece Ã¼zerlerine yÃ¼klenen tutarÄ±n gÃ¶sterilmesi gerekmektedir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Tutar Bilgisi. Limit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n KullanÄ±labilir Kart Limiti \n kullanilabilirLimit \n Kompleks:KullanÄ±labilirLimit \n K \n Karta ait kullanÄ±labilir TL limit bilgisi. KullanÄ±labilir kart limiti (+) deÄerde gÃ¶nderilmelidir. Herhangi bir sebeple (kart limitinin aÅÄ±lmasÄ± vb.)  (-) olmasÄ± durumunda deÄerin (-) olarak gÃ¶nderilmesi beklenmektedir. \n Kart tipi banka olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Tutar Bilgisi. Limit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n DÃ¶nem Ä°Ã§i Hareket ToplamÄ± \n donemIciHareketToplami \n Kompleks:DonemIciHareketToplami \n Z \n DÃ¶nem iÃ§i hareket toplamÄ± ve kalan ekstre borcunun toplamÄ± dÃ¶nÃ¼lmelidir. MÃ¼Återinin borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb(+) deÄer ile tutar bilgisi gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili dÃ¶neme ait hareketlerin toplam tutar bilgisidir. Kart tipi banka ve Ã¶n Ã¶demeli kartlar iÃ§in ilgili dÃ¶nem iÃ§erisinde ay baÅÄ±ndan itibaren yapÄ±lan hareketlerin toplam tutar bilgisi iletilmelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Tutar Bilgisi.  Tutar iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Ekstre Borcu \n ekstreBorcu \n Kompleks:EkstreBorcu \n K \n Ä°lgili ekstre tÃ¼rÃ¼ne uygun olarak ekstre borcu iletilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb(+) deÄer ile tutar bilgisi gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi koÅulludur. Ek kredi kartÄ± iÃ§in ilgili alan varsa dÃ¶nÃ¼lmelidir . Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n BorÃ§ tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Kalan Ekstre Borcu \n kalanEkstreBorcu \n Kompleks:KalanEkstreBorcu \n K \n Ä°lgili ekstre tÃ¼rÃ¼ne uygun olarak kalan ekstre borcu iletilmelidir. MÃ¼Återinin kalan ekstre borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. Kalan ekstre borcu yoksa veya herhangi bir sebeple ektresinde alacak tutarÄ± varsa 0(sÄ±fÄ±r) deÄeri gÃ¶nderilmelidir. Pozitif deÄer gÃ¶nderilmemelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi koÅulludur. Alt kart tipi ; AsÄ±l ve Dijital kredi kartÄ± iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi zorunludur. Ek kredi kartÄ± iÃ§in ilgili alan varsa dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n BorÃ§ tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Asgari Ãdeme TutarÄ± \n asgariOdemeTutari \n Kompleks:AsgariOdemeTutari \n K \n Ä°lgili ekstre tÃ¼rÃ¼ne uygun olarak ekstreye ait asgari Ã¶deme tutarÄ± iletilmelidir. Ekstre Borcu (-) ise; asgari Ã¶deme tutarÄ± da (-) deÄer olarak gÃ¶nderilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb.)  \"0\" (sÄ±fÄ±r) deÄeri gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi koÅulludur. Alt kart tipi ; AsÄ±l ve Dijital kredi kartÄ± iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi zorunludur. Ek kredi kartÄ± iÃ§in ilgili alan varsa dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Ãdeme tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Kalan Asgari Ãdeme TutarÄ± \n kalanAsgariOdemeTutari \n Kompleks:KalanAsgariOdemeTutari \n K \n Ä°lgili ekstre tÃ¼rÃ¼ne uygun olarak ekstreye ait kalan asgari Ã¶deme tutarÄ± iletilmelidir. Ekstre Borcu (-) ise; asgari Ã¶deme tutarÄ± da (-) deÄer olarak gÃ¶nderilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb.)  \"0\" (sÄ±fÄ±r) deÄeri gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi koÅulludur. Alt kart tipi ; AsÄ±l ve Dijital kredi kartÄ± iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi zorunludur. Ek kredi kartÄ± iÃ§in ilgili alan varsa dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Ãdeme tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Hesap Kesim Tarihi \n hesapKesimTarihi \n ISODate \n Z \n Karta ait hesap kesim tarihi iletilmelidir. Hesap kesim tarihi olarak son kesilmiÅ ekstrenin tarihi iletilmelidir. ÃrneÄin; gÃ¼nÃ¼n tarihi 09/01/2026 olduÄu durumda her ayÄ±n 23'Ã¼nde kesilen ekstre iÃ§in hesap kesim tarihi 2025-12-23 Åeklinde olacaktÄ±r. \n Kart tipi kredi kartÄ± olanlar iÃ§in hesap kesim tarihi iletilmelidir. Ek kart iÃ§in asÄ±l kartÄ±n hesap kesim tarihi dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in sorgulama yapÄ±lan ayÄ±n son takvim gÃ¼nÃ¼ dÃ¶nÃ¼lmelidir. \n \n \n Sonraki Hesap Kesim Tarihi \n sonrakiHesapKesimTarihi \n ISODate \n Z \n Kesilecek olan ekstrenin hesap kesim tarihi tarihi iletilmelidir. ÃrneÄin; gÃ¼nÃ¼n tarihi 09/01/2026 olduÄu durumda her ayÄ±n 23'Ã¼nde kesilen ekstre iÃ§in sonraki hesap kesim tarihi 2026-01-23 Åeklinde olacaktÄ±r. \n Kart tipi kredi kartÄ± olanlar iÃ§in sonraki hesap kesim tarihi iletilmelidir. Ek kart iÃ§in asÄ±l kartÄ±n sonraki hesap kesim tarihi dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in sorgulama yapÄ±lan aydan bir sonraki ayÄ±n son takvim gÃ¼nÃ¼ dÃ¶nÃ¼lmelidir \n \n \n Son Ãdeme Tarihi \n sonOdemeTarihi \n ISODate \n K \n KesilmiÅ olan ekstre iÃ§in kart borcunun Ã¶deneceÄi son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir. ÃrneÄin; kesilmiÅ olan ekstreye ait  hesap kesim tarihi 2025-12-23 Åeklinde olan bir kredi kartÄ± iÃ§in son Ã¶deme tarihi 2026-01-03 olacaktÄ±r. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Ek kart iÃ§in asÄ±l kartÄ±n son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n Sonraki Son Ãdeme Tarihi \n sonrakiSonOdemeTarihi \n ISODate \n K \n Kesilecek olan ekstre iÃ§in kart borcunun Ã¶deneceÄi son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir.  ÃrneÄin; kesilecek olan ekstreye ait  hesap kesim tarihi 2026-01-23 Åeklinde olan bir kredi kartÄ± iÃ§in son Ã¶deme tarihi 2026-02-03 olacaktÄ±r. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Ek kart iÃ§in asÄ±l kartÄ±n sonraki son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n Puan Bilgisi \n puanBilgisi \n Kompleks:PuanBilgisi[Array] \n \n Karta ait puan bilgileri dizi iÃ§erisinde iletilmelidir. \n \n \n \n > Puan DeÄeri \n puanDegeri \n AN1..25 \n K \n Kart iÃ§in mevcutta yer alan puan deÄeri varsa iletilmelidir. HHS Ã¶zelinde puan deÄeri puan tipine gÃ¶re birim olarak tutuluyorsa ilgili deÄer iletilmelidir. Ãrn: 100 Plus puan bilgisi varsa puan deÄeri alanÄ±nda 100 iletilmelidir. Puan deÄeri eksi deÄer alabilir. \n TÃ¼m kart tipleri iÃ§in puan bilgisi varsa dÃ¶nÃ¼lmelidir. \n \n \n > Puan Tipi \n puanTipi \n AN1..50 \n K \n Puan Tipi olarak HHS Ã¶zelinde bir puanTipi varsa o bilgi iletilmelidir. Ãrn: 100 Plus puan bilgisi varsa puan tipi alanÄ±nda Plus deÄeri iletilmelidir. \n TÃ¼m kart tipleri iÃ§in puan bilgisi varsa dÃ¶nÃ¼lmelidir. \n \n \n Nakit Ãekim Limiti \n nakitCekimLimiti \n Kompleks:NakitCekimLimiti \n K \n Karta ait nakit Ã§ekim limit deÄeri iletilmelidir. Ekstre tÃ¼rÃ¼ TRY dÄ±ÅÄ±nda olan kartlar iÃ§in de TRY para biriminde geÃ§erli olan limit iletilmelidir. Nakit Ãekim Limiti (+) deÄerde gÃ¶nderilmelidir. Negatif deÄer gÃ¶nderilmemelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Limit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n KullanÄ±labilir Nakit Ãekim Limiti \n kullanilabilirNakitCekimLimiti \n Kompleks:KullanilabilirNakitCekimLimiti \n K \n Karta ait kullanÄ±labilir nakit Ã§ekim limit deÄeri iletilmelidir. Ekstre tÃ¼rÃ¼ TRY dÄ±ÅÄ±nda olan kartlar iÃ§in de TRY para biriminde geÃ§erli olan limit iletilmelidir. KullanÄ±labilir Nakit Ãekim Limiti (+) deÄerde gÃ¶nderilmelidir. Herhangi bir sebeple (nakit limitinin aÅÄ±lmasÄ± vb.)  (-) olmasÄ± durumunda deÄerin (-) olarak gÃ¶nderilmesi beklenmektedir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Limit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Kalan Toplam Taksit TutarÄ± \n kalanToplamTaksitTutari \n Kompleks:KalanToplamTaksitTutari \n K \n Karta ait tÃ¼m kalan taksitlerin toplam deÄeri iletilmelidir.MÃ¼Återinin Taksit borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. Taksit iadesi veya benzeri nedenlerle oluÅan mÃ¼Återinin alacaklÄ± olduÄu durumda tutar (+) deÄer gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Taksit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n DÃ¶nem Taksit Tutar Bilgisi \n donemTaksitTutarBilgisi \n Kompleks:DonemTaksitTutarBilgisi[array] \n K \n Kart Tipi kredi kartÄ± olanlar iÃ§in taksit bilgisi varsa taksit iÃ§eren dÃ¶nemlerin dizi halinde iletilmesi zorunludur. \n \n \n \n >

16 DÃ¶nem DeÄeri \n donemDegeri \n N3 \n Z \n Taksitli iÅlemler dÃ¶nÃ¼lmesi sebebiyle dÃ¶nem deÄeri minimum 1 olacak Åekilde dÃ¶nÃ¼lmelidir. \n \n \n \n > DÃ¶nem Taksit TutarÄ± \n donemTaksitTutari \n Kompleks:DonemTaksitTutari \n Z \n Ä°lgili dÃ¶nem deÄeri iÃ§erisindeki toplam taksit tutar bilgisi iletilmelidir. MÃ¼Återinin DÃ¶nem Taksit Tutar borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. DÃ¶nem Taksit Tutar iadesi veya benzeri nedenlerle oluÅan mÃ¼Återinin alacaklÄ± olduÄu durumda tutar (+) deÄer gÃ¶nderilmelidir. \n \n \n \n >> Tutar \n tutar \n AN1..25 \n Z \n Taksit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n >> Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n 9.11 ADIM 4.2: Kart Hareket Bilgilerinin SorgulanmasÄ± \n GET /kartlar/{kartRef}/kart-hareketleri \n KartBilgileri nesnesi ile elde edilen kart listesinde yer alan kartlarÄ±n iÅlem/hareket bilgileri sorgulanÄ±r. Kart hareketleri iÃ§in \"KartHareketleri\" nesnesinin iÃ§eriÄi Tablo 25'de verilmiÅtir. \n \n Bir karta iliÅkin iÅlem bilgileri Tablo 24âdeki istek parametrelerine gÃ¶re sorgulanÄ±r. Parametrede yer alan deÄerlerin doÄru gÃ¶nderildiÄi kontrol edilir. HatalÄ± gÃ¶nderilmesi durumunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Parametrede yer alan isteÄe baÄlÄ± alanlar gÃ¶nderilmediÄi durumda parametredeki varsayÄ±lan deÄerler ile kart hareketleri dÃ¶nÃ¼lÃ¼r. \n Parametrede yer alan ekstreTuru bilgisi Ekstre TÃ¼rleri haricinde uygun olmayan bir deÄer gÃ¶nderildiÄinde  âTR.OHVPS.Business.InvalidCurrencyCodeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Bu alan gÃ¶nderilmiyorsa TRY olarak deÄerlendirilmelidir. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen kartRef'ler iÃ§in, kart hareket bilgileri sorgusunda yer alan kartRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili kartRef bulunamaz ise  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n Kart Hareket Bilgilerinin SorgulanmasÄ± yapÄ±lÄ±rken HHS tarafÄ±ndan ÃHKânÄ±n â09:  AyrÄ±ntÄ±lÄ± Kart Ä°Ålem Bilgisiâ izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 09 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Kart tipi olarak; iptal statÃ¼sÃ¼nde olan banka ve Ã¶n Ã¶demeli kartlar iÃ§in hareket sorgulamasÄ± yapÄ±lamayacaktÄ±r. Kart tipi kredi kartÄ± olup iptal statÃ¼sÃ¼nde olan ve borcu olmayan bir kart iÃ§in de kart hareket sorgulamasÄ± yapÄ±lamayacaktÄ±r. Hareket sorgulamasÄ± yapÄ±lamayacak bir kart tipi iÃ§in HHS'ler tarafÄ±ndan  \"TR.OHVPS.Business.InvalidCardStatus\"  hatasÄ± dÃ¶nÃ¼lmelidir. \n -RÄ±za iÃ§erisinde kanal gÃ¶rÃ¼ntÃ¼leme yetkisi kapatÄ±lan kart iÃ§in hareket bilgisi sorgulandÄ±ÄÄ±nda  TR.OHVPS.Business.RestrictedChannelAccess  hata kodu dÃ¶nÃ¼lecektir. \n Ä°ptal statÃ¼sÃ¼nde olan kart tipleri iÃ§in geÃ§miÅe dÃ¶nÃ¼k hareket sorgulamasÄ± yapÄ±lamayacaktÄ±r. ÃrneÄin; Kredi KartÄ± iÃ§in -12 ile 18 arasÄ± olan dÃ¶nem deÄeri iptal statÃ¼sÃ¼nde olan kredi kartÄ± iÃ§in 0 ile 18 arasÄ±nda yapÄ±labilecektir. TÃ¼m kart tipleri iÃ§in belirtilen parametrede yer alan dÃ¶nem deÄerinin uygun gÃ¶nderilmediÄi durumda  âTR.OHVPS.Business.InvalidPeriodValueâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ekstre bilgisi bulunmayan sanal ve ek kredi kart bilgileri iÃ§in ekstre dÃ¶nemlerine Ã¶zgÃ¼ kart hareketleri sorgulandÄ±ÄÄ±nda HHS'ler tarafÄ±ndan  TR.OHVPS.Business.NoStatementForCard  hatasÄ± dÃ¶nÃ¼lmelidir. \n KartÄ±n yeni oluÅmasÄ±/aktif edilmesi gibi sÃ¼reÃ§lerler sonucunda ekstre bilgisi hiÃ§ oluÅmamÄ±Å dÃ¶nem deÄerleri iÃ§in kart hareketleri sorgulandÄ±ÄÄ±nda HHS'ler tarafÄ±ndan  TR.OHVPS.Business.StatementNotCreated  hatasÄ± dÃ¶nÃ¼lmelidir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS tarafÄ±ndan \"K

16artHareketleri\" nesnesi dÃ¶nÃ¼lÃ¼r. \n \n HHS'ler kart tipi kredi kartÄ± ise ve karta ait borÃ§/taksit tutar bilgisi bulunuyorsa KartHareketleri nesnesi iÃ§in baÅarÄ±lÄ± yanÄ±t dÃ¶nmek zorundadÄ±r. \n Kart tipi Banka KartÄ± olanlarda dÃ¶nem iÃ§i olarak sorgulama yapÄ±lan aya ait ilgili banka kartÄ± ile yapÄ±lan kart hareketleri gÃ¶rÃ¼ntÃ¼lenecektir. (Banka kartÄ± ile yapÄ±lan Para Ãekme/YatÄ±rma, banka kartÄ± ile yapÄ±lan POS'tan AlÄ±ÅveriÅ vb.). Banka kartÄ±nda dÃ¶nem deÄerinin \"-1\" gÃ¶nderilmesi durumunda bir Ã¶nceki aya ait kart hareketleri gÃ¶rÃ¼ntÃ¼lenecektir. \n Kart hareketleri yanÄ±tÄ±nda hareket bilgileri iÅlem tarihinine gÃ¶re sÄ±ralÄ± olarak iletilmelidir. Ä°Ålem tarihi en gÃ¼ncel tarihten geriye dÃ¶nÃ¼k olacak Åekilde listelenmelidir. \n Kart hareketlerinde ekstre tÃ¼rleri dÄ±ÅÄ±nda yapÄ±lan bir iÅlem varsa hangi ekstre tÃ¼rÃ¼ne dahil edilerek gÃ¶steriliyorsa gÃ¶nderilmelidir.\n \n Ãrn: 100 JPY'lik bir harcama iÅlemi TRY biriminde Ã§evirilip 23 TRY olarak TRY ekstre tÃ¼rÃ¼nde gÃ¶steriliyorsa ilgili iÅlem iÃ§in iÅlem tutarÄ± 23 TRY, orijinal iÅlem tutarÄ± ise 100 JPY olarak deÄerlendirilmelidir. \n \n \n \n Tablo 24: Kart Hareket Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n DÃ¶nem DeÄeri \n donemDegeri \n N3 \n Z \n Kart hareketlerinin sorgulanacaÄÄ± dÃ¶neme ait deÄerdir.  DÃ¶nem iÃ§i : 0 GeÃ§miÅ Ay/Ekstre : -1 ile -12 arasÄ± Taksit : 1 ile 18 arasÄ±  Provizyon : 99  Kart tipine gÃ¶re alabileceÄi dÃ¶nem deÄerleri ise ;  Banka KartÄ± : 0 ve -1 Kredi KartÄ± : -12 ile 18 arasÄ± ve 99 (Sanal alt kart tipi hariÃ§ diÄer tÃ¼m alt kart tiplerinde bu deÄerler geÃ§erlidir.)  Alt kart tipi sanal kart tipinde ise alabileceÄi deÄerler 0 ve 99'dur. Ãn Ãdemeli Kart : 0 ve -1 \n Ä°ptal statÃ¼sÃ¼nde olan kart tipleri iÃ§in geÃ§miÅe dÃ¶nÃ¼k hareket sorgulamasÄ± yapÄ±lamayacaktÄ±r. ÃrneÄin; Kredi KartÄ± iÃ§in -12 ile 18 arasÄ± olan dÃ¶nem deÄeri iptal statÃ¼sÃ¼nde olan kredi kartÄ± iÃ§in 0 ile 18 arasÄ±nda yapÄ±labilecektir.  TÃ¼m kart tipleri iÃ§in belirtilen dÃ¶nem deÄerinin uygun gÃ¶nderilmediÄi durumda hata verilmelidir. \n \n \n Ekstre Turu \n ekstreTuru \n AN3 \n K \n Kart bilgileri yanÄ±tÄ±nda dÃ¶nÃ¼len ekstre tÃ¼rleri deÄerlerini almaktadÄ±r. Para birimine uygun olarak kart detay bilgileri sorgulanmaktadÄ±r. Ekstre parametresi TRY,USD,EUR,GBP olarak gÃ¶nderilebilir. Bu alan gÃ¶nderilmiyorsa TRY deÄerlendirilmelidir. Ä°lgili para birimine Ã¶zel ekstre iÃ§indeki harcama deÄeri dÃ¶nÃ¼lecektir. \n Ekstre tÃ¼rleri haricinde uygun olmayan bir deÄer gÃ¶nderildiÄinde hata verilmelidir. \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n BorÃ§ Alacak GÃ¶stergesi \n brcAlc \n AN1 \n Ä° \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Karta borÃ§ yaratan iÅlem.A: Karta alacak yaratan iÅlem. N: Finansal olmayan iÅlem {âBâ,âAâ,âNâ} \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS kart hareketlerini  sÄ±ralama kriteri iÅlem tarihi  olacak Åekilde ilgili yÃ¶ne uygun olarak sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 25: âKartHareketleriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n

16Kart Tiplerine Ä°stinaden DetaylÄ± AÃ§Ä±klama \n \n \n \n \n Kart Referans NumarasÄ± \n kartRef \n AN5..40 \n Z \n HHS tarafÄ±ndan her bir kart iÃ§in atanan biricik deÄerdir (uuid). Bir kart tek bir kartRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir kartRef tek bir karta karÅÄ±lÄ±k gelmelidir. AynÄ± kart iÃ§in alÄ±nan tÃ¼m rÄ±zalarda kart referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n \n DÃ¶nem DeÄeri \n donemDegeri \n N3 \n Z \n Kart hareketlerinin sorgulanacaÄÄ± dÃ¶neme ait deÄerdir. \n \n \n \n DÃ¶nem BaÅlangÄ±Ã§ Tarihi \n donemBaslangicTarihi \n ISODate \n Z \n Sorgulama yapÄ±lan ekstre dÃ¶nemine gÃ¶re ilgili dÃ¶neme ait baÅlangÄ±Ã§ tarih bilgisidir. Kart tipi kredi kartÄ± olanlar iÃ§in ilgili dÃ¶neme ait baÅlangÄ±Ã§ tarihi iletilmelidir. Kart tipi banka kartÄ± ve Ã¶n Ã¶demeli kart olanlar iÃ§in sorgulama yapÄ±lan ayÄ±n baÅlangÄ±Ã§ tarihi iletilmelidir. \n \n \n \n DÃ¶nem BitiÅ Tarihi \n donemBitisTarihi \n ISODate \n Z \n Sorgulama yapÄ±lan ekstre dÃ¶nemine gÃ¶re ilgili dÃ¶neme ait bitiÅ tarih bilgisidir. Kart tipi kredi kartÄ± olanlar iÃ§in ilgili dÃ¶neme ait bitiÅ tarihi iletilmelidir. Kart tipi banka kartÄ± ve Ã¶n Ã¶demeli kart olanlar iÃ§in sorgulama yapÄ±lan ayÄ±n bitiÅ tarihi iletilmelidir. \n \n \n \n Ekstre TÃ¼rÃ¼ \n ekstreTuru \n AN3 \n Z \n Ekstre tÃ¼rÃ¼ TRY,USD,EUR,GBP olarak gÃ¶nderilebilir. Ä°stek paremetresinde iletilen deÄer ile aynÄ± deÄer olmalÄ±dÄ±r. \n \n \n \n Ekstre Borcu \n ekstreBorcu \n Kompleks:EkstreBorcu \n K \n Sorgulama yapÄ±lan geÃ§miÅ dÃ¶neme iÃ§in ekstre tÃ¼rÃ¼ne uygun olarak ekstre borcu iletilmelidir. MÃ¼Återinin borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir.  MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb(+) deÄer ile tutar bilgisi gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in sadece geÃ§miÅ dÃ¶nem deÄerine istinaden ilgili alan iletilmelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n BorÃ§ tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Asgari Ãdeme TutarÄ± \n asgariOdemeTutari \n Kompleks:AsgariOdemeTutari \n K \n Ä°lgili geÃ§miÅ dÃ¶nem iÃ§in ekstre tÃ¼rÃ¼ne uygun olarak ekstreye ait asgari Ã¶deme tutarÄ± iletilmelidir. Ekstre Borcu (-) ise; asgari Ã¶deme tutarÄ± da (-) deÄer olarak gÃ¶nderilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb.)  \"0\" (sÄ±fÄ±r) deÄeri gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in sadece geÃ§miÅ dÃ¶nem deÄerine istinaden ilgili alan iletilmelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Ãdeme tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n DÃ¶nem Taksit TutarÄ± \n donemTaksitTutari \n Kompleks:DonemTaksitTutari \n K \n Ä°stek parametresinde iletilen ilgili dÃ¶nem deÄeri iÃ§erisindeki toplam taksit tutar bilgisi iletilmelidir. MÃ¼Återinin DÃ¶nem Taksit Tutar borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. DÃ¶nem Taksit Tutar iadesi veya benzeri nedenlerle oluÅan mÃ¼Återinin alacaklÄ± olduÄu durumda tutar (+) deÄer gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in taksit bilgisi varsa ilgili alan iletilmelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n DÃ¶nem taksit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Hesap Kesim Tarihi \n hesapKesimTarihi \n ISODate \n K \n Karta ait sorgulanan dÃ¶neme ait hesap kesim tarihi iletilmelidir. Tarih formatÄ±nda iletilmelidir. Ãrn : 2024-11-23 \n Kart tipi kredi kartÄ± olanlar iÃ§in sadece geÃ§miÅ dÃ¶nem deÄerine istinaden ilgili alan iletilmelidir. \n \n \n Son Ãdeme Tarihi \n sonOdemeTarihi \n ISODate \n K \n Karta ait sorgulanan dÃ¶nem iÃ§in son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir. Ãrn : 2024-12-02 \n Kart tipi kredi kartÄ± olanlar iÃ§in sadece geÃ§miÅ dÃ¶nem deÄerine istinaden ilgili alan iletilmelidir. \n \n \n Hareket Bilgileri \n hareketBilgileri \n Kompleks Alan: HareketBilgileri[array] \n K \n Dizi halinde liste olacaktÄ±r. \n \n \n \n > Ä°Ålem NumarasÄ± \n islemNo \n AN3..50 \n Z \n Kart hareketinin oluÅturulmasÄ± sÄ±rasÄ±nda atanan ve borÃ§ (veya alacak) hareketini tekilleÅtiren HHS bazÄ±nda tekil tanÄ±mlayÄ±cÄ±dÄ±r. Bu deÄer tek baÅÄ±na tekil olabileceÄi gibi b

16irden fazla deÄerin bir araya getirilmesiyle de tekilliÄi saÄlanmÄ±Å olabilir. Bu deÄerin en azÄ±ndan kart referans numarasÄ± bazÄ±nda tekil olmasÄ± beklenir. Genellikle kullanÄ±lan Ã¶rnekleri; Instance_Id, Transaction_Id, Transaction_Num, Transaction_TimeStamp \n \n \n \n > Ä°Ålem TutarÄ± \n islemTutari \n Kompleks:IslemTutari \n Z \n YapÄ±lan iÅleme ait tutar bilgisi. Taksitli bir iÅlem ise ilgili dÃ¶nemdeki taksit tutarÄ± iletilecektir. ÃHK, HHS'de ilgili dÃ¶nem sorguladÄ±ÄÄ±nda hangi tutarÄ± gÃ¶rÃ¼ntÃ¼lÃ¼yorsa ilgili tutar dÃ¶nÃ¼lecektir. Ä°Åleme ait sadece puan bilgisiyle kazanÄ±m, kullanÄ±m, iade veya iptal varsa ve tutar bilgisi yoksa ilgili tutar deÄeri sÄ±fÄ±r gÃ¶nderilmelidir. Puana dair deÄerler ise PuanBilgileri alanÄ± iÃ§erisinde gÃ¶nderilmelidir. \n \n \n \n >> Tutar \n tutar \n AN1..24 \n Z \n Ä°Ålem tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n >> Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi. Ekstre tÃ¼rÃ¼ ile aynÄ± olmasÄ± gerekmektedir. \n \n \n \n > Orijinal Ä°Ålem TutarÄ± \n orijinalIslemTutari \n Kompleks:OrijinalIslemTutari \n K \n Ekstre tÃ¼rÃ¼ dÄ±ÅÄ±nda yapÄ±lan iÅleme ait tutar bilgisi. ÃrneÄin; ekstre tÃ¼rÃ¼ TRY gÃ¶nderildiÄi durumda iÅlem 100 JPY ise iÅlem tutarÄ± alanÄ±nda 100 deÄeri iletilmelidir. \n \n \n \n >> Tutar \n tutar \n AN1..24 \n Z \n Ä°Ålem tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n >> Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi. ÃrneÄin; 100 JPY ise iÅlem tutar para birimi alanÄ±nda JPY deÄeri iletilmelidir. \n \n \n \n > Ä°Ålem Tarihi \n islemTarihi \n ISODateTime \n Z \n Ä°Ålemin gerÃ§ekleÅtiÄi zaman bilgisi. Taksitli iÅlemlerde iÃ§inde bulunulan dÃ¶nem Ã¶zelinde ilgili taksitin yansÄ±yacaÄÄ± tarih deÄeri dÃ¶nÃ¼lmelidir. \n \n \n \n > BorÃ§ Alacak GÃ¶stergesi \n borcAlacak \n AN1 \n Z \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Karta borÃ§ yaratan iÅlem.A: Karta alacak yaratan iÅlem. N: Finansal olmayan iÅlem {âBâ,âAâ,âNâ} \n \n \n \n > Ä°Ålem AÃ§Ä±klamasÄ± \n islemAciklamasi \n AN1..200 \n Z \n AlÄ±ÅveriÅ iÅlemi olmasÄ± durumunda sadece iÅyeri adÄ±nÄ± iÃ§eren aÃ§Ä±klama, diÄer iÅlemler iÃ§in mevcut iÅlem aÃ§Ä±klamasÄ± iletilir. HHS'ler tÃ¼m kart hareketlerini YÃS'ler ile paylaÅmakla yÃ¼kÃ¼mlÃ¼ olup, hassas veri iÃ§eren(Ã¶rn: faiz, komisyon bilgisi iÃ§eren vb.) iÅlem hareketleri de bu kapsamda deÄerlendirilerek iÅlem aÃ§Ä±klamasÄ±nÄ±n maskeli olarak iletilmesi saÄlanÄ±r. Kelimelerin ilk 3 hanesi maskeli olacak Åekilde, ancak sakÄ±ncalÄ± bulunan kelimeler varsa; (Ã¶rn: faiz, komiyon vb.) kelimelerin tamamÄ± maskeli olacak Åekilde gÃ¶sterilebilir. \n \n \n \n > Ä°Ålem Puan Bilgileri \n islemPuanBilgileri \n Kompleks: IslemPuanBilgileri[Array] \n K \n Ä°lgili iÅlem sonrasÄ± kazanÄ±lan veya kullanÄ±lan bir puan deÄeri varsa iletilmesi gerekmektedir. Ä°lgili puan bilgi veya bilgileri dizi iÃ§erisinde iletilmelidir. \n Ä°lgili alanda koÅula uygun olarak deÄer dÃ¶nÃ¼lecekse; kart tipi kredi, banka ve Ã¶n Ã¶demeli kartÄ± olanlar iÃ§in dÃ¶nÃ¼lmesi zorunludur. \n \n \n >> Ä°Ålem PuanÄ± \n islemPuani \n AN1..24 \n K \n Ä°Åleme dair kazanÄ±lan veya kullanÄ±lan puan deÄeri iletilmelidir. Ãrn: 100 Plus kazanÄ±lmÄ±Å bir iÅlem iÃ§in 100 deÄeri iletilmelidir. \n \n \n \n >> Ä°Ålem Puan Birimi \n islemPuanBirimi \n AN1..50 \n K \n Ä°Åleme dair kazanÄ±lan veya kullanÄ±lan puan birimi iletilmelidir. Ãrn: 100 Plus kazanÄ±lmÄ±Å bir iÅlem iÃ§in Plus deÄeri iletilmelidir. \n \n \n \n >> Ä°Ålem Puan Durumu \n islemPuanDurumu \n AN2 \n K \n Ä°lgili iÅlem sonucunda puan bilgisinin bir kazanÄ±m, kullanÄ±m, iade ve iptal durumlarÄ±na yÃ¶nelik deÄer iletilmelidir. TR.OHVPS.DataCode.IslemPuanDurumu deÄerlerinden birini alÄ±r. 01: Puan KazanÄ±mÄ± 02: Puan KullanÄ±mÄ± 03: Puan Ä°ade 04: Puan Ä°ptal \n \n \n \n > Toplam Taksit TutarÄ± \n toplamTaksitTutari \n Kompleks:ToplamTaksitTutari \n K \n Ä°lgili iÅlem taksitli bir iÅlem ise o iÅleme ait toplam taksit tutarÄ± iletilmelidir. Ä°lgili iÅlem tek Ã§ekim bir iÅlem ise o iÅlemde ilgili alan iletilmemelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n >> Tutar \n tutar \n AN1..25 \n Z \n Taksit Tutar Bilgisi. Taksit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n >> Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n > Toplam Taksit SayÄ±sÄ± \n toplamTaksitSayisi \n N2 \n K \n Ä°lgili iÅlem taksitli bir iÅlem ise o iÅleme ait toplam taksit sayÄ±sÄ± iletilmelidir. Ä°lgili iÅlem tek Ã§ekim bir iÅlem ise o iÅlemde ilgili alan iletilmemelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Ä°lgili Taksit DÃ¶nemi \n taksitDonemi \n N2 \n K \n Taksitli iÅlem olmasÄ± durumunda iÅleme ait ilg

16ili taksit dÃ¶nem bilgisi. ÃrneÄin: 3 taksitli bir iÅlemde 2. taksit yansÄ±mÄ±Åsa 2 olarak gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > SatÄ±cÄ± Kategori Kodu \n saticiKategoriKodu \n AN4 \n K \n SatÄ±cÄ± Kategori Kodu(MCC) varsa iletilmesi zorunludur. AlÄ±ÅveriÅ iÅlemlerinde gÃ¶nderimi zorunludur. \n Ä°lgili alanda koÅula uygun olarak deÄer dÃ¶nÃ¼lecekse; kart tipi kredi ve banka kartÄ± olanlar iÃ§in dÃ¶nÃ¼lmesi zorunludur. \n \n \n \n"},{title:"2.Kapsam ve Dayanak",frontmatter:{},regularPath:"/v2.0.0/contents/kapsam-ve-dayanak.html",relativePath:"v2.0.0/contents/kapsam-ve-dayanak.md",key:"v-143b3106",path:"/v2.0.0/contents/kapsam-ve-dayanak.html",content:" 2.Kapsam ve Dayanak \n 12 KasÄ±m 2019âda gÃ¼ncellenen â 6493 sayÄ±lÄ± Ãdeme ve Menkul KÄ±ymet Mutabakat Sistemleri, Ãdeme Hizmetleri ve Elektronik Para KuruluÅlarÄ± HakkÄ±nda Kanun âun (Kanun) 12ânci maddesine yeni eklenen ve  Ãdeme Hizmetleri Direktifi 2 'de (Payment Services Directive 2, PSD2) bulunan iki yeni Ã¶deme hizmeti aÅaÄÄ±daki gibi tanÄ±mlanmÄ±ÅtÄ±r (Åekil-1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri): \n \n Ãdeme Emri BaÅlatma Hizmeti : ÃHKânÄ±n isteÄi Ã¼zerine baÅka bir Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nda bulunan  Ã¶deme hesabÄ±yla  ilgili sunulan Ã¶deme emri baÅlatma hizmeti [Madde 12, birinci fÄ±kra, (f) bendi] \n Hesap Bilgisi Hizmeti : ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± koÅuluyla, ÃHKânÄ±n Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ± nezdinde bulunan bir veya daha fazla  Ã¶deme hesabÄ±na  iliÅkin konsolide edilmiÅ bilgilerin Ã§evrim iÃ§i platformlarda sunulmasÄ± hizmeti [Madde 12, birinci fÄ±kra, (g) bendi] \n \n   \n Åekil 1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS)- tanÄ±tÄ±m \n Kanunun 14/A maddesinin ikinci fÄ±krasÄ±na gÃ¶re , Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetleri ile ilgili iÅlemlerin yÃ¼rÃ¼tÃ¼lmesine iliÅkin usul ve esaslar ile taraflarca uyulmasÄ± gereken teknik ve operasyonel gereklilikler ikincil dÃ¼zenlemeler uyarÄ±nca TÃ¼rkiye Cumhuriyet Merkez BankasÄ± (TCMB) tarafÄ±ndan belirlenir. Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri  Ã¶deme hizmetleri veri paylaÅÄ±m servisleri (ÃHVPS)  olarak adlandÄ±rÄ±lmaktadÄ±r. \n Ãdeme Hizmetleri ve Elektronik Para Ä°hracÄ± ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± HakkÄ±nda YÃ¶netmelikâin (YÃ¶netmelik) 59âuncu maddesinin birinci fÄ±krasÄ± uyarÄ±nca hazÄ±rlanan bu belgede sÃ¶z konusu Ã¶deme hizmetlerini sunacak Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, Ã¶deme hesabÄ±nÄ±n bulunduÄu Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, varsa ilgili diÄer taraflarÄ±n ve bu hizmetlerin sunulmasÄ± iÃ§in taraflar arasÄ±nda kurulacak baÄlantÄ±nÄ±n teknik ve operasyonel gereklilikleri aÃ§Ä±klanmaktadÄ±r. \n DÃ¼zenlemeler kapsamÄ±nda yetkilendirilen Ã¼Ã§Ã¼ncÃ¼ taraf hizmet saÄlayÄ±cÄ±sÄ±  (Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ±, YÃS) , Ã¶deme hizmeti kullanÄ±cÄ±larÄ±nÄ±n  Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS)  nezdindeki Ã¶deme hesaplarÄ±na ulaÅarak Ã¶deme emri baÅlatma ve hesap bilgisi saÄlama hizmetlerinden (Ã¶deme hizmetleri veri paylaÅÄ±m servislerinden) faydalanmasÄ±na aracÄ±lÄ±k eder. Ãdeme hizmetleri veri paylaÅÄ±m servisleri kapsamÄ±nda iki tip YÃS bulunmaktadÄ±r:  1) Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ve 2) Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS). \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ÃHKânÄ±n farklÄ± Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS) nezdindeki hesaplarÄ±nÄ±n bilgilerini derleyerek Ã§evrim iÃ§i platformlarda  toplu Åekilde  sunar. Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS) ise talebi Ã¼zerine ÃHKânÄ±n HHSâde bulunan Ã¶deme hesabÄ±ndan Ã¶deme iÅlemi baÅlatÄ±r. \n ÃHVPSânin Ã¼st dÃ¼zey gÃ¶sterimi Åekil-2âde verilmiÅtir. \n   \n Åekil 2: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS) -Ã¼st dÃ¼zey gÃ¶sterim \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servislerinin HHSâler tarafÄ±ndan  GEÃÄ°T  vasÄ±tasÄ±yla sunulduÄu uygulama mimarisi ise Åekil-3âte sunulmuÅtur. \n  \n Åekil 3: ÃHVPS'nin GEÃÄ°T vasÄ±tasÄ±yla sunumu \n"},{title:"7.\tÄ°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v2.0.0/contents/ileri-tarihli-odeme-emri-hizmeti.html",relativePath:"v2.0.0/contents/ileri-tarihli-odeme-emri-hizmeti.md",key:"v-c07c3efa",path:"/v2.0.0/contents/ileri-tarihli-odeme-emri-hizmeti.html",headers:[{level:2,title:"Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"ileri-tarihli-odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"7.1.\tADIM 0 - Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± BaÅlatma IsteÄi",slug:"_7-1-adim-0-ileri-tarihli-odeme-emri-rÄ±zasÄ±-baslatma-istegi"},{level:2,title:"7.2.\tADIM 1 - Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_7-2-adim-1-ileri-tarihli-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"7.3.\tADIM 2- Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_7-3-adim-2-ileri-tarihli-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"7.4.\tADIM 2.1 â Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_7-4-adim-2-1-ileri-tarihli-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"7.5.\tADIM 3- Ä°leri Tarihli Ãdeme Emrinin OluÅturulmasÄ±",slug:"_7-5-adim-3-ileri-tarihli-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"7.6.\tADIM 3.1- Ä°leri Tarihli Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_7-6-adim-3-1-ileri-tarihli-odeme-emri-sorgusu-istege-baglÄ±"},{level:2,title:"7.7.\tADIM 4- Ä°leri Tarihli Ãdeme Emri RÄ±za Ä°ptali",slug:"_7-7-adim-4-ileri-tarihli-odeme-emri-rÄ±za-iptali"}],content:" 7.\tÄ°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti \n Ãdeme hizmeti kullanÄ±cÄ±sÄ±nÄ±n ileri bir tarihte gerÃ§ekleÅmesini istediÄi Ã¶deme emirlerinde bu hizmeti kullanabilir. Ãdemenin Havale / PÃS / FAST Ã¶deme sistemlerinden hangisi ile gerÃ§ekleÅeceÄine, Ã¶deme gÃ¼nÃ¼ geldiÄinde HHS karar verir. \n Ä°leri tarihli Ã¶deme hizmetini online bankacÄ±lÄ±k sistemlerinde sunan HHS'lerin, ÃHVPS Ã¼zerinden bu hizmetleri sunmasÄ± zorunludur. Mevcutta online kanallarÄ±ndan bu hizmeti sunduklarÄ± mÃ¼Återi segmentine (bireysel,kurumsal vb.), ÃHVPS Ã¼zerinden hizmet sunmaya devam etmeleri gerekmektedir. YÃS, bireysel mÃ¼Återi Ã¶zelinde ileri tarihli Ã¶deme hizmeti vermeyen HHS'ye ileri tarihli bir Ã¶deme emri rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.IndividualCustomerNotSupported\"  hatasÄ± , kurumsal mÃ¼Återi Ã¶zelinde ileri tarihli Ã¶deme emri rÄ±zasÄ± isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  TR.OHVPS.Business.CorporateCustomerNotSupported  hatasÄ± verilmelidir. \n HHS'ler ileri tarihli Ã¶deme emri hizmetini sunuÅ bilgilerini HHS API aracÄ±lÄ±ÄÄ± ile yayÄ±nlayacaklardÄ±r. YÃS, ileri tarihli Ã¶deme hizmeti baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\":\"02\" parametresi ile alabilir. YÃS, ileri tarihli Ã¶deme hizmeti sunmayan HHS'ye ileri tarihli bir Ã¶deme emri rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.ScheduledPaymentNotSupported  hatasÄ±

16iletilmelidir. \n Ä°leri tarihli Ã¶deme emri hizmetinde TRY dÄ±ÅÄ±ndaki yabancÄ± para birimleri iÃ§in HHS tarafÄ±ndan destek verilmemesi durumunda  TR.OHVPS.Business.InvalidCurrencyCode  hataasÄ± verilmelidir. \n Ä°leri tarihli Ã¶deme emri gÃ¼ncelleme hizmeti YÃS Ã¼zerinden yapÄ±lamayacaktÄ±r. ÃHK aktif olan dÃ¼zenli Ã¶deme talimat rÄ±zasÄ±nÄ± iptal ederek, yeniden oluÅturabilecektir. \n HHS Ã¼zerinden ilgili gÃ¼ncelleme hizmeti saÄlanabilir. Ä°leri tarihli talimat iÃ§erisinde yapÄ±lan gÃ¼ncelleme sonucunda olay bildirim ile YÃS'e bildirim saÄlanacaktÄ±r. HHS Ã¼zerinden gÃ¼ncelleme yapÄ±lÄ±rken talimat tarihine dair ileri bir tarihe gÃ¼ncelleme adÄ±mÄ± olmamalÄ±dÄ±r. Sadece ilk oluÅturulan talimat tarihinden Ã¶ncesi olacak Åekilde gÃ¼ncelleme yapÄ±lmasÄ±na izin verilmelidir. \n Ä°leri Tarili Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n Ä°leri Tarihli Ãdeme Emri RÄ±za BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden ileri tarihli Ã¶deme emrini baÅlatÄ±r. \n Ä°leri Tarihli Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âÄ°leri Tarihli Ãdeme Emri BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve ileri tarihli Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n Ä°leri Tarihli Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âileri tarihli Ã¶deme emriâni HHSâye iletir. \n Ä°leri Tarihli Ãdeme Emri RÄ±za Durumu, Ä°leri Tarihli Ãdeme Emri Durumu, Ä°leri Tarihli Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, Ä°leri Tarihli Ãdeme Emri RÄ±za Durumu, Ä°leri Tarihli Ãdeme Emri Durumu, Ä°leri Tarihli Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±)  mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin hem HBH hem de ÃBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini(Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n YÃS'ler gÃ¶nderen hesap seÃ§imini aÅaÄÄ±daki yÃ¶ntemlerden biri ya da birkaÃ§Ä± ile saÄlayabilirler: \n \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± HHS ekranÄ±ndan seÃ§tirebilir. \n YÃS, mÃ¼Återisinden Hesap Bilgisi rÄ±zasÄ± alÄ±r. RÄ±za aldÄ±ÄÄ± hesaplar Ã¼zerinden hesap referansÄ± aracÄ±lÄ±ÄÄ± ile ileri tarihli Ã¶deme emri baÅlatabilir. \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± elle girmesine olanak tanÄ±yabilir. IBAN'Ä± olmayan HHS'ler ileri tarihli Ã¶deme emri rÄ±zasÄ± adÄ±mÄ±nda  TR.OHVPS.Business.IBANNotSupported  hatasÄ±nÄ± vermelidir. IBAN'Ä± olan HHS'lerin bu akÄ±ÅÄ± desteklemesi zorunludur. \n YÃS; mÃ¼Återisinin hesap referansÄ±nÄ± elle girmesini saÄlayabilir. Hesap ReferansÄ± bilgisi ile baÅlatÄ±lan ileri tarihli Ã¶deme emri iÅlemlerinde HHS seÃ§imi zorunludur. \n \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in, YÃS'ler hesap referansÄ± ile Ã¶deme baÅlatabilirler. BunlarÄ±n dÄ±ÅÄ±ndaki HHS'lerin, gÃ¶nderen IBAN veya hesap referansÄ± ile Ã¶deme akÄ±ÅÄ±nÄ± desteklemesi zorunludur. \n Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. Ãdeme Emri Hizmeti ile aynÄ± etki alanÄ±(scope) kullanÄ±lmaktadÄ±r. \n Tablo : Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n ileri-tarihli-odeme-emri-rizasi \n POST \n /ileri-tarihli-odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n IleriTarihliOdemeEmriRizasiIstegi \n Iler

16iTarihliOdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 3 \n ileri-tarihli-odeme-emri-rizasi \n GET \n /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n IleriTarihliOdemeEmriRizaYaniti \n \n \n 4 \n ileri-tarihli-odeme-emri \n POST \n /ileri-tarihli-odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n IleriTarihliOdemeEmriIstegi \n IleriTarihliOdemeEmri \n \n \n 5 \n ileri-tarihli-odeme-emri \n GET \n /ileri-tarihli-odeme-emri/{odmEmriNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n IleriTarihliOdemeEmri \n \n \n 6 \n ileri-tarihli-odeme-emri-rizasi-iptal \n DELETE \n /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n - \n - \n - \n 7.1.\tADIM 0 - Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) ileri tarihli Ã¶deme emri rÄ±zasÄ± sÃ¼recini baÅlatÄ±r. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 7.2.\tADIM 1 - Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil : Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (ileriTarihliOdemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ olduÄu geÃ§it tarafÄ±ndan kontrol edilir. \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahipliÄi geÃ§it tarafÄ±ndan kontrol edilir. \n HHS tarafÄ±ndan, istek baÅlÄ±ÄÄ±ndaki x-aspsp-code ile katilimciBlg iÃ§erisinde yer alan hhsKod deÄeri ile aynÄ± olduÄunu kontrol edilir. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, ileri tarihli Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren ileriTarihliOdemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /ileri-tarihli-odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir IleriTarihliOdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, ileri tarihli Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS'ler ileri tarihli Ã¶deme emri hizmetini sunuÅ bilgilerini HHS API aracÄ±lÄ±ÄÄ± ile yayÄ±nlayacaklardÄ±r. YÃS, ileri tarihli Ã¶deme hizmeti baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\":\"02\" parametresi ile alabilir. YÃS, ileri tarihli Ã¶deme hizmeti sunmayan HHS'ye ileri tarihli bir Ã¶deme emri rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.ScheduledPaymentNotSupported  hatasÄ±

16iletilmelidir. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hata kodu iletilmeli ve fieldErrors dolu olacak Åekilde hatalÄ± alanÄ± belirten detaylÄ± aÃ§Ä±klama gÃ¶nderilmelidir. InvalidFormat hata kodlarÄ±nda fieldErrors iÃ§eriÄi gÃ¶nderilmeli ve anlaÅÄ±lÄ±r aÃ§Ä±klama ile message, messageTr alanlarÄ± doldurulmasÄ± zorunludur. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, bireysel mÃ¼Återi Ã¶zelinde ileri tarihli Ã¶deme hizmetini kendi kanallarÄ±nda sunmuyor ise HHS'ye ileri tarihli bir Ã¶deme emri rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.IndividualCustomerNotSupported\"  hatasÄ± ,\nkurumsal mÃ¼Återi Ã¶zelinde ileri tarihli Ã¶deme emri rÄ±zasÄ± isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CorporateCustomerNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme adresleri ile ileri tarihli Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.TPPRedirectionAddressMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; kimlik bilgileri nesnesinde yer alan kimlik bilgisi ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (KoÅullu Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.CustomerNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n âAÃ§Ä±k BankacÄ±lÄ±k Kanal Yetkiâ tanÄ±mÄ± yok ise  \"TR.OHVPS.Business.OpenBankingChannelClosed\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n Ä°leri tarihli Ã¶deme emri rÄ±zasÄ±nda alÄ±cÄ± hesap bilgileri Karekod ya da Kolas ile belirlenebilir. HHS online kanallarÄ±nda ileri tarihli Ã¶deme hizmetini Karekod ve Kolas aracÄ±lÄ±ÄÄ± ile kabul ediyorsa, ÃHVPS servisleri ile de kabul etmek zorundadÄ±r. YÃS tarafÄ±ndan ileri tarihli Ã¶deme emri rÄ±zasÄ± isteÄi iÃ§erisinde alÄ±cÄ± bilgisi iÃ§in karekod ya da kolas kompleks alanlarÄ± yer almasÄ± durumunda , destek vermeyen HHS'ler tarafÄ±ndan  TR.OHVPS.Business.RecipientAccountTypeNotSupported  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir. \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.DecoupledAuthenticationNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  \"TR.OHVPS.Business.EventSubscriptionNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin, ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerInfoMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerMobileApplicationNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n HHS kimlik bilgisi ile gÃ¶nderen Ã¼nvanÄ±nÄ±n uyumlu olduÄunu kontrol eder. HHS'ler EFT/FAST iÅlemlerinde kabul ettikleri kontrol kriterleri ile iÅleme izin verebilirler. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.IncorrectSenderTitle\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n GÃ¶nderen Hesap NumarasÄ± ÃBHS tarafÄ±ndan iletildiÄi durumda;\n \n IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.InvalidAccount\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountCodeMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu kontrol edilir.Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.CustomerAccountMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. (Ä°lgili hesabÄ±n para transfer iÅlemine yetkisi olmamasÄ±) Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountUnauthorized\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâde gÃ¶nderen hesabÄ±n aktifliÄi kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountInactive\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n GÃ¶nderen Hesap NumarasÄ± iÃ§in, He

16sap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile ileri tarihli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  \"TR.OHVPS.Business.ActiveConsentNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Talimat tarihi, talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±, maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. Belirtilen tarih aralÄ±ÄÄ± dÄ±ÅÄ±nda ÃBHS tarafÄ±ndan talimat tarihi iletilmesi durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.InvalidOrderDateRange\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Talimati tarih bilgisi iÃ§in Ã¶deme gÃ¼nÃ¼nÃ¼n iÅ gÃ¼nÃ¼ne gelmediÄi ve HHS'nin FAST/Havale ile anlÄ±k Ã¶deme baÅlatamadÄ±ÄÄ± durumda,  HHS tarafÄ±dan  \"TR.OHVPS.Business.OrderDateNotWorkDay\"  hata mesajÄ± ile iÅlemi kesmelidir. YÃS, ÃHK'ya tarih bilgisini gÃ¼ncelletebilir ya da kendisi otomatik atama yapabilir. SonrasÄ±nda tekrar rÄ±za talebinde bulunmalÄ±dÄ±r. \n AlÄ±cÄ± ve gÃ¶nderen hesabÄ±n aynÄ± olmasÄ± durumunda  âTR.OHVPS.Business.SenderRecipientSameâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n MÃ¼Återinin kendi hesaplarÄ± arasÄ±nda talimat veremeyeceÄi durumlarÄ±n kontrolÃ¼ iÃ§in  âTR.OHVPS.Business.SameAccountTransferRestrictedâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, Ã¶deme iÃ§in benzersiz âRizaNoâ ile âIleriTarihliOdemeEmriRizasiâ nesnesi oluÅturur ve ÃBHSâye dÃ¶ner. \n HHS, IleriTarihliOdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n Hesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK ileri tarihli Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n  BAÅARILI Ä°STEK: \n Tablo : âIleriTarihliOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan ileri tarihli Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.ohkTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir para birimi olduÄu kontrol eder. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda ileri tarihli Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile ileri tarihli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, HspRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n Ã¼nvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n TalimatÄ±n gerÃ§ekleÅeceÄi ana kadar KOLAS tanÄ±mÄ±nÄ±nda deÄiÅiklik olabileceÄi iÃ§in,  KOLAS ile yapÄ±lan ileri tarihli iÅlemler, talimatÄ±n verildiÄi anda Ã§Ã¶zÃ¼len IBAN'a yapÄ±lacaktÄ±r. \n Kolas ile ileri tarihli Ã¶deme emri hizmeti desteklenmiyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir. \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n Karekod ile yapÄ±lan ileri tarihli iÅlemler, talimatÄ±n verildiÄi anda Ã§Ã¶zÃ¼len IBAN'a yapÄ±lacaktÄ±r. \n Karekod ile ileri tarihli Ã¶deme emri hizmeti desteklenmiyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir. \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n HHS, YÃS'Ã¼n API deseninde \"O\" kodunu ilettiÄini kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarÄ±nda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.   -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tÄ°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n YÃS bu deÄeri ÃHKâyÄ± HHSâye yÃ¶nlendirmeden Ã¶nceki ekranda gÃ¶stermeli, ve HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak yine ÃHKâya gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n \n >> Talimat Tarihi \n tlmtTrh \n ISODate \n Z \n ÃHK tarafÄ±ndan talep edilen, Ã¶deme gerÃ§ekleÅme zamanÄ±dÄ±r. \n Talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±,maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âIleriTarihliOdemeEmriRizasiâ nesnesi Tabloâda parametrelerden oluÅur: \n Tablo : âIleriTarihliOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n >

16 RÄ±za No \n rizaNo \n AN1..128 \n Z \n IleriTarihliOdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n IleriTarihliOdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n IleriTarihliOdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.   Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen Ã¼nvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.    Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Talimat Tarihi \n tlmtTrh \n ISODate \n Z \n ÃHK tarafÄ±ndan talep edilen, Ã¶deme gerÃ§ekleÅme zamanÄ±dÄ±r. Talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±,maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. Belirtilen tarih aralÄ±ÄÄ± dÄ±ÅÄ±nda ÃBHS tarafÄ±ndan talimat tarihi iletilmesi durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.InvalidOrderDateRange  hatasÄ± verilmelidir. \n 7.3.\tADIM 2- Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil : Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n ileri tarihli Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=I&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=I&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak

16iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=I&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n ileri tarihli Ã¶deme emri rÄ±zasÄ±nÄ± baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK, bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS, ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 7.4.\tADIM 2.1 â Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âIleriTarihliOdemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda ileri tarihli Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle,  IleriTarihliOdemeEmriRizasi  nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -Ileri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  IleriTarihliOdemeEmriRizasi  nesnesine iÅler. \n \n Sorgulama yapÄ±lan Ä°leri Tarihli Ãdeme Emri HHS tarafÄ±nda bulunmuyor ise  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n GET /ileri-tarihli-odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  IleriTarihliOdemeEmriRizasi  kaynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n Durum \n IleriTarihliOdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n Ä°leri Tarihli Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /ileri-tarihli-odeme-emri-rizasi/{rizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âIleriTarihliOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âIleriTarihliOdemeEmriRizasiâ nesnesi oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âIleriTarihliOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /ileri-tarihli-odeme-emri-rizasi/{rizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âIleriTarihliOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n 7.5.\tADIM 3- Ä°leri Tarihli Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Ä°leri Tarihli Ãdeme Emrinin OluÅturulmasÄ± \n POST /ileri-tarihli-odeme-emri \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS OdemeEmri kaynaÄÄ±nÄ± oluÅturur. \n Ä°leri Tarihli Ãdeme emri (IleriTarihliOdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r. \n \n EriÅim Belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir EriÅim Belirteci yok ise  \"TR.OHVPS.Connection.InvalidToken\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini y

16apar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor, Y: Yetkilendirildi  ya da E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n POST /ileri-tarihli-odeme-emri-rizasi ile POST /ileri-tarihli-odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r. Ä°leri Tarihli Ãdeme Emri rÄ±zasÄ±nda gÃ¶nderilen deÄerlerden farklÄ± bir deÄer gÃ¶nderildiÄi durumda  âTR.OHVPS.Business.FieldMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra, iÃ§erisinde odmEmriNo ve odmDrm deÄiÅkenleri de bulunan IleriTarihliOdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n \n POST verisindeki GÃ¶nderen Hesap NumarasÄ± ve AlÄ±cÄ± Hesap NumarasÄ±nÄ±n aynÄ± bankaya aitse HAVALE deÄilse FAST veya PÃS iÅ akÄ±ÅÄ±na geÃ§ilir. \n \n BAÅARILI Ä°STEK: \n Tablo 9: âIleriTarihliOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan ileri tarihli Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n >YÃ¶nlendirme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n >AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur. yetYntm = Y iÃ§in bu nesne iletilmemelidir. \n \n \n \n >>OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >>OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n \n \n >Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde,

161. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± ileri tarihli Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Ä°Ålem TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS iÅlem tutarÄ± Ã¶deme mesajÄ±nda (Havale/FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n Ttr \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda ileri tarihli Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi ileri tarihli Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n KolasRef ( hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. \n RefBlg (Hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n FAST/PÃS Acklm \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n \n \n >> Talimat Tarihi \n tlmtTrh \n ISODate \n Z \n ÃHK tarafÄ±ndan talep edilen, Ã¶deme gerÃ§ekleÅme zamanÄ±dÄ±r. Talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±,maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. \n \n \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âIleriTarihliOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âIleriTarihliOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n Z \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Emir Bilgileri \n emrBlg \n Kompleks: EmirBilgileri \n Z \n \n \n \n >

16 Ãdeme Emri NumarasÄ± \n odmEmriNo \n AN1..128 \n Z \n IleriTarihliOdemeEmri nesnesinin UID'sidir. IleriTarihliOdemeEmri Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Ãdeme Emri Zaman \n odmEmriZmn \n ISODateTime \n Z \n IleriTarihliOdemeEmri nesnesinin oluÅturulduÄu zaman bilgisi. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GerÃ§ekleÅen Ä°Ålem TutarÄ± \n grckIslTtr \n Kompleks:GerceklesenTutar \n K \n odmDrm:01 ,02 ve 06 olduÄu durumda gÃ¶nderilmesi zorunludur. Ãdeme durumu 01 ve 02 durumlarÄ±nda gerÃ§ekleÅtirilen tutarÄ±n tamamÄ± bu alanda iletilmelidir. Ãdeme durumu: 06 olan kÄ±smi Ã¶deme iÅlemlerinde ise gerÃ§ekleÅen tutar bilgisi iletilmelidir. \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n Talimat gerÃ§ekleÅtiÄinde Ã¶deme yapÄ±lan tutar bilgisi.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.  Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>>

16 Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ  deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme Durumu \n odmDrm \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r.      Ãdeme Durumu alanÄ± ile ilgili olarak HHSâler tarafÄ±ndan YÃSâlere  IleriTarihliOdemeEmri servisi yanÄ±tÄ±nda  04:Onayda Bekliyor, 05:Ãdeme Bekleniyor yanÄ±tlarÄ± gÃ¶nderilebilir. 04:Onayda Bekliyor  ve  05:Ãdeme Bekleniyor  durumlarÄ± oluÅtuktan sonra YÃS tarafÄ±ndan ileri tarihli Ã¶deme emri sorgulamasÄ± yapÄ±larak Ã¶deme durumunun gÃ¼ncel deÄeri Ã¶Ärenilir. GÃ¼ncel deÄerler  01:GerÃ§ekleÅti,03:GerÃ§ekleÅmedi , 06:KÄ±smen GerÃ§ekleÅti  ve  07:Ä°ptal Edildi  durumlarÄ± olabilir. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n K \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. odmDrm:01, 02 ve 06 olduÄu durumda gÃ¶nderilmesi zorunludur. \n \n \n >> Ãdeme Sistem NumarasÄ± \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. Havale/FAST/PÃS  Ã¶deme yÃ¶ntemleri iÃ§in tarih alanÄ± yyyy-aa-gg formatÄ±nda 10 karakter olarak

16iletilmelidir. odmDrm:01, 02 ve 06 olduÄu durumda gÃ¶nderilmesi zorunludur. \n \n \n >> Talimat Tarihi \n tlmtTrh \n ISODate \n Z \n ÃHK tarafÄ±ndan talep edilen, Ã¶deme gerÃ§ekleÅme zamanÄ±dÄ±r. Talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±,maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. \n \n \n >> GerÃ§ekleÅen Ãdeme ZamanÄ± \n grckOdmZmn \n ISODateTime \n K \n GerÃ§ekleÅen Ã¶deme iÅlemine ait zaman bilgisi. odmDrm:01, 02 ve 06 olduÄu durumda gÃ¶nderilmesi zorunludur. \n 7.6.\tADIM 3.1- Ä°leri Tarihli Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Ä°leri Tarihli Ãdeme Emri Sorgusu \n GET /ileri-tarihli-odeme-emri/{odmEmriNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla ileri tarihli Ã¶deme emrini sorgulayabilir. Maksimum Ã¶demenin gerÃ§ekleÅeceÄi gÃ¼nÃ¼n 15 gÃ¼n sonrasÄ±na kadar sorgulama yapÄ±labilir. SonrasÄ±nda yapÄ±lacak sorgulamalarda eriÅim belirtecinin yetki sÃ¼resi sonlandÄ±ÄÄ± iÃ§in HHS  \"TR.OHVPS.Resource.ConsentRevoked\" Â hatasÄ±nÄ± dÃ¶nmelidir.\nÄ°ptal edilmiÅ talimatÄ±n bilgileri sorgulanmak istendiÄinde de yine  \"TR.OHVPS.Resource.ConsentRevoked\" Â hatasÄ± verilmelidir. \n YÃS sadece kendi uygulamasÄ± Ã¼zerinden verilmiÅ ileri tarihli Ã¶demeleri sorgulayabilir. EriÅim izni olmayan bir Ã¶deme emri numarasÄ± ile sorgulama yaptÄ±ÄÄ±nda HHS'den  \"TR.OHVPS.Resource.NotFound\"  hatasÄ±nÄ± alÄ±r. \n KÄ±smi Ã¶demelerde, kÄ±smen gerÃ§ekleÅen Ã¶deme tutarÄ±, \"gerÃ§ekleÅen iÅlem tutarÄ±\"(grckIslTtr) alanÄ±nda gÃ¶nderilirken, gÃ¶nderilmesi talep edilen tutar alanÄ±(rÄ±za baÅlatma isteÄinde ki tutar) da \"iÅlem tutarÄ±\"(islTtr) alanÄ±nda gÃ¶nderilmeye devam edilmelidir. \n GerÃ§ekleÅen iÅlem tutarÄ± ve para birimi, Ã¶deme gerÃ§ekleÅme zamanÄ± alanlarÄ±, Ã¶deme gÃ¼nÃ¼nden itibaren dolu olarak gelir. \n BAÅARILI YANIT: \n GET /ileri-tarihli-odeme-emri/{odmEmriNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âIleriTarihliOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âIleriTarihliOdemeEmriâ nesnesi dÃ¶ner. \n 7.7.\tADIM 4- Ä°leri Tarihli Ãdeme Emri RÄ±za Ä°ptali \n \n Åekil 10: Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± Ä°ptali \n DELETE /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla ileri tarihli Ã¶deme emri rÄ±zasÄ±nÄ± iptal edebilir. \n DELETE /ileri-tarihli-odeme-emri-rizasi Ã§aÄrÄ±sÄ±, bir ÃBHS'nin Ã¶nceden oluÅturulmuÅ bir ileri tarihli Ã¶deme emri rÄ±zasÄ±nÄ± silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, ÃBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \n \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±za, silinen rizaNo bilgisi ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°ptal edilmek istenen Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± HHS tarafÄ±nda bulunmuyor ise  âTR.OHVPS.ResourceNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S veya Yetki Ä°ptal - I ise  \"TR.OHVPS.Resource.ConsentRevoked\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°ptal edilmek istenen Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±ânÄ±n Ã¶deme durumu 04 ya da 05 deÄil ise  âTR.OHVPS.Business.TransactionCompletedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±da kontroller baÅarÄ±yla tamamlandÄ±ktan sonra sÄ±rasÄ±yla aÅaÄÄ±daki iÅlemler yapÄ±lÄ±r. \n \n odmDrm deÄeri 04 ve 05 olan kayÄ±tlar 07 durum kodu ile gÃ¼ncellenmelidir. \n Ä°liÅkili ileri tarihli Ã¶deme emri talimatÄ± iptal edilmelidir. \n RÄ±za iptal edilmelidir. \n \n Bu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin ÃBHS Ã¼zerinden ileri tarihli Ã¶deme emri rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki ileri tarihli Ã¶deme emri rÄ±zasÄ± nesnesinin silinmesini saÄlar.\nMÃ¼Återinin ÃBHSânin veri eriÅim iznini iptal etmesi durumunda ÃBHS, HHSâde mevcut olan IleriTarihliOdemeEmriRizasi'na dair rÄ±za ve talimat bilgilerini pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa\nDELETE /ileri-tarihli-odeme-emri-rizasi/{RizaNo}

16\nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. \n Servis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r.\nÃHK rÄ±zasÄ± YÃS Ã¼zerinden baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ ve durum kodu \"03\" olarak gÃ¼ncellenir ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir.\nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir:\nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (ÃBHS) \n"},{title:"6.\tÃdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v2.0.0/contents/odeme-emri-baslatma-hizmeti.html",relativePath:"v2.0.0/contents/odeme-emri-baslatma-hizmeti.md",key:"v-29ce59bd",path:"/v2.0.0/contents/odeme-emri-baslatma-hizmeti.html",headers:[{level:3,title:"Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi",slug:"_6-1-adim-0-odeme-emri-baslatma-istegi"},{level:2,title:"6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_6-2-adim-1-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_6-3-adim-2-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_6-4-adim-2-1-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ±",slug:"_6-5-adim-3-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_6-6-adim-3-1-odeme-emri-sorgusu-istege-baglÄ±"},{level:3,title:"GET /odeme-emri/{odemeEmriNo}",slug:"get-odeme-emri-odemeemrino"}],content:" 6.\tÃdeme Emri BaÅlatma Hizmeti \n Ãdeme emri baÅlatma iÅlemi havale, FAST ya da PÃS Ã¶demesiyle sonuÃ§lanabilir. Ãdeme iÅleminin amacÄ± kiÅiden kiÅiye para transferi, e-ticaret Ã¶demesi gibi farklÄ± Ã¶deme tÃ¼rleri olabilir. Ãdemenin amacÄ±na gÃ¶re ÃBHSânin ileteceÄi veri setinde farklÄ±laÅmalar olabilir. \n Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n Ãdeme Emri BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden Ã¶deme emrini baÅlatÄ±r. \n Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âÃdeme Emri BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âÃ¶deme emriâni HHSâye iletir. \n Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±)  mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin hem HBH hem de ÃBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini(Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n YÃS'ler gÃ¶nderen hesap seÃ§imini aÅaÄÄ±daki yÃ¶ntemlerden biri ya da birkaÃ§Ä± ile saÄlayabilirler: \n \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± HHS ekranÄ±ndan seÃ§tirebilir. \n YÃS, mÃ¼Återisinden Hesap Bilgisi rÄ±zasÄ± alÄ±r. RÄ±za aldÄ±ÄÄ± hesaplar Ã¼zerinden hesap referansÄ± aracÄ±lÄ±ÄÄ± ile Ã¶deme emri baÅlatabilir. \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± elle girmesine olanak tanÄ±yabilir. IBAN'Ä± olmayan HHS'ler Ã¶deme emri rÄ±zasÄ± adÄ±mÄ±nda  TR.OHVPS.Business.IBANNotSupported  hatasÄ±nÄ± vermelidir. IBAN'Ä± olan HHS'lerin bu akÄ±ÅÄ± desteklemesi zorunludur. \n YÃS; mÃ¼Återisinin hesap referansÄ±nÄ± elle girmesini saÄlayabilir. Hesap ReferansÄ± bilgisi ile baÅlatÄ±lan Ã¶deme emri iÅlemlerinde HHS seÃ§imi zorunludur. \n \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in, YÃS'ler hesap referansÄ± ile Ã¶deme baÅlatabilirler. Bu

16nlarÄ±n dÄ±ÅÄ±ndaki HHS'lerin, gÃ¶nderen IBAN veya hesap referansÄ± ile Ã¶deme akÄ±ÅÄ±nÄ± desteklemesi zorunludur. \n \n Åekil 4: Ãdeme Emri BaÅlatma Hizmeti Ãst DÃ¼zey Ä°Å AkÄ±ÅÄ± \n Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. \n Tablo 6: Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n odeme-emri-rizasi \n POST \n /odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriRizasiIstegi \n OdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n odeme-emri-rizasi \n GET \n /odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmriRizaYaniti \n \n \n 3 \n odeme-emri \n POST \n /odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriIstegi \n OdemeEmri \n \n \n 3.1 \n odeme-emri \n GET \n /odeme-emri/{odemeEmriNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmri \n 6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) Ã¶deme emri baÅlatma iÅlemine onay verir. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil 5: Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (odemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ olduÄu geÃ§it tarafÄ±ndan kontrol edilir. \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahipliÄi geÃ§it tarafÄ±ndan kontrol edilir. \n HHS tarafÄ±ndan, istek baÅlÄ±ÄÄ±ndaki x-aspsp-code ile katilimciBlg iÃ§erisinde yer alan hhsKod deÄeri ile aynÄ± olduÄunu kontrol edilir. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren odemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir OdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini y

16apar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hata kodu iletilmeli ve fieldErrors dolu olacak Åekilde hatalÄ± alanÄ± belirten detaylÄ± aÃ§Ä±klama gÃ¶nderilmelidir. InvalidFormat hata kodlarÄ±nda fieldErrors iÃ§eriÄi gÃ¶nderilmeli ve anlaÅÄ±lÄ±r aÃ§Ä±klama ile message, messageTr alanlarÄ± doldurulmasÄ± zorunludur. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme adresleri ile Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.TPPRedirectionAddressMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; kimlik bilgileri nesnesinde eÄer kimlik bilgileri iletilmiÅ ise; bu veri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r. (KoÅullu Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.CustomerNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. Kurumsal mÃ¼Återi ile baÅlatÄ±lan rÄ±zada yer alan mÃ¼Återi bilgisinin karÅÄ± kurumda Kurumsal mÃ¼Återi deÄil; bireysel mÃ¼Återi olduÄu durumda  TR.OHVPS.Business.BusinessCustomerMismatch  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ãdeme Emri BaÅlatma Hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n âAÃ§Ä±k BankacÄ±lÄ±k Kanal Yetkiâ tanÄ±mÄ± yok ise  \"TR.OHVPS.Business.OpenBankingChannelClosed\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir. \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.DecoupledAuthenticationNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  \"TR.OHVPS.Business.EventSubscriptionNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin olduÄu durumlarda; ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerInfoMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. Kimlik alanÄ± iÃ§ermeyen tek seferlik Ã¶deme emri akÄ±ÅlarÄ±nda bu kural geÃ§erli deÄildir. GSM ve IBAN deÄerleri sadece tek seferlik Ã¶demelerde kullanÄ±labilir. \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerMobileApplicationNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n HHS kimlik bilgisi ile gÃ¶nderen Ã¼nvanÄ±nÄ±n uyumlu olduÄunu kontrol eder. HHS'ler EFT/FAST iÅlemlerinde kabul ettikleri kontrol kriterleri ile iÅleme izin verebilirler. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.IncorrectSenderTitle\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n GÃ¶nderen Hesap NumarasÄ± ÃBHS tarafÄ±ndan iletildiÄi durumda;\n \n IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.InvalidAccount\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountCodeMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.CustomerAccountMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. (Ä°lgili hesabÄ±n para transfer iÅlemine yetkisi olmamasÄ±) Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountUnauthorized\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâde gÃ¶nderen hesabÄ±n aktifliÄi kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountInactive\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n GÃ¶nderen Hesap NumarasÄ± iÃ§in, He

16sap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  \"TR.OHVPS.Business.ActiveConsentNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n AlÄ±cÄ± ve gÃ¶nderen hesabÄ±n aynÄ± olmasÄ± durumunda  âTR.OHVPS.Business.SenderRecipientSameâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n MÃ¼Återinin kendi hesaplarÄ± arasÄ±nda talimat veremeyeceÄi durumlarÄ±n kontrolÃ¼ iÃ§in  âTR.OHVPS.Business.SameAccountTransferRestrictedâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n \n Tek Seferlik Ãdeme \n \n Tek seferlik Ã¶deme akÄ±ÅÄ± YÃS'ten HHS'ye giden istekte, gÃ¶nderen kimlik bilgilerinin olmadÄ±ÄÄ± durumda gerÃ§ekleÅir. GÃ¶nderen kimlik bilgisi olmadÄ±ÄÄ±nda, KOLAS sorgusu yapÄ±lamayacaÄÄ±ndan Ã¶tÃ¼rÃ¼, HHS tarafÄ±ndan  \"TR.OHVPS.Resource.OneTimePaymentNotSupport\"  hatasÄ± dÃ¶nÃ¼lmelidir. ÃHK'nÄ±n YÃS'Ã¼n mÃ¼Återisi olmadÄ±ÄÄ± durumda tek seferlik Ã¶deme baÅlatÄ±labilir. \n Tek seferlik Ã¶deme akÄ±ÅÄ± hem iÅyeri Ã¶demelerinde hem de kiÅiden kiÅiye para transferlerinde kullanÄ±labilen bir akÄ±ÅtÄ±r. Ä°Åyeri tarafÄ±ndan baÅlatÄ±lan tek seferlik Ã¶deme iÅlemlerinde katÄ±lÄ±mcÄ±lar gÃ¶nderen ÃHK'dan Ã¼cret alÄ±namaz. \n Tek seferlik Ã¶deme akÄ±ÅÄ± sadece bireysel mÃ¼Återiler iÃ§in kullanÄ±labilir. Kurumsal mÃ¼Återi ile Ã¶deme emri baÅlatÄ±lmasÄ± durumunda  \"TR.OHVPS.Resource.OneTimePaymentNotSupport\"  hatasÄ± dÃ¶nÃ¼lÃ¼r.\nTek seferlik Ã¶deme akÄ±ÅÄ±nda hem yÃ¶nlendirmeli hem de ayrÄ±k GKD akÄ±ÅÄ± ile mÃ¼Återi yetkilendirmesi saÄlanabilir. \n AÅaÄÄ±daki senaryolar tek seferlik Ã¶demeye Ã¶rnek olarak gÃ¶sterilebilir. \nÄ°Åyeri Ãdemesi akÄ±ÅÄ± Ã¶rneÄi: Bir e-ticaret sitesinde, Ã¼ye olmadan alÄ±ÅveriÅ yapÄ±lmasÄ± ve Ã¶demenin YÃS tarafÄ±ndan kimlik bilgisi olmadan baÅlatÄ±lmasÄ± \nKiÅiden kiÅiye para transferi akÄ±ÅÄ± Ã¶rneÄi: QR veya diÄer yÃ¶ntemler ile alÄ±cÄ± bilgilerinin gÃ¶nderici ile paylaÅÄ±lmasÄ± ve YÃS Ã¼zerinden gÃ¶nderici bilgileri olmadan alÄ±cÄ±ya para transferi yapÄ±lmasÄ± iÃ§in rÄ±za verilmesi \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, Ã¶deme iÃ§in benzersiz âRizaNoâ ile âOdemeEmriRizasiâ nesnesi oluÅturur ve ÃBHSâye dÃ¶ner.  HHS, OdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n Tek seferlik Ã¶deme iÅlemlerinde (gÃ¶nderen kimlik bilgilerinin boÅ olduÄu durumda) ileri tarihli ve dÃ¼zenli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±labilir; ancak bu iÅ modelleri hizmete sunulmadan Ã¶nce BKM ile paylaÅÄ±lmalÄ± ve onayÄ± alÄ±nmalÄ±dÄ±r. \n POST /odeme-emri-rizasi  isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âodemeEmriRizasiIstegiâ nesnesi (Tablo-7) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âodemeEmriRizasiâ (Tablo-8) nesnesi oluÅturulur. \n  BAÅARILI Ä°STEK: \n Tablo 7: âOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  Durum ko

16du(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.ohkTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir para birimi olduÄu kontrol eder. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.  Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen Ã¼nvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, Hs

16pRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n Ã¼nvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r.  FAST-TR Karekod dÄ±ÅÄ±ndaki iÅ yeri Ã¶demelerinde; yine Ã¼nvan alanÄ±nda iÅyeri adÄ± bilgisi gÃ¶nderilmelidir. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n Tek seferlik Ã¶demelerde ( kimlik bilgileri boÅ iletildiÄinde) KOLAS nesnesi dolu iletiliyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n HHS, YÃS'Ã¼n API deseninde \"O\" kodunu ilettiÄini kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarÄ±nda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.   -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tÄ°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n YÃS bu deÄeri ÃHKâyÄ± HHSâye yÃ¶nlendirmeden Ã¶nceki ekranda gÃ¶stermeli, ve HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak yine ÃHKâya gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi

16iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r.  Ä°Åyeri Ãdeme Bilgileri, YÃS uygulama Ã¶nyÃ¼zÃ¼nde ÃHKânÄ±n bildiÄi ve giriÅi yapÄ±lmasÄ± beklenen bir bilgi olmamalÄ±dÄ±r. YÃS tarafÄ±ndan sistemsel olarak doldurulmasÄ± gereklidir. \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir.  4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriRizasiâ nesnesi Tablo-8âdeki parametrelerden oluÅur: \n Tablo 8: âOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n \n \n \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.   Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen Ã¼nvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.    Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisidir. Bu alan ileri vadeli Ã¶demeler iÃ§in dÃ¼ÅÃ¼nÃ¼lmÃ¼ÅtÃ¼r. Ä°lk fazda doldurulmasÄ±na gerek olmadÄ±ÄÄ± dÃ¼ÅÃ¼nÃ¼lmektedir. \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil 6: Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS,

16ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n Ã¶deme emrini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âodemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle,  OdemeEmriRizasi  nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  OdemeEmriRizasi  nesnesine iÅler. \n GET /odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  OdemeEmriRizasi  kaynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n \n Sorgulama yapÄ±lan Ã¶deme emri rÄ±zasÄ± HHS tarafÄ±nda bulunmuyor ise  \"TR.OHVPS.ResourceNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 8âde belirtilen \"OdemeEmriRizasi\" nesnesini dÃ¶nmektedir. \n Durum \n OdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n Ãdeme Emri RÄ±zasÄ± sonlandÄ±rÄ±ldÄ± ve iptal statÃ¼sÃ¼nde olan rÄ±za'larÄ±n gÃ¼ncellenme zamanÄ±ndan(gnclZmn) 6 ay sonrasÄ±na kadar sorgulanabilir olmasÄ± beklenmektedir. HHS'ler ilgili sÃ¼re sonrasÄ±nda yapÄ±lacak rÄ±za sorgularÄ±na \" TR.OHVPS.Resource.NotFound\"  uyarÄ±sÄ± verebilir. YÃS'ler tarafÄ±ndan iptal ve sonlandÄ±rÄ±ldÄ± statÃ¼sÃ¼nde olan rÄ±zalar iÃ§in sorgulama yapmamalÄ±dÄ±r. \n Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /odeme-emri-rizasi/{RizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-8âde yer alan parametreleri iÃ§eren âOdemeEmriRizasiâ oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /odeme-emri-rizasi/{RizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemlerinde, Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgilerinin Ã¶deme emri rÄ±zasÄ± sÄ±rasÄ±nda gÃ¶nderimi zorunlu deÄildir. BaÅarÄ±lÄ± GKD sonrasÄ±, yani eriÅim belirteci alÄ±ndÄ±ÄÄ±nda, Ã¶deme emri oluÅmadan Ã¶nce, YÃSâÃ¼n Ã¶deme emri rÄ±zasÄ±nÄ± sorgulayarak bu bilgileri almasÄ± ve Ã¶deme emrini oluÅtururken Kimlik TÃ¼rÃ¼, Kimlik Verisi ve GÃ¶nderen Ãnvan alanlarÄ±nÄ± dolu olarak gÃ¶ndermesi beklenmektedir.  Ancak rÄ±za durumu âYetki Bekleniyor - Bâ, âYetkilendirildi - Yâ ve âYetki Ä°ptal - Iâ statÃ¼lerinde ise, Ã¶deme emri rÄ±zasÄ± sorgulamasÄ±nda, HHSânin Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgisini Y

16ÃS ile paylaÅmamasÄ± gerekmektedir. \n 6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Ãdeme Emrinin OluÅturulmasÄ± \n POST /odeme-emri \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS OdemeEmri kaynaÄÄ±nÄ± oluÅturur. \n Ãdeme emri (OdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r. \n \n EriÅim Belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir EriÅim Belirteci yok ise  \"TR.OHVPS.Connection.InvalidToken\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor, Y: Yetkilendirildi  ya da E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n POST /odeme-emri-rizasi ile POST /odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r. Ãdeme emri rÄ±zasÄ±nda gÃ¶nderilen deÄerlerden farklÄ± bir deÄer gÃ¶nderildiÄi durumda  âTR.OHVPS.Business.FieldMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS tarafÄ±ndan Ãdeme Emrinin OluÅturulmasÄ± API'sine istek yapÄ±ldÄ±ÄÄ±nda mÃ¼Återinin bakiyesi kontrol edilir. Bakiye yetersiz ise HHS tarafÄ±ndan  \"TR.OHVPS.Business.BalanceInsufficient\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. MÃ¼Återinin hesabÄ±nda bakiye olmasÄ± ancak gÃ¼nlÃ¼k iÅlem limitine takÄ±lmasÄ± durumunda ise  TR.OHVPS.Business.ExceededTransactionLimit  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra, iÃ§erisinde OdemeEmriNo ve OdemeEmriDurumu deÄiÅkenleri de bulunan OdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n \n POST verisindeki GÃ¶nderen Hesap NumarasÄ± ve AlÄ±cÄ± Hesap NumarasÄ±nÄ±n aynÄ± bankaya aitse HAVALE deÄilse FAST veya PÃS iÅ akÄ±ÅÄ±na geÃ§ilir. \n OdemeEmriDurumu âGerÃ§ekleÅtiâ / âGÃ¶nderildiâ / âGerÃ§ekleÅmediâ olarak gÃ¼ncellenir. \n \n BAÅARILI Ä°STEK: \n Tablo 9: âOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n >YÃ¶nlendirme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n \n \n \n \n \n \n \n \n \n >AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur. yetYntm = Y iÃ§in bu nesne iletilmemelidir. \n \n \n \n >>OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >>OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n \n \n >Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde,

161. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Ãdeme Emri RizasÄ± Nesnesindeki Ä°Ålem TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS iÅlem tutarÄ± Ã¶deme mesajÄ±nda (Havale/FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n Ttr \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n KolasRef ( hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. \n RefBlg (Hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n FAST/PÃS Acklm \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme Sistemi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r.  Ä°Åyeri Ãdeme Bilgileri, YÃS uygulama Ã¶nyÃ¼zÃ¼nde ÃHKânÄ±n bildiÄi ve giriÅi yapÄ±lmasÄ± beklenen bir bilgi olmamalÄ±dÄ±r. YÃS tarafÄ±ndan sistemsel olarak doldurulmasÄ± gereklidir. \n \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n \n \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n Z \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Emir Bilgileri \n emrBlg \n Kompleks: EmirBilgileri \n Z \n \n \n \n > Ãdeme Emri NumarasÄ± \n odmEmriNo \n AN1..128 \n Z \n odemeEmri nesnesinin UID'sidir. OdemeEmrine Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Ãdeme Emri Zaman \n odmEmriZmn \n ISODateTime \n Z \n odemeEmri nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.  Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ  deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme Durumu \n odmDrm \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r.      Ãdeme Durumu alanÄ± ile ilgili olarak HHSâler tarafÄ±ndan YÃSâlere  OdemeEmri servisi yanÄ±tÄ±nda 02:GÃ¶nderildi, 04:Onayda Bekliyor,05:Ä°Åleme AlÄ±ndÄ± yanÄ±tlarÄ± gÃ¶nderilebilir.   05:Ä°Åleme AlÄ±ndÄ±  durumu YÃS tarafÄ±ndan mÃ¼Återiye gÃ¶sterilmeyen bir koddur. Bu kod dÃ¶nÃ¼ldÃ¼ÄÃ¼nde YÃS uygulamasÄ±nda ÃHKâya Ã¶deme durumu  02:GÃ¶nderildi  olarak gÃ¶sterilir. Ä°Ålemin son durumunun teyidi iÃ§in YÃS Ã¶deme emri sorgulamasÄ± yapmalÄ±dÄ±r.   02:GÃ¶nderildi  durumu oluÅtuktan sonra YÃS tarafÄ±ndan Ã¶deme emri sorgulamasÄ± yapÄ±larak Ã¶deme durumunun gÃ¼ncel deÄeri Ã¶Ärenilir. GÃ¼ncel deÄerler  01:GerÃ§ekleÅti,03:GerÃ§ekleÅmedi  durumlarÄ± olabilir. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Ãdeme Sistem NumarasÄ± \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. Havale/FAST/PÃS  Ã¶deme yÃ¶ntemleri iÃ§in tarih alanÄ± yyyy-aa-gg formatÄ±nda 10 karakter olarak

16iletilmelidir. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Ãdeme Emri Sorgusu \n GET /odeme-emri/{odemeEmriNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla Ã¶deme emrini sorgulayabilir. \n BAÅARILI YANIT: \n GET /odeme-emri/{odemeEmriNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âOdemeEmriâ nesnesi dÃ¶ner. \n \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, yer alan odemeEmriNo iÃ§in, Ã¶deme emri sorgusundaki odemeEmriNo bilgisinin aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Sorgulama yapÄ±lan Ã¶deme emri numarasÄ± HHS tarafÄ±nda bulunmuyor ise  \"TR.OHVPS.ResourceNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n"},{title:"12.\tOlay Bildirim",frontmatter:{},regularPath:"/v2.0.0/contents/olay-bildirim.html",relativePath:"v2.0.0/contents/olay-bildirim.md",key:"v-448b4d1d",path:"/v2.0.0/contents/olay-bildirim.html",headers:[{level:2,title:"Genel Bilgiler",slug:"genel-bilgiler"},{level:2,title:"Olay Abonelik Servisleri (OAS)",slug:"olay-abonelik-servisleri-oas"},{level:2,title:"ADIM 1: Olay AboneliÄinin gerÃ§ekleÅtirilmesi",slug:"adim-1-olay-aboneliginin-gerceklestirilmesi"},{level:2,title:"ADIM 2: Olay AboneliÄinin gÃ¼ncellenmesi",slug:"adim-2-olay-aboneliginin-guncellenmesi"},{level:2,title:"ADIM 3: Olay AboneliÄinin sorgulanmasÄ±",slug:"adim-3-olay-aboneliginin-sorgulanmasÄ±"},{level:2,title:"ADIM 4: Olay AboneliÄinin iptali",slug:"adim-4-olay-aboneliginin-iptali"},{level:2,title:"ADIM 5: Olay AboneliÄinin Ä°letilemeyen OlaylarÄ±",slug:"adim-5-olay-aboneliginin-iletilemeyen-olaylarÄ±"},{level:2,title:"ADIM 6: Sistem Olay Dinleme",slug:"adim-6-sistem-olay-dinleme"},{level:2,title:"Olay Dinleme Servisleri (ODS)",slug:"olay-dinleme-servisleri-ods"},{level:2,title:"ADIM 1: Olay Dinleme",slug:"adim-1-olay-dinleme"},{level:2,title:"ADIM 2:  Sistem Olay Dinleme",slug:"adim-2-sistem-olay-dinleme"}],content:" 12.\tOlay Bildirim  \n Genel Bilgiler \n Olay Bildirim Abonelik API servisleri, HHS'lerin sunmuÅ olduklarÄ± olay bildirimlerini takip etmek amacÄ±yla abonelik akÄ±ÅlarÄ±nÄ± tanÄ±mlar. \n YÃS'ler olay bildirimlerini takip edebilmek iÃ§in talep ettikleri abonelik hizmetlerini belirterek HHS'ler Ã¶zelinde bir abonelik kaydÄ± oluÅtururlar. Bu abonelik kaydÄ±nÄ± okuyabilir, gÃ¼ncelleyebilir ya da silebilirler. \n Olay bildirimleri HHS'ler tarafÄ±ndan 2 yÃ¶ntem ile saÄlanÄ±r. Ä°lki olay bildirimlerinin anlÄ±k olarak iletilmesi, diÄeri ise anlÄ±k iletilemeyen olaylarÄ±n toplu olarak iletilmesidir. \n Olay Bildirimi 2 API ile yÃ¶netilecektir. \n 1 - Olay Abonelik Servisleri (OAS) \n2 - Olay Dinleme Servisleri  (ODS) \n Olay Abonelik ve Olay Dinleme API'lerinin istek ve yanÄ±t baÅlÄ±ÄÄ±nda beklenen parametreler ÃBH,HBH,GKD API'lerinden farklÄ±dÄ±r.\n 3.15. Ä°stek BaÅlÄ±ÄÄ±  ve  3.16. YanÄ±t BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mlerinde zorunlu parametreler ve aÃ§Ä±klamalarÄ± belirtilmiÅtir. \n Olay Abonelik Servisleri (OAS) \n Olay abonelik Servisleri; HHS'ler tarafÄ±ndan sunulacak olay bildirim abonelik servislerini ve iletilemeyen olaylar servisini iÃ§ermektedir. \n HHS'nin sunacaÄÄ± bu API ile YÃS'ler Åu adÄ±mlarÄ± gerÃ§ekleÅtirebilir. \n \n YÃS'Ã¼n olay bildirimlerini dinleyebilmek iÃ§in Ã¶ncelikle dinlemek istediÄi olaylara ait olay tipleri ve kaynak tiplerini belirlemesi gerekmektedir. \n Olay tipleri ve kaynak tiplerinin neler olacaÄÄ± \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda belirtilmiÅtir. \n YÃS, belirlediÄi olaylar iÃ§in HHS'ye olay abonelik endpointi aracÄ±lÄ±ÄÄ± ile abonelik baÅlatÄ±r. \n YÃS, abonelik numarasÄ± aracÄ±lÄ±ÄÄ± ile abonelik bilgilerini gÃ¶rÃ¼ntÃ¼leyebilir, gÃ¼ncelleyebilir, silebilir. \n YÃS, olay bildirimlerini bu abonelik sayesinde kendisinin sunacaÄÄ± Olay Dinleme API'si ile dinler. \n HHS anlÄ±k iletemediÄi olaylarÄ±nÄ± biriktirerek, iletilemeyen olaylar endpointi ile YÃS'e sunar. \n \n HHS'ler \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda belirlenen olay ve kaynak tiplerinin tÃ¼mÃ¼ iÃ§in YÃS'lere bildirim sunmak zorundadÄ±r. \n Olay Abonelik Servislerinde Idempotency kurallarÄ±nÄ±n iÅletilmesine gerek bulunmamaktadÄ±r. \n Nezdinde Ã¶deme hesabÄ± bulunduran bazÄ± hesap hizmeti saÄlayÄ±cÄ±lar(EPK, Ãdeme KuruluÅlarÄ±) mÃ¼Återilerine ait hesaplarÄ±, diÄer HHS'lerdeki havuz hesaplarÄ±nÄ± kullanarak yÃ¶netiyor olabilir. Bu durum ilgili hesap hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n, ÃHVPS kapsamÄ±nda HHS olduÄu rolde sunmasÄ± gereken olay bildirim servisleri ile ilgili uymasÄ± gereken kurallarÄ± deÄiÅtirmemektedir. Ä°lgili hesap hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n standartlara uygun Åekilde YÃS'lere bildirimleri yapmasÄ± gerekmektedir. \n YÃS'ler sahip olduklarÄ± rol Ã¶zelinde olay abonelik servislerinden faydalanabilir. Bu yÃ¼zden olay bildirim etki alanÄ± (scope) deÄerleri hesap_bilgisi ve/veya odeme_emri olarak belirlenmiÅtir. \n Olay Abonelik Servisine ait API Endpointleri aÅaÄÄ±daki tabloda listelenmiÅtir. \n Olay Abonelik Servisleri iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âhesap_b

16ilgisiâ  \"odeme_emri\" \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n olay-abonelik \n POST \n /olay-abonelik \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n OlayAbonelikÄ°stegi \n OlayAbonelik \n \n \n 2 \n olay-abonelik \n GET \n /olay-abonelik \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n - \n OlayAbonelik \n \n \n 3 \n olay-abonelik/{olayAbonelikNo} \n PUT \n /olay-abonelik/{olayAbonelikNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n OlayAbonelik \n OlayAbonelik \n \n \n 4 \n olay-abonelik/{olayAbonelikNo} \n DELETE \n /olay-abonelik/{olayAbonelikNo} \n Z \n Ä°stemci Kimlik Bilgileri \n - \n - \n - \n - \n \n \n 5 \n olay-abonelik/{olayAbonelikNo}/iletilemeyen-olaylar \n GET \n /olay-abonelik/{olayAbonelikNo}/iletilemeyen-olaylar \n Z \n Ä°stemci Kimlik Bilgileri \n - \n Sayfalama \n \n Olaylar \n \n \n 6 \n sistem-olay-dinleme \n POST \n sistem-olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n

16- \n - \n Olaylar \n - \n ADIM 1: Olay AboneliÄinin gerÃ§ekleÅtirilmesi \n POST /olay-abonelik \n HHS'nin olay abonelik hizmeti sunduÄu servistir.\nYÃS, seÃ§eceÄi olay-kaynak tipleri iÃ§in bu servis aracÄ±lÄ±ÄÄ± ile abone olabilir. HHS POST iÅlemi sonucunda, YÃS adÄ±na bir olay abonelik kaynaÄÄ± oluÅturur ve tekil tanÄ±mlayÄ±cÄ± olan olayAbonelikNo deÄerini dÃ¶ner. olayAbonelikNo Ã¼retilirken farklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. olayAbonelikNo evrensel tekil olmalÄ±dÄ±r. \n1 YÃS'Ã¼n 1 HHS'de 1 adet abonelik kaydÄ± olabilir. \nBaÅarÄ±lÄ± POST isteÄi sonucu HTTP 201 cevabÄ± ile iletilmelidir. \n YÃS tarafÄ±ndan daha Ã¶nce oluÅturulmuÅ olay abonelik kaydÄ± varsa  \"HTTP 400 -TR.OHVPS.Business.EventSubscriptionAlreadyExists\"  hatasÄ±yla uyarÄ± mesajÄ±nÄ± dÃ¶ner. \n Olay Abonelik kaydÄ± oluÅturmak isteyen YÃS'Ã¼n ODS API tanÄ±mÄ± HHS tarafÄ±ndan kontrol edilmelidir. YÃS'Ã¼n tanÄ±mÄ± olmamasÄ± halinde  \"HTTP 400-TR.OHVPS.Business.InvalidContent\"  hatasÄ± verilmelidir. \n Olay Abonelik kaydÄ± oluÅturmak isteyen YÃS tarafÄ±ndan olay tipi ve kaynak tipi iÃ§in iletilen deÄerler olmasÄ± gereken sÄ±ralÄ± veri tÃ¼lerinden(TR.OHVPS.DataCode.OlayTip ve TR.OHVPS.DataCode.KaynakTip) farklÄ± ise HHS tarafÄ±ndan   \"TR.OHVPS.Business.EventSubscriptionNotFound\"  hatasÄ± verilmelidir. \n Abonelik Ã¼zerinde gÃ¶rÃ¼ntÃ¼leme, gÃ¼ncelleme, silme iÅlemlerini gerÃ§ekleÅtirebilir.\nYÃS'Ã¼n AboneliÄi devam ettiÄi sÃ¼rece; YÃS'Ã¼n aÃ§acaÄÄ± Olay Dinleme API'sine, HHS tarafÄ±ndan abonelik kapsamÄ±nda olay bildirimleri iletilir. \n BKM'nin sunacaÄÄ± abonelik servisleri iÃ§in HHS ve YÃS'lerin abonelik isteÄi yapmasÄ±na gerek bulunmamaktadÄ±r. BKM Ã¼retim ortamÄ± tanÄ±mlarÄ± yapÄ±lÄ±rken katÄ±lÄ±mcÄ±larÄ± abonelik servislerine Ã¼ye yapacaktÄ±r. BKM'nin sunacaÄÄ± abonelik servislerinin olay tipi \"HHS_YOS_GUNCELLENDI\"dir. HHS ve YÃS API ile sunulan bilgilerde bir deÄiÅiklik olduÄunda yapÄ±lacak olay bildirimlerini saÄlar.\nÃrneÄin; HHS logo bilgilerinde yapÄ±lacak bir deÄiÅiklik sonrasÄ±nda, YÃS'lere yapÄ±lacak bildirim ile logo bilgisini deÄiÅen HHS'nin hhsKod deÄerini iletir. YÃS, HHS API'yi  hhsKod ile Ã§aÄÄ±rarak HHS'nin gÃ¼ncel bilgilerini alÄ±r. GÃ¼ncel bilgiler ile kendi sistemini gÃ¼nceller. \n Olay tipi ve kaynak tipine ekleme yapÄ±ldÄ±kÃ§a YÃS'lerin olay abonelik kayÄ±tlarÄ±nÄ± yeni tipleri iÃ§erecek Åekilde gÃ¼ncel tutmasÄ± gerekmektedir. \n OlayAbonelikIstegi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n \n \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n YÃS abone olmak istediÄi olay tiplerini TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄer ya da deÄerler ile doldurur. \n \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda \"Olay Bildirim Yapan\" kolonu \"HHS\" olan olay tipleri ile veri giriÅine izin verilir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n Olay tiplerinin tanÄ±mlanabildiÄi kaynak listesi bulunmaktadÄ±r. Bu listeye uygun kaynak tipleri iletilmelidir. \n HHS, YÃS API Ã¼zerinden YÃS'Ã¼n rollerini alarak uygun kaynak tiplerine kayÄ±t olmasÄ±nÄ± saÄlar. \n \n \n \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± iletilebilir. Ä°lk deÄeri olay abonelik oluÅturma zamanÄ± bilgisidir. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n \n \n \n \n Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi \n * AnlÄ±k : Olay gerÃ§ekleÅtikten sonra maksimum 5 saniye iÃ§erisindeki zaman \n \n \n \n Olay Tipleri \n YÃS RolÃ¼ \n Kaynak Tipleri \n Olay OluÅturulma durumu \n KaynakNo \n AsÄ±l verinin elde edileceÄi API \n Olay Bildirimini Yapan \n Olay Bildirim ZamanÄ± \n Retry Policy \n \n \n \n \n KAYNAK_GUNCELLENDI \n ÃBH \n ODEME_EMRI \n TÃ¼m Ã¶deme durum deÄiÅikliklerinde \n odmEmrNo \n GET /odeme-emri/{odemeEmriNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n ILERI_TARIHLI_ODEME_EMRI_RIZASI \n RÄ±za iptal detay kodu â02â : KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal durumunda \n rizaNo \n GET /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n ILERI_TARIHLI_ODEME_EMRI \n TÃ¼m Ã¶deme durum deÄiÅikliklerinde, Ã¶deme emri iÃ§erisinde yer alan tutar, talimat tarihi deÄiÅikliklerinde \n odmEmrNo \n GET /ileri-tarihli-odeme-emri/{odemeEmriNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n DUZENLI_ODEME_EMRI_RIZASI \n RÄ±za iptal detay kodu â02â : KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal durumunda \n rizaNo \n GET /duzenli-odeme-emri-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n DUZENLI_ODEME_PLANI \n DÃ¼zenli Ã¶deme planÄ± iÃ§erisinde yer alan herhangi bir alan iÃ§in deÄiÅiklik olduÄu durumda \n tlmtNo \n /duzenli-odeme-emri/{tlmtNo}/odeme-plani \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n DUZENLI_ODEME_EMRI \n DÃ¼zenli Ã¶deme emri iÃ§erisinde gÃ¶nderen hesap ve aÃ§Ä±klama alanlarÄ±na dair deÄiÅiklik olduÄu durumda \n tlmtNo \n /duzenli-odeme-emri/{tlmtNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n RÄ±za iptal detay kodu â02â : KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal durumunda ve RÄ±za iptal detay kodu â09â : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor durumunda \n rizaNo \n GET /hesap-bilgisi-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n HBH \n BAKIYE \n Bakiye nesnesindeki tutarla ilgili bir bilgi deÄiÅtiÄinde ve HBH rÄ±zasÄ± iÃ§erisinde \"06-AnlÄ±k Bakiye Bildirimi\" izin tÃ¼rÃ¼ varsa oluÅturulur. Mevcutta alÄ±nmÄ±Å rÄ±zalar iÃ§in  bakiye kaynak tipi Ã¶zelinde 06 izin tÃ¼rÃ¼ gerektiÄinden; mevcut rÄ±zanÄ±n yenilenmesine dair mÃ¼Återiye bilgilendirme yapÄ±larak 06 izin tÃ¼rÃ¼nÃ¼ kapsayan yeni rÄ±za alÄ±nmasÄ± sÃ¼reci YÃS tarafÄ±ndan gerÃ§ekleÅtirilebilir. Bloke tutar deÄiÅikliÄi iÃ§in olay oluÅturma ve bildirimi HHS inisiyatifindedir. KrdHsp iÃ§erisinde yer alan kulKrdTtr deÄerinin deÄiÅtiÄi durumda olay bildirim gÃ¶nderilmesi gerekmektedir. \n hspRef \n GET /hesaplar/{hspRef}/bakiye, GET /hesaplar/{hspRef}/islemler \n HHS \n Maksimum 10 dakika iÃ§erisinde \n Retry policy uygulanmamalÄ±dÄ±r. Ä°lk istek gÃ¶nderilemediÄi durumda Ä°letilemeyen Olaylara eklenmelidir. \n \n \n \n HBH \n KART_BILGILERI \n Kart bilgileri nesnesindeki kart statÃ¼sÃ¼ veya ekstre tÃ¼rleri iÃ§erisinde sadece yeni bir esktre tÃ¼rÃ¼ eklendiÄinde oluÅturulur. Ekstre tÃ¼rÃ¼nde azaltma yÃ¶nÃ¼nde gÃ¼ncelleme varsa olay bildirimi gÃ¶nderilmemelidir. YÃS'e kart statÃ¼sÃ¼nÃ¼n veya ekstre tÃ¼rlerinin deÄiÅtiÄine dair olay bildirimi gÃ¶nderilir. \n kartRef \n GET /kartlar,  GET /kartlar/{kartRef},   GET /kartlar/{kartRef}/kart-detay,  GET /kartlar/{kartRef}/kart-hareketleri \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n HBH \n COKLU_ISLEM_TALEBI ( bulk-data) \n Ä°lgili API Ä°lke ve kurallarÄ±na eklendiÄinde gÃ¼ncellenecektir. \n \n \n HHS \n \n 30 Dakika - 3 Deneme \n \n \n AYRIK_GKD_BASARILI \n ÃBH \n ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}}&rizaTip=O \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}&rizaTip=H \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n ÃBH \n ILERI_TARIHLI_ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}}&rizaTip=I \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n ÃBH \n DUZENLI_ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}}&rizaTip=D \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n AYRIK_GKD_BASARISIZ \n ÃBH \n ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /odeme-emri-rizasi/{RizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /hesap-bilgisi-rizasi/{RizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n ÃBH \n ILERI_TARIHLI_ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n ÃBH \n DUZENLI_ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /duzenli-odeme-emri-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n HHS_YOS_GUNCELLENDI \n \n \n BKM sistemi tarafÄ±ndan Ã¼retilecek olaylarÄ± dinlemek iÃ§in kullanÄ±lacak kaynak tipidir. YÃS ve HHS'lerin BKM'ye abonelik oluÅturmasÄ±na gerek bulunmamaktadÄ±r. BKM HHS ve YÃS Ã¼retim ortamÄ± tanÄ±mÄ± yaparken abonelikler

16ini baÅlatacaktÄ±r.   (HHS yaygÄ±nlaÅtÄ±rma durumundayken de aboneliÄi baÅlatÄ±lacaktÄ±r.) \n \n \n HHS \n \n \n \n \n \n YÃS \n HHS \n HHS bilgilerinde deÄiÅiklik olduÄunda, YÃS'Ã¼n hhsKod ile sorgulama yapmasÄ± ve deÄiÅen bilgiyi gÃ¼ncellemesi beklenmektedir. \n hhsKod \n GET /hhs/{hhsKod} \n BKM \n *AnlÄ±k \n 5 Dakika - 3 Deneme \n \n \n \n HHS \n YOS \n YÃS bilgilerinde deÄiÅiklik olduÄunda, HHS'nin yosKod ile sorgulama yapmasÄ± ve deÄiÅen bilgiyi gÃ¼ncellemesi beklenmektedir. \n yosKod \n GET /yos/{yosKod} \n BKM \n *AnlÄ±k \n 5 Dakika - 3 Deneme \n \n \n \n * AnlÄ±k : Olay gerÃ§ekleÅtikten sonra maksimum 5 saniye iÃ§erisindeki zaman \n ADIM 2: Olay AboneliÄinin gÃ¼ncellenmesi \n PUT\tolay-abonelik/{olayAbonelikNo} \n YÃS'Ã¼n olay aboneliÄine ait abonelik tiplerini gÃ¼ncelleyebildiÄi servistir. Olay aboneliÄi oluÅturulduÄu zaman HHS tarafÄ±ndan iletilen olayAbonelikNo aracÄ±lÄ±ÄÄ± ile gÃ¼ncelleme iÅlemi yapÄ±lÄ±r. YÃS abone olmak istediÄi olay-kayÄ±t tiplerininin son halini gÃ¼ncelleme servisi ile HHS'ye iletir. HHS bu bilgilerle eski abonelik tiplerinin yerini deÄiÅtirir. \n BaÅarÄ±lÄ± PUT isteÄi sonucu HTTP 200 cevabÄ± ile iletilmelidir. \n OlayAbonelikIstegi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n HHS geÃ§erli bir olay abonelik numarasÄ± olduÄunun kontrolÃ¼nÃ¼ yapar. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n HHS Sisteminde, YÃS'Ã¼n eski abonelikleri yeni aboneliklerle gÃ¼ncellenmelidir. \n \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n YÃS abone olmak istediÄi olay tiplerini TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄer ya da deÄerler ile doldurur. \n \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda \"Olay Bildirim Yapan\" kolonu \"HHS\" olan olay tipleri ile veri giriÅine izin verilir.  Olay tipi AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ iÃ§in, YÃS'Ã¼n ODS API'yi sunmasÄ± zorunludur. HHS, bu olay tipleri Ã¶zelinde YÃS API Ã¼zerinden YÃS'Ã¼n bu API'yi sunduÄunu kontrol eder ve eÄer sunmuyor ise TR.OHVPS.Business.InvalidContent hatasÄ± dÃ¶nerek kayÄ±t iÅlemini gerÃ§ekleÅtirmez. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n Olay tiplerinin tanÄ±mlanabildiÄi kaynak listesi bulunmaktadÄ±r. Bu listeye uygun kaynak tipleri iletilmelidir. \n HHS, YÃS API Ã¼zerinden YÃS'Ã¼n rollerini alarak uygun kaynak tiplerine kayÄ±t olmasÄ±na izin verir. \n \n \n \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n ADIM 3: Olay AboneliÄinin sorgulanmasÄ± \n GET /olay-abonelik \n YÃS olay abonelik bilgilerini sorgulamak isteyebilir. HHS, YÃS'e ait aktif durumdaki abonelik bilgisini iletir.\nBaÅarÄ±lÄ± GET sonucu HTTP 200 kodu ile iletilmelidir. \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n YÃS'Ã¼n abone olduÄu olay - kaynak listesini dÃ¶ner. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄerler iÃ§erir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden deÄerler iÃ§erir. \n ADIM 4: Olay AboneliÄinin iptali \n DELETE /olay-abonelik/olayAbonelikNo \n YÃS'Ã¼n abonelik kaydÄ±nÄ± silmesi iÃ§in HHS'nin sunduÄu servistir.  BaÅarÄ±lÄ± silme iÅlemi sonucu HTTP 204 ile YÃS'e iletilir. \n ADIM 5: Olay AboneliÄinin Ä°letilemeyen OlaylarÄ± \n GET /iletilemeyen-olaylar \n HHS kaynaklar Ã¼zerinde oluÅacak olaylarÄ± YÃS'e POST/olay-dinleme servisi ile gÃ¶nderim saÄlamaktadÄ±r. Bu gÃ¶nderim belli bir yeniden gÃ¶nderim politasÄ± (retry-policy) ile yapÄ±lmalÄ±dÄ±r.  Ancak yine de iletilemeyen olaylar olursa (YÃS servisinden HTTP 202 alamama durumu) YÃS'e iletilemeyen-olaylar servisi Ã¼zerinden sunulmalÄ±dÄ±r. Yani yeniden gÃ¶nderim politikasÄ± sonunda gÃ¶nderilemeyen olaylar bu servis ile sunulmalÄ±dÄ±r. \n AynÄ± kaynak numarasÄ± ile aynÄ± olay-kaynak tipinde, 1 YÃSâe ait, 1 adet iletilemeyen olay kaydÄ± olabilir. \n Bu serviste 1 gÃ¼n Ã¶ncesinden sorgu anÄ±na kadar tÃ¼m kayÄ±tlarÄ±na ait iletilemeyen olaylar listelenmelidir.\nÃrnek sorgu zamanÄ± : 2023-04-06T15:14:00+03:00\nHHS'nin sunacaÄÄ± veri 2023-04-05T00:00:00+03:00  ile 2023-04-06T15:14:00+03:00 arasÄ±nda olmalÄ±dÄ±r.\nSÄ±ralama yÃ¶nÃ¼ olay tarihine gÃ¶re artan Åekilde olmalÄ±dÄ±r. Sayfalama 100'er kayÄ±t dÃ¶nÃ¼lerek yapÄ±lmalÄ±dÄ±r. \n YÃS tarafÄ±ndan iletilemeyen olaylar isteÄi 10 dakikada bir olacak Åekilde yapÄ±labilir. HHS bu limite uygun iÅlem kÄ±sÄ±tÄ± uygulayabilir. \n Ä°Ålem Sorgu ÃrneÄi GET Ä°Ålem Sorgu ÃrneÄi  : /iletilemeyen-olaylar?syfNo=1&olyZmnBslTrh=2024-01-08T16:42:00+03:00&olyZmnBtsTrh=2024-01-09T17:09:00+03:00 \n ÃrneÄin; \n olyZmnBslTrh : 07/01/2024 10:00:00+03:00\n olyZmnBtsTrh : 09/01/2024 16:00:00+03:00\n Sorgu ZamanÄ± : 09/01/2024 10:15:00+03:00 \n YanÄ±t iÃ§erisinde yer alan veriye ait tarih aralÄ±ÄÄ± : 08/01/2024 00:00:00+03:00 - 09/01/2024 10:15:00+03:00 olmalÄ±dÄ±r. \n BaÅlangÄ±Ã§ ve bitiÅ zaman aralÄ±ÄÄ± Ã¶rnekte yer alan Åekilde seÃ§ilse dahi ilgili servis yanÄ±tÄ± iÃ§in Ã¶ncelikle sorgu zamanÄ±na bakÄ±lÄ±p 1 gÃ¼n Ã¶ncesinden sorgu anÄ±na kadar tÃ¼m kayÄ±tlarÄ±n iletilemeyen olaylar iÃ§erisinde listelenmesi saÄlanmalÄ±dÄ±r. \n Ä°lgili tarih aralÄ±ÄÄ±nda uygun veri olmamasÄ± halinde yanÄ±t gÃ¶vdesi boÅ olacak Åekilde dÃ¶nÃ¼lmelidir. \n Ä°letilemeyen Olaylar Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS Ä°letilemeyen Olaylar listesine ait bu sayfadaki kayÄ±tlarÄ± gÃ¶ndermelidir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶ndermelidir. \n \n \n Olay ZamanÄ± BaÅlangÄ±Ã§ Tarihi \n olyZmnBslTrh \n ISODateTime \n Ä° \n Sorgulanacak Olay ZamanÄ±na ait baÅlangÄ±Ã§ tarihi \n HHS'ler iletilemeyen olaylar listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan tetiklenen sorgularda; olyZmnBslTrh iletilmediÄi durumda ya da 1 gÃ¼n Ã¶ncesinin baÅlangÄ±Ã§ saatine gÃ¶re daha geri bir zaman dilimi gÃ¶nderildiÄinde, baÅlangÄ±Ã§ zamanÄ±(olyZmnBslTrh) deÄeri sorgu zamanÄ±ndan 1 gÃ¼n Ã¶ncesine ait gÃ¼nÃ¼n baÅlangÄ±Ã§ zamanÄ± olarak kabul edilmelidir. \n \n \n Olay ZamanÄ± BitiÅ Tarihi \n olyZmnBtsTrh \n ISODateTime \n Ä° \n Sorgulanacak Olay ZamanÄ±na ait bitiÅ tarihi \n HHS'ler iletilemeyen olaylar listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan tetiklenen sorgularda;

16 olyZmnBtsTrh iletilmediÄi durumda ya da sorgu zamanÄ±ndan daha ileri bir zaman dilimi gÃ¶nderildiÄinde, bitiÅ zamanÄ±(olyZmnBtsTrh) deÄeri sorgu zamanÄ± olarak kabul edilmelidir. \n \n \n \n Tablo 17: Olaylar nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Olaylar \n olaylar \n Kompleks: Olaylar \n Z \n \n \n \n >Olay No \n olayNo \n AN1..64 \n Z \n Olaya ait evrensel tekil numaradÄ±r. \n \n \n >Olay Zamani \n olayZamani \n ISODateTime \n Z \n OlayÄ±n oluÅtuÄu tarih bilgisidir. \n \n \n >Olay Tipi \n olayTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >Kaynak NumarasÄ± \n kaynakNo \n AN1..128 \n Z \n GÃ¼ncellenen kaynaÄa ait HHS sistemindeki tekil tanÄ±mlayÄ±cÄ±. \n \n \n \n Kaynak numarasÄ±nda gÃ¶nderilen deÄer ile ilgili kaynaÄÄ± sorgulayarak almak YÃS'Ã¼n insiyatifindedir. \n ADIM 6: Sistem Olay Dinleme \n POST /sistem-olay-dinleme \n HHS'lerin sistem olaylarÄ±nÄ± dinleme amacÄ±yla aÃ§masÄ± gereken endpoint bilgisidir. \n YÃS API iÃ§erisinde yapÄ±lan deÄiÅikliklerde, BKM tarafÄ±ndan HHS'lere olay bildirimlerini yapÄ±lÄ±r. \n Olaylar yanÄ±t nesnesi iÃ§erisinde 1 adet kayÄ±t yer almalÄ±dÄ±r. \n BaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted kodu ile dÃ¶nÃ¼lmelidir. \n HHS'den baÅarÄ±lÄ± yanÄ±t alÄ±namadÄ±ÄÄ± durumda, 5 dakika aralÄ±klarla 3 kez deneme yapÄ±lacaktÄ±r. Hata alÄ±nmaya devam edilmesi durumunda baÅka bir aksiyon alÄ±nmayacaktÄ±r. \n Olay Dinleme Servisleri (ODS) \n YÃS sunacaÄÄ± Olay Dinleme Servisi ile hem HHS'den hem de BKM'den gelen olaylarÄ±n bildirimini dinleyebilir. YÃS'ler HHS'de yer alan olay abonelik kayÄ±tlarÄ±nÄ± iptal edebilir ancak BKM Sistem Olay Dinleme servisinin ileteceÄi bildirimlerin alÄ±nmasÄ± zorunlu olduÄundan ODS API her zaman aktif olmalÄ±dÄ±r. \n HHS'den gelecek olay bildirimlerini olay-dinleme endpointi ile dinlerken, BKM'den gelecek olay bildirimlerini sistem-olay-dinleme endpointi ile dinlemelidir. \n Olay Dinleme Servislerinde Idempotency kurallarÄ±nÄ±n iÅletilmesine gerek bulunmamaktadÄ±r. \n Olay Dinleme Servisine ait API Endpointleri aÅaÄÄ±daki tabloda listelenmiÅtir. \n Olay Dinleme Servisleri iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âolay_dinlemeâ \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n olay-dinleme \n POST \n /olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek \n - \n Olaylar \n - \n \n \n 2 \n sistem-olay-dinleme \n POST \n /olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n

16- \n - \n Olaylar \n - \n ADIM 1: Olay Dinleme \n POST /olay-dinleme \n Olay abonelik servisi ile abone olunan olaylar, olay dinleme servisi ile YÃS'e iletilir.\nOlaylar yanÄ±t nesnesi iÃ§erisinde en fazla 100 kayÄ±t gÃ¶nderilmelidir.\nBaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted ile dÃ¶nÃ¼lmelidir. \n HHS'nin iÅlem hata aldÄ±ÄÄ±nda, baÅarÄ±lÄ± iÅlem olana kadar 3 kez deneme yapÄ±lmasÄ± gerekmektedir.\nÄ°lk istekle son istek arasÄ±nda 30 dakika olacak Åekilde, zamana yayarak bu denemelerin yapÄ±lmasÄ± gerekmektedir. (Exponential backoff policy uygulanmasÄ± beklenmektedir. )\nHHS kendi sistemini yormayacak Åekilde, belirleyeceÄi kurallar dahilinde bu geliÅtirmeyi yapmalÄ±dÄ±r. \n Tablo 17: Olaylar nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n >KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >>Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n >> Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n >Olaylar \n olaylar \n Kompleks: Olaylar \n Z \n \n \n \n >>Olay NumarasÄ± \n olayNo \n AN1..64 \n Z \n Olaya ait atanmÄ±Å tekil kimlik numarasÄ± \n \n \n >>Olay ZamanÄ± \n olayZamani \n ISODateTime \n Z \n OlayÄ±n oluÅma zamanÄ± \n \n \n >>Olay Tipi \n olayTipi \n AN1..36 \n > \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >>Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >>Kaynak NumarasÄ± \n kaynakNo \n AN1..128 \n Z \n GÃ¼ncellenen kaynaÄa ait HHS sistemindeki tekil tanÄ±mlayÄ±cÄ±. \n ADIM 2:  Sistem Olay Dinleme \n POST /sistem-olay-dinleme \n YÃS'lerin sistem olaylarÄ±nÄ± dinleme amacÄ±yla aÃ§masÄ± gereken endpoint bilgisidir. \n HHS API iÃ§erisinde yapÄ±lan deÄiÅikliklerde, BKM tarafÄ±ndan YÃS'lere olay bildirimlerini yapÄ±lÄ±r. \n Olaylar yanÄ±t nesnesi iÃ§erisinde 1 adet kayÄ±t yer almalÄ±dÄ±r. \n BaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted kodu ile dÃ¶nÃ¼lmelidir. \n YÃS'ten baÅarÄ±lÄ± yanÄ±t alÄ±namadÄ±ÄÄ± durumda, 5 dakika aralÄ±klarla 3 kez deneme yapÄ±lacaktÄ±r. Hata alÄ±nmaya devam edilmesi durumunda baÅka bir aksiyon alÄ±nmayacaktÄ±r. \n"},{title:"4. RÄ±za DurumlarÄ±",frontmatter:{},regularPath:"/v2.0.0/contents/riza-durumlari.html",relativePath:"v2.0.0/contents/riza-durumlari.md",key:"v-64fc905e",path:"/v2.0.0/contents/riza-durumlari.html",headers:[{level:2,title:"4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri",slug:"_4-1-hesap-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"},{level:2,title:"4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri",slug:"_4-2-odeme-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"}],content:" 4. RÄ±za DurumlarÄ± \n ÃHK, Ãdeme Emri BaÅlatma Hizmetine ya da Hesap Bilgisi Hizmetine mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi ile baÅlar. ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden yaptÄ±ÄÄ± iÅlemler neticesinde rÄ±za durumlarÄ± deÄiÅebilir.\nRÄ±zaânÄ±n alabileceÄi durum kodlarÄ± Åu Åekilde belirlenmiÅtir. \n B: Yetki Bekleniyor  â Ä°lk rÄ±za talebinde \n Y: Yetkilendirildi  â BaÅarÄ±lÄ± GKD sonrasÄ± yetKod Ã¼retildiÄinde \n K: Yetki KullanÄ±ldÄ±  â EriÅim Belirteci alÄ±ndÄ±ÄÄ±nda \n E: Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼  â ÃBHS iÃ§in \n S: Yetki SonlandÄ±rÄ±ldÄ± \nÂ Â Â Â HBHS iÃ§in : EriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde \nÂ Â Â Â ÃBHS iÃ§in : Yenileme belirteci Son Tarihi geldiÄinde \n I :Yetki Ä°ptal \nRÄ±za iptal durumu ise gerek raporlama gerekse mÃ¼Återi deneyimi perspektifinden doÄru   bilgilendirmeler yapÄ±labilmesi aÃ§Ä±sÄ±ndan aÅaÄÄ±daki gibi detay kodlarÄ± ile zenginleÅtirilmiÅtir: \n \n RÄ±za Ä°ptal Detay Kodu: \n \n \n \n â01â :\tYeni RÄ±za Talebi ile Ä°ptal \n â02â :\tKullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal \n â03â :\tKullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal \n â04â :\tSÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor \n â05â :\tSÃ¼re AÅÄ±mÄ± : Yetkilendirildi \n â06â :\tSÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi \n â07â :\tGKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± \n â08â :\tGKD iptali : RÄ±zano ile kimlik bilgileri uyuÅmamasÄ± \n â09â :\tGKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor \n â10â :\tGKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n â11â :\tGKD iptali : Hesap Yetki S

16orunu \n â12â :\tGKD iptali : ÃHK HHS kontrollerini aÅamadÄ± \n â13â :\tGKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi \n â14â :\tGKD iptali : Fraud ÅÃ¼phesi \n â15â :\tHesap RÄ±za GÃ¼ncelleme Talebi ile Ä°ptal \n â99â :\tGKD iptali : DiÄer \n \n \n 4.1 ve 4.2 bÃ¶lÃ¼mlerinde detaylandÄ±rÄ±lan rÄ±za durum deÄiÅikliklerinde rÄ±za iptal detay kodlarÄ± kullanÄ±lmÄ±ÅtÄ±r. \n ÃrneÄin Bâ¨ I/01 denildiÄinde âYetki Bekleniyorâ rÄ±za durumundan âYetki Ä°ptalâ rÄ±za durumuna RÄ±za Ä°ptal Detay Kodu da â01â yani âYeni RÄ±za Talebi ile Ä°ptalâ olarak gÃ¼ncellenmelidir ifade edilmiÅtir. \n ÃHK verdiÄi rÄ±za sÄ±rasÄ±nda seÃ§tiÄi hesaplarÄ±ndan/kartlarÄ±ndan biri kapatÄ±lÄ±rsa, diÄer hesaplara/kartlara ait bilgileri gÃ¶rmeye devam eder. Ancak ÃHKânÄ±n hesabÄ±na/kartÄ±na ait bilgilerinin YÃS'e iletilmesini istemediÄi durumda, rÄ±zasÄ±nÄ± tamamen iptal ederek yeni hesap/kart listesi ile yeni rÄ±za vermesi gerekmektedir. Yani hesap/kart kapanmasÄ± nedeniyle rÄ±za geÃ§erliliÄini yitirmez. ÃHK'nÄ±n proaktif olarak bu hesabÄ±/kartÄ± rÄ±zadan Ã§Ä±karmasÄ± durumunda rÄ±za iptali olur. \n RÄ±za iptal edilmediÄi ve geÃ§erli olduÄu sÃ¼rece kapalÄ± hesaplar/kartlar iÃ§in diÄer Ã§evrimiÃ§i kanallarda uygulanan yÃ¶ntem izlenmelidir. DiÄer Ã§evrimiÃ§i kanallarda kapalÄ± hesaplara/kartlara iliÅkin bilgi dÃ¶nÃ¼lmÃ¼yor ise ÃHVPS'den de dÃ¶nÃ¼Å yapÄ±lmaz. ÃHKânÄ±n rÄ±za onayÄ± verdiÄi aÃ§Ä±k hesaplarÄ±nÄ±n/kartlarÄ±nÄ±n tÃ¼mÃ¼ HHS tarafÄ±nda kapatÄ±ldÄ±ÄÄ± durumda, yine aynÄ± Åekilde HHS Ã§evrimiÃ§i kanallarÄ±nda koyduÄu kurallara gÃ¶re bu hesaplarÄ±nÄ±n/kartlarÄ±nÄ±n YÃS uygulamasÄ±nda gÃ¶sterilmesine karar verir. \n Hesap/kart kapama ve ticari kullanÄ±cÄ±larÄ±n hesaplar/kartlar Ã¼zerindeki yetki deÄiÅiklikleri HHS'nin iÃ§ sistemleri tarafÄ±ndan yapÄ±lan kontrollerle yÃ¶netilir. Buradaki deÄiÅiklikler ile HHS sistemsel olarak rÄ±za iptali gerÃ§ekleÅtiremez. ÃHK izni ve onayÄ± dahilinde rÄ±za iptal gerÃ§ekleÅtirilmesi gerekmektedir. \n HHS'ler sunmuÅ olduklarÄ± RÄ±za Ä°ptal ekranÄ±nÄ± (sadece Hesap Bilgisi RÄ±zasÄ± iÃ§in), hangi ortamlardan GKD yapÄ±lmasÄ±na izin veriliyorsa (web/mobil) aynÄ± ortamdan ÃHK'ya sunmalÄ±dÄ±r.  ÃrneÄin bir HHS bireysel mÃ¼Återileri iÃ§in web ve mobil, kurumsal mÃ¼Återiler iÃ§in web Ã¼zerinden GKD imkanÄ± sunuyor ise, minimumda bireysel mÃ¼Återiler iÃ§in web ve mobil ortamlarÄ±ndan, kurumsal mÃ¼Återiler iÃ§in web ortamÄ±ndan RÄ±za Ä°ptal ekranÄ± aracÄ±lÄ±ÄÄ± ile rÄ±za iptaline izin vermelidir. Bunun dÄ±ÅÄ±nda Ã§aÄrÄ± merkezi ya da Åube gibi ortamlardan sunacaÄÄ± RÄ±za Ä°ptal imkanÄ± HHS inisiyatifindedir. Bahsi geÃ§en zorunluluk Ãdeme Emri RÄ±za Ä°ptal ekranÄ± iÃ§in geÃ§erli deÄildir. \n Benzer Åekilde YÃS'ler hangi ortamlardan (web/mobil) hizmet veriyorsa, aynÄ± ortam Ã¼zerinden RÄ±za Ä°ptal ekranÄ±nÄ± sunmalÄ±dÄ±r. \n 4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n, bir YÃS iÃ§in, bir HHS'de aktif tek bir rÄ±zasÄ± olabilir.\nBir ÃHK hem kiÅisel olarak hem de bir kurumun kullanÄ±cÄ±sÄ± olabilir. Bu durumda kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Hesap Bilgisi RÄ±zasÄ± isteÄi HHSâye iletilir. \na.\tHHS ÃHK'ya ait iÃ§eride rÄ±za var mÄ± kontrol eder. EÄer yoksa  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \nb.\tEÄer iÃ§eride rÄ±za varsa ; \n \n Yeni hesap bilgisi rÄ±zasÄ± talebi baÅlatÄ±lmÄ±Åsa (oncekiRizaNo alanÄ±nÄ±n hiÃ§ gÃ¶nderilmediÄi durum):  \ni. RÄ±za durumu Yetki Bekleniyor - B ise; \nÂ Â Â Â     HHS, sistemde Yetki Bekleniyor - B rÄ±za durumuna sahip kayÄ±t olduÄu iÃ§in, Ã¶ncelikle eski kaydÄ± Yetki Ä°ptal - I durumuna getirir.  RÄ±za Ä°ptal Detay Kodu âYeni RÄ±za Talebi ile iptalâ olmalÄ±dÄ±r.  B â¨ I / 01  SonrasÄ±nda,  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \n \n Â Â Â Â  ii. RÄ±za durumu Yetkilendirildi - Y veya Yetki KullanÄ±ldÄ± - K ise; \nÂ Â Â Â ÃHK'nÄ±n halihazÄ±rda verilmiÅ bir rÄ±zasÄ± vardÄ±r. HHS, Ã¶nce mevcut rÄ±zanÄ±n iptalinin yapÄ±lmasÄ± gerektiÄine dair   TR.OHVPS.Business.ConsentAlreadyExists  hatasÄ±nÄ± dÃ¶ner. YÃS, HHS ya da YÃS uygulamasÄ± Ã¼zerinden bu rÄ±zanÄ±n iptal edilmesi gerektiÄine dair ÃHK'ya bilgilendirme yapar. \n Â Â Â Â  iii.\tRÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise Yetki Bekleniyor - B durumunda yeni rÄ±za no oluÅturur. \n Â Â Â Â  iv.\tRÄ±za durumu Yetki Ä°ptal - I ise  Yetki Bekleniyor - B  durumunda yeni rÄ±za no oluÅturur. \n \n \n BaÅlatÄ±lan rÄ±za isteÄi gÃ¼ncelleme akÄ±ÅÄ± ile baÅlatÄ±lmasÄ± durumunda oncekiRizaNo deÄeri rÄ±za isteÄinde bulunan ÃHKâya ait olmalÄ±dÄ±r. ÃHKâya ait olmamasÄ± durumunda  TR.OHVPS.Business.CustomerNotFound  hatasÄ± dÃ¶nÃ¼lÃ¼r. AynÄ± ÃHK olmasÄ± durumunda ;

16 \n i. Ãnceki RÄ±za durumu B: Yetki Bekleniyor , Y: Yetkilendirildi ya da I :Yetki Ä°ptal  ise;  TR.OHVPS.Business.ConsentStatusNotforUpdate  hatasÄ± verilecektir. \n ii. Yetki KullanÄ±ldÄ± - K ise; hesap rÄ±zasÄ± baÅarÄ±lÄ± gerÃ§ekleÅtiriliyor olup Yetki Bekleniyor - B durumunda yeni bir rÄ±za oluÅturulur. Ãnceki hesap bilgisi rÄ±zasÄ± durumunda bir gÃ¼ncelleme yapÄ±lmaz. \n iii. Yetki SonlandÄ±rÄ±ldÄ± - S ise; RÄ±za GÃ¼ncelleme ZamanÄ± kontrol edilir. \n â¢\tSonlandÄ±rÄ±ldÄ± statÃ¼sÃ¼ne geÃ§mesiyle birlikte rÄ±za gÃ¼ncelleme zamanÄ± Ã¼zerinden 30 gÃ¼n geÃ§miÅ ise  TR.OHVPS.Business.ConsentStatusNotforUpdate  hatasÄ± verilir. \nâ¢\t30 gÃ¼n geÃ§memiÅ ise; hesap rÄ±zasÄ± baÅarÄ±lÄ± gerÃ§ekleÅtiriliyor olup Yetki Bekleniyor - B durumunda yeni bir rÄ±za oluÅturulur. Ãnceki hesap bilgisi rÄ±zasÄ± durumunda bir gÃ¼ncelleme yapÄ±lmaz. \n \n \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda RÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.  B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: TarayÄ±cÄ±yÄ± kapatmÄ±Å olabilir) RÄ±za Yetki Bekleniyor - B rÄ±za durumunda kalÄ±r.  5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B rÄ±za durumundaki kayÄ±tlar Yetki Ä°ptal  : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir.   B â¨ I / 04  Bkz. 9. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine  rizaIptDtyKod  deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda/kartlarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 12 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 13 \n \n \n Fraud ÅÃ¼phesi Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 99 \n \n \n \n \n \n \n EriÅim Belirteci API \n a. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda; \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetki KullanÄ±ldÄ± - K  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n â¢  Hesap RÄ±zasÄ± GÃ¼ncelleme akÄ±ÅÄ± ile hesap bilgi rÄ±zasÄ± gÃ¼ncelleniyor ise yeni hesap bilgisi rÄ±zasÄ± K durumuna gÃ¼ncellendiÄinde Ã¶nceki rÄ±za no durumu I â 15 (Hesap RÄ±za GÃ¼ncelleme ile Ä°ptal) ile iptale Ã§ekilir. \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Sorgulama: HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir hesap bilgisi-rizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. RÄ±za numarasÄ± ile sorgulama yapÄ±lÄ±r. \n \n \n Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali: HBHS Ã¼zerinden ya da HHS Ã¼zerinden yapÄ±lan rÄ±za iptallerinde RÄ±za durumu  Yetki Ä°ptal - I olarak gÃ¼ncellenir. RÄ±za numarasÄ± ile iptal saÄlanÄ±r. \n a. HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir.  RÄ±za durumu sorgulanÄ±r. \n RÄ±za numarasÄ± Yetki Bekleniyor - B ve Yetkilendirildi - Y ve Yetki KullanÄ±ldÄ± - K durumlarÄ±nda ise Yetki Ä°ptal durumuna getirilir. RÄ±za gnclzmn timestamp ile gÃ¼ncellenir.\nHHS, RÄ±za iptalinde aynÄ± zamanda eriÅim belirtecini de invalid hale getirmelidir. \n B â¨ I / 02 \n Y â¨ I / 02 \n K â¨ I / 02 \n b.\tYÃS Ã¼zerinden yapÄ±lacak iptal iÅleminde yine Y ve B ve K rÄ±za durumlarÄ±nda ise iptal edilebilir. \n B â¨ I / 03 \n Y â¨ I / 03 \n K â¨ I / 03 \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise iptal gerÃ§ekleÅmez. âRÄ±za durumunuz iptal etmeye uygun deÄildir.â hatasÄ± ÃHK'ya yansÄ±tÄ±lÄ±r.  TR.OHVPS.Resource.ConsentRevoked \n \n \n ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.\nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde RÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki S

16onlandÄ±rÄ±ldÄ± durumuna Ã§ekilmelidir.   K â¨ S \n \n \n Hesaplar, Bakiye ve Ä°Ålemler servislerinde eriÅim belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.\nGeÃ§erli bir eriÅim belirteci yok ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n YÃS'Ã¼n; RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda Hesaplar, Bakiye ve Ä°Ålemler servislerini Ã§aÄÄ±rmamasÄ± beklenir. HHS'nin bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda  TR.OHVPS.Resource.ConsentRevoked  hatasÄ±nÄ± dÃ¶nmesi gereklidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K dÄ±ÅÄ±nda ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± verilmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K ise servis akÄ±ÅlarÄ±na devam edilir. \n RÄ±za sorgulama API'sinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound hatasÄ±  verilmelidir. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir âYetki Bekleniyorâ durumunda kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor  â¨ RÄ±za Ä°ptal  / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir âYetkilendirildiâ durumunda kalan kayÄ±tlar gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ±: Yetkilendirildi  B â¨ I / 05 \nYukarÄ±da bahsedilen, YÃS SÃ¼re AÅÄ±mÄ± nedeniyle rÄ±za iptal durum gÃ¼ncellemelerini yapmadan Ã¶nce HHSâyi sorgulayarak rÄ±za durumunu Ã¶Ärenmeli ve sÃ¼re aÅÄ±mÄ± dÄ±ÅÄ±nda bir kodu varsa aynÄ± kodla kendi sistemini gÃ¼ncellemelidir. \nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde rÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ±âya gÃ¼ncellenir.  K â¨ S \n 4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n bir YÃS iÃ§in bir HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n Kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ± isteÄi HHSâye iletilir. Ä°Ã§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za no oluÅturur. \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda rÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.   B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: BrowserÄ± kapatmÄ±Å olabilir)\nRÄ±za durumu Yetki Bekleniyor'dur. 5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B durumundaki kayÄ±tlar RÄ±za Ä°ptal : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir. Bkz. 8. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine rizaIptDtyKod deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 12 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 13 \n \n \n Fraud ÅÃ¼phesi Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 99 \n \n \n \n \n \n \n GKD muafiyeti olduÄunda YÃS HHSâden arka planda onay alÄ±r. Bu onay sÄ±rasÄ±nda rÄ±za durumu  Yetkilendirildi  yapÄ±lÄ±r.  B â¨ Y \n \n \n EriÅim Belirteci API \na. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda;

16 \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B , Yetki KullanÄ±ldÄ± - K  ya da Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K veya Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Ãdeme BaÅlatma API Ã¶nce eriÅim belirteci ve sonrasÄ±nda rÄ±za kontolÃ¼ yapÄ±larak gerÃ§ekleÅtirilmelidir \n \n Ãncelikle EriÅim Belirteci kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir EriÅim Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Bekleniyor - B , Yetkilendirildi - Y, Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda Ã¶deme emri gerÃ§ekleÅtirilir.  RÄ±za durumu Yetki KullanÄ±ldÄ± - K'dan Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E yapÄ±lmalÄ±dÄ±r.   K â¨E \n \n \n \n Sorgulama: GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlarda, Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle, Ã¶demeEmriRizasi nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r.\nRÄ±za sorgulama, Ãdeme Emri Sorgulama API'lerinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound  hatasÄ± verilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ±nÄ±n Ä°ptali bulunmamaktadÄ±r. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir Yetki Bekleniyor'da kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir Yetkilendirildi'de kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetkilendirildi  B â¨ I / 05 \n 5 dakikadan uzun sÃ¼redir Yetki kullanÄ±ldÄ±'da kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetki kullanÄ±ldÄ± â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi  B â¨ I / 06 \n Yenileme belirteci Son Tarih geldiÄinde rÄ±za durumu Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼âden Yetki SonlandÄ±rÄ±ldÄ±'ya gÃ¼ncellenir. \n E â¨ S \n \n \n GKD muafiyeti sadece Ã¶deme baÅlatma servislerinde bulunmaktadÄ±r. \n \n \n"},{frontmatter:{},regularPath:"/v2.0.0/contents/tanim-ve-kisitlamalar.html",relativePath:"v2.0.0/contents/tanim-ve-kisitlamalar.md",key:"v-bfbd2b46",path:"/v2.0.0/contents/tanim-ve-kisitlamalar.html",content:"  1.\tTanÄ±m ve KÄ±saltmalar   \n Tablo 1: TanÄ±m ve KÄ±saltmalar \n \n \n \n KÄ±saltma \n TanÄ±m \n AÃ§Ä±klama \n Ä°ngilizce AÃ§Ä±klama \n Ä°ngilizce KÄ±saltma \n \n \n \n \n ÃS \n ÃerÃ§eve SÃ¶zleÅme \n Ãdeme hizmeti saÄlayÄ±cÄ±sÄ± ile mÃ¼Återi arasÄ±nda tekil veya sÃ¼reklilik arz eden Ã¶deme iÅlemlerinin yÃ¼rÃ¼tÃ¼lmesine ve mÃ¼mkÃ¼n olan durumlarda Ã¶deme hesabÄ±nÄ±n aÃ§Ä±lmasÄ±na iliÅkin usul ve esaslarÄ± belirleyen sÃ¶zleÅme \n \n \n \n \n EPK \n Elektronik Para KuruluÅu \n Kanun kapsamÄ±nda elektronik para ihraÃ§ etme yetkisi verilen tÃ¼zel kiÅi \n Electronic Money Institution \n EMI \n \n \n FAST \n FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi \n TCMB tarafÄ±ndan iÅletilen FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi Sistemi \n \n \n \n \n FAST TR-Karekod \n FAST-TR Karekod Teknik Ä°lke ve Kurallar Rehberi \n TR Karekodâun FAST Sistemi aracÄ±lÄ±ÄÄ±yla gerÃ§ekleÅecek iÅlemlerde kullanÄ±lmasÄ±na iliÅkin detaylÄ± teknik ilke ve kurallarÄ±nÄ± iÃ§eren dokÃ¼man \n \n \n \n \n GEÃÄ°T \n BKM API GeÃ§idi \n BankalararasÄ± Kart Merkezi (BKM) tarafÄ±ndan geliÅtirilen ve taraflara standart AÃ§Ä±k BankacÄ±lÄ±k iÅlemleri sunulmasÄ±nÄ± saÄlayan API GeÃ§idi uygulamasÄ± \n \n \n \n \n GKD \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n Kimlik doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin bildiÄi, sahip olduÄu veya biyometrik bir karakteristiÄi olan bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntem \n Strong Customer Authentication \n SCA \n \n \n Ä°B \n Ä°Ålem Bilgisi \n GerÃ§ekleÅtirilen iÅleme iliÅkin iÅlem zamanÄ±nÄ±, iÅlemin niteliÄini ve Ã¶deme iÅlemi iÃ§in Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve Ã¶demenin gÃ¶ndereni ile alÄ±cÄ±sÄ±nÄ± veya toplu Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve gÃ¶ndereni ile alÄ±cÄ±larÄ±nÄ± iÃ§eren bilgi \n \n \n \n \n Ä°DK \n Ä°Ålem DoÄrulama Kodu \n Kimlik doÄrulama yÃ¶ntemlerinden biriyle kendisini sisteme tanÄ±tan bir mÃ¼Återinin gerÃ§ekleÅtirmek istediÄi

16iÅleme Ã¶zgÃ¼ olmak ve belirli bir geÃ§erlilik sÃ¼resi iÃ§inde iÅlem onayÄ±nda kullanÄ±lmak Ã¼zere oluÅturulan, finansal sonuÃ§ doÄrunan iÅlemlerde kiÅiye onay anÄ±nda ilgili iÅlem bilgisi (Ä°B) ile birlikte gÃ¶sterilen, alÄ±cÄ± veya tutarÄ±n deÄiÅmesiyle geÃ§ersiz hale gelen bilgi \n Authentication Code \n AC \n \n \n KOLAS \n Kolay Adresleme Servisi \n Fon transferlerinde hesap numarasÄ± ile ad soyad yerine kullanÄ±lan ve belirli bir hesap ile eÅleÅtirilmiÅ telefon numarasÄ±, e-posta adresi, T.C. Kimlik NumarasÄ± (TCKN), Vergi Kimlik NumarasÄ± (VKN), YabancÄ± Kimlik NumarasÄ± veya Pasaport NumarasÄ± gibi Kolay Adres bilgilerinin kaydedilmesini, gÃ¼ncellenmesini ve sorgulamasÄ±nÄ± saÄlayan katman servis \n \n \n \n \n HBHS \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (g) bendinde tanÄ±mlanan Ã¶deme hizmetini (hesap bilgisi hizmetini) sunan tÃ¼zel kiÅi \n Account Information Service Provider \n AISP \n \n \n HHS \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± \n Nezdinde Ã¶deme hesabÄ± bulunan Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± \n Account Servicing Payment Service Provider \n ASPSP \n \n \n ÃBHS \n Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (f) bendinde tanÄ±mlanan Ã¶deme hizmetini (Ã¶deme emri baÅlatma hizmetini) sunan tÃ¼zel kiÅi \n Payment Initiation Service Provider \n PISP \n \n \n ÃDK \n Ãdeme KuruluÅu \n Ãdeme hizmeti saÄlamak ve gerÃ§ekleÅtirmek iÃ§in Kanun kapsamÄ±nda yetkilendirilmiÅ tÃ¼zel kiÅi \n Payment Institution \n PI \n \n \n ÃH \n Ãdeme HesabÄ± \n Ãdeme hizmeti kullanÄ±cÄ±sÄ± adÄ±na aÃ§Ä±lan ve Ã¶deme iÅleminin yÃ¼rÃ¼tÃ¼lmesinde kullanÄ±lan hesap \n Payment Account \n PA \n \n \n ÃHK \n Ãdeme Hizmeti KullanÄ±cÄ±sÄ± (MÃ¼Återi) \n GÃ¶nderen, alÄ±cÄ± veya her ikisi sÄ±fatÄ±yla belirli bir Ã¶deme hizmetinden faydalanan gerÃ§ek veya tÃ¼zel kiÅi \n Payment Service User \n PSU \n \n \n ÃHS \n Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n 5411 sayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar, EPK, ÃDK ve Posta ve Telgraf TeÅkilatÄ± Anonim Åirketi(PTT) \n Payment Service Provider \n PSP \n \n \n ÃHVPS \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri \n Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri \n \n \n \n \n PÃS \n Perakende Ãdeme Sistemi \n TCMB tarafÄ±ndan iÅletilen, iÅlemlerin TÃ¼rk LirasÄ± Ã¼zerinden gerÃ§ekleÅtiÄi MÃ¼Återiler ArasÄ± TÃ¼rk LirasÄ± AktarÄ±m Sistemi \n \n \n \n \n TR-Karekod \n TR-Karekod Ä°lke ve KurallarÄ± \n Ulusal karekod (TR Karekod) ilke ve kurallarÄ±nÄ±n belirlendiÄi belge \n \n \n \n \n YÃS \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n Ãdeme emri baÅlatma hizmeti ve/veya hesap bilgisi hizmeti sunan tÃ¼zel kiÅi \n Third Party Payment Service Providers \n TPP \n \n \n \n"},{frontmatter:{},regularPath:"/v2.0.0/deneyalani/genel-bilgiler.html",relativePath:"v2.0.0/deneyalani/genel-bilgiler.md",key:"v-48365a59",path:"/v2.0.0/deneyalani/genel-bilgiler.html",content:" GENEL BiLGÄ°LER: \n ÃHVPS API Ä°lke ve KurallarÄ± dokÃ¼manÄ±na istinaden geliÅtirmelerini yapan/yapacak olan katÄ±lÄ±mcÄ±lar geliÅtirdikleri sÃ¼rÃ¼me ait APIâlerin nasÄ±l Ã§alÄ±ÅtÄ±klarÄ±nÄ± gÃ¶rmek istediklerinde âDeney AlanÄ±â Ã¼zerinden gÃ¶zlem yapabilirler. Bu kapsamda, Deney AlanÄ± katÄ±lÄ±mcÄ±lara tarayÄ±cÄ± Ã¼zerinden statik verilerle iÅlem baÅlatarak, dÃ¶nen yanÄ±tÄ± inceleme imkanÄ± sunar. \n Deney AlanÄ± ile sunulan imkanlar Åu Åekildedir: \n \n Servisler durum bilgisi iÃ§ermeyecek Åekilde (stateless) olarak sunulmaktadÄ±r. \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama akÄ±ÅlarÄ±nda kurum Ã¶zelinde oluÅturulan yetkilendirme kimlik bilgilerine ihtiyaÃ§ duyulmamaktadÄ±r. \n YanÄ±t veri kÃ¼mesi statiktir. Servislere yapÄ±lan istekler, her zaman aynÄ± yanÄ±tÄ± dÃ¶nmektedir. \n Yeni oluÅturma, gÃ¼ncelleme, silme iÅlemleri kaynak veri Ã¼zerinde deÄiÅiklik yapmamaktadÄ±r. \n Deney alanÄ± genelin kullanÄ±mÄ±na aÃ§Ä±ktÄ±r. Ãyelik kaydÄ± olmaksÄ±zÄ±n Deney AlanÄ± Ã¼zerinden API incelemeleri gerÃ§ekleÅtirilebilmektedir. \n API dokÃ¼manÄ±nda yapÄ±lacak minor deÄiÅiklikler deney alanÄ±na yansÄ±tÄ±lmayacaktÄ±r. \n \n Not: Deney AlanÄ±ânÄ±n kapsamÄ± geniÅletilmiÅ versiyonu â âBKM ÃHVPS SimÃ¼latÃ¶râ uygulamasÄ± hem HHS hem de YÃS katÄ±lÄ±mcÄ±larÄ±nÄ±n; test uygulamalarÄ±nÄ± uÃ§tan uca test edebilebileceÄi bir ortamdÄ±r. SimÃ¼latÃ¶r uygulamasÄ± Ã¼zerinden dinamik veri giriÅi yaparak, geliÅtirilen servisler ile zorunlu senaryolarÄ±n tÃ¼mÃ¼nÃ¼n simÃ¼lasyonu gerÃ§ekleÅtirilebilir. SimÃ¼latÃ¶r ortamÄ±ndaki APIâler, Ã¼retim ortamÄ±nÄ±n bir kopyasÄ± olacak Åekilde oluÅturulmuÅtur ve kurumlarÄ±n Ã¼retim ortamÄ±na hazÄ±r hale gelmelerine aracÄ±lÄ±k eder. Bu uygulama, pÃ¼rÃ¼zsÃ¼z bir Ã¼retim ortamÄ± geÃ§iÅi imkanÄ± saÄlar ve ÃHVPS BKM Teknik Sertifikasyonu geÃ§mek iÃ§in koÅulmasÄ± gereken sertifikasyon senaryolarÄ± BKM ÃHVPS SimÃ¼latÃ¶râÃ¼ Ã¼zerinden sunulmaktadÄ±r. BKM SimÃ¼latÃ¶r kullanÄ±mÄ± iÃ§in ayrÄ± bir sÃ¼reÃ§ iÅletilmekte olup daha fazla detaylÄ± bilgi almak iÃ§in [email protected] adresine taleplerinizi iletmeniz gerekmektedir. \n Ãdeme Emri BaÅlatma API Deney AlanÄ± \n"},{frontmatter:{},regularPath:"/v2.0.0/deneyalani/duzenli-odeme-emri-api.html",relativePath:"v2.0.0/deneyalani/duzenli-odeme-emri-api.md",key:"v-e73a02ea",path:"/v2.0.0/deneyalani/duzenli-odeme-emri-api.html",content:" \n   \

16n "},{title:"5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama",frontmatter:{},regularPath:"/v2.0.0/contents/gkd.html",relativePath:"v2.0.0/contents/gkd.md",key:"v-24f9d8c6",path:"/v2.0.0/contents/gkd.html",headers:[{level:2,title:"5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-1-yonlendirmeli-guclu-kimlik-dogrulama"},{level:2,title:"5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-2-ayrÄ±k-guclu-kimlik-dogrulama"},{level:3,title:"5.2.1\tStatik Model",slug:"_5-2-1statik-model"},{level:2,title:"5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi",slug:"_5-3-yonlendirme-bildirim-adresleri-ve-durum-kodu-parametresi"},{level:2,title:"5.4  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri",slug:"_5-4-guclu-kimlik-dogrulama-kontrolleri"}],content:" 5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n MÃ¼Återi iÃ§in gÃ¼Ã§lÃ¼ kimlik doÄrulama, ÃHKânÄ±n (mÃ¼Återinin) kimliÄinin doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin âbildiÄiâ, âsahip olduÄuâ veya âbiyometrik bir karakteristiÄi olanâ bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntemi tanÄ±mlar. \n Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄ uyarÄ±nca hesap bilgisi hizmetinde mÃ¼Återinin onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda ve Ã¶deme emri baÅlatma hizmetinde her bir Ã¶deme emri baÅlatma iÅleminde  HHS tarafÄ±ndan mÃ¼Återiye gÃ¼Ã§lÃ¼ kimlik doÄrulama (GKD) uygulanmasÄ± esastÄ±r.  Buna gÃ¶re: \n \n \n Hesap bilgisi hizmetinde ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda  TebliÄin 26 ncÄ± maddesinin 1 inci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya GKD uygulanÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 2 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanÄ±r ve iÅlem doÄrulama kodu ile ÃHKânÄ±n onayÄ± alÄ±nÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 3 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanmasÄ±na iliÅkin istisna veya ilave gÃ¼venlik Ã¶nlemleri iÅbu API Ä°lke ve KurallarÄ± belgesinde tanÄ±mlanÄ±r. \n \n \n HHS, gÃ¼Ã§lÃ¼ kimlik doÄrulama sÃ¼recinde ÃHKânin sahip olduÄu bileÅen sÄ±nÄ±fÄ± olarak SMS OTP ya da SMS ile iÅlem doÄrulama kodu kullanabilir. \n \n \n HHS, aÅaÄÄ±daki hallerde veya  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re tek bileÅen ile kimlik doÄrulama yapabilir. \n \n Ãdemenin gÃ¶ndereni ve alÄ±cÄ±sÄ±nÄ±n aynÄ± olmasÄ±, \n Daha Ã¶nce tanÄ±mlanmÄ±Å gÃ¼venli alÄ±cÄ±lar listesine Ã¶deme yapÄ±lmasÄ±, \n ÃHKânin talimatÄ±na istinaden gerÃ§ekleÅtirilen dÃ¼zenli bir Ã¶deme olmasÄ±. \n \n \n \n Tek bileÅen ile kimlik doÄrulama yapÄ±lan bu iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin mÃ¼Återi tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye ait olur. \n \n \n Ä°Ålem DoÄrulamada  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± ÄÄ bendindeki  iÅlem bilgisi tanÄ±mÄ±na uygun olarak aÅaÄÄ±daki bilgiler ile  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  tanÄ±mlanan iÅleme Ã¶zel Ã¼retilmiÅ iÅlem doÄrulama kodu birlikte kullanÄ±lÄ±r. \n \n AlÄ±cÄ± Unvan (Kolas akÄ±ÅÄ±nda maskeli olarak)  (Ã¶deme emri baÅlatma hizmeti) \n Tutar (Ã¶deme emri baÅlatma hizmeti) \n Referans bilgisi (8 karakterden kÃ¼Ã§Ã¼k ise alanÄ±n tÃ¼m deÄeri, bÃ¼yÃ¼k ise ilk 4 ve son 4 hanesi) \n \n Ä°Åleme ait yukarÄ±daki bilgilerden en az biri deÄiÅtiÄi zaman  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  belirtildiÄi gibi yeni bir iÅlem doÄrulama kodu Ã¼retilecek Åekilde akÄ±Å kurgulanmalÄ±dÄ±r. \n \n \n Ä°Ålem doÄrulama kodunun gÃ¶nderilmesinden HHS sorumludur. HHS,  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re iÅlem doÄrulama kodu kullanmaksÄ±zÄ±n ÃHKânÄ±n onayÄ±nÄ± alabilir. Ä°Ålem doÄrulama kodu kullanÄ±lmayan iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin ÃHK tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye aittir. \n \n \n ÃHVPS API Ä°lke ve KurallarÄ± kapsamÄ±nda iki adet GÃ¼Ã§lÃ¼ Kimlik DoÄrulama (GKD) yÃ¶ntemi kullanÄ±lacaktÄ±r: \n \n YÃ¶nlendirmeli (Redirect) GKD YÃ¶ntemi \n AyrÄ±k (Decoupled) GKD YÃ¶ntemi \n \n \n \n Hem web hem mobil uygulama hizmeti bulunan katÄ±lÄ±mcÄ±lar iÃ§in her iki uygulama Ã¶zelinde de yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. Web ya da mobil uygulamalardan sadece birinin olmasÄ± durumunda ilgili uygulama Ã¶zelinde yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. \n 5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n YÃ¶nlendirmeli GKD YÃ¶nteminde, mÃ¼Återi kimlik doÄrulama iÃ§in YÃS tarafÄ±ndan HHS arayÃ¼zÃ¼ne yÃ¶nlendirilir. \n MÃ¼Återi HHSâye (uygulama veya web arayÃ¼zÃ¼ vasÄ±tasÄ±yla) yÃ¶nlendirildikten s

16onra mÃ¼Återinin gÃ¼Ã§lÃ¼ kimlik doÄrulamasÄ± adÄ±m adÄ±m ve doÄrudan HHS ile mÃ¼Återi arasÄ±nda yÃ¼rÃ¼tÃ¼lÃ¼r. GKDânin tamamlanmasÄ±ndan sonra mÃ¼Återi tekrar YÃS uygulamasÄ±na yÃ¶nlendirilir. \n YÃ¶nlendirmeli GKD YÃ¶ntemi iÃ§in Ã¼st dÃ¼zey Ã¶rnek iÅ akÄ±ÅÄ± aÅaÄÄ±daki adÄ±mlardan oluÅur: \n \n YÃS, GKD iÃ§in HHS tarafÄ±ndan tanÄ±mlanan arayÃ¼ze (tarayÄ±cÄ± ya da uygulama) yÃ¶nlendirme yapar. \n MÃ¼Återi, YÃS arayÃ¼zÃ¼nden ayrÄ±lÄ±r, yÃ¶nlendirildiÄi HHS arayÃ¼zÃ¼ Ã¼zerinde kimlik doÄrulama iÅlemlerini gerÃ§ekleÅtirir. \n GKD tamamlandÄ±ktan sonra mÃ¼Återi, YÃS arayÃ¼zÃ¼ne tekrar yÃ¶nlendirilir ve iÅlem sonucu gÃ¶rÃ¼ntÃ¼lenir. \n \n YÃ¶nlendirmeli GKD iÃ§in temel gereklilikler ÅunlardÄ±r: \n \n Ãdeme hizmeti (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) tarayÄ±cÄ± ya da uygulama tabanlÄ± bir Åekilde sunulabilir. Web ya da mobil uygulamalardan sadece birinin olmasÄ± durumunda ilgili uygulama Ã¶zelinde yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n YÃ¶nlendirmeli GKD YÃ¶nteminde; rÄ±za isteÄine baÅarÄ±lÄ± yanÄ±t alÄ±ndÄ±ktan sonra, ÃHK, kimlik doÄrulama iÃ§in YÃS tarafÄ±ndan HHS arayÃ¼zÃ¼ne yÃ¶nlendirilir.\nYÃS, yÃ¶nlendirme akÄ±ÅÄ±nÄ± kendi sunucusundan karÅÄ±layacaÄÄ± bir istek ile baÅlatmalÄ±dÄ±r. YÃS web arayÃ¼zÃ¼ndeki bu yapÄ±, 302 yanÄ±t kodu ve yanÄ±t baÅlÄ±ÄÄ±ndaki Location deÄeri ile ÃHK tarayÄ±cÄ±sÄ±nÄ± HHS adresine yÃ¶nlendirmelidir. Bu sayede GKD, HHS tarafÄ±nda baÅlayabilir. \n YÃS tarafÄ±ndaki yÃ¶nlendirme servisi iÃ§in Ã¶rnek response; \n HTTP/1.1 302 Found\nLocation: {{hhsYonAdr}}\n \n ÃHK, HHSâye (app veya web arayÃ¼zÃ¼ vasÄ±tasÄ±yla) yÃ¶nlendirildikten sonra ÃHK'nin gÃ¼Ã§lÃ¼ kimlik doÄrulamasÄ± HHS ile ÃHK arasÄ±nda yÃ¼rÃ¼tÃ¼lÃ¼r. GKDânin tamamlanmasÄ±ndan sonra ÃHK tekrar YÃS uygulamasÄ±na yÃ¶nlendirilir. \n HHS, yÃ¶nlendirme akÄ±ÅÄ±nÄ± kendi sunucusundan karÅÄ±layacaÄÄ± bir istek ile baÅlatmalÄ±dÄ±r. HHS web/app arayÃ¼zÃ¼ndeki bu yapÄ±, ÃHK'nin oturumunu gÃ¼venli bir Åekilde kapatmalÄ±dÄ±r. ArdÄ±ndan 302 yanÄ±t kodu ve yanÄ±t baÅlÄ±ÄÄ±ndaki Location deÄeri ile ÃHK tarayÄ±cÄ±sÄ±nÄ± YÃS adresine yÃ¶nlendirmelidir. \n HTTP/1.1 302 Found\nLocation: {{yosYonAdr}}&rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O\n \n HHSânin web arayÃ¼zÃ¼ne, \n \n HHSânin mobil uygulamasÄ±nÄ±n olmadÄ±ÄÄ±, \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) sunduÄu mobil cihazda HHS uygulamasÄ±nÄ±n yÃ¼klÃ¼ olmadÄ±ÄÄ±, \ndurumlarda yÃ¶nlendirme yapÄ±lÄ±r. \n \n YÃSâÃ¼n mobil uygulamasÄ± varsa mobil cihazda uygulamadan tarayÄ±cÄ±ya, YÃSâÃ¼n mobil uygulamasÄ± yoksa Ã¶deme hizmetinin sunduÄu cihazda (KiÅisel Bilgisayar veya Mobil Cihaz) tarayÄ±cÄ± Ã¼zerinden yÃ¶nlendirme yapÄ±lÄ±r. \n Uygulama TabanlÄ± YÃ¶nlendirme \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) YÃSâÃ¼n mobil uygulamasÄ± ile kullanÄ±yorsa, aynÄ± mobil cihazda HHSânin mobil uygulamasÄ±nÄ±n yÃ¼klenmiÅ olmasÄ± durumunda, ÃHK doÄrulamasÄ±nÄ±n HHS mobil uygulamasÄ± tarafÄ±ndan yapÄ±lmasÄ± iÃ§in uygulama tabanlÄ± yÃ¶nlendirme yapÄ±lÄ±r. BÃ¶ylece ÃHK, Ã¶deme hizmetine eriÅim iÃ§in HHSânin mobil kanalÄ±na eriÅim sÄ±rasÄ±nda kullandÄ±ÄÄ± doÄrulama yÃ¶ntemini ile doÄrulanabilir. \n HHS'nin mobil uygulamasÄ± olmasÄ± durumunda hhsYonAdr olarak universal link kullanmasÄ± gerekmektedir. \n Tablo 5: YÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama KanallarÄ± \n \n \n \n DoÄrulama YÃ¶ntemi \n YÃS OlasÄ± Ortam \n HHS OlasÄ± Ortam \n \n \n \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼)/Mobil Cihaz \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼) / Mobil Cihaz \n \n \n Uygulama TabanlÄ± YÃ¶nlendirme \n Mobil Cihaz \n Mobil Cihaz \n 5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n AyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama, bir kullanÄ±cÄ±nÄ±n kimliÄinin, bir iÅlem baÅlatÄ±ldÄ±ktan sonra ayrÄ± bir Åekilde doÄrulandÄ±ÄÄ± yÃ¶nteme verilen addÄ±r. Bu GKD modelinde, kimlik doÄrulama iÅlem sÃ¼recinden \"ayrÄ±ÅtÄ±rÄ±lmÄ±ÅtÄ±r\". KullanÄ±cÄ±lar, baÅka bir arayÃ¼ze yÃ¶nlendirilmek yerine ( tarayÄ±cÄ± veya uygulama tabanlÄ± yÃ¶nlendirme gibi), ayrÄ± bir kanal Ã¼zerinden (telefonlarÄ±nda bir uygulama bildirimi gibi) iÅlemi doÄrulamalarÄ± iÃ§in bildirim alÄ±r.\nKullanÄ±cÄ±, iÅlemi tamamen ayrÄ± bir cihaz veya uygulama kullanarak doÄrulayabilir. \n Ä°lk fazda AyrÄ±k GKD'de QRâlÄ± modeller kullanÄ±lmayacaktÄ±r. \n AyrÄ±k GKD uygulamalarÄ±nÄ±n farklÄ± Ã¶rnekleri bulunmaktadÄ±r. Ancak yaygÄ±n olan yaklaÅÄ±m, bir web arayÃ¼zÃ¼ ve bir mobil uygulamanÄ±n komb

16inasyonunu kullanmayÄ± iÃ§erir. \n Mobil uygulamasÄ± bulunan HHS'ler iÃ§in AyrÄ±k GKD desteklenmesi zorunludur.  HHSânin web olduÄu durumda AyrÄ±k GKD akÄ±ÅÄ± uygulanmayacaktÄ±r. Mobil uygulamasÄ± bulunup mÃ¼Återi Ã¶zelinde mobil aktiflik kontrol sÃ¼reci HHS inisiyatifindedir. AyrÄ±k GKD sÃ¼recinde HHS tarafÄ±nda sadece mobil uygulama Ã¼zerinden GKD yapÄ±lmalÄ±dÄ±r. ÃHKânÄ±n web uygulamasÄ±na yÃ¶nlendirme yapmamasÄ± gerekmektedir. \n YÃS rolÃ¼nde AyrÄ±k GKD akÄ±ÅÄ±nÄ±n ÃHKâya sorularak baÅlatÄ±lmasÄ±na gerek bulunmamakla beraber bu bilginin ÃHKâya sorulmasÄ± YÃS inisiyatifindedir. YÃS olarak, AyrÄ±k GKD iÅ akÄ±ÅlarÄ± kapsamÄ±nda ÃHKâya ayrÄ±k GKD Ã¶ncesi HHS mobil uygulamasÄ±nÄ±n varlÄ±ÄÄ± sorularak (bildirim ayarlarÄ±nÄ±n aÃ§Ä±k olmasÄ± gerektiÄi bilgisi de verilebilir) ilerlenebilir. AynÄ± zamanda AyrÄ±k GKD ile rÄ±za sÃ¼recinin baÅlatÄ±lmasÄ± zorunlu deÄildir. RÄ±za sÃ¼reci baÅlatÄ±lÄ±rken yetkilendirme yÃ¶ntemi YÃS inisiyatifindedir. \n Ãrnek bir akÄ±Å Åu Åekildedir: \n \n Ä°Ålem BaÅlatma (YÃS Web/Mobil ArayÃ¼zÃ¼):  ÃHK bir iÅlemi YÃSâÃ¼n web/mobil arayÃ¼zÃ¼nde baÅlatÄ±r. YÃS uygulamasÄ±, ÃHK'nÄ±n tekil bir kullanÄ±cÄ± kimliÄini rÄ±zaya ekleyerek bir rÄ±za baÅlatma iÅlemini HHSâye iletir. HHS, tekil kullanÄ±cÄ± kimliÄini kullanarak ÃHK'nÄ±n mobil uygulamasÄ±na bir bildirim gÃ¶nderir. \n Kimlik DoÄrulama Ä°steÄi (HHS Mobil Uygulama):  ÃHK Mobil uygulama bildirimi alÄ±r ve mobil uygulama ÃHK'ya  kimlik doÄrulama isteÄi sunar. HHSânin BDDK tarafÄ±ndan belirlenmiÅ GKD yÃ¶ntemlerine uygun davranmasÄ± beklenmektedir. \n Kimlik DoÄrulama OnayÄ± (HHS Mobil Uygulama):  Mobil uygulama, ÃHKânÄ±n kimlik doÄrulama giriÅimini doÄrular. BaÅarÄ±lÄ± olursa rÄ±za onayÄ± sonrasÄ± mobil uygulama, 'AyrÄ±k Yetkilendirme BaÅarÄ±lÄ±' olay bildirimini YÃSâe gÃ¶nderir. \n Ä°Ålem OnayÄ± (YÃS Web/Mobil ArayÃ¼zÃ¼):  YÃS,  HHS'den gelen 'AyrÄ±k Yetkilendirme BaÅarÄ±lÄ±' olay bildirimine konu olan rÄ±zayÄ± kullanarak yetkilendirme koduna eriÅir. Bundan sonraki sÃ¼reÃ§ eriÅim belirteci alÄ±nmasÄ± servisi ile devam eder. \n \n AyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulamanÄ±n Olay Bildirim Servisleri ile olan BaÄÄ±mlÄ±lÄ±klarÄ± \n AyrÄ±k GKD sÃ¼recinde; HHS'nin yetkilendirme kodunu YÃS'e iletmesi iÃ§in gerekli Ã¶nkoÅul olan ÃHK doÄrulamasÄ± adÄ±mÄ±nÄ±n tamamlanmasÄ±nÄ± olay bildirimi ile YÃS'e yapmasÄ± gerekmektedir.\nBu nedenle YÃS'lerin eÄer AyrÄ±k GKD sÃ¼recini destekleyecek ise;  /olay-dinleme endpointini aÃ§arak olay bildirimi almasÄ± zorunludur. \n Ãzetle: \n YÃ¶nlendirmeli GKD \n \n HHS mobil uygulamasÄ± olmasÄ± durumunda yÃ¶nlendirme adresi olarak universalLink kullanmalÄ±. \n Bu link tanÄ±mÄ±  uygulama var ise uygulamayÄ± aÃ§ yoksa webden devam et Åeklinde olmalÄ±. \n YÃSâÃ¼n mobilden mi webden mi geldiÄi HHS aÃ§Ä±sÄ±ndan Ã¶nemli deÄildir. HHS olarak YÃS hangi adresi yonAdr deÄerinde gÃ¶ndermiÅ ise yetkilendirme sÃ¼reci bittiÄinde o adrese yÃ¶nlendirme yapÄ±lmalÄ±dÄ±r. \n \n AyrÄ±k GKD \n \n Mobil uygulamasÄ± bulunan HHS'ler iÃ§in AyrÄ±k GKD desteklenmesi zorunludur. HHSânin web olduÄu durumda AyrÄ±k GKD akÄ±ÅÄ± uygulanmayacaktÄ±r. Mobil uygulamasÄ± bulunup mÃ¼Återi Ã¶zelinde mobil aktiflik kontrol sÃ¼reci HHS inisiyatifindedir. AyrÄ±k GKD sÃ¼recinde HHS tarafÄ±nda sadece mobil uygulama Ã¼zerinden GKD yapÄ±lmalÄ±dÄ±r. ÃHKânÄ±n web uygulamasÄ±na yÃ¶nlendirme yapmamasÄ± gerekmektedir. \n ÃHKânin Mobil uygulamasÄ±nÄ±n olmadÄ±ÄÄ±nÄ± tespit edebildiÄiniz her durum iÃ§in rÄ±za oluÅturma aÅamasÄ±nda âTR.OHVPS.Business.CustomerMobileApplicationNotFoundâ hatasÄ± dÃ¶Ã¼lÃ¼r. \n HHS, ÃHKânÄ±n mobil uygulamasÄ±nÄ±n bulunmadÄ±ÄÄ± bilgisine ulaÅamazsa kendisinin belirleyeceÄi bildirim yÃ¶ntemlerinden biri ile ÃHKâye bilgilendirme yapar. Bildirim yÃ¶ntemi SMS ise ÃHKâya mobil uygulamasÄ±nÄ± aÃ§tÄ±racak Åekilde adres iletir, Web uygulamayÄ± aÃ§tÄ±racak bir link iletilmemelidir. ÃHK bu bildirimi dikkate almazsa/alamazsa veya ÃHKâda mobil uygulama yok ise bu durumda rÄ±za sÃ¼re aÅÄ±mÄ±ndan iptal olur. \n ÃHK mevcut bankacÄ±lÄ±k iÅlemlerinde bildirimi nasÄ±l gÃ¶nderiyorsanÄ±z (ÃrneÄin: AnlÄ±k bildirim gÃ¶nderildi, alÄ±nmadÄ±, SMSâe dÃ¶nÃ¼ldÃ¼ gibi.) aynÄ± Åekilde bildirim gÃ¶ndererek ÃHKânin uygulama Ã¼zerinden rÄ±zayÄ± onaylamasÄ± beklenir. Buradaki akÄ±Å HHSânin diÄer Ã¼rÃ¼nleri iÃ§in verdiÄi mÃ¼Återi deneyimi ile paralel olmalÄ±dÄ±r. \n 5.2.1\tStatik Model \n YÃS'Ã¼n ÃHK'yÄ± tanÄ±dÄ±ÄÄ± ve ÃHK'ya ait tanÄ±mlayÄ±cÄ± bilgileri HHS'ye aktarabildiÄi durumda kullanÄ±lmaktadÄ±r. Buradaki ÃHK'ya ait tanÄ±mlayÄ±cÄ± bilgiler TCKN, MNO , YKN, PNO, GSM, IBAN olarak belirlenmiÅtir. \n AkÄ±Å aÅaÄÄ±daki gibi kurgulanmÄ±ÅtÄ±r: \n   \n \n \n ÃHK, YÃS uygulamasÄ± Ã¼zerinde iÅlem baÅlatÄ±r. \n \n \n ÃHK, YÃS uygulamasÄ± iÃ§erisinde, farklÄ± bir ortam Ã¼zerinden HHS doÄrulamasÄ±nÄ± gerÃ§ekleÅtirmek istediÄini belirtir. ÃHK'yÄ± tanÄ±ma tip ve deÄerleri YÃS ÃHK'dan talep edebileceÄi gibi, YÃS sisteminde hali hazÄ±rda kayÄ±tlÄ± bilgilerle de akÄ±ÅÄ± devam ettirebilir.  \n \n \n ÃHK, YÃS'Ã¼n mÃ¼Återisi ve YÃS uygulamasÄ±na login ise tek seferlik Ã¶deme akÄ±ÅÄ± baÅlatamaz. \n \n \n YÃS tarafÄ±ndan baÅlatÄ±lan tek seferlik bir Ãdeme iÅleminin AyrÄ±k GKD ile onaylanacaÄÄ± durumda;\nYÃSâÃ¼n ilgili kullanÄ±cÄ±ya ait âÃHK TanÄ±m DeÄerâ verisinin yanÄ±nda iÅleme ait ve ilgili ÃHK ile eÅleÅtirilmiÅ olan  ve sadece YÃS ile ÃHKânÄ±n bilebileceÄi bir deÄerin daha ÃHK tarafÄ±ndan saÄlanmasÄ± ve YÃS tarafÄ±ndan kontrol edilerek eÅleÅen Ãdeme emrinin HHSâye iletilmesi gerekmektedir. ÃrneÄin; bu deÄer YÃS tarafÄ±nda yapÄ±lan tek seferlik Ã¶deme iÅlemine ait fatura numarasÄ±. \n \n \n YÃS Ã¶nyÃ¼zde ÃHK'dan aldÄ±ÄÄ± ohkTanimTip ve ohkTanimDeger deÄ

16erlerini kimlik tÃ¼r ve kimlik deÄeri alanlarÄ±na atamamalÄ±dÄ±r. \n \n \n YÃS, ayrÄ±k GKD ile iÅlem baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\"=\"01\" parametresi ile alabilir. \n \n \n YÃS, ÃHK bilgileri ile rÄ±za oluÅturur. RÄ±za nesnesi iÃ§erisinde yer alan GKD nesnesinde ilgili parametreler aÅaÄÄ±daki Åekilde doldurulur: \n \n \n ohkTanimTip ve ohkTanimDeger parametreleri \nBu metodda; ayrikGkd nesnesi iÃ§erisindeki \"ohkTanimTip\" parametresi TR.OHVPS.DataCode.ohkTanimTip sÄ±ralÄ± veri tiplerinden TCKN, MNO , YKN, PNO, GSM, IBAN deÄerlerinden birini alabilir. ohkTanimDeger parametresi de seÃ§ilen tipe ait ÃHK'ya ait deÄeri iÃ§ermelidir.RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin olduÄu durumlarda; ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r.Kimlik alanÄ± iÃ§ermeyen tek seferlik Ã¶deme emri akÄ±ÅlarÄ±nda bu kural geÃ§erli deÄildir. GSM ve IBAN deÄerleri sadece tek seferlik Ã¶demelerde kullanÄ±labilir. \n YÃS'ten ohkTanimTip olarak gelen IBAN bilgisi sadece ÃHK'yÄ± tanÄ±mak iÃ§in kullanÄ±labilir. TanÄ±m tipi IBAN ile baÅlatÄ±lan bir iÅlemde ÃHK, baÅka bir IBAN ile Ã¶deme baÅlatabilir. \n Kurumsal mÃ¼Återiler iÃ§in kmlkTur ve kmlkVrs alanlarÄ± ohkTanimTip ve ohkTanimDeger alanlarÄ±nda gÃ¶nderilmelidir. \n \n \n yetYntm parametresi \nyetYntm parametresi  AyrÄ±k GKD  akÄ±ÅÄ±nÄ± ifade eden \"A\" deÄerini almalÄ±dÄ±r.  \n \n \n \n \n Ãrnek bir istek : \nPOST/ohvps/obh/s2.0/odeme-emri-rizasi \n RizaNesnesi \n {\n...\n  \"gkd\": {\n    \"yetYntm\": \"A\",\n     \"ayrikGkd\" :{\n         \"ohkTanimTip\" : \"TCKN\" \n         \"ohkTanimDeger\": \"11232123212\"\n     }    \n  },\n...\n}\n \n \n \n YÃS, ayrÄ±k GKD ile iÅlem baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\":\"01\" parametresi ile alabilir.\nYÃS, ayrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.DecoupledAuthenticationNotSupported  hatasÄ± iletilmelidir. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n \n \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda hata mesajÄ± vermelidir. HHS tarafÄ±ndan  TR.OHVPS.Business.CustomerMobileApplicationNotFound  hatasÄ± iletilmelidir. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. HHS, ÃHKânÄ±n mobil uygulamasÄ±nÄ±n bulunmadÄ±ÄÄ± bilgisine ulaÅamazsa kendisinin belirleyeceÄi bildirim yÃ¶ntemlerinden biri ile ÃHKâye bilgilendirme yapar. Bildirim yÃ¶ntemi SMS ise ÃHKâya mobil uygulamasÄ±nÄ± aÃ§tÄ±racak Åekilde adres iletir, Web uygulamayÄ± aÃ§tÄ±racak bir link iletilmemelidir. \n \n \n HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  TR.OHVPS.Business.EventSubscriptionNotFound  hata kodu iletilmelidir. \n \n \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir.   \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  TR.OHVPS.Resource.InvalidFormat  hata kodu iletilmelidir. \n \n \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin olduÄu durumlarda; ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  TR.OHVPS.Business.CustomerInfoMismatch  hatasÄ± iletilmelidir.\nKimlik alanÄ± iÃ§ermeyen tek seferlik Ã¶deme emri akÄ±ÅlarÄ±nda bu kural geÃ§erli deÄildir. GSM ve IBAN deÄerleri sadece tek seferlik Ã¶demelerde kullanÄ±labilir. \n \n \n Tek seferlik Ã¶deme iÅlemlerinde \"ohkTanimTip\" = \"GSM\"/\"IBAN\" olarak gÃ¶nderilmiÅ ise, HHS sisteminde bu GSM/IBAN ile eÅleÅen mÃ¼Återileri taramalÄ±dÄ±r. GSM/IBAN bilgisi ÃHK bazÄ±nda tekil bir kullanÄ±cÄ±ya eriÅim imkanÄ± saÄlamaz ise  TR.OHVPS.Business.InvalidCustomerInfo  hatasÄ±nÄ± iletmelidir. \n \n \n Kontrollerin baÅarÄ±lÄ± olmasÄ± durumunda HHS rÄ±zayÄ± oluÅturur ve ÃHK tekil verisi ile ulaÅtÄ±ÄÄ± ÃHK'ya bilgilendirme mesajÄ± gÃ¶nderir.      Bilgilendirme mesajÄ± kÄ±sa mesaj ya da anlÄ±k bildirim mesajÄ± olabilir. ÃHKânÄ±n birden fazla cihazda aktivasyonu varsa HHSânin iÃ§ sÃ¼reÃ§lerine gÃ¶re mevcut durumda nasÄ±l bir bildirim sÃ¼reci iÅletiliyorsa aynÄ± Åekilde ilerlenebilir.  \n \n \n Kurumsal mÃ¼Återiler iÃ§in, hangi kullacÄ±ya bildirim gitmesi isteniyor ise, rÄ±za aÅamasÄ±nda o kiÅi ayrikGkd nesnesinde gÃ¶nderilir. HHS'nin rÄ±za iÃ§erisindeki ohkTur deÄerine gÃ¶re,  gelen bildirime verilen cevaba uygun uygulamasÄ±nÄ± aÃ§malÄ±dÄ±r. Kurumsal ÃHK iÃ§in rÄ±za geldi ise, kurumsal giriÅ sayfasÄ±; bireysel ÃHK iÃ§in rÄ±za geldi ise bireysel giriÅ sayfasÄ± mÃ¼Återinin Ã¶nÃ¼ne aÃ§Ä±lmalÄ±dÄ±r ve ilgili hesaplara eriÅime izin vermelidir. \n \n \n ÃHK'ya bir bildirim gelmemesi durumunda, HHS kendi sisteminde GKD sÃ¼recine devam edemez. 5 dakika sonunda rÄ±za durumu Yetki Bekleniyor'dan RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± (Ä°ptal kod 04) durumuna Ã§eker. \n \n \n \n \n ÃHK, HHS sisteminden gelen bildirim mesajÄ±nÄ± alÄ±r. HHS sistemine login olduktan sonra iÅleme onay verilmezse veya GKD kontrolleri baÅarÄ±sÄ±z olursa HHS Olay Bildirim servisleri aracÄ±lÄ±ÄÄ± ile GKD sÃ¼recinin sonlandÄ±ÄÄ±nÄ± YÃS'e iletir. Olay tipi \"AYRIK_GKD_BASARISIZ\" olacak Åekilde bir POST /olay-dinleme servis Ã§aÄrÄ±sÄ± yapÄ±lÄ±r.YÃS kendisine gelen olay bildirimi ile\nrÄ±za sorgulamasÄ± yaparak iptal detay kodunu Ã¶Ärenebilir. \n \n \n ÃHK, HHS sisteminde login olduktan sonra iÅleme onay verirse; HHS tarafÄ±ndan rÄ±za ile iliÅkili yetkod deÄeri Ã¼retilir.HHS, YÃS'e ÃHK iÃ§in \"yetkod\" deÄeri Ã¼retildiÄinin bilgisini Olay Bildirim servisleri aracÄ±lÄ±ÄÄ± ile iletir. Olay tipi \"AYRIK_GKD_BASARILI\" olacak Åekilde bir POST /olay-dinleme servis Ã§aÄrÄ±sÄ± yapÄ±lÄ±r. \n \n \n YÃS kendisine gelen olay bildirimi ile \"yetkod\" deÄerinin HHS'de Ã¼retildiÄinin bilgisini alÄ±r. \"yetkod\" deÄerini Ã¶Ärenebilmek iÃ§in HHS'yi sorgulamasÄ± gerekmektedir.  \nHHS'nin aÃ§acaÄÄ±   GET /yetkilendirme-kodu endpointi   ile bu bilgiye eriÅebilir. \n \n \n YÃS, \"yetkod\" ile POST /erisim-belirteci endpointinden eriÅim belirteci alÄ±r. BÃ¶ylelikle ÃHK'nÄ±n AyrÄ±k GKD sÃ¼reci tamamlanmÄ±Å olur. \n 5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi \n CSRF AtaklarÄ±ndan korunmak iÃ§in ve YÃS uygulamasÄ±nÄ±n bir Ã¶nceki durumunu restore edebilmesi iÃ§in; YÃS tarafÄ±ndan iletilen yÃ¶nlendirme ve bildirim adreslerine , Oauth2 standartlarÄ±ndaki state parametresine eÅdeÄer,   durum ko

16du (drmKod)  parametresinin eklenmesi gerekmektedir. Durum kodu parametresi YÃS tarafÄ±ndan Ã¼retilen, tekil ve kolay tahmin edilemeyen bir deÄer olmalÄ±dÄ±r. RÄ±za isteÄi gÃ¶nderimi aÅamasÄ±nda oluÅturulmalÄ±dÄ±r. YÃS uygulamasÄ±nda uygun bir yerde saklanmalÄ±dÄ±r (cookie, session, local storage gibi) . \n Durum kodu, rÄ±za isteÄindeki yÃ¶nlendirme adresine parametre olarak eklenir.  GKD sÃ¼reci sonrasÄ±nda yetki kodu ile birlikte bu bilgi, HHS tarafÄ±ndan YÃSâe iletilir. YÃS sakladÄ±ÄÄ± deÄer ile parametre olarak gelen deÄerin eÅitliÄini kontrol eder. AynÄ± ise eriÅim belirteci almak Ã¼zere akÄ±ÅÄ± ilerletir. FarklÄ± ise iÅlemi keser. \n 5.4  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri \n ÃHK, GKD iÃ§in HHS uygulamasÄ±na yÃ¶nlendirildiÄinde, HHSânin Ã§eÅitli kontroller yaparak iÅlemin doÄruluÄunu teyit etmesi gerekmektedir.\nYapÄ±lmasÄ± gereken kontrollere ait temel senaryolar aÅaÄÄ±daki tabloda belirtilmiÅtir. Bu senaryolar baz alÄ±narak HHSâler tarafÄ±ndan zenginleÅtirilebilir. \n AÅaÄÄ±daki tabloda yer alan 07-13 arasÄ± RÄ±za Ä°ptal Detay KodlarÄ±nÄ±n oluÅtuÄu senaryolar, HHS uygulamasÄ±nda yapÄ±lan kullanÄ±cÄ± doÄrulama Ã¶ncesi ve sonrasÄ± olarak iki adÄ±mda incelenmelidir. \n HHS tarafÄ±nda, kullanÄ±cÄ± doÄrulama Ã¶ncesinde yapÄ±lan kontroller neticesinde verilemeyen rÄ±zalar iÃ§in â04â : SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor iptal kodu atanÄ±r. HHS'nin YÃS uygulamasÄ±na 04 kodunu iletmesi beklenmez. YÃS zaman aÅÄ±mÄ± neticesinde rÄ±za statÃ¼sÃ¼nÃ¼ sorgulayarak Ã¶Ärenir. \nKullanÄ±cÄ± doÄrulandÄ±ktan sonra rÄ±za verilemiyorsa ilgili hata kodunun YÃS'e iletilmesi beklenmektedir. KullanÄ±cÄ± doÄrulama sonrasÄ± YÃS'e iletilen rÄ±za iptal detay kodu ile HHS veri modelinde tutulan rÄ±za ile iliÅkili rÄ±za iptal detay kodu, aynÄ± deÄeri alacak Åekilde gÃ¼ncellenmelidir. YÃS, HHS tarafÄ±ndan kendine iletilen rÄ±za iptal detay kodunu kendi veri modelinde gÃ¼ncellemelidir. \n Zorunlu olarak belirtilen hata durumlarÄ±nÄ±n HHSâler tarafÄ±ndan gerÃ§eklenmesi ve uygun hata kodlarÄ±nÄ±n YÃSâe iletilmesi; ileride oluÅabilecek mutabakatlaÅma sorunlarÄ±nÄ± ortadan kaldÄ±rabilecek, yapÄ±lacak raporlamalar kapsamÄ±nda sistem ve sÃ¼reÃ§ iyileÅtirmelerine katkÄ± saÄlayacak, son kullanÄ±cÄ± aÃ§Ä±sÄ±ndan da alÄ±nan hataya yÃ¶nelik bilgilendirici iÃ§erik saÄlayacaktÄ±r. \n Hata aÃ§Ä±klamalarÄ±; hata koduna uygun ya da uyumlu olmak kaydÄ±yla, HHS ve YÃS tarafÄ±ndan farklÄ± Åekillerde sunulabilir. \n GKD SÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller \n \n \n \n RÄ±za Ä°ptal Detay Kodu \n HHS hata aÃ§Ä±klamasÄ±* \n YÃ¶s ekranÄ±nda listelenecek Ã¶rnek mesaj metni* \n Ãrnek Senaryo \n Zorunlu / Opsiyonel \n \n \n \n \n 07 \n RÄ±za mevcut ve durumu \"Yetkilendirildi\" veya \"Yetki KullanÄ±ldÄ±\" \n Yetki HatasÄ± \n ÃHK,  kullanÄ±cÄ± doÄrulama iÅlemi tamamlandÄ±ktan sonra  YÃS ekranÄ±nda ileri - geri yaparak ya da ÃHK'nÄ±n yÃ¶nlendirme adresini kopyalayarak tarayÄ±cÄ±ya yapÄ±ÅtÄ±rmasÄ± ile tekrar HHS'ye yÃ¶nlendirir. Bu durumda HHS bu rÄ±za iptal detay kodunu iletir. HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 08 \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±. \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n YÃS tarafÄ±ndan baÅlatÄ±lan rÄ±za iÃ§erisinde yer alan kimlik bilgisi (Ã¶rn:TCKN) ile HHS'de baÅarÄ±lÄ± kimlik doÄrulama yapÄ±lan ÃHK'nÄ±n bilgilerinin uyuÅmadÄ±ÄÄ± durumda  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 09 \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) \n GÃ¶sterilebilecek hesap/kart bulunamamÄ±ÅtÄ±r. \n HHS, kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra, ÃHK'nÄ±n uygun statÃ¼lÃ¼ hesabÄ±nÄ±n olmadÄ±ÄÄ± durumda  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 10 \n ÃHK'nÄ±n AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n ÃHK'nÄ±n AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n AÃ§Ä±k bankacÄ±lÄ±ÄÄ± ayrÄ± bir kanal olarak tanÄ±mlamÄ±Å HHS'lerde,  ÃHK kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra yapÄ±lan kontrollerde, ÃHK'nÄ±n iÅlemlerini AB kanalÄ±na kapatmÄ±Å olmasÄ± durumunda   HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Opsiyonel \n \n \n 11 \n ÃHK'nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmamasÄ± \n Yetki hatasÄ± \n 1- Kurumsal firma kullanÄ±cÄ±larÄ±nÄ±n hesaplar Ã¼zerinde iÅlem yetkisinin olmamasÄ± durumunda   2- Bireysel ortak hesaplarda hesap kÄ±sÄ±tÄ± bulunuyorsa (para Ã§Ä±kÄ±ÅÄ±na izin verilmediÄi durum)  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 12 \n HHSânin,  ÃHK Ã¶zelinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ± \n Yetki hatasÄ± \n HHS'nin, kullanÄ±cÄ± doÄrulama sonrasÄ± ÃHK iÃ§in iÃ§ sistemlerinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ±. ÃrneÄin: MÃ¼Återinin henÃ¼z bankacÄ±lÄ±k hizmet sÃ¶zleÅmesi gibi Internet Åubesi Ã¼zerinde iÅlem yapmasÄ±nÄ± engelleyen eksikleri olmasÄ± durumunda veya kurumsal kullanÄ±cÄ±da vekalet sÃ¼resinin dolmasÄ±/eksik dokÃ¼man olmasÄ± durumunda kanal Ã¼zerinde iÅlem yapamadÄ±ÄÄ± durum  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Opsiyonel \n \n \n 13 \n ÃHK isteÄi ile GKDâden vazgeÃ§ilmesi \n MÃ¼Återi iÅlemden vazgeÃ§miÅtir. \n HHS ekranÄ±nda yer alan VAZGEÃ butonuna basÄ±lmasÄ± durumu (ÃHK,HHS uygulamasÄ±nda kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra VAZGEÃ butonu olabilir.) \n Zorunlu \n \n \n 14 \n GKD Ä°ptali: Fraud ÅÃ¼phesi \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n HHS Fraud ÅÃ¼phesi nedeniyle iÅlemin devamÄ±na izin vermez. HHS'nin, fraud kontrollerinin Ã¶deme baÅlatma hizmeti iÃ§in yapmasÄ± ve â14- GKD Ä°ptali: Fraud ÅÃ¼phesiâ ile rÄ±za iptalini gerÃ§ekleÅtirmelidir. HBH servislerinde HHS'nin rÄ±za iptal kodu 14 ile iÅlemi kesmesi HHS'nin kendi insiyatifindedir yani opsiyoneldir. \n KoÅullu \n \n \n 99 \n DiÄer \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n OluÅabilecek diÄer senaryolar. \n Zorunlu \n \n \n \n GKD sÄ±rasÄ±nda iletilen rÄ±za no eÄer HHSânin sisteminde bulunamazsa durumu gÃ¼ncellenecek bir rÄ±za no da olmayacaktÄ±r. HHS kendi Ã¶nyÃ¼zÃ¼nde bu duruma uygun bir mesaj gÃ¶sterebilir. YÃSâe de DiÄer hata kodu ile bu durumu iletebilir. \n"},{title:"3. Temel Prensipler",frontmatter:{},regularPath:"/v2.0.0/contents/temel-prensipler.html",relativePath:"v2.0.0/contents/temel-prensipler.md",key:"v-9f53f9d6",path:"/v2.0.0/contents/temel-prensipler.html",headers:[{level:2,title:"3.1 Genel",slug:"_3-1-genel"},{level:2,title:"3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum",slug:"_3-2-istem-cagrÄ±-ve-oturum"},{level:2,title:"3.3.\tRESTful API",slug:"_3-3-restful-api"},{level:2,title:"3.4.\tSÃ¼rÃ¼m YÃ¶netimi",slug:"_3-4-surum-yonetimi"},{level:2,title:"3.5.\tKaynak URI Yol YapÄ±sÄ±",slug:"_3-5-kaynak-uri-yol-yapÄ±sÄ±"},{level:2,title:"3.6.\tKarakter Kodlama",slug:"_3-6-karakter-kodlama"},{level:2,title:"3.7.\tVeri FormatÄ±",slug:"_3-7-veri-formatÄ±"},{level:2,title:"3.8.\tÄ°stemci Sertifika YÃ¶netimi",slug:"_3-8-istemci-sertifika-yonetimi"},{level:2,title:"3.9.\tYetkilendirme TÃ¼rleri",slug:"_3-9-yetkilendirme-turleri"},{level:2,title:"3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ±",slug:"_3-10-istek-cevap-mesajlarÄ±nda-kullanÄ±lan-nesne-yapÄ±larÄ±"},{level:2,title:"3.11. SayfalandÄ±rma ve Filtreleme",slug:"_3-11-sayfalandÄ±rma-ve-filtreleme"},{level:2,title:"3.12. Mesaj Ä°mzalama",slug:"_3-12-mesaj-imzalama"},{level:2,title:"3.13. Durum Kodu",slug:"_3-13-durum-kodu"},{level:2,title:"3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ±",slug:"_3-14-gereksinimlerinin-sÄ±nÄ±flandÄ±rÄ±lmasÄ±"},{level:2,title:"3.15. Ä°stek BaÅlÄ±ÄÄ±",slug:"_3-15-istek-baslÄ±gÄ±"},{level:2,title:"3.16. YanÄ±t BaÅlÄ±ÄÄ±",slug:"_3-16-yanÄ±t-baslÄ±gÄ±"},{level:2,title:"3.17. Idempotency KurallarÄ±",slug:"_3-17-idempotency-kurallarÄ±"},{level:2,title:"3.18. HTTP Durum KodlarÄ±",slug:"_3-18-http-durum-kodlarÄ±"},{level:2,title:"3.19. Maskeleme KurallarÄ±",slug:"_3-19-maskeleme-kurallarÄ±"},{level:2,title:"3.20. Fonksiyonel Olmayan Gereksinimler",slug:"_3-20-fonksiyonel-olmayan-gereksinimler"},{level:2,title:"3.21. Otomatik Sorgular",slug:"_3-21-otomatik-sorgular"}],content:' 3. Temel Prensipler  \n Bu bÃ¶lÃ¼mde Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (Hesap Bilgisi Hizmeti, Ãdeme Emri BaÅlatma Hizmeti) iÃ§in tanÄ±mlanan temel prensipler aÃ§Ä±klanmaktadÄ±r. \n 3.1 Genel \n \n \n HHSâler YÃ¶netmeliÄin 59. maddesinin beÅinci fÄ±krasÄ± ve Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄin (TebliÄ) 23. maddesinin birinci fÄ±krasÄ± uyarÄ±nca, Ã¶deme hizmetleri veri paylaÅÄ±m servislerini GEÃÄ°T aracÄ±lÄ±ÄÄ±yla HBHS ve ÃBHSâye sunmakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n \n \n TebliÄin 23. maddesinin ikinci fÄ±krasÄ± uyarÄ±nca Ã¶deme emri baÅlatma hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± ÃBHS ile HHSâdir. \n \n \n TebliÄin 23. maddesinin Ã¼Ã§Ã¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca hesap bilgisi hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± HBHS ile HHSâdir. \n \n \n YÃ¶netmeliÄin 60. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, Ã¶deme emri baÅlatma hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n YÃ¶netmeliÄin 61. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, hesap bilgisi hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n TebliÄin 25. maddesi uyarÄ±nca HHS ve YÃS (ÃBHS ve HBHS) arasÄ±nda baÄlantÄ± uÃ§tan uca gÃ¼venli bir Åekilde saÄlanÄ±r. Bu amaÃ§la iletim katmanÄ±nda TLS (asgari 1.2 sÃ¼rÃ¼mÃ¼) ile Åifreli iletiÅim saÄlanÄ±r. \n \n \n TebliÄin 23. maddesinin dÃ¶rdÃ¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca HHS tarafÄ±ndan sunulan Ã¶deme hizmetleri veri paylaÅÄ±m servislerini kullanan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n TCMB tarafÄ±ndan ilgili Ã¶deme hizmeti iÃ§in yetkilendirilmiÅ olduÄu kontrol edilir. \n \n \n TebliÄin 25. maddesinin beÅinci fÄ±krasÄ± uyarÄ±nca zaman damgasÄ±, 15/1/2004 tarihli 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunu kapsamÄ±nda tanÄ±mlanan zaman damgasÄ±na dayanÄ±r. \n \n \n API alan isimleri TÃ¼rkÃ§e olarak tanÄ±mlanmÄ±ÅtÄ±r. Ancak API baÅlÄ±ÄÄ± (header) alanÄ±ndaki alan isimleri Ã¶zelinde, API GeÃ§itleri tarafÄ±ndan otomatik olarak tanÄ±nabilmesi gÃ¶zetilerek, Ä°ngilizce isimlendirme tercih edilmiÅtir. \n \n \n ÃHK halihazÄ±rda Ã¶deme hesaplarÄ±na, Ã§evrim iÃ§i (mobil bankacÄ±lÄ±k, internet bankacÄ±lÄ±ÄÄ± vb.) eriÅebilir durumda ise, HHS\'nin varsa AÃ§Ä±k BankacÄ±lÄ±k kanal veya yetki tanÄ±mÄ±nÄ± varsayÄ±lan deÄeri AÃIK olacak Åekilde sunmasÄ± gerekmektedir. HHSânin, Bireysel/Kurumsal/Ticari mÃ¼Återi ayrÄ±mÄ± yapmaksÄ±zÄ±n tÃ¼m mÃ¼Återileri iÃ§in, Ã§evrim iÃ§i kanallarda hesap hareketlerine eriÅim ve Ã¶deme yapabilme yetkisi bulunmasÄ± durumunda, yine aynÄ± Åekilde AÃ§Ä±k BankacÄ±lÄ±k kanal veya yetki tanÄ±mÄ±nÄ± da varsayÄ±lan deÄeri AÃIK olacak Åekilde sunmasÄ± gerekmektedir. HHS AÃ§Ä±k BankacÄ±lÄ±k hizmetini kanal/yetki tanÄ±mÄ± ile yÃ¶netmesi durumunda hizmeti verdiÄi ilgili kanallar(web,mobil) Ã¼zerinden mÃ¼Återisine AÃ§ma/Kapama olanaÄÄ± Åeklinde sunmasÄ± gerekmektedir. \n \n \n 5411 SayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar, HHS API iÃ§erisinde Aktif durumda listelenmemiÅken, YÃS API iÃ§erisinde listelenemezler. \n 3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum \n \n \n Her istek tekil istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) iÃ§erir. Birden fazla istek iÃ§eren iÅlem YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi (istek numarasÄ±: X-Request-ID) ve rÄ±za sÃ¼recine Ã¶zgÃ¼ talep kimliÄi (iÅlem grup numarasÄ±: X-Group-ID) deÄerleri kullanÄ±lmalÄ±dÄ±r. AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± X-Group-ID bilgisi deÄeri gÃ¶nderilmelidir. \n \n \n Oturum takibi ise PSU-Session-ID ile yapÄ±lÄ±r. Oturum numarasÄ± (PSU-Session-ID) ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) ile birlikte ilgili tÃ¼m iÅlem verilerini iÃ§erecek Åekilde k

16ayÄ±t altÄ±na alÄ±nÄ±r. \n \n \n ÃrneÄin, bir Ã¶deme emri baÅlatma iÅlemi birden fazla istekten oluÅur. Her istek yukarÄ±da belirtildiÄi gibi biricik istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) iÃ§erir. Ancak iÅlemin oturum bÃ¼tÃ¼nlÃ¼ÄÃ¼ PSU-Session-ID ile saÄlanÄ±r. \n \n \n Taraflar aÃ§tÄ±klarÄ± oturumu iÅlem bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ saÄlayacak sÃ¼re iÃ§erisinde aÃ§Ä±k tutar ve iÅlem biter bitmez kapatÄ±r. \n 3.3.\tRESTful API \n APIâler, dÃ¼nya Ã¶lÃ§eÄinde yaygÄ±n bir Åekilde kullanÄ±lan Temsili Durum Transferi (Representational State Transfer, REST) mimari tarzÄ± ve JavaScript Nesne Notasyonu (JavaScript Object Notation, JSON) veri formatlarÄ±na uygun olarak geliÅtirilir. En Ã¼st seviye Veri TanÄ±mlama Dili (Data Description Language) ve en iyi uygulama Ã¶rnekleri iÃ§in  ^JSON ÅemasÄ±  temel alÄ±nÄ±r. \n Ä°stek ve yanÄ±t mesajlarÄ±nda, isteÄe baÄlÄ± veya koÅullu bir alan, deÄer iÃ§ermiyorsa, bu alan JSON payloadunda yer almamalÄ±dÄ±r. \n Ãrnek kod bloÄu. \n "rzBlg":{\n         "rizaNo":"aa9bd7e7-0ccd-4edc-9639-5a358dbf2335",\n         "olusZmn":"2022-11-28T12:00:21+03:00",\n         "gnclZmn":null,    --\x3e hatalÄ±\n         "rizaDrm":"K",\n         "rizaIptDtyKod":"" --\x3e hatalÄ± \n      },\n \n Ãrnek kod bloÄu: \n \n         "alc":{\n            "hspNo": "TR800800004162387689546019",\n            "unv": "AHMET YILMAZ", \n            "kolas":{}  --\x3e nesne gÃ¶nderimi hatalÄ±\n         },\n 3.4.\tSÃ¼rÃ¼m YÃ¶netimi \n API sonraki aÅamalarda doÄabilecek gereksinimleri ve daha karmaÅÄ±k kullanÄ±m durumlarÄ±nÄ± karÅÄ±lamak iÃ§in sÃ¼rÃ¼mler halinde geliÅtirilir ve bu durum tasarÄ±m sÄ±rasÄ±nda gÃ¶z Ã¶nÃ¼nde bulundurulur. \n API v1.0.2 sÃ¼rÃ¼mÃ¼nde ; \n \n Kapsamdaki Ã¶deme hesaplarÄ± : Vadesiz TL, yabancÄ± para hesaplarÄ± (gerÃ§ek ve tÃ¼zel kiÅilere ait Ã¶deme hesaplarÄ±), Kredili Mevduat HesabÄ± \n Tekil Ã¶deme (Virman/Havale/FAST/MÃ¼ÅterilerarasÄ± TL AktarÄ±m Sistemi)\n \n Virman ve havale iÅlemleri kapsamÄ±nda yabancÄ± para transferi yapÄ±labilir. \n \n \n Hesap bilgisi hizmetleri\n \n Temel veya ayrÄ±ntÄ±lÄ± hesap bilgisi \n Bakiye \n GerÃ§ekleÅen iÅlemler iÃ§in Hesap hareketleri \n \n \n Karekodlu Ã¶demelerdeki 01, 02 ve 03 akÄ±Å tÃ¼rleri\nyer almaktadÄ±r. \n \n API v1.1.0 sÃ¼rÃ¼mÃ¼nde ; \n \n \n API v1.0.2 sÃ¼rÃ¼mÃ¼ne ek Olay Bildirim ve AyrÄ±k GKD Ã¶zellikleri eklenmiÅtir. SÃ¼reÃ§lerin daha iyi iÅlemesi iÃ§in Ã§eÅitli gÃ¼ncellemeler yapÄ±lmÄ±ÅtÄ±r. \n \n \n API v2.0 sÃ¼rÃ¼mÃ¼nde ileri tarihli Ã¶deme emri, dÃ¼zenli Ã¶deme emri, hesap bilgisi hizmeti iÃ§erisinde kart hizmetleri, YÃS Ã¼zerinden rÄ±za gÃ¼ncelleme hizmetine dair gÃ¼ncellemeler eklenmiÅtir. \n \n \n Her sÃ¼rÃ¼m deÄiÅikliÄinde bir Ã¶nceki sÃ¼rÃ¼m belirli bir sÃ¼re desteklenecektir. DiÄer bir ifadeyle, sadece belirli bir sÃ¼re iÃ§in mevcut ve bir Ã¶nceki sÃ¼rÃ¼m aynÄ± anda eriÅilebilir olacaktÄ±r. \n 3.5.\tKaynak URI Yol YapÄ±sÄ± \n YÃSâlerin baÅlattÄ±ÄÄ± Ã§aÄrÄ±larda URI yolu aÅaÄÄ±daki yapÄ±yÄ± takip eder: \n [hhs-yol-Ã¶n-eki]/ohvps/ [kaynak-grubu]/ [sÃ¼rÃ¼m]/ [kaynak]/[kaynak-no]/[alt-kaynak] \n Bu, aÅaÄÄ±daki unsurlardan oluÅur: \n \n [hhs-yol-Ã¶n-eki] \nÄ°steÄe baÄlÄ±, HHS\'ye Ã¶zgÃ¼ yol Ã¶n ekini ifade eder. \nGEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda BKM tarafÄ±ndan belirlenen sistem adÄ± ve yol Ã¶n eki kullanÄ±lÄ±r. \n ohvps \nSabit metin âohvpsâ (Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri kÄ±saltmasÄ±) \n [kaynak-grubu] \nKaynak grubu, APIâye eriÅmek iÃ§in kullanÄ±lan Ã¶deme hizmetine (HBH, ÃBH) gÃ¶re eriÅim adresi (end point) grubunu tanÄ±mlar (âhbhâ veya âobhâ). \n [sÃ¼rÃ¼m] \nAPI sÃ¼rÃ¼mÃ¼nÃ¼ ifade eder (â/s[ana-sÃ¼rÃ¼m].[alt-sÃ¼rÃ¼m]/â). \n [kaynak]/[kaynak-no] \nKaynak detaylarÄ±nÄ± ifade eder. \n [alt-kaynak] \nAlt kaynak detaylarÄ±nÄ± ifade eder. \n \n HHS, tÃ¼m kaynaklarÄ± iÃ§in aynÄ± katÄ±lÄ±mcÄ± yolu Ã¶n ekini ve sistem adÄ±nÄ± kullanmalÄ±dÄ±r. \n BKM APIâlerine eriÅmek isteyen uygulamalarÄ±n yetkilerine gÃ¶re aÅaÄÄ±daki APIâlere abone olmalarÄ± gerekmektedir: \n OBH: \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s2.0/odeme-emri-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s2.0/odeme-emri \nHBH: \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesap-bilgisi-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar/1234/islemler \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar/1234/bakiye \nGKD \n https://gecit-api.bkmtest.com.tr/ohvps/gkd/s2.0/erisim-belirteci \nHHS â YÃS API \n https://gecit-api.bkmtest.com.tr/hhs-api/s2.0/hhs \n https://gecit-api.bkmtest.com.tr/hhs-api/s2.0/hhs/1234 \n https://gecit-api.bkmtest.com.tr/yos-api/s2.0/yos \n https://gecit-api.bkmtest.com.tr/yos-api/s2.0/yos/1234 \n HHSâlerin saÄlayacaklarÄ± APIâlerdeki URI Ã§evrimi Ã¶rnekleri aÅaÄÄ±daki gibidir. \n \n https://xbank.com.tr/api-portal/ohvps/obh/s2.0/odeme-emri \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s2.0/odeme-emri  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s2.0/hesap-bilgisi-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesap-bilgisi-rizasi  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s2.0/hesaplar \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar   (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s2.0/hesaplar/1234 \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar/1234  (BKM API) \n \n GEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda, istek baÅlÄ±ÄÄ±nda bulunan âx-aspsp-codeâ (isteÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodu) deÄerine gÃ¶re HHS APIâde standart olarak tanÄ±mlanmÄ±Å olan âbasePathâ bilgisine servis uzantÄ±sÄ± eklenerek HHSâye yÃ¶nlendirme yapÄ±lÄ±r. \n ÃrneÄin, istek baÅlÄ±ÄÄ±nda  xbank âÄ±n kodu varsa, YÃS tarafÄ±ndan yapÄ±lan \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesap-bilgisi-rizasi \nÃ§aÄrÄ±sÄ± GEÃÄ°T tarafÄ±ndan karÅÄ±lanarak \n https://xbank.com.tr/api-portal/ohvps/hbh/s2.0/hesap-bilgisi-rizasi \nadresine yÃ¶nlendirilir. \n Bu Ã¶rnekte,  https://xbank.com.tr/api-portal  basePath bilgisi HHS tarafÄ±ndan HHS APIâye girilen deÄerdir. \n ÃNEMLÄ° :  URI Query parametreleri GET ile iletilirken deÄerlerde url-encode yapÄ±lmalÄ±dÄ±r. Ãrnek bir API isteÄi; \nGET /ohvps/hbh/s2.0/hesaplar/xxx/islemler?hesapIslemBslTrh=2023-02-07T16:42:38%2B03:00&hesapIslemBtsTrh=2023-02-07T17:09:18%2B03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfKytSayi=10&syfNo=1 \n Burada \'+\' karakterinin boÅluk olarak algÄ±lanmamasÄ± iÃ§in %2B deÄeri ile iletilmiÅtir. \n 3.6.\tKarakter Kodlama \n API istekleri ve yanÄ±tlarÄ±nÄ±n  BaÅlÄ±k  parametrelerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r.  3.15. Ä°stek BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n API istekleri ve yanÄ±tlarÄ±nda  GÃ¶vde  parametrelerinde UTF-8 karakter kodlamasÄ± kullanÄ±lÄ±r. Bu, JSON iÃ§in varsayÄ±lan karakter kodlamasÄ±dÄ±r. \n Ancak, bir HHS\'nin kendi uygulamalarÄ± ve Ã¶deme baÅlattÄ±ÄÄ± Ã¶deme sistemi (Havale vb.) bazÄ± UTF-8 karakterlerini kabul etmeyebilir. HHS, UTF-8 kodlamasÄ± iÃ§eren bir mesajÄ± iÅleyemez ve reddederse, HTTP 400 (HatalÄ± Ä°stek) durum ko

16du ile yanÄ±t vermelidir. \n ÃHVPS kapsamÄ±nda iletilen deÄerler iÃ§erisinde iÅlenemeyecek karakterler var ise  "TR.OHVPS.Business.InvalidCharacter"  hatasÄ± verilir. \n GÃ¶vde parametrelerinde desteklenen UTF-8 karakter kÃ¼mesi aÅaÄÄ±da listelenmiÅtir. \n \n \n \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n \n \n \n \n \n 20 \n = \n 3d \n X \n 58 \n r \n 72 \n \n \n ! \n 21 \n ? \n 3f \n Y \n 59 \n s \n 73 \n\n 23 \n @ \n 40 \n Z \n 5a \n t \n 74 \n \n \n % \n 25 \n A \n 41 \n [ \n 5b \n u \n 75 \n \n \n & \n 26 \n B \n 42 \n \\ \n 5c \n v \n 76 \n \n \n \' \n 27 \n C \n 43 \n ] \n 5d \n w \n 77 \n \n \n ( \n 28 \n D \n 44 \n ^ \n 5e \n x \n 78 \n \n \n ) \n 29 \n E \n 45 \n _ \n 5f \n y \n 79 \n \n \n * \n 2a \n F \n 46 \n a \n 61 \n z \n 7a \n \n \n + \n 2b \n G \n 47 \n b \n 62 \n { \n 7b \n \n \n , \n 2c \n H \n 48 \n c \n 63 \n } \n 7d \n \n \n - \n 2d \n I \n 49 \n d \n 64 \n Ã \n c3 87 \n \n \n . \n 2e \n J \n 4a \n e \n 65 \n Ã \n c3 96 \n \n \n / \n 2f \n K \n 4b \n f \n 66 \n Ã \n c3 9c \n \n \n 0 \n 30 \n L \n 4c \n g \n 67 \n Ã§ \n c3 a7 \n \n \n 1 \n 31 \n M \n 4d \n h \n 68 \n Ã¶ \n c3 b6 \n \n \n 2 \n 32 \n N \n 4e \n i \n 69 \n Ã¼ \n c3 bc \n \n \n 3 \n 33 \n O \n 4f \n j \n 6a \n Ä \n c4 9e \n \n \n 4 \n 34 \n P \n 50 \n k \n 6b \n Ä \n c4 9f \n \n \n 5 \n 35 \n Q \n 51 \n l \n 6c \n Ä° \n c4 b0 \n \n \n 6 \n 36 \n R \n 52 \n m \n 6d \n Ä± \n c4 b1 \n \n \n 7 \n 37 \n S \n 53 \n n \n 6e \n Å \n c5 9e \n \n \n 8 \n 38 \n T \n 54 \n o \n 6f \n Å \n c5 9f \n \n \n 9 \n 39 \n U \n 55 \n p \n 70 \n \n \n \n \n : \n 3a \n V \n 56 \n q \n 71 \n \n \n \n \n ; \n 3b \n W \n 57 \n \n \n \n \n \n \n \n Ancak  EriÅim belirteci, Yenileme belirteci ve Authorization  parametreleri daha dar bir karakter kÃ¼mesi ile doldurulmalÄ±dÄ±r. \n Bearer HTTP Authorization ÅemasÄ± RFC 6750\'de tanÄ±mlanmÄ±ÅtÄ±r.  https://www.rfc-editor.org/rfc/rfc6750#section-2.1  bÃ¶lÃ¼mÃ¼nde izin verilen karakterlerin gÃ¶nderilmesi beklenmektedir. Buradaki standartÄ±n her 3 parametre iÃ§in de uygulanmasÄ±na karar verilmiÅtir. \n RFC 6750 iÃ§erisinde bearer token formatÄ± Åu Åekildedir : 1*( ALPHA / DIGIT / "-" / "." / "_" / "~" / "+" / "/" ) *"=" \nAugmented BNF for Syntax Specifications (ABNF) ile ifade edilen bu formatta token en az 1 adet alfanumerik karakter veya Ã¶zel karakter ("-", "." , "_" , "~" , "+" , "/")  iÃ§ermeli ve 0 ya da daha Ã§ok sayÄ±da "=" karakteri ile bitmelidir. \n ALPHA = A-Z / a-z aralÄ±ÄÄ±ndaki harflerdir. \nDIGIT = 0-9 aralÄ±ÄÄ±ndaki rakamlardÄ±r. \n 3.7.\tVeri FormatÄ± \n \n AÃ§Ä±k bankacÄ±lÄ±k kapsamÄ±ndaki zaman damgasÄ±, ISO 8601 standartÄ±na uygun olarak yerel saat bilgisini ve timezone bilgisini de iÃ§erecek Åekilde " yyyy-MM-ddâTâHH:mm:ssXXX " formattaki haliyle hazÄ±rlanmalÄ±dÄ±r. \n \n Ãrnek:  "timestamp": "2021-05-30T20:34:15+03:00" \nyyyy : 4 hane yÄ±l \nMM : BaÅa â0â eklenmiÅ, toplam 2 hane ay \ndd    : BaÅa â0â eklenmiÅ, toplam 2 hane gÃ¼n \nHH    : BaÅa â0â eklenmiÅ, toplam 2 hane saat (0-23 arasÄ± deÄer alabilir.) \nmm : BaÅa â0â eklenmiÅ, toplam 2 hane dakika \nss    : BaÅa â0â eklenmiÅ, toplam 2 hane saniye \nXXX : ISO 8601 Time zone \n \n \n Zaman damgasÄ± hesaplamalarÄ±nda, yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saatinin 00:00:00 olduÄu kabul edilmiÅtir. \n \n \n JWT veri paketlerinde kullanÄ±lan zaman damgalarÄ±, 1 Ocak 1970 Saat 00:00:00 (UTC) anÄ±ndan itibaren geÃ§en saniye sayÄ±sÄ± deÄerini (Unix Time) kullanmalÄ±dÄ±r. \n \n \n Bir HHS, tarihi yanlÄ±Å biÃ§imlendirilmiÅ bir istek aldÄ±ÄÄ±nda, 400 (HatalÄ± Ä°stek) durum kodu ve ilgili hata kodu ile yanÄ±t vermelidir. \n \n \n ISO 4217 StandartÄ±nda para birimleri ve kaÃ§ basamak ondalÄ±k deÄer iÃ§erebilecekleri belirlenmiÅtir. \n https://www.iso.org/iso-4217-currency-codes.html   adresinden Ã¼cretsiz olarak listeye eriÅilebilir.  \nAPI StandartlarÄ±nda da para birimleri  ISO 4217âde tanÄ±mlanmÄ±Å olan 3 harfli kodlarla iletilir.   TÃ¼m tutar alanlarÄ± ISO 4217\'de tanÄ±mlanmÄ±Å para birimlerinin ondalÄ±k basamak deÄerleri de gÃ¶z Ã¶nÃ¼nde bulundurularak iletilmelidir. Tutar alanlarÄ± artÄ± ya da eksi deÄer alabileceÄi iÃ§in API deseninde tanÄ±mlanmÄ±Å regular expressionlar dikkate alÄ±nmalÄ±dÄ±r. \nÃrneÄin; Bakiye API\'sindeki "Kredili Mevduat HesabÄ± Bakiyesi" alanÄ± "-100.25" ve "Para Birimi" alanÄ± "TRY" olarak

16iletildiÄinde 25 deÄerinin kuruÅ olduÄu anlaÅÄ±lmalÄ±dÄ±r. \nÃdeme Emri RÄ±zasÄ± API\'sinde yer alan "Ä°Ålem TutarÄ±" alanÄ± "104.75" TRY olarak iletildiÄinde "75" deÄerinin kuruÅ olduÄu anlaÅÄ±lmalÄ±dÄ±r. \n"12000" Japon Yeni iÃ§in, ISO 4217âde JPY para biriminin ondalÄ±k kÄ±smÄ± olmadÄ±ÄÄ±ndan "Ä°Ålem TutarÄ±" alanÄ±nda "12000" ve "Para Birimi" alanÄ±nda "JPY" deÄeri  iletilmelidir. \n \n \n AltÄ±n para birimi Ã¶zelinde ISO 4217âye uygun olarak "XAU" cinsinde ve 2 basamak ondalÄ±k rakam iÃ§erecek Åekilde iletilmelidir. ÃrneÄin iÃ§erisinde "13,50 gr" altÄ±n olan hesap iÃ§in bakiye "13.50", para birimi "XAU" olarak gÃ¶nderilmelidir. \n \n \n DiÄer madenlerde ondalÄ±k basamak ISO 4217 standartÄ±nda tanÄ±mlandÄ±ÄÄ± gibi olmalÄ±dÄ±r. \n \n \n SÄ±ralÄ± veri tipleri bÃ¼yÃ¼k kÃ¼Ã§Ã¼k harfe duyarlÄ± olmalÄ±dÄ±r. \n 3.8.\tÄ°stemci Sertifika YÃ¶netimi \n ÃHVPS kapsamÄ±nda YÃS ve HHSâlerin gÃ¼venli bir Åekilde tanÄ±mlanmasÄ± amacÄ±yla elektronik sertifikalar kullanÄ±lÄ±r. \n ÃHVPS kapsamÄ±nda taraflarÄ±n gÃ¼venli bir Åekilde tanÄ±mlamasÄ±, uÃ§tan uca gÃ¼venli iletiÅim, mesaj Åifreleme ve mesaj imzalama iÅlevleri 15/1/2004 tarihli ve 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunuânda aÃ§Ä±klanan elektronik sertifikalar kullanÄ±larak saÄlanÄ±r. Elektronik sertifikada TÃ¼rkiye Cumhuriyet Merkez BankasÄ± tarafÄ±ndan verilen kuruluÅ kodu ve kuruluÅun tÃ¼rÃ¼ne dair bilgiler bulunur. \n GEÃÄ°T Ã¼zerinden yapÄ±lan eriÅimlerde YÃS ve HHSâlere Ã¶nceden daÄÄ±tÄ±lmÄ±Å olan istemci sertifikalarÄ± kullanÄ±larak taraflarÄ±n (sunucu) kimliklerinin doÄrulanmasÄ± saÄlanacaktÄ±r. Ä°stemci sertifikalarÄ± hem test hem de Ã¼retim ortamÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi sertifikasyon sÃ¼recinde de sÄ±nanacaktÄ±r. SÃ¶z konusu sertifikalarÄ±n daÄÄ±tÄ±m prosedÃ¼rleri ve kullanÄ±mlara yÃ¶nelik aÃ§Ä±klamalar EK-3âte yer verilmiÅtir. \n 3.9.\tYetkilendirme TÃ¼rleri \n GEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda iki temel yetkilendirme tÃ¼rÃ¼ kullanÄ±lÄ±r: \n 1.\tÄ°stemci Kimlik Bilgileri:  MÃ¼Återi onayÄ±nÄ±n gerekmediÄi, sadece YÃSâÃ¼n tanÄ±mlanÄ±p doÄrulandÄ±ÄÄ± API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. YÃSâÃ¼n yetkilendirilmiÅ olduÄu ve faaliyet izninin yaptÄ±ÄÄ± hizmet Ã§aÄrÄ±sÄ±na uygun olduÄu kontrol edilir.  Bu amaÃ§la, YÃSâlere clientId ve clientSecret tahsis edilecektir. YÃSâler ilgili clientId ve clientSecret ile sadece yetkilendirilmiÅ olduklarÄ± servislere eriÅebileceklerdir. YÃSâler kendilerine BKM tarafÄ±ndan sunulacak APIâyi, kendi clientID ve clientSecret deÄerleri ile sorgulayarak âÄ°stemci Kimlik Bilgileriâ belirtecini (access token) elde edeceklerdir.\nHHSâler de GEÃÄ°T Ã¼zerindeki YÃS APIâsini sorgulama maksadÄ± ile GEÃÄ°T\'e geldiklerinde, kendilerine atanmÄ±Å olan clientID ve clientSecret bilgileri ile yetki kontrolleri yapÄ±lÄ±r.\nHHS ve YÃSâler ; ilettikleri client id ve secret deÄerleri kullanÄ±larak oluÅturulacak bearer authentication metodu ile servislerini sunacaklardÄ±r. \n 2.\tYetkilendirme Kodu:  YÃSâÃ¼n doÄrulanmasÄ±nÄ±n yanÄ±sÄ±ra mÃ¼Återinin GKD ile doÄrulanmasÄ± gereken API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. MÃ¼Återi doÄrulanarak yetkilendirme kodu oluÅturulmasÄ± HHSânin yetkilendirme arayÃ¼zÃ¼ne yÃ¶nlendirilir. GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda yetkilendirme kodu YÃSâe dÃ¶nÃ¼lÃ¼r. YÃS daha sonra HHSânin  eriÅim belirteci  (access token) eriÅim adresini (EK-3: POST /erisim-belirteci) Ã§aÄÄ±rmak suretiyle yetkilendirme kodunu bir eriÅim belirteci (access token) ile deÄiÅtirerek ilgili kaynaklarÄ± kullanabilir. \n Ãdeme emri baÅlatma ve hesap bilgisi hizmetlerinde hangi yetkilendirme tÃ¼rlerinin kullanÄ±lacaÄÄ± bilgisi, ilgili baÅlÄ±klardaki eriÅim adresleri (endpoints) tablolarÄ±nda yer almaktadÄ±r. \n erisim-belirteci  erisim noktasÄ±ndan elde edilen  erisimBelirteci  iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda  x-access-token  alanÄ±nda iletilir.\nBelirli bir sÃ¼re iÃ§in tanÄ±mlanan eriÅim belirteci (access token) deÄerinin yenileme belirteci (refresh token) ile yenilenmesi gerekir. \n EriÅim adreslerinde kullanÄ±lan yetkilendirme tÃ¼rÃ¼ ilgili eriÅim adresi tablolarÄ±nda belirtilmiÅtir. \n 3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ± \n Ä°stek ve Cevap mesajlarÄ±nda kullanÄ±lacak olan nesneler tÃ¼m elemanlarÄ±nÄ± kapsayacak Åekilde Ek-1 de listelenmiÅtir. TÃ¼m listelenen elemanlar aÃ§Ä±sÄ±ndan (UÃ§ nokta mesaj yapÄ±larÄ±nÄ±n belirtildiÄi tablolarda belirtildiÄi Ã¼zere) alanÄ±n Zorunlu (z) veya Ä°steÄe BaÄlÄ± (Ä°) olma durumlarÄ±na gÃ¶re bazÄ± alanlar gÃ¶nderilebilir veya gÃ¶nderilmeyebilir. \n 3.11. SayfalandÄ±rma ve Filtreleme \n SayfalandÄ±rma \n ÃaÄrÄ±ya dÃ¶nÃ¼len kaynak nesnesi iÃ§erisindeki kayÄ±tlar bir sayfalandÄ±rma yapÄ±sÄ± ile Ã§

16aÄrÄ±lacak Åekilde istek oluÅturulur. \n OluÅturulacak isteÄin iÃ§erisinde parametreler ile filtreleme, sayfa baÅÄ±na gÃ¶sterilecek kayÄ±t sayÄ±sÄ± ve hangi sayfanÄ±n Ã¶nyÃ¼zde gÃ¶sterileceÄi bilgileri eriÅim noktasÄ±na iletilir ve ilgili kayÄ±tlar cevap olarak alÄ±nÄ±r. \n Filtreleme \n HHS, birden Ã§ok kayÄ±t dÃ¶nÃ¼lmesi gereken GET Ã§aÄrÄ±larÄ±nda sÄ±nÄ±rlÄ± filtreleme desteÄi saÄlamalÄ±dÄ±r. Filtre parametreleri her zaman kaynak nesnesinin belirli alanlarÄ±na Ã¶zgÃ¼dÃ¼r ve nesne iÃ§in tanÄ±mlanan kurallara uymalÄ±dÄ±r. \n 3.12. Mesaj Ä°mzalama \n Elektronik imzalar, ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini destekler. Ä°mzalarÄ±n kaynak bazÄ±nda hangi istek ve yanÄ±tlara uygulandÄ±ÄÄ± belirlidir. \n API yalnÄ±zca TLS\'ye dayanÄ±rsa, dijital kayÄ±tlarÄ± ve inkÃ¢r edilemezlik kanÄ±tlarÄ±nÄ± tutmak zor olur. Bu nedenle, TLS\'ye dayanmayan bir inkÃ¢r edilemezlik Ã§Ã¶zÃ¼mÃ¼ olarak API isteÄinin HTTP baÅlÄ±ÄÄ±nda bir JWS kullanÄ±larak saÄlanabilir. \n HTTP isteÄinin gÃ¶vdesinin hash fonksiyonu (SHA256) ile Ã¶zeti alÄ±nacaktÄ±r. Elde edilen Ã¶zet, asimetrik anahtarlarÄ± destekleyen bir algoritma kullanÄ±larak imzalanacak ve JWS elde edilecektir. Ä°steÄin kendinize geldiÄi durumda body Ã¼zerinde hiÃ§ bir deÄiÅikliÄe tabi tutmadan (serialize/deserialize, minify, trim, vb yapmadan) doÄrulama yapmanÄ±z gerekmektedir. AynÄ± Åekilde isteÄin kendinizden Ã§Ä±ktÄ±ÄÄ± aÅamada da response body Ã¼zerinde hiÃ§ bir deÄiÅikliÄe tabi tutmadan (serialize/deserialize, minify, trim, vb yapmadan) mesaj imzalama yapÄ±lmalÄ±dÄ±r. \n Bir istek, YÃS\'nin Ã¶zel anahtarÄ± ile imzalanacak ve bu isteÄe karÅÄ±lÄ±k gelen yanÄ±t, HHS\'nin Ã¶zel anahtarÄ± tarafÄ±ndan imzalanacaktÄ±r. \n TÃ¼m API istekleri ve yanÄ±tlarÄ± imzalanmaz. Mesaj imzalamanÄ±n zorunlu olup olmadÄ±ÄÄ±, desteklenip desteklenmediÄi her API Ã¶zelinde belirlenir. \n Anahtar Deposu \n HHS\'ler ve YÃS\'ler tarafÄ±ndan gÃ¼venilen bir GÃ¼ven Otoritesi (Trust Anchor), taraflar iÃ§in bir genel anahtar deposu saÄlamaktan sorumludur. \n GÃ¼ven Otoritesi, taraflardan herhangi birisinin oluÅturduÄu bir anahtar Ã§iftinin aÃ§Ä±k bÃ¶lÃ¼mÃ¼nÃ¼ saklayan merkezi bir dizin (BKM tarafÄ±ndan tutulan merkezi kayÄ±t sistemi vb.) olacaktÄ±r. \n MesajlarÄ± doÄrulamak iÃ§in taraflarÄ±n genel anahtarlarÄ±nÄ±n paylaÅÄ±lmasÄ± iÃ§in BKM bir servis saÄlayacaktÄ±r. HHS API olarak adlandÄ±rÄ±lÄ±mÄ±Å olan bu servis ile HHS ve YÃS listelerine ulaÅÄ±labildiÄi gibi doÄrulama iÅlemi iÃ§in ihtiyaÃ§ duyulacak olan genel anahtarlara da bu servis Ã¼zerinden eriÅilebilinecektir. \n Ä°lgili Mesaj Åifreleme iÃ§in genel akÄ±Å, Ek-5 bÃ¶lÃ¼mÃ¼nde detaylarÄ±yla paylaÅÄ±lmaktadÄ±r. \n 3.13. Durum Kodu \n APIâler, iki farklÄ± amaca hizmet eden iki durum kodu kullanÄ±r: \n \n HTTP Durum Kodu, API Ã§aÄrÄ±sÄ±nÄ±n (kaynaktaki HTTP iÅlemi) sonucunu yansÄ±tÄ±r. \n BazÄ± kaynak payloadâlarÄ±ndaki Durum alanÄ±, kaynaklarÄ±n durumunu yansÄ±tÄ±r. \n 3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ± \n EriÅim adreslerinin ve alanlarÄ±n kullanÄ±mÄ± Zorunlu(Z), Ä°steÄe BaÄlÄ±(Ä°) veya KoÅullu(K) olabilir. KullanÄ±mlara iliÅkin durumlar ve kullanÄ±mÄ±n (K) koÅullu olduÄu duruma iliÅkin aÃ§Ä±klamalar ilgili tablolarda belirtilmiÅtir. \n ÃHVPS API\'lerinin (HBH,ÃBH,GKD) istek ve yanÄ±tta kullanÄ±lacak baÅlÄ±k isimleri, ilgili RFC dokÃ¼manlarÄ±nda ve aÅaÄÄ±daki tabloda yer aldÄ±ÄÄ± Åekilde kullanÄ±lacaktÄ±r.  Uygulamaya Ã¶zelleÅmiÅ baÅlÄ±klar "X-" ile baÅlayacaktÄ±r. BaÅlÄ±k isimlerinde yer alacak kÄ±saltmalar (Ã¶rn. PSU, ASPSP gibi) tamamÄ± bÃ¼yÃ¼k harfle yazÄ±lacak Åekilde tanÄ±mlanacaktÄ±r. BaÅlÄ±k isimleri bÃ¼yÃ¼k â kÃ¼Ã§Ã¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin x-request-id ya da X-Request-ID olarak gÃ¶nderilmiÅ olan bir istek baÅlÄ±ÄÄ± deÄiÅkeni, sunucu tarafÄ±nda hata vermeyecek Åekilde iÅlenebilmelidir. \n 3.15. Ä°stek BaÅlÄ±ÄÄ± \n \n "BaÅlÄ±k isimleri" yorumlanÄ±rken kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin "x-ReQuEsT-Id" geÃ§erli bir baÅlÄ±k ismidir. \n "BaÅlÄ±k deÄerleri" yorumlanÄ±rken ise kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harf duy

16arlÄ±lÄ±ÄÄ± olmalÄ±dÄ±r. ÃrneÄin "xyz123" ile "XYZ123" deÄerleri farklÄ±dÄ±r. \n BaÅlÄ±k deÄerlerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r. ÃrneÄin "PSU-Device-Data" deÄerinde "Ä°OS12" yazmak, bÃ¼yÃ¼k "Ä°" harfinin ISO-8859-1 iÃ§erisinde yer almamasÄ±ndan dolayÄ±, hataya yol aÃ§acaktÄ±r. \n Ä°stek baÅlÄ±ÄÄ±nda aÅaÄÄ±daki tabloda belirtilen alanlar dÄ±ÅÄ±nda gÃ¶nderim yapÄ±lmamalÄ±dÄ±r. \n Ä°stek baÅlÄ±ÄÄ±nda boÅ deÄer iÃ§eren bir baÅlÄ±k ismiyle gÃ¶nderim yapÄ±lmamalÄ±dÄ±r. Ãrnek; "PSU-Initiated":"" \n Ä°stek ve YanÄ±t baÅlÄ±ÄÄ±nda yer alan alanlarÄ±n; POST GET DELETE methodlarÄ±nda, OBH,HBH,GKD,OAS,ODS API\'leri bazÄ±nda Zorunlu/KoÅullu/Ä°steÄe BaÄlÄ± kullanÄ±m durumlarÄ± aÅaÄÄ±daki tabloda listelenmiÅtir. \n \n Tablo 2: Ä°stek BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n POST \n GET \n DELETE \n POST \n GET \n DELETE \n \n \n \n \n \n \n \n OBH HBH GKD \n OBH HBH GKD \n OBH HBH GKD \n OAS ODS \n OAS ODS \n OAS ODS \n \n \n X-Request-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±.   Ãrnek: Ãdeme emri baÅlatma iÅ akÄ±ÅÄ±nÄ±n her adÄ±mda farklÄ± âx-request-idâ deÄeri kullanÄ±lÄ±r.   ÃaÄrÄ±larÄ±n aynÄ± yanÄ±tÄ± dÃ¶nmesinin beklendiÄi durumlarda (idempotent iÅlemlerde) aynÄ± deÄer ile Ã§aÄrÄ± yapÄ±lÄ±r. \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±.  AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± x-group-id bilgisi deÄeri gÃ¶nderilmelidir. Ãrnek: Ãdeme emri baÅlatma/hesap bilgisi iÅ akÄ±ÅÄ±nÄ±n her adÄ±mÄ±nda aynÄ± âx-group-idâ deÄeri kullanÄ±lÄ±r. \n Z \n Z \n Z \n - \n - \n - \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder. Bu deÄerin application/json olarak gÃ¶nderilmesi gerekmektedir. Hata durumlarÄ±nda application/problem+json da iletilebilir.  (BaÅka bir deÄere ayarlanÄ±rsa, HHS, 415 Desteklenmeyen Ortam TÃ¼rÃ¼ (Unsupported Media Type) ile yanÄ±t vermelidir) \n Z \n - \n - \n Z \n - \n - \n \n \n X-ASPSP-Code \n AN4 \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n (HHS) kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-TPP-Code \n AN4 \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n PSU-Auth-Date \n ISODateTime \n ÃHKânÄ±n YÃS Ã¼zerinde en son oturum aÃ§tÄ±ÄÄ± saat. [RFC7231] ÃrneÄin:  auth-date: Tue, 11 Sep 2012 19:43:31 GMT \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-IP-Address \n AN7..15 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n IP adresi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-IP-Port \n AN1..5 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n Port adresi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-GEO-Location \n AN1..36 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n konum bilgisi. RFC2426 standartÄ±na uygun olarak paylaÅÄ±lmalÄ±dÄ±r. ÃrneÄin  GEO:"<enlem >, <boylam>GEO:52.506931,13.144558 \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-User-Agent \n AN 1.. 255 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n saÄladÄ±ÄÄ± user-agent bilgisi. (TarayÄ±cÄ±, versiyon, iÅletim sistemi bilgileri) \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Timestamp \n ISODateTime \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n tarih saat iÃ§eren zaman bilgisi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Device-ID \n AN5..40 \n ÃHK iÅlemi mobil uygulama aracÄ±lÄ±ÄÄ±yla baÅlattÄ±ysa, kullanÄ±lan mobil uygulama ilk yÃ¼klendiÄinde oluÅturulan tekil cihaz veya uygulama belirteci. ÃHK cihazÄ±nÄ±n UUID deÄeri kullanÄ±labilir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Device-Data \n AN1..1024 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± mobil cihaza ait veriler.  Ãrnek alanlar:   - Platform - (Android, iOS, Windows 10 Mobile)  - Device Model   - OS Name   - OS Version - Locale - Time zone \n Ä° \n Ä° \n Ä° \n - \n

16- \n - \n \n \n PSU-Initiated \n AN1 \n Ä°Ålemin ÃHK tarafÄ±ndan baÅlatÄ±lmasÄ± durumunda E , sistem tarafÄ±ndan baÅlatÄ±ldÄ±ÄÄ± durumda H deÄerini, olay bildirimine istinaden yapÄ±lacak isteklerde O deÄerini almasÄ± beklenir. Ä°Ålemler servisinde yapÄ±lacak sistemsel sorgulardaki iÅlem limitlerini kontrol amacÄ±yla kullanÄ±lÄ±r. O deÄerinin gÃ¶nderilebileceÄi API\'ler  AsÄ±l Verinin Elde EdileceÄi API  olarak ilgili sayfada yer alan Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi tablosunda yer almaktadÄ±r. AsÄ±l verinin elde edileceÄi API\'ler Ã¶zelinde O gÃ¶nderimi yapÄ±labilir. O olarak yapÄ±lan her isteÄe HHS\'nin yanÄ±t vermesi gereklidir. Otomatik sorgularda uygulanan Ã¼st limitler, O gÃ¶nderimi durumunda geÃ§erli deÄildir. \n Z \n Z \n Z \n - \n - \n - \n \n \n PSU-Fraud-Check \n AN1..4096 \n YÃS\'lerin Ã§eÅitli gÃ¼venlik kontrollerini gerÃ§ekleÅtirerek, Ã¶nemli gÃ¶rÃ¼len aÅaÄÄ±daki bilgileri HHS\'ler ile paylaÅmalarÄ± gerekmektedir. Bu bilgiler Ä±ÅÄ±ÄÄ±nda mÃ¼Återinin profili oluÅturulmasÄ±na katkÄ± saÄlanacaktÄ±r.   ÃHKâlÄ± iÅlemlerde (PSU-Initiated = E gÃ¶nderildiÄi durumlarda) gÃ¶nderilmesi zorunludur.  Sistemsel yapÄ±lan API Ã§aÄrÄ±mlarÄ±mda, Olay Bildirim Servis ÃaÄrÄ±mlarÄ±nda ve HHS-YÃS API Ã§aÄrÄ±mlarÄ±nda gÃ¶nderilmesine gerek bulunmamaktadÄ±r.  PaylaÅÄ±lacak bilgiler Åu Åekildedir.   FirstLoginFlag  : ÃHK\'nÄ±n, mÃ¼Återilik Ã¶mrÃ¼nde ilgili YÃS sistemine (mobil ya da web uygulamasÄ±) ilk login olma sÃ¼resini ifade eden deÄer. ÃHK\'nÄ±n ilk yaptÄ±ÄÄ± HBH ya da ÃBH iÅlemi deÄil, YÃS sisteminde kendini aktifleÅtirme tarih aralÄ±ÄÄ± bilgisidir.   YÃS, kullanÄ±cÄ±nÄ±n ilk login bilgisini tutarak sonraki iÅlemlerinde bu bilgiyi belirlenen format ile HHS\'ye aktaracaktÄ±r. ÃrneÄin; YÃS\'Ã¼n 7 aydÄ±r mÃ¼Återisi olan bir kullanÄ±cÄ± iÃ§in bu alan "5" olarak YÃS tarafÄ±ndan beslenecektir. Burada amaÃ§; ilgili kullanÄ±cÄ±nÄ±n YÃS\'Ã¼n eski bir mÃ¼Återisi mi, yoksa yeni bir mÃ¼Återisi mi olup olmadÄ±ÄÄ±nÄ± anlamaktÄ±r.   GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   DeviceFirstLoginFlag  : ÃHK\'nÄ±n, mÃ¼Återilik Ã¶mrÃ¼nde iÅlem anÄ±nda kullandÄ±ÄÄ± cihazla YÃS uygulamasÄ±na (web ya da uygulama tabanlÄ±) ilk login olma sÃ¼resini ifade eden deÄer. ÃHK cihaz deÄiÅikliÄi yaparsa FirstLoginFlag deÄeri sabit kalmalÄ±  ancak DeviceFirstLoginFlag deÄeri deÄiÅmelidir.  FirstloginFlag deÄeri ile ÃHKânÄ±n YÃS uygulamasÄ±na ilk login tarih bilgisi ile ilgili bilgi verilirken, DeviceFirstLoginFlag ile de ÃHKânÄ±n YÃS uygulamasÄ±na farklÄ± bir cihaz aracÄ±lÄ±ÄÄ± ile ilk login tarihinin bilgisi verilmektedir.  ÃrneÄin; ÃHK 7 aydÄ±r YÃS\'Ã¼n mÃ¼Återisi olabilir, bÃ¶yle bir durumda FirstLoginFlag deÄeri "5" olacaktÄ±r. Ancak son iÅlemini daha Ã¶nce hiÃ§ kullanmadÄ±ÄÄ± bir cihazdan yapmÄ±ÅtÄ±r. Yeni cihazdaki login sÃ¼re aralÄ±ÄÄ± 0-2 saat aralÄ±ÄÄ±nda  olduÄu iÃ§in DeviceFirstLoginFlag deÄeri "1" olacaktÄ±r.FirstLoginFlag deÄeri yine "5" olarak kalmaya devam edecektir.Bu bilgi ile YÃS, ilgili HHS\'ye ilk kez geliyor olsa bile; HHS, mÃ¼Återinin YÃS\'Ã¼ uzun sÃ¼redir kullandÄ±ÄÄ±nÄ± ama yeni bir cihazla iÅlemlerine devam ettiÄini anlayabilecektir. Bir ÃHK, farklÄ± cihazlar veya platformlar Ã¼zerinden YÃS ile etkileÅime girebilir.  KullanÄ±cÄ± ve YÃS arasÄ±nda bir oturum baÅlatÄ±lmÄ±Å ise YÃSâÃ¼n tutarlÄ± ve kalÄ±cÄ± bir kimlik (device id) atamasÄ± beklenmektedir.  Device ID: Web sitesi veya mobil uygulama kullanÄ±cÄ±larÄ± iÃ§in Ã¼retilen, tarayÄ±cÄ± ya da mobil uygulama tabanlÄ± benzersiz (tekil) tanÄ±mlayÄ±cÄ± deÄer. Mobil uygulamalar iÃ§in ÃHKânÄ±n ilk defa ilgili cihaza aktivasyon yaptÄ±ÄÄ± tarih bilgisi alÄ±nmalÄ±dÄ±r.   Device ID bilgileri YÃS uygulama ortamÄ± (web ya da uygulama tabanlÄ±) ve ÃHK cihazÄ± bazÄ±nda tutulmalÄ±dÄ±r. YÃSâten baÅlatÄ±lan iÅlem hangi uygulama ortamÄ±na ait ise ilgili ortamala iliÅkili tutulan Device IDânin ilk login tarihine bakÄ±larak gÃ¼ncel flag deÄeri hesaplanmalÄ±dÄ±r.  GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   LastPasswordChangeFlag  : ÃHK\'nÄ±n, YÃS (cihaz baÄÄ±msÄ±z)  uygulamasÄ±na login olduÄu Åifre bilgisinin en son deÄiÅtirildiÄi sÃ¼reyi ifade eden deÄer. MÃ¼Återinin en son ne zaman Åifre deÄiÅikliÄi yaptÄ±ÄÄ±nÄ± anlamak iÃ§in kullanÄ±lan alandÄ±r. Yeni mÃ¼Återi ve hiÃ§ Åifre deÄiÅikliÄi yapmamÄ±Å olabilir, bÃ¶yle bir durumda ilgili alan "0" olarak beslenecektir.   GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   BlacklistFlag  : ÃHK\'nÄ±n herhangi bir sebeple YÃS\'Ã¼n sakÄ±ncalÄ± mÃ¼Återiler listesinde bulunup bulunmadÄ±ÄÄ±nÄ± ifade eden deÄer.   Burada amaÃ§ herhangi bir sebeple YÃS tarafÄ±nda yasaklÄ± olarak kayÄ±tlÄ± olan ÃHK bilgisinin, dolandÄ±rÄ±cÄ±lÄ±ÄÄ± Ã¶nceden tespit etmek amaÃ§lÄ± HHS\'ye aktarÄ±lmasÄ± olarak aÃ§Ä±klanabilir. ÃrneÄin, YÃS tarafÄ±ndan tespit edilen dolandÄ±rÄ±cÄ± kullancÄ±lara ait device id bilgisi, bu kara listede tutulur daha sonra aynÄ± cihazla baÅka bir ÃHK iÅlem yapacak olsa bile bu alanda ilgili bilgi "1" deÄeri ile HHS\'ye aktarÄ±lÄ±r. HHS\'de olmayÄ±p YÃS tarafÄ±nda olan bu Ã¶rnekteki sakÄ±ncalÄ± mÃ¼Återi/cihaz bilgisinin, dolaylÄ± yoldan HHS\'ye aktarÄ±lmasÄ± amaÃ§lanmaktadÄ±r.  GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.VarYok sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   MalwareFlag  : YÃS uygulamasÄ±nÄ±n Ã§alÄ±ÅtÄ±ÄÄ± cihaz Ã¼zerindeki son 21 gÃ¼ne ait zararlÄ± yazÄ±lÄ±m tespit bilgisini ifade eden deÄer. ÃrneÄin ÃHK\'nÄ±n cihazÄ±nda zararlÄ± yazÄ±lÄ±m olduÄ

16u ayÄ±n 1\'inde YÃS tarafÄ±ndan tespit edildi. ZararlÄ± yazÄ±lÄ±m tespitinden 2 saat sonra YÃS Ã¼zerinden login olan ÃHK\'nÄ±n durumu,  "1" olarak iletilecektir. Bir gÃ¼n sonra ayÄ±n 2\'sinde, yeni bir zararlÄ± yazÄ±lÄ±m tespiti yok ancak mevcut zararlÄ± yazÄ±lÄ±m aktifse alan "2" deÄeri ile iletilecektir. SÃ¼reler artarak 21 gÃ¼ne kadar TR.OHVPS.DataCode.ZmnAralik deÄerlerine gÃ¶re iletilecektir.Son 21 gÃ¼n iÃ§inde yeni bir tespit yoksa ayÄ±n 22\'sinden itibaren ilgili alan  "0" deÄeri ile beslenecektir. Not: ZararlÄ± yazÄ±lÄ±m, bankacÄ±lÄ±k iÅlemlerinin yapÄ±ldÄ±ÄÄ± uygulamalara giriÅte kullanÄ±lan bilgilerin (Åifre, kullanÄ±cÄ± kodu gibi) ele geÃ§irilmesi amacÄ±yla kullanÄ±lan bir uygulama ya da kod parÃ§acÄ±ÄÄ± olabilir. Bu amaÃ§lar dÄ±ÅÄ±nda kullanÄ±lan (bankacÄ±lÄ±Äa yÃ¶nelik bir zararlÄ± yazÄ±lÄ±m olmayan) yazÄ±lÄ±m tespitleri iletilmemelidir. YÃS kanallarÄ±na her bir loginde, kullanÄ±lan cihazda bir zararlÄ± yazÄ±lÄ±m var mÄ± yok mu kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.   GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   AnomalyFlag  : DiÄer ÅÃ¼pheli durumlarÄ±n varlÄ±ÄÄ±nÄ± ifade eden deÄer. GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.VarYok sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   UnsafeAccountFlag : HHS tarafÄ±ndan aktarÄ±lan bilgi ile son 21 gÃ¼n iÃ§inde ÃHK\'nÄ±n dolandÄ±rÄ±cÄ±lÄ±k maÄduru olmasÄ± durumunu ifade eden deÄer. ÃrneÄin; HHS 1, ayÄ±n 1\'inde sÃ¼phe veya sahtekarlÄ±k nedeniyle bir Ã¶deme iÅlemine izin vermediÄi durumda, bu bilgiyi rÄ±za iptal detay kodu ile YÃS\'e aktarmÄ±Å olur. Bu bilgiyi tutan YÃS, ilgili mÃ¼Återinin 15 dakika sonra HHS 2\'de yaptÄ±ÄÄ± iÅlem iÃ§in ilgili alanÄ± "1" deÄeri ile besler. BÃ¶ylece HHS 2, ÃHK\'nÄ±n farklÄ± bir HHS\'de son 15 dakika iÃ§inde ÅÃ¼pheli veya sahte bir iÅlemi olduÄunu anlayabilecektir. AyÄ±n 22\'sinde yeni bir tespit/kayÄ±t yoksa bu alan YÃS tarafÄ±ndan "0" olarak beslenecektir. GÃ¶nderilmesi Opsiyonel alandÄ±r.TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.     Flaglar JWT claims iÃ§ine key value Åeklinde eklenerek gÃ¶nderilecektir. EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±\'nda belirtilen yÃ¶ntemle imzalanarak oluÅturulan JWT PSU-Fraud-Check alanÄ±na konularak YÃS\'ler tarafÄ±ndan HHS\'ye iletilmelidir. \n K \n K \n Z \n - \n - \n - \n \n \n PSU-Session-ID \n AN1..100 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen oturuma Ã¶zgÃ¼ talep kimliÄi. ÃHK\'nÄ±n YÃS uygulamasÄ± Ã¼zerinden kimlik doÄrulama mekanizmasÄ± ile bilgi sistemlerine dÃ¢hil olmalarÄ±ndan iÅlemlerini tamamlayÄ±p sistemden ayrÄ±lmalarÄ±na kadar geÃ§ecek tÃ¼m sÃ¼reci kapsayacak Åekilde aynÄ± deÄeri almalÄ±dÄ±r. Tek seferlik Ã¶deme gibi ÃHKânÄ±n tanÄ±nmadan baÅlatÄ±ldÄ±ÄÄ± iÅlemlerde bu deÄer boÅ olarak iletilmelidir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n Authorization \n AN1..4096 \n KatÄ±lÄ±mcÄ± ile GEÃÄ°T arasÄ±ndaki otorizasyon iÃ§in kullanÄ±lan token bilgisidir.  Yekilendirme tÃ¼rlerinden Ä°stemci Kimlik Bilgileriâni adresler.    BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-Access-Token \n AN1..4096 \n ÃHKânÄ±n GKD sÃ¼recinde doÄrulanmasÄ± sonrasÄ±nda kullanÄ±lan eriÅim simgesi. Yetkilendirme tÃ¼rlerinden Yetkilendirme Kodu (GKD)ânu adresler.  BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n X-JWS-Signature \n AN1..4096 \n Payload gÃ¶vdesinin ayrÄ±lmÄ±Å bir JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi.  Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir.  Mesaj imzalama kullanÄ±lan API ve methoda gÃ¶re gÃ¶nderimi zorunludur. \n K \n K \n K \n K \n - \n - \n 3.16. YanÄ±t BaÅlÄ±ÄÄ± \n \n "BaÅlÄ±k isimleri" yorumlanÄ±rken kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin "x-ReQuEsT-Id" geÃ§erli bir baÅlÄ±k ismidir. \n "BaÅlÄ±k deÄerleri" yorumlanÄ±rken ise kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harf duy

16arlÄ±lÄ±ÄÄ± olmalÄ±dÄ±r. ÃrneÄin "xyz123" ile "XYZ123" deÄerleri farklÄ±dÄ±r. \n BaÅlÄ±k deÄerlerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r. ÃrneÄin "Link" deÄerinde "Ä°OS12" yazmak, bÃ¼yÃ¼k "Ä°" harfinin ISO-8859-1 iÃ§erisinde yer almamasÄ±ndan dolayÄ±, hataya yol aÃ§acaktÄ±r. \n YanÄ±t baÅlÄ±ÄÄ±nda aÅaÄÄ±daki tabloda belirtilen alanlar dÄ±ÅÄ±nda gÃ¶nderim yapÄ±lmamalÄ±dÄ±r. \n YanÄ±t baÅlÄ±ÄÄ±nda boÅ deÄer iÃ§eren bir baÅlÄ±k ismiyle gÃ¶nderim yapÄ±lmamalÄ±dÄ±r. Ãrnek; "PSU-Initiated":"" \n \n Tablo 3: YanÄ±t BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n KullanÄ±m Durumu  OBH HBH GKD \n KullanÄ±m Durumu  OAS ODS \n \n \n \n \n X-Request-ID \n AN1..36 \n YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±    Ä°lgili istek baÅlÄ±ÄÄ±ndaki bilgi geri dÃ¶nÃ¼lÃ¼r. \n Z \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±. Ä°lgili istek baÅlÄ±ÄÄ±ndaki bu deÄer geri dÃ¶nÃ¼lÃ¼r. \n Z \n - \n \n \n X-ASPSP-Code \n AN4 \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n (HHS) kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n Z \n \n \n X-TPP-Code \n AN4 \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n Z \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder:  application/json \n Z \n Z \n \n \n X-JWS-Signature \n AN1..4096 \n JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n hangi yanÄ±tlar iÃ§in kullanÄ±lmasÄ± gerektiÄi ilgili endpoint iÃ§in belirtilmiÅtir.  Hata durumlarÄ±nda, yanÄ±t gÃ¶vdesi deÄeri dÃ¶nÃ¼lÃ¼yor ise imzalanmalÄ± ve imza bilgisi x-jws-signature alanÄ±nda iletilmelidir.  Ancak uygulama katmanÄ± tarafÄ±ndan yakalanamayan dolayÄ±sÄ± ile imzalanamayan hata durumlarÄ±nda x-jws-signature alanÄ± HHS\'ler tarafÄ±ndan boÅ gÃ¶nderilebilir.  HatalÄ± yanÄ±t alÄ±ndÄ±ÄÄ± durumlarda ise X-JWS-Signature baÅlÄ±k deÄeri dolu ise doÄrulama yapÄ±lmalÄ±dÄ±r. (4**, 5**) \n K \n K \n \n \n X-RateLimit-Limit \n N 1..18 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde en fazla kaÃ§ adet istek yapÄ±labileceÄini gÃ¶sterir. KÄ±sÄ±t uygulanan servislerde bu baÅlÄ±ÄÄ±n dÃ¶nmesi zorunludur. \n K \n - \n \n \n X-RateLimit-Remaining \n N 1..18 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde k

16aÃ§ adet istek hakkÄ± kaldÄ±ÄÄ±nÄ± gÃ¶sterir. KÄ±sÄ±t uygulanan servislerde bu baÅlÄ±ÄÄ±n dÃ¶nmesi zorunludur. \n K \n - \n \n \n X-RateLimit-Reset \n AN 1..255 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde Ã§aÄrÄ±m hakkÄ± bittikten sonra yeniden denemeden Ã¶nce beklemesi gereken sÃ¼reyi (saniye cinsinden) gÃ¶sterir. HTTP 429 durum kodu (Too Many Requests) ile dÃ¶nÃ¼len yanÄ±tlarÄ±n baÅlÄ±ÄÄ±nda dÃ¶nÃ¼lmesi zorunludur.  YÃS olarak yaptÄ±ÄÄ±nÄ±z sistemsel sorgularda; HTTP 429 durum kodu (Too Many Requests) ile dÃ¶nÃ¼len yanÄ±t aldÄ±ÄÄ±nÄ±zda tekrar sorgu yapmadan Ã¶nce âX-RateLimit-Resetâ yanÄ±t baÅlÄ±ÄÄ±nÄ± kontrol ederek, bu baÅlÄ±ktaki sÃ¼re kadar bekledikten sonra yeniden sorgulama yapÄ±lmasÄ± gerekmektedir. \n K \n - \n \n \n x-total-count \n N 1..18 \n Hesaplar, Ä°Ålemler, Bakiye, Ä°letilemeyen Olaylar servislerinde sayfalama kullanÄ±ldÄ±ÄÄ± durumda, sorgu sonucu dÃ¶necek toplam kayÄ±t sayÄ±sÄ± bilgisi, bu alanda HHS isteÄine baÄlÄ± olarak gÃ¶nderilebilir.   KayÄ±t sayÄ±sÄ± 0 olduÄu durumda gÃ¶nderimi zorunludur. \n K \n K \n \n \n Link \n 1..4096 \n âLinkâ alanÄ±nÄ±n  Hesap Bilgisi Hizmeti iÃ§in EriÅim Adresleri    tablosundaki parametre  = Sayfalama olan APIâlerde ve Ä°letilemeyen Olaylar API\'sinde gÃ¶nderim yapÄ±lmasÄ± zorunludur.  Sayfalama yapÄ±sÄ± kullanÄ±ldÄ±ÄÄ±nda gelen yanÄ±tta birden fazla sayfa var ise; Ã¶nceki, sonraki, ilk, son sayfalara gitmek iÃ§in gerekli referanslar link headerÄ±nda aÅaÄÄ±daki Ã¶rnekteki gibi doldurulabilir.  x-total-count alanÄ±nÄ±n gÃ¶nderimi kayÄ±t sayÄ±sÄ± 0 olduÄu durum dÄ±ÅÄ±nda isteÄe baÄlÄ± olduÄu iÃ§in; Link iÃ§erisindeki son sayfa bilgisi  (last) isteÄe baÄlÄ± hale getirilmiÅtir. âÃncekiâ( prev) ve âSonrakiâ (next) adÄ±mlarÄ±nÄ±n uygun olan her durumda yer almasÄ± zorunludur. Ä°lk sayfada âÃncekiâ seÃ§eneÄi olmamalÄ±, son sayfada ise âSonrakiâ seÃ§eneÄi olmamalÄ±dÄ±r.    </ohvps/hbh/s2.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=6&syfKytSayi=100>; rel="next",  </ohvps/hbh/s2.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=4&syfKytSayi=100>; rel="prev",  </ohvps/hbh/s2.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=14&syfKytSayi=100>; rel="last",  </ohvps/hbh/s2.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=0&syfKytSayi=100>; rel="first"    HiÃ§ hesap hareketinin olmadÄ±ÄÄ± durumda dÃ¶nen yanÄ±t baÅlÄ±ÄÄ±nÄ±zÄ±n Åu Åekilde olmasÄ± beklenmektedir.  Response body: [] Response header: Link: </ohvps/hbh/s2.0/hesaplar?srlmKrtr=hspRef&srlmYon=A&syfNo=1&syfKytSayi=100>; rel="last",</ohvps/hbh/s2.0/hesaplar?srlmKrtr=hspRef&srlmYon=A&syfNo=1&syfKytSayi=100>; rel="first"  x-total-count alanÄ± da 0 olarak iletilmelidir. \n K \n K \n 3.17. Idempotency KurallarÄ± \n YÃSâÃ¼n aÅaÄÄ±daki durumlarda aynÄ± istek numarasÄ± (x-request-id) ve aynÄ± veri gÃ¶vdesiyle Ã§aÄrÄ±yÄ± tekrarlamasÄ±; HHSânin de bu durumlarda aynÄ± yanÄ±tÄ± dÃ¶nmesi gereklidir. \n \n HHSânin yanÄ±tÄ± kesinti/arÄ±za nedeniyle YÃSâe ulaÅmaz ve zaman aÅÄ±mÄ± sÃ¶z konusu olmasÄ±, \n ÃHK, YÃS uygulamasÄ± Ã¼zerinden Ã§ift tÄ±klama ile mÃ¼kerrer defa HHS APIâlerini Ã§aÄÄ±rÄ±lmasÄ±,\n(API kontrollerinden Ã¶nce YÃS uygulamasÄ±nÄ±n, Ã§ift tÄ±klama kontrolÃ¼ yapmasÄ± Ã¶nerilmektedir.) \n YÃS, yanÄ±t almasÄ±na raÄmen iÅleyemeden kaybedilmesi, \n \n durumlarÄ±nda HHS aÅaÄÄ±daki kurallarÄ± iÅletir: \n \n HHS gelen istek numarasÄ±nÄ± ve veri gÃ¶vdesini birleÅtirerek checksum deÄeri Ã¼retir. \nchesksum deÄeri x-request-id|request.body ânin hash algoritmalarÄ±ndan (CRC32,MD5 vb)  geÃ§irilerek Ã¼retilebilir. \n HHS bu checksum deÄeri ile YÃSâe dÃ¶nmÃ¼Å olduÄu yanÄ±tÄ± 5 dk boyunca saklar.  Saklama yÃ¶ntemi olarak veri tabanÄ± veya Ã¶nbellek araÃ§larÄ± kullanÄ±labilir. \n YÃS aynÄ± istek numarasÄ± ve aynÄ± veri gÃ¶vdesi ile yeni bir Ã§aÄrÄ± yaptÄ±ÄÄ±nda, aynÄ± checksum deÄeri Ã¼retileceÄi iÃ§in 5dk boyunca bu deÄere karÅÄ±lÄ±k gelen yanÄ±tÄ± dÃ¶ner. \n 5 dk sonrasÄ±nda istek numarasÄ± veya veri gÃ¶vdesi deÄiÅmemiÅ olsa dahi bu HHS tarafÄ±ndan yeni istek olarak kabul edilir. \n \n AÅaÄÄ±daki Public Post iÅlemleri iÃ§in bu kural setinin iÅletilmesi gerekmektedir: \n 1- Ãdeme emri rÄ±zasÄ± oluÅturma \n2- EriÅim belirteci oluÅturma \n3- Ãdeme emri \n4- Hesap bilgisi rÄ±zasÄ± oluÅturma \n5- Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± oluÅturma \n6- Ä°leri Tarihli Ãdeme Emri \n7- DÃ¼zenli TekrarlÄ± Ãdeme Emri RÄ±zasÄ± oluÅturma \n8- DÃ¼zenli TekrarlÄ± Ãdeme Emri \n 3.18. HTTP Durum KodlarÄ± \n RFC 2616\'da belirlenmiÅ olan durum ko

16dlarÄ± (status code) gÃ¶nderilen isteÄin durumunu YÃSâa standart bir Åekilde ifade eder. EÄer bir hata varsa hatayÄ±, gÃ¶nderilen istek baÅarÄ±lÄ± bir Åekilde iÅlem gÃ¶rdÃ¼yse ona iliÅkin durumu aktarÄ±r. Durum kodlarÄ± genel olarak 5 kategoridedir. \n \n 1xx Bilgi \n 2xx BaÅarÄ±lÄ± \n 3xx YÃ¶nlendirme \n 4xx Ä°stemci HatasÄ± \n 5xx Sunucu HatasÄ± \n \n errorCode AlanÄ±nda KullanÄ±labilecek SÄ±ralÄ± Hata Tipleri : \n \n TR.OHVPS.Resource \n \n â¨\tInvalidFormat \n â¨\tConsentMismatch \n â¨\tNotFound \n â¨\tInvalidSignature \n â¨\tMissingSignature \n â¨\tMethodNotAllowed \n â¨\tNotAcceptable \n â¨\tUnsupportedMediaType \n â¨\tConsentRevoked \n \n \n \n TR.OHVPS.Business \n \n â¨\tInvalidContent \n â¨\tInvalidAccount \n \n \n \n TR.OHVPS.Connection \n \n â¨\tInvalidCertificate \n â¨\tExceededRate \n â¨\tInvalidTPP \n â¨\tInvalidASPSP \n â¨\tInvalidToken \n â¨\tInvalidTPPRole \n \n \n \n TR.OHVPS.Server \n \n â¨\tInternalError \n â¨\tServiceUnavailable \n \n \n TR.OHVPS.Resource.InvalidFormat hatasÄ± alÄ±ndÄ±ÄÄ± durumda; fieldErrors nesnesi iÃ§erisinde verilecek hata kodlarÄ± : \n \n TR.OHVPS.Field \n \n â¨\tMissing \n â¨\tInvalid \n \n \n Veri Tipi ÃrneÄi: \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "d8bd4e5f-f094-48a6-aee1-3a800e2709d9" , \n     "timestamp" :   "2022-12-22T10:33:15+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "fieldErrors" :   [ \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.islTtr.prBrm" , \n             "messageTr" :   "boÅ deÄer olamaz" , \n             "message" :   "must not be null" , \n             "code" :   "TR.OHVPS.Field.Missing" \n         } , \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.kmlk.kmlkVrs" , \n             "messageTr" :   "boyut \'1\' ile \'30\' arasÄ±nda olmalÄ±" , \n             "message" :   "size must be between 1 and 30" , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } \n     ] , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" \n }  \n \n Tablo 4: HTTP Durum KodlarÄ± \n \n \n \n HTTP Durum \n Ä°stek Sonucu ve AÃ§Ä±klamalar \n POST \n GET \n DELETE \n \n \n \n \n 200 OK \n Ä°stek BaÅarÄ±yla TamamlandÄ±. Kaynak gÃ¼ncellemek iÃ§in yapÄ±lan (Ã¶rneÄin, GET) ve baÅarÄ±yla tamamlanan isteklerinde kullanÄ±lÄ±r. \n H \n E \n H \n \n \n 201 Created \n Ä°stek BaÅarÄ±lÄ± Oldu. Kaynak yaratma isteÄi (Ã¶rneÄin, POST /Ã¶deme-emri-rizasi) baÅarÄ±yla sonuÃ§landÄ±. \n E \n H \n H \n \n \n 204 No Content \n Silme iÅlemi baÅarÄ±yla tamamlandÄ±. Kaynak silme isteÄi (Ã¶rneÄin,  DELETE /hesap-rizasi/{RizaNo} ) baÅarÄ±yla sonuÃ§landÄ±. \n H \n H \n E \n \n \n 400 Bad Request \n Ä°stekte bozuk, eksik veya uyumlu olmayan JSON gÃ¶vdesi, URL parametreleri veya baÅlÄ±k alanlarÄ± var.  Ä°stekle baÅlatÄ±lan iÅlem yapÄ±sal bozukluk, eksik veya tutarsÄ±z veri veya HHS tarafÄ±ndaki kontrollerin hatalÄ± sonuÃ§lanmasÄ± nedeniyle hata ile sonuÃ§lanÄ±r ve hataya iliÅkin veriler hata nesnesi iÃ§erisinde dÃ¶nÃ¼lÃ¼r. \n E \n E \n E \n \n \n 401 Unauthorized \n Yetkilendirme baÅlÄ±ÄÄ± eksik, hatalÄ± veya geÃ§ersiz olduÄundan istek yetkilendirilmediÄinde ve eriÅim reddedildiÄinde http 401 kodu dÃ¶nÃ¼lmelidir. \n E \n E \n E \n \n \n 403 Forbidden \n EriÅim belirtecinin veya rÄ±zanÄ±n kapsamÄ± uyuÅmuyor. YÃS bir hesaba/iÅlem kaynaÄÄ±na eriÅmeye Ã§alÄ±ÅÄ±r ve YÃS, istenen kaynaÄa eriÅmek iÃ§in geÃ§erli izinlere sahip bir rÄ±zasÄ± yoktur.  ÃrneÄin; hesap bilgisi rÄ±zasÄ± bakiye izni almamÄ±ÅtÄ±r ancak /bakiyeler adresinden istekte bulunmuÅtur. \n \n \n \n \n \n 404 Not Found \n **HHS geÃ§erli bir API eriÅim adresini saÄlamÄ±yorsa, o URL\'ye gelen istekler iÃ§in 404 (BulunamadÄ±) ile yanÄ±t vermelidir.**YÃS, uygulama esaslarÄ±nda tanÄ±mlanmayan bir

16kaynak iÃ§in bir URL\'ye eriÅmeye Ã§alÄ±ÅÄ±rsa (Ã¶rneÄin, GET /yurtdisi-odeme), HHS, 404 (BulunamadÄ±) ile yanÄ±t vermeyi seÃ§ebilir. \n E \n E \n E \n \n \n 405 Method Not Allowed \n YÃS, desteklenmeyen bir yÃ¶ntemle kaynaÄa eriÅmeye Ã§alÄ±ÅtÄ±. \n E \n E \n E \n \n \n 406 Not Acceptable \n Ä°stek, geÃ§ersiz bir karakter kÃ¼mesi iÃ§eriyor. \n E \n E \n E \n \n \n 415 Unsupported Media Type \n Ä°stek gÃ¶vdesi hedef kaynakta bu yÃ¶ntem tarafÄ±ndan desteklenmeyen bir biÃ§imde oluÅturulduÄu iÃ§in iÅlem reddedildi \n E \n H \n H \n \n \n 429 Too Many Requests \n Belirli bir sÃ¼re iÃ§inde Ã§ok fazla talepte bulunulduÄu iÃ§in iÅlem reddedildi.  HHSâler adil kullanÄ±m politikalarÄ±nÄ± aÅan talepleri kÄ±sÄ±tlayabilir. \n E \n E \n E \n \n \n 500 Internal Server Error \n API sunucu / servis katmanÄ±nda sorun oluÅtu. Ä°Ålem baÅarÄ±sÄ±z.  5XX hata durumlarÄ±nda yanÄ±t gÃ¶vde deÄeri olmadÄ±ÄÄ± iÃ§in mesaj imzalama yapÄ±lamaz ve x-jws-signature alanÄ± boÅ olarak iletilir.  Bu durumda x-jws-signature kontrolÃ¼ yapÄ±lmamalÄ±dÄ±r. \n E \n E \n E \n \n \n 503 Service Unavailable \n Hizmet sÃ¼rÃ¼mÃ¼ kullanÄ±mdan kaldÄ±rÄ±ldÄ±.  Bir API\'nin kullanÄ±mdan kaldÄ±rÄ±ldÄ±ÄÄ± ve artÄ±k bir HHS tarafÄ±ndan operasyonel olarak desteklenmediÄi durumlarda, URI yolu hala etkin olabilir ve API isteklerini kabul edebilir.  Bu durumda, YÃS\'Ã¼n API sÃ¼rÃ¼mÃ¼nÃ¼n Ã§evrimdÄ±ÅÄ± olduÄunun farkÄ±nda olmasÄ± iÃ§in 503 Hizmet KullanÄ±lamÄ±yor dÃ¶nmesi Ã¶nerilir. \n E \n E \n E \n \n \n \n Ä°Å kurallarÄ± nezdinde ilgili hata kodlarÄ± Ã¶zelleÅtirilmiÅ olup HHS tarafÄ±ndan verilecek olan hata kodlarÄ± ÃHVPS API Ä°lke ve KurallarÄ± dokÃ¼manÄ±nda ilgili alanlarda paylaÅÄ±lmÄ±ÅtÄ±r. Bu Ã§alÄ±Åmaya ek olarak, HHS\'lerin YÃS\'lere; YÃS\'lerin de ÃHK\'lara iletecekleri hata mesaj iÃ§eriklerinde standartlaÅmaya gidilmiÅtir. Bu Ã§alÄ±Åmaya TÃ¼rkiye\'nin Ä°letiÅim Platformu altÄ±nda yer alan ÃHVPS > DokÃ¼manlar alanÄ±ndan ulaÅabilirsiniz. HHS\'lerin ve YÃS\'lerin ilgili dokÃ¼manÄ± referans alarak mesaj iÃ§eriklerini, kurumlarÄ±n kendi mÃ¼Återi iletiÅim dili kapsamÄ±nda dÃ¼zenleyerek ÃHK\'lara gÃ¶sterebilir olmasÄ± beklenmektedir. \n Hata Ãrnekleri: \n 400 Bad Request \n TR.OHVPS.Resource.InvalidFormat  hatasÄ± Åema validasyonu, alan uzunluk ve varlÄ±k kontrollerinin baÅarÄ±sÄ±z olduÄu durumda verilmelidir. \n \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "7f115b9c-d7c2-4a2a-bc45-5a9891c79072" , \n     "timestamp" :   "2022-12-22T10:47:57+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "fieldErrors" :   [ \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.alc.unv" , \n             "messageTr" :   "boyut \'3\' ile \'140\' arasÄ±nda olmalÄ±" , \n             "message" :   "size must be between 3 and 140" , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } , \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.islTtr.ttr" , \n             "messageTr" :   "boÅ deÄer olamaz" , \n             "message" :   "must not be null" , \n             "code" :   "TR.OHVPS.Field.Missing" \n         } \n     ] , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" \n }  \n\n \n Zorunlu header alanlarÄ±ndan biri ya da birkaÃ§Ä± eksik olarak gÃ¶nderilirse aÅaÄÄ±daki gibi bir hata dÃ¶nÃ¼ÅÃ¼ gerÃ§ekleÅebilir. \n HHS uygulamasÄ± tarafÄ±ndan dÃ¶nÃ¼lebilecek hata Ã¶rnekleri: \n \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "2005515d-f0e6-4a07-a439-0ef3b0f56011" , \n     "timestamp" :   "2022-12-22T10:39:26+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" , \n     "fieldErrors" :   [ \n         {          \n             "field" :   "X-Request-ID" , \n             "messageTr" :   "X-Request-ID deÄeri boÅ olamaz." , \n             "message" :   "X-Request-ID cannot be null." , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } \n     ] \n }  \n\n \n Business hata Ã¶rneÄi - 1: \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "677cfd9d-77c1-4ea3-8bdf-74a6e9887177" , \n     "timestamp" :   "2022-12-22T11:05:59+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "gonUnvan wrong" , \n     "moreInformationTr" :   "GÃ¶nderen Ãnvan hatalÄ±" , \n     "errorCode" :   "TR.OHVPS.Business.IncorrectSenderTitle" \n }  \n \n Business hata Ã¶rneÄi - 2: \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "5df3b402-3aca-4305-a35b-5af0f3184b40" , \n     "timestamp" :   "2022-12-22T11:06:47+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Sender account is disabled or not found." , \n     "moreInformationTr" :   "Gonderen hesap aktif deÄil veya bulunamadÄ±." , \n     "errorCode" :   "TR.OHVPS.Business.InvalidAccount" \n }  \n \n GEÃÄ°T\'te yapÄ±lan zorunlu header kontrollerinde aÅaÄÄ±daki hatalar dÃ¶nebilir: \n \n { \n     "timestamp" :   "2022-12-22T10:40:28+03:00" , \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "d4375748-6fc7-4f7e-94f3-6411cab1d59f" , \n     "moreInformationTr" :   "GeÃ§ersiz HHS kodu." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidASPSP" , \n     "moreInformation" :   "Invalid ASPSP Code" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" \n }  \n \n GEÃÄ°T tarafÄ±ndan dÃ¶nÃ¼lecek hata Ã¶rneÄi: \n \n { \n     "timestamp" :   "2022-12-22T10:40:28+03:00" , \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "d4375748-6fc7-4f7e-94f3-6411cab1d59f" , \n     "moreInformationTr" :   "GeÃ§ersiz HHS kodu." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidTPP" , \n     "moreInformation" :   "Invalid TPP Code" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" \n }  \n \n GEÃÄ°T tarafÄ±ndan dÃ¶nÃ¼lecek hata Ã¶rneÄi: \n \n { \n     "timestamp" :   "2022-12-22T11:14:05+03:00" , \n     "path" :   "/ohvps/hbh/s2.0/hesap-bilgisi-rizasi" , \n     "id" :   "ee1e3ea7-a5e5-468b-bb02-314148f84e6a" , \n     "moreInformationTr" :   "GeÃ§ersiz yÃ¶s rolÃ¼. Ä°lgili api Ã§aÄrÄ±sÄ± iÃ§in yetkisi yok." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidTPPRole" , \n     "moreInformation" :   "Invalid TPP Role" , \n     "httpCode" :   403 , \n     "httpMessage" :   "Forbidden" \n }  \n\n \n 401 Unauthorized \n YÃS, sÃ¼resi dolmuÅ bir eriÅim belirteci kullandÄ±ÄÄ±nda, HHS 401 (Yetkisiz) http kodu ile aÅaÄÄ±daki hata kodunu dÃ¶nmelidir.  AÅaÄÄ±daki nedenlerden herhangi biri nedeniyle bir EriÅim Belirtecinin sÃ¼resi dolduÄunda bu durum ortaya Ã§Ä±kabilir: \n \n RÄ±zanÄ±n sÃ¼resi doldu (Son Kullanma Tarihi geÃ§ti) \n EriÅim Belirtecinin ÅÃ¼pheli kullanÄ±mÄ± veya sahtekarlÄ±k ÅÃ¼phesi \n RÄ±zada belirlenen gÃ¼n s

16ayÄ±sÄ±nÄ±n aÅÄ±mÄ±\nBu hata, mÃ¼Återiden doÄru izinlerle yeniden kimlik doÄrulamasÄ± isteyerek Ã§Ã¶zÃ¼lebilir. \n \n \n { \n     "path" :   "/ohvps/gkd/s2.0/erisim-belirteci" , \n     "id" :   "ed3fd667-fc58-40ad-a982-e8937faccd15" , \n     "timestamp" :   "2022-12-22T11:17:33+03:00" , \n     "httpCode" :   401 , \n     "httpMessage" :   "Unauthorized" , \n     "moreInformation" :   "Refresh token expired or not found in database" , \n     "moreInformationTr" :   "Yenileme belirteci zaman aÅÄ±mÄ±na uÄramÄ±Å veya veri tabanÄ±nda yok" , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidToken" \n }  \n \n\n \n 403 Forbidden \n Ãrn; YÃS yetkisi olmayan rol(ÃBH/HBH) ile iÅlem yapmaya Ã§alÄ±ÅtÄ±ÄÄ± durumda 403 hatasÄ± alarak iÅleme devam edemez. \n { \n   "path" :   "/ohvps/hbh/s2.0/bakiye" , \n   "id" :   "3e48ea98-f889-48b9-aa6e-28aabc6cfb14" , \n   "timestamp" :   "2022-12-22T11:20:05+03:00" , \n   "httpCode" :   403 , \n   "httpMessage" :   "Forbidden" , \n   "moreInformation" :   "Forbidden" , \n   "moreInformationTr" :   "Bakiye Bilgileri iÃ§in ÃHK izni bulunmamaktadÄ±r." , \n   "errorCode" :   "TR.OHVPS.Resource.Forbidden" \n }  \n \n 404 Not Found \n Ãrn; GET /odeme-emri-rizasi/123456 Ã§aÄrÄ±sÄ± durumunda 123456 geÃ§erli bir Ã¶deme kaynaÄÄ± deÄilse, HHS, 404 koduyla cevap vermelidir. \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi/123456" , \n     "id" :   "22f52b2d-d442-4a6a-8f39-d23eba45a34b" , \n     "timestamp" :   "2022-12-22T10:53:53+03:00" , \n     "httpCode" :   404 , \n     "httpMessage" :   "Not Found" , \n     "moreInformation" :   "Resource not found" , \n     "errorCode" :   "TR.OHVPS.Resource.NotFound" , \n     "moreInformationTr" :   "Kaynak bulunamadÄ±" \n }  \n\n \n 405 Method Not Allowed \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "3e5c6b28-7ee4-4469-b541-843fb4a94eec" , \n     "timestamp" :   "2022-12-22T11:35:10+03:00" , \n     "httpCode" :   405 , \n     "httpMessage" :   "Method Not Allowed" , \n     "moreInformation" :   "Method not allowed" , \n     "errorCode" :   "TR.OHVPS.Resource.MethodNotAllowed" , \n     "moreInformationTr" :   "Ä°stek yapÄ±lan URL iÃ§in izin verilmeyen metot" \n }  \n \n 406 Not Acceptable \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "3e5c6b28-7ee4-4469-b541-843fb4a94eec" , \n     "timestamp" :   "2022-12-22T11:35:10+03:00" , \n     "httpCode" :   406 , \n     "httpMessage" :   "Not Acceptable" , \n     "moreInformation" :   "Not Acceptable" , \n     "errorCode" :   "TR.OHVPS.Resource.NotAcceptable" , \n     "moreInformationTr" :   "Kabul edilmedi" \n }  \n \n 415 Unsupported Media Type \n Ä°stek baÅlÄ±ÄÄ±nda content-type, JSON dÄ±ÅÄ±nda bir veri iletilirse bu hata verilebilir. \n \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "63cc94b6-1b51-4648-9671-95e6e2e7e03d" , \n     "timestamp" :   "2022-12-22T11:37:12+03:00" , \n     "httpCode" :   415 , \n     "httpMessage" :   "Unsupported Media Type" , \n     "moreInformation" :   "Content type not supported" , \n     "errorCode" :   "TR.OHVPS.Resource.UnsupportedMediaType" , \n     "moreInformationTr" :   "Desteklenmeyen iÃ§erik tipiâ" \n }  \n \n 429 Too Many Requests \n { \n   "path" :   "/ohvps/hbh/s2.0/hesaplar/aef6061f-2978-4bb4-980d-b4c634c8055b/islemler" , \n   "id" :   "20473c5f-2f4f-4b2e-8b66-7978aec442f7" , \n   "timestamp" :   "2022-12-22T00:21:07+03:00" , \n   "httpCode" :   429 , \n   "httpMessage" :   "Too Many Requests" , \n   "moreInformation" :   "Exceeded rate" , \n   "moreInformationTr" :   "EriÅim sÄ±klÄ±ÄÄ± limiti aÅÄ±mÄ±" , \n   "errorCode" :   "TR.OHVPS.Connection.ExceededRate" \n }  \n \n 500 Internal Server Error \n { \n   "id" :   "1b90c6dc-0277-4755-8b05-9297ddfab743" , \n   "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n   "timestamp" :   "2022-12-22T11:41:34+03:00" , \n   "httpCode" :   500 , \n   "httpMessage" :   "Internal Server Error" , \n   "moreInformation" :   "Unexpected condition was encountered." , \n   "moreInformationTr" :   "Beklenmeyen bir durumla karÅÄ±laÅÄ±ldÄ±." , \n   "errorCode" :   "TR.OHVPS.Server.InternalError" \n }  \n\n \n 503 Service Unavailable \n \n   "timestamp" :   "2022-12-20T23:18:56+03:00" , \n   "path" :   "/ohvps/hbh/s2.0/hesap-bilgisi-rizasi/2a72678ee3d24de2be47887e4903a8c6" , \n   "id" :   "e76315b7-09f4-4295-b6d8-1f7fec632159" , \n   "moreInformationTr" :   "HHS Åu anda hizmet veremiyor." , \n   "errorCode" :   "TR.OHVPS.Server.ServiceUnavailable" , \n   "moreInformation" :   "HHS is currently unavailable" , \n   "httpCode" :   503 , \n   "httpMessage" :   "Service Unavailable" \n 3.19. Maskeleme KurallarÄ± \n Maskeli olarak iletilmesi gereken verilerin maskeleme kurallarÄ± Åu Åekildedir: \n \n IBAN verileri Hesap NumarasÄ± : Ä°lk 4 ve son 4 karakteri aÃ§Ä±k, diÄer karakterler maskeli olmalÄ±dÄ±r. Ãrnek: TR54******************4812 \n Ad-SoyadÄ± / Ticari Unvan : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet â â karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r.\nÃrneÄin: âFATÄ°H SERKAN ERENâ ifadesi âFA *** SE**** ER****â Åeklinde gÃ¶sterilmelidir. \n Tabela UnvanÄ± : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet \' \' karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r. ÃrneÄin âBANKALARARASI KART MERKEZÄ° ANONÄ°M ÅÄ°RKETÄ°â ifadesi âBA *** KA**

16** ME**** AN**** ÅÄ°****â Åeklinde gÃ¶sterilmelidir. \n YÃSâten girilen alÄ±cÄ± unvan ve IBAN bilgileri Ã¶deme emri rÄ±zasÄ± ve Ã¶deme emri yanÄ±tÄ±nda aÃ§Ä±k dÃ¶nÃ¼lÃ¼r, Kolas akÄ±ÅÄ±nda Ã¶deme emri rÄ±zasÄ± yanÄ±tÄ± ve Ã¶deme emri istek ve yanÄ±tÄ±nda maskeli taÅÄ±nÄ±r. \n 3.20. Fonksiyonel Olmayan Gereksinimler \n \n \n HHSâlerin sunuyor olduklarÄ± servisleri en fazla 6000 ms iÃ§inde yanÄ±t dÃ¶necek Åekilde tasarlamalÄ±dÄ±r. \n \n \n HHS\'ler mevcut online iÅlem kanallarÄ±ndan sunduklarÄ± eriÅilebilirlik ve performans kriterlerinden daha dÃ¼ÅÃ¼k bir hizmet kalitesi sunmamalÄ±dÄ±r. \n \n \n HHSâlerin sunuyor olduklarÄ± servislere sistemin gÃ¼venlik ve sÃ¼rekliliÄini saÄlamak adÄ±na rate limit koyma ihtiyaÃ§larÄ± olur ise, standartlar ve ihtiyaÃ§lara uygun Åekilde bir konfigÃ¼rasyon yapabilirler.  \n \n \n HHS rate limit tanÄ±mÄ± uyguluyor ise; YÃS\'ler arasÄ±nda ayrÄ±m yapmadan, adil ve makul sÄ±nÄ±rlar dahilinde uygulamalÄ±dÄ±r.    \n \n \n YÃS tarafÄ±ndan kullanÄ±cÄ±nÄ±n baÅlatmadÄ±ÄÄ± otomatik sorgu limitleri  3.21 Otomatik Sorgular  bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. HHS\'lerin bu servisler iÃ§in minimumda cevap vermesi gereken sorgu sayÄ±larÄ± belirlenmiÅtir. Bu sayÄ±larÄ±n Ã¼zerinde yapÄ±lan servis Ã§aÄrÄ±sÄ±na yanÄ±t dÃ¶nmek HHS inisiyatifindedir. DiÄer taraftan kullanÄ±cÄ±nÄ±n baÅlattÄ±ÄÄ± istekler iÃ§in uygulanacak limitler, HHS\'nin online iÅlem kanallarÄ±ndan sunulan sorgu limitlerinden daha az olmamalÄ±dÄ±r. \n \n \n HHS\'ler, Ã§aÄrÄ±m limitlerini aÅan istekler iÃ§in HTTP 429 - Too Many Request hatasÄ±nÄ± dÃ¶nmelidir. Ãrnek hata mesajÄ±  3.18 HTTP Durum KodlarÄ±  bÃ¶lÃ¼mÃ¼nde bulunmaktadÄ±r. Rate Limit Ã¶zelinde tanÄ±mlanmÄ±Å parametreler olan X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset alanlarÄ± da   3.16 YanÄ±t BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanmÄ±ÅtÄ±r. YÃS\'ler de HHS\'nin belirlediÄi rate limit kurallarÄ±na uymakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n 3.21. Otomatik Sorgular \n YÃS uygulamasÄ±, ÃHK\'nÄ±n baÅlattÄ±ÄÄ± iÅlemler neticesinde API Ã§aÄrÄ±mÄ± yapabileceÄi gibi, sistemsel bir Åekilde otomatik API Ã§aÄrÄ±mÄ± da yapabilir. \nHHS, API Ã§aÄrÄ±mÄ±nÄ±n ÃHK\'lÄ± ya da ÃHK\'sÄ±z olduÄunu istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n ÃHK YÃS uygulamasÄ±na giriÅ yaptÄ±ÄÄ± andan Ã§Ä±kÄ±Å yaptÄ±ÄÄ± ana kadar yani ÃHK oturumu boyunca yapÄ±lan API Ã§aÄrÄ±mlarÄ±nda, PSU-Initiated  deÄerinin "E" olmasÄ± gerekmektedir.  YÃS uygulamasÄ±nda ÃHK oturumu boyunca,  ÃHK\'nÄ±n bilgilerinden minimumda "bakiye" bilgisinin, uygulama arayÃ¼zlerinde gÃ¼ncel deÄeri ile online sorgularla gÃ¶sterimi YÃS\'Ã¼n insiyatifindedir. \n ÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \n YÃS, aÅaÄÄ±daki API\'leri sistemsel bir Åekilde Ã§aÄÄ±rabilir. \nHHS\'lerin bu servisler iÃ§in minimumda cevap vermesi gereken sorgu sayÄ±larÄ± belirlenmiÅtir. Bu sayÄ±larÄ±n Ã¼zerinde yapÄ±lan servis Ã§aÄrÄ±sÄ±na yanÄ±t dÃ¶nmek HHS inisiyatifindedir. \nHHS tarafÄ±ndan izin verilen sorgu sayÄ±sÄ±nÄ±n Ã¼zerinde yapÄ±lan bir sorgu iÃ§in HTTP 429 durum kodu (Too Many Requests) hatasÄ± dÃ¶nÃ¼lmelidir. YanÄ±t gÃ¶vdesinde tekrar hata nesnesinin oluÅturulmasÄ± HHS inisiyatifindedir.  HHS yanÄ±t headerÄ± alanÄ±nda iletilecek X-RateLimit-Reset (saniye cinsinden) deÄeri kadar sÃ¼re sonunda\nYÃS\'Ã¼n tekrar sorgulama yapmasÄ± beklenmektedir. \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Otomatik Sorgu SayÄ±sÄ± \n \n \n \n \n 1 \n erisim-belirteci \n POST \n /erisim-belirteci \n --- \n \n \n 2 \n odeme-emri-rizasi \n GET \n /odeme-emri-rizasi/{rizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 3 \n odeme-emri \n GET \n /odeme-emri/{odemeEmriNo} \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 4 \n ileri-tarihli-odeme-emri-rizasi \n GET \n /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 5 \n ileri-tarihli-odeme-emri \n GET \n /ileri-tarihli-odeme-emri

16/{odemeEmriNo} \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 6 \n ileri-tarihli-odeme-emri-rizasi \n DELETE \n /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n --- \n \n \n 7 \n duzenli-odeme-emri-rizasi \n GET \n /duzenli-odeme-emri-rizasi/{rizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 8 \n duzenli-odeme-emri \n GET \n /duzenli-odeme-emri/{talimatNo} \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 9 \n duzenli-odeme-emri-rizasi \n DELETE \n /duzenli-odeme-emri-rizasi/{rizaNo}} \n --- \n \n \n 10 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 11 \n duzenli-odeme-talimat-plani \n GET \n /duzenli-odeme-emri/{talimatNo}/odeme-plani \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 12 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n --- \n \n \n 13 \n hesaplar \n GET \n /hesaplar \n Bireysel gÃ¼nde 4  Kurumsal gÃ¼nde 4 \n \n \n 14 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Bireysel gÃ¼nde 4 Kurumsal gÃ¼nde 4 \n \n \n 15 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 16 \n bakiye \n GET \n /bakiye \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 17 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Bireysel gÃ¼nde 4 Kurumsal ÃHK - saatte 12 \n \n \n 18 \n kartlar \n GET \n /kartlar \n Bireysel gÃ¼nde 4  Kurumsal gÃ¼nde 4 \n \n \n 19 \n kartlar \n GET \n /kartlar/{kartRef} \n Bireysel gÃ¼nde 4 Kurumsal gÃ¼nde 4 \n \n \n 20 \n kart-detay \n GET \n /kartlar/{kartRef}/kart-detay \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 21 \n kart-hareketleri \n GET \n /kartlar/{kartRef}/kart-hareketleri \n Bireysel gÃ¼nde 32 Kurumsal ÃHK - gÃ¼nde 32 \n \n \n \n YÃS ve HHS son 24 saat iÃ§erisindeki sorgu sayÄ±larÄ±nÄ± toplayarak elde ettiÄi sonuÃ§larla limit kontrolÃ¼ yapmalÄ±dÄ±r (Pencere yÃ¶ntemi). \n Ä°Ålemler servisinin Ã§aÄrÄ±m detaylarÄ±na  ^BÃ¶lÃ¼m 7.8  Ã¼zerinden ulaÅÄ±labilir. \n Hesap bilgisi rÄ±zasÄ±nÄ±n YÃS tarafÄ±ndan otomatik bir Åekilde iptal edilmesi durumu  ^BÃ¶lÃ¼m 9\'da  aÃ§Ä±klanmÄ±ÅtÄ±r. \n Kart hareketleri iÃ§in sistemsel sorgu yapÄ±ldÄ±ÄÄ± durumda aynÄ± ekstre tÃ¼rÃ¼ iÃ§in dÃ¶nem deÄeri deÄiÅtikÃ§e limit dÃ¼Åmeyecektir. Sayfalama yapÄ±ldÄ±ÄÄ± durumlarda ise deÄiÅen sayfa numaralarÄ± Ã¶zelinde de limit dÃ¼Åmeyecektir. AynÄ± sayfa ve aynÄ± dÃ¶nem Ã¶zelinde tekrar sorgu yapÄ±lmasÄ± halinde limit dÃ¼ÅÃ¼mÃ¼ gerÃ§ekleÅecektir. \n Ekstre tÃ¼rÃ¼ deÄiÅmesi durumunda da limit dÃ¼ÅÃ¼mÃ¼ olmalÄ±dÄ±r. \n'},{frontmatter:{},regularPath:"/v2.0.0/deneyalani/hhs-yos-api.html",relativePath:"v2.0.0/deneyalani/hhs-yos-api.md",key:"v-d8bdee46",path:"/v2.0.0/deneyalani/hhs-yos-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.0/deneyalani/ileri-tarihli-odeme-emri-api.html",relativePath:"v2.0.0/deneyalani/ileri-tarihli-odeme-emri-api.md",key:"v-b537e5f2",path:"/v2.0.0/deneyalani/ileri-tarihli-odeme-emri-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.0/deneyalani/hesap-bilgisi-api.html",relativePath:"v2.0.0/deneyalani/hesap-bilgisi-api.md",key:"v-7b0a82c6",path:"/v2.0.0/deneyalani/hesap-bilgisi-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.0/deneyalani/olay-bildirim-api.html",relativePath:"v2.0.0/deneyalani/olay-bildirim-api.md",key:"v-5a2e0d7d",path:"/v2.0.0/deneyalani/olay-bildirim-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.0/deneyalani/odeme-emri-api.html",relativePath:"v2.0.0/deneyalani/odeme-emri-api.md",key:"v-35eaf572",path:"/v2.0.0/deneyalani/odeme-emri-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.0/deneyalani/test.html",relativePath:"v2.0.0/deneyalani/test.md",key:"v-aa99c1f6",path:"/v2.0.0/deneyalani/test.html",content:" \n   \n "},{title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",frontmatter:{},regularPath:"/v2.0.1/contents/ekler.html",relativePath:"v2.0.1/contents/ekler.md",key:"v-51c1355d",path:"/v2.0.1/contents/ekler.html",headers:[{level:2,title:"EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ±",slug:"ek-1-istek-cevap-mesajlarÄ±nda-kullanÄ±lacak-nesne-yapÄ±larÄ±"},{level:2,title:"EK-2: SÄ±ralÄ± Veri TÃ¼rleri",slug:"ek-2-sÄ±ralÄ±-veri-turleri"},{level:2,title:"EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi",slug:"ek-3-istemci-sertifikalarÄ±nÄ±n-tanÄ±m-ve-yonet

16imi"},{level:2,title:"EK-4: Sunucu SertifikalarÄ±",slug:"ek-4-sunucu-sertifikalarÄ±"},{level:2,title:"EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±",slug:"ek-5-mesaj-imzalama-akÄ±sÄ±"},{level:3,title:"Ä°mzalama KurallarÄ± (YÃS)",slug:"imzalama-kurallarÄ±-yos"},{level:2,title:"EK-6: HHS/YÃS API Mimarisi",slug:"ek-6-hhs-yos-api-mimarisi"}],content:' EK-1: Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lacak Nesne YapÄ±larÄ± \n AÃ§Ä±k BankacÄ±lÄ±k simÃ¼latÃ¶r uygulamasÄ± Ã¼zerinde swagger dÃ¶kÃ¼manlarÄ±nÄ±n gÃ¼ncel sÃ¼rÃ¼mlerine eriÅim saÄlanabilir. \n EK-2: SÄ±ralÄ± Veri TÃ¼rleri \n \n \n \n Kod \n AÃ§Ä±klama \n \n \n \n \n TR.OHVPS.DataCode.BrcAlc \n Ä°Ålemin hesabÄ± borÃ§landÄ±rdÄ±ÄÄ± ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. B : BorÃ§ A : Alacak N : Finansal Olmayan \n \n \n TR.OHVPS.DataCode.EvetHayir \n E : Evet H : HayÄ±r \n \n \n TR.OHVPS.DataCode.GkdTur \n GKD yapÄ±lmasÄ±nÄ± gerekli bulduÄu durumda HHS, YÃSâÃ¼n belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi GKD yÃ¶ntemini bildirir: Y: YÃ¶nlendirmeli GKD A: AyrÄ±k GKD \n \n \n TR.OHVPS.DataCode.HHSDurumu \n A : AÃ§Ä±k. Ãretim OrtamÄ±nda HHSânin aktif bir Åekilde hizmet vermesi durumu.  Y : YaygÄ±nlaÅtÄ±rma. Ãretim OrtamÄ±nda HHSânin kendisi tarafÄ±ndan tanÄ±mlanmÄ±Å kÄ±sÄ±tlÄ± ÃHKâya hizmet vermesi durumu.    G : GeÃ§ici Hizmet Veremiyor. HHS servislerinde teknik bir sorun olmasÄ± nedeniyle HHSânin hizmet verememesi durumu.  K: KapalÄ±. HHSânin hizmet vermeme durumu. \n \n \n TR.OHVPS.DataCode.HHSYOSSrlmKrtr \n âkodâ : Kod âunvâ : Unvan \n \n \n TR.OHVPS.DataCode.HspDrm \n HesabÄ±n durumunu belirtir: AKTIF PASIF KAPALI \n \n \n TR.OHVPS.DataCode.HspTip \n Hesap Ã§eÅidini belirtir: VADESIZ KREDILI_MEVDUAT_HESABI POS CEK YATIRIM \n \n \n TR.OHVPS.DataCode.HspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.IslemAmaci \n 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aidat Ã¶demesi 12: Gayrimenkul alÄ±m Ã¶demesi 13: Motorlu taÅÄ±t alÄ±m Ã¶demesi 14: BorÃ§ verme/BorÃ§ Ã¶deme 15: Hediye/baÄÄ±Å/yardÄ±m 16: Vergi/resim/harÃ§ Ã¶demesi 17: Tazminat/sigorta Ã¶demesi 18: AvukatlÄ±k/DanÄ±ÅmanlÄ±k/MÃ¼Åavirlik Ãdemesi 19: SaÄlÄ±k Ã¶demesi 20: Kripto/dijital varlÄ±k 21: Åans oyunlarÄ±/bahis Ã¶demesi 22: EÄlence/sosyal medya Ã¶demesi 99: DiÄer \n \n \n TR.OHVPS.DataCode.IslemTuru \n Hesap hareketleri (iÅlemler) sorgusunda dÃ¶nÃ¼len Ä°Ålem TÃ¼rÃ¼ (islTur) parametresi aÅaÄÄ±daki deÄerlerden birini alabilir: HAVALE EFT FAST PARA_YATIRMA PARA_CEKME YABANCI_PARA_HAVALE YATIRIM_HESABINA_AKTARIM YATIRIM_HESABINDAN_AKTARIM KURUM_FATURA_ODEMESI CEK SENET SIGORTA_ODEMESI UCRET_KOMISYON_FAIZ SGK_ODEMESI VERGI_ODEMESI DOVIZ_ALIM DOVIZ_SATIM KREDI_ODEMESI KREDI_KULLANIM KK_ODEMESI KK_NAKIT_AVANS SANS_OYUNU UYE_ISYERI_ISLEMLERI HGS_OGS_ISLEMLERI DOGRUDAN_BORCLANDIRMA_SISTEMI DIGER \n \n \n TR.OHVPS.DataCode.IzinTur \n 01: Temel Hesap Bilgisi 02: AyrÄ±ntÄ±lÄ± Hesap Bilgisi 03: Bakiye Bilgisi 04: Temel Ä°Ålem (Hesap Hareketleri) Bilgisi 05: AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi 06: AnlÄ±k Bakiye Bildirimi 07: Temel Kart Bilgisi 08: DetaylÄ± Kart Bilgisi 09: AyrÄ±ntÄ±lÄ± Kart Ä°Ålem Bilgisi \n \n \n TR.OHVPS.DataCode.KareKodAksTur \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulamalÄ± hizmet alÄ±nan iÅyeri Ã¶demesi 02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulamalÄ± iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n TR.OHVPS.DataCode.KaynakTip \n HESAP_BILGISI_RIZASI  ODEME_EMRI_RIZASI   ODEME_EMRI   ILERI_TARIHLI_ODEME_EMRI_RIZASI   ILERI_TARIHLI_ODEME_EMRI   DUZENLI_ODEME_EMRI_RIZASI  DUZENLI_ODEME_PLANI  DUZENLI_ODEME_EMRI   BAKIYE    COKLU_ISLEM_TALEBI    HHS    YOS   KART_BILGILERI \n \n \n TR.OHVPS.DataCode.KimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) Y , YKN , N11 P , PNO , AN7..9 \n \n \n TR.OHVPS.DataCode.KolasHspTur \n HesabÄ±n bireysel veya ticari nitelikte olduÄunu belirtir: B: Bireysel T: Ticari \n \n \n TR.OHVPS.DataCode.KolasTur \n MÃ¼Återinin sorgulama istediÄi Kolay Adres Tipi deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r: T: Telefon NumarasÄ± E: E-Posta K: TCKN V: VKN Y: YKN P: Pasaport NumarasÄ± \n \n \n TR.OHVPS.DataCode.KurumKimlikTur \n Kod, Tip, Format K , TCKN , N11 M , MNO , AN1..30 (HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ±) V , VKN , AN10 \n \n \n TR.OHVPS.DataCode.LogoArkaPlan \n B :  LogolarÄ±n arka planÄ±nÄ±n beyaz olmasÄ± (Erkek Logo)   K : LogolarÄ±n arka planÄ±nÄ±n renkli/koyu olmasÄ± (DiÅi Logo) \n \n \n TR.OHVPS.DataCode.LogoFormat \n SVG :  Logonun svg formatÄ±nda olmasÄ±nÄ± ifade eder. Logonun 1:2 oranÄ±nda olmasÄ± gerekmektedir.   PNG : Logonun png formatÄ±nda olmasÄ±nÄ± ifade eder. Logonun 500 X 1000 px olmasÄ± gerekmektedir. \n \n \n TR.OHVPS.DataCode.LogoTur \n FULL_LOGO   : YazÄ± ve ikon Åekillerin bir arada olduÄu logo   ICON_LOGO : Ä°kon Åekillerin olduÄu ( Sadece gÃ¶rsel olan-yazÄ±sÄ±z ) logo \n \n \n TR.OHVPS.DataCode.OdemeAmaci \n Ãdemenin AmacÄ±na yÃ¶nelik olarak aÅaÄÄ±daki deÄerlerden birini alÄ±r: 01: Konut KirasÄ± Ãdemesi 02: Ä°Å yeri KirasÄ± Ãdemesi 03: DiÄer Kira Ãdemesi 04: E-Ticaret Ãdemesi: Elektronik ticaret iÅlem amaÃ§lÄ± aktarÄ±mlar 05: ÃalÄ±Åan Ãdemesi: MaaÅ, harcÄ±rah, prim gibi Ã§alÄ±Åan Ã¶demeleri 06: Ticari Ã¶deme: Ticari iÅletmelerin birbirlerine, kendi hesaplarÄ±na veya mÃ¼Återilerine Ã¶demeleri, borÃ§, ithalat, ihracat, Åirket satÄ±n alma, vb. kapsamÄ±nda Ã¶demeler 07: Bireysel Ãdeme: Ãzel amaÃ§lÄ± (aile bireylerine, hediye, baÄÄ±Å, borÃ§, alÄ±ÅveriÅ vs.) Ã¶demeler 08: YatÄ±rÄ±m: Mevduat, menkul kÄ±ymet, dÃ¶viz, gayrÄ± menkul, taÅÄ±t, varlÄ±k alÄ±mÄ±, temettÃ¼ Ã¶deme, tahsilat vb. gibi yatÄ±rÄ±m amaÃ§lÄ± Ã¶demeler 09: Finansal: Kredi, depo, repo, tÃ¼rev, finansal varlÄ±k alÄ±m/satÄ±mÄ± vb. Ã¶demeler 10: EÄitim Ã¶demesi 11: Aid

16at Ã¶demesi 12: Gayrimenkul alÄ±m Ã¶demesi* 13: Motorlu taÅÄ±t alÄ±m Ã¶demesi* 14: BorÃ§ verme/BorÃ§ Ã¶deme* 15: Hediye/baÄÄ±Å/yardÄ±m* 16: Vergi/resim/harÃ§ Ã¶demesi* 17: Tazminat/sigorta Ã¶demesi* 18: AvukatlÄ±k/DanÄ±ÅmanlÄ±k/MÃ¼Åavirlik Ãdemesi* 19: SaÄlÄ±k Ã¶demesi* 20: Kripto/dijital varlÄ±k* 21: Åans oyunlarÄ±/bahis Ã¶demesi* 22: EÄlence/sosyal medya Ã¶demesi*   Liste iÃ§erisinde * ile iÅaretlenen \'Ãdeme AmacÄ±\' deÄiÅiklikleri, TCMB geÃ§iÅ sÃ¼reciyle senkronize Åekilde, 02 Nisan 2026 gÃ¼n sonu ile birlikte devreye alÄ±nacaktÄ±r. \n \n \n TR.OHVPS.DataCode.OdemeDurumu \n Ãdemenin durumunu gÃ¶sterir. AlabileceÄi deÄerler: 01: GerÃ§ekleÅti (Ãdeme ilgili Ã¶deme sistemine iletildi ve alÄ±cÄ± hesabÄ±na ulaÅtÄ±.)  02: GÃ¶nderildi (Ãdeme ilgili Ã¶deme sistemine iletildi ancak alÄ±cÄ± hesabÄ±na ulaÅtÄ±ÄÄ±na dair teyit alÄ±nmadÄ±.)Ä°Ålemin son durumunun teyidi iÃ§in YÃS sorgulama yapmalÄ±dÄ±r. 03- GerÃ§ekleÅmedi (Ãdemenin ilgili Ã¶deme sistemine iÅletiminde veya iÅlenmesi sÄ±rasÄ±nda hata, zaman aÅÄ±mÄ±, sistemin gÃ¼n sonu iÅlemlerine baÅlamasÄ± vb. durum oluÅtu ve Ã¶deme gereÃ§eklemedi veya iade edildi.) 04- Onayda bekliyor (Ãdeme emri veya ileri tarihli Ã¶deme emri alÄ±ndÄ±. Ãoklu onay akÄ±ÅÄ±nÄ±n tamamlanmasÄ± bekleniyor.) 05- Ãdeme Bekleniyor ( Ãdeme Sistemine gÃ¶nderilmeden Ã¶nceki statÃ¼dÃ¼r.) 06- KÄ±smen GerÃ§ekleÅti ( Ä°leri tarihli ve dÃ¼zenli Ã¶deme talimatlarÄ±nda kÄ±smi Ã¶deme yapÄ±lan iÅlemler iÃ§in geÃ§erli statÃ¼dÃ¼r.) 07- Ä°ptal Edildi ( Ãdeme sistemine gÃ¶nderilmeden Ã¶nce mÃ¼Återi ya da herhangi bir sebepten iptal edilen durumlarda kullanÄ±labilir.) \n \n \n TR.OHVPS.DataCode.OdemeKaynak \n I: Ä°nternet bankacÄ±lÄ±ÄÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. A: Otomatik para makineleri (ATM) ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. T: Telefon bankacÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. K: Kiosklar aracÄ±lÄ±ÄÄ±yla gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. S: Åubeden girilen Ã¶demelerde kullanÄ±lÄ±r. M: Mobil uygulamadan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. D: YukarÄ±dakiler dÄ±ÅÄ±ndaki Ã¶deme kaynaklarÄ±ndan gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.  O: AÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r. \n \n \n TR.OHVPS.DataCode.OdemeSistemi \n Ä°Ålemin yÃ¶nlendirildiÄi Ãdeme Sistemine gÃ¶re aÅaÄÄ±daki deÄerlerden birini alabilir: H: Havale F: FAST E: EFT (PÃS) deÄerlerinden birini alabilir. \n \n \n TR.OHVPS.DataCode.OhkTur \n B: Bireysel  K: Kurumsal \n \n \n TR.OHVPS.DataCode.OhkTanimTip \n TCKN: TCKN Â  (ohkTanimDeger N11 olarak gÃ¶nderilmelidir.)  MNO:  Â  Â    HHSâye Ã¶zel bireysel veya kurum mÃ¼Återi numarasÄ± (OHKTanimDeger AN1..30 olarak gÃ¶nderilmelidir. )   YKN:  Â  Â  YabancÄ± Kimlik NumarasÄ± (OHKTanimDeger N11 olarak gÃ¶nderilmelidir.)    PNO:  Â  Â  Pasaport numarsÄ± (ohkTanimDeger AN7..9 olarak gÃ¶nderilmelidir.)    GSM:  Â  Â   Cep telefonu numarasÄ± (ohkTanimDeger N10 olarak gÃ¶nderilmelidir.)   IBAN:  Â  IBAN numarasÄ± (OHKTanimDeger AN26 olarak gÃ¶nderilmelidir.) \n \n \n TR.OHVPS.DataCode.OlayTip \n KAYNAK_GUNCELLENDI  AYRIK_GKD_BASARILI AYRIK_GKD_BASARISIZ HHS_YOS_GUNCELLENDI \n \n \n TR.OHVPS.DataCode.YOSDurumu \n A : AÃ§Ä±k. Ãretim OrtamÄ±nda YÃSâÃ¼n aktif bir Åekilde hizmet vermesi durumu.   G : GeÃ§ici Hizmet Veremiyor. YÃS servislerinde teknik bir sorun olmasÄ± nedeniyle YÃS\'Ã¼n hizmet verememesi durumu.   K: KapalÄ±. YÃS\'Ã¼n hizmet vermeme durumu. \n \n \n TR.OHVPS.DataCode.PSUInitiated \n âEâ : Evet  âHâ : HayÄ±r   âOâ : Olay Bildirim \n \n \n TR.OHVPS.DataCode.RizaDurumu \n B: Yetki Bekleniyor Y: Yetkilendirildi K: Yetki KullanÄ±ldÄ± E: Yetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼ S: Yetki SonlandÄ±rÄ±ldÄ± I :Yetki Iptal \n \n \n TR.OHVPS.DataCode.RizaIptDtyKod \n â01â :Yeni RÄ±za Talebi ile Ä°ptal â02â :KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal â03â :KullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal â04â :SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor â05â :SÃ¼re AÅÄ±mÄ± : Yetkilendirildi â06â :SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi â07â :GKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± â08â :GKD iptali : RÄ±zano ile TCKN uyuÅmamasÄ± â09â :GKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor â10â :GKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± â11â :GKD iptali : Hesap Yetki S

16orunu â12â :GKD iptali : ÃHK HHS kontrollerini aÅamadÄ± â13â :GKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi â14â :GKD iptali : Fraud ÅÃ¼phesi â15â :Hesap RÄ±za GÃ¼ncelleme Talebi ile Ä°ptal  â99â :GKD iptali : DiÄer \n \n \n TR.OHVPS.DataCode.RizaTip \n H: Hesap Bilgisi RÄ±zasÄ± O: Ãdeme Emri RÄ±zasÄ±  I: Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± D: DÃ¼zenli Ãdeme Emri RÄ±zasÄ± \n \n \n TR.OHVPS.DataCode.SrlmYon \n âAâ: Azalan deÄerle sÄ±ralama âYâ: Artan deÄerle sÄ±ralama \n \n \n TR.OHVPS.DataCode.VarYok \n 0 : KayÄ±t Yok   1 : KayÄ±t Var \n \n \n TR.OHVPS.DataCode.YetTip \n AlabileceÄi deÄerlere gÃ¶re hangi belirtecin dÃ¶neceÄine karar verilir. yet_kod yenileme_belirteci \n \n \n TR.OHVPS.DataCode.ZmnAralik \n 0 : KayÄ±t Yok  1 : 0-2 saat 2 : 2 saat 1 dakika-24 saat  3 : 1-3 gÃ¼n   4 : 4-15 gÃ¼n\t  5 : 16 gÃ¼n ve Ã¼stÃ¼ \n \n \n TR.OHVPS.DataCode.HizmetTipi \n 01 :  AyrÄ±k GKD  02 : Ä°leri Tarihli Ãdeme 03 : DÃ¼zenli Ãdeme \n \n \n TR.OHVPS.DataCode.OdemePeriyodu \n G :  GÃ¼nlÃ¼k  H : HaftalÄ±k A : AylÄ±k D : DiÄer \n \n \n TR.OHVPS.DataCode.KartTip \n B : Banka KartÄ±  K : Kredi KartÄ± P : Ãn Ãdemeli(Prepaid) Kart \n \n \n TR.OHVPS.DataCode.AltKartTip \n A : AsÄ±l  E : Ek Kart S : Sanal Kart \n \n \n TR.OHVPS.DataCode.KartStatu \n A : AÃ§Ä±k/Aktif  P : Pasif I : Ä°ptal \n \n \n TR.OHVPS.DataCode.IslemPuanDurumu \n 01 : Puan KazanÄ±mÄ±  02: Puan KullanÄ±mÄ±  03: Puan Ä°ade  04: Puan Ä°ptal \n \n \n TR.OHVPS.DataCode.KartSema \n T : TROY  M : Mastercard V : Visa U : UnionPay A : American Express J : JCB \n \n \n TR.OHVPS.DataCode.KartTuru \n B : Bireysel  T :Ticari \n \n \n TR.OHVPS.DataCode.KartFormu \n F : Fiziksel  D :Dijital \n \n \n TR.OHVPS.DataCode.EkstreStatu \n A : Aktif  P : Pasif \n EK-3: Ä°stemci SertifikalarÄ±nÄ±n TanÄ±m ve YÃ¶netimi \n TÃ¼m katÄ±lÄ±mcÄ±larÄ±n GEÃÄ°T\'e eriÅebilmesi iÃ§in, BKM tarafÄ±ndan yapÄ±lan istemci sertifika doÄrulamasÄ±ndan geÃ§mesi gerekmektedir. Ä°stemci sertifikasÄ± Ã¼retilmeden Ã¶nce katÄ±lÄ±mcÄ±larÄ±n CSR Ã¼retme akÄ±ÅÄ±nÄ± tamamlamasÄ± gerekmektedir. \n OpenSSL ile CSR (Certificate Signing Request) OluÅturma \nAÅaÄÄ±daki komut ile 2048-bit RSA private key ve CSR oluÅturulur. \nopenssl req -new -newkey rsa:2048 -nodes -keyout PRIVATEKEY.key -out CSR.csr \n CSR ile ilgili detay bilgilerin giriÅinde; \nCommon Name (CN) olarak 4 karakterli hhsKod ya da yosKod deÄeri ile, \ndiÄer alanlar iÃ§in de kurum bilgileriniz ile giriÅ yapÄ±lÄ±r. \n TÃ¼m bilgilerin girilmesinden sonra oluÅan private key dosyasÄ± kurumunuzda saklanÄ±r.\nCSR dosyasÄ± ise istemci sertifika Ã¼retmek Ã¼zere kullanÄ±lÄ±r. Bu aÅamada takip edilmesi gereken adÄ±mlar Åu Åekildedir: \n KatÄ±lÄ±mcÄ±larÄ±n, TRIP ortamÄ± Ã¼zerinden, BKM TarafÄ±ndan yetki verilmiÅ kullanÄ±cÄ±larÄ±nÄ±n gÃ¶rebileceÄi "Ä°stemci Sertifika Talebi" menÃ¼ adÄ±mÄ±na giriÅ yapmalarÄ± beklenir. AÃ§Ä±lan ekranda,"CSR DosyasÄ± YÃ¼kleme" alanÄ± iÃ§erisine, katÄ±lÄ±mcÄ±nÄ±n Ã¼retmiÅ olduÄu csr dosyasÄ± yÃ¼klenir. YaklaÅÄ±k 1 dakika iÃ§erisinde kuruma Ã¶zel olarak Ã¼retilmiÅ olan client sertifikasÄ± indirilmeye hazÄ±r hale gelecektir. "Ä°ndir" butonu ile client sertifika indirilir. Ä°stemci tarafÄ±nda web isteÄinin ilgili sertifika ile iliÅkilendirilerek oluÅturulmasÄ± gerekmektedir. \n Uzun dÃ¶nemli olarak hazÄ±rlanacak olan sertifikalar sertifikasyon ve Ã¼retim ortamlarÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi bu aÅamalarda sÄ±nanacaktÄ±r. \n GEÃÄ°T\'in test ve Ã¼retim ortamlarÄ± ayrÄ±mÄ±nda istemci sertifikalarÄ±, HHS Listeleme API eriÅimleri ve Sertifikasyon baÄlantÄ±larÄ± Åekil 15-HHS/YÃS API Mimarisi DiagramÄ±nda resmedilmiÅtir. \n EK-4: Sunucu SertifikalarÄ± \n Sunucu sertifikalarÄ±nÄ±n endpoint bilgisini (Fqdn) iÃ§erecek ve global bir Certification Authority tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir.\nÃrneÄin; entegrasyon formu iÃ§erinde yer alan URL bilgisinin (test.xbank.com.tr) sertifika iÃ§erisinde tanÄ±mlÄ± olmasÄ± ve bu sertifikanÄ±n global bir CA Ã¶rneÄin Verisign tarafÄ±ndan imzalanmÄ±Å olarak sunulmasÄ± gerekmektedir. \n Hizmet saÄlayÄ±cÄ± olan HHS\'ler tarafÄ±ndan sunucu sertifikalarÄ± uygulanmalÄ±dÄ±r. \n EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ± \n Dijital imzalama yapÄ±sÄ±,

16ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini saÄlamak amacÄ±yla kurgulanmÄ±ÅtÄ±r.  Ä°mzalarÄ±n kaynak bazÄ±nda hangi istek ve yanÄ±tlara uygulandÄ±ÄÄ± belirlidir. \n API yalnÄ±zca TLS\'ye dayanÄ±rsa, dijital kayÄ±tlarÄ± ve inkÃ¢r edilemezlik kanÄ±tlarÄ±nÄ± tutmak zor olur. Bu nedenle, TLS\'ye dayanmayan bir inkÃ¢r edilemezlik Ã§Ã¶zÃ¼mÃ¼ olarak API isteÄinin HTTP baÅlÄ±ÄÄ±nda bir JWS kullanÄ±larak saÄlanabilir. \n HTTP isteÄinin gÃ¶vdesinin hash fonksiyonu (SHA256) ile Ã¶zeti alÄ±nacaktÄ±r. Elde edilen Ã¶zet, asimetrik anahtarlarÄ± destekleyen bir algoritma kullanÄ±larak imzalanacak ve JWS elde edilecektir. Ä°steÄin kendinize geldiÄi durumda body Ã¼zerinde hiÃ§ bir deÄiÅikliÄe tabi tutmadan (serialize/deserialize, minify, trim, vb yapmadan) doÄrulama yapmanÄ±z gerekmektedir. AynÄ± Åekilde isteÄin kendinizden Ã§Ä±ktÄ±ÄÄ± aÅamada da response body Ã¼zerinde hiÃ§ bir deÄiÅikliÄe tabi tutmadan (serialize/deserialize, minify, trim, vb yapmadan) mesaj imzalama yapÄ±lmalÄ±dÄ±r. \n Bu kapsamda imzalama akÄ±ÅÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r: \n \n HHS ve YÃS Ã¶ncelikle Ã¶zel ve aÃ§Ä±k anahtarlarÄ±nÄ± oluÅturmalÄ±dÄ±r. Bu anahtarlarÄ± oluÅturmak iÃ§in aÅaÄÄ±da âopensslâ kullanÄ±larak oluÅturma Ã¶rneÄi paylaÅÄ±lmÄ±ÅtÄ±r. Bu anahtarlardan Ã¶zel olan anahtar mesajÄ± imzalamak iÃ§in kullanÄ±lacak olup, aÃ§Ä±k anahtar ise mesajÄ± doÄrulamak amacÄ±yla mesajÄ±n alÄ±cÄ±sÄ± tarafÄ±ndan kullanÄ±lacaktÄ±r. \n \n Ãzel anahtarÄ±n oluÅturulmasÄ±. private.pem => Ãzel anahtar  \n openssl genrsa -out private.pem 2048 \n Ãzel anahtardan aÃ§Ä±k anahtarÄ±n oluÅturulmasÄ±. public_key.pem => AÃ§Ä±k anahtar (BKM ile paylaÅÄ±lacak aÃ§Ä±k anahtar) \n openssl rsa -in private.pem -pubout -outform PEM -out public_key.pem \n Opsiyonel olarak Ã¶zel anahtarÄ±n PCKS8 formatÄ±na Ã§evrilmesi (Java aÃ§Ä±sÄ±ndan PCKS8 formatÄ±nda olma ihtiyacÄ± nedeniyle). private_key.pem => Ãzel anahtarÄ±n formatlanmÄ±Å hali.  \n openssl pkcs8 -topk8 -inform PEM -in private.pem -out private_key.pem ânocrypt \n \n \n AÃ§Ä±k ve Ãzel anahtarlar oluÅturulduktan sonra AÃ§Ä±k Anahtar BKM ile paylaÅÄ±lÄ±r. BKM bu aÃ§Ä±k anahtarÄ± diÄer katÄ±lÄ±mcÄ±larÄ±n ulaÅabilmesi ve alabilmesi iÃ§in bir Anahtar Deposu yaklaÅÄ±mÄ± ile bÃ¼nyesinde tutar. Ä°lgili anahtarÄ± iletebilmek ve alabilmek iÃ§in kullanÄ±lacak HHS/YOS API ye eriÅim detaylarÄ± EK-6 bÃ¶lÃ¼mÃ¼nde detaylÄ± olarak paylaÅÄ±lmÄ±ÅtÄ±r.  EÄer kurumun ilgili anahtar Ã§iftinin yenilenme durumu sÃ¶z konusu ise yenilemenin hemen ardÄ±ndan aÃ§Ä±k anahtar yeni bir imzalama yapÄ±lmadan Ã¶nce mutlaka BKM ile paylaÅÄ±lmalÄ±dÄ±r. \n \n \n Ä°mzalÄ± mesajÄ± aÃ§acak olan kurum mesajÄ± imzalayan kurumun aÃ§Ä±k anahtarÄ±nÄ± her sorguda yeniden almak durumunda deÄildir. Belirli periyodlarda kendi ortamÄ±ndaki anahtarÄ± yenileyerek sistemi iÅletebilir. Ancak imzalayan kurum anahtar Ã§ifti yenilemesi yaptÄ±ÄÄ±nda BKM ile aÃ§Ä±k anahtarÄ±nÄ± paylaÅsa dahi imzalÄ± mesajÄ± doÄrulayacak taraf eski aÃ§Ä±k anahtar ile doÄrulama yapmaya Ã§alÄ±ÅtÄ±ÄÄ± iÃ§in hata alacaktÄ±r. Bu ilk hata durumunda hÄ±zlÄ±ca BKM Ã¼zerinden yeni anahtarÄ± alÄ±p mesajÄ± tekrar doÄrulamayÄ± denemelidir. EÄer yine hata alÄ±yor ise doÄrulama iÅlemini hata statÃ¼sÃ¼ne almalÄ±dÄ±r. Bu sebeple anahtar yenileyen kurum yeni aÃ§Ä±k anahtarÄ±nÄ± yeni bir mesaj imzalama yapmadan Ã¶nce mutlaka BKM ile paylaÅmalÄ±dÄ±r. \n \n \n PSU-Fraud-Check alanÄ± iÃ§in de JWT formatÄ±nda Ã§Ä±ktÄ± hazÄ±rlanmasÄ± beklenmektedir. Ãrnek bir PSU-Fraud-Check payload deÄeri aÅaÄÄ±daki gibidir; \n {"AnomalyFlag": "0", \n"LastPasswordChangeFlag": "1", \n"FirstLoginFlag": "1", \n"DeviceFirstLoginFlag": "1", \n"BlacklistFlag": "0", \n"MalwareFlag": "0", \n"UnsafeAccountFlag": "0", \n"exp": 1663424479, \n"iat": 1663338079, \n"iss": "[https://apigw.bkm.com.tr|https://apigw.bkm.com.tr/]" } \n Ä°mzalama KurallarÄ± (YÃS) \n Bir YÃS Ã¼zerinden baÅlayan akÄ±Å Ã¶rnek olarak paylaÅÄ±lmÄ±ÅtÄ±r. \n \n \n YÃS, mesaj imzalama gerektiren her API isteÄinin HTTP gÃ¶vdesini (request body) kendi Ã¶zel anahtarÄ± ile Åifreleyerek imza bilgisini oluÅturur. \n \n \n ArdÄ±ndan bu imza verisini, gÃ¶ndereceÄi mesajÄ±n istek baÅlÄ±ÄÄ±nda yer alan X-JWS-Signature alanÄ±nda gÃ¶ndermelidir. \n \n \n X-JWS-Signature alanÄ±nda gÃ¶nderilecek olan bilgi aÅaÄÄ±daki yÃ¶ntem ile oluÅturulmalÄ±dÄ±r. \n \n \n Bu alana yazÄ±lacak olan bilgi JWT formatÄ±nda oluÅturulmalÄ±dÄ±r. \n \n \n Bir JWT, header-payload-signature alanlarÄ±ndan oluÅmaktadÄ±r. \n \n Header alanÄ±nda JWTâyi imzalamak iÃ§in kullanÄ±lacak algoritma belirtilmelidir.  Standartlar kapsamÄ±nda RS256 kullanÄ±lacaktÄ±r. \n Payload kÄ±smÄ±nda Ã¶zel olarak oluÅturulacak olan âbodyâ claim alanÄ±na istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ± yazÄ±lmalÄ±dÄ±r. \n JSON payload oluÅturulurken RFC 7519 baz alÄ±nmalÄ±dÄ±r. "iss" (Issuer) Claim, "exp" (Expiration Time) Claim, "iat" (Issued At) Claim, âbodyâ Claim alanlarÄ±nÄ±n gÃ¶nderilmesi zorunludur. ^RFC7519 \na.\t"iss" (Issuer) Claim : Kurumunuza Ã¶zel bilgidir. \nb.\t"exp" (Expiration Time) Claim: Saniye cinsinden (Unix time) imzanÄ±n son geÃ§erli olduÄu tarih. Bu tarih  mevcut sunucu saatinizden 60 dakika sonra olacak Åekilde kullanÄ±lmalÄ±dÄ±r. \nc.\t"iat" (Issued At) Claim : Saniye cinsinden (Unix time) imzanÄ±n oluÅturulduÄu tarih. Bu tarih  mevcut sunucu saatinizden 5 dakika Ã¶nce olacak Åekilde kullanÄ±lmalÄ±dÄ±r. \nd.\tâbodyâ Claim : istek gÃ¶vdesi (request body) verisinin SHA256 hash deÄeri karÅÄ±lÄ±ÄÄ±. \n Signature alanÄ±nda da Ã¶zel anahtar ile imzalanmÄ±Å olan imza iÃ§eriÄi yer alacaktÄ±r. \n \n X-JWS-Signature:   JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir. \n Ãrnek X-JWS-Signature Payload DeÄeri \n { \n"iss": "https://apigw.bkm.com.tr", \n"exp": 1646832405, \n"iat": 1646746005, \n"body": "c543072f97a761a1d891dc81acc380bc1e6f61ca6541bd93ebfdece338457922" \n} \n \n \n \n \n YÃS, isteÄi gÃ¶nderir. Sadece mesajÄ±n bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ ve doÄruluÄunu teyit amacÄ± ile istek gÃ¶vdesi (request body) SHA256 hash deÄeri imzalanarak X-JWS-Signature alanÄ±nda bu imza iletilir. Ä°steÄin gÃ¶vde (request body) kÄ±smÄ± aÃ§Ä±k ve Åifresiz olarak gÃ¶nderilmektedir. \n \n \n HHS, isteÄi alÄ±r, talebi gerÃ§ekleÅtirmeden Ã¶nce aldÄ±ÄÄ± API isteklerinin imzasÄ±nÄ± doÄrulamalÄ±dÄ±r. X-JWS-Signature alanÄ±ndaki JWT aÅaÄÄ±daki adÄ±mlarla doÄrulanmalÄ±dÄ±r. \n \n Header kÄ±smÄ±ndaki algoritmanin RS256 olduÄu kontrol edilir. \n GÃ¶nderen kurumun aÃ§Ä±k anahtarÄ± ile JWT verify (doÄrulama) iÅlemi yapÄ±lÄ±r. \n YukarÄ±daki iÅlemlerin doÄruluÄunun ardÄ±ndan JWTânin payload kÄ±smÄ±ndaki âbodyâ claim alanÄ±ndaki bilginin, isteÄin gÃ¶vde verisinin SHA256 hash deÄerlerinin aynÄ± olduÄu kontrol edilir. \n Ãrnek checksum deÄeri   "a64b19f95eeb1fb0a0a3e2dbbc6e3d8472c52184d4543417ddc6d156fc5c5571" veya   "A64B19F95EEB1FB0A0A3E2DBBC6E3D8472C52184D4543417DDC6D156FC5C5571" Åeklinde olabilir. Ä°ki hali de aynÄ± deÄere sahiptir. Kontrollerde buna dikkat edilmesi gerekmektedir. \n \n \n \n YukarÄ±daki iÅlemler ile doÄruluÄu teyit edilmiÅ olan isteÄin talebi gerÃ§ekleÅtirir. \n \n \n EÄer istek doÄrulanamÄ±yor ise gÃ¶nderen kurumun aÃ§Ä±k ve Ã¶zel anahtar Ã§ifti yenilenmiÅ olabilir. \n \n \n BKM HHS API  Ã¼zerinden ilgili kurumun bilgilerini (kurum ko

16du vs) kullanarak kurumun detay bilgileri Ã§eker ve kendi ortamÄ±nda yeniler. \n \n \n ArdÄ±ndan imzayÄ± tekrar aÃ§Ä±k anahtar ile doÄrulayarak kontroller gerÃ§ekleÅtirilir. (EÄer halen doÄrulama iÅlemi baÅarÄ±sÄ±z ise bu istek iÃ§in hata akÄ±ÅÄ± Ã§alÄ±ÅtÄ±rÄ±lÄ±r.  TR.OHVPS.Resource.InvalidSignature  kodu ile hata Ã¼retilebilir.) \n \n \n Ä°mza bilgisinin beklendiÄi (x-jws-signature) servislerde, bu bilginin iletilmediÄi durumlarda  TR.OHVPS.Resource.MissingSignature  hatasÄ± Ã¼retilebilir. \n \n \n HHS isteÄi iÅledikten sonra cevabÄ± oluÅtururken de yukarÄ±daki akÄ±Ålar ile gÃ¶ndereceÄi cevabÄ± imzalamalÄ±dÄ±r. \n \n \n Ä°stek yanÄ±t gÃ¶vdesinin SHA256 checksum deÄeri iÃ§in hexadecimal Ã§Ä±ktÄ± kullanÄ±lacaktÄ±r. OluÅacak Ã§Ä±ktÄ±nÄ±n 64 karakter olmasÄ± beklenmektedir. Kontrol iÃ§in "^[A-Fa-f0-9]{64}$" RegEx tarifini kullanabilirsiniz. \n \n \n Ãrnek bir gÃ¶vde: \n {"katilimciBlg":{"hhsKod":"8000","yosKod":"8000"},"gkd":{"yetYntm":"Y","yonAdr":"https://boss-test.bkm.com.tr/boss/ab/yosSimulator/8000?drmKod=6021de9f-55e7-454a-94be-2044866b22e1"},"kmlk":{"kmlkTur":"M","kmlkVrs":"123456","ohkTur":"B"},"hspBlg":{"iznBlg":{"iznTur":["01","02","03","04","05"],"erisimIzniSonTrh":"2022-10-12T23:59:59+03:00","hesapIslemBslZmn":"2021-10-10T00:00:00+03:00","hesapIslemBtsZmn":"2023-10-10T23:59:59+03:00"}}}\n \n Bu gÃ¶vdenin checksum\'Ä±: \n a64b19f95eeb1fb0a0a3e2dbbc6e3d8472c52184d4543417ddc6d156fc5c5571\n \n Bu checksum\'Ä±n iletildiÄi x-jws-signature baÅlÄ±k deÄeri: \n eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwczovL2FwaWd3LmJrbS5jb20udHIiLCJleHAiOjE2NjU0NzU1NjIsImlhdCI6MTY2NTM4OTE2MiwiYm9keSI6ImE2NGIxOWY5NWVlYjFmYjBhMGEzZTJkYmJjNmUzZDg0NzJjNTIxODRkNDU0MzQxN2RkYzZkMTU2ZmM1YzU1NzEifQ.Q65PI_1fTEzzBMirvmJvXgVX3orhhZ4_UqujtGdHkU7me-1ymIjvPrzy3kfyER1pedFb7HDCBuPvYoqjX8eUnpiiZsxfzCiEa0McIhoFeUOggq-O8VihItp8bLr2DWwQ9JHN1-WXB2mL31KAKFAL1VY9-DXuAdT-RfE_SLYsl2ycmNy4ti4XvfDvvlE56ZsieFZ727VuwR8wi7F0kKDc6UhjaMF9xcUeAM1fxX-bmcOaOo1NZGC0vvgjNZKz_OJrN-q8VhWYnQPiJ7wY7S9IG8bHIkBImKSVf8LuOEvl8u0BZzADLH1iOBd9x2l1plyI_NLPTrnOqhWhKlljkkJBCg\n \n EÄer PSU-Fraud-Check iÃ§in baÅlÄ±k gÃ¶nderilecekse, yine JWT formatÄ±nda imza Ã¼retilmelidir. Ãrnek bir psu-fraud-check baÅlÄ±k deÄeri: \n eyJhbGciOiJSUzI1NiJ9.eyJBbm9tYWx5RmxhZyI6IjAiLCJMYXN0UGFzc3dvcmRDaGFuZ2VGbGFnIjoiMSIsIkZpcnN0TG9naW5GbGFnIjoiMSIsIkRldmljZUZpcnN0TG9naW5GbGFnIjoiMSIsIkJsYWNrbGlzdEZsYWciOiIwIiwiTWFsd2FyZUZsYWciOiIwIiwiVW5zYWZlQWNjb3VudEZsYWciOiIwIiwiZXhwIjoxNjY1NDc1NTU2LCJpYXQiOjE2NjUzODkxNTYsImlzcyI6Imh0dHBzOi8vYXBpZ3cuYmttLmNvbS50ciJ9.DhUh_nsXDuNIrvsQ3KOhOXdVcJg6fTDVW8K1oea8kLtmb7n-_hJHY3mWX5zzobu-Vh2VvFzIxPhHtol6gLHFktmIMiQ9TDHb_mRZFXgJB4ToNfqc3Fy9mi5bS8By2IYi1HxDaCStstaZDaunzXfHCtqybfZXyk6teDrf-iIf6lqX9Keo7GZO-Y7mP7C13-c_QwyNKrZK4TZwUQbecRqXYn1DcEHM7kukQHTar_hKBWkXPmNpScY0J2rKksr4ejR1uLhdQm-Pdwoe9y6qrNEB79vMLBkRNtbuV0vc1GYHp_YKkzBKBI_58uuB2GD9877CsrcRnHMQb88xpxiPKh6-ew\n EK-6: HHS/YÃS API Mimarisi \n HHS/YÃS API Uygulama Mimarisinde Test ve Ãretim ortamlarÄ±nda aÅaÄÄ±daki alanda yer almaktadÄ±r. \n \n Åekil 15: HHS/YÃS API Mimarisi \n'},{title:"8.\tDÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v2.0.1/contents/duzenli-odeme-emri-hizmeti.html",relativePath:"v2.0.1/contents/duzenli-odeme-emri-hizmeti.md",key:"v-1d292df6",path:"/v2.0.1/contents/duzenli-odeme-emri-hizmeti.html",headers:[{level:2,title:"DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"duzenli-odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"8.1.\tADIM 0 - DÃ¼zenli Ãdeme Emri RÄ±zasÄ± BaÅlatma IsteÄi",slug:"_8-1-adim-0-duzenli-odeme-emri-rÄ±zasÄ±-baslatma-istegi"},{level:2,title:"8.2.\tADIM 1 - DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_8-2-adim-1-duzenli-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"8.3.\tADIM 2- DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_8-3-adim-2-duzenli-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"8.4.\tADIM 2.1 â DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_8-4-adim-2-1-duzenli-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"8.5.\tADIM 3- Duzenli Ãdeme Emrinin OluÅturulmasÄ±",slug:"_8-5-adim-3-duzenli-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"8.6.\tADIM 3.1- Duzenli Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_8-6-adim-3-1-duzenli-odeme-emri-sorgusu-istege-baglÄ±"},{level:2,title:"8.7.\tADIM 4- DÃ¼zenli Ãdeme PlanÄ± Sorgulama",slug:"_8-7-adim-4-duzenli-odeme-planÄ±-sorgulama"},{level:2,title:"8.8.\tADIM 5- DÃ¼zenli Ãdeme Emri RÄ±za Ä°ptali",slug:"_8-8-adim-5-duzenli-odeme-emri-rÄ±za-iptali"}],content:" 8.\tDÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti \n Ãdeme hizmeti kullanÄ±cÄ±sÄ±nÄ±n dÃ¼zenli tekrar eden bir Ã¶deme talimatÄ± gerÃ§ekleÅtirmek istediÄi Ã¶deme emirlerinde bu hizmeti kullanabilir. Ãdemenin Havale / PÃS / FAST Ã¶deme sistemlerinden hangisi ile gerÃ§ekleÅeceÄine, Ã¶deme gÃ¼nÃ¼ geldiÄinde HHS karar verir. \n DÃ¼zenli Ã¶deme hizmetini online bankacÄ±lÄ±k sistemlerinde sunan HHS'lerin, ÃHVPS Ã¼zerinden bu hizmetleri sunmasÄ± zorunludur. Mevcutta online kanallarÄ±ndan bu hizmeti sunduklarÄ± mÃ¼Återi segmentine (bireysel,kurumsal vb.), ÃHVPS Ã¼zerinden hizmet sunmaya devam etmeleri gerekmektedir. YÃS, bireysel mÃ¼Återi Ã¶zelinde dÃ¼zenli Ã¶deme hizmeti vermeyen HHS'ye dÃ¼zenli Ã¶deme talimatÄ± rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.IndividualCustomerNotSupported  hatasÄ± , kurumsal mÃ¼Återi Ã¶zelinde dÃ¼zenli Ã¶deme talimatÄ± rÄ±zasÄ± isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  TR.OHVPS.Business.CorporateCustomerNotSupported  hatasÄ± verilmelidir. \n HHS'ler dÃ¼zenli Ã¶deme hizmetini sunuÅ bilgilerini HHS API aracÄ±lÄ±ÄÄ± ile yayÄ±nlayacaklardÄ±r. YÃS, dÃ¼zenli Ã¶deme hizmeti baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\":\"03\" parametresi ile alabilir. YÃS, dÃ¼zenli Ã¶deme hizmeti sunmayan HHS'ye dÃ¼zenli Ã¶deme talimat rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.RegularPaymentOrderNotSupported  hatasÄ±

16iletilmelidir. \n DÃ¼zenli Ã¶deme emri hizmetinde TRY dÄ±ÅÄ±ndaki yabancÄ± para birimleri iÃ§in HHS tarafÄ±ndan destek verilmemesi durumunda  TR.OHVPS.Business.InvalidCurrencyCode  hataasÄ± verilmelidir. \n DÃ¼zenli Ã¶deme talimatÄ± gÃ¼ncelleme hizmeti YÃS Ã¼zerinden yapÄ±lamayacaktÄ±r. ÃHK aktif olan dÃ¼zenli Ã¶deme talimat rÄ±zasÄ±nÄ± iptal ederek, yeniden oluÅturabilecektir. \n HHS Ã¼zerinden ilgili gÃ¼ncelleme hizmeti saÄlanabilir. Ãdeme planÄ±nda yapÄ±lan gÃ¼ncelleme sonucunda olay bildirim ile YÃS'e bildirim saÄlanacaktÄ±r. HHS Ã¼zerinden gÃ¼ncelleme yapÄ±lÄ±rken son Ã¶deme gÃ¼nÃ¼ iÃ§in ileri bir tarihe gÃ¼ncelleme adÄ±mÄ± olmamalÄ±dÄ±r. Sadece ilk oluÅturulan dÃ¼zenli Ã¶deme emri iÃ§erisindeki son Ã¶deme gÃ¼nÃ¼nden Ã¶ncesi olacak Åekilde gÃ¼ncelleme yapÄ±lmasÄ±na izin verilmelidir. \n DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n DÃ¼zenli Ãdeme Emri RÄ±zasÄ± BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± baÅlatÄ±r. \n DÃ¼zenli Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âDÃ¼zenli Ãdeme Emri RÄ±zasÄ± BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve dÃ¼zenli Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n DÃ¼zenli Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âdÃ¼zenli Ã¶deme emriâni HHSâye iletir. \n DÃ¼zenli Ãdeme Emri RÄ±za Durumu, DÃ¼zenli Ãdeme Emri Durumu, DÃ¼zenli Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, DÃ¼zenli Ãdeme Emri RÄ±za Durumu, DÃ¼zenli Ãdeme Emri Durumu, DÃ¼zenli Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n DÃ¼zenli Ãdeme PlanÄ± SorgularÄ±:  ÃBHS, DÃ¼zenli Ãdeme Emri iÃ§in oluÅturulan talimata dair Ã¶deme planÄ±nÄ± sorgulayabilir. \n \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±)  mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin hem HBH hem de ÃBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini(Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n YÃS'ler gÃ¶nderen hesap seÃ§imini aÅaÄÄ±daki yÃ¶ntemlerden biri ya da birkaÃ§Ä± ile saÄlayabilirler: \n \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± HHS ekranÄ±ndan seÃ§tirebilir. \n YÃS, mÃ¼Återisinden Hesap Bilgisi rÄ±zasÄ± alÄ±r. RÄ±za aldÄ±ÄÄ± hesaplar Ã¼zerinden hesap referansÄ± aracÄ±lÄ±ÄÄ± ile dÃ¼zenli Ã¶deme emri baÅlatabilir. \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± elle girmesine olanak tanÄ±yabilir. IBAN'Ä± olmayan HHS'ler dÃ¼zenli Ã¶deme emri rÄ±zasÄ± adÄ±mÄ±nda  TR.OHVPS.Business.IBANNotSupported  hatasÄ±nÄ± vermelidir. IBAN'Ä± olan HHS'lerin bu akÄ±ÅÄ± desteklemesi zorunludur. \n YÃS; mÃ¼Återisinin hesap referansÄ±nÄ± elle girmesini saÄlayabilir. Hesap ReferansÄ± bilgisi ile baÅlatÄ±lan dÃ¼zenli Ã¶deme emri iÅlemlerinde HHS seÃ§imi zorunludur. \n \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in, YÃS'ler hesap referansÄ± ile Ã¶deme baÅlatabilirler. BunlarÄ±n dÄ±ÅÄ±ndaki HHS'lerin, gÃ¶nderen IBAN veya hesap referansÄ± ile Ã¶deme akÄ±ÅÄ±nÄ± desteklemesi zorunludur. \n DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. Ãdeme Emri Hizmeti ile aynÄ± etki alanÄ±(scope) kullanÄ±lmaktadÄ±r. \n Tablo : DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n duzenli-odeme-emri-rizasi \n POST \n /duzenli-odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n DuzenliOdemeEmriRizasiIstegi \n DuzenliOdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 3 \n duzenli-odeme-emri-rizasi \n GET \n /duzenli-odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n DuzenliOdemeEmriRizasi \n \n \n 4 \n duzenli-odeme-emri \n POST \n /duzenli-odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n DuzenliOdemeEmriIstegi \n DuzenliOdemeEmri \n \n \n 5 \n duzenli-odeme-emri \n GET \n /duzenli-odeme-emri

16/{talimatNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n DuzenliOdemeEmri \n \n \n 6 \n duzenli-odeme-emri-rizasi-iptal \n DELETE \n /duzenli-odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n - \n - \n - \n \n \n 7 \n duzenli-odeme-talimat-plani \n GET \n /duzenli-odeme-emri/{talimatNo}/odeme-plani \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n DuzenliOdemeEmriPlani \n 8.1.\tADIM 0 - DÃ¼zenli Ãdeme Emri RÄ±zasÄ± BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) dÃ¼zenli Ã¶deme emri rÄ±zasÄ± sÃ¼recini baÅlatÄ±r. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 8.2.\tADIM 1 - DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil : DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (DuzenliOdemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ olduÄu geÃ§it tarafÄ±ndan kontrol edilir. \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahipliÄi geÃ§it tarafÄ±ndan kontrol edilir. \n HHS tarafÄ±ndan, istek baÅlÄ±ÄÄ±ndaki x-aspsp-code ile katilimciBlg iÃ§erisinde yer alan hhsKod deÄeri ile aynÄ± olduÄunu kontrol edilir. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, dÃ¼zenli Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren DuzenliOdemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1 HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /duzenli-odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir DuzenliOdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, dÃ¼zenli Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n YÃS, dÃ¼zenli Ã¶deme hizmeti sunmayan (HHS API'de yer alan \"hizmetTipi\":\"03\" yok ise) HHS'ye dÃ¼zenli Ã¶deme talimat rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.RegularPaymentOrderNotSupported  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hata kodu iletilmeli ve fieldErrors dolu olacak Åekilde hatalÄ± alanÄ± belirten detaylÄ± aÃ§Ä±klama gÃ¶nderilmelidir. InvalidFormat hata kodlarÄ±nda fieldErrors iÃ§eriÄi gÃ¶nderilmeli ve anlaÅÄ±lÄ±r aÃ§Ä±klama ile message, messageTr alanlarÄ± doldurulmasÄ± zorunludur. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS, bireysel mÃ¼Återi Ã¶zelinde dÃ¼zenli Ã¶deme hizmeti vermeyen HHS'ye dÃ¼zenli Ã¶deme talimatÄ± rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.IndividualCustomerNotSupported\"  hatasÄ± , kurumsal mÃ¼Återi Ã¶zelinde dÃ¼zenli Ã¶deme talimatÄ± rÄ±zasÄ± isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CorporateCustomerNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme adresleri ile dÃ¼zenli Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini y

16apar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.TPPRedirectionAddressMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; kimlik bilgileri nesnesinde yer alan kimlik bilgileri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (KoÅullu Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.CustomerNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n âAÃ§Ä±k BankacÄ±lÄ±k Kanal Yetkiâ tanÄ±mÄ± yok ise  \"TR.OHVPS.Business.OpenBankingChannelClosed\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir. \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.DecoupledAuthenticationNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  \"TR.OHVPS.Business.EventSubscriptionNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin, ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerInfoMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerMobileApplicationNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n HHS kimlik bilgisi ile gÃ¶nderen Ã¼nvanÄ±nÄ±n uyumlu olduÄunu kontrol eder. HHS'ler EFT/FAST iÅlemlerinde kabul ettikleri kontrol kriterleri ile iÅleme izin verebilirler. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.IncorrectSenderTitle\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n GÃ¶nderen Hesap NumarasÄ± ÃBHS tarafÄ±ndan iletildiÄi durumda;\n \n IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.InvalidAccount\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountCodeMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu kontrol edilir.Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.CustomerAccountMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. (Ä°lgili hesabÄ±n para transfer iÅlemine yetkisi olmamasÄ±) Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountUnauthorized\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâde gÃ¶nderen hesabÄ±n aktifliÄi kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountInactive\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n GÃ¶nderen hesap numarasÄ± iÃ§in, Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile dÃ¼zenli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  \"TR.OHVPS.Business.ActiveConsentNotFound\"  hatasÄ± verilmelidir. \n DÃ¼zenli Ã¶deme emri rÄ±zasÄ±nda alÄ±cÄ± hesap bilgileri Karekod ya da Kolas ile belirlenebilir. HHS online kanallarÄ±nda dÃ¼zenli Ã¶deme hizmetini Karekod ve Kolas aracÄ±lÄ±ÄÄ± ile kabul ediyorsa, ÃHVPS servisleri ile de kabul etmek zorundadÄ±r. YÃS tarafÄ±ndan dÃ¼zenli Ã¶deme emri rÄ±zasÄ± isteÄi iÃ§erisinde alÄ±cÄ± bilgisi iÃ§in karekod ya da kolas kompleks alanlarÄ± yer almasÄ± durumunda , destek vermeyen HHS'ler tarafÄ±ndan  \"TR.OHVPS.Business.RecipientAccountTypeNotSupported\"  hatasÄ± verilmelidir. \n AlÄ±cÄ± ve gÃ¶nderen hesabÄ±n aynÄ± olmasÄ± durumunda  âTR.OHVPS.Business.SenderRecipientSameâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n MÃ¼Återinin kendi hesaplarÄ± arasÄ±nda talimat veremeyeceÄi durumlarÄ±n kontrolÃ¼ iÃ§in  âTR.OHVPS.Business.SameAccountTransferRestrictedâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, DuzenliOdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n Bu aÅamada ÃHKânÄ±n HHS tarafÄ±ndan tanÄ±mlanmÄ±Å ve isteÄin veri alanÄ±nda gÃ¶nderen hesaba (borÃ§landÄ±rÄ±lacak hesaba) iliÅkin bir bilgisinin olmasÄ± gerekmez. \nHesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK dÃ¼zenli Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n POST /duzenli-odeme-emri-rizasi  isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âDuzenliOdemeEmriRizasiIstegiâ nesnesi (Tablo) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âDuzenliOdemeEmriRizasiâ (Tablo) nesnesi oluÅturulur. \n  BAÅARILI Ä°STEK: \n Tablo : âDuzenliOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan dÃ¼zenli Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.ohkTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n >

16 GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda dÃ¼zenli Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile dÃ¼zenli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, HspRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n Ã¼nvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n TalimatÄ±n gerÃ§ekleÅeceÄi ana kadar KOLAS tanÄ±mÄ±nÄ±nda deÄiÅiklik olabileceÄi iÃ§in,  KOLAS ile yapÄ±lan dÃ¼zenli Ã¶deme emri iÅlemleri, talimatÄ±n verildiÄi anda Ã§Ã¶zÃ¼len IBAN'a yapÄ±lacaktÄ±r. \n Kolas ile dÃ¼zenli Ã¶deme emri hizmeti desteklenmiyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir. \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n Karekod ile yapÄ±lan dÃ¼zenli iÅlemler, talimatÄ±n verildiÄi anda Ã§Ã¶zÃ¼len IBAN'a yapÄ±lacaktÄ±r. \n Karekod ile dÃ¼zenli Ã¶deme emri hizmeti desteklenmiyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir. \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n HHS, YÃS'Ã¼n API deseninde \"O\" kodunu ilettiÄini kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarÄ±nda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.   -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tÄ°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n YÃS bu deÄeri ÃHKâyÄ± HHSâye yÃ¶nlendirmeden Ã¶nceki ekranda gÃ¶stermeli, ve HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak yine ÃHKâya gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âDuzenliOdemeEmriRizasiâ nesnesi Tabloâda parametrelerden oluÅur: \n Tablo : âDuzenliOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n DuzenliOdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n DuzenliOdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n DuzenliOdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n >

16 GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.   Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen Ã¼nvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.    Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n 8.3.\tADIM 2- DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil : DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n dÃ¼zenli Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=D&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=D&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=D&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK, bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS, dÃ¼zenli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 8.4.\tADIM 2.1 â DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âDuzenliOdemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda dÃ¼zenli Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgilerinin zorunlu olmasÄ± nedeniyle,  DuzenliOdemeEmriRizasi  nesnesi sorgulanarak bu bilgiler alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -DÃ¼zenli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  DuzenliOdemeEmriRizasi  nesnesine iÅler. \n \n Sorgulama yapÄ±lan DÃ¼zenli Ãdeme Emri HHS tarafÄ±nda bulunmuyor ise  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n GET /duzenli-odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  DuzenliOdemeEmriRizasi  k

16aynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n Durum \n DuzenliOdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n DÃ¼zenli Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /duzenli-odeme-emri-rizasi/{rizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âDuzenliOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-8âde yer alan parametreleri iÃ§eren âDuzenliOdemeEmriRizasiâ oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âDuzenliOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /duzenli-odeme-emri-rizasi/{rizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âDuzenliOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n 8.5.\tADIM 3- Duzenli Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Duzenli Ãdeme Emrinin OluÅturulmasÄ± \n POST /duzenli-odeme-emri \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS DuzenliOdemeEmri kaynaÄÄ±nÄ± oluÅturur.\nDuzenli Ãdeme emri (DuzenliOdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r. \n \n EriÅim Belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir EriÅim Belirteci yok ise  \"TR.OHVPS.Connection.InvalidToken\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor, Y: Yetkilendirildi  ya da E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n POST /duzenli-odeme-emri-rizasi ile POST /duzenli-odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r. DÃ¼zenli Ãdeme Emri rÄ±zasÄ±nda gÃ¶nderilen deÄerlerden farklÄ± bir deÄer gÃ¶nderildiÄi durumda  âTR.OHVPS.Business.FieldMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra POST baÅarÄ±lÄ± olursa, iÃ§erisinde tlmtNo deÄiÅkeni bulunan DuzenliOdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n BAÅARILI Ä°STEK: \n Tablo 9: âDuzenliOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan dÃ¼zenli Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n >YÃ¶nlendirme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n >AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur. yetYntm = Y iÃ§in bu nesne iletilmemelidir. \n \n \n \n >>OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >>OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n \n \n >Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde, 1. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± dÃ¼zenli Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Duzenli Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >

16 GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Duzenli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Duzenli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda dÃ¼zenli Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi dÃ¼zenli Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Duzenli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Duzenli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n KolasRef ( hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n Duzenli Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. \n RefBlg (Hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n FAST/PÃS Acklm \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âDuzenliOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âDuzenliOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n Z \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.  Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ  deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n Talimat Bilgileri \n tlmtBlg \n Kompleks: TalimatBilgileri \n

16- \n \n \n \n > Talimat NumarasÄ± \n tlmtNo \n AN1..128 \n Z \n DÃ¼zenli Ãdeme Emri nesnesinin UID'sidir. DÃ¼zenli Ãdeme Emri kaydÄ±'na dair Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Talimat OluÅma ZamanÄ± \n tlmtOlsZmn \n ISODateTime \n Z \n duzenliOdemeEmri nesnesinin oluÅturulma zamanÄ±, talimatÄ±n HHS'de oluÅturulduÄu zaman bilgisidir. \n \n \n > Talimat TutarÄ± \n tlmtTtr \n AN1..24 \n Z \n ÃBHS'nin HHS'de belirlediÄi tutar bilgisidir. Talimata ait ilk Ã¶deme emri kaydÄ±nÄ±n tutar bilgisi iletilmelidir.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n > Ä°lk Ãdeme GÃ¼nÃ¼ \n ilkOdmGn \n ISODate \n Z \n ÃBHS'nin HHS'de belirlediÄi ilk Ã¶deme gÃ¼nÃ¼ bilgisidir.   AlabileceÄi minimum tarih deÄeri dÃ¼zenli Ã¶demenin verildiÄi tarihin 1 gÃ¼n sonrasÄ± olabilir. Maksimum deÄer ise 30 gÃ¼n olacak Åekilde seÃ§ilebilir.  \n \n \n > Son Ãdeme GÃ¼nÃ¼ \n sonOdmGn \n ISODate \n Z \n ÃBHS'nin HHS'de belirlediÄi son Ã¶deme gÃ¼nÃ¼ bilgisidir. AlabileceÄi minimum gÃ¼n deÄeri ilk Ã¶deme gÃ¼nÃ¼nÃ¼n 1 gÃ¼n sonrasÄ± olabilir. Maksimum deÄer ise 2 yÄ±l olmalÄ±dÄ±r.  \n \n \n > Ãdeme SayÄ±sÄ± \n odmSayi \n N3 \n Z \n ÃBHS'nin HHS'de belirlediÄi Ã¶deme sayÄ±sÄ±dÄ±r. Minimum deÄer 2 adet olmalÄ±dÄ±r. \n \n \n > Ãdeme Periyodu \n odmPryt \n AN1 \n Z \n ÃBHS'nin HHS'de belirlediÄi Ã¶deme periyot bilgisidir. TR.OHVPS.DataCode.OdemePeriyodu sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Talimat Rumuzu \n tlmtRmz \n AN1..180 \n Ä° \n ÃBHS'nin HHS'de belirlediÄi talimata dair rumuz aÃ§Ä±klamasÄ±dÄ±r. Ä°lgili alan isteÄe baÄlÄ± olup HHS'lerin inisiyatifindedir. \n 8.6.\tADIM 3.1- Duzenli Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Duzenli Ãdeme Emri Sorgusu \n GET /duzenli-odeme-emri/{tlmtNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla dÃ¼zenli Ã¶deme emrini sorgulayabilir. Maksimum talimata dair son Ã¶deme gÃ¼nÃ¼nÃ¼n 5 gÃ¼n sonrasÄ±na kadar sorgulama yapÄ±labilir. SonrasÄ±nda yapÄ±lacak sorgulamalarda eriÅim belirtecinin yetki sÃ¼resi sonlandÄ±ÄÄ± iÃ§in HHS  TR.OHVPS.Resource.ConsentRevoked Â hatasÄ±nÄ± dÃ¶nmelidir.\nÄ°ptal edilmiÅ talimatÄ±n bilgileri sorgulanmak istendiÄinde de yine  TR.OHVPS.Resource.ConsentRevoked Â hatasÄ± verilmelidir. \n YÃS sadece kendi uygulamasÄ± Ã¼zerinden verilmiÅ dÃ¼zenli Ã¶demeleri sorgulayabilir. EriÅim izni olmayan bir Ã¶deme emri numarasÄ± ile sorgulama yaptÄ±ÄÄ±nda HHS'den  TR.OHVPS.Resource.NotFound  hatasÄ±nÄ± alÄ±r. \n BAÅARILI YANIT: \n GET /duzenli-odeme-emri/{tlmtNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âDuzenliOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âDuzenliOdemeEmriâ nesnesi dÃ¶ner. \n 8.7.\tADIM 4- DÃ¼zenli Ãdeme PlanÄ± Sorgulama \n \n Åekil 10: DÃ¼zenli Ãdeme PlanÄ± Sorgulama \n GET /duzenli-odeme-emri/{talimatNo}/odeme-plani \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla dÃ¼zenli Ã¶deme planÄ±nÄ± gÃ¶rÃ¼ntÃ¼leyebilir. Ä°ptal edilen bir Ã¶deme emri rÄ±zasÄ±na dair talimat Ã¶deme planÄ± gÃ¶rÃ¼ntÃ¼lenemeyecektir. Ä°ptal edilmiÅ bir talimata ait istek geldiÄinde HHS tarafÄ±ndan  \"TR.OHVPS.Resource.ConsentRevoked\"  hatasÄ± dÃ¶nÃ¼lmelidir. \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan \"DuzenliOdemeEmriPlani\" nesnesi Tablo-11âdeki parametrelerden oluÅur: \n Tablo 11: DuzenliOdemeEmriPlani nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Ãdeme SÄ±ra NumarasÄ± \n odmSiraNo \n AN1..999 \

16n Z \n Ãdeme planÄ± iÃ§erisindeki sÄ±rayÄ± belirten deÄerdir. \n \n \n Ãdeme TutarÄ± \n odmTtr \n AN1..24 \n Z \n Ãdeme planÄ± iÃ§erisinde Ã¶deme numarasÄ± kaydÄ±na ait Ã¶denecek tutar bilgisi   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n GerÃ§ekleÅen Ãdeme TutarÄ± \n grckOdmTtr \n AN1..24 \n K \n Ãdeme planÄ± iÃ§erisinde Ã¶deme numarasÄ± kaydÄ±na ait Ã¶denmiÅ  tutar bilgisi. KÄ±smi Ã¶deme yapÄ±lan iÅlemlerde kÄ±smi Ã¶deme tutar bilgisi eklenmelidir. KÄ±smi Ã¶deme yerine Ã¶denecek tutarÄ±n tamamÄ± Ã¶denmesi durumunda ilgili tutar bilgisi iletilmelidir. Ãdeme Durumu 01, 02 ve 06 olan kayÄ±tlar iÃ§in bu alanÄ±n gÃ¶nderilmesi zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n Ãdeme TutarÄ± Para Birimi \n prBrm \n AN3 \n Z \n Tutara ait Para Birimi.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n Ãdeme Talimat Tarihi \n odmTlmtTrh \n ISODate \n Z \n Ãdeme planÄ± iÃ§erisindeki ilgili Ã¶demenin gerÃ§ekleÅmesi beklenen tarih bilgisidir. \n \n \n Ãdeme GerÃ§ekleÅme ZamanÄ± \n odmGrckZmn \n ISODateTime \n K \n Ãdeme planÄ± iÃ§erisindeki ilgili Ã¶demenin gerÃ§ekleÅtiÄi tarih bilgisidir. Ãdeme durumu 01, 02 ve 06 olan kayÄ±tlar iÃ§in bu alanÄ±n gÃ¶nderilmesi zorunludur. \n \n \n Ãdeme Durumu \n odmDrm \n AN2 \n Z \n Ãdeme planÄ± iÃ§erisindeki Ã¶demelere ait durumu belirten deÄerdir.  TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n 8.8.\tADIM 5- DÃ¼zenli Ãdeme Emri RÄ±za Ä°ptali \n \n Åekil 10: DÃ¼zenli Ãdeme Emri RÄ±zasÄ± Ä°ptali \n DELETE /duzenli-odeme-emri-rizasi/{rizaNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± iptal edebilir. \n DELETE /duzenli-odeme-emri-rizasi Ã§aÄrÄ±sÄ±, bir ÃBHS'nin Ã¶nceden oluÅturulmuÅ bir dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, ÃBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \n \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±za, iptal edilen rizaNo bilgisi ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°ptal edilmek istenen DÃ¼zenli Ãdeme Emri RÄ±zasÄ± HHS tarafÄ±nda bulunmuyor ise  âTR.OHVPS.ResourceNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu I ve S olmayan kayÄ±tlar iÃ§in rÄ±za iptali saÄlanacaktÄ±r. I ve S olan kayÄ±tlar iÃ§in rÄ±za iptal edilmek istendiÄinde HHS'ler tarafÄ±ndan  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lecektir. \n \n YukarÄ±da kontroller baÅarÄ±yla tamamlandÄ±ktan sonra sÄ±rasÄ±yla aÅaÄÄ±daki iÅlemler yapÄ±lÄ±r. \n \n DÃ¼zenli Ã¶deme talimat planÄ± iÃ§erisinde yer alan odmDrm deÄeri 04 ve 05 olan kayÄ±tlar 07 durum kodu ile gÃ¼ncellenecektir. DiÄer durum kodlarÄ± iÃ§in 07 durum ko

16d gÃ¼ncellemesi yapÄ±lmayacaktÄ±r. \n Ä°liÅkili dÃ¼zenli Ã¶deme emri talimatÄ± iptal edilmelidir. \n RÄ±za iptal edilmelidir. \n \n Bu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin ÃBHS Ã¼zerinden dÃ¼zenli Ã¶deme emri rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki dÃ¼zenli Ã¶deme emri rÄ±zasÄ± nesnesinin silinmesini saÄlar.\nMÃ¼Återinin ÃBHSânin veri eriÅim iznini iptal etmesi durumunda ÃBHS, HHSâde mevcut olan DuzenliOdemeEmriRizasi'na dair rÄ±za ve talimat bilgilerini pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa\nDELETE /duzenli-odeme-emri-rizasi/{RizaNo}\nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. \n Servis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r.\nÃHK rÄ±zasÄ± baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ olarak ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir.\nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir:\nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (ÃBHS) \n"},{title:"GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",frontmatter:{},regularPath:"/v2.0.1/contents/erisim-belirteci.html",relativePath:"v2.0.1/contents/erisim-belirteci.md",key:"v-1a476f8d",path:"/v2.0.1/contents/erisim-belirteci.html",headers:[{level:2,title:"Yetkilendirme Kodu API",slug:"yetkilendirme-kodu-api"},{level:2,title:"EriÅim Belirteci API",slug:"erisim-belirteci-api"}],content:' GÃ¼Ã§lÃ¼ Kimlik DoÄrulama  \n \n ÃHK\'nÄ±n YÃS uygulamasÄ±ndan HHS uygulamasÄ±na yÃ¶nlendirilmesi ile baÅlanan gÃ¼Ã§lÃ¼ kimlik doÄrulama sÃ¼reci,  Oauth 2.0 standartlarÄ± gereÄi Ã¶ncelikle yetkod deÄerinin YÃS\'e iletilmesi ile baÅlar ve eriÅim belirtecinin alÄ±nmasÄ± sonucunda baÅarÄ± ile sonuÃ§lanmÄ±Å olur. \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ  "odeme_emri" \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n yetkilendirme-kodu \n GET \n /yetkilendirme-kodu \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n \n yetkilendirmeKodu \n \n \n 2 \n erisim-belirteci \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n ErisimBelirteciIstegi \n ErisimBelirteci \n Yetkilendirme Kodu API \n GET /yetkilendirme-kodu \n AyrÄ±k GKD sÃ¼recinde kullanÄ±lacak olan Yetkilendirme Kodu API\'nin  HHS tarafÄ±ndan sunulmasÄ± gerekmektedir. \n AyrÄ±k GKD akÄ±ÅÄ±nda; HHS, YÃS\'Ã¼n olay dinleme servisine "AYRIK_GKD_BASARILI" olay tipi ile olay bildirimi yapar. BÃ¶ylece ÃHK\'nÄ±n kendi sistemine baÅarÄ± ile login olduÄunu ve yetKod deÄerinin ÃHK ile iliÅkilendirildiÄinin bilgisini YÃS\'e iletmiÅ olur.  \nHHS olay bildirimi iÃ§in retry policy sÃ¼reÃ§leri kapsamÄ±nda 1 dakikada 3 kez deneme yapabilir. YÃS\'e olay bildirimi yapÄ±lmamÄ±Å ise, kendisine gelmeyen olay bildirimi iÃ§in yetkod\'un geÃ§erli olduÄu 5 dakika boyunca yetkilendirme-kodu endpointi ile sorgulama yaparak yetkod deÄerini alabilir. \n YÃS, "ODEME_EMRI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=O \n YÃS, "ILERI_TARIHLI_ODEME_EMRI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=I \n YÃS, "DUZENLI_TEKRARLI_ODEME_EMRI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=D \n YÃS, "HESAP_BILGISI_RIZASI" kaynaÄÄ± iÃ§in bildirim yapÄ±ldÄ± ise; GET /yetkilendirme-kodu endpointi ile yetkod sorgusu yapÄ±lÄ±r. \nÃrnek Ã§aÄrÄ±m :\n GET /yetkilendirme-kodu?rizaNo=123&rizaTip=H \n Ä°STEK: \n YÃS, rÄ±za numarasÄ±nÄ± ve isteÄin ÃBH ya da HBH olmasÄ±na gÃ¶re deÄiÅen rÄ±za tipini parametre olarak

16istek talebine ekler. RÄ±za tipinin alabileceÄi deÄerler  TR.OHVPS.DataCode.RizaTip  sÄ±ralÄ± veri tiplerinde belirtilmiÅtir. \n HHS\'nin, yetkilendirme yÃ¶ntemi "AyrÄ±k Gkd" ise  rÄ±za numarasÄ± ile yetki kodu deÄerini dÃ¶nmesi beklenmektedir. YÃ¶nlendirmeli GKD iÃ§in bu endpoint "yetKod" deÄerini dÃ¶nmemelidir. YÃ¶nlendirmeli GKDâye ait bir rÄ±za no ile yetkilendirme kodu API kullanÄ±larak yet_kod alÄ±nmak istendiÄinde HHS tarafÄ±ndan  TR.OHVPS.Resource.NotFound  hatasÄ± verilmelidir. \n YANIT: \n HHS yanÄ±t nesnesi iÃ§erisinde, ÃHK\'ya ait yetki kodunu, rÄ±za no ve rÄ±za durumu ile birlikte YÃS\'e iletir. \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Yetki Kodu \n yetKod \n AN1..255 \n Z \n GKD sÃ¼recinde Ã¼retilen yetkilendirme kodudur. Tek kullanÄ±mlÄ±k olup, aynÄ± yetKod ile birden fazla token alÄ±namaz. yetKod Parametresinin yaÅam Ã¶mrÃ¼ 5 dakika olmalÄ±dÄ±r. \n \n \n RÄ±zaNo \n rizaNo \n AN1..128 \n Z \n RÄ±za nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n AyrÄ±k GKD sÃ¼recinde, yetkod deÄerini alan YÃS; eriÅim belirteci API ile GKD sÃ¼recini tamamlar. \n EriÅim Belirteci API \n POST /erisim-belirteci \n Ä°STEK: \n YÃS erisim-belirteci eriÅim adresini 2 amaÃ§la kullanÄ±r: \n \n \n Bir Ã¶nceki adÄ±mdan aldÄ±ÄÄ± rizaNo, rizaTip (Ã¶deme emri baÅlatma hizmetinde âOâ, hesap bilgisi hizmetinde âHâ, ileri tarihli Ã¶deme emri baÅlatma hizmetinde "I") ve GKD sonrasÄ± dÃ¶nÃ¼len yetKod bilgilerini kullanarak HHS nezdinde ErisimBelirteci nesnesi oluÅturmak Ã¼zere istekte bulunur. YÃSâÃ¼n istekte bulunabilmesi iÃ§in GKD adÄ±mÄ±nÄ±n baÅarÄ±lÄ± bir Åekilde tamamlanmasÄ± rizaDrm bilgisinin âyetkilendirildiâ olmasÄ± gerekir. EriÅim Belirteci nesnesi ile rÄ±zasÄ± nesnesi (Ãdeme Emri RÄ±zasÄ±, Hesap Bilgisi RÄ±zasÄ± veya Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±) arasÄ±ndaki iliÅki rÄ±za numarasÄ± Ã¼zerinden saÄlanÄ±r. \n \n \n AldÄ±ÄÄ± eriÅim belirtecinin GeÃ§erlilik SÃ¼resinin dolduÄu durumda, yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci almasÄ± gerekmektedir. \n \n \n POST /erisim-belirteci isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âErisimBelirteciIstegiâ nesnesi (Tablo-23) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âErisimBelirteciâ nesnesi (Tablo 24) oluÅturulur veya (Yenileme Belirteci iÃ§in) gÃ¼ncellenir. RÄ±za durumu âYetki KullanÄ±ldÄ±â olarak gÃ¼ncellenir. \n EriÅim Belirteci POST iÅlemi sonucunda HTTP 200 dÃ¶nÃ¼lmesi gerekmektedir. \n âErisimBelirteciIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±zaNo \n rizaNo \n AN1..128 \n Z \n RÄ±za nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n RÄ±za Tipi \n rizaTip \n AN1 \n Z \n O,H,I,D (TR.OHVPS.DataCode.RizaTip) \n \n \n Yetki Tipi \n yetTip \n AN1..50 \n Z \n âyet_kodâ yada âyenileme_belirteciâ deÄerini alabilir.  (TR.OHVPS.DataCode.YetTip) \n \n \n Yetki Kodu \n yetKod \n AN1..255 \n K \n GKD iÅleminden dÃ¶nen yetkilendirme kodudur. Tek kullanÄ±mlÄ±k olup, aynÄ± yetKod ile birden fazla token alÄ±namaz. yetKod Parametresinin yaÅam Ã¶mrÃ¼ 5 dakika olmalÄ±dÄ±r. yetTip = âyet_kodâ ise zorunludur. \n \n \n Yenilenme Belirteci \n yenilemeBelirteci \n AN1..4096 \n K \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r. yetTip = âyenileme_belirteciâ ise kullanÄ±mÄ± zorunludur. \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âerisimBelirteciâ nesnesinde bulunan eriÅim belirteci deÄeri Ã¶deme emrinin baÅlatÄ±lmasÄ± esnasÄ±nda kullanÄ±lÄ±r. \n "ErisimBelirteci" nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format:Veri modeli Ä°smi \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n EriÅim Belirteci \n erisimBelirteci \n AN1..4096 \n Z \n Yetkilendirme Kodu karÅÄ±lÄ±ÄÄ±nda HHS tarafÄ±ndan dÃ¶nÃ¼len ve sonraki hesap bilgisi ve Ã¶deme emri servislerine eriÅimde kullanÄ±lan bilgidir. BÃ¶lÃ¼m 3.6 Karakter Kodlama   bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. Yenileme belirteci ile birden fazla eriÅim belirteci alÄ±nmasÄ± durumunda verilen tÃ¼m eriÅim belirteÃ§lerinin sÃ¼releri bitene kadar geÃ§erli olmalÄ±dÄ±r. \n \n \n GeÃ§erlilik SÃ¼resi \n gecerlilikSuresi \n N1..9 \n Z \n EriÅim Belirtecini saniye cinsinden geÃ§erlilik sÃ¼residir.  EriÅim belirteci geÃ§erli olduÄu son tarih ; Hesap Bilgisi RÄ±zasÄ± iÃ§in en fazla 30 gÃ¼n en az ise 1 gÃ¼n olmalÄ±dÄ±r.  EriÅimin GeÃ§erli OlduÄu Son Tarih(erisimIzniSonTrh); EriÅim Belirteci GeÃ§erlilik SÃ¼resi\'nden kÃ¼Ã§Ã¼k ise EriÅimin GeÃ§erli OlduÄu Son Tarih deÄeri ile sÄ±nÄ±rlÄ±dÄ±r. Ãdeme Emri RÄ±zasÄ± ,Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± ve DÃ¼zenli TekrarlÄ± Ãdeme Emri RÄ±zasÄ± iÃ§in 5 dakika olmalÄ±dÄ±r. \n \n \n Yenileme Belirteci \n yenilemeBelirteci \n AN1..4096 \n Z \n EriÅim belirtecinin yenilenmesi amacÄ±yla kullanÄ±lÄ±r.   BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir.  Yenileme Belirteci ile EriÅim Belirteci isteÄi yapÄ±ldÄ±ÄÄ±nda HHS\'nin dÃ¶ndÃ¼ÄÃ¼ yanÄ±t iÃ§erisindeki yenilemeBelirteci deÄerini kesinlikle deÄiÅtirmemesi gerekmektedir.Yenileme belirteci rÄ±za sÃ¼resi boyunca gÃ¼ncellenmemelidir. \n \n \n Yenileme Belirteci GeÃ§erlik SÃ¼resi \n yenilemeBelirteciGecerlilikSuresi \n N1..9 \n Z \n Yenileme belirtecinin saniye cinsinden geÃ§erlilik sÃ¼residir. Yenileme belirtecinin geÃ§erli olduÄu son tarih ; Hesap Bilgisi iÃ§in EriÅimin GeÃ§erli OlduÄu Son Tarih ile sÄ±nÄ±rlÄ± olmalÄ±dÄ±r. Bu tarih geldiÄi zaman Hesap Bilgisi RÄ±za Durumunu âYetki SonlandÄ±rÄ±ldÄ±â statÃ¼sÃ¼ne Ã§ekilmesi gerekir. Ãdeme BaÅlatma iÃ§in RÄ±za OluÅturma ZamanÄ±ndan 15 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. 15 gÃ¼n sÃ¼resi sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. Ãdeme emri 5 dakika iÃ§inde gerÃ§ekleÅtirilmelidir. GerÃ§ekleÅmediÄinde 4.2.8 bÃ¶lÃ¼mÃ¼nde aktarÄ±lan rÄ±za statÃ¼ gÃ¼ncellemesi yapÄ±lmalÄ±dÄ±r.  Yenileme belirteci geÃ§erlilik sÃ¼resi, Ä°leri Tarihli Ãdeme Emri BaÅlatma iÃ§in talimatÄ±n gerÃ§ekleÅeceÄi zamandan 15 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. Talimat gerÃ§ekleÅtikten sonrasÄ± iÃ§in 15 gÃ¼n sÃ¼reyle sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. Yenileme belirteci geÃ§erlilik sÃ¼resi, DÃ¼zenli TekrarlÄ± Ãdeme Emri BaÅlatma iÃ§in talimatÄ±n gerÃ§ekleÅeceÄi  son Ã¶deme gÃ¼nÃ¼  zamanÄ±ndan 5 gÃ¼n sonrasÄ± olmalÄ±dÄ±r. Son talimat gerÃ§ekleÅtikten sonrasÄ± iÃ§in 5 gÃ¼n sÃ¼reyle sorgulama servislerinin Ã§aÄrÄ±mÄ±nÄ± destekleyecek Åekilde uzun tutulmuÅtur. \n \n \n \n erisim-belirteci erisim noktasÄ±ndan elde edilen erisimBelirteci, iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda x-access-token alanÄ±nda iletilir. \n Yenilenme Belirteci (refreshToken) kullanÄ±larak EriÅim Belirteci (accessToken) alÄ±ndÄ±ÄÄ±nda, dÃ¶ne

16n yanÄ±ttaki Yenileme Belirteci GeÃ§erlik SÃ¼resi (yenilemeBelirteciGecerlilikSuresi) geÃ§en sÃ¼re eksiltilerek, kalan zamanÄ±n saniye cinsinden hesaplanmasÄ±yla iletilmelidir. \n EriÅim Belirteci API Ã§aÄrÄ±mÄ± sÄ±rasÄ±nda rÄ±za durumlarÄ± kontrol edilmelidir. Bu kontrollerin nasÄ±l yapÄ±lmasÄ± gerektiÄi 4-RÄ±za DurumlarÄ± bÃ¶lÃ¼mÃ¼nde aktarÄ±lmÄ±ÅtÄ±r. \n Yenileme belirteci karÅÄ±lÄ±ÄÄ±nda yeni bir eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda HHS\'nin dÃ¶ndÃ¼ÄÃ¼ hata yanÄ±tÄ±nda httpCode = 401 ve errorCode = "TR.OHVPS.Connection.InvalidToken" gelirse YÃS Ã¶nce rÄ±zanÄ±n durumu sorgulamalÄ±dÄ±r.  \nEÄer geÃ§erli bir rÄ±za ise; HHS veya YÃS tarafÄ±nda bir sorun olduÄu anlaÅÄ±lmalÄ±dÄ±r. Sistem tarafÄ±ndan hata Ã¼retilmeli ve sorun incelenmelidir. \nEÄer geÃ§erli bir rÄ±za deÄil ise YÃS tarafÄ±ndaki rÄ±za durumu gÃ¼ncellenmelidir. \n'},{title:"5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama",frontmatter:{},regularPath:"/v2.0.1/contents/gkd.html",relativePath:"v2.0.1/contents/gkd.md",key:"v-7adaab06",path:"/v2.0.1/contents/gkd.html",headers:[{level:2,title:"5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-1-yonlendirmeli-guclu-kimlik-dogrulama"},{level:2,title:"5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",slug:"_5-2-ayrÄ±k-guclu-kimlik-dogrulama"},{level:3,title:"5.2.1\tStatik Model",slug:"_5-2-1statik-model"},{level:2,title:"5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi",slug:"_5-3-yonlendirme-bildirim-adresleri-ve-durum-kodu-parametresi"},{level:2,title:"5.4  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri",slug:"_5-4-guclu-kimlik-dogrulama-kontrolleri"}],content:" 5.\tGÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n MÃ¼Återi iÃ§in gÃ¼Ã§lÃ¼ kimlik doÄrulama, ÃHKânÄ±n (mÃ¼Återinin) kimliÄinin doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin âbildiÄiâ, âsahip olduÄuâ veya âbiyometrik bir karakteristiÄi olanâ bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntemi tanÄ±mlar. \n Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄ uyarÄ±nca hesap bilgisi hizmetinde mÃ¼Återinin onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda ve Ã¶deme emri baÅlatma hizmetinde her bir Ã¶deme emri baÅlatma iÅleminde  HHS tarafÄ±ndan mÃ¼Återiye gÃ¼Ã§lÃ¼ kimlik doÄrulama (GKD) uygulanmasÄ± esastÄ±r.  Buna gÃ¶re: \n \n \n Hesap bilgisi hizmetinde ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± esnasÄ±nda  TebliÄin 26 ncÄ± maddesinin 1 inci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya GKD uygulanÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 2 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanÄ±r ve iÅlem doÄrulama kodu ile ÃHKânÄ±n onayÄ± alÄ±nÄ±r. \n \n \n Ãdeme emri baÅlatma hizmetinde,  TebliÄin 26 ncÄ± maddesinin 3 nci fÄ±krasÄ± uyarÄ±nca  HHS tarafÄ±ndan ÃHKâya gÃ¼Ã§lÃ¼ kimlik doÄrulama uygulanmasÄ±na iliÅkin istisna veya ilave gÃ¼venlik Ã¶nlemleri iÅbu API Ä°lke ve KurallarÄ± belgesinde tanÄ±mlanÄ±r. \n \n \n HHS, gÃ¼Ã§lÃ¼ kimlik doÄrulama sÃ¼recinde ÃHKânin sahip olduÄu bileÅen sÄ±nÄ±fÄ± olarak SMS OTP ya da SMS ile iÅlem doÄrulama kodu kullanabilir. \n \n \n HHS, aÅaÄÄ±daki hallerde veya  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re tek bileÅen ile kimlik doÄrulama yapabilir. \n \n Ãdemenin gÃ¶ndereni ve alÄ±cÄ±sÄ±nÄ±n aynÄ± olmasÄ±, \n Daha Ã¶nce tanÄ±mlanmÄ±Å gÃ¼venli alÄ±cÄ±lar listesine Ã¶deme yapÄ±lmasÄ±, \n ÃHKânin talimatÄ±na istinaden gerÃ§ekleÅtirilen dÃ¼zenli bir Ã¶deme olmasÄ±. \n \n \n \n Tek bileÅen ile kimlik doÄrulama yapÄ±lan bu iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin mÃ¼Återi tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye ait olur. \n \n \n Ä°Ålem DoÄrulamada  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± ÄÄ bendindeki  iÅlem bilgisi tanÄ±mÄ±na uygun olarak aÅaÄÄ±daki bilgiler ile  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  tanÄ±mlanan iÅleme Ã¶zel Ã¼retilmiÅ iÅlem doÄrulama kodu birlikte kullanÄ±lÄ±r. \n \n AlÄ±cÄ± Unvan (Kolas akÄ±ÅÄ±nda maskeli olarak)  (Ã¶deme emri baÅlatma hizmeti) \n Tutar (Ã¶deme emri baÅlatma hizmeti) \n Referans bilgisi (8 karakterden kÃ¼Ã§Ã¼k ise alanÄ±n tÃ¼m deÄeri, bÃ¼yÃ¼k ise ilk 4 ve son 4 hanesi) \n \n Ä°Åleme ait yukarÄ±daki bilgilerden en az biri deÄiÅtiÄi zaman  TebliÄin 3 Ã¼ncÃ¼ maddesinin birinci fÄ±krasÄ± hh bendinde  belirtildiÄi gibi yeni bir iÅlem doÄrulama kodu Ã¼retilecek Åekilde akÄ±Å kurgulanmalÄ±dÄ±r. \n \n \n Ä°Ålem doÄrulama kodunun gÃ¶nderilmesinden HHS sorumludur. HHS,  TebliÄin 10 uncu maddesinin ikinci fÄ±krasÄ±nda  belirtilen risk deÄerlendirmesi sonucuna gÃ¶re iÅlem doÄrulama kodu kullanmaksÄ±zÄ±n ÃHKânÄ±n onayÄ±nÄ± alabilir. Ä°Ålem doÄrulama kodu kullanÄ±lmayan iÅlemlerle ilgili olarak gerÃ§ekleÅtirilen iÅlemin ÃHK tarafÄ±ndan yapÄ±ldÄ±ÄÄ±nÄ± ispat etme yÃ¼kÃ¼mlÃ¼lÃ¼ÄÃ¼ HHSâye aittir. \n \n \n ÃHVPS API Ä°lke ve KurallarÄ± kapsamÄ±nda iki adet GÃ¼Ã§lÃ¼ Kimlik DoÄrulama (GKD) yÃ¶ntemi kullanÄ±lacaktÄ±r: \n \n YÃ¶nlendirmeli (Redirect) GKD YÃ¶ntemi \n AyrÄ±k (Decoupled) GKD YÃ¶ntemi \n \n \n \n Hem web hem mobil uygulama hizmeti bulunan katÄ±lÄ±mcÄ±lar iÃ§in her iki uygulama Ã¶zelinde de yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. Web ya da mobil uygulamalardan sadece birinin olmasÄ± durumunda ilgili uygulama Ã¶zelinde yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. \n 5.1.\tYÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n YÃ¶nlendirmeli GKD YÃ¶nteminde, mÃ¼Återi kimlik doÄrulama iÃ§in YÃS tarafÄ±ndan HHS arayÃ¼zÃ¼ne yÃ¶nlendirilir. \n MÃ¼Återi HHSâye (uygulama veya web arayÃ¼zÃ¼ vasÄ±tasÄ±yla) yÃ¶nlendirildikten s

16onra mÃ¼Återinin gÃ¼Ã§lÃ¼ kimlik doÄrulamasÄ± adÄ±m adÄ±m ve doÄrudan HHS ile mÃ¼Återi arasÄ±nda yÃ¼rÃ¼tÃ¼lÃ¼r. GKDânin tamamlanmasÄ±ndan sonra mÃ¼Återi tekrar YÃS uygulamasÄ±na yÃ¶nlendirilir. \n YÃ¶nlendirmeli GKD YÃ¶ntemi iÃ§in Ã¼st dÃ¼zey Ã¶rnek iÅ akÄ±ÅÄ± aÅaÄÄ±daki adÄ±mlardan oluÅur: \n \n YÃS, GKD iÃ§in HHS tarafÄ±ndan tanÄ±mlanan arayÃ¼ze (tarayÄ±cÄ± ya da uygulama) yÃ¶nlendirme yapar. \n MÃ¼Återi, YÃS arayÃ¼zÃ¼nden ayrÄ±lÄ±r, yÃ¶nlendirildiÄi HHS arayÃ¼zÃ¼ Ã¼zerinde kimlik doÄrulama iÅlemlerini gerÃ§ekleÅtirir. \n GKD tamamlandÄ±ktan sonra mÃ¼Återi, YÃS arayÃ¼zÃ¼ne tekrar yÃ¶nlendirilir ve iÅlem sonucu gÃ¶rÃ¼ntÃ¼lenir. \n \n YÃ¶nlendirmeli GKD iÃ§in temel gereklilikler ÅunlardÄ±r: \n \n Ãdeme hizmeti (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) tarayÄ±cÄ± ya da uygulama tabanlÄ± bir Åekilde sunulabilir. Web ya da mobil uygulamalardan sadece birinin olmasÄ± durumunda ilgili uygulama Ã¶zelinde yÃ¶nlendirme yapÄ±lmasÄ± zorunludur. \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n YÃ¶nlendirmeli GKD YÃ¶nteminde; rÄ±za isteÄine baÅarÄ±lÄ± yanÄ±t alÄ±ndÄ±ktan sonra, ÃHK, kimlik doÄrulama iÃ§in YÃS tarafÄ±ndan HHS arayÃ¼zÃ¼ne yÃ¶nlendirilir.\nYÃS, yÃ¶nlendirme akÄ±ÅÄ±nÄ± kendi sunucusundan karÅÄ±layacaÄÄ± bir istek ile baÅlatmalÄ±dÄ±r. YÃS web arayÃ¼zÃ¼ndeki bu yapÄ±, 302 yanÄ±t kodu ve yanÄ±t baÅlÄ±ÄÄ±ndaki Location deÄeri ile ÃHK tarayÄ±cÄ±sÄ±nÄ± HHS adresine yÃ¶nlendirmelidir. Bu sayede GKD, HHS tarafÄ±nda baÅlayabilir. \n YÃS tarafÄ±ndaki yÃ¶nlendirme servisi iÃ§in Ã¶rnek response; \n HTTP/1.1 302 Found\nLocation: {{hhsYonAdr}}\n \n ÃHK, HHSâye (app veya web arayÃ¼zÃ¼ vasÄ±tasÄ±yla) yÃ¶nlendirildikten sonra ÃHK'nin gÃ¼Ã§lÃ¼ kimlik doÄrulamasÄ± HHS ile ÃHK arasÄ±nda yÃ¼rÃ¼tÃ¼lÃ¼r. GKDânin tamamlanmasÄ±ndan sonra ÃHK tekrar YÃS uygulamasÄ±na yÃ¶nlendirilir. \n HHS, yÃ¶nlendirme akÄ±ÅÄ±nÄ± kendi sunucusundan karÅÄ±layacaÄÄ± bir istek ile baÅlatmalÄ±dÄ±r. HHS web/app arayÃ¼zÃ¼ndeki bu yapÄ±, ÃHK'nin oturumunu gÃ¼venli bir Åekilde kapatmalÄ±dÄ±r. ArdÄ±ndan 302 yanÄ±t kodu ve yanÄ±t baÅlÄ±ÄÄ±ndaki Location deÄeri ile ÃHK tarayÄ±cÄ±sÄ±nÄ± YÃS adresine yÃ¶nlendirmelidir. \n HTTP/1.1 302 Found\nLocation: {{yosYonAdr}}&rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O\n \n HHSânin web arayÃ¼zÃ¼ne, \n \n HHSânin mobil uygulamasÄ±nÄ±n olmadÄ±ÄÄ±, \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) sunduÄu mobil cihazda HHS uygulamasÄ±nÄ±n yÃ¼klÃ¼ olmadÄ±ÄÄ±, \ndurumlarda yÃ¶nlendirme yapÄ±lÄ±r. \n \n YÃSâÃ¼n mobil uygulamasÄ± varsa mobil cihazda uygulamadan tarayÄ±cÄ±ya, YÃSâÃ¼n mobil uygulamasÄ± yoksa Ã¶deme hizmetinin sunduÄu cihazda (KiÅisel Bilgisayar veya Mobil Cihaz) tarayÄ±cÄ± Ã¼zerinden yÃ¶nlendirme yapÄ±lÄ±r. \n Uygulama TabanlÄ± YÃ¶nlendirme \n ÃHKânÄ±n Ã¶deme hizmetini (hesap bilgisi veya Ã¶deme emri baÅlatma hizmeti) YÃSâÃ¼n mobil uygulamasÄ± ile kullanÄ±yorsa, aynÄ± mobil cihazda HHSânin mobil uygulamasÄ±nÄ±n yÃ¼klenmiÅ olmasÄ± durumunda, ÃHK doÄrulamasÄ±nÄ±n HHS mobil uygulamasÄ± tarafÄ±ndan yapÄ±lmasÄ± iÃ§in uygulama tabanlÄ± yÃ¶nlendirme yapÄ±lÄ±r. BÃ¶ylece ÃHK, Ã¶deme hizmetine eriÅim iÃ§in HHSânin mobil kanalÄ±na eriÅim sÄ±rasÄ±nda kullandÄ±ÄÄ± doÄrulama yÃ¶ntemini ile doÄrulanabilir. \n HHS'nin mobil uygulamasÄ± olmasÄ± durumunda hhsYonAdr olarak universal link kullanmasÄ± gerekmektedir. \n Tablo 5: YÃ¶nlendirmeli GÃ¼Ã§lÃ¼ Kimlik DoÄrulama KanallarÄ± \n \n \n \n DoÄrulama YÃ¶ntemi \n YÃS OlasÄ± Ortam \n HHS OlasÄ± Ortam \n \n \n \n \n TarayÄ±cÄ± TabanlÄ± YÃ¶nlendirme \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼)/Mobil Cihaz \n KiÅisel Bilgisayar (masaÃ¼stÃ¼, dizÃ¼stÃ¼) / Mobil Cihaz \n \n \n Uygulama TabanlÄ± YÃ¶nlendirme \n Mobil Cihaz \n Mobil Cihaz \n 5.2.\tAyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n AyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulama, bir kullanÄ±cÄ±nÄ±n kimliÄinin, bir iÅlem baÅlatÄ±ldÄ±ktan sonra ayrÄ± bir Åekilde doÄrulandÄ±ÄÄ± yÃ¶nteme verilen addÄ±r. Bu GKD modelinde, kimlik doÄrulama iÅlem sÃ¼recinden \"ayrÄ±ÅtÄ±rÄ±lmÄ±ÅtÄ±r\". KullanÄ±cÄ±lar, baÅka bir arayÃ¼ze yÃ¶nlendirilmek yerine ( tarayÄ±cÄ± veya uygulama tabanlÄ± yÃ¶nlendirme gibi), ayrÄ± bir kanal Ã¼zerinden (telefonlarÄ±nda bir uygulama bildirimi gibi) iÅlemi doÄrulamalarÄ± iÃ§in bildirim alÄ±r.\nKullanÄ±cÄ±, iÅlemi tamamen ayrÄ± bir cihaz veya uygulama kullanarak doÄrulayabilir. \n Ä°lk fazda AyrÄ±k GKD'de QRâlÄ± modeller kullanÄ±lmayacaktÄ±r. \n AyrÄ±k GKD uygulamalarÄ±nÄ±n farklÄ± Ã¶rnekleri bulunmaktadÄ±r. Ancak yaygÄ±n olan yaklaÅÄ±m, bir web arayÃ¼zÃ¼ ve bir mobil uygulamanÄ±n komb

16inasyonunu kullanmayÄ± iÃ§erir. \n Mobil uygulamasÄ± bulunan HHS'ler iÃ§in AyrÄ±k GKD desteklenmesi zorunludur.  HHSânin web olduÄu durumda AyrÄ±k GKD akÄ±ÅÄ± uygulanmayacaktÄ±r. Mobil uygulamasÄ± bulunup mÃ¼Återi Ã¶zelinde mobil aktiflik kontrol sÃ¼reci HHS inisiyatifindedir. AyrÄ±k GKD sÃ¼recinde HHS tarafÄ±nda sadece mobil uygulama Ã¼zerinden GKD yapÄ±lmalÄ±dÄ±r. ÃHKânÄ±n web uygulamasÄ±na yÃ¶nlendirme yapmamasÄ± gerekmektedir. \n YÃS rolÃ¼nde AyrÄ±k GKD akÄ±ÅÄ±nÄ±n ÃHKâya sorularak baÅlatÄ±lmasÄ±na gerek bulunmamakla beraber bu bilginin ÃHKâya sorulmasÄ± YÃS inisiyatifindedir. YÃS olarak, AyrÄ±k GKD iÅ akÄ±ÅlarÄ± kapsamÄ±nda ÃHKâya ayrÄ±k GKD Ã¶ncesi HHS mobil uygulamasÄ±nÄ±n varlÄ±ÄÄ± sorularak (bildirim ayarlarÄ±nÄ±n aÃ§Ä±k olmasÄ± gerektiÄi bilgisi de verilebilir) ilerlenebilir. AynÄ± zamanda AyrÄ±k GKD ile rÄ±za sÃ¼recinin baÅlatÄ±lmasÄ± zorunlu deÄildir. RÄ±za sÃ¼reci baÅlatÄ±lÄ±rken yetkilendirme yÃ¶ntemi YÃS inisiyatifindedir. \n Ãrnek bir akÄ±Å Åu Åekildedir: \n \n Ä°Ålem BaÅlatma (YÃS Web/Mobil ArayÃ¼zÃ¼):  ÃHK bir iÅlemi YÃSâÃ¼n web/mobil arayÃ¼zÃ¼nde baÅlatÄ±r. YÃS uygulamasÄ±, ÃHK'nÄ±n tekil bir kullanÄ±cÄ± kimliÄini rÄ±zaya ekleyerek bir rÄ±za baÅlatma iÅlemini HHSâye iletir. HHS, tekil kullanÄ±cÄ± kimliÄini kullanarak ÃHK'nÄ±n mobil uygulamasÄ±na bir bildirim gÃ¶nderir. \n Kimlik DoÄrulama Ä°steÄi (HHS Mobil Uygulama):  ÃHK Mobil uygulama bildirimi alÄ±r ve mobil uygulama ÃHK'ya  kimlik doÄrulama isteÄi sunar. HHSânin BDDK tarafÄ±ndan belirlenmiÅ GKD yÃ¶ntemlerine uygun davranmasÄ± beklenmektedir. \n Kimlik DoÄrulama OnayÄ± (HHS Mobil Uygulama):  Mobil uygulama, ÃHKânÄ±n kimlik doÄrulama giriÅimini doÄrular. BaÅarÄ±lÄ± olursa rÄ±za onayÄ± sonrasÄ± mobil uygulama, 'AyrÄ±k Yetkilendirme BaÅarÄ±lÄ±' olay bildirimini YÃSâe gÃ¶nderir. \n Ä°Ålem OnayÄ± (YÃS Web/Mobil ArayÃ¼zÃ¼):  YÃS,  HHS'den gelen 'AyrÄ±k Yetkilendirme BaÅarÄ±lÄ±' olay bildirimine konu olan rÄ±zayÄ± kullanarak yetkilendirme koduna eriÅir. Bundan sonraki sÃ¼reÃ§ eriÅim belirteci alÄ±nmasÄ± servisi ile devam eder. \n \n AyrÄ±k GÃ¼Ã§lÃ¼ Kimlik DoÄrulamanÄ±n Olay Bildirim Servisleri ile olan BaÄÄ±mlÄ±lÄ±klarÄ± \n AyrÄ±k GKD sÃ¼recinde; HHS'nin yetkilendirme kodunu YÃS'e iletmesi iÃ§in gerekli Ã¶nkoÅul olan ÃHK doÄrulamasÄ± adÄ±mÄ±nÄ±n tamamlanmasÄ±nÄ± olay bildirimi ile YÃS'e yapmasÄ± gerekmektedir.\nBu nedenle YÃS'lerin eÄer AyrÄ±k GKD sÃ¼recini destekleyecek ise;  /olay-dinleme endpointini aÃ§arak olay bildirimi almasÄ± zorunludur. \n Ãzetle: \n YÃ¶nlendirmeli GKD \n \n HHS mobil uygulamasÄ± olmasÄ± durumunda yÃ¶nlendirme adresi olarak universalLink kullanmalÄ±. \n Bu link tanÄ±mÄ±  uygulama var ise uygulamayÄ± aÃ§ yoksa webden devam et Åeklinde olmalÄ±. \n YÃSâÃ¼n mobilden mi webden mi geldiÄi HHS aÃ§Ä±sÄ±ndan Ã¶nemli deÄildir. HHS olarak YÃS hangi adresi yonAdr deÄerinde gÃ¶ndermiÅ ise yetkilendirme sÃ¼reci bittiÄinde o adrese yÃ¶nlendirme yapÄ±lmalÄ±dÄ±r. \n \n AyrÄ±k GKD \n \n Mobil uygulamasÄ± bulunan HHS'ler iÃ§in AyrÄ±k GKD desteklenmesi zorunludur. HHSânin web olduÄu durumda AyrÄ±k GKD akÄ±ÅÄ± uygulanmayacaktÄ±r. Mobil uygulamasÄ± bulunup mÃ¼Återi Ã¶zelinde mobil aktiflik kontrol sÃ¼reci HHS inisiyatifindedir. AyrÄ±k GKD sÃ¼recinde HHS tarafÄ±nda sadece mobil uygulama Ã¼zerinden GKD yapÄ±lmalÄ±dÄ±r. ÃHKânÄ±n web uygulamasÄ±na yÃ¶nlendirme yapmamasÄ± gerekmektedir. \n ÃHKânin Mobil uygulamasÄ±nÄ±n olmadÄ±ÄÄ±nÄ± tespit edebildiÄiniz her durum iÃ§in rÄ±za oluÅturma aÅamasÄ±nda âTR.OHVPS.Business.CustomerMobileApplicationNotFoundâ hatasÄ± dÃ¶Ã¼lÃ¼r. \n HHS, ÃHKânÄ±n mobil uygulamasÄ±nÄ±n bulunmadÄ±ÄÄ± bilgisine ulaÅamazsa kendisinin belirleyeceÄi bildirim yÃ¶ntemlerinden biri ile ÃHKâye bilgilendirme yapar. Bildirim yÃ¶ntemi SMS ise ÃHKâya mobil uygulamasÄ±nÄ± aÃ§tÄ±racak Åekilde adres iletir, Web uygulamayÄ± aÃ§tÄ±racak bir link iletilmemelidir. ÃHK bu bildirimi dikkate almazsa/alamazsa veya ÃHKâda mobil uygulama yok ise bu durumda rÄ±za sÃ¼re aÅÄ±mÄ±ndan iptal olur. \n ÃHK mevcut bankacÄ±lÄ±k iÅlemlerinde bildirimi nasÄ±l gÃ¶nderiyorsanÄ±z (ÃrneÄin: AnlÄ±k bildirim gÃ¶nderildi, alÄ±nmadÄ±, SMSâe dÃ¶nÃ¼ldÃ¼ gibi.) aynÄ± Åekilde bildirim gÃ¶ndererek ÃHKânin uygulama Ã¼zerinden rÄ±zayÄ± onaylamasÄ± beklenir. Buradaki akÄ±Å HHSânin diÄer Ã¼rÃ¼nleri iÃ§in verdiÄi mÃ¼Återi deneyimi ile paralel olmalÄ±dÄ±r. \n 5.2.1\tStatik Model \n YÃS'Ã¼n ÃHK'yÄ± tanÄ±dÄ±ÄÄ± ve ÃHK'ya ait tanÄ±mlayÄ±cÄ± bilgileri HHS'ye aktarabildiÄi durumda kullanÄ±lmaktadÄ±r. Buradaki ÃHK'ya ait tanÄ±mlayÄ±cÄ± bilgiler TCKN, MNO , YKN, PNO, GSM, IBAN olarak belirlenmiÅtir. \n AkÄ±Å aÅaÄÄ±daki gibi kurgulanmÄ±ÅtÄ±r: \n   \n \n \n ÃHK, YÃS uygulamasÄ± Ã¼zerinde iÅlem baÅlatÄ±r. \n \n \n ÃHK, YÃS uygulamasÄ± iÃ§erisinde, farklÄ± bir ortam Ã¼zerinden HHS doÄrulamasÄ±nÄ± gerÃ§ekleÅtirmek istediÄini belirtir. ÃHK'yÄ± tanÄ±ma tip ve deÄerleri YÃS ÃHK'dan talep edebileceÄi gibi, YÃS sisteminde hali hazÄ±rda kayÄ±tlÄ± bilgilerle de akÄ±ÅÄ± devam ettirebilir.  \n \n \n ÃHK, YÃS'Ã¼n mÃ¼Återisi ve YÃS uygulamasÄ±na login ise tek seferlik Ã¶deme akÄ±ÅÄ± baÅlatamaz. \n \n \n YÃS tarafÄ±ndan baÅlatÄ±lan tek seferlik bir Ãdeme iÅleminin AyrÄ±k GKD ile onaylanacaÄÄ± durumda;\nYÃSâÃ¼n ilgili kullanÄ±cÄ±ya ait âÃHK TanÄ±m DeÄerâ verisinin yanÄ±nda iÅleme ait ve ilgili ÃHK ile eÅleÅtirilmiÅ olan  ve sadece YÃS ile ÃHKânÄ±n bilebileceÄi bir deÄerin daha ÃHK tarafÄ±ndan saÄlanmasÄ± ve YÃS tarafÄ±ndan kontrol edilerek eÅleÅen Ãdeme emrinin HHSâye iletilmesi gerekmektedir. ÃrneÄin; bu deÄer YÃS tarafÄ±nda yapÄ±lan tek seferlik Ã¶deme iÅlemine ait fatura numarasÄ±. \n \n \n YÃS Ã¶nyÃ¼zde ÃHK'dan aldÄ±ÄÄ± ohkTanimTip ve ohkTanimDeger deÄ

16erlerini kimlik tÃ¼r ve kimlik deÄeri alanlarÄ±na atamamalÄ±dÄ±r. \n \n \n YÃS, ayrÄ±k GKD ile iÅlem baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\"=\"01\" parametresi ile alabilir. \n \n \n YÃS, ÃHK bilgileri ile rÄ±za oluÅturur. RÄ±za nesnesi iÃ§erisinde yer alan GKD nesnesinde ilgili parametreler aÅaÄÄ±daki Åekilde doldurulur: \n \n \n ohkTanimTip ve ohkTanimDeger parametreleri \nBu metodda; ayrikGkd nesnesi iÃ§erisindeki \"ohkTanimTip\" parametresi TR.OHVPS.DataCode.ohkTanimTip sÄ±ralÄ± veri tiplerinden TCKN, MNO , YKN, PNO, GSM, IBAN deÄerlerinden birini alabilir. ohkTanimDeger parametresi de seÃ§ilen tipe ait ÃHK'ya ait deÄeri iÃ§ermelidir.RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin olduÄu durumlarda; ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r.Kimlik alanÄ± iÃ§ermeyen tek seferlik Ã¶deme emri akÄ±ÅlarÄ±nda bu kural geÃ§erli deÄildir. GSM ve IBAN deÄerleri sadece tek seferlik Ã¶demelerde kullanÄ±labilir. \n YÃS'ten ohkTanimTip olarak gelen IBAN bilgisi sadece ÃHK'yÄ± tanÄ±mak iÃ§in kullanÄ±labilir. TanÄ±m tipi IBAN ile baÅlatÄ±lan bir iÅlemde ÃHK, baÅka bir IBAN ile Ã¶deme baÅlatabilir. \n Kurumsal mÃ¼Återiler iÃ§in kmlkTur ve kmlkVrs alanlarÄ± ohkTanimTip ve ohkTanimDeger alanlarÄ±nda gÃ¶nderilmelidir. \n \n \n yetYntm parametresi \nyetYntm parametresi  AyrÄ±k GKD  akÄ±ÅÄ±nÄ± ifade eden \"A\" deÄerini almalÄ±dÄ±r.  \n \n \n \n \n Ãrnek bir istek : \nPOST/ohvps/obh/s2.0/odeme-emri-rizasi \n RizaNesnesi \n {\n...\n  \"gkd\": {\n    \"yetYntm\": \"A\",\n     \"ayrikGkd\" :{\n         \"ohkTanimTip\" : \"TCKN\" \n         \"ohkTanimDeger\": \"11232123212\"\n     }    \n  },\n...\n}\n \n \n \n YÃS, ayrÄ±k GKD ile iÅlem baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\":\"01\" parametresi ile alabilir.\nYÃS, ayrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.DecoupledAuthenticationNotSupported  hatasÄ± iletilmelidir. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n \n \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda hata mesajÄ± vermelidir. HHS tarafÄ±ndan  TR.OHVPS.Business.CustomerMobileApplicationNotFound  hatasÄ± iletilmelidir. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. HHS, ÃHKânÄ±n mobil uygulamasÄ±nÄ±n bulunmadÄ±ÄÄ± bilgisine ulaÅamazsa kendisinin belirleyeceÄi bildirim yÃ¶ntemlerinden biri ile ÃHKâye bilgilendirme yapar. Bildirim yÃ¶ntemi SMS ise ÃHKâya mobil uygulamasÄ±nÄ± aÃ§tÄ±racak Åekilde adres iletir, Web uygulamayÄ± aÃ§tÄ±racak bir link iletilmemelidir. \n \n \n HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  TR.OHVPS.Business.EventSubscriptionNotFound  hata kodu iletilmelidir. \n \n \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir.   \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  TR.OHVPS.Resource.InvalidFormat  hata kodu iletilmelidir. \n \n \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin olduÄu durumlarda; ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  TR.OHVPS.Business.CustomerInfoMismatch  hatasÄ± iletilmelidir.\nKimlik alanÄ± iÃ§ermeyen tek seferlik Ã¶deme emri akÄ±ÅlarÄ±nda bu kural geÃ§erli deÄildir. GSM ve IBAN deÄerleri sadece tek seferlik Ã¶demelerde kullanÄ±labilir. \n \n \n Tek seferlik Ã¶deme iÅlemlerinde \"ohkTanimTip\" = \"GSM\"/\"IBAN\" olarak gÃ¶nderilmiÅ ise, HHS sisteminde bu GSM/IBAN ile eÅleÅen mÃ¼Återileri taramalÄ±dÄ±r. GSM/IBAN bilgisi ÃHK bazÄ±nda tekil bir kullanÄ±cÄ±ya eriÅim imkanÄ± saÄlamaz ise  TR.OHVPS.Business.InvalidCustomerInfo  hatasÄ±nÄ± iletmelidir. \n \n \n Kontrollerin baÅarÄ±lÄ± olmasÄ± durumunda HHS rÄ±zayÄ± oluÅturur ve ÃHK tekil verisi ile ulaÅtÄ±ÄÄ± ÃHK'ya bilgilendirme mesajÄ± gÃ¶nderir.      Bilgilendirme mesajÄ± kÄ±sa mesaj ya da anlÄ±k bildirim mesajÄ± olabilir. ÃHKânÄ±n birden fazla cihazda aktivasyonu varsa HHSânin iÃ§ sÃ¼reÃ§lerine gÃ¶re mevcut durumda nasÄ±l bir bildirim sÃ¼reci iÅletiliyorsa aynÄ± Åekilde ilerlenebilir.  \n \n \n Kurumsal mÃ¼Återiler iÃ§in, hangi kullacÄ±ya bildirim gitmesi isteniyor ise, rÄ±za aÅamasÄ±nda o kiÅi ayrikGkd nesnesinde gÃ¶nderilir. HHS'nin rÄ±za iÃ§erisindeki ohkTur deÄerine gÃ¶re,  gelen bildirime verilen cevaba uygun uygulamasÄ±nÄ± aÃ§malÄ±dÄ±r. Kurumsal ÃHK iÃ§in rÄ±za geldi ise, kurumsal giriÅ sayfasÄ±; bireysel ÃHK iÃ§in rÄ±za geldi ise bireysel giriÅ sayfasÄ± mÃ¼Återinin Ã¶nÃ¼ne aÃ§Ä±lmalÄ±dÄ±r ve ilgili hesaplara eriÅime izin vermelidir. \n \n \n ÃHK'ya bir bildirim gelmemesi durumunda, HHS kendi sisteminde GKD sÃ¼recine devam edemez. 5 dakika sonunda rÄ±za durumu Yetki Bekleniyor'dan RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± (Ä°ptal kod 04) durumuna Ã§eker. \n \n \n \n \n ÃHK, HHS sisteminden gelen bildirim mesajÄ±nÄ± alÄ±r. HHS sistemine login olduktan sonra iÅleme onay verilmezse veya GKD kontrolleri baÅarÄ±sÄ±z olursa HHS Olay Bildirim servisleri aracÄ±lÄ±ÄÄ± ile GKD sÃ¼recinin sonlandÄ±ÄÄ±nÄ± YÃS'e iletir. Olay tipi \"AYRIK_GKD_BASARISIZ\" olacak Åekilde bir POST /olay-dinleme servis Ã§aÄrÄ±sÄ± yapÄ±lÄ±r.YÃS kendisine gelen olay bildirimi ile\nrÄ±za sorgulamasÄ± yaparak iptal detay kodunu Ã¶Ärenebilir. \n \n \n ÃHK, HHS sisteminde login olduktan sonra iÅleme onay verirse; HHS tarafÄ±ndan rÄ±za ile iliÅkili yetkod deÄeri Ã¼retilir.HHS, YÃS'e ÃHK iÃ§in \"yetkod\" deÄeri Ã¼retildiÄinin bilgisini Olay Bildirim servisleri aracÄ±lÄ±ÄÄ± ile iletir. Olay tipi \"AYRIK_GKD_BASARILI\" olacak Åekilde bir POST /olay-dinleme servis Ã§aÄrÄ±sÄ± yapÄ±lÄ±r. \n \n \n YÃS kendisine gelen olay bildirimi ile \"yetkod\" deÄerinin HHS'de Ã¼retildiÄinin bilgisini alÄ±r. \"yetkod\" deÄerini Ã¶Ärenebilmek iÃ§in HHS'yi sorgulamasÄ± gerekmektedir.  \nHHS'nin aÃ§acaÄÄ±   GET /yetkilendirme-kodu endpointi   ile bu bilgiye eriÅebilir. \n \n \n YÃS, \"yetkod\" ile POST /erisim-belirteci endpointinden eriÅim belirteci alÄ±r. BÃ¶ylelikle ÃHK'nÄ±n AyrÄ±k GKD sÃ¼reci tamamlanmÄ±Å olur. \n 5.3.\tYÃ¶nlendirme/Bildirim Adresleri ve Durum Kodu Parametresi \n CSRF AtaklarÄ±ndan korunmak iÃ§in ve YÃS uygulamasÄ±nÄ±n bir Ã¶nceki durumunu restore edebilmesi iÃ§in; YÃS tarafÄ±ndan iletilen yÃ¶nlendirme ve bildirim adreslerine , Oauth2 standartlarÄ±ndaki state parametresine eÅdeÄer,   durum ko

16du (drmKod)  parametresinin eklenmesi gerekmektedir. Durum kodu parametresi YÃS tarafÄ±ndan Ã¼retilen, tekil ve kolay tahmin edilemeyen bir deÄer olmalÄ±dÄ±r. RÄ±za isteÄi gÃ¶nderimi aÅamasÄ±nda oluÅturulmalÄ±dÄ±r. YÃS uygulamasÄ±nda uygun bir yerde saklanmalÄ±dÄ±r (cookie, session, local storage gibi) . \n Durum kodu, rÄ±za isteÄindeki yÃ¶nlendirme adresine parametre olarak eklenir.  GKD sÃ¼reci sonrasÄ±nda yetki kodu ile birlikte bu bilgi, HHS tarafÄ±ndan YÃSâe iletilir. YÃS sakladÄ±ÄÄ± deÄer ile parametre olarak gelen deÄerin eÅitliÄini kontrol eder. AynÄ± ise eriÅim belirteci almak Ã¼zere akÄ±ÅÄ± ilerletir. FarklÄ± ise iÅlemi keser. \n 5.4  GÃ¼Ã§lÃ¼ Kimlik DoÄrulama Kontrolleri \n ÃHK, GKD iÃ§in HHS uygulamasÄ±na yÃ¶nlendirildiÄinde, HHSânin Ã§eÅitli kontroller yaparak iÅlemin doÄruluÄunu teyit etmesi gerekmektedir.\nYapÄ±lmasÄ± gereken kontrollere ait temel senaryolar aÅaÄÄ±daki tabloda belirtilmiÅtir. Bu senaryolar baz alÄ±narak HHSâler tarafÄ±ndan zenginleÅtirilebilir. \n AÅaÄÄ±daki tabloda yer alan 07-13 arasÄ± RÄ±za Ä°ptal Detay KodlarÄ±nÄ±n oluÅtuÄu senaryolar, HHS uygulamasÄ±nda yapÄ±lan kullanÄ±cÄ± doÄrulama Ã¶ncesi ve sonrasÄ± olarak iki adÄ±mda incelenmelidir. \n HHS tarafÄ±nda, kullanÄ±cÄ± doÄrulama Ã¶ncesinde yapÄ±lan kontroller neticesinde verilemeyen rÄ±zalar iÃ§in â04â : SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor iptal kodu atanÄ±r. HHS'nin YÃS uygulamasÄ±na 04 kodunu iletmesi beklenmez. YÃS zaman aÅÄ±mÄ± neticesinde rÄ±za statÃ¼sÃ¼nÃ¼ sorgulayarak Ã¶Ärenir. \nKullanÄ±cÄ± doÄrulandÄ±ktan sonra rÄ±za verilemiyorsa ilgili hata kodunun YÃS'e iletilmesi beklenmektedir. KullanÄ±cÄ± doÄrulama sonrasÄ± YÃS'e iletilen rÄ±za iptal detay kodu ile HHS veri modelinde tutulan rÄ±za ile iliÅkili rÄ±za iptal detay kodu, aynÄ± deÄeri alacak Åekilde gÃ¼ncellenmelidir. YÃS, HHS tarafÄ±ndan kendine iletilen rÄ±za iptal detay kodunu kendi veri modelinde gÃ¼ncellemelidir. \n Zorunlu olarak belirtilen hata durumlarÄ±nÄ±n HHSâler tarafÄ±ndan gerÃ§eklenmesi ve uygun hata kodlarÄ±nÄ±n YÃSâe iletilmesi; ileride oluÅabilecek mutabakatlaÅma sorunlarÄ±nÄ± ortadan kaldÄ±rabilecek, yapÄ±lacak raporlamalar kapsamÄ±nda sistem ve sÃ¼reÃ§ iyileÅtirmelerine katkÄ± saÄlayacak, son kullanÄ±cÄ± aÃ§Ä±sÄ±ndan da alÄ±nan hataya yÃ¶nelik bilgilendirici iÃ§erik saÄlayacaktÄ±r. \n Hata aÃ§Ä±klamalarÄ±; hata koduna uygun ya da uyumlu olmak kaydÄ±yla, HHS ve YÃS tarafÄ±ndan farklÄ± Åekillerde sunulabilir. \n GKD SÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller \n \n \n \n RÄ±za Ä°ptal Detay Kodu \n HHS hata aÃ§Ä±klamasÄ±* \n YÃ¶s ekranÄ±nda listelenecek Ã¶rnek mesaj metni* \n Ãrnek Senaryo \n Zorunlu / Opsiyonel \n \n \n \n \n 07 \n RÄ±za mevcut ve durumu \"Yetkilendirildi\" veya \"Yetki KullanÄ±ldÄ±\" \n Yetki HatasÄ± \n ÃHK,  kullanÄ±cÄ± doÄrulama iÅlemi tamamlandÄ±ktan sonra  YÃS ekranÄ±nda ileri - geri yaparak ya da ÃHK'nÄ±n yÃ¶nlendirme adresini kopyalayarak tarayÄ±cÄ±ya yapÄ±ÅtÄ±rmasÄ± ile tekrar HHS'ye yÃ¶nlendirir. Bu durumda HHS bu rÄ±za iptal detay kodunu iletir. HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 08 \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±. \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n YÃS tarafÄ±ndan baÅlatÄ±lan rÄ±za iÃ§erisinde yer alan kimlik bilgisi (Ã¶rn:TCKN) ile HHS'de baÅarÄ±lÄ± kimlik doÄrulama yapÄ±lan ÃHK'nÄ±n bilgilerinin uyuÅmadÄ±ÄÄ± durumda  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 09 \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) \n GÃ¶sterilebilecek hesap/kart bulunamamÄ±ÅtÄ±r. \n HHS, kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra, ÃHK'nÄ±n uygun statÃ¼lÃ¼ hesabÄ±nÄ±n olmadÄ±ÄÄ± durumda  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 10 \n ÃHK'nÄ±n AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n ÃHK'nÄ±n AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n AÃ§Ä±k bankacÄ±lÄ±ÄÄ± ayrÄ± bir kanal olarak tanÄ±mlamÄ±Å HHS'lerde,  ÃHK kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra yapÄ±lan kontrollerde, ÃHK'nÄ±n iÅlemlerini AB kanalÄ±na kapatmÄ±Å olmasÄ± durumunda   HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Opsiyonel \n \n \n 11 \n ÃHK'nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmamasÄ± \n Yetki hatasÄ± \n 1- Kurumsal firma kullanÄ±cÄ±larÄ±nÄ±n hesaplar Ã¼zerinde iÅlem yetkisinin olmamasÄ± durumunda   2- Bireysel ortak hesaplarda hesap kÄ±sÄ±tÄ± bulunuyorsa (para Ã§Ä±kÄ±ÅÄ±na izin verilmediÄi durum)  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Zorunlu \n \n \n 12 \n HHSânin,  ÃHK Ã¶zelinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ± \n Yetki hatasÄ± \n HHS'nin, kullanÄ±cÄ± doÄrulama sonrasÄ± ÃHK iÃ§in iÃ§ sistemlerinde yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olmasÄ±. ÃrneÄin: MÃ¼Återinin henÃ¼z bankacÄ±lÄ±k hizmet sÃ¶zleÅmesi gibi Internet Åubesi Ã¼zerinde iÅlem yapmasÄ±nÄ± engelleyen eksikleri olmasÄ± durumunda veya kurumsal kullanÄ±cÄ±da vekalet sÃ¼resinin dolmasÄ±/eksik dokÃ¼man olmasÄ± durumunda kanal Ã¼zerinde iÅlem yapamadÄ±ÄÄ± durum  HHS ve YÃS'ler veri modellerini bu bilgi doÄrultusunda gÃ¼ncellemelidir. \n Opsiyonel \n \n \n 13 \n ÃHK isteÄi ile GKDâden vazgeÃ§ilmesi \n MÃ¼Återi iÅlemden vazgeÃ§miÅtir. \n HHS ekranÄ±nda yer alan VAZGEÃ butonuna basÄ±lmasÄ± durumu (ÃHK,HHS uygulamasÄ±nda kullanÄ±cÄ± doÄrulama yaptÄ±ktan sonra VAZGEÃ butonu olabilir.) \n Zorunlu \n \n \n 14 \n GKD Ä°ptali: Fraud ÅÃ¼phesi \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n HHS Fraud ÅÃ¼phesi nedeniyle iÅlemin devamÄ±na izin vermez. HHS'nin, fraud kontrollerinin Ã¶deme baÅlatma hizmeti iÃ§in yapmasÄ± ve â14- GKD Ä°ptali: Fraud ÅÃ¼phesiâ ile rÄ±za iptalini gerÃ§ekleÅtirmelidir. HBH servislerinde HHS'nin rÄ±za iptal kodu 14 ile iÅlemi kesmesi HHS'nin kendi insiyatifindedir yani opsiyoneldir. \n KoÅullu \n \n \n 99 \n DiÄer \n Ä°Ålem gerÃ§ekleÅtirilememiÅtir. \n OluÅabilecek diÄer senaryolar. \n Zorunlu \n \n \n \n GKD sÄ±rasÄ±nda iletilen rÄ±za no eÄer HHSânin sisteminde bulunamazsa durumu gÃ¼ncellenecek bir rÄ±za no da olmayacaktÄ±r. HHS kendi Ã¶nyÃ¼zÃ¼nde bu duruma uygun bir mesaj gÃ¶sterebilir. YÃSâe de DiÄer hata kodu ile bu durumu iletebilir. \n"},{title:"9.\tHesap Bilgisi Hizmeti",frontmatter:{},regularPath:"/v2.0.1/contents/hesap-bilgisi-hizmeti.html",relativePath:"v2.0.1/contents/hesap-bilgisi-hizmeti.md",key:"v-16682afd",path:"/v2.0.1/contents/hesap-bilgisi-hizmeti.html",headers:[{level:2,title:"Genel Bilgiler",slug:"genel-bilgiler"},{level:2,title:"Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri",slug:"hesap-bilgisi-hizmeti-icin-erisim-adresleri"}

16,{level:2,title:"ADIM 0: ÃHK'nÄ±n hesap/kart bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:",slug:"adim-0-ohk-nÄ±n-hesap-kart-bilgilerine-erisim-icin-talepte-bulunmasÄ±"},{level:2,title:"9.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_9-1-adim-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:3,title:"POST /hesap-bilgisi-rizasi",slug:"post-hesap-bilgisi-rizasi"},{level:3,title:"BaÅarÄ±lÄ± Ä°stek:",slug:"basarÄ±lÄ±-istek"},{level:3,title:"BaÅarÄ±lÄ± YanÄ±t:",slug:"basarÄ±lÄ±-yanÄ±t"},{level:2,title:"Ä°zinler",slug:"izinler"},{level:2,title:"9.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi",slug:"_9-2-adim-2-hesap-bilgisi-hizmeti-rÄ±zasÄ±nÄ±n-tesisi"},{level:2,title:"9.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ±",slug:"_9-3-adim-2-1-hesap-bilgisi-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±"},{level:2,title:"9.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali",slug:"_9-4-adim-2-2-hesap-bilgisi-rÄ±zasÄ±nÄ±n-iptali"},{level:2,title:"9.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ±",slug:"_9-5-adim-3-hesap-bilgilerinin-alÄ±nmasÄ±"},{level:2,title:"9.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ±",slug:"_9-6-adim-3-1-ve-3-2-hesap-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"9.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ±",slug:"_9-7-adim-3-3-ve-3-4-hesap-bakiyesinin-sorgulanmasÄ±"},{level:2,title:"9.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ±",slug:"_9-8-adim-3-5-ve-3-6-islemlerin-sorgulanmasÄ±"},{level:2,title:"9.9 ADIM 4: Kart Bilgilerinin SorgulanmasÄ±",slug:"_9-9-adim-4-kart-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"9.10 ADIM 4.1: Kart Detay Bilgilerinin SorgulanmasÄ±",slug:"_9-10-adim-4-1-kart-detay-bilgilerinin-sorgulanmasÄ±"},{level:2,title:"9.11 ADIM 4.2: Kart Hareket Bilgilerinin SorgulanmasÄ±",slug:"_9-11-adim-4-2-kart-hareket-bilgilerinin-sorgulanmasÄ±"}],content:" 9.\tHesap Bilgisi Hizmeti  \n Genel Bilgiler \n Bu dokÃ¼manda belirtilen \"Hesap Bilgisi Hizmeti\" ibaresi hem hesap hem de kart rÄ±za sÃ¼reÃ§lerini kapsamaktadÄ±r. \n Hesap bilgisi sorgulama iÃ§in HBHS tarafÄ±ndan mÃ¼Återi rÄ±zasÄ± tesisinin HHS tamamlanmÄ±Å olmasÄ± gerekir. MÃ¼Återi rÄ±zasÄ± tesisi tamamlandÄ±ktan sonra, HBHS sorgulamak istediÄi hesaba ait verileri ilgili eriÅim adresi Ã¼zerinden sorgular. \n \n \n Åekil 10: Hesap Bilgisi Hizmeti Ãst DÃ¼zey AkÄ±ÅÄ± \n Åekil-10âda sunulan hesap bilgisi hizmeti 5 temel akÄ±Åtan oluÅur: \n 0.\tMÃ¼Återinin hesap bilgilerine eriÅim iÃ§in talepte bulunmasÄ±:  ÃHK ÃBHS mobil uygulama ya da web sitesinden hesap bilgilerine eriÅim iÅlemini baÅlatÄ±r. \n 1.\tHesap Bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n hazÄ±rlanmasÄ±: \n HBHS, âhesap/kart bilgilerine eriÅimâ iÃ§in mÃ¼Återi rÄ±zasÄ± tesisi amacÄ±yla HHSâdeki hesap bilgisi rÄ±zasÄ± eriÅim adresine bir POST isteÄinde bulunur ve bir hesap bilgisi rÄ±zasÄ± nesnesi oluÅturur. HHS hesap bilgisi rÄ±zasÄ± nesnesi iÃ§in biricik tanÄ±mlayacÄ± dÃ¶ner (RÄ±zaNo). Hesap bilgisi rÄ±zasÄ±, mÃ¼Återinin HBHSânin hesap/kart bilgilerine eriÅim izin verdiÄi alanlarÄ± iÃ§in 9.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± baÅlÄ±ÄÄ±nda incelenebilir. \n 2.\tHesap bilgisi hizmeti mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi: \n HHS, Hesap Bilgisi RÄ±zasÄ± servisi ile ÃHK Ã¶zelinde âYetki bekleniyorâ statÃ¼sÃ¼nde bir rÄ±za nesnesi hazÄ±rlar. HHS, GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda hesap bilgisi rÄ±zasÄ± nesnesinin yetkilendirildiÄini belirtmek iÃ§in RÄ±za Durumunu âRÄ±za Yetkilendirildiâ olarak gÃ¼nceller. Nesne yetkilendirildikten sonra HHS nesne ile bir eriÅim belirteci (access token) iliÅkilendirir, RÄ±za Durumunu âYetki KullanÄ±ldÄ±â yapar ve bu belirteci HBHSâye geri dÃ¶ner.  BÃ¶ylece mÃ¼Återi rÄ±za tesisi saÄlanmÄ±Å olur. \n Hesap bilgisi rÄ±zasÄ±na iliÅkin temel ilkeler ÅunlardÄ±r: \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de Yetki Bekleniyor, Yetkilendirildi, Yetki KullanÄ±ldÄ± statÃ¼sÃ¼nde 1 rÄ±zasÄ± olabilir. \n MÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± ÃHK ile HBHS arasÄ±nda belirlenir. Bu nedenle mÃ¼Återi rÄ±zasÄ±nÄ±n ayrÄ±ntÄ±larÄ± HHS ekranÄ±nda deÄiÅtirilmemelidir. \n ÃHK, hesap ve kart eriÅim izni ayrÄ±ntÄ±larÄ±nÄ± yalnÄ±zca bir bÃ¼tÃ¼n olarak yetkilendirebilir veya geri alabilir. \n MÃ¼Återi rÄ±zasÄ± tesisi esnasÄ±nda, mÃ¼Återi HHS arayÃ¼zÃ¼nde eriÅim iÃ§in yetkilendirecek hesaplarÄ± ve kartlarÄ± seÃ§er. \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN hizmeti sunmayabildikleri iÃ§in hesap referansÄ± ile akÄ±ÅlarÄ±nÄ± kurgulayabilirler. YÃS Ã¶nyÃ¼zlerinde yapÄ±lan bilgilendirmelerde, IBAN harici hesap referansÄ± ile iÅlem yapÄ±labilmesine dikkat edilmelidir. \n \n 2.1\tHesap bilgisi rÄ±zasÄ±nÄ±n sorgulanmasÄ±:  MÃ¼Återi rÄ±zasÄ±  GET/hesap-bilgisi-rizasi/{RizaNo}  Ã§aÄrÄ±sÄ± yapÄ±larak sorgulanÄ±r. \n 2.2\tHesap bilgisi mÃ¼Återi rÄ±zasÄ±nÄ±n iptali:  MÃ¼Återi rÄ±zasÄ±  DELETE/hesap-bilgisi-rizasi/{RizaNo}

16  Ã§aÄrÄ±sÄ± yapÄ±larak iptal edilir. \n 3.1\tHesap bilgilerinin alÄ±nmasÄ±:  Hesap bilgileri ilgili kaynaÄa (hesaplar, bakiye, iÅlemler) GET isteÄi yapÄ±larak gerÃ§ekleÅtirilir. HBHS, mÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden sonrasÄ±nda (geÃ§erli bir eriÅim belirticine sahip olduÄunda) Ã¶ncelikle  GET/hesaplar  Ã§aÄrÄ±sÄ± yapacaktÄ±r. \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±) mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin HBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini (Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n 4.\tKart bilgilerinin alÄ±nmasÄ±:   Kart bilgileri ilgili kaynaÄa (kartlar, kart detayÄ±, kart hareketleri) GET isteÄi yapÄ±larak gerÃ§ekleÅtirilir. HBHS, mÃ¼Återi rÄ±zasÄ±nÄ±n tesisinden sonrasÄ±nda (geÃ§erli bir eriÅim belirticine sahip olduÄunda) Ã¶ncelikle  GET/kartlar  Ã§aÄrÄ±sÄ± yapacaktÄ±r. \n Hesap Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n Etki AlanÄ± (Scope) =âhesap_bilgisiâ \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n hesap-bilgisi-rizasi \n POST \n /hesap-bilgisi-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n HesapBilgisiRizasiIstegi \n HesapBilgisiRizasi \n \n \n 2 \n erisim-belirteci  (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n \n HesapBilgisiRizasi \n \n \n 2.2 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD-KoÅullu) \n \n \n \n \n \n \n 3.1 \n hesaplar \n GET \n /hesaplar \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n HesapBilgileri(birden Ã§ok hesap) \n \n \n 3.2 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n HesapBilgileri(tek  hesap) \n \n \n 3.3 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n \n \n BakiyeBilgileri(tek  hesap) \n \n \n 3.4 \n bakiye \n GET \n /bakiye \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama \n \n BakiyeBilgileri(birden Ã§ok hesap) \n \n \n 3.5 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n IslemBilgileri (tek hesap) \n \n \n 4 \n kartlar \n GET \n /kartlar \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n KartBilgileri(birden Ã§ok kart) \n \n \n 4.1 \n kartlar \n GET \n /kartlar/{kartRef} \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n KartBilgileri(tek kart) \n \n \n 4.2 \n kart-detay \n GET \n /kartlar/{kartRef}/kart-detay \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Filtreleme \n \n KartDetayBilgileri \n \n \n 4.3 \n kart-hareketleri \n GET \n /kartlar/{kartRef}/kart-hareketleri \n Z \n Ä°stemci Kimlik Bilgileri ve Yetkilendirme Kodu (GKD) \n \n Sayfalama Filtreleme \n \n KartHareketleri \n \n \n \n Tablo 11: Hesap/Kart Bilgisi Hizmeti Ä°Ã§in EriÅim Adresleri \n ADIM 0: ÃHK'nÄ±n hesap/kart bilgilerine eriÅim iÃ§in talepte bulunmasÄ±: \n ÃHK, HBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) hesap/kart bilgilerine eriÅim iÃ§in talepte bulunur. \n 9.1 ADIM 1: Hesap Bilgisi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n Bu dokÃ¼manda belirtilen hesap bilgisi hizmeti ibaresi hem hesap hem de kart rÄ±za sÃ¼reÃ§lerini kapsamaktadÄ±r. \n Bu API Ã§aÄrÄ±sÄ± HBHS'nin HHS'de yeni bir âHesapBilgisiRizasiâ nesnesi oluÅturmasÄ±nÄ± ve nesneye eriÅmek iÃ§in benzersiz bir rÄ±za numarasÄ± ({rizaNo}) dÃ¶nÃ¼lmesini saÄlar. \n API Ã§aÄrÄ±sÄ±nÄ±n baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± yeterlidir.\nBaÅarÄ±yla oluÅturulan hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n rÄ±za durumu âYetki Bekleniyorâ olarak dÃ¼zenlenir.\nÃHK daha Ã¶nce aldÄ±ÄÄ± rÄ±zaya iliÅkin er

16iÅim tarihleri, izin tÃ¼rlerini ve hesap bilgilerini gÃ¼ncellemek isterse, HBHS Ã¶nce HHS nezdindeki rÄ±zayÄ± iptal etmeli ve sonrasÄ±nda yeni bir rÄ±za talebinde bulunmalÄ±dÄ±r.\n \n \n Åekil 11: Hesap/Kart Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n POST /hesap-bilgisi-rizasi isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âHesapBilgisiRizasÄ±Istegiâ nesnesi (Tablo-12) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âHesapBilgisiRizasiâ (Tablo-13) nesnesi oluÅturulur. \n  POST /hesap-bilgisi-rizasi \n Bu dokÃ¼manda belirtilen hesap bilgisi rÄ±zasÄ± ibaresi hem hesap hem de kart rÄ±za sÃ¼reÃ§lerini kapsamaktadÄ±r. \n BaÅarÄ±lÄ± Ä°stek: \n Ä°STEK: \n HBHS, bu API eriÅim adresinden HHSâye yeni bir HesapBilgisiRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n HBHS, ÃHKânÄ±n hesap/kart bilgilerine yÃ¶nelik rÄ±za baÅlatma isteÄi olduÄunu HHSâye bildirir. YÃS'ler sÃ¼rÃ¼m 2.0 iÃ§in Hesap Bilgisi RÄ±zasÄ± isteÄi gÃ¶nderdiÄinde HHS'nin ÃHK'yÄ± yÃ¶nlendireceÄi mobil uygulama iÃ§erisinde sÃ¼rÃ¼m 2.0 deÄiÅikliklerini iÃ§eren, kart bilgilerinin seÃ§imini yapacaklarÄ± sÃ¼rÃ¼mÃ¼n yÃ¼klÃ¼ olmamasÄ± durumunda HHS'ler tarafÄ±ndan  TR.OHVPS.Business.CustomerMobileApplicationHasOlderVersion  hatasÄ± verilebilir. \n HBHS, ÃHKânÄ±n, HBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n API dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk ve uzunluk kontrollerini yapar.(Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  âTR.OHVPS.Resource.InvalidFormatâ  hata kodu iletilmeli ve fieldErrors dolu olacak Åekilde hatalÄ± alanÄ± belirten detaylÄ± aÃ§Ä±klama gÃ¶nderilmelidir. InvalidFormat hata kodlarÄ±nda fieldErrors iÃ§eriÄi gÃ¶nderilmeli ve anlaÅÄ±lÄ±r aÃ§Ä±klama ile message, messageTr alanlarÄ± doldurulmasÄ± zorunludur. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; YÃS API ile alÄ±nan temel adres bilgilerinde yer alan yÃ¶nlendirme adresleri ile hesap bilgisi rÄ±zasÄ± nesnesi iÃ§erisinde yer alan YÃS  adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  âTR.OHVPS.Business.TPPRedirectionAddressMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; kimlik bilgileri nesnesinde iletilen kimlik bilgileri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.(Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  âTR.OHVPS.Business.CustomerNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Kurumsal mÃ¼Återi ile baÅlatÄ±lan rÄ±zada yer alan mÃ¼Återi bilgisinin karÅÄ± kurumda Kurumsal mÃ¼Återi deÄil; bireysel mÃ¼Återi olduÄu durumda âTR.OHVPS.Business.BusinessCustomerMismatchâ hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Bir ÃHK'nÄ±n 1 YÃS iÃ§in aktif tek bir rÄ±zasÄ± olabilir. ÃHKânÄ±n  âYetkilendirildiâ ve âYetki KullanÄ±ldÄ±â statÃ¼sÃ¼nde rÄ±zasÄ± varken yeni bir rÄ±za isteÄi gÃ¶nderdiÄinde HHS tarafÄ±ndan  TR.OHVPS.Business.ConsentAlreadyExists  hatasÄ± dÃ¶nÃ¼lÃ¼r.  GÃ¼ncelleme isteÄi gÃ¶ndermesi durumunda ise iÅletilmesi gereken akÄ±Ålar âRÄ±za DurumlarÄ±â baÅlÄ±ÄÄ±ndan kontrol edilmelidir. \n Hesap bilgi hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n âAÃ§Ä±k BankacÄ±lÄ±k Kanal Yetkiâ tanÄ±mÄ± yok ise  âTR.OHVPS.Business.OpenBankingChannelClosedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n Hesap bilgi hizmeti rÄ±za isteÄinde 01 ya da 07 izin tÃ¼rÃ¼ olmak zorundadÄ±r. HHS tarafÄ±ndan izin tÃ¼rÃ¼ iÃ§erisinde 01 ya da 07 varlÄ±k durumu kontrol edilir. OlmamasÄ± durumunda  \"TR.OHVPS.Business.IncorrectPermissionTypeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap bilgi hizmeti rÄ±za isteÄinde 01 izin tÃ¼rÃ¼ bulunmuyor ise 02, 03, 04, 05 ya da 06 izin tÃ¼rÃ¼ olmamalÄ±dÄ±r. 01 izin tÃ¼rÃ¼ bulunmadÄ±ÄÄ±nda 02, 03, 04, 05 ya da 06 izin tÃ¼rlerinden biri ya da birkaÃ§Ä± gÃ¶nderildiÄinde  \"TR.OHVPS.Business.IncorrectPermissionTypeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap bilgi hizmeti rÄ±za isteÄinde 07 izin tÃ¼rÃ¼ bulunmuyor ise 08 ya da 09 izin tÃ¼rÃ¼ olmamalÄ±dÄ±r. 07 izin tÃ¼rÃ¼ bulunmadÄ±ÄÄ±nda 08 ya da 09 izin tÃ¼rlerinden biri ya da ikisi gÃ¶nderildiÄinde  \"TR.OHVPS.Business.IncorrectPermissionTypeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n ÃHK, HHS'de olacak bakiye deÄiÅikliklerinden anlÄ±k haberdar olmak istiyor ise 06-AnlÄ±k Bakiye Bildirimi izin tÃ¼rÃ¼ seÃ§imi ile rÄ±za baÅlatmasÄ± gereklidir. 03-Bakiye Bilgisi izin tÃ¼rÃ¼ ile birlikte seÃ§ilmesi gereklidir. 06 izin tÃ¼rÃ¼ seÃ§ilip 03 izin tÃ¼rÃ¼ seÃ§ilmediÄi durumda  âTR.OHVPS.Business.IncorrectPermissionTypeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°zin tÃ¼rÃ¼ â06: AnlÄ±k Bakiye Bildirimiâ seÃ§ilmiÅ ise HHS, YÃS'Ã¼n KAYNAK_GUNCELLENDI olay tipinde olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. Olay abonelik kaydÄ± bulunmuyor ise  âTR.OHVPS.Business.EventSubscriptionNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap bilgi hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n izin verecek hesap ya da kartÄ± yok ise  âTR.OHVPS.Business.ProductNotSuitableâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Ä°ki Ã¼rÃ¼nden biri var ise baÅarÄ±lÄ± yanÄ±t dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n EriÅimin GeÃ§erli OlduÄu Son Tarih bilgisi mÃ¼Återi baÄÄ±msÄ±z alabileceÄi minimum deÄer : RÄ±za tarihi + 1 gÃ¼ndÃ¼r. Maksimum rÄ±za sÃ¼resi bireysel mÃ¼Återiler iÃ§in 6 ay, Kurumsal/TÃ¼zel mÃ¼Återiler iÃ§in 12 ay olacaktÄ±r. Bireysel mÃ¼Återiler iÃ§in 6 aydan fazla, kurumsal mÃ¼Återiler iÃ§in ise 12 aydan fazla iletildiÄi durumda  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, hesap bilgisi rÄ±zasÄ± verilmesinden  geÃ§miÅe  dÃ¶nÃ¼k en fazla 12 ay olabilmektedir. 12 aydan fazla gÃ¶nderilmesi durumunda  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ±, hesap bilgisi rÄ±zasÄ± verilmesinden  geleceÄe  dÃ¶nÃ¼k en fazla 12 ay sonrasÄ± olabilmektedir. 12 aydan fazla gÃ¶nderilmesi durumunda  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  âTR.OHVPS.Business.DecoupledAuthenticationNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir. \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD ile baÅlatÄ±lan hesap bilgi hizmeti rÄ±za isteÄinde HHS, YÃSâÃ¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  âTR.OHVPS.Business.EventSubscriptionNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  âTR.OHVPS.Business.CustomerInfoMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda hata mesajÄ± vermelidir. HHS tarafÄ±ndan  âTR.OHVPS.Business.CustomerMobileApplicationNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, benzersiz âRizaNoâ ile âHesapBilgisiRizasiâ nesnesi oluÅturur ve HBHSâye dÃ¶ner. \n HHS, HesapBilgisiRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n Tablo 12: âHesapBilgisiRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ãnceki RÄ±za No \n oncekiRizaNo \n AN1..128 \n K \n HesapBilgisiRÄ±zasiIstegi nesnesinin gÃ¼ncelleme sebebiyle oluÅturulmasÄ± esnasÄ±nda ÃHK'nÄ±n gÃ¼ncelleme yapmak istediÄi mevcut rÄ±za no bilgisi. RÄ±za gÃ¼ncelleme yapÄ±lmak istendiÄinde gÃ¶nderilmesi zorunludur. \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. Hata durumunda TR.OHVPS.Connection.InvalidASPSP hata kodunu dÃ¶ner. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder.  Hata durumunda TR.OHVPS.Connection.InvalidTPP hata kodunu dÃ¶ner. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Yetkilendirme yÃ¶ntemi, HBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.   Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.OHKTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r.   TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir.   Kurum adÄ±na yapÄ±lan(ticari) iÅlemlerde kurum kullanÄ±cÄ±sÄ±nÄ±n bilgisi iletilmelidir. \n \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n \n Hesap/Kart Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n \n >Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih.   MÃ¼Återi YÃS ekranÄ±ndan bu deÄeri belirleyebilir. Bireysel mÃ¼Återiler iÃ§in rÄ±za sÃ¼resi 6 ay, Kurumsal/TÃ¼zel mÃ¼Återiler iÃ§in 12 ay olacaktÄ±r.    Bireysel MÃ¼Återiler iÃ§in varsayÄ±lan deÄer : RÄ±za verilen tarih + 6 ay   Kurumsal MÃ¼Återiler iÃ§in varsayÄ±lan deÄer : RÄ±za verilen tarih + 12 ay  Bireysel MÃ¼Återiler iÃ§in alabileceÄi maksimum deÄer : RÄ±za tarihi + 6 ay  Kurumsal MÃ¼Återiler iÃ§in alabileceÄi maksimum deÄer : RÄ±za tarihi + 12 ay    MÃ¼Återi baÄÄ±msÄ±z alabileceÄi minimum deÄer : RÄ±za tarihi + 1 gÃ¼n    ÃrneÄin  04/02/2023âde minimum 05/02/2023 seÃ§ilebilir. Bu durumda yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saati 00:00:00 olduÄu kabul edildiÄi iÃ§in; erisimIzniSonTrh deÄeri 2023-02-06T00:00:00+03:00 olmalÄ±dÄ±r.  HHS rÄ±za onay ekranlarÄ±nda YÃS'ten iletilen eriÅim izni son tarihi yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saati olarak iletildiÄinden ÃHK'ya gÃ¶sterilecek tarih eriÅim izninin biteceÄi gÃ¼n olarak gÃ¶sterilmelidir.  ÃrneÄe istinaden; ÃHK YÃSâde 05/02/2023 seÃ§miÅ ise HHS rÄ±za onay ekranÄ±nda 06/02/2023 gÃ¶rmemeli, bu iki tarihin aynÄ±, yani 05/02/2023 olacak Åekilde gÃ¶sterilmesi gerekmektedir.      Ãrnek rÄ±za oluÅ zamanÄ±  : 2023-02-04T21:20:20+03:00    1 gÃ¼nlÃ¼k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri:    2023-02-06T00:00:00+03:00 (26 saat 40 sakikalÄ±k rÄ±za vermiÅ oluyor.)    7 gÃ¼nlÃ¼k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri:  2023-02-12T00:00:00+03:00    1 aylÄ±k rÄ±za verildiÄinde erisimIzniSonTrh deÄeri :   2023-03-05-T00:00:00+03:00 \n Bu alanda bir deÄer bulunmadÄ±ÄÄ± durumda HHS hata dÃ¶nmelidir. \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geÃ§miÅe dÃ¶nÃ¼k en fazla 12 ay olabilir, daha eski olmamasÄ± gerekir.   VarsayÄ±lan deÄeri rÄ±za verilen tarih (iÅlem zamanÄ±) â 12 aydÄ±r.   ÃHK bu alana bir deÄer giriÅi saÄlamÄ±Å ise zaman bilgisi Ã¼retilirken ekrandan girilen tarihe 00:00:00 zaman bilgisi eklenmelidir. ÃHK deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.   Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  - 12 ay    Maksimum tarih: RÄ±zanÄ±n veriliÅ tarihi +  12 ay    Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve  Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap bilgisi rÄ±zasÄ± verilmesinden geleceÄe dÃ¶nÃ¼k en fazla 12 ay sonrasÄ± olabilir, daha ileri bir tarih olmamasÄ± gerekir.   VarsayÄ±lan deÄeri: RÄ±za verilen tarih + 12 aydÄ±r. ÃHK bu alana bir deÄer giriÅi saÄlamÄ±Å ise girdiÄi tarihe 1 gÃ¼n eklenir ve yeni gÃ¼nÃ¼n ilk saati kabul edilen 00:00:00 saat bilgisini ekler.  ÃHK bu alana bir deÄer giriÅi saÄlamamÄ±Å ise ÃBHS varsayÄ±lan deÄerlerle bu alanÄ± doldurarak, HHSâye iletir.  Minimum tarihi : RÄ±zanÄ±n veriliÅ tarihi  â 12 ay  Maksimum tarihi :  RÄ±zanÄ±n veriliÅ tarihi + 12 ay   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur.  Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ise gÃ¶nderilmemelidir. EÄer dolu gÃ¶nderilirse HHS tarafÄ±ndan uygun hata mesajÄ± iletilmelidir. \n ÃHK tarafÄ±ndan izin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmemiÅ ve Ä°Ålem Sorgulama BitiÅ ZamanÄ± ÃBHS tarafÄ±ndan dolu olarak gÃ¶nderilmiÅ ise HHS tarafÄ±ndan iÅlemin devamÄ±na izin verilmez.   Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ilmiÅ ise; HHS bu alanÄ±n alabileceÄi minimum ve maksimum deÄerlerin sÄ±nÄ±rlar iÃ§erisinde olduÄunu kontrol eder. \n BaÅarÄ±lÄ± YanÄ±t: \n Tablo 13: HesapBilgisiRizasi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Ãnceki RÄ±za No \n oncekiRizaNo \n AN1..128 \n K \n HesapBilgisiRÄ±zasiIstegi nesnesinin gÃ¼ncelleme sebebiyle oluÅturulmasÄ± esnasÄ±nda ÃHK'nÄ±n gÃ¼ncelleme yapmak istediÄi mevcut rÄ±za no bilgisi. RÄ±za gÃ¼ncelleme yapÄ±lmak istendiÄinde gÃ¶nderilmesi zorunludur. Ä°stekte gÃ¶nderilen deÄer aynÄ± Åekilde yanÄ±tta dÃ¶nÃ¼lmelidir. \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. Ãrn; hesap bilgi rÄ±zasÄ±nÄ±n tesisine dair ilk istek mesajÄ±na dÃ¶nÃ¼Åte âB: Yetki Bekleniyorâ deÄerini almasÄ± beklenir. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄ

16u durumda zorunludur. \n \n \n Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n > Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r.  TR.OHVPS.DataCode.KurumKimlikTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.  TR.OHVPS.DataCode.KurumKimlikTur deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n > Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r (B: Bireysel, K:Kurumsal) \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir.  TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde\tGKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.  HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir. RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Hesap/Kart Bilgisi \n hspBlg \n Kompleks: HesapBilgisi \n Z \n \n \n \n > Ä°zin Bilgisi \n iznBlg \n Kompleks: IzinBilgisi \n Z \n \n \n \n >> Ä°zin TÃ¼rÃ¼ \n iznTur \n Array[AN2] \n Z \n ÃHK tarafÄ±ndan HBHS Ã¶nyÃ¼zÃ¼nde belirlenen izin tipleridir. Bir istekte birden fazla deÄer bulunabilir, TR.OHVPS.DataCode.IzinTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> EriÅimin GeÃ§erli OlduÄu Son Tarih \n erisimIzniSonTrh \n ISODateTime \n Z \n Hesap bilgisi rÄ±zasÄ±nÄ±n geÃ§erli olduÄu son tarih \n \n \n >> Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi baÅlangÄ±Ã§ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n >> Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsZmn \n ISODateTime \n K \n Hesap hareketlerinin sorgunabileceÄi bitiÅ zamanÄ±. Ä°zin tÃ¼rÃ¼ âTemel iÅlem Bilgisiâ ve/veya âAyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisiâ seÃ§ildiÄinde bu alanlarÄ±n doldurulmasÄ± zorunludur. \n \n \n > AyrÄ±ntÄ± Bilgi \n ayrBlg \n Kompleks: AyrintiBilgi \n Ä° \n \n \n \n > ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n Ä°zinler \n Bir hesap bilgisi rÄ±zasÄ± kaynaÄÄ± Ã§aÄrÄ±sÄ±na yanÄ±t olarak dÃ¶ndÃ¼rÃ¼len verileri sÄ±nÄ±rlamak iÃ§in izin kodlarÄ± kullanÄ±lÄ±r. \n Hesap ve karta dair tÃ¼m bilgiler hesap bilgisi rÄ±zasÄ± altÄ±nda alÄ±nacaktÄ±r. Ä°zin tÃ¼rleri hesap ve karta gÃ¶re ayrÄ±ÅmaktadÄ±r. \n \n Temel Hesap Bilgisi \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n Bakiye Bilgisi \n Temel Ä°Ålem (Hesap Hareketleri) Bilgisi \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n AnlÄ±k Bakiye Bildirimi \n Temel Kart Bilgisi \n DetaylÄ± Kart Bilgisi \n AyrÄ±ntÄ±lÄ± Kart Ä°Ålem Bilgisi \n \n ÃHKâya sunulacak seÃ§imler ve kurallarÄ± aÅaÄÄ±daki gibi olmalÄ±dÄ±r. \n \n \n \n SeÃ§im \n Kural \n \n \n \n \n Temel Hesap Bilgisi \n ÃHK seÃ§im yapabilir. Temel Kart Bilgisi seÃ§ilmediyse bu izin tÃ¼rÃ¼nÃ¼n seÃ§imi zorunludur. \n \n \n AyrÄ±ntÄ±lÄ± Hesap Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Bakiye Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n Temel Ä°Ålem (Hesap Hareketleri)  Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi \n ÃHK seÃ§im yapabilir. AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi seÃ§imi Temel Ä°Ålem Bilgisi seÃ§imini kapsar. (AyrÄ±ntÄ±lÄ± Ä°Ålem bilgisi seÃ§ildiÄinde Temel Ä°Ålem Bilgisi de seÃ§ili olmalÄ±dÄ±r.) \n \n \n AnlÄ±k Bakiye Bildirimi \n Bakiye Bilgisi izin tÃ¼rÃ¼ ile birlikte seÃ§ilmesi gereklidir. ÃHK, HHS'de olacak bakiye deÄiÅikliklerinden anlÄ±k haberdar olmak istiyor ise bu izin tÃ¼rÃ¼ seÃ§imi ile rÄ±za baÅlatmasÄ± gereklidir. \n \n \n Temel Kart Bilgisi \n ÃHK seÃ§im yapabilir. Temel Hesap Bilgisi seÃ§ilmediyse bu izin tÃ¼rÃ¼nÃ¼n seÃ§imi zorunludur. \n \n \n DetaylÄ± Kart Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n AyrÄ±ntÄ±lÄ± Kart Ä°Ålem Bilgisi \n ÃHK seÃ§im yapabilir. \n \n \n \n AÅaÄÄ±daki durumlarda, izin kombinasyonlarÄ±na izin verilmez. HHS, bu hesap eriÅim onaylarÄ±nÄ± 400 (HatalÄ± Ä°stek) yanÄ±t ko

16duyla reddetmelidir: \n \n Ä°zin dizisinin herhangi bir izin tÃ¼rÃ¼ iÃ§ermemesi durumu, \n Ä°zin dizisinde HHS tarafÄ±ndan desteklenmeyen bir izin kodunun yer almasÄ± durumu \n 9.2 ADIM 2: Hesap Bilgisi Hizmeti RÄ±zasÄ±nÄ±n Tesisi \n \n \n Åekil 12: Hesap Bilgisi ÃHK RÄ±zasÄ±nÄ±n Tesisi \n RÄ±za tesisinin baÅarÄ±yla sonuÃ§lanmasÄ± iÃ§in HBHS'nin istemci kimlik bilgileri yetkisi kullanmasÄ± ve ardÄ±ndan mÃ¼Återinin HHS tarafÄ±ndan yÃ¶nlendirmeli veya ayrÄ±k GKD ile doÄrulanmasÄ± gerekir. HHS'de oluÅturulan ve rÄ±za durumu âYetki Bekleniyorâ olan bir hesap bilgisi rÄ±zasÄ±, GKD sonrasÄ± âYetkilendirildiâ statÃ¼sÃ¼ne gÃ¼ncellenir. HBHS, eriÅim saÄlayacaÄÄ± hesaplarÄ± ve kartlarÄ± hesap bilgisi rÄ±zasÄ±nÄ±n tesisinden Ã¶nce seÃ§er. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda, HBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n \n HBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n \n \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n ÃHKâyÄ± doÄrularsa, \n \n \n ÃHK HBHS Ã¼zerinden iÅlem yapÄ±lmasÄ±na izin vereceÄi hesap/kart seÃ§imini y

16apar. HBHS Ã¼zerinden ÃHKânÄ±n verdiÄi izin bilgilerini ve eriÅim izninin baÅlangÄ±Ã§/bitiÅ tarihi bilgilerini, HHS'ler bilgilendirme amaÃ§lÄ± ÃHKâya gÃ¶sterir. \n \n \n RÄ±za gÃ¼ncelleme akÄ±ÅÄ± ile baÅlatÄ±lan rÄ±za isteklerinde mevcut rÄ±za iÃ§erisinde seÃ§ili olan hesap/kart bilgileri ÃHK'ya HHS ekranlarÄ±nda aynÄ± Åekilde seÃ§ili olarak getirilmelidir. ÃHK'lar mevcut rÄ±za iÃ§erisinde izin vermiÅ olduÄu hesap/kart bilgilerini seÃ§ili olarak gÃ¶rÃ¼ntÃ¼leyip yeni rÄ±za iÃ§in izin vermek istediÄi hesap/kartlarÄ±n seÃ§imini gÃ¼ncelleyebilmelidir. \n RÄ±za gÃ¼ncelleme sÃ¼recinde;  ÃHKânÄ±n HHSâdeki mevcut rÄ±zasÄ± kapsamÄ±nda YÃSâten gelen rÄ±za izin tÃ¼rlerine gÃ¶re listeleme yapÄ±lmalÄ±dÄ±r. 01,02,03,04,05,06 seÃ§ildiyse hesaplarÄ±n; 07,08,09 seÃ§ildiyse kartlarÄ±n HHSâde listelenmesi gerekmektedir. ÃrneÄin: ÃHKânÄ±n mevcut rÄ±zasÄ±nda hesaplar (01,02,03 rÄ±za tÃ¼rlerinin seÃ§ili olsun) iÃ§in hesap bilgisi rÄ±zasÄ± verilmiÅ olsun eÄer YÃSâten rÄ±za gÃ¼ncelleme kapsamÄ±nda 01,02, 07,08 rÄ±za tÃ¼rleri geldiÄi durumda HHSânin mevcut hesap rÄ±zasÄ±nÄ± ve doÄal olarak hesaplarÄ± listelemesi ek olarak da karta ait rÄ±za tÃ¼rleri seÃ§ildiÄinde kartlarÄ±n listelenmesi gerekecektir. Ancak, ÃHKânÄ±n mevcut rÄ±zasÄ±nda hesaplar (01,02,03 rÄ±za tÃ¼rlerinin seÃ§ili olsun) iÃ§in hesap bilgisi rÄ±zasÄ± verilmiÅ olsun eÄer YÃSâten rÄ±za gÃ¼ncelleme kapsamÄ±nda  07,08, 09 rÄ±za tÃ¼rleri geldiÄi farz edildiÄinde HHSânin mevcut hesap rÄ±zasÄ±nÄ± gÃ¶stermemesi ve sadece karta ait rÄ±za tÃ¼rleri seÃ§ildiÄi iÃ§in kartlarÄ± listelemesi gerekecektir. \n \n \n HHS hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=H&drmKod=zzz\n \n \n \n ÃHKâyÄ± doÄrulayamazsa, \n \n \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n \n \n HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile HBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I &rizaNo=yy&rizaTip=H&rizaIptDtyKod=11&drmKod=zzz\n \n \n \n \n \n \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda, HHS, ÃHKânÄ±n hesap bilgisi hizmetini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister. \n \n AyrÄ±k akÄ±Å HBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek hesap bilgisi rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, Ã¶deme hizmeti kullanÄ±cÄ±sÄ±nÄ± doÄrular. \n ÃHK verdiÄi izin tipi dahilinde bilgileri paylaÅÄ±lacak olan hesaplarÄ± seÃ§er. RÄ±za gÃ¼ncelleme akÄ±ÅÄ± ile baÅlatÄ±lan isteklerde ÃHK mevcutta vermiÅ olduÄu hesap ve kartlarÄ± seÃ§ili olarak gÃ¶rÃ¼ntÃ¼ler. Ä°lgili seÃ§imler Ã¼zerinde gÃ¼ncelleme saÄlayarak onay verir. \n HHS, hesap bilgisi rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS,  hesap bilgisi rÄ±zasÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. RÄ±za tesisi saÄlanmÄ±Å olur. \n 9.3 ADIM 2.1: Hesap Bilgisi RÄ±zasÄ±nÄ±n SorgulanmasÄ± \n GET /hesap-bilgisi-rizasi/{rizaNo} \n ÃHK, HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir veya ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.  Bu durumlarda HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir HesapBilgisiRizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. \n \n YÃS sadece kendi uygulamasÄ± Ã¼zerinden verilmiÅ hesap bilgi rÄ±zasÄ±nÄ± sorgulayabilir. YÃS'e ait olmayan bir rÄ±za ile sorgulama yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'e ait rÄ±za sorgulama yapÄ±lÄ±rken ilgili rÄ±za kaydÄ± bulunamaz ise  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 13âde belirtilen âHesapBilgisiRizasiâ nesnesini dÃ¶nmektedir. \n Durum \nHesapBilgisiRizasi kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n \n Yetki Bekleniyor \n \n \n Yetkilendirildi \n \n \n Yetki KullanÄ±ldÄ± \n \n \n Yetki S

16onlandÄ±rÄ±ldÄ± \n \n \n Yetki Ä°ptal \n \n \n Hesap bilgisi rÄ±zasÄ± sonlandÄ±rÄ±ldÄ± ve iptal statÃ¼sÃ¼nde olan rÄ±za'larÄ±n gÃ¼ncellenme zamanÄ±ndan(gnclZmn) 6 ay sonrasÄ±na kadar sorgulanabilir olmasÄ± beklenmektedir. HHS'ler ilgili sÃ¼re sonrasÄ±nda yapÄ±lacak rÄ±za sorgularÄ±na  \"TR.OHVPS.Resource.NotFound\"  uyarÄ±sÄ± verebilir. YÃS'ler tarafÄ±ndan iptal ve sonlandÄ±rÄ±ldÄ± statÃ¼sÃ¼nde olan rÄ±zalar iÃ§in sorgulama yapmamalÄ±dÄ±r. \n 9.4 ADIM 2.2: Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali \n \n \n \n Åekil 13: Hesap Bilgisi MÃ¼Återi RÄ±zasÄ±nÄ±n Geri AlÄ±nmasÄ± \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \n DELETE /hesap-bilgisi-rizasi Ã§aÄrÄ±sÄ±, bir HBHS'nin Ã¶nceden oluÅturulmuÅ bir hesap eriÅim rÄ±zasÄ±nÄ± (yetkili olsun veya olmasÄ±n) silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, HBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \nBu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin HBHS Ã¼zerinden hesap bilgisi rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki hesap bilgisi rÄ±zasÄ± nesnesinin silinmesini saÄlar. \n \n RÄ±za durumunun K olduÄu durumlarda eriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±za, silinen rizaNo bilgisi ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za Ä°ptali API'sinde ilgili rÄ±za kaydÄ± bulunamaz ise  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S veya Yetki Ä°ptal - I ise  \"TR.OHVPS.Resource.ConsentRevoked\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n MÃ¼Återinin HBHSânin veri eriÅim iznini iptal etmesi durumunda HBHS, HHSâde mevcut olan HesapBilgisiRizasi kaynaÄÄ±nÄ± pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa \n DELETE /hesap-bilgisi-rizasi/{RizaNo} \nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. HBHS ayrÄ±ca, sisteminden Hesap/Kart EriÅim Ä°zni kaynaklarÄ±nÄ± da temizlemelidir. \nSÃ¶z konusu silme iÅlemi, kayÄ±tlarÄ±n statÃ¼sÃ¼nÃ¼n pasife Ã§ekilmesi ile gerÃ§ekleÅtirilmelidir. SÃ¶z konusu kayÄ±tlar, denetim izlerinin oluÅturulmasÄ± ve saklanmasÄ±na iliÅkin ikincil dÃ¼zenleme hÃ¼kÃ¼mleri kapsamÄ±nda gÃ¼venli Åekilde tutulmalÄ±dÄ±r. \nServis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r. \nÃHK rÄ±zasÄ± baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ olarak gÃ¼ncellenir ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir. \nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir: \nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (HBHS) \n 9.5 ADIM 3: Hesap Bilgilerinin AlÄ±nmasÄ± \n    \n \n   \n Åekil 14: Hesap Bilgilerinin AlÄ±nmasÄ± \n Ä°STEK: \nMÃ¼Återi rÄ±zasÄ± tesis edilmiÅ kullanÄ±cÄ± iÃ§in HBHS API eriÅim adresinden HHSâye eriÅilebilir hesap bilgilerini GET isteÄi ile sorgular: \n \n Parametrede yer alan deÄerlerin doÄru gÃ¶nderildiÄi kontrol edilir. HatalÄ± gÃ¶nderilmesi durumunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Parametrede yer alan deÄerler gÃ¶nderilmediÄi durumda parametredeki varsayÄ±lan deÄerler ile hesap bilgileri dÃ¶nÃ¼lÃ¼r. VarsayÄ±lan deÄerler Tablo 14'de belirtilmiÅtir. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n /hesaplar/{hspRef} ile yapÄ±lan istekte;\n \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen hspRef'ler iÃ§in, hesap bilgisi sorgulanan hspRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili hspRef bulunamaz  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n RÄ±za durumu kontrol edilir.\n \n RizaDurumu B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'Ã¼n;

16 RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda hesap bilgileri servisini Ã§aÄÄ±rmamasÄ± beklenir. Bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âYetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n HHS tarafÄ±ndan ÃHKânÄ±n â01: Temel Hesap Bilgisiâ izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 01 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, \"HesapBilgileri\" nesnesini oluÅturur ve HBHSâye dÃ¶ner. \n \n Hesap bilgisi rÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinden herhangi bir hesabÄ±n kapatÄ±lmasÄ± ya da pasife alÄ±nmasÄ± durumunda YÃS tarafÄ±ndan yapÄ±lan hesap isteÄine HHS tarafÄ±ndan hesap bilgisi dÃ¶nÃ¼lmelidir. RÄ±za iÃ§erisinde tek bir hesap olmasÄ± halinde ilgili hesabÄ±n kapatÄ±lmasÄ± durumunda rÄ±za 09 iptal detay kodu ile iptal edilmelidir.\nKapalÄ± hesap iÃ§in TR.OHVPS.DataCode.HspDrm veri tÃ¼rÃ¼nden KAPALI deÄeri ile, pasif hesap iÃ§in TR.OHVPS.DataCode.HspDrm veri tÃ¼rÃ¼nden PASIF deÄeri ile dÃ¶nÃ¼lmelidir. \n 9.6 ADIM 3.1 ve 3.2: Hesap Bilgilerinin SorgulanmasÄ± \n GET /hesaplar ve GET /hesaplar/{hspRef} \n Bu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bilgileri sorgulanÄ±r. Hesap bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re (Temel Hesap Bilgisi veya DetaylÄ± Hesap Bilgisi) yanÄ±tÄ±nda dÃ¶nÃ¼len HesapBilgileri nesnesinin iÃ§eriÄi deÄiÅir. Tablo 15âte HesapBilgileri nesnesinin iÃ§eriÄi verilmiÅtir. \n Hesap Bilgisi Sorgu ÃrneÄi (TÃ¼m Hesaplar) =  /hesaplar \nHesap Bilgisi Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef} \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 14: Hesap Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa NumarasÄ± \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 15: âHesapBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasÄ± nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n Hesap Temel \n hspTml \n Kompleks: HesapTemel \n Z \n Temel Hesap Bilgileri (Temel Hesap Bilgisi varsayÄ±lan izin tÃ¼rÃ¼ olduÄundan Hesap Temel nesnesi zorunlu olarak yanÄ±tta bulunur) \n \n \n > Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hs

16pRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n > Hesap NumarasÄ± \n hspNo \n AN26 \n K \n EÄer varsa Ã¶deme hesabÄ±na ait IBAN bilgisi \n \n \n > Hesap Sahibi ÃnvanÄ± \n hspShb \n AN3..140 \n Z \n Hesap sahibi ya da hesap sahiplerinin ad-soyadÄ±, ticari Ã¼nvanÄ± \n \n \n > Åube AdÄ± \n subeAdi \n AN3..50 \n K \n EÄer varsa Ã¶deme hesabÄ±nÄ±n baÄlÄ± olduÄu Åubenin adÄ± \n \n \n > KÄ±sa Ad \n kisaAd \n AN3..50 \n K \n EÄer hesap sahibi hesaba ait bir ad tanÄ±mladÄ±ysa, tanÄ±mlanan hesap adÄ± \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi. \n \n \n > Hesap TÃ¼rÃ¼ \n hspTur \n AN1 \n Z \n HesabÄ±n tÃ¼rÃ¼ (bireysel veya ticari). TR.OHVPS.DataCode.HspTur sÄ±rali veri deÄerlerinden birini alÄ±r. \n \n \n > Hesap Tipi \n hspTip \n AN1..32 \n Z \n HesabÄ±n tipi (VADESÄ°Z, KREDÄ°LÄ° vb.).TR.OHVPS.DataCode.HspTip sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >Hesap ÃrÃ¼n AdÄ± \n hspUrunAdi \n AN1..140 \n Ä° \n HHS tarafÄ±ndan atanmÄ±Å olan Ã¼rÃ¼n adÄ± bilgisidir. HBHS tarafÄ±ndan ÃHKâya gÃ¶sterilmesi kullanÄ±m kolaylÄ±ÄÄ± saÄlayacaktÄ±r. \n \n \n > Hesap Durumu \n hspDrm \n AN5..50 \n Z \n HesabÄ±n durumunu belirtir. TR.OHVPS.DataCode.HspDrm sÄ±ralÄ± veri tÃ¼rlerinden birini alÄ±r. \n \n \n Hesap Detay \n hspDty \n Kompleks: HesapDetay \n K \n Detay Hesap Bilgileri (Temel Hesap Bilgisine ek olarak Detay Hesap Bilgisi izin tÃ¼rÃ¼ de seÃ§ilmiÅse Hesap Detay nesnesi koÅullu olarak yanÄ±tta bulunur) \n \n \n > AÃ§Ä±lÄ±Å Tarihi \n hspAclsTrh \n ISODateTime \n Z \n Belirtilen hesabÄ±n aÃ§Ä±lÄ±Å tarihi. \n 9.7 ADIM 3.3 ve 3.4: Hesap Bakiyesinin SorgulanmasÄ± \n GET /bakiye ve GET /hesaplar/{hspRef}/bakiye \nBu eriÅim noktalarÄ±ndan tÃ¼m hesaplarÄ±n veya belirli bir hesabÄ±n bakiyesi sorgulanÄ±r.   Ä°stek Ã§aÄrÄ±sÄ±na dÃ¶nÃ¼len âBakiyeBilgileriâ nesnesi Tablo 17âde verilmiÅtir. \n \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n /hesaplar/{hspRef}/bakiye ile yapÄ±lan istekte;\n \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen hspRef'ler iÃ§in, bakiye sorgusundaki hspRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili hspRef bulunamaz  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n RÄ±za durumu kontrol edilir.\n \n RizaDurumu B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'Ã¼n; RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda hesap bakiye servisini Ã§aÄÄ±rmamasÄ± beklenir. Bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âYetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n Hesap Bakiye SorgulanmasÄ± yapÄ±lÄ±rken HHS tarafÄ±ndan ÃHKânÄ±n â03: Bakiye Bilgisiâ izin tÃ¼rÃ¼ sahipliÄi kontrol edilir. 03 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, \"BakiyeBilgileri\" nesnesini oluÅturur ve HBHSâye dÃ¶ner. \n \n Hesap Bilgisi RÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinde yer alan hesaplardan kapatÄ±lmÄ±Å ya da pasif duruma alÄ±nmÄ±Å olan hesaplar iÃ§in bakiye isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan bakiye bilgisi dÃ¶nÃ¼lmelidir. \n \n Hesap bakiyelerinin gÃ¶sterilmesi sÄ±rasÄ±nda aÅaÄÄ±da verilen Ã¶rnekler gÃ¶zÃ¶nÃ¼nde bulundurulmalÄ±dÄ±r. \n Ãrnek 1 : ÃHK  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  0 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  -1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 2 : ÃHK  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  1 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  2000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 3 : ÃHK  Hesap Bakiye TutarÄ±  1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  0 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  0 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ãrnek 4 : ÃHK  Hesap Bakiye TutarÄ±  1000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL. ÃHK 1000 TL para Ã§Ä±kÄ±ÅÄ± gerÃ§ekleÅtirdi. Bakiye API'si yanÄ±tÄ± iÃ§erisinde iletilen  Kredi Dahil GÃ¶stergesi  1 deÄerini iÃ§eriyorsa,  Hesap Bakiye TutarÄ±  3000 TL,  Kredili Mevduat HesabÄ± Bakiyesi  3000 TL olmalÄ±dÄ±r. \n Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /bakiye?\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= hspRef &\nsrlmYon=A \n Tablo 16: âBakiyeBilgileriâ Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼

16yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek kayÄ±tlarÄ±n sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: { âhspRefâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini hspRef olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler:  A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 17: âBakiyeBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap ReferansÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hspRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n Bakiye \n bky \n Kompleks:Bakiye \n Z \n \n \n \n > Hesap Bakiye TutarÄ± \n bkyTtr \n AN1..25 \n Z \n HesabÄ±n bakiyesi. Bloke tutar dÃ¼ÅÃ¼lmeden iletilmelidir.   Tutar alanÄ± regex patterni Åu Åekildedir:  '^-?\\d{1,18}$|^-?\\d{1,18}\\.\\d{1,5}$' \n \n \n > Blokeli Tutar \n blkTtr \n AN1..24 \n K \n Varsa hesapta blokeli tutar bilgisi.     Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n > Bakiye Ä°letilme ZamanÄ± \n bkyZmn \n ISODateTime \n Z \n Bakiyenin iletildiÄi zaman bilgisi. \n \n \n > KrediliHesap \n krdHsp \n Kompleks: KrediliHesap \n K \n \n \n \n >> Kredili Mevduat HesabÄ± Bakiyesi \n kulKrdTtr \n AN1..24 \n Z \n Kredili mevduat tutarÄ±. Kredili bir hesap ise zorunlu.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n >> Kredi Dahil GÃ¶stergesi \n krdDhlGstr \n AN1 \n Z \n Kredili bir hesap ise zorunlu. Bakiye tutarÄ±nÄ±n kredi tutarÄ± dahil edilerek ya da edilmeden iletildiÄini gÃ¶sterir.   0: Kredi tutarÄ± dahil edilmeden bakiye bilgisi iletilmesi durumu   1: Kredi tutarÄ± dahil edilerek bakiye bilgisi iletilmesi durumu \n 9.8 ADIM 3.5 ve 3.6: Ä°Ålemlerin SorgulanmasÄ± \n GET /hesaplar/{hspRef}/islemler \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 19âda belirtilen \"IslemBilgileri\" nesnesini dÃ¶nmektedir. \n \n Belirli bir hesaba iliÅkin iÅlem bilgileri Tablo 18âdeki istek parametrelerine gÃ¶re sorgulanÄ±r. Parametrede yer alan deÄerlerin doÄru gÃ¶nderildiÄi kontrol edilir. HatalÄ± gÃ¶nderilmesi durumunda  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen hspRef'ler iÃ§in, iÅlemler sorgusundaki hspRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili hspRef bulunamaz  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n RizaDurumu B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'Ã¼n;

16 RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda iÅlemler servisini Ã§aÄÄ±rmamasÄ± beklenir. Bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âYetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n HHS tarafÄ±ndan ÃHKânÄ±n â04: Temel Ä°Ålem (Hesap Hareketleri) Bilgisiâ veya \"05: AyrÄ±ntÄ±lÄ± Ä°Ålem Bilgisi\" izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 04 veya 05 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ   hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n Hesap Bilgisi RÄ±zasÄ± alÄ±nmÄ±Å ve eriÅim izni devam eden hesaplar iÃ§erisinde yer alan hesaplardan kapatÄ±lmÄ±Å ya da pasif duruma alÄ±nmÄ±Å olan hesaplar iÃ§in iÅlemler isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan iÅlemler bilgisi dÃ¶nÃ¼lmelidir. \nÄ°Ålem bilgisi iÃ§in daha Ã¶nce tanÄ±mlanmÄ±Å izin tÃ¼rÃ¼ne gÃ¶re yanÄ±tta dÃ¶nen IslemBilgileri nesnesinin (Temel Ä°Ålem Bilgisi veya Temel Ä°Ålem Bilgisi ve DetaylÄ± Ä°Ålem Bilgisi) iÃ§eriÄi deÄiÅir. \nÄ°Ålemler servisi hem ÃHKânÄ±n talebi ile YÃS uygulamasÄ± Ã¼zerinden Ã§aÄrÄ±labileceÄi gibi, YÃSâÃ¼n ÃHKâsÄ±z baÅlatabileceÄi otomatik Ã§aÄrÄ±larÄ± ile de yanÄ±t dÃ¶nebilmektedir. \nHHS, iÅlemin sistemsel yapÄ±lÄ±p yapÄ±lmadÄ±ÄÄ±nÄ±, istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir.\nÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \nYÃS, otomatik yapacaÄÄ± sorgularda; \n \n Bireysel ÃHKâlar iÃ§in hesap bazÄ±nda gÃ¼nde en fazla 4 adet baÅarÄ± ile sonuÃ§lanan sorgulama yapabilir. 4 adetten fazla yapÄ±lmasÄ± durumunda  âTR.OHVPS.Connection.ExceededRateâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Kurumsal ÃHKâlar iÃ§in hesap bazÄ±nda saatte en fazla 12 adet baÅarÄ± ile sonuÃ§lanan sorgulama yapabilir. 12 adetten fazla yapÄ±lmasÄ± durumunda  âTR.OHVPS.Connection.ExceededRateâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n HHS, tutacaÄÄ± sayaÃ§ bilgisi ile bu sayÄ±larÄ± kontrol ederek daha fazla sorgulama yapÄ±lmasÄ±na izin vermeyebilir. \n AynÄ± istek parametreleri ile yapÄ±lan sorgu sonucunda dÃ¶necek toplam kayÄ±t sayÄ±sÄ± 100âÃ¼ aÅtÄ±ÄÄ±nda, sayfalama yÃ¶ntemi ile HHSânin cevap dÃ¶nmesi beklenmektedir.  Her bir sayfa iÃ§in iÅlemler servisi tekrar Ã§aÄrÄ±lsa da, bu Ã§aÄrÄ±m HHSânin tuttuÄu sayaÃ§ deÄerini arttÄ±rmaz. HHSânin tutacaÄÄ± sayaÃ§Ä±n kontrol parametreleri YÃS kodu, hesap numarasÄ± ya da referansÄ± olmalÄ±dÄ±r. Sayfa no parametresi varsa ve 1'den bÃ¼yÃ¼k ise iÅlem sayacÄ±nÄ± arttÄ±rmamalÄ±dÄ±r. \n ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden tetiklediÄi iÅlemlerde ise;\nbireysel ÃHKâlar  iÃ§in en fazla 1 aylÄ±k,\nkurumsal ÃHKâlar iÃ§in ise en fazla 1 haftalÄ±k bir pencere aralÄ±ÄÄ±nda sorgulama yapÄ±labilir. Belirtilen tarih aralÄ±ÄÄ±ndan farklÄ± deÄer ile sorgulama yapÄ±ldÄ±ÄÄ±nda  âTR.OHVPS.Business.InvalidStartEndTimeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS, otomatik yapacaÄÄ± sorgularda hem bireysel hem de kurumsal ÃHKâlar iÃ§in 24 saatlik bir pencere aralÄ±ÄÄ±nda sorgulama yapabilir. Belirtilen tarih aralÄ±ÄÄ±ndan farklÄ± deÄer ile sorgulama yapÄ±ldÄ±ÄÄ±nda  âTR.OHVPS.Business.InvalidStartEndTimeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saatinin 00:00:00 olduÄu kabul edilmiÅtir. \n Sorgu Ã¶rnekleri aÅaÄÄ±daki gibidir:  \n 1 gÃ¼nlÃ¼k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-06-02T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n \n 1 haftalÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-06-08T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-02-01T00:00:00+03:00&\nhesapIslemBtsTrh=2020-03-01T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-01-31T00:00:00+03:00&\nhesapIslemBtsTrh=2020-02-28T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 1 AylÄ±k Ä°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-02-28T00:00:00+03:00&\nhesapIslemBtsTrh=2020-03-28T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n 24 saatlik pencerede yapacaÄÄ± sistemsel sorgu Ã¶rneÄi (Son sorgusunun Ã¼zerine 24 saat eklenmesi)  =\n/hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2020-06-01T14:10:08+03:00&\nhesapIslemBtsTrh=2020-06-02T14:10:08+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n ÃnyÃ¼zden alÄ±nan sorgu parametreleri ile oluÅturulan sorgu Ã¶rneÄi (Ãrnek sorgu tarih aralÄ±ÄÄ± 20.02.2023- 25.02.2023 arasÄ±ndadÄ±r)  =\n/hesaplar/{hspRef}/islemler?\nhesapIslemBslTrh=2023-02-20T00:00:00+03:00&\nhesapIslemBtsTrh=2023-02-26T00:00:00+03:00&\nminIslTtr=0&\nmksIslTtr=100000&\nbrcAlc=A&\nsyfKytSayi=25&\nsyfNo=1&\nsrlmKrtr= islGrckZaman &\nsrlmYon=A\n \n Tablo 18: Ä°Ålem Listesi Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ä°Ålem Sorgulama BaÅlangÄ±Ã§ ZamanÄ± \n hesapIslemBslTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin baÅlangÄ±Ã§ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. ÃHK tarafÄ±ndan tetiklenen sorgularda;hesapIslemBslTrh ve hesapIslemBtsTrh arasÄ± fark bireysel ÃHKâlar iÃ§in en fazla 1 ay,kurumsal ÃHKâlar iÃ§in ise en fazla 1 hafta olabilir. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;son 24 saat sorgulanabilir. Bu yÃ¼zden hesapIslemBtsTrh-24 saatâten daha uzun bir aralÄ±k sorgulanamaz olmalÄ±dÄ±r. Ä°stek baÅlÄ±ÄÄ±nda yer alan PSU-Initiated alanÄ± âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n \n \n Ä°Ålem Sorgulama BitiÅ ZamanÄ± \n hesapIslemBtsTrh \n ISODateTime \n Z \n Sorgulanacak iÅlemlerin bitiÅ tarihi. \n HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan sistemsel yapÄ±lan sorgulamalarda hem bireysel, hem de kurumsal ÃHKâlar iÃ§in;Ä°leri vadeli iÅlem emirleri dahil olmadÄ±ÄÄ± iÃ§in (SÃ¼rÃ¼m 1.0.2 kapsamÄ±nda); Ä°Ålem Sorgulama BitiÅ ZamanÄ±, her zaman, sorgulama zaman damgasÄ±nÄ± iletecek Åekilde (datetime (now)) iletilebilir. \n \n \n En DÃ¼ÅÃ¼k Ä°Ålem TutarÄ± \n minIslTtr \n AN1..24 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en dÃ¼ÅÃ¼k iÅlem tutarÄ±.      Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n En YÃ¼ksek Ä°Ålem TutarÄ± \n mksIslTtr \n AN1..24 \n Ä° \n Sorgulanacak iÅlemlerin alabileceÄi en yÃ¼ksek iÅlem tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n BorÃ§ Alacak GÃ¶stergesi \n brcAlc \n AN1 \n Ä° \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Hesaba borÃ§ yaratan iÅlem.A: Hesaba alacak yaratan iÅlem.{âBâ,âAâ} \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼

16yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âislGrckZamanâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama kriterini islGrckZaman olarak belirler. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 19: âIslemBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Hesap Referans NumarasÄ± \n hspRef \n AN5..40 \n Z \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. Bir hesap (IBAN) tek bir hspRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir hspRef tek bir IBAN'a karÅÄ±lÄ±k gelmelidir. AynÄ± hesap iÃ§in alÄ±nan tÃ¼m rÄ±zalarda hesap referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n Islemler \n isller \n Kompleks:Islem[Array] \n K \n Hesaba iliÅkin hareketler varsa Ä°Ålemler nesnesi dizisi olarak dÃ¶nÃ¼lÃ¼r. Ä°Ålemler nesnesi Temel Ä°Ålem Bilgileri ve Detay Ä°Ålem Bilgileri nesnesinden meydana gelir. Ä°zin tÃ¼rÃ¼ varsayÄ±lan olarak Temel Ä°Ålem Bilgilerini iÃ§erir. Detay Ä°Ålem Bilgileri izin tÃ¼rÃ¼ de seÃ§ildi ise Temel Ä°Ålem Bilgilerine ek olarak Detay Ä°Ålem Bilgileri de gÃ¶nderilir. \n \n \n > Temel Ä°Ålem Bilgileri \n islTml \n Kompleks:IslemTemel \n Z \n Temel Ä°Ålem Bilgileri varsayÄ±lan olarak dÃ¶nÃ¼lÃ¼r. \n \n \n >> Ä°Ålem NumarasÄ± \n islNo \n AN3..50 \n Z \n Hesap hareketinin oluÅturulmasÄ± sÄ±rasÄ±nda atanan ve borÃ§ (veya alacak) hareketini tekilleÅtiren HHS bazÄ±nda tekil tanÄ±mlayÄ±cÄ±dÄ±r. Bu deÄer tek baÅÄ±na tekil olabileceÄi gibi birden fazla deÄerin bir araya getirilmesiyle de tekilliÄi saÄlanmÄ±Å olabilir. Bu deÄerin en azÄ±ndan hesap numarasÄ± (hesNo) bazÄ±nda tekil olmasÄ± beklenir. Genellikle kullanÄ±lan Ã¶rnekleri; Instance_Id, Transaction_Id, Transaction_Num, Transaction_TimeStamp,dekont numarasÄ± \n \n \n >> Ä°Ålem Referans NumarasÄ± \n refNo \n AN3..50 \n Z \n Ä°Ålemi uÃ§tan uca tanÄ±mlayan tekil tanÄ±mlayÄ±cÄ±dÄ±r. BorÃ§ ve alacak hareketinden oluÅan bir veya birden fazla iÅlemler bÃ¼tÃ¼nÃ¼ iÃ§in atanmÄ±Å olan ve bu bÃ¼tÃ¼nÃ¼ tekilleÅtiren (bir biri ile iliÅkisini tutan) deÄerdir.Bu deÄer hem YÃSâten gelen deÄer olabilir (Ã¶deme iÅlemlerinde kullanÄ±lan kkodRef ya da refBlg alanÄ±) hem de HHS iÃ§inde takip edilmek iÃ§in Ã¼retilmiÅ bir deÄer olabilir. HHS sisteminde 2 deÄerin de bulunmasÄ± durumunda;refNo alanÄ±nÄ± doldurmak iÃ§in, HHSânin YÃSâten gelen deÄere Ã¶ncelik vermesi beklenmektedir. YÃSâten gelen veri Ã¶rneÄi: SipariÅ NumarasÄ±, Fatura NumarasÄ±, Karekod ReferansÄ± vb. HHSâte Ã¼retilen veri Ã¶rneÄi: MasraflÄ± havale iÅleminde hem havale iÅleminin hem de masraf iÅleminin aynÄ± referans numarasÄ±na sahip olmasÄ± da Ã¶rnek olarak gÃ¶sterilebilir. \n \n \n >> Ä°Ålem TutarÄ± \n islTtr \n AN1..24 \n Z \n Ä°Ålem tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n >> GÃ¼ncel Bakiye TutarÄ± \n gnclBky \n AN1..25 \n Z \n Ä°Ålem sonrasÄ± gÃ¼ncel bakiye bilgisi tutarÄ±.    Tutar alanÄ± regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para birimi. \n \n \n >> Ä°Ålem GerÃ§ekleÅme ZamanÄ± \n islGrckZaman \n ISODateTime \n Z \n Ä°Ålemin gerÃ§ekleÅme zamanÄ±. \n \n \n >> Ä°Ålem KanalÄ± \n kanal \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeKaynak sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> BorÃ§landÄ±rma AlacaklandÄ±rma GÃ¶stergesi \n brcAlc \n AN1 \n Z \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Ä°Ålemin hesabÄ± borÃ§ ya da alacaklandÄ±rdÄ±ÄÄ± bilgisidir. \n \n \n >> Ä°Ålem TÃ¼rÃ¼ \n islTur \n AN3..50 \n Z \n HHSânin iÅleme ait iliÅkilendirdiÄi iÅlem tÃ¼rÃ¼ deÄeri. TR.OHVPS.DataCode.IslemTuru sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Ä°Ålem AmacÄ± \n islAmc \n AN2 \n Z \n TR.OHVPS.DataCode.IslemAmaci sÄ±rali veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Ãdeme Sistemi No \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. Havale/FAST/PÃS  Ã¶deme yÃ¶ntemleri iÃ§in tarih alanÄ± yyyy-aa-gg formatÄ±nda 10 karakter olarak

16iletilmelidir. \n \n \n > Detay Ä°Ålem Bilgileri \n islDty \n Kompleks: IslemDetay \n K \n Detay Ä°Ålem Bilgileri dizi olarak gÃ¶nderilmelidir. \n \n \n >> Ä°Ålem AÃ§Ä±klamasÄ± \n islAcklm \n AN1..200 \n Z \n HHS tarafÄ±ndan atanan iÅlem aÃ§Ä±klamasÄ±. HHS kendi iÅlem hareketlerine yansÄ±ttÄ±ÄÄ± aÃ§Ä±klamayÄ± buraya yansÄ±tmalÄ±dÄ±r.  HHS'ler tÃ¼m hesap hareketlerini YÃS'ler ile paylaÅmakla yÃ¼kÃ¼mlÃ¼ olup, hassas veri iÃ§eren(Ã¶rn: faiz, komisyon bilgisi iÃ§eren vb.) iÅlem hareketleri de bu kapsamda deÄerlendirilerek iÅlem aÃ§Ä±klamasÄ±nÄ±n maskeli olarak iletilmesi saÄlanÄ±r. Kelimelerin ilk 3 hanesi maskeli olacak Åekilde, ancak sakÄ±ncalÄ± bulunan kelimeler varsa; (Ã¶rn: faiz, komiyon vb.) kelimelerin tamamÄ± maskeli olacak Åekilde gÃ¶sterilebilir. \n \n \n >> KarÅÄ± Taraf \n krsTrf \n Kompleks:  KarsiTaraf \n K \n KullanÄ±mÄ± iÅlem bazÄ±nda deÄiÅmektedir. Ãrnek: FAST iÅleminde karÅÄ± taraf alÄ±cÄ±nÄ±n bilgileridir. Vergi Ã¶demesinde kurum IBAN bilgisi mÃ¼Återiye gÃ¶sterilemeyebileceÄinden bu alanÄ±n boÅ gelmesi HHS insiyatifindedir. \n \n \n >>> KarÅÄ± Maskeli IBAN \n krsMskIBAN \n AN26 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n maskeli IBAN bilgisi. \n \n \n >>> KarÅÄ± Ãnvan \n krsUnvan \n AN3..140 \n K \n Ä°lgili hesap hareketinin karÅÄ± tarafÄ±nÄ±n ad-soyad ya da ticari Ã¼nvan bilgisi. Ãnvan bilgisi maskelenmeden iletilmelidir. \n \n \n >>> KarÅÄ± Taraf Kimlik Bilgisi \n krsKimlikVrs \n AN1..11 \n Ä° \n HHS sorumluluÄunda YÃS ile paylaÅÄ±lan KarÅÄ± Taraf Kimlik Bilgisi(Kimlik/Kurum Kimlik - TCKN/VKN) \n 9.9 ADIM 4: Kart Bilgilerinin SorgulanmasÄ± \n    \n GET /kartlar ve GET /kartlar/{kartRef} \n Bu eriÅim noktalarÄ±ndan tÃ¼m kartlarÄ±n veya belirli bir kartÄ±n bilgileri sorgulanÄ±r ve kart listesi elde edilir. Ä°lgili sorgu iÃ§in 07 izin tÃ¼rÃ¼nÃ¼n verilmesi yeterlidir. HHS ekranlarÄ±nda kart seÃ§imi yapÄ±lÄ±rken sadece aktif/aÃ§Ä±k statÃ¼de olan kartlar listelenecek ve ÃHK'ya seÃ§tirilecektir. KartÄ±n ilgili kanalda listelenme yetkisi bulunmuyorsa ÃHVPS kapsamÄ±nda listelenmeyebilir. ListelendiÄi durumda; asÄ±l kart sahibi ile sanal/ek kart sahiplerinin aynÄ± kiÅi olduÄu dÃ¼ÅÃ¼nÃ¼ldÃ¼ÄÃ¼nde HHS ekranlarÄ±nda kart seÃ§imi yapÄ±larak rÄ±za verilirken asÄ±l kart seÃ§ilmeden ilgili asÄ±l karta baÄlÄ± sanal ve ek kartlarÄ±n ayrÄ±ca seÃ§ilerek rÄ±za verilmesine izin verilmemelidir. HHS mevcut kanallarÄ±nda ek ve sanal kart hareketlerini asÄ±l karttan ayÄ±rt etmeden mÃ¼Återisine gÃ¶steriyor ise asÄ±l kart seÃ§imi ile birlikte asÄ±l karta baÄlÄ± sanal ve/veya ek kart seÃ§imini zorunlu kÄ±lmalÄ±dÄ±r. AsÄ±l kart hamili dÄ±ÅÄ±nda bir kiÅi iÃ§in ek kart Ã§Ä±kartÄ±ldÄ±ÄÄ± durumda ek kart sahibi HHS'de asÄ±l kartÄ± gÃ¶rmeyecek olduÄundan sadece kendisine Ã§Ä±kartÄ±lan ek kartÄ± listelenecek ve seÃ§erek rÄ±za vermesi saÄlanacaktÄ±r. Ek kart hamilinin asÄ±l kart hamilinden farklÄ± olduÄu durumda asÄ±l karta ait bir rÄ±za olmasa da ek karta rÄ±za verilebilir. \n Her durumda onay ekranÄ±nda rÄ±za verilen tÃ¼m kartlarÄ±n listesini ÃHK'ya gÃ¶stermesi zorunludur. KapalÄ± devre Ã§alÄ±Åan kartlar kapsama dahil deÄildir. \n YÃS tarafÄ±ndan baÅlatÄ±lan rÄ±za isteklerinde hesap ve kart izin tÃ¼rlerinin seÃ§ili olmasÄ± durumunda HHS ekranlarÄ±nda hem hesaplarÄ±n hem de kartlarÄ±n listelenmesi saÄlanacaktÄ±r. Ancak hesap ya da kart bilgilerinden en az birinin seÃ§ilmesi yeterlidir. Hem hesap hem kart bilgisi iÃ§in seÃ§im yapÄ±lmasÄ± zorunluluÄu bulunmamaktadÄ±r. YÃS Ã¼zerinden hem hesap hem kart izin tÃ¼rÃ¼ seÃ§ilerek baÅlatÄ±lan rÄ±za akÄ±ÅÄ±nda, mÃ¼Återi HHS ekranÄ±nda yalnÄ±zca hesap seÃ§imi yapmÄ±Å ise, kartlar servisine yapÄ±lan isteklerde HHS tarafÄ±ndan hata yerine boÅ liste dÃ¶nÃ¼lmelidir. \n \n Parametrede yer alan deÄerlerin doÄru gÃ¶nderildiÄi kontrol edilir. HatalÄ± gÃ¶nderilmesi durumunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Parametrede yer alan deÄerler gÃ¶nderilmediÄi durumda parametredeki varsayÄ±lan deÄerler ile kart bilgileri dÃ¶nÃ¼lÃ¼r. VarsayÄ±lan deÄerler Tablo 20'de belirtilmiÅtir. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n RizaDurumu B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n YÃS'Ã¼n;

16 RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda kartlar servisini Ã§aÄÄ±rmamasÄ± beklenir. Bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âYetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n Ä°lgili rÄ±za numarasÄ±nÄ±n â07: Temel Kart Bilgisiâ izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 07 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS tarafÄ±ndan istek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±za iÃ§erisindeki kart bilgileri dÃ¶nÃ¼lÃ¼r. Kart bilgileri iÃ§in KartBilgileri nesnesinin iÃ§eriÄi Tablo 21'de verilmiÅtir. \n Kart Bilgisi Sorgu ÃrneÄi (TÃ¼m Kartlar) = /kartlar?syfKytSayi=25&syfNo=1?kartTipi=K\nKart Bilgisi Sorgu ÃrneÄi (Belirli Bir Kart) = /kartlar/{kartRef} \n Ä°ptal statÃ¼sÃ¼nde olan banka ve Ã¶n Ã¶demeli kart tipleri HHS tarafÄ±ndan kartlar sorgusunda dÃ¶nÃ¼lmeyecek olup YÃS'ler tarafÄ±ndan ÃHK'ya da gÃ¶sterilemeyecektir. Ä°ptal statÃ¼lÃ¼ kredi kart tipi iÃ§in borÃ§/taksit bilgisi veya artÄ± bakiye olmasÄ± durumunda kartlar listesinde HHS'ler tarafÄ±ndan dÃ¶nÃ¼Å saÄlanacak olup YÃS'ler tarafÄ±ndan ÃHK'ya gÃ¶sterilecektir. Ä°ptal statÃ¼sÃ¼nde olup herhangi bir bakiye ve borÃ§ olmamasÄ± durumunda ilgili kart bilgisi kartlar listesinde HHS tarafÄ±ndan iletilmeyecektir. \n HHS'de aÃ§Ä±k/aktif statÃ¼de yer alan kartlar seÃ§ilip rÄ±za tahsis edildikten sonra kartÄ±n statÃ¼sÃ¼nÃ¼n pasif olmasÄ± durumunda HHS tarafÄ±ndan mevcut kanallarÄ±nda gÃ¶sterilen bilgiler kart liste, detay ve hareket sorgulamalarÄ±nda dÃ¶nÃ¼lmelidir. HHS'de kart seÃ§imi yapÄ±p rÄ±za tahsis edildikten sonra ilgili kartÄ±n gÃ¶sterimi Ã¶zelinde HHS'de kÄ±sÄ±tlama getirilmesi durumlarÄ± iÃ§in Ã¶rnekler aÅaÄÄ±da detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n RÄ±za iÃ§erisinde sadece kart olmasÄ± durumunda ilgili rÄ±zanÄ±n 09 iptal detay kodu ile iptal edilmesi saÄlanacaktÄ±r. \n RÄ±za iÃ§erisinde ilgili kartÄ±n dÄ±ÅÄ±nda hesap/kart olmasÄ± durumunda rÄ±za iptal edilmeyecektir. Ä°lgili kart haricinde kart listesinde farklÄ± bir kart yoksa kart listesi, sorgulandÄ±ÄÄ±nda  TR.OHVPS.Business.RestrictedChannelAccess  hata kodu dÃ¶nÃ¼lecektir. \n \n Tablo 20: Kart Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n Kart Tipi \n kartTipi \n AN1 \n Ä° \n Kart tipleri Ã¶zelinde Banka, Kredi ve Ãn Ãdemeli kartlarÄ±n ayrÄ±ca soruglanmasÄ± saÄlanÄ±r. \n Bu veri gÃ¶nderildiÄi durumda, HHS kart tipine uygun olarak kart bilgilerini dÃ¶ner. \n \n \n \n Tablo 21: âKartBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n Kart Referans NumarasÄ± \n kartRef \n AN5..40 \n Z \n HHS tarafÄ±ndan her bir kart iÃ§in atanan biricik deÄerdir (uuid). Bir kart tek bir kartRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir kartRef tek bir karta karÅÄ±lÄ±k gelmelidir. AynÄ± kart iÃ§in alÄ±nan tÃ¼m rÄ±zalarda kart referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n Kart NumarasÄ± \n kartNo \n AN15..16 \n Z \n Karta ait numara maskeli olarak iletilmelidir. Maskeleme kuralÄ± kart'Ä±n ilk 6 ve son 4 hanesi aÃ§Ä±k olarak gÃ¶rÃ¼necek Åekilde maskelenmelidir. Sanal kart bilgisi iÃ§in de ilgili numara maskeli olarak iletilmelidir. Ãrn: 123456******5678 \n \n \n AsÄ±l Kart NumarasÄ± \n asilKartNo \n AN15..16 \n K \n AsÄ±l kartlar iÃ§in ilgili alan iletilmemelidir. Sanal ve ek kartlar iÃ§in baÄlÄ± olduklarÄ± asÄ±l kart numaralarÄ± iletilmelidir. Ek karta ait sanal kart iÃ§in asÄ±l kart numarasÄ± olarak ek kart numarasÄ± iletilmelidir. Kart numarasÄ± maskeli iletilmelidir. \n \n \n Kart Tipi \n kartTipi \n AN1 \n Z \n KartÄ±n tipini belirten deÄerdir. Kart tipleri olarak alabileceÄi deÄerler  TR.OHVPS.DataCode.KartTip  sÄ±ralÄ± veri tÃ¼rlerinden biridir. \n \n \n Alt Kart Tipi \n altKartTipi \n AN1 \n Z \n Kart Tipleri altÄ±nda yer alan alt kart tipleridir. Alt kart tipleri olarak alabileceÄi deÄerler  TR.OHVPS.DataCode.AltKartTip  sÄ±ralÄ± veri tÃ¼rlerinden biridir.  AsÄ±l banka kartÄ±, sanal banka kartÄ±, ek kredi kartÄ±, asÄ±l kredi kartÄ± gibi tÃ¼m kart tiplerini ayrÄ±ÅtÄ±rmak iÃ§in asÄ±l ve alt kart tipleri kullanÄ±lmaktadÄ±r. \n \n \n Kart Formu \n kartFormu \n AN1 \n Z \n KartÄ±n fiziksel ve dijital olduÄ

16unu belirten deÄerdir. AlabileceÄi deÄerler  TR.OHVPS.DataCode.KartFormu  sÄ±ralÄ± veri tÃ¼rlerinden biridir. \n \n \n Kart TÃ¼rÃ¼ \n kartTuru \n AN1 \n Z \n KartÄ±n tipinin bireysel ya da ticari olmasÄ±na yÃ¶nelik olan deÄerdir.  B:Bireysel, T:Ticari \n \n \n Kart StatÃ¼sÃ¼ \n kartStatu \n AN1 \n Z \n TR.OHVPS.DataCode.KartStatu  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  Kart statÃ¼sÃ¼ iÃ§in gÃ¼ncelleme yapÄ±lamayacak durumda ise iptal statÃ¼sÃ¼ olarak deÄerlendirilmelidir. Kart statÃ¼sÃ¼ gÃ¼ncellenebilir durumda ise aÃ§Ä±k ve pasif olarak deÄerlendirilmelidir. \n \n \n Kart Sahibi Ad/Soyad \n kartSahibi \n AN3..140 \n Z \n Kart sahibi ya da kart sahiplerinin ad-soyadÄ±. \n \n \n Kart Ticari Unvan \n kartTicariUnvan \n AN3..140 \n K \n Kart tÃ¼rÃ¼ ticari ise ilgili alanda ticari unvan iletilmesi zorunludur. \n \n \n Kart ÃrÃ¼n AdÄ± \n kartUrunAdi \n AN3..140 \n Z \n Kart bilgilerinin Ã¼rÃ¼n adÄ±. Ãrn : TROY Business Kart \n \n \n Ekstre TÃ¼rleri \n ekstreTurleri \n Kompleks:EkstreTurleri[Array] \n Z \n Ekstre tÃ¼rleri dizi iÃ§erisinde iletilmelidir. \n \n \n > Ekstre StatÃ¼sÃ¼ \n ekstreStatu \n AN1 \n Z \n TR.OHVPS.DataCode.EkstreStatu  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.Ekstre tÃ¼rÃ¼nÃ¼n durumu iletilmelidir. Pasif olan ekstre tÃ¼rleri de iletilmelidir. A: Aktif : ilgili kartÄ±n ekstre tÃ¼rÃ¼nÃ¼n kullanÄ±ma aÃ§Ä±k olmasÄ±dÄ±r. P: Pasif : Ä°lgili kartÄ±n ekstre tÃ¼rÃ¼nÃ¼n eskiden kullanÄ±ldÄ±ÄÄ± ancak Åu an devre dÄ±ÅÄ± durumda olmasÄ±dÄ±r.  Ãrnek olarak: Ä°lgili kredi kartÄ±nÄ±n TRY, USD, EUR ekstre tÃ¼rleri aÃ§Ä±k olduÄu durumda Ã¼Ã§ ekstre tÃ¼rÃ¼nÃ¼n de aktif olarak dÃ¶nmesi beklenmektedir. ÃHK, USD ekstre tÃ¼rÃ¼nÃ¼ kapattÄ±ÄÄ± durumda USD pasif ; TRY ve EUR aktif olarak dÃ¶nmesi beklenmektedir. BÃ¶ylece ÃHKânÄ±n Åu an pasif ama Ã¶nceden aktif olan ekstre tÃ¼rlerinin sorgulanmasÄ± saÄlanabilecektir. EÄer bir ekstre tÃ¼rÃ¼ iÃ§in hiÃ§ ekstre Ã¼retilmemiÅse, bu durumda HHSânin ilgili ekstre tÃ¼rÃ¼nÃ¼ hiÃ§ dÃ¶nmemesi gerekmektedir. \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Ä°lgili karta ait ekstre tÃ¼rleri para birimi.(TRY, USD, EUR, GBP) YurtdÄ±ÅÄ± ekstre olan kartlar iÃ§in TRY haricinde de deÄer dÃ¶nÃ¼lmesi gerekmektedir. Banka kartlarÄ±nda ise karta baÄlÄ± olan hesap para birimleri iletilmelidir. \n \n \n Kart Rumuz \n kartRumuz \n AN3..140 \n Ä° \n Kart iÃ§in rumuz bilgisi var ise gÃ¶nderilebilir. \n \n \n Kart ÅemasÄ± \n kartSema \n AN1 \n Z \n TR.OHVPS.DataCode.KartSema  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n 9.10 ADIM 4.1: Kart Detay Bilgilerinin SorgulanmasÄ± \n GET /kartlar/{kartRef}/kart-detay \n KartBilgileri nesnesi ile elde edilen kart listesinde yer alan kartlarÄ±n detayÄ± sorgulanÄ±r. Detay ile birlikte KartDetayBilgileri nesnesinin iÃ§eriÄi Tablo 23'de verilmiÅtir. \n \n Parametrede yer alan ekstreTuru bilgisi Ekstre TÃ¼rleri haricinde uygun olmayan bir deÄer gÃ¶nderildiÄinde  âTR.OHVPS.Business.InvalidCurrencyCodeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Bu alan gÃ¶nderilmiyorsa TRY olarak deÄerlendirilmelidir. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen kartRef'ler iÃ§in, kart detay bilgileri sorgulanan kartRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili kartRef bulunamaz  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n Ä°lgili rÄ±za numarasÄ±nÄ±n â08: DetaylÄ± Kart Bilgisiâ izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 08 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupported\"â  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Alt kart tipi Sanal Kart olanlar iÃ§in detay bilgisi gÃ¶rÃ¼ntÃ¼lenmeyecektir.  Sanal kart Ã¶zelinde detay bilgi sorgulamasÄ± yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CardTypeNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Kart tipi olarak; iptal statÃ¼sÃ¼nde olan banka ve Ã¶n Ã¶demeli kartlar iÃ§in detay sorgulamasÄ± yapÄ±lamayacaktÄ±r. Kart tipi kredi kartÄ± olup iptal statÃ¼sÃ¼nde olan ve  borcu olmayan bir  kart iÃ§in de kart detay sorgulamasÄ± yapÄ±lamayacaktÄ±r. Detay sorgulamasÄ± yapÄ±lamayacak bir kart tipi iÃ§in HHS'ler tarafÄ±ndan  \"TR.OHVPS.Business.InvalidCardStatus\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za iÃ§erisinde kanal gÃ¶rÃ¼ntÃ¼leme yetkisi kapatÄ±lan kart iÃ§in detay bilgisi sorgulandÄ±ÄÄ±nda  TR.OHVPS.Business.RestrictedChannelAccess  hata kodu dÃ¶nÃ¼lecektir. \n Ä°lk kredi kartÄ± oluÅan ÃHK'lar henÃ¼z ekstre oluÅmadÄ±ÄÄ± sebebiyle tarih ve borÃ§ bilgileri de oluÅmamÄ±Å olabilir. Bu sebeple ilgili tutar bilgileri sÄ±fÄ±r olacak Åekilde dÃ¶nÃ¼lmelidir. Tarih bilgileri ise varsayÄ±lan tarih bilgisi olarak dÃ¶nÃ¼lebilir.(Ãrn:01/01/1900) Bu Åekilde gelen bir tarih bilgisi YÃS'ler tarafÄ±ndan ÃHK'ya boÅ olarak gÃ¶sterilebilir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS tarafÄ±ndan  âKartDetayBilgileriâ  nesnesi dÃ¶nÃ¼lÃ¼r. \n HHS'ler kart tipi kredi kartÄ± ise ve karta ait borÃ§/taksit tutar bilgisi bulunuyorsa KartDetayBilgileri nesnesi iÃ§in baÅarÄ±lÄ± yanÄ±t dÃ¶nmek zorundadÄ±r. BorÃ§ bilgisi iÃ§in tutarlar eksi(-) olacak Åekilde iletilmesi beklenmektedir. \n Kart Detay Bilgisi Sorgu ÃrneÄi (Tek Bir Kart) = /kartlar/{kartRef}/kart-detay \n Parametre iÃ§eren Kart Detay Bilgisi Sorgu ÃrneÄi (Tek Bir Kart) =  /kartlar/{kartRef}/kart-detay?ekstreTuru=USD \n Tablo 22: Kart Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ekstre TÃ¼rÃ¼ \n ekstreTuru \n AN3 \n K \n Kart bilgileri yanÄ±tÄ±nda dÃ¶nÃ¼len ekstre tÃ¼rleri deÄerlerini almaktadÄ±r. Para birimine uygun olarak kart detay bilgileri sorgulanmaktadÄ±r. Ekstre parametresi TRY,USD,EUR,GBP olarak gÃ¶nderilebilir. Bu alan gÃ¶nderilmiyorsa TRY deÄerlendirilmelidir. Ä°lgili para birimine Ã¶zel ekstre iÃ§indeki harcama deÄeri dÃ¶nÃ¼lecektir. \n Ekstre tÃ¼rleri haricinde uygun olmayan bir deÄer gÃ¶nderildiÄinde hata verilmelidir. \n \n \n \n Tablo 23: âKartDetayBilgileriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n

16Kart Tiplerine Ä°stinaden DetaylÄ± AÃ§Ä±klama \n \n \n \n \n RÄ±za No \n rizaNo \n AN1..128 \n Z \n HesapBilgisiRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n Kart Referans NumarasÄ± \n kartRef \n AN5..40 \n Z \n HHS tarafÄ±ndan her bir kart iÃ§in atanan biricik deÄerdir (uuid). Bir kart tek bir kartRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir kartRef tek bir karta karÅÄ±lÄ±k gelmelidir. AynÄ± kart iÃ§in alÄ±nan tÃ¼m rÄ±zalarda kart referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n \n Ekstre TÃ¼rÃ¼ \n ekstreTuru \n AN3 \n Z \n Ekstre tÃ¼rÃ¼ TRY,USD,EUR,GBP olarak gÃ¶nderilebilir. Ä°stek paremetresinde iletilen deÄer ile aynÄ± deÄer olmalÄ±dÄ±r. \n \n \n \n Toplam Kart Limiti \n toplamLimit \n Kompleks:ToplamLimit \n K \n Karta ait toplam TL limit bilgisi. Toplam kart limiti (+) deÄerde gÃ¶nderilmelidir. Negatif deÄer gÃ¶nderilmemelidir. \n Kart tipi kredi kartÄ± ve Ã¶n Ã¶demeli kart olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. Ãn Ã¶demeli kartlarda, baÄlÄ± bulunduklarÄ± bir hesap olsa bile, sadece Ã¼zerlerine yÃ¼klenen tutarÄ±n gÃ¶sterilmesi gerekmektedir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Tutar Bilgisi. Limit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n KullanÄ±labilir Kart Limiti \n kullanilabilirLimit \n Kompleks:KullanÄ±labilirLimit \n K \n Karta ait kullanÄ±labilir TL limit bilgisi. KullanÄ±labilir kart limiti (+) deÄerde gÃ¶nderilmelidir. Herhangi bir sebeple (kart limitinin aÅÄ±lmasÄ± vb.)  (-) olmasÄ± durumunda deÄerin (-) olarak gÃ¶nderilmesi beklenmektedir. \n Kart tipi banka olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Tutar Bilgisi. Limit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n DÃ¶nem Ä°Ã§i Hareket ToplamÄ± \n donemIciHareketToplami \n Kompleks:DonemIciHareketToplami \n Z \n DÃ¶nem iÃ§i hareket toplamÄ± ve kalan ekstre borcunun toplamÄ± dÃ¶nÃ¼lmelidir. MÃ¼Återinin borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb(+) deÄer ile tutar bilgisi gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili dÃ¶neme ait hareketlerin toplam tutar bilgisidir. Kart tipi banka ve Ã¶n Ã¶demeli kartlar iÃ§in ilgili dÃ¶nem iÃ§erisinde ay baÅÄ±ndan itibaren yapÄ±lan hareketlerin toplam tutar bilgisi iletilmelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Tutar Bilgisi.  Tutar iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Ekstre Borcu \n ekstreBorcu \n Kompleks:EkstreBorcu \n K \n Ä°lgili ekstre tÃ¼rÃ¼ne uygun olarak ekstre borcu iletilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb(+) deÄer ile tutar bilgisi gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi koÅulludur. Ek kredi kartÄ± iÃ§in ilgili alan varsa dÃ¶nÃ¼lmelidir . Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n BorÃ§ tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Kalan Ekstre Borcu \n kalanEkstreBorcu \n Kompleks:KalanEkstreBorcu \n K \n Ä°lgili ekstre tÃ¼rÃ¼ne uygun olarak kalan ekstre borcu iletilmelidir. MÃ¼Återinin kalan ekstre borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. Kalan ekstre borcu yoksa veya herhangi bir sebeple ektresinde alacak tutarÄ± varsa 0(sÄ±fÄ±r) deÄeri gÃ¶nderilmelidir. Pozitif deÄer gÃ¶nderilmemelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi koÅulludur. Alt kart tipi ; AsÄ±l ve Sanal kredi kartÄ± iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi zorunludur. Ek kredi kartÄ± iÃ§in ilgili alan varsa dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n BorÃ§ tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Asgari Ãdeme TutarÄ± \n asgariOdemeTutari \n Kompleks:AsgariOdemeTutari \n K \n Ä°lgili ekstre tÃ¼rÃ¼ne uygun olarak ekstreye ait asgari Ã¶deme tutarÄ± iletilmelidir. Ekstre Borcu (-) ise; asgari Ã¶deme tutarÄ± da (-) deÄer olarak gÃ¶nderilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb.)  \"0\" (sÄ±fÄ±r) deÄeri gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi koÅulludur. Alt kart tipi ; AsÄ±l ve Sanal kredi kartÄ± iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi zorunludur. Ek kredi kartÄ± iÃ§in ilgili alan varsa dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Ãdeme tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Kalan Asgari Ãdeme TutarÄ± \n kalanAsgariOdemeTutari \n Kompleks:KalanAsgariOdemeTutari \n K \n Ä°lgili ekstre tÃ¼rÃ¼ne uygun olarak ekstreye ait kalan asgari Ã¶deme tutarÄ± iletilmelidir. Ekstre Borcu (-) ise; asgari Ã¶deme tutarÄ± da (-) deÄer olarak gÃ¶nderilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb.)  \"0\" (sÄ±fÄ±r) deÄeri gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi koÅulludur. Alt kart tipi ; AsÄ±l ve Sanal kredi kartÄ± iÃ§in ilgili alanÄ±n dÃ¶nÃ¼lmesi zorunludur. Ek kredi kartÄ± iÃ§in ilgili alan varsa dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Ãdeme tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Hesap Kesim Tarihi \n hesapKesimTarihi \n ISODate \n Z \n Karta ait hesap kesim tarihi iletilmelidir. Hesap kesim tarihi olarak son kesilmiÅ ekstrenin tarihi iletilmelidir. ÃrneÄin; gÃ¼nÃ¼n tarihi 09/01/2026 olduÄu durumda her ayÄ±n 23'Ã¼nde kesilen ekstre iÃ§in hesap kesim tarihi 2025-12-23 Åeklinde olacaktÄ±r. \n Kart tipi kredi kartÄ± olanlar iÃ§in hesap kesim tarihi iletilmelidir. Ek kart iÃ§in asÄ±l kartÄ±n hesap kesim tarihi dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in sorgulama yapÄ±lan ayÄ±n son takvim gÃ¼nÃ¼ dÃ¶nÃ¼lmelidir. \n \n \n Sonraki Hesap Kesim Tarihi \n sonrakiHesapKesimTarihi \n ISODate \n Z \n Kesilecek olan ekstrenin hesap kesim tarihi tarihi iletilmelidir. ÃrneÄin; gÃ¼nÃ¼n tarihi 09/01/2026 olduÄu durumda her ayÄ±n 23'Ã¼nde kesilen ekstre iÃ§in sonraki hesap kesim tarihi 2026-01-23 Åeklinde olacaktÄ±r. \n Kart tipi kredi kartÄ± olanlar iÃ§in sonraki hesap kesim tarihi iletilmelidir. Ek kart iÃ§in asÄ±l kartÄ±n sonraki hesap kesim tarihi dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in sorgulama yapÄ±lan aydan bir sonraki ayÄ±n son takvim gÃ¼nÃ¼ dÃ¶nÃ¼lmelidir \n \n \n Son Ãdeme Tarihi \n sonOdemeTarihi \n ISODate \n K \n KesilmiÅ olan ekstre iÃ§in kart borcunun Ã¶deneceÄi son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir. ÃrneÄin; kesilmiÅ olan ekstreye ait  hesap kesim tarihi 2025-12-23 Åeklinde olan bir kredi kartÄ± iÃ§in son Ã¶deme tarihi 2026-01-03 olacaktÄ±r. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Ek kart iÃ§in asÄ±l kartÄ±n son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n Sonraki Son Ãdeme Tarihi \n sonrakiSonOdemeTarihi \n ISODate \n K \n Kesilecek olan ekstre iÃ§in kart borcunun Ã¶deneceÄi son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir.  ÃrneÄin; kesilecek olan ekstreye ait  hesap kesim tarihi 2026-01-23 Åeklinde olan bir kredi kartÄ± iÃ§in son Ã¶deme tarihi 2026-02-03 olacaktÄ±r. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Ek kart iÃ§in asÄ±l kartÄ±n sonraki son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n Puan Bilgisi \n puanBilgisi \n Kompleks:PuanBilgisi[Array] \n \n Karta ait puan bilgileri dizi iÃ§erisinde iletilmelidir. \n \n \n \n > Puan DeÄeri \n puanDegeri \n AN1..25 \n K \n Kart iÃ§in mevcutta yer alan puan deÄeri varsa iletilmelidir. HHS Ã¶zelinde puan deÄeri puan tipine gÃ¶re birim olarak tutuluyorsa ilgili deÄer iletilmelidir. Ãrn: 100 Plus puan bilgisi varsa puan deÄeri alanÄ±nda 100 iletilmelidir. Puan deÄeri eksi deÄer alabilir. \n TÃ¼m kart tipleri iÃ§in puan bilgisi varsa dÃ¶nÃ¼lmelidir. \n \n \n > Puan Tipi \n puanTipi \n AN1..50 \n K \n Puan Tipi olarak HHS Ã¶zelinde bir puanTipi varsa o bilgi iletilmelidir. Ãrn: 100 Plus puan bilgisi varsa puan tipi alanÄ±nda Plus deÄeri iletilmelidir. \n TÃ¼m kart tipleri iÃ§in puan bilgisi varsa dÃ¶nÃ¼lmelidir. \n \n \n Nakit Ãekim Limiti \n nakitCekimLimiti \n Kompleks:NakitCekimLimiti \n K \n Karta ait nakit Ã§ekim limit deÄeri iletilmelidir. Ekstre tÃ¼rÃ¼ TRY dÄ±ÅÄ±nda olan kartlar iÃ§in de TRY para biriminde geÃ§erli olan limit iletilmelidir. Nakit Ãekim Limiti (+) deÄerde gÃ¶nderilmelidir. Negatif deÄer gÃ¶nderilmemelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Limit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n KullanÄ±labilir Nakit Ãekim Limiti \n kullanilabilirNakitCekimLimiti \n Kompleks:KullanilabilirNakitCekimLimiti \n K \n Karta ait kullanÄ±labilir nakit Ã§ekim limit deÄeri iletilmelidir. Ekstre tÃ¼rÃ¼ TRY dÄ±ÅÄ±nda olan kartlar iÃ§in de TRY para biriminde geÃ§erli olan limit iletilmelidir. KullanÄ±labilir Nakit Ãekim Limiti (+) deÄerde gÃ¶nderilmelidir. Herhangi bir sebeple (nakit limitinin aÅÄ±lmasÄ± vb.)  (-) olmasÄ± durumunda deÄerin (-) olarak gÃ¶nderilmesi beklenmektedir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Limit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Kalan Toplam Taksit TutarÄ± \n kalanToplamTaksitTutari \n Kompleks:KalanToplamTaksitTutari \n K \n Karta ait tÃ¼m kalan taksitlerin toplam deÄeri iletilmelidir.MÃ¼Återinin Taksit borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. Taksit iadesi veya benzeri nedenlerle oluÅan mÃ¼Återinin alacaklÄ± olduÄu durumda tutar (+) deÄer gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Taksit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n DÃ¶nem Taksit Tutar Bilgisi \n donemTaksitTutarBilgisi \n Kompleks:DonemTaksitTutarBilgisi[array] \n K \n Kart Tipi kredi kartÄ± olanlar iÃ§in taksit bilgisi varsa taksit iÃ§eren dÃ¶nemlerin dizi halinde iletilmesi zorunludur. \n \n \n \n >

16 DÃ¶nem DeÄeri \n donemDegeri \n N3 \n Z \n Taksitli iÅlemler dÃ¶nÃ¼lmesi sebebiyle dÃ¶nem deÄeri minimum 1 olacak Åekilde dÃ¶nÃ¼lmelidir. \n \n \n \n > DÃ¶nem Taksit TutarÄ± \n donemTaksitTutari \n Kompleks:DonemTaksitTutari \n Z \n Ä°lgili dÃ¶nem deÄeri iÃ§erisindeki toplam taksit tutar bilgisi iletilmelidir. MÃ¼Återinin DÃ¶nem Taksit Tutar borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. DÃ¶nem Taksit Tutar iadesi veya benzeri nedenlerle oluÅan mÃ¼Återinin alacaklÄ± olduÄu durumda tutar (+) deÄer gÃ¶nderilmelidir. \n \n \n \n >> Tutar \n tutar \n AN1..25 \n Z \n Taksit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n >> Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n 9.11 ADIM 4.2: Kart Hareket Bilgilerinin SorgulanmasÄ± \n GET /kartlar/{kartRef}/kart-hareketleri \n KartBilgileri nesnesi ile elde edilen kart listesinde yer alan kartlarÄ±n iÅlem/hareket bilgileri sorgulanÄ±r. Kart hareketleri iÃ§in \"KartHareketleri\" nesnesinin iÃ§eriÄi Tablo 25'de verilmiÅtir. \n \n Bir karta iliÅkin iÅlem bilgileri Tablo 24âdeki istek parametrelerine gÃ¶re sorgulanÄ±r. Parametrede yer alan deÄerlerin doÄru gÃ¶nderildiÄi kontrol edilir. HatalÄ± gÃ¶nderilmesi durumunda HHS tarafÄ±ndan  âTR.OHVPS.Resource.InvalidFormatâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Parametrede yer alan isteÄe baÄlÄ± alanlar gÃ¶nderilmediÄi durumda parametredeki varsayÄ±lan deÄerler ile kart hareketleri dÃ¶nÃ¼lÃ¼r. \n Parametrede yer alan ekstreTuru bilgisi Ekstre TÃ¼rleri haricinde uygun olmayan bir deÄer gÃ¶nderildiÄinde  âTR.OHVPS.Business.InvalidCurrencyCodeâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. Bu alan gÃ¶nderilmiyorsa TRY olarak deÄerlendirilmelidir. \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, izin verilen kartRef'ler iÃ§in, kart hareket bilgileri sorgusunda yer alan kartRefe ait rÄ±za ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°lgili kartRef bulunamaz ise  âTR.OHVPS.Resource.NotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor ya da Y: Yetkilendirildi ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n Kart Hareket Bilgilerinin SorgulanmasÄ± yapÄ±lÄ±rken HHS tarafÄ±ndan ÃHKânÄ±n â09:  AyrÄ±ntÄ±lÄ± Kart Ä°Ålem Bilgisiâ izin tÃ¼rÃ¼ne sahipliÄi kontrol edilir. 09 izin tÃ¼rÃ¼ne sahip deÄil ise  âTR.OHVPS.Business.PermissionTypeNotSupportedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Kart tipi olarak; iptal statÃ¼sÃ¼nde olan banka ve Ã¶n Ã¶demeli kartlar iÃ§in hareket sorgulamasÄ± yapÄ±lamayacaktÄ±r. Kart tipi kredi kartÄ± olup iptal statÃ¼sÃ¼nde olan ve borcu olmayan bir kart iÃ§in de kart hareket sorgulamasÄ± yapÄ±lamayacaktÄ±r. Hareket sorgulamasÄ± yapÄ±lamayacak bir kart tipi iÃ§in HHS'ler tarafÄ±ndan  \"TR.OHVPS.Business.InvalidCardStatus\"  hatasÄ± dÃ¶nÃ¼lmelidir. \n -RÄ±za iÃ§erisinde kanal gÃ¶rÃ¼ntÃ¼leme yetkisi kapatÄ±lan kart iÃ§in hareket bilgisi sorgulandÄ±ÄÄ±nda  TR.OHVPS.Business.RestrictedChannelAccess  hata kodu dÃ¶nÃ¼lecektir. \n Ä°ptal statÃ¼sÃ¼nde olan kart tipleri iÃ§in geÃ§miÅe dÃ¶nÃ¼k hareket sorgulamasÄ± yapÄ±lamayacaktÄ±r. ÃrneÄin; Kredi KartÄ± iÃ§in -12 ile 18 arasÄ± olan dÃ¶nem deÄeri iptal statÃ¼sÃ¼nde olan kredi kartÄ± iÃ§in 0 ile 18 arasÄ±nda yapÄ±labilecektir. TÃ¼m kart tipleri iÃ§in belirtilen parametrede yer alan dÃ¶nem deÄerinin uygun gÃ¶nderilmediÄi durumda  âTR.OHVPS.Business.InvalidPeriodValueâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ekstre bilgisi bulunmayan sanal ve ek kredi kart bilgileri iÃ§in ekstre dÃ¶nemlerine Ã¶zgÃ¼ kart hareketleri sorgulandÄ±ÄÄ±nda HHS'ler tarafÄ±ndan  TR.OHVPS.Business.NoStatementForCard  hatasÄ± dÃ¶nÃ¼lmelidir.\nKredi kartÄ± hareket sorgulamasÄ±nda ilgili dÃ¶nemde kart iÅlemi bulunmamasÄ± halinde dahi ekstre oluÅturulmalÄ± ve iÅlem listesi boÅ olarak dÃ¶ndÃ¼rÃ¼lmelidir. Hata mesajÄ± dÃ¶nÃ¼lmemelidir.\nÃrneÄin: Nisan, MayÄ±s, Haziran ve Temmuz aylarÄ± iÃ§in sÄ±rasÄ±yla -4, -3, -2, -1 dÃ¶nem deÄerleri atanmÄ±Å olsun. MayÄ±s ayÄ±nda kart Ã¼zerinde iÅlem bulunmamasÄ± durumunda dahi MayÄ±s ayÄ±na ait ekstre oluÅturulur ve dÃ¶nem deÄeri -3 olarak

16iletilir; iÅlem listesi boÅ olarak yanÄ±t verilir. \n KartÄ±n yeni oluÅmasÄ±/aktif edilmesi gibi sÃ¼reÃ§lerler sonucunda ekstre bilgisi hiÃ§ oluÅmamÄ±Å dÃ¶nem deÄerleri iÃ§in kart hareketleri sorgulandÄ±ÄÄ±nda HHS'ler tarafÄ±ndan  TR.OHVPS.Business.StatementNotCreated  hatasÄ± dÃ¶nÃ¼lmelidir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS tarafÄ±ndan \"KartHareketleri\" nesnesi dÃ¶nÃ¼lÃ¼r. \n \n HHS'ler kart tipi kredi kartÄ± ise ve karta ait borÃ§/taksit tutar bilgisi bulunuyorsa KartHareketleri nesnesi iÃ§in baÅarÄ±lÄ± yanÄ±t dÃ¶nmek zorundadÄ±r. \n Kart tipi Banka KartÄ± olanlarda dÃ¶nem iÃ§i olarak sorgulama yapÄ±lan aya ait ilgili banka kartÄ± ile yapÄ±lan kart hareketleri gÃ¶rÃ¼ntÃ¼lenecektir. (Banka kartÄ± ile yapÄ±lan Para Ãekme/YatÄ±rma, banka kartÄ± ile yapÄ±lan POS'tan AlÄ±ÅveriÅ vb.). Banka kartÄ±nda dÃ¶nem deÄerinin \"-1\" gÃ¶nderilmesi durumunda bir Ã¶nceki aya ait kart hareketleri gÃ¶rÃ¼ntÃ¼lenecektir. \n Kart hareketleri yanÄ±tÄ±nda hareket bilgileri iÅlem tarihinine gÃ¶re sÄ±ralÄ± olarak iletilmelidir. Ä°Ålem tarihi en gÃ¼ncel tarihten geriye dÃ¶nÃ¼k olacak Åekilde listelenmelidir. \n Kart hareketlerinde ekstre tÃ¼rleri dÄ±ÅÄ±nda yapÄ±lan bir iÅlem varsa hangi ekstre tÃ¼rÃ¼ne dahil edilerek gÃ¶steriliyorsa gÃ¶nderilmelidir.\n \n Ãrn: 100 JPY'lik bir harcama iÅlemi TRY biriminde Ã§evirilip 23 TRY olarak TRY ekstre tÃ¼rÃ¼nde gÃ¶steriliyorsa ilgili iÅlem iÃ§in iÅlem tutarÄ± 23 TRY, orijinal iÅlem tutarÄ± ise 100 JPY olarak deÄerlendirilmelidir. \n \n \n \n Tablo 24: Kart Hareket Bilgileri Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n DÃ¶nem DeÄeri \n donemDegeri \n N3 \n Z \n Kart hareketlerinin sorgulanacaÄÄ± dÃ¶neme ait deÄerdir.  DÃ¶nem iÃ§i : 0 GeÃ§miÅ Ay/Ekstre : -1 ile -12 arasÄ± Taksit : 1 ile 18 arasÄ±  Provizyon : 99  Kart tipine gÃ¶re alabileceÄi dÃ¶nem deÄerleri ise ;  Banka KartÄ± : 0 ve -1 Kredi KartÄ± : -12 ile 18 arasÄ± ve 99 (Sanal alt kart tipi hariÃ§ diÄer tÃ¼m alt kart tiplerinde bu deÄerler geÃ§erlidir.)  Alt kart tipi sanal kart tipinde ise alabileceÄi deÄerler 0 ve 99'dur. Ãn Ãdemeli Kart : 0 ve -1 \n Ä°ptal statÃ¼sÃ¼nde olan kart tipleri iÃ§in geÃ§miÅe dÃ¶nÃ¼k hareket sorgulamasÄ± yapÄ±lamayacaktÄ±r. ÃrneÄin; Kredi KartÄ± iÃ§in -12 ile 18 arasÄ± olan dÃ¶nem deÄeri iptal statÃ¼sÃ¼nde olan kredi kartÄ± iÃ§in 0 ile 18 arasÄ±nda yapÄ±labilecektir.  TÃ¼m kart tipleri iÃ§in belirtilen dÃ¶nem deÄerinin uygun gÃ¶nderilmediÄi durumda hata verilmelidir. \n \n \n Ekstre Turu \n ekstreTuru \n AN3 \n K \n Kart bilgileri yanÄ±tÄ±nda dÃ¶nÃ¼len ekstre tÃ¼rleri deÄerlerini almaktadÄ±r. Para birimine uygun olarak kart detay bilgileri sorgulanmaktadÄ±r. Ekstre parametresi TRY,USD,EUR,GBP olarak gÃ¶nderilebilir. Bu alan gÃ¶nderilmiyorsa TRY deÄerlendirilmelidir. Ä°lgili para birimine Ã¶zel ekstre iÃ§indeki harcama deÄeri dÃ¶nÃ¼lecektir. \n Ekstre tÃ¼rleri haricinde uygun olmayan bir deÄer gÃ¶nderildiÄinde hata verilmelidir. \n \n \n Sayfa BaÅÄ±na Ä°stenen KayÄ±t SayÄ±sÄ± \n syfKytSayi \n N3 \n Ä° \n Sayfa baÅÄ±na istenen kayÄ±t sayÄ±sÄ±. Bu alanda iletilen deÄer 100âden bÃ¼yÃ¼k olamaz. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayÄ± kadar gruplandÄ±rarak gÃ¶nderir. Bu veri gÃ¶nderilmediÄinde sayfadaki kayÄ±t sayÄ±sÄ± 100 olarak kullanÄ±lÄ±r. \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu sayfadaki kayÄ±tlarÄ± gÃ¶nderir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶nderir. \n \n \n BorÃ§ Alacak GÃ¶stergesi \n brcAlc \n AN1 \n Ä° \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Karta borÃ§ yaratan iÅlem.A: Karta alacak yaratan iÅlem. N: Finansal olmayan iÅlem {âBâ,âAâ,âNâ} \n Bu veri gÃ¶nderildiÄi durumda HHS iÅlemler listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS kart hareketlerini  sÄ±ralama kriteri iÅlem tarihi  olacak Åekilde ilgili yÃ¶ne uygun olarak sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 25: âKartHareketleriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n

16Kart Tiplerine Ä°stinaden DetaylÄ± AÃ§Ä±klama \n \n \n \n \n Kart Referans NumarasÄ± \n kartRef \n AN5..40 \n Z \n HHS tarafÄ±ndan her bir kart iÃ§in atanan biricik deÄerdir (uuid). Bir kart tek bir kartRef'e karÅÄ±lÄ±k gelmelidir, benzer Åekilde bir kartRef tek bir karta karÅÄ±lÄ±k gelmelidir. AynÄ± kart iÃ§in alÄ±nan tÃ¼m rÄ±zalarda kart referans bilgisinin deÄiÅmemesi gerekmektedir. \n \n \n \n DÃ¶nem DeÄeri \n donemDegeri \n N3 \n Z \n Kart hareketlerinin sorgulanacaÄÄ± dÃ¶neme ait deÄerdir. \n \n \n \n DÃ¶nem BaÅlangÄ±Ã§ Tarihi \n donemBaslangicTarihi \n ISODate \n Z \n Sorgulama yapÄ±lan ekstre dÃ¶nemine gÃ¶re ilgili dÃ¶neme ait baÅlangÄ±Ã§ tarih bilgisidir. Kart tipi kredi kartÄ± olanlar iÃ§in ilgili dÃ¶neme ait baÅlangÄ±Ã§ tarihi iletilmelidir. Kart tipi banka kartÄ± ve Ã¶n Ã¶demeli kart olanlar iÃ§in sorgulama yapÄ±lan ayÄ±n baÅlangÄ±Ã§ tarihi iletilmelidir. \n \n \n \n DÃ¶nem BitiÅ Tarihi \n donemBitisTarihi \n ISODate \n Z \n Sorgulama yapÄ±lan ekstre dÃ¶nemine gÃ¶re ilgili dÃ¶neme ait bitiÅ tarih bilgisidir. Kart tipi kredi kartÄ± olanlar iÃ§in ilgili dÃ¶neme ait bitiÅ tarihi iletilmelidir. Kart tipi banka kartÄ± ve Ã¶n Ã¶demeli kart olanlar iÃ§in sorgulama yapÄ±lan ayÄ±n bitiÅ tarihi iletilmelidir. \n \n \n \n Ekstre TÃ¼rÃ¼ \n ekstreTuru \n AN3 \n Z \n Ekstre tÃ¼rÃ¼ TRY,USD,EUR,GBP olarak gÃ¶nderilebilir. Ä°stek paremetresinde iletilen deÄer ile aynÄ± deÄer olmalÄ±dÄ±r. \n \n \n \n Ekstre Borcu \n ekstreBorcu \n Kompleks:EkstreBorcu \n K \n Sorgulama yapÄ±lan geÃ§miÅ dÃ¶neme iÃ§in ekstre tÃ¼rÃ¼ne uygun olarak ekstre borcu iletilmelidir. MÃ¼Återinin borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir.  MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb(+) deÄer ile tutar bilgisi gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in sadece geÃ§miÅ dÃ¶nem deÄerine istinaden ilgili alan iletilmelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n BorÃ§ tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Asgari Ãdeme TutarÄ± \n asgariOdemeTutari \n Kompleks:AsgariOdemeTutari \n K \n Ä°lgili geÃ§miÅ dÃ¶nem iÃ§in ekstre tÃ¼rÃ¼ne uygun olarak ekstreye ait asgari Ã¶deme tutarÄ± iletilmelidir. Ekstre Borcu (-) ise; asgari Ã¶deme tutarÄ± da (-) deÄer olarak gÃ¶nderilmelidir. MÃ¼Återinin alacaÄÄ± olduÄu durumda (iade/fazla Ã¶deme vb.)  \"0\" (sÄ±fÄ±r) deÄeri gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in sadece geÃ§miÅ dÃ¶nem deÄerine istinaden ilgili alan iletilmelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n Ãdeme tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n DÃ¶nem Taksit TutarÄ± \n donemTaksitTutari \n Kompleks:DonemTaksitTutari \n K \n Ä°stek parametresinde iletilen ilgili dÃ¶nem deÄeri iÃ§erisindeki toplam taksit tutar bilgisi iletilmelidir. MÃ¼Återinin DÃ¶nem Taksit Tutar borcu olduÄu durumda (-) deÄer gÃ¶nderilmelidir. DÃ¶nem Taksit Tutar iadesi veya benzeri nedenlerle oluÅan mÃ¼Återinin alacaklÄ± olduÄu durumda tutar (+) deÄer gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in taksit bilgisi varsa ilgili alan iletilmelidir. \n \n \n > Tutar \n tutar \n AN1..25 \n Z \n DÃ¶nem taksit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n > Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n Hesap Kesim Tarihi \n hesapKesimTarihi \n ISODate \n K \n Karta ait sorgulanan dÃ¶neme ait hesap kesim tarihi iletilmelidir. Tarih formatÄ±nda iletilmelidir. Ãrn : 2024-11-23 \n Kart tipi kredi kartÄ± olanlar iÃ§in sadece geÃ§miÅ dÃ¶nem deÄerine istinaden ilgili alan iletilmelidir. \n \n \n Son Ãdeme Tarihi \n sonOdemeTarihi \n ISODate \n K \n Karta ait sorgulanan dÃ¶nem iÃ§in son Ã¶deme tarih bilgisi dÃ¶nÃ¼lmelidir. Ãrn : 2024-12-02 \n Kart tipi kredi kartÄ± olanlar iÃ§in sadece geÃ§miÅ dÃ¶nem deÄerine istinaden ilgili alan iletilmelidir. \n \n \n Hareket Bilgileri \n hareketBilgileri \n Kompleks Alan: HareketBilgileri[array] \n K \n Dizi halinde liste olacaktÄ±r. \n \n \n \n > Ä°Ålem NumarasÄ± \n islemNo \n AN3..50 \n Z \n Kart hareketinin oluÅturulmasÄ± sÄ±rasÄ±nda atanan ve borÃ§ (veya alacak) hareketini tekilleÅtiren HHS bazÄ±nda tekil tanÄ±mlayÄ±cÄ±dÄ±r. Bu deÄer tek baÅÄ±na tekil olabileceÄi gibi b

16irden fazla deÄerin bir araya getirilmesiyle de tekilliÄi saÄlanmÄ±Å olabilir. Bu deÄerin en azÄ±ndan kart referans numarasÄ± bazÄ±nda tekil olmasÄ± beklenir. Genellikle kullanÄ±lan Ã¶rnekleri; Instance_Id, Transaction_Id, Transaction_Num, Transaction_TimeStamp \n \n \n \n > Ä°Ålem TutarÄ± \n islemTutari \n Kompleks:IslemTutari \n Z \n YapÄ±lan iÅleme ait tutar bilgisi. Taksitli bir iÅlem ise ilgili dÃ¶nemdeki taksit tutarÄ± iletilecektir. ÃHK, HHS'de ilgili dÃ¶nem sorguladÄ±ÄÄ±nda hangi tutarÄ± gÃ¶rÃ¼ntÃ¼lÃ¼yorsa ilgili tutar dÃ¶nÃ¼lecektir. Ä°Åleme ait sadece puan bilgisiyle kazanÄ±m, kullanÄ±m, iade veya iptal varsa ve tutar bilgisi yoksa ilgili tutar deÄeri sÄ±fÄ±r gÃ¶nderilmelidir. Puana dair deÄerler ise PuanBilgileri alanÄ± iÃ§erisinde gÃ¶nderilmelidir. \n \n \n \n >> Tutar \n tutar \n AN1..24 \n Z \n Ä°Ålem tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n >> Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi. Ekstre tÃ¼rÃ¼ ile aynÄ± olmasÄ± gerekmektedir. \n \n \n \n > Orijinal Ä°Ålem TutarÄ± \n orijinalIslemTutari \n Kompleks:OrijinalIslemTutari \n K \n Ekstre tÃ¼rÃ¼ dÄ±ÅÄ±nda yapÄ±lan iÅleme ait tutar bilgisi. ÃrneÄin; ekstre tÃ¼rÃ¼ TRY gÃ¶nderildiÄi durumda iÅlem 100 JPY ise iÅlem tutarÄ± alanÄ±nda 100 deÄeri iletilmelidir. \n \n \n \n >> Tutar \n tutar \n AN1..24 \n Z \n Ä°Ålem tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n >> Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi. ÃrneÄin; 100 JPY ise iÅlem tutar para birimi alanÄ±nda JPY deÄeri iletilmelidir. \n \n \n \n > Ä°Ålem Tarihi \n islemTarihi \n ISODateTime \n Z \n Ä°Ålemin gerÃ§ekleÅtiÄi zaman bilgisi. Taksitli iÅlemlerde iÃ§inde bulunulan dÃ¶nem Ã¶zelinde ilgili taksitin yansÄ±yacaÄÄ± tarih deÄeri dÃ¶nÃ¼lmelidir. \n \n \n \n > BorÃ§ Alacak GÃ¶stergesi \n borcAlacak \n AN1 \n Z \n TR.OHVPS.DataCode.BrcAlc sÄ±ralÄ± veri tipi deÄerlerinden birini alÄ±r. Sorgulanacak iÅlemlerin borÃ§ / alacak kriteri B: Karta borÃ§ yaratan iÅlem.A: Karta alacak yaratan iÅlem. N: Finansal olmayan iÅlem {âBâ,âAâ,âNâ} \n \n \n \n > Ä°Ålem AÃ§Ä±klamasÄ± \n islemAciklamasi \n AN1..200 \n Z \n AlÄ±ÅveriÅ iÅlemi olmasÄ± durumunda sadece iÅyeri adÄ±nÄ± iÃ§eren aÃ§Ä±klama, diÄer iÅlemler iÃ§in mevcut iÅlem aÃ§Ä±klamasÄ± iletilir. HHS'ler tÃ¼m kart hareketlerini YÃS'ler ile paylaÅmakla yÃ¼kÃ¼mlÃ¼ olup, hassas veri iÃ§eren(Ã¶rn: faiz, komisyon bilgisi iÃ§eren vb.) iÅlem hareketleri de bu kapsamda deÄerlendirilerek iÅlem aÃ§Ä±klamasÄ±nÄ±n maskeli olarak iletilmesi saÄlanÄ±r. Kelimelerin ilk 3 hanesi maskeli olacak Åekilde, ancak sakÄ±ncalÄ± bulunan kelimeler varsa; (Ã¶rn: faiz, komiyon vb.) kelimelerin tamamÄ± maskeli olacak Åekilde gÃ¶sterilebilir. \n \n \n \n > Ä°Ålem Puan Bilgileri \n islemPuanBilgileri \n Kompleks: IslemPuanBilgileri[Array] \n K \n Ä°lgili iÅlem sonrasÄ± kazanÄ±lan veya kullanÄ±lan bir puan deÄeri varsa iletilmesi gerekmektedir. Ä°lgili puan bilgi veya bilgileri dizi iÃ§erisinde iletilmelidir. \n Ä°lgili alanda koÅula uygun olarak deÄer dÃ¶nÃ¼lecekse; kart tipi kredi, banka ve Ã¶n Ã¶demeli kartÄ± olanlar iÃ§in dÃ¶nÃ¼lmesi zorunludur. \n \n \n >> Ä°Ålem PuanÄ± \n islemPuani \n AN1..24 \n K \n Ä°Åleme dair kazanÄ±lan veya kullanÄ±lan puan deÄeri iletilmelidir. Ãrn: 100 Plus kazanÄ±lmÄ±Å bir iÅlem iÃ§in 100 deÄeri iletilmelidir. \n \n \n \n >> Ä°Ålem Puan Birimi \n islemPuanBirimi \n AN1..50 \n K \n Ä°Åleme dair kazanÄ±lan veya kullanÄ±lan puan birimi iletilmelidir. Ãrn: 100 Plus kazanÄ±lmÄ±Å bir iÅlem iÃ§in Plus deÄeri iletilmelidir. \n \n \n \n >> Ä°Ålem Puan Durumu \n islemPuanDurumu \n AN2 \n K \n Ä°lgili iÅlem sonucunda puan bilgisinin bir kazanÄ±m, kullanÄ±m, iade ve iptal durumlarÄ±na yÃ¶nelik deÄer iletilmelidir. TR.OHVPS.DataCode.IslemPuanDurumu deÄerlerinden birini alÄ±r. 01: Puan KazanÄ±mÄ± 02: Puan KullanÄ±mÄ± 03: Puan Ä°ade 04: Puan Ä°ptal \n \n \n \n > Toplam Taksit TutarÄ± \n toplamTaksitTutari \n Kompleks:ToplamTaksitTutari \n K \n Ä°lgili iÅlem taksitli bir iÅlem ise o iÅleme ait toplam taksit tutarÄ± iletilmelidir. Ä°lgili iÅlem tek Ã§ekim bir iÅlem ise o iÅlemde ilgili alan iletilmemelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n >> Tutar \n tutar \n AN1..25 \n Z \n Taksit Tutar Bilgisi. Taksit tutarÄ± iÃ§in regex patterni Åu Åekildedir: ' ^[\\-\\+]?\\d{1,18}$|^[\\-\\+]?\\d{1,18}\\.\\d{1,5}$ ' \n \n \n \n >> Para Birimi \n paraBirimi \n AN3 \n Z \n Para Birimi \n \n \n \n > Toplam Taksit SayÄ±sÄ± \n toplamTaksitSayisi \n N2 \n K \n Ä°lgili iÅlem taksitli bir iÅlem ise o iÅleme ait toplam taksit sayÄ±sÄ± iletilmelidir. Ä°lgili iÅlem tek Ã§ekim bir iÅlem ise o iÅlemde ilgili alan iletilmemelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > Ä°lgili Taksit DÃ¶nemi \n taksitDonemi \n N2 \n K \n Taksitli iÅlem olmasÄ± durumunda iÅleme ait ilg

16ili taksit dÃ¶nem bilgisi. ÃrneÄin: 3 taksitli bir iÅlemde 2. taksit yansÄ±mÄ±Åsa 2 olarak gÃ¶nderilmelidir. \n Kart tipi kredi kartÄ± olanlar iÃ§in ilgili alan dÃ¶nÃ¼lmesi zorunludur. Kart tipi banka ve Ã¶n Ã¶demeli kart olan kartlar iÃ§in ilgili alan dÃ¶nÃ¼lmemelidir. \n \n \n > SatÄ±cÄ± Kategori Kodu \n saticiKategoriKodu \n AN4 \n K \n SatÄ±cÄ± Kategori Kodu(MCC) varsa iletilmesi zorunludur. AlÄ±ÅveriÅ iÅlemlerinde gÃ¶nderimi zorunludur. \n Ä°lgili alanda koÅula uygun olarak deÄer dÃ¶nÃ¼lecekse; kart tipi kredi ve banka kartÄ± olanlar iÃ§in dÃ¶nÃ¼lmesi zorunludur. \n \n \n \n"},{title:"HHS, YÃS ve Temsilcilik API",frontmatter:{},regularPath:"/v2.0.1/contents/hhs-yos-api.html",relativePath:"v2.0.1/contents/hhs-yos-api.md",key:"v-1c9ff506",path:"/v2.0.1/contents/hhs-yos-api.html",headers:[{level:2,title:"HHS API",slug:"hhs-api"},{level:2,title:"YÃS API",slug:"yos-api"},{level:2,title:"TEMSÄ°LCÄ°LÄ°K API",slug:"temsilcilik-api"}],content:" HHS, YÃS ve Temsilcilik API \n HHS API, HHSâlerin detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. HHS API iÃ§in âhhs_readâ scope bilgisi kullanÄ±lÄ±r. \n Production ortamÄ±nda HHS / YOS API iÃ§erisinde sisteme dahil olmuÅ, sertifikasyonu baÅarÄ± ile tamamlamÄ±Å paydaÅlar listelenecektir. HHS tarafÄ±ndan desteklenen API sÃ¼rÃ¼mleri listelenecektir. \n YÃSâler HHS APIâsini sorgulayabilir ancak YÃS APIâsini sorgulayamazlar. \nBenzer Åekilde HHSâler YÃS APIâsini sorgulayabilir, HHS APIâsini sorgulayamazlar. \n HHS API \n GET /hhs/{hhsKod} \n Ä°Ålem Sorgu ÃrneÄi =  /hhs  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m HHSâlerin dizi Åeklinde verileri listelenir. \nÄ°Ålem Sorgu ÃrneÄi =  /hhs/2001   â¨ bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan hhsKoduâna ait bilgiler listelenir. Ya da â404 Not Foundâ hatasÄ± alÄ±r. \nHHS ve YÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir. \nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap) =  /hhs?srlmKrtr=kod&srlmYon=A \n Tablo 20: HHS ve YÃS API Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n SÄ±ralama Kriteri \n srlmKrtr \n AN3..50 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama kriterini belirtir. AlabileceÄi deÄerler: {âkodâ, âunvâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu kritere gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, sÄ±ralama kriteri âunvâ olarak belirlenmelidir. \n \n \n SÄ±ralama YÃ¶nÃ¼ \n srlmYon \n AN1 \n Ä° \n Cevapta dÃ¶nÃ¼lecek iÅlemlerin sÄ±ralama yÃ¶nÃ¼nÃ¼ belirtir. AlabileceÄi deÄerler: A: Azalan deÄerle sÄ±ralama Y: Artan deÄerle sÄ±ralama {âAâ,âYâ} \n Bu veri gÃ¶nderildiÄi durumda, HHS iÅlemler listesini bu yÃ¶ne gÃ¶re sÄ±ralayarak gÃ¶nderir. GÃ¶nderilmediÄinde, HHS sÄ±ralama yÃ¶nÃ¼nÃ¼ Azalan olarak belirler. \n \n \n \n Tablo 21: HHS Bilgileri Sorgulama YanÄ±tÄ± âHhsâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n hhs kodu \n kod \n AN4 \n Z \n HHS nin kod bilgisi \n \n \n hhs unvanÄ± \n unv \n AN3..140 \n Z \n HHS nin unvan bilgisi \n \n \n hhs markasÄ± \n marka \n AN1..140 \n Z \n ÃHK'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. HHS tarafÄ±ndan belirlenecektir. \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n HHSânin mesaj imzalama iÃ§in paylaÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n HHS Api Bilgileri \n apiBilgileri \n Kompleks: HhsApiBilgi[Array][0..N] \n Z \n Desteklenen Api ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > api \n api \n AN1..20 \n Z \n Api Ä°smi Ãrnek :obh, hbh,gkd \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s1.0, s2.0 \n \n \n HHS Hizmet Bilgileri \n hizmetBilgileri \n Kompleks: HhsHizmetBilgi[Array][0..N] \n Z \n Desteklenen hizmet ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > hizmetTipi \n hizmetTipi \n AN1..20 \n Z \n Hizmet Tipi bilgileri.TR.OHVPS.DataCode.HizmetTipi sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s1.1, s2.0 \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n HHS'ye ait logo bilgileri. \n \n \n > logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n HHS tarafÄ±nda tutulan ve YÃS'lerle paylaÅÄ±lacak olan url adres bilgisidir.  Ãrnek: https://via.placeholder.com/150?text=0001 \n \n \n > logoArkaPlan \n logoArkaPlan \n AN1 \n Z \n TR.OHVPS.DataCode.LogoArkaPlan sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoFormat \n logoFormat \n AN3 \n Z \n TR.OHVPS.DataCode.LogoFormat sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n Durum \n durum \n AN1 \n Z \n HHS'nin durum bilgisidir.  TR.OHVPS.DataCode.HHSDurumu sÄ±ralÄ± veri tipinde alabileceÄi deÄerler belirtilmiÅtir. \n \n \n \n HHS API'de; AÃ§Ä±k, YaygÄ±nlaÅtÄ±rma, GeÃ§ici Hizmet Veremiyor, KapalÄ± durumlarÄ±ndaki HHS'ler listelenecektir.  \nSertifikasyon onayÄ± alan HHS'ler, Ã¼retim ortamÄ±na geÃ§iÅte \"YaygÄ±nlaÅtÄ±rma\" durumuna sahip olabilir.  HHS'nin, hangi YÃS'ler ile \"YaygÄ±nlaÅtÄ±rma\" kontrollerini y

16apacaÄÄ±, HHS yÃ¶netiminde olacaktÄ±r. BÃ¶ylece Ãretim OrtamÄ±nda HHSânin kendisi tarafÄ±ndan tanÄ±mlanmÄ±Å kÄ±sÄ±tlÄ± ÃHKâya hizmet vermesi ve servislerini test etmesi saÄlanabilir olacaktÄ±r. HHS'ler kendi kurum kontrollerini yapana kadar, \"YaygÄ±nlaÅtÄ±rma\" durumunda kalabilirler. HHS'nin BKM'ye yapacaÄÄ± talep ile, HHS \"YaygÄ±nlaÅtÄ±rma\" durumundan \"AÃ§Ä±k\" durumuna geÃ§ebilecektir. \n AÅaÄÄ±daki durumlarda HHS'nin statÃ¼sÃ¼ GeÃ§ici KapalÄ± olarak gÃ¼ncellenebilecektir: \n \n HHS'nin talebi ile uzun sÃ¼reli (minimum 1 saati aÅan) yaÅanan teknik sorunlarda ve BKMâye en az 3 iÅ gÃ¼nÃ¼ Ã¶ncesinde bildirilen planlÄ± kesintilerde G statÃ¼sÃ¼ne alÄ±nabilecektir. \n Ä°lgili resmi kurumlardan gelen talep Ã¼zerine HHS G statÃ¼sÃ¼ne alÄ±nabilir. \n \n YÃS'ler hem A hem G statÃ¼sÃ¼nde olan HHS'leri listeleyebilir. Ancak YÃS uygulamasÄ±nda G statÃ¼sÃ¼nde olan bir HHS mÃ¼Återi tarafÄ±ndan seÃ§ilirse mÃ¼Återiye gerekli hata mesajÄ±nÄ±n verilmesi ve ilgili HHS'ye istek atÄ±lmamasÄ± saÄlanmalÄ±dÄ±r. \n Hem YOS hem de HHS API iÃ§in geÃ§erli olacak; logo gÃ¶nderiminde dikkat edilmesi gerekenler Åu Åekilde tariflenmiÅtir: \n \n LogolarÄ±n ham dosya yerine kurumun yayÄ±nlayacaÄÄ± bir URL Ã¼zerinden sunulmasÄ± gerekmektedir. (Ãrn: logoURL = https://kurumadi.com.tr/logo.png) Logo BKM tarafÄ±nda host edilmeyecektir. \n Logo urlâin public eriÅilebilir url olmasÄ± gereklidir. \n Logo, yatayda veya dikeyde taÅma paysÄ±z tam oturacak, sÄ±nÄ±r boyutlarÄ±nÄ± geÃ§meyecek ve ortalanmÄ±Å yerleÅime sahip olmalÄ±dÄ±r. \n YÃS uygulamasÄ±nda gÃ¶sterim esnasÄ±nda logolarÄ±n hÄ±zlÄ± yÃ¼klenmesi ve dÃ¼ÅÃ¼k veri tÃ¼ketmesi aÃ§Ä±sÄ±ndan; logo boyutu 250 KBâÄ±n altÄ±nda olmalÄ±dÄ±r. \n HHS ve YÃSâlerin tÃ¼m logo tÃ¼rlerini (8 farklÄ± tipte logoyu) zorunlu olarak dÃ¶nmesi beklenmektedir. \n Circle logo kullanÄ±lmasÄ± gerektiÄinde ICON_LOGO logo tÃ¼rÃ¼ kullanÄ±lmalÄ±dÄ±r. \n LogolarÄ±nÄ± gÃ¼ncellemek isteyen Kurumlar bu deÄiÅikliÄi, pys Ã¼zerinden (https://pys-preprod.bkm.com.tr, https://pys.bkm.com.tr ) gÃ¼ncelleyerek onaya iletmeleri gereklidir. BKM de katÄ±lÄ±mcÄ±lara HHS/YÃS API aracÄ±lÄ±ÄÄ± ile gÃ¼ncel logonun Ã§ekilmesi gerektiÄine dair bilgilendirme yapar. \n LogolarÄ± anlÄ±k Ã§eken katÄ±lÄ±mcÄ±larÄ±n, herhangi bir teknik nedenden dolayÄ± gÃ¼ncel logoyu alamadÄ±ÄÄ± durum olabilir. Bu durumda sistemlerine kaydetmiÅ olduÄu kuruma ait ikon logoyu gÃ¶stermesi gereklidir. \n HHS ve YÃSâler API aracÄ±lÄ±ÄÄ± ile almÄ±Å olduklarÄ± logolarÄ±n formatÄ± Ã¼zerinde deÄiÅiklik (kare, yuvarlak hale getirip resize etmek gibi) yapabilirler. Ancak logonun gÃ¶rsel ve yazÄ±larÄ±nÄ± etkileyecek bir  deÄiÅiklik yapmamalÄ±dÄ±rlar. \n YÃS/HHS mobil uygulamasÄ±ndaki dark mode ve light mode kullanÄ±mlarÄ±nda, hangi logonun kullanÄ±lacaÄÄ±na uygulama sahibi karar verecektir. \n YÃS API \n YÃS API, YÃS statÃ¼sundeki kurumlarÄ±n detay bilgilerini sunan servistir. Bu servis ile aÅaÄÄ±daki istek/yanÄ±t yapÄ±larÄ± ile ihtiyaÃ§ duyulabilecek ilgili bilgiler temin edilebilir. YÃS API iÃ§in âyos_readâ scope bilgisi kullanÄ±lÄ±r. \n YÃS API yanÄ±tÄ±nda, listelenen yÃ¶nlendirme ve bildirim adresleri bulunmaktadÄ±r. HHS, iÅlem anÄ±nda iletilen yonAdr ya da bldrAdr alanlarÄ±nda gÃ¶nderilen adreslere yetKod deÄerini iletmelidir. YÃS API iÃ§erisinde yer alan adresleri, rÄ±za isteÄinde gÃ¶nderilen adreslerin doÄruluÄunu kontrol etme amacÄ±yla kullanÄ±lmalÄ±dÄ±r. Bu nedenle YÃS API iÃ§erisinde listelenen adreslerin hostname seviyesinde yer almasÄ± yeterlidir. \n YÃS API iÃ§erisinde yer alan YÃS rol bilgileri ve aktiflik/pasiflik durumlarÄ± birbiriyle iliÅkili deÄildir. \n YÃS'Ã¼n sahip olduÄu Ã¶bhs,hbhs rolleri iÃ§in herhangi bir fraud ya da teknik sebeplerden Ã¶tÃ¼rÃ¼ geÃ§ici sÃ¼reyle geri alÄ±nabilir. \n YÃS'lerin hizmet verememesi durumunda rollerinin geri alÄ±nmasÄ± yapÄ±lmayacaktÄ±r. YÃS rolleri sadece ilgili resmi kurumlardan gelen talep Ã¼zerine alÄ±nabilecektir. \n YÃS aktifliÄini korurken problem Ã§Ã¶zÃ¼lene kadar geÃ§ici olarak alÄ±nan roller(Ã¶bhs,hbhs) tekrardan aktif hale getirilir. \n GET /yos/{yosKod} \n Ä°Ålem Sorgu ÃrneÄi =  /yos  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m YÃS'lerin dizi Åeklinde verileri listelenir. \n Ä°Ålem Sorgu ÃrneÄi =  /yos/2501  â¨  bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan yosKoduâna ait bilgiler listelenir ya da â404 Not Foundâ hatasÄ± alÄ±r.\nYÃS API Tablo 20âdeki istek parametrelerine gÃ¶re sorgulanabilir.\nÄ°Ålem Sorgu ÃrneÄi (Belirli Bir Hesap)=  /yos?srlmKrtr=kod&srlmYon=A \n Tablo 22: YOS Bilgileri Sorgulama YanÄ±tÄ± âYosâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n YÃ¶s kodu \n kod \n AN4 \n Z \n YÃS'Ã¼n kod bilgisi \n \n \n YÃ¶s unvanÄ± \n unv \n AN3..140 \n Z \n YÃS unvan bilgisi \n \n \n YÃ¶s markasÄ± \n marka \n AN1..140 \n Z \n ÃHK'nÄ±n kolaylÄ±kla algÄ±layabileceÄi kÄ±sa unvan bilgisi. YÃS tarafÄ±ndan belirlenecektir. \n \n \n YÃS rolleri \n roller \n Array[AN4] \n Z \n YÃSâun rollerini belirten deÄer. Ãrnek: [ \"obhs\", \"hbhs\" ]  - obhs - Ãdeme Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼  - hbhs - Hesap Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼ \n \n \n Adresler \n adresler \n Kompleks:Adres[Array] [1..N] \n Z \n --- \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. Adres detaylarÄ±nÄ±n hangi GKD tÃ¼rÃ¼ne ait olduÄunu belirtir. \n \n \n > Adres DetaylarÄ± \n adresDetaylari \n adresDetaylari\tKompleks: AdresDetayi[Array] [1..N] \n Z \n \n \n \n >> Temel Adres \n tmlAdr \n AN1..1024 \n Z \n yetYntm deÄeri âYâ olarak iletildiÄinde YÃ¶nlendirmeli GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. yetYntm deÄeri âAâ olarak iletildiÄinde AyrÄ±k GKD sÃ¼recinde HHSânin YOSâe authorizasyon kodunu hangi url e gÃ¶ndereceÄi bilgisini tutar. Riza isteklerinde bu deÄer ile uyumluluÄu kontrol edilmelidir. Ãrnek: https://example.com https://example2.com/path deepLink://example/test deepLink://example2/test \n \n \n >> AÃ§Ä±klama \n aciklama \n AN1..1024 \n Ä° \n YÃSâÃ¼n gÃ¶nderdiÄi adrese yÃ¶nelik vermek istediÄi aÃ§Ä±klama Ãrnek: WEB bireysel , WEB kurumsal  , APP \n \n \n AÃ§Ä±k anahtar \n acikAnahtar \n AN1..1024 \n Z \n YÃSâÃ¼n mesaj imzalama iÃ§in payla

16ÅtÄ±ÄÄ± aÃ§Ä±k anahtar \n \n \n YÃS Api Bilgileri \n apiBilgileri \n Kompleks: YosApiBilgi[Array][0..N] \n Z \n Desteklenen Api ve sÃ¼rÃ¼m bilgileri dÃ¶nÃ¼lecektir. \n \n \n > api \n api \n AN1..20 \n Z \n Api Ä°smi Ãrnek :ods \n \n \n > surum \n surum \n AN1..10 \n Z \n Api SÃ¼rÃ¼m Kodu Ãrnek: s1.0, s2.0 s1.0 \n \n \n Logo Bilgileri \n logoBilgileri \n Kompleks: LogoBilgisi [Array][1..N] \n Z \n YOSâe ait logo bilgileri. \n \n \n > logoTur \n logoTur \n AN3..50 \n Z \n Logonun tÃ¼rÃ¼nÃ¼ belirler. TR.OHVPS.DataCode.LogoTur sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoAdr \n logoAdr \n AN1..255 \n Z \n YÃS tarafÄ±nda tutulan ve HHSâlerle paylaÅÄ±lacak olan url adres bilgisidir.  Ãrnek: https://via.placeholder.com/150?text=0001 \n \n \n > logoArkaPlan \n logoArkaPlan \n AN1 \n Z \n TR.OHVPS.DataCode.LogoArkaPlan sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n > logoFormat \n logoFormat \n AN3 \n Z \n TR.OHVPS.DataCode.LogoFormat sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerlerinden birini alÄ±r. \n \n \n Durum \n durum \n AN1 \n Z \n YÃS'Ã¼n durum bilgisidir.  TR.OHVPS.DataCode.YOSDurumu sÄ±ralÄ± veri tipinde alabileceÄi deÄerler belirtilmiÅtir. \n TEMSÄ°LCÄ°LÄ°K API \n Temsilcilik API, ÃHVPS kapsamÄ±nda hizmet sunan temsilcilere iliÅkin bilgilerin HHSâler tarafÄ±ndan sorgulanabilmesini saÄlamak amacÄ±yla sunulmaktadÄ±r. Bu API aracÄ±lÄ±ÄÄ±yla, bir temsilcinin hangi YÃS (ler) aracÄ±lÄ±ÄÄ± ile hizmet sunduÄu ve hangi roller kapsamÄ±nda faaliyet gÃ¶sterdiÄi bilgilerine eriÅilebilecektir.\nTemsilcilik API iÃ§in HHS'ler, mevcuttaki yos_read scope bilgisini kullanarak eriÅebilecektir. \n GET /temsilcilik/{temsilciKod} \n Ä°Ålem Sorgu ÃrneÄi =  /temsilcilik  â¨  bu sorgu yÃ¶ntemi ile tÃ¼m temsilcilerin dizi Åeklinde verileri listelenir. \n Ä°Ålem Sorgu ÃrneÄi =  /temsilcilik/25015  â¨  bu sorgu yÃ¶ntemi ile gÃ¶nderilmiÅ olan temsilciKodâa ait bilgiler listelenir. \n Tablo 23: Temsilcilik Bilgileri Sorgulama YanÄ±tÄ± âTemsilcilikâ nesnesi \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Temsilci kodu \n temsilciKod \n AN5 \n Z \n Temsilcinin kod bilgisi. \n \n \n Temsilci unvanÄ± \n unvan \n AN6..140 \n Z \n Temsilcinin unvan bilgisi. \n \n \n Temsilci yÃ¶s listesi \n calistigiYosListesi \n [Array][0..N] \n Z \n Temsilcinin Ã§alÄ±ÅtÄ±ÄÄ± YÃ¶s'lere ait Ã¶zet bilgi. \n \n \n > YÃ¶s kodu \n yosKod \n AN4 \n Z \n YÃS'Ã¼n kod bilgisi \n \n \n > Temsilci durum kodu \n durum \n AN1 \n Z \n Ãrnek: [ \"A\", \"G\", \"K\" ]  - A - AÃ§Ä±k  - G - GeÃ§ici Hizmet Veremiyor  - K - KapalÄ± \n \n \n > Temsilcinin hizmet sunduÄu roller \n temsilcilikRoller \n [Array][1..N] \n Z \n Temsilcinin rollerini belirten deÄer. Ãrnek: [ \"obhs\", \"hbhs\" ]  - obhs - Ãdeme Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼  - hbhs - Hesap Bilgisi Hizmet SaÄlayÄ±cÄ± RolÃ¼ \n \n \n \n"},{title:"2.Kapsam ve Dayanak",frontmatter:{},regularPath:"/v2.0.1/contents/kapsam-ve-dayanak.html",relativePath:"v2.0.1/contents/kapsam-ve-dayanak.md",key:"v-a6caf7c6",path:"/v2.0.1/contents/kapsam-ve-dayanak.html",content:" 2.Kapsam ve Dayanak \n 12 KasÄ±m 2019âda gÃ¼ncellenen â 6493 sayÄ±lÄ± Ãdeme ve Menkul KÄ±ymet Mutabakat Sistemleri, Ãdeme Hizmetleri ve Elektronik Para KuruluÅlarÄ± HakkÄ±nda Kanun âun (Kanun) 12ânci maddesine yeni eklenen ve  Ãdeme Hizmetleri Direktifi 2 'de (Payment Services Directive 2, PSD2) bulunan iki yeni Ã¶deme hizmeti aÅaÄÄ±daki gibi tanÄ±mlanmÄ±ÅtÄ±r (Åekil-1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri): \n \n Ãdeme Emri BaÅlatma Hizmeti : ÃHKânÄ±n isteÄi Ã¼zerine baÅka bir Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nda bulunan  Ã¶deme hesabÄ±yla  ilgili sunulan Ã¶deme emri baÅlatma hizmeti [Madde 12, birinci fÄ±kra, (f) bendi] \n Hesap Bilgisi Hizmeti : ÃHKânÄ±n onayÄ±nÄ±n alÄ±nmasÄ± koÅuluyla, ÃHKânÄ±n Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ± nezdinde bulunan bir veya daha fazla  Ã¶deme hesabÄ±na  iliÅkin konsolide edilmiÅ bilgilerin Ã§evrim iÃ§i platformlarda sunulmasÄ± hizmeti [Madde 12, birinci fÄ±kra, (g) bendi] \n \n   \n Åekil 1: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS)- tanÄ±tÄ±m \n Kanunun 14/A maddesinin ikinci fÄ±krasÄ±na gÃ¶re , Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetleri ile ilgili iÅlemlerin yÃ¼rÃ¼tÃ¼lmesine iliÅkin usul ve esaslar ile taraflarca uyulmasÄ± gereken teknik ve operasyonel gereklilikler ikincil dÃ¼zenlemeler uyarÄ±nca TÃ¼rkiye Cumhuriyet Merkez BankasÄ± (TCMB) tarafÄ±ndan belirlenir. Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri  Ã¶deme hizmetleri veri paylaÅÄ±m servisleri (ÃHVPS)  olarak adlandÄ±rÄ±lmaktadÄ±r. \n Ãdeme Hizmetleri ve Elektronik Para Ä°hracÄ± ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± HakkÄ±nda YÃ¶netmelikâin (YÃ¶netmelik) 59âuncu maddesinin birinci fÄ±krasÄ± uyarÄ±nca hazÄ±rlanan bu belgede sÃ¶z konusu Ã¶deme hizmetlerini sunacak Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, Ã¶deme hesabÄ±nÄ±n bulunduÄu Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ±nÄ±n, varsa ilgili diÄer taraflarÄ±n ve bu hizmetlerin sunulmasÄ± iÃ§in taraflar arasÄ±nda kurulacak baÄlantÄ±nÄ±n teknik ve operasyonel gereklilikleri aÃ§Ä±klanmaktadÄ±r. \n DÃ¼zenlemeler kapsamÄ±nda yetkilendirilen Ã¼Ã§Ã¼ncÃ¼ taraf hizmet saÄlayÄ±cÄ±sÄ±  (Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ±, YÃS) , Ã¶deme hizmeti kullanÄ±cÄ±larÄ±nÄ±n  Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS)  nezdindeki Ã¶deme hesaplarÄ±na ulaÅarak Ã¶deme emri baÅlatma ve hesap bilgisi saÄlama hizmetlerinden (Ã¶deme hizmetleri veri paylaÅÄ±m servislerinden) faydalanmasÄ±na aracÄ±lÄ±k eder. Ãdeme hizmetleri veri paylaÅÄ±m servisleri kapsamÄ±nda iki tip YÃS bulunmaktadÄ±r:  1) Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ve 2) Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS). \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± (HBHS) ÃHKânÄ±n farklÄ± Hesap Hizmeti SaÄlayÄ±cÄ±larÄ± (HHS) nezdindeki hesaplarÄ±nÄ±n bilgilerini derleyerek Ã§evrim iÃ§i platformlarda  toplu Åekilde  sunar. Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± (ÃBHS) ise talebi Ã¼zerine ÃHKânÄ±n HHSâde bulunan Ã¶deme hesabÄ±ndan Ã¶deme iÅlemi baÅlatÄ±r. \n ÃHVPSânin Ã¼st dÃ¼zey gÃ¶sterimi Åekil-2âde verilmiÅtir. \n   \n Åekil 2: Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (ÃHVPS) -Ã¼st dÃ¼zey gÃ¶sterim \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servislerinin HHSâler tarafÄ±ndan  GEÃÄ°T  vasÄ±tasÄ±yla sunulduÄu uygulama mimarisi ise Åekil-3âte sunulmuÅtur. \n  \n Åekil 3: ÃHVPS'nin GEÃÄ°T vasÄ±tasÄ±yla sunumu \n"},{title:"7.\tÄ°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v2.0.1/contents/ileri-tarihli-odeme-emri-hizmeti.html",relativePath:"v2.0.1/contents/ileri-tarihli-odeme-emri-hizmeti.md",key:"v-dbcd7a7e",path:"/v2.0.1/contents/ileri-tarihli-odeme-emri-hizmeti.html",headers:[{level:2,title:"Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"ileri-tarihli-odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"7.1.\tADIM 0 - Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± BaÅlatma IsteÄi",slug:"_7-1-adim-0-ileri-tarihli-odeme-emri-rÄ±zasÄ±-baslatma-istegi"},{level:2,title:"7.2.\tADIM 1 - Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_7-2-adim-1-ileri-tarihli-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"7.3.\tADIM 2- Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_7-3-adim-2-ileri-tarihli-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"7.4.\tADIM 2.1 â Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_7-4-adim-2-1-ileri-tarihli-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"7.5.\tADIM 3- Ä°leri Tarihli Ãdeme Emrinin OluÅturulmasÄ±",slug:"_7-5-adim-3-ileri-tarihli-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"7.6.\tADIM 3.1- Ä°leri Tarihli Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_7-6-adim-3-1-ileri-tarihli-odeme-emri-sorgusu-istege-baglÄ±"},{level:2,title:"7.7.\tADIM 4- Ä°leri Tarihli Ãdeme Emri RÄ±za Ä°ptali",slug:"_7-7-adim-4-ileri-tarihli-odeme-emri-rÄ±za-iptali"}],content:" 7.\tÄ°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti \n Ãdeme hizmeti kullanÄ±cÄ±sÄ±nÄ±n ileri bir tarihte gerÃ§ekleÅmesini istediÄi Ã¶deme emirlerinde bu hizmeti kullanabilir. Ãdemenin Havale / PÃS / FAST Ã¶deme sistemlerinden hangisi ile gerÃ§ekleÅeceÄine, Ã¶deme gÃ¼nÃ¼ geldiÄinde HHS karar verir. \n Ä°leri tarihli Ã¶deme hizmetini online bankacÄ±lÄ±k sistemlerinde sunan HHS'lerin, ÃHVPS Ã¼zerinden bu hizmetleri sunmasÄ± zorunludur. Mevcutta online kanallarÄ±ndan bu hizmeti sunduklarÄ± mÃ¼Återi segmentine (bireysel,kurumsal vb.), ÃHVPS Ã¼zerinden hizmet sunmaya devam etmeleri gerekmektedir. YÃS, bireysel mÃ¼Återi Ã¶zelinde ileri tarihli Ã¶deme hizmeti vermeyen HHS'ye ileri tarihli bir Ã¶deme emri rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.IndividualCustomerNotSupported\"  hatasÄ± , kurumsal mÃ¼Återi Ã¶zelinde ileri tarihli Ã¶deme emri rÄ±zasÄ± isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  TR.OHVPS.Business.CorporateCustomerNotSupported  hatasÄ± verilmelidir. \n HHS'ler ileri tarihli Ã¶deme emri hizmetini sunuÅ bilgilerini HHS API aracÄ±lÄ±ÄÄ± ile yayÄ±nlayacaklardÄ±r. YÃS, ileri tarihli Ã¶deme hizmeti baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\":\"02\" parametresi ile alabilir. YÃS, ileri tarihli Ã¶deme hizmeti sunmayan HHS'ye ileri tarihli bir Ã¶deme emri rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.ScheduledPaymentNotSupported  hatasÄ±

16iletilmelidir. \n Ä°leri tarihli Ã¶deme emri hizmetinde TRY dÄ±ÅÄ±ndaki yabancÄ± para birimleri iÃ§in HHS tarafÄ±ndan destek verilmemesi durumunda  TR.OHVPS.Business.InvalidCurrencyCode  hataasÄ± verilmelidir. \n Ä°leri tarihli Ã¶deme emri gÃ¼ncelleme hizmeti YÃS Ã¼zerinden yapÄ±lamayacaktÄ±r. ÃHK aktif olan dÃ¼zenli Ã¶deme talimat rÄ±zasÄ±nÄ± iptal ederek, yeniden oluÅturabilecektir. \n HHS Ã¼zerinden ilgili gÃ¼ncelleme hizmeti saÄlanabilir. Ä°leri tarihli talimat iÃ§erisinde yapÄ±lan gÃ¼ncelleme sonucunda olay bildirim ile YÃS'e bildirim saÄlanacaktÄ±r. HHS Ã¼zerinden gÃ¼ncelleme yapÄ±lÄ±rken talimat tarihine dair ileri bir tarihe gÃ¼ncelleme adÄ±mÄ± olmamalÄ±dÄ±r. Sadece ilk oluÅturulan talimat tarihinden Ã¶ncesi olacak Åekilde gÃ¼ncelleme yapÄ±lmasÄ±na izin verilmelidir. \n Ä°leri Tarili Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n Ä°leri Tarihli Ãdeme Emri RÄ±za BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden ileri tarihli Ã¶deme emrini baÅlatÄ±r. \n Ä°leri Tarihli Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âÄ°leri Tarihli Ãdeme Emri BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve ileri tarihli Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n Ä°leri Tarihli Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âileri tarihli Ã¶deme emriâni HHSâye iletir. \n Ä°leri Tarihli Ãdeme Emri RÄ±za Durumu, Ä°leri Tarihli Ãdeme Emri Durumu, Ä°leri Tarihli Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, Ä°leri Tarihli Ãdeme Emri RÄ±za Durumu, Ä°leri Tarihli Ãdeme Emri Durumu, Ä°leri Tarihli Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±)  mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin hem HBH hem de ÃBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini(Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n YÃS'ler gÃ¶nderen hesap seÃ§imini aÅaÄÄ±daki yÃ¶ntemlerden biri ya da birkaÃ§Ä± ile saÄlayabilirler: \n \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± HHS ekranÄ±ndan seÃ§tirebilir. \n YÃS, mÃ¼Återisinden Hesap Bilgisi rÄ±zasÄ± alÄ±r. RÄ±za aldÄ±ÄÄ± hesaplar Ã¼zerinden hesap referansÄ± aracÄ±lÄ±ÄÄ± ile ileri tarihli Ã¶deme emri baÅlatabilir. \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± elle girmesine olanak tanÄ±yabilir. IBAN'Ä± olmayan HHS'ler ileri tarihli Ã¶deme emri rÄ±zasÄ± adÄ±mÄ±nda  TR.OHVPS.Business.IBANNotSupported  hatasÄ±nÄ± vermelidir. IBAN'Ä± olan HHS'lerin bu akÄ±ÅÄ± desteklemesi zorunludur. \n YÃS; mÃ¼Återisinin hesap referansÄ±nÄ± elle girmesini saÄlayabilir. Hesap ReferansÄ± bilgisi ile baÅlatÄ±lan ileri tarihli Ã¶deme emri iÅlemlerinde HHS seÃ§imi zorunludur. \n \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in, YÃS'ler hesap referansÄ± ile Ã¶deme baÅlatabilirler. BunlarÄ±n dÄ±ÅÄ±ndaki HHS'lerin, gÃ¶nderen IBAN veya hesap referansÄ± ile Ã¶deme akÄ±ÅÄ±nÄ± desteklemesi zorunludur. \n Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. Ãdeme Emri Hizmeti ile aynÄ± etki alanÄ±(scope) kullanÄ±lmaktadÄ±r. \n Tablo : Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n ileri-tarihli-odeme-emri-rizasi \n POST \n /ileri-tarihli-odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n IleriTarihliOdemeEmriRizasiIstegi \n Iler

16iTarihliOdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 3 \n ileri-tarihli-odeme-emri-rizasi \n GET \n /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n IleriTarihliOdemeEmriRizaYaniti \n \n \n 4 \n ileri-tarihli-odeme-emri \n POST \n /ileri-tarihli-odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n IleriTarihliOdemeEmriIstegi \n IleriTarihliOdemeEmri \n \n \n 5 \n ileri-tarihli-odeme-emri \n GET \n /ileri-tarihli-odeme-emri/{odmEmriNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n IleriTarihliOdemeEmri \n \n \n 6 \n ileri-tarihli-odeme-emri-rizasi-iptal \n DELETE \n /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n - \n - \n - \n 7.1.\tADIM 0 - Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) ileri tarihli Ã¶deme emri rÄ±zasÄ± sÃ¼recini baÅlatÄ±r. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 7.2.\tADIM 1 - Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil : Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (ileriTarihliOdemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ olduÄu geÃ§it tarafÄ±ndan kontrol edilir. \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahipliÄi geÃ§it tarafÄ±ndan kontrol edilir. \n HHS tarafÄ±ndan, istek baÅlÄ±ÄÄ±ndaki x-aspsp-code ile katilimciBlg iÃ§erisinde yer alan hhsKod deÄeri ile aynÄ± olduÄunu kontrol edilir. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, ileri tarihli Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren ileriTarihliOdemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /ileri-tarihli-odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir IleriTarihliOdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, ileri tarihli Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS'ler ileri tarihli Ã¶deme emri hizmetini sunuÅ bilgilerini HHS API aracÄ±lÄ±ÄÄ± ile yayÄ±nlayacaklardÄ±r. YÃS, ileri tarihli Ã¶deme hizmeti baÅlatabileceÄi HHS'lerin listesini HHS API'de yer alan \"hizmetTipi\":\"02\" parametresi ile alabilir. YÃS, ileri tarihli Ã¶deme hizmeti sunmayan HHS'ye ileri tarihli bir Ã¶deme emri rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.ScheduledPaymentNotSupported  hatasÄ±

16iletilmelidir. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hata kodu iletilmeli ve fieldErrors dolu olacak Åekilde hatalÄ± alanÄ± belirten detaylÄ± aÃ§Ä±klama gÃ¶nderilmelidir. InvalidFormat hata kodlarÄ±nda fieldErrors iÃ§eriÄi gÃ¶nderilmeli ve anlaÅÄ±lÄ±r aÃ§Ä±klama ile message, messageTr alanlarÄ± doldurulmasÄ± zorunludur. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, bireysel mÃ¼Återi Ã¶zelinde ileri tarihli Ã¶deme hizmetini kendi kanallarÄ±nda sunmuyor ise HHS'ye ileri tarihli bir Ã¶deme emri rÄ±zasÄ± isteÄi yapmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.IndividualCustomerNotSupported\"  hatasÄ± ,\nkurumsal mÃ¼Återi Ã¶zelinde ileri tarihli Ã¶deme emri rÄ±zasÄ± isteÄi yapÄ±ldÄ±ÄÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CorporateCustomerNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme adresleri ile ileri tarihli Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.TPPRedirectionAddressMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; kimlik bilgileri nesnesinde yer alan kimlik bilgisi ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r.  (KoÅullu Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.CustomerNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n âAÃ§Ä±k BankacÄ±lÄ±k Kanal Yetkiâ tanÄ±mÄ± yok ise  \"TR.OHVPS.Business.OpenBankingChannelClosed\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n Ä°leri tarihli Ã¶deme emri rÄ±zasÄ±nda alÄ±cÄ± hesap bilgileri Karekod ya da Kolas ile belirlenebilir. HHS online kanallarÄ±nda ileri tarihli Ã¶deme hizmetini Karekod ve Kolas aracÄ±lÄ±ÄÄ± ile kabul ediyorsa, ÃHVPS servisleri ile de kabul etmek zorundadÄ±r. YÃS tarafÄ±ndan ileri tarihli Ã¶deme emri rÄ±zasÄ± isteÄi iÃ§erisinde alÄ±cÄ± bilgisi iÃ§in karekod ya da kolas kompleks alanlarÄ± yer almasÄ± durumunda , destek vermeyen HHS'ler tarafÄ±ndan  TR.OHVPS.Business.RecipientAccountTypeNotSupported  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir. \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.DecoupledAuthenticationNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  \"TR.OHVPS.Business.EventSubscriptionNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin, ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerInfoMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerMobileApplicationNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n HHS kimlik bilgisi ile gÃ¶nderen Ã¼nvanÄ±nÄ±n uyumlu olduÄunu kontrol eder. HHS'ler EFT/FAST iÅlemlerinde kabul ettikleri kontrol kriterleri ile iÅleme izin verebilirler. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.IncorrectSenderTitle\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n GÃ¶nderen Hesap NumarasÄ± ÃBHS tarafÄ±ndan iletildiÄi durumda;\n \n IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.InvalidAccount\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountCodeMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu kontrol edilir.Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.CustomerAccountMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. (Ä°lgili hesabÄ±n para transfer iÅlemine yetkisi olmamasÄ±) Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountUnauthorized\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâde gÃ¶nderen hesabÄ±n aktifliÄi kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountInactive\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n GÃ¶nderen Hesap NumarasÄ± iÃ§in, He

16sap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile ileri tarihli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  \"TR.OHVPS.Business.ActiveConsentNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Talimat tarihi, talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±, maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. Belirtilen tarih aralÄ±ÄÄ± dÄ±ÅÄ±nda ÃBHS tarafÄ±ndan talimat tarihi iletilmesi durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.InvalidOrderDateRange\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Talimati tarih bilgisi iÃ§in Ã¶deme gÃ¼nÃ¼nÃ¼n iÅ gÃ¼nÃ¼ne gelmediÄi ve HHS'nin FAST/Havale ile anlÄ±k Ã¶deme baÅlatamadÄ±ÄÄ± durumda,  HHS tarafÄ±dan  \"TR.OHVPS.Business.OrderDateNotWorkDay\"  hata mesajÄ± ile iÅlemi kesmelidir. YÃS, ÃHK'ya tarih bilgisini gÃ¼ncelletebilir ya da kendisi otomatik atama yapabilir. SonrasÄ±nda tekrar rÄ±za talebinde bulunmalÄ±dÄ±r. \n AlÄ±cÄ± ve gÃ¶nderen hesabÄ±n aynÄ± olmasÄ± durumunda  âTR.OHVPS.Business.SenderRecipientSameâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n MÃ¼Återinin kendi hesaplarÄ± arasÄ±nda talimat veremeyeceÄi durumlarÄ±n kontrolÃ¼ iÃ§in  âTR.OHVPS.Business.SameAccountTransferRestrictedâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, Ã¶deme iÃ§in benzersiz âRizaNoâ ile âIleriTarihliOdemeEmriRizasiâ nesnesi oluÅturur ve ÃBHSâye dÃ¶ner. \n HHS, IleriTarihliOdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n Hesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK ileri tarihli Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n  BAÅARILI Ä°STEK: \n Tablo : âIleriTarihliOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan ileri tarihli Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  Durum kodu(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.ohkTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir para birimi olduÄu kontrol eder. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda ileri tarihli Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile ileri tarihli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, HspRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n Ã¼nvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n TalimatÄ±n gerÃ§ekleÅeceÄi ana kadar KOLAS tanÄ±mÄ±nÄ±nda deÄiÅiklik olabileceÄi iÃ§in,  KOLAS ile yapÄ±lan ileri tarihli iÅlemler, talimatÄ±n verildiÄi anda Ã§Ã¶zÃ¼len IBAN'a yapÄ±lacaktÄ±r. \n Kolas ile ileri tarihli Ã¶deme emri hizmeti desteklenmiyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir. \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n Karekod ile yapÄ±lan ileri tarihli iÅlemler, talimatÄ±n verildiÄi anda Ã§Ã¶zÃ¼len IBAN'a yapÄ±lacaktÄ±r. \n Karekod ile ileri tarihli Ã¶deme emri hizmeti desteklenmiyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir. \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n HHS, YÃS'Ã¼n API deseninde \"O\" kodunu ilettiÄini kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarÄ±nda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.   -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tÄ°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n YÃS bu deÄeri ÃHKâyÄ± HHSâye yÃ¶nlendirmeden Ã¶nceki ekranda gÃ¶stermeli, ve HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak yine ÃHKâya gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n \n >> Talimat Tarihi \n tlmtTrh \n ISODate \n Z \n ÃHK tarafÄ±ndan talep edilen, Ã¶deme gerÃ§ekleÅme zamanÄ±dÄ±r. \n Talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±,maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âIleriTarihliOdemeEmriRizasiâ nesnesi Tabloâda parametrelerden oluÅur: \n Tablo : âIleriTarihliOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n >

16 RÄ±za No \n rizaNo \n AN1..128 \n Z \n IleriTarihliOdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n IleriTarihliOdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n IleriTarihliOdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n Z \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.   Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen Ã¼nvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.    Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Talimat Tarihi \n tlmtTrh \n ISODate \n Z \n ÃHK tarafÄ±ndan talep edilen, Ã¶deme gerÃ§ekleÅme zamanÄ±dÄ±r. Talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±,maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. Belirtilen tarih aralÄ±ÄÄ± dÄ±ÅÄ±nda ÃBHS tarafÄ±ndan talimat tarihi iletilmesi durumunda HHS tarafÄ±ndan  TR.OHVPS.Business.InvalidOrderDateRange  hatasÄ± verilmelidir. \n 7.3.\tADIM 2- Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil : Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n ileri tarihli Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=I&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS, ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=I&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak

16iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=I&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n ileri tarihli Ã¶deme emri rÄ±zasÄ±nÄ± baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK, bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS, ileri tarihli Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 7.4.\tADIM 2.1 â Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âIleriTarihliOdemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda ileri tarihli Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle,  IleriTarihliOdemeEmriRizasi  nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -Ileri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  IleriTarihliOdemeEmriRizasi  nesnesine iÅler. \n \n Sorgulama yapÄ±lan Ä°leri Tarihli Ãdeme Emri HHS tarafÄ±nda bulunmuyor ise  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n GET /ileri-tarihli-odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  IleriTarihliOdemeEmriRizasi  kaynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n Durum \n IleriTarihliOdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n Ä°leri Tarihli Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /ileri-tarihli-odeme-emri-rizasi/{rizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âIleriTarihliOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âIleriTarihliOdemeEmriRizasiâ nesnesi oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âIleriTarihliOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /ileri-tarihli-odeme-emri-rizasi/{rizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âIleriTarihliOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n 7.5.\tADIM 3- Ä°leri Tarihli Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Ä°leri Tarihli Ãdeme Emrinin OluÅturulmasÄ± \n POST /ileri-tarihli-odeme-emri \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS OdemeEmri kaynaÄÄ±nÄ± oluÅturur. \n Ä°leri Tarihli Ãdeme emri (IleriTarihliOdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r. \n \n EriÅim Belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir EriÅim Belirteci yok ise  \"TR.OHVPS.Connection.InvalidToken\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini y

16apar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor, Y: Yetkilendirildi  ya da E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n POST /ileri-tarihli-odeme-emri-rizasi ile POST /ileri-tarihli-odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r. Ä°leri Tarihli Ãdeme Emri rÄ±zasÄ±nda gÃ¶nderilen deÄerlerden farklÄ± bir deÄer gÃ¶nderildiÄi durumda  âTR.OHVPS.Business.FieldMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra, iÃ§erisinde odmEmriNo ve odmDrm deÄiÅkenleri de bulunan IleriTarihliOdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine/Talimata DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n \n POST verisindeki GÃ¶nderen Hesap NumarasÄ± ve AlÄ±cÄ± Hesap NumarasÄ±nÄ±n aynÄ± bankaya aitse HAVALE deÄilse FAST veya PÃS iÅ akÄ±ÅÄ±na geÃ§ilir. \n \n BAÅARILI Ä°STEK: \n Tablo 9: âIleriTarihliOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan ileri tarihli Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n >YÃ¶nlendirme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n >AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur. yetYntm = Y iÃ§in bu nesne iletilmemelidir. \n \n \n \n >>OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >>OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n \n \n >Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde,

161. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± ileri tarihli Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Ä°Ålem TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS iÅlem tutarÄ± Ã¶deme mesajÄ±nda (Havale/FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n Ttr \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda ileri tarihli Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi ileri tarihli Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n KolasRef ( hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n Ä°leri Tarihli Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. \n RefBlg (Hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n FAST/PÃS Acklm \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n \n \n >> Talimat Tarihi \n tlmtTrh \n ISODate \n Z \n ÃHK tarafÄ±ndan talep edilen, Ã¶deme gerÃ§ekleÅme zamanÄ±dÄ±r. Talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±,maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. \n \n \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âIleriTarihliOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âIleriTarihliOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n Z \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Emir Bilgileri \n emrBlg \n Kompleks: EmirBilgileri \n Z \n \n \n \n >

16 Ãdeme Emri NumarasÄ± \n odmEmriNo \n AN1..128 \n Z \n IleriTarihliOdemeEmri nesnesinin UID'sidir. IleriTarihliOdemeEmri Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Ãdeme Emri Zaman \n odmEmriZmn \n ISODateTime \n Z \n IleriTarihliOdemeEmri nesnesinin oluÅturulduÄu zaman bilgisi. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GerÃ§ekleÅen Ä°Ålem TutarÄ± \n grckIslTtr \n Kompleks:GerceklesenTutar \n K \n odmDrm:01 ,02 ve 06 olduÄu durumda gÃ¶nderilmesi zorunludur. Ãdeme durumu 01 ve 02 durumlarÄ±nda gerÃ§ekleÅtirilen tutarÄ±n tamamÄ± bu alanda iletilmelidir. Ãdeme durumu: 06 olan kÄ±smi Ã¶deme iÅlemlerinde ise gerÃ§ekleÅen tutar bilgisi iletilmelidir. \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n Talimat gerÃ§ekleÅtiÄinde Ã¶deme yapÄ±lan tutar bilgisi.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.  Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>>

16 Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ  deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme Durumu \n odmDrm \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r.      Ãdeme Durumu alanÄ± ile ilgili olarak HHSâler tarafÄ±ndan YÃSâlere  IleriTarihliOdemeEmri servisi yanÄ±tÄ±nda  04:Onayda Bekliyor, 05:Ãdeme Bekleniyor yanÄ±tlarÄ± gÃ¶nderilebilir. 04:Onayda Bekliyor  ve  05:Ãdeme Bekleniyor  durumlarÄ± oluÅtuktan sonra YÃS tarafÄ±ndan ileri tarihli Ã¶deme emri sorgulamasÄ± yapÄ±larak Ã¶deme durumunun gÃ¼ncel deÄeri Ã¶Ärenilir. GÃ¼ncel deÄerler  01:GerÃ§ekleÅti,03:GerÃ§ekleÅmedi , 06:KÄ±smen GerÃ§ekleÅti  ve  07:Ä°ptal Edildi  durumlarÄ± olabilir. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n K \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. odmDrm:01, 02 ve 06 olduÄu durumda gÃ¶nderilmesi zorunludur. \n \n \n >> Ãdeme Sistem NumarasÄ± \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. Havale/FAST/PÃS  Ã¶deme yÃ¶ntemleri iÃ§in tarih alanÄ± yyyy-aa-gg formatÄ±nda 10 karakter olarak

16iletilmelidir. odmDrm:01, 02 ve 06 olduÄu durumda gÃ¶nderilmesi zorunludur. \n \n \n >> Talimat Tarihi \n tlmtTrh \n ISODate \n Z \n ÃHK tarafÄ±ndan talep edilen, Ã¶deme gerÃ§ekleÅme zamanÄ±dÄ±r. Talimat verilen gÃ¼nÃ¼n tarihinden minimum 1 gÃ¼n sonrasÄ±,maksimum ise 1 yÄ±l sonrasÄ± olacak Åekilde seÃ§ilebilir. \n \n \n >> GerÃ§ekleÅen Ãdeme ZamanÄ± \n grckOdmZmn \n ISODateTime \n K \n GerÃ§ekleÅen Ã¶deme iÅlemine ait zaman bilgisi. odmDrm:01, 02 ve 06 olduÄu durumda gÃ¶nderilmesi zorunludur. \n 7.6.\tADIM 3.1- Ä°leri Tarihli Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Ä°leri Tarihli Ãdeme Emri Sorgusu \n GET /ileri-tarihli-odeme-emri/{odmEmriNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla ileri tarihli Ã¶deme emrini sorgulayabilir. Maksimum Ã¶demenin gerÃ§ekleÅeceÄi gÃ¼nÃ¼n 15 gÃ¼n sonrasÄ±na kadar sorgulama yapÄ±labilir. SonrasÄ±nda yapÄ±lacak sorgulamalarda eriÅim belirtecinin yetki sÃ¼resi sonlandÄ±ÄÄ± iÃ§in HHS  \"TR.OHVPS.Resource.ConsentRevoked\" Â hatasÄ±nÄ± dÃ¶nmelidir.\nÄ°ptal edilmiÅ talimatÄ±n bilgileri sorgulanmak istendiÄinde de yine  \"TR.OHVPS.Resource.ConsentRevoked\" Â hatasÄ± verilmelidir. \n YÃS sadece kendi uygulamasÄ± Ã¼zerinden verilmiÅ ileri tarihli Ã¶demeleri sorgulayabilir. EriÅim izni olmayan bir Ã¶deme emri numarasÄ± ile sorgulama yaptÄ±ÄÄ±nda HHS'den  \"TR.OHVPS.Resource.NotFound\"  hatasÄ±nÄ± alÄ±r. \n KÄ±smi Ã¶demelerde, kÄ±smen gerÃ§ekleÅen Ã¶deme tutarÄ±, \"gerÃ§ekleÅen iÅlem tutarÄ±\"(grckIslTtr) alanÄ±nda gÃ¶nderilirken, gÃ¶nderilmesi talep edilen tutar alanÄ±(rÄ±za baÅlatma isteÄinde ki tutar) da \"iÅlem tutarÄ±\"(islTtr) alanÄ±nda gÃ¶nderilmeye devam edilmelidir. \n GerÃ§ekleÅen iÅlem tutarÄ± ve para birimi, Ã¶deme gerÃ§ekleÅme zamanÄ± alanlarÄ±, Ã¶deme gÃ¼nÃ¼nden itibaren dolu olarak gelir. \n BAÅARILI YANIT: \n GET /ileri-tarihli-odeme-emri/{odmEmriNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âIleriTarihliOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âIleriTarihliOdemeEmriâ nesnesi dÃ¶ner. \n 7.7.\tADIM 4- Ä°leri Tarihli Ãdeme Emri RÄ±za Ä°ptali \n \n Åekil 10: Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± Ä°ptali \n DELETE /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla ileri tarihli Ã¶deme emri rÄ±zasÄ±nÄ± iptal edebilir. \n DELETE /ileri-tarihli-odeme-emri-rizasi Ã§aÄrÄ±sÄ±, bir ÃBHS'nin Ã¶nceden oluÅturulmuÅ bir ileri tarihli Ã¶deme emri rÄ±zasÄ±nÄ± silmesine izin verir. MÃ¼Återi, rÄ±zasÄ±nÄ± HHS Ã¼zerinden iptal etmek yerine, ÃBHS Ã¼zerinden bu rÄ±zasÄ±nÄ± kaldÄ±rmak isteyebilir. \n \n EriÅim belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir eriÅim belirteci yok ise HHS tarafÄ±ndan  âTR.OHVPS.Connection.InvalidTokenâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±za, silinen rizaNo bilgisi ile aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°ptal edilmek istenen Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± HHS tarafÄ±nda bulunmuyor ise  âTR.OHVPS.ResourceNotFoundâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S veya Yetki Ä°ptal - I ise  \"TR.OHVPS.Resource.ConsentRevoked\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ä°ptal edilmek istenen Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ±ânÄ±n Ã¶deme durumu 04 ya da 05 deÄil ise  âTR.OHVPS.Business.TransactionCompletedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±da kontroller baÅarÄ±yla tamamlandÄ±ktan sonra sÄ±rasÄ±yla aÅaÄÄ±daki iÅlemler yapÄ±lÄ±r. \n \n odmDrm deÄeri 04 ve 05 olan kayÄ±tlar 07 durum kodu ile gÃ¼ncellenmelidir. \n Ä°liÅkili ileri tarihli Ã¶deme emri talimatÄ± iptal edilmelidir. \n RÄ±za iptal edilmelidir. \n \n Bu API Ã§aÄrÄ±sÄ±, mÃ¼Återinin ÃBHS Ã¼zerinden ileri tarihli Ã¶deme emri rÄ±zasÄ±nÄ± iptal etmesine ve HHS nezdindeki ileri tarihli Ã¶deme emri rÄ±zasÄ± nesnesinin silinmesini saÄlar.\nMÃ¼Återinin ÃBHSânin veri eriÅim iznini iptal etmesi durumunda ÃBHS, HHSâde mevcut olan IleriTarihliOdemeEmriRizasi'na dair rÄ±za ve talimat bilgilerini pratik olarak mÃ¼mkÃ¼n olan en kÄ±sa sÃ¼rede silmelidir. Bu ise, ilgili kaynaÄa\nDELETE /ileri-tarihli-odeme-emri-rizasi/{RizaNo}

16\nÃ§aÄrÄ±sÄ± aracÄ±lÄ±ÄÄ± ile yerine getirilir. \n Servis istek parametresi olarak sadece pathâde iletilen RÄ±za No bilgisine ihtiyaÃ§ duymaktadÄ±r.\nÃHK rÄ±zasÄ± YÃS Ã¼zerinden baÅarÄ± ile silindiÄinde HTTP 204 response kodu ile iÅlem sonucu iletilir. RÄ±za tipi âIâ yani âYetki Ä°ptalâ ve durum kodu \"03\" olarak gÃ¼ncellenir ve gnclZmn zaman damgasÄ± vurularak gÃ¼ncellenir.\nÃHK ile rÄ±za iptali sÄ±rasÄ±nda kurulacak iletiÅimde (e-posta, sms gibi) aÅaÄÄ±daki alanlarÄ±n iletilmesi tavsiye edilmektedir:\nYÃS AdÄ±, HHS adÄ±, RÄ±za OluÅturma ZamanÄ±, Servis Tipi Bilgisi (ÃBHS) \n"},{title:"4. RÄ±za DurumlarÄ±",frontmatter:{},regularPath:"/v2.0.1/contents/riza-durumlari.html",relativePath:"v2.0.1/contents/riza-durumlari.md",key:"v-4c8f674f",path:"/v2.0.1/contents/riza-durumlari.html",headers:[{level:2,title:"4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri",slug:"_4-1-hesap-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"},{level:2,title:"4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri",slug:"_4-2-odeme-bilgisi-hizmeti-rÄ±za-durum-degisiklikleri"}],content:" 4. RÄ±za DurumlarÄ± \n ÃHK, Ãdeme Emri BaÅlatma Hizmetine ya da Hesap Bilgisi Hizmetine mÃ¼Återi rÄ±zasÄ±nÄ±n tesisi ile baÅlar. ÃHKânÄ±n YÃS uygulamasÄ± Ã¼zerinden yaptÄ±ÄÄ± iÅlemler neticesinde rÄ±za durumlarÄ± deÄiÅebilir.\nRÄ±zaânÄ±n alabileceÄi durum kodlarÄ± Åu Åekilde belirlenmiÅtir. \n B: Yetki Bekleniyor  â Ä°lk rÄ±za talebinde \n Y: Yetkilendirildi  â BaÅarÄ±lÄ± GKD sonrasÄ± yetKod Ã¼retildiÄinde \n K: Yetki KullanÄ±ldÄ±  â EriÅim Belirteci alÄ±ndÄ±ÄÄ±nda \n E: Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼  â ÃBHS iÃ§in \n S: Yetki SonlandÄ±rÄ±ldÄ± \nÂ Â Â Â HBHS iÃ§in : EriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde \nÂ Â Â Â ÃBHS iÃ§in : Yenileme belirteci Son Tarihi geldiÄinde \n I :Yetki Ä°ptal \nRÄ±za iptal durumu ise gerek raporlama gerekse mÃ¼Återi deneyimi perspektifinden doÄru   bilgilendirmeler yapÄ±labilmesi aÃ§Ä±sÄ±ndan aÅaÄÄ±daki gibi detay kodlarÄ± ile zenginleÅtirilmiÅtir: \n \n RÄ±za Ä°ptal Detay Kodu: \n \n \n \n â01â :\tYeni RÄ±za Talebi ile Ä°ptal \n â02â :\tKullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal \n â03â :\tKullanÄ±cÄ± Ä°steÄi ile YÃS Ã¼zerinden Ä°ptal \n â04â :\tSÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor \n â05â :\tSÃ¼re AÅÄ±mÄ± : Yetkilendirildi \n â06â :\tSÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi \n â07â :\tGKD iptali : AynÄ± rÄ±za no ile mÃ¼kerrer Ã§aÄrÄ±mÄ± \n â08â :\tGKD iptali : RÄ±zano ile kimlik bilgileri uyuÅmamasÄ± \n â09â :\tGKD iptali : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor \n â10â :\tGKD iptali : HHS AÃ§Ä±k BankacÄ±lÄ±k kanalÄ± iÅleme kapalÄ± \n â11â :\tGKD iptali : Hesap Yetki Sorunu \n â12â :\tGKD iptali : ÃHK HHS kontrollerini aÅamadÄ± \n â13â :\tGKD iptali : ÃHK isteÄi ile GKDâden vazgeÃ§ildi \n â14â :\tGKD iptali : Fraud ÅÃ¼phesi \n â15â :\tHesap RÄ±za GÃ¼ncelleme Talebi ile Ä°ptal \n â99â :\tGKD iptali : DiÄer \n \n \n 4.1 ve 4.2 bÃ¶lÃ¼mlerinde detaylandÄ±rÄ±lan rÄ±za durum deÄiÅikliklerinde rÄ±za iptal detay kodlarÄ± kullanÄ±lmÄ±ÅtÄ±r. \n ÃrneÄin Bâ¨ I/01 denildiÄinde âYetki Bekleniyorâ rÄ±za durumundan âYetki Ä°ptalâ rÄ±za durumuna RÄ±za Ä°ptal Detay Kodu da â01â yani âYeni RÄ±za Talebi ile Ä°ptalâ olarak gÃ¼ncellenmelidir ifade edilmiÅtir. \n ÃHK verdiÄi rÄ±za sÄ±rasÄ±nda seÃ§tiÄi hesaplarÄ±ndan/kartlarÄ±ndan biri kapatÄ±lÄ±rsa, diÄer hesaplara/kartlara ait bilgileri gÃ¶rmeye devam eder. Ancak ÃHKânÄ±n hesabÄ±na/kartÄ±na ait bilgilerinin YÃS'e iletilmesini istemediÄi durumda, rÄ±zasÄ±nÄ± tamamen iptal ederek yeni hesap/kart listesi ile yeni rÄ±za vermesi gerekmektedir. Yani hesap/kart kapanmasÄ± nedeniyle rÄ±za geÃ§erliliÄini yitirmez. ÃHK'nÄ±n proaktif olarak bu hesabÄ±/kartÄ± rÄ±zadan Ã§Ä±karmasÄ± durumunda rÄ±za iptali olur. \n RÄ±za iptal edilmediÄi ve geÃ§erli olduÄu sÃ¼rece kapalÄ± hesaplar/kartlar iÃ§in diÄer Ã§evrimiÃ§i kanallarda uygulanan yÃ¶ntem izlenmelidir. DiÄer Ã§evrimiÃ§i kanallarda kapalÄ± hesaplara/kartlara iliÅkin bilgi dÃ¶nÃ¼lmÃ¼yor ise ÃHVPS'den de dÃ¶nÃ¼Å yapÄ±lmaz. ÃHKânÄ±n rÄ±za onayÄ± verdiÄi aÃ§Ä±k hesaplarÄ±nÄ±n/kartlarÄ±nÄ±n tÃ¼mÃ¼ HHS tarafÄ±nda kapatÄ±ldÄ±ÄÄ± durumda, yine aynÄ± Åekilde HHS Ã§evrimiÃ§i kanallarÄ±nda koyduÄu kurallara gÃ¶re bu hesaplarÄ±nÄ±n/kartlarÄ±nÄ±n YÃS uygulamasÄ±nda gÃ¶sterilmesine karar verir. \n Hesap/kart kapama ve ticari kullanÄ±cÄ±larÄ±n hesaplar/kartlar Ã¼zerindeki yetki deÄiÅiklikleri HHS'nin iÃ§ sistemleri tarafÄ±ndan yapÄ±lan kontrollerle yÃ¶netilir. Buradaki deÄiÅiklikler ile HHS sistemsel olarak rÄ±za iptali gerÃ§ekleÅtiremez. ÃHK izni ve onayÄ± dahilinde rÄ±za iptal gerÃ§ekleÅtirilmesi gerekmektedir. \n HHS'ler sunmuÅ olduklarÄ± RÄ±za Ä°ptal ekranÄ±nÄ± (sadece Hesap Bilgisi RÄ±zasÄ± iÃ§in), hangi ortamlardan GKD yapÄ±lmasÄ±na izin veriliyorsa (web/mobil) aynÄ± ortamdan ÃHK'ya sunmalÄ±dÄ±r.  ÃrneÄin bir HHS bireysel mÃ¼Återileri iÃ§in web ve mobil, kurumsal mÃ¼Återiler iÃ§in web Ã¼zerinden GKD imkanÄ± sunuyor ise, minimumda bireysel mÃ¼Återiler iÃ§in web ve mobil ortamlarÄ±ndan, kurumsal mÃ¼Återiler iÃ§in web ortamÄ±ndan RÄ±za Ä°ptal ekranÄ± aracÄ±lÄ±ÄÄ± ile rÄ±za iptaline izin vermelidir. Bunun dÄ±ÅÄ±nda Ã§aÄrÄ± merkezi ya da Åube gibi ortamlardan sunacaÄÄ± RÄ±za Ä°ptal imkanÄ± HHS inisiyatifindedir. Bahsi geÃ§en zorunluluk Ãdeme Emri RÄ±za Ä°ptal ekranÄ± iÃ§in geÃ§erli deÄildir. \n Benzer Åekilde YÃS'ler hangi ortamlardan (web/mobil) hizmet veriyorsa, aynÄ± ortam Ã¼zerinden RÄ±za Ä°ptal ekranÄ±nÄ± sunmalÄ±dÄ±r. \n 4.1.\tHesap Bilgisi Hizmeti RÄ±za durum deÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n, bir YÃS iÃ§in, bir HHS'de aktif tek bir rÄ±zasÄ± olabilir.\nBir ÃHK hem kiÅisel olarak hem de bir kurumun kullanÄ±cÄ±sÄ± olabilir. Bu durumda kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \nAynÄ± kural YÃSâÃ¼n hizmet verdiÄi Temsilcisi iÃ§in de geÃ§erlidir. ÃrneÄin: \n Bir mÃ¼Återinin bir Hesap Hizmet SaÄlayÄ±cÄ±sÄ± (HHS) nezdinde, aynÄ± Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ± (YÃS) veya onun temsilcisi Ã¼zerinden yalnÄ±zca bir adet aktif hesap bilgisi rÄ±zasÄ± bulunabilir.\nBu sistematiÄin temel kurallarÄ± ve uygulanmasÄ± Åu Åekildedir: \n \n Ãoklu Temsilci KÄ±sÄ±tÄ±: Bir YÃS, birden fazla temsilci aracÄ±lÄ±ÄÄ±yla hizmet verse dahi bu kural geÃ§erlidir. MÃ¼Återi, ilg

16ili YÃS'Ã¼n herhangi bir temsilcisi Ã¼zerinden zaten bir HHS'de rÄ±za vermiÅse, aynÄ± YÃS'Ã¼n bir baÅka temsilcisi Ã¼zerinden yeni bir rÄ±za veremez. \n DoÄrulama ve DoÄrudan Engelleme: HHS, bir mÃ¼Återi iÃ§in ilgili YÃS'e ait zaten aktif bir rÄ±za olup olmadÄ±ÄÄ±nÄ± kontrol eder. EÄer temsilcilerden biri Ã¼zerinden mevcut bir rÄ±za varsa, aynÄ± mÃ¼Återi baÅka bir temsilci Ã¼zerinden mÃ¼kerrer rÄ±za oluÅturmaya Ã§alÄ±ÅtÄ±ÄÄ±nda iÅlem sistem tarafÄ±ndan reddedilmeli ve hata mesajÄ± dÃ¶ndÃ¼rÃ¼lmelidir. AynÄ± durum YÃSâÃ¼n kendisi iÃ§in de geÃ§erlidir. HHS, bir mÃ¼Återi iÃ§in ilgili YÃS'e ait zaten aktif bir rÄ±za olup olmadÄ±ÄÄ±nÄ± kontrol eder. EÄer temsilcilerden biri Ã¼zerinden mevcut bir rÄ±za varsa, aynÄ± mÃ¼Återi YÃSâÃ¼n kendisi iÃ§in mÃ¼kerrer rÄ±za oluÅturmaya Ã§alÄ±ÅtÄ±ÄÄ±nda iÅlem sistem tarafÄ±ndan reddedilmeli ve hata mesajÄ± dÃ¶ndÃ¼rÃ¼lmelidir. \n \n Temsilci kendi ad ve hesabÄ±na mÃ¼Återi edinemez. MÃ¼Återinin, YÃSâÃ¼n mÃ¼Återisi olmasÄ± gerekmektedir.\nEÄer temsilci kendi sunduÄu baÅka hizmetler kapsamÄ±ndaki mÃ¼Återilerini aÃ§Ä±k bankacÄ±lÄ±k (f ve g) hizmetlerinden yararlandÄ±rmak istiyorsa, sÃ¶z konusu aÃ§Ä±k bankacÄ±lÄ±k hizmetlerinden yararlanmak isteyen mÃ¼Återilerinin YÃSâÃ¼n de mÃ¼Återisi olmalarÄ±nÄ± saÄlamasÄ± gerekmektedir. \n \n \n Hesap Bilgisi RÄ±zasÄ± isteÄi HHSâye iletilir. \na.\tHHS ÃHK'ya ait iÃ§eride rÄ±za var mÄ± kontrol eder. EÄer yoksa  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \nb.\tEÄer iÃ§eride rÄ±za varsa ; \n \n Yeni hesap bilgisi rÄ±zasÄ± talebi baÅlatÄ±lmÄ±Åsa (oncekiRizaNo alanÄ±nÄ±n hiÃ§ gÃ¶nderilmediÄi durum):  \ni. RÄ±za durumu Yetki Bekleniyor - B ise; \nÂ Â Â Â     HHS, sistemde Yetki Bekleniyor - B rÄ±za durumuna sahip kayÄ±t olduÄu iÃ§in, Ã¶ncelikle eski kaydÄ± Yetki Ä°ptal - I durumuna getirir.  RÄ±za Ä°ptal Detay Kodu âYeni RÄ±za Talebi ile iptalâ olmalÄ±dÄ±r.  B â¨ I / 01  SonrasÄ±nda,  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za oluÅturur. \n \n Â Â Â Â  ii. RÄ±za durumu Yetkilendirildi - Y veya Yetki KullanÄ±ldÄ± - K ise; \nÂ Â Â Â ÃHK'nÄ±n halihazÄ±rda verilmiÅ bir rÄ±zasÄ± vardÄ±r. HHS, Ã¶nce mevcut rÄ±zanÄ±n iptalinin yapÄ±lmasÄ± gerektiÄine dair   TR.OHVPS.Business.ConsentAlreadyExists  hatasÄ±nÄ± dÃ¶ner. YÃS, HHS ya da YÃS uygulamasÄ± Ã¼zerinden bu rÄ±zanÄ±n iptal edilmesi gerektiÄine dair ÃHK'ya bilgilendirme yapar. \n Â Â Â Â  iii.\tRÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise Yetki Bekleniyor - B durumunda yeni rÄ±za no oluÅturur. \n Â Â Â Â  iv.\tRÄ±za durumu Yetki Ä°ptal - I ise  Yetki Bekleniyor - B  durumunda yeni rÄ±za no oluÅturur. \n \n \n BaÅlatÄ±lan rÄ±za isteÄi gÃ¼ncelleme akÄ±ÅÄ± ile baÅlatÄ±lmasÄ± durumunda oncekiRizaNo deÄeri rÄ±za isteÄinde bulunan ÃHKâya ait olmalÄ±dÄ±r. ÃHKâya ait olmamasÄ± durumunda  TR.OHVPS.Business.CustomerNotFound  hatasÄ± dÃ¶nÃ¼lÃ¼r. AynÄ± ÃHK olmasÄ± durumunda ; \n i. Ãnceki RÄ±za durumu B: Yetki Bekleniyor , Y: Yetkilendirildi ya da I :Yetki Ä°ptal  ise;  TR.OHVPS.Business.ConsentStatusNotforUpdate  hatasÄ± verilecektir. \n ii. Yetki KullanÄ±ldÄ± - K ise; hesap rÄ±zasÄ± baÅarÄ±lÄ± gerÃ§ekleÅtiriliyor olup Yetki Bekleniyor - B durumunda yeni bir rÄ±za oluÅturulur. Ãnceki hesap bilgisi rÄ±zasÄ± durumunda bir gÃ¼ncelleme yapÄ±lmaz. \n iii. Yetki SonlandÄ±rÄ±ldÄ± - S ise; RÄ±za GÃ¼ncelleme ZamanÄ± kontrol edilir. \n â¢\tSonlandÄ±rÄ±ldÄ± statÃ¼sÃ¼ne geÃ§mesiyle birlikte rÄ±za gÃ¼ncelleme zamanÄ± Ã¼zerinden 30 gÃ¼n geÃ§miÅ ise  TR.OHVPS.Business.ConsentStatusNotforUpdate  hatasÄ± verilir. \nâ¢\t30 gÃ¼n geÃ§memiÅ ise; hesap rÄ±zasÄ± baÅarÄ±lÄ± gerÃ§ekleÅtiriliyor olup Yetki Bekleniyor - B durumunda yeni bir rÄ±za oluÅturulur. Ãnceki hesap bilgisi rÄ±zasÄ± durumunda bir gÃ¼ncelleme yapÄ±lmaz. \n \n \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda RÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.  B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: TarayÄ±cÄ±yÄ± kapatmÄ±Å olabilir) RÄ±za Yetki Bekleniyor - B rÄ±za durumunda kalÄ±r.  5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B rÄ±za durumundaki kayÄ±tlar Yetki Ä°ptal  : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir.   B â¨ I / 04  Bkz. 9. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine  rizaIptDtyKod  deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda/kartlarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 12 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 13 \n \n \n Fraud ÅÃ¼phesi Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 99 \n \n \n \n \n \n \n EriÅim Belirteci API \n a. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda;

16 \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetki KullanÄ±ldÄ± - K  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n â¢  Hesap RÄ±zasÄ± GÃ¼ncelleme akÄ±ÅÄ± ile hesap bilgi rÄ±zasÄ± gÃ¼ncelleniyor ise yeni hesap bilgisi rÄ±zasÄ± K durumuna gÃ¼ncellendiÄinde Ã¶nceki rÄ±za no durumu I â 15 (Hesap RÄ±za GÃ¼ncelleme ile Ä°ptal) ile iptale Ã§ekilir. \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Sorgulama: HBHS, rÄ±za alma akÄ±ÅÄ±na baÅlamadan Ã¶nce, daha Ã¶nce oluÅturulmuÅ bir hesap bilgisi-rizasi kaynaÄÄ±nÄ±n durumunu, isteÄe baÄlÄ± olarak alabilir. RÄ±za numarasÄ± ile sorgulama yapÄ±lÄ±r. \n \n \n Hesap Bilgisi RÄ±zasÄ±nÄ±n Ä°ptali: HBHS Ã¼zerinden ya da HHS Ã¼zerinden yapÄ±lan rÄ±za iptallerinde RÄ±za durumu  Yetki Ä°ptal - I olarak gÃ¼ncellenir. RÄ±za numarasÄ± ile iptal saÄlanÄ±r. \n a. HHS Ã¼zerinden rÄ±za iptali yapmÄ±Å olabilir.  RÄ±za durumu sorgulanÄ±r. \n RÄ±za numarasÄ± Yetki Bekleniyor - B ve Yetkilendirildi - Y ve Yetki KullanÄ±ldÄ± - K durumlarÄ±nda ise Yetki Ä°ptal durumuna getirilir. RÄ±za gnclzmn timestamp ile gÃ¼ncellenir.\nHHS, RÄ±za iptalinde aynÄ± zamanda eriÅim belirtecini de invalid hale getirmelidir. \n B â¨ I / 02 \n Y â¨ I / 02 \n K â¨ I / 02 \n b.\tYÃS Ã¼zerinden yapÄ±lacak iptal iÅleminde yine Y ve B ve K rÄ±za durumlarÄ±nda ise iptal edilebilir. \n B â¨ I / 03 \n Y â¨ I / 03 \n K â¨ I / 03 \n RÄ±za durumu Yetki SonlandÄ±rÄ±ldÄ± - S  ise iptal gerÃ§ekleÅmez. âRÄ±za durumunuz iptal etmeye uygun deÄildir.â hatasÄ± ÃHK'ya yansÄ±tÄ±lÄ±r.  TR.OHVPS.Resource.ConsentRevoked \n \n \n ÃHKânÄ±n verdiÄi rÄ±za sÃ¼resi dolmuÅ olabilir.\nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde RÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ± durumuna Ã§ekilmelidir.   K â¨ S \n \n \n Hesaplar, Bakiye ve Ä°Ålemler servislerinde eriÅim belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.\nGeÃ§erli bir eriÅim belirteci yok ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n YÃS'Ã¼n; RÄ±za Ä°ptal - I ya da Yetki SonlandÄ±rÄ±ldÄ± - S rÄ±za durumlarÄ±nda Hesaplar, Bakiye ve Ä°Ålemler servislerini Ã§aÄÄ±rmamasÄ± beklenir. HHS'nin bu rÄ±za durumlarÄ± ile yapÄ±lmÄ±Å Ã§aÄrÄ±lar olduÄunda  TR.OHVPS.Resource.ConsentRevoked  hatasÄ±nÄ± dÃ¶nmesi gereklidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K dÄ±ÅÄ±nda ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± verilmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K ise servis akÄ±ÅlarÄ±na devam edilir. \n RÄ±za sorgulama API'sinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound hatasÄ±  verilmelidir. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir âYetki Bekleniyorâ durumunda kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor  â¨ RÄ±za Ä°ptal  / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir âYetkilendirildiâ durumunda kalan kayÄ±tlar gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ±: Yetkilendirildi  B â¨ I / 05 \nYukarÄ±da bahsedilen, YÃS SÃ¼re AÅÄ±mÄ± nedeniyle rÄ±za iptal durum gÃ¼ncellemelerini y

16apmadan Ã¶nce HHSâyi sorgulayarak rÄ±za durumunu Ã¶Ärenmeli ve sÃ¼re aÅÄ±mÄ± dÄ±ÅÄ±nda bir kodu varsa aynÄ± kodla kendi sistemini gÃ¼ncellemelidir. \nEriÅimin GeÃ§erli OlduÄu Son Tarih geldiÄinde rÄ±za durumu Yetki KullanÄ±ldÄ±âdan Yetki SonlandÄ±rÄ±ldÄ±âya gÃ¼ncellenir.  K â¨ S \n 4.2.\tÃdeme Bilgisi Hizmeti RÄ±za Durum DeÄiÅiklikleri \n Kural : Bir ÃHK'nÄ±n bir YÃS iÃ§in bir HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n Kurum ve kiÅisel rÄ±za aynÄ± anda mevcut olabilmelidir. RÄ±za nesneleri, HHS tarafÄ±ndan uygun Åekilde yÃ¶netilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ± isteÄi HHSâye iletilir. Ä°Ã§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n  Yetki Bekleniyor - B  rÄ±za durumu ile yeni rÄ±za no oluÅturur. \n \n \n GKD baÅarÄ±lÄ± bir Åekilde tamamlandÄ±ÄÄ±nda rÄ±za durumu Yetki Bekleniyorâdan Yetkilendirildiâye gÃ¼ncellenir.   B â¨ Y \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdar olmayabilir. \n ÃHK GKD yapmadan ayrÄ±lmÄ±Å olabilir. (ÃR: BrowserÄ± kapatmÄ±Å olabilir)\nRÄ±za durumu Yetki Bekleniyor'dur. 5 dakika iÃ§erisinde sistem tarafÄ±ndan Yetki Bekleniyor - B durumundaki kayÄ±tlar RÄ±za Ä°ptal : Yetki Bekleniyor SÃ¼re AÅÄ±mÄ± olarak gÃ¼ncellenir. Bkz. 8. Madde. \n \n \n GKD'nin gerÃ§ekleÅmediÄi durumlardan HHS haberdardÄ±r. HHS yonlendirme adresinin query parametrelerine rizaIptDtyKod deÄerini ekleyerek bu durumu YÃSâe bildirmek zorundadÄ±r. \n \n \n RÄ±za durumunun  âYetkilendirildi\" , âYetki KullanÄ±ldÄ±â olduÄu durum.  Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨  I / 07 \n \n \n RÄ±zano ile kimlik bilgileri uyuÅmazlÄ±ÄÄ±.  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 08 \n \n \n ÃHK'nÄ±n HHS'de ilgili Ã¼rÃ¼nÃ¼nÃ¼n olmadÄ±ÄÄ± durum (hesap/kart) Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 09 \n \n \n AÃ§Ä±k bankacÄ±lÄ±k kanalÄ±nÄ±z iÅleme kapalÄ±dÄ±r.Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 10 \n \n \n KullanÄ±cÄ±nÄ±n HHS'deki hesaplarÄ±nda yeterli yetkisinin olmama durumu  Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 11 \n \n \n HHSânin ÃHK iÃ§in yaptÄ±ÄÄ± kontrollerin baÅarÄ±sÄ±z olduÄu durum Yetki Bekleniyor â¨ Yetki Ä°ptal   B â¨ I / 12 \n \n \n ÃHK isteÄi ile GKDâden vazgeÃ§ildiÄi durum Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 13 \n \n \n Fraud ÅÃ¼phesi Yetki Bekleniyor â¨ Yetki Ä°ptal  B â¨ I / 14 \n \n \n DiÄer Yetki Bekleniyor â¨  Yetki Ä°ptal   B â¨  I / 99 \n \n \n \n \n \n \n GKD muafiyeti olduÄunda YÃS HHSâden arka planda onay alÄ±r. Bu onay sÄ±rasÄ±nda rÄ±za durumu  Yetkilendirildi  yapÄ±lÄ±r.  B â¨ Y \n \n \n EriÅim Belirteci API \na. EriÅim Belirteci'nin yetkilendirme kodu ile Ã§aÄrÄ±mÄ± yapÄ±ldÄ±ÄÄ±nda; \n Â Â Â Â  i. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise   TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Bekleniyor - B , Yetki KullanÄ±ldÄ± - K  ya da Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetkilendirildi - Y olduÄunda eriÅim belirteci tahsis edilir.\nEriÅim belirteci alÄ±ndÄ±ÄÄ±nda rÄ±za durumu K: Yetki KullanÄ±ldÄ± yapÄ±lÄ±r.  Y â¨K \n b. Yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci alÄ±nmasÄ± sÄ±rasÄ±nda; yenileme belirteci kontrolÃ¼ ve sonrasÄ±nda rÄ±za kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. \n Â Â Â Â  i. Ãncelikle Yenileme Belirteci GeÃ§erlik SÃ¼resi kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir Yenileme Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  ii. RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki SonlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iii. RÄ±za durumu Yetki Bekleniyor - B ya da Yetkilendirildi - Y  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \nÂ Â Â Â  iv. RÄ±za durumu Yetki KullanÄ±ldÄ± - K veya Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E olduÄunda, yenileme belirteci karÅÄ±lÄ±ÄÄ± eriÅim belirteci tahsis edilir. \n \n \n Ãdeme BaÅlatma API Ã¶nce eriÅim belirteci ve sonrasÄ±nda rÄ±za kontolÃ¼ yapÄ±larak gerÃ§ekleÅtirilmelidir \n \n Ãncelikle EriÅim Belirteci kontrolÃ¼ yapÄ±lmalÄ±dÄ±r. GeÃ§erli bir EriÅim Belirteci olmadÄ±ÄÄ± gÃ¶rÃ¼lÃ¼r ise  TR.OHVPS.Connection.InvalidToken  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Ä°ptal - I  ya da Yetki S

16onlandÄ±rÄ±ldÄ± - S ise  TR.OHVPS.Resource.ConsentRevoked  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki Bekleniyor - B , Yetkilendirildi - Y, Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ - E  ise  TR.OHVPS.Resource.ConsentMismatch  hatasÄ± dÃ¶nÃ¼lmelidir. \n RÄ±za durumu Yetki KullanÄ±ldÄ± - K olduÄunda Ã¶deme emri gerÃ§ekleÅtirilir.  RÄ±za durumu Yetki KullanÄ±ldÄ± - K'dan Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ â E yapÄ±lmalÄ±dÄ±r.   K â¨E \n \n \n \n Sorgulama: GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlarda, Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle, Ã¶demeEmriRizasi nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r.\nRÄ±za sorgulama, Ãdeme Emri Sorgulama API'lerinde ilgili rÄ±za kaydÄ± bulunamaz veya sorgulayan kurumun yetkisi yoksa (Ã¶rn : YÃSâÃ¼n farklÄ± bir YÃSâe ait rÄ±za noyu sorgulamasÄ±) \n TR.OHVPS.Resource.NotFound  hatasÄ± verilmelidir. \n \n \n Ãdeme Emri RÄ±zasÄ±nÄ±n Ä°ptali bulunmamaktadÄ±r. \n \n \n HHS/YÃS tarafÄ±nda rÄ±za bilgileri belirli aralÄ±klarla sistem kullanÄ±cÄ±sÄ± tarafÄ±ndan taranÄ±r:\n5 dakikadan uzun sÃ¼redir Yetki Bekleniyor'da kalan kayÄ±tlarÄ±n durumlarÄ± gÃ¼ncellenir.\nYetki Bekleniyor â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Bekleniyor  B â¨ I / 04 \n 5 dakikadan uzun sÃ¼redir Yetkilendirildi'de kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetkilendirildi     â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetkilendirildi  B â¨ I / 05 \n 5 dakikadan uzun sÃ¼redir Yetki kullanÄ±ldÄ±'da kalan kayÄ±tlar durumlarÄ± gÃ¼ncellenir.\nYetki kullanÄ±ldÄ± â¨ RÄ±za Ä°ptal / SÃ¼re AÅÄ±mÄ± : Yetki Ãdemeye DÃ¶nÃ¼Åmedi  B â¨ I / 06 \n Yenileme belirteci Son Tarih geldiÄinde rÄ±za durumu Yetki Ã¶deme emrine dÃ¶nÃ¼ÅtÃ¼âden Yetki SonlandÄ±rÄ±ldÄ±'ya gÃ¼ncellenir. \n E â¨ S \n \n \n GKD muafiyeti sadece Ã¶deme baÅlatma servislerinde bulunmaktadÄ±r. \n \n \n"},{title:"12.\tOlay Bildirim",frontmatter:{},regularPath:"/v2.0.1/contents/olay-bildirim.html",relativePath:"v2.0.1/contents/olay-bildirim.md",key:"v-0219a13d",path:"/v2.0.1/contents/olay-bildirim.html",headers:[{level:2,title:"Genel Bilgiler",slug:"genel-bilgiler"},{level:2,title:"Olay Abonelik Servisleri (OAS)",slug:"olay-abonelik-servisleri-oas"},{level:2,title:"ADIM 1: Olay AboneliÄinin gerÃ§ekleÅtirilmesi",slug:"adim-1-olay-aboneliginin-gerceklestirilmesi"},{level:2,title:"ADIM 2: Olay AboneliÄinin gÃ¼ncellenmesi",slug:"adim-2-olay-aboneliginin-guncellenmesi"},{level:2,title:"ADIM 3: Olay AboneliÄinin sorgulanmasÄ±",slug:"adim-3-olay-aboneliginin-sorgulanmasÄ±"},{level:2,title:"ADIM 4: Olay AboneliÄinin iptali",slug:"adim-4-olay-aboneliginin-iptali"},{level:2,title:"ADIM 5: Olay AboneliÄinin Ä°letilemeyen OlaylarÄ±",slug:"adim-5-olay-aboneliginin-iletilemeyen-olaylarÄ±"},{level:2,title:"ADIM 6: Sistem Olay Dinleme",slug:"adim-6-sistem-olay-dinleme"},{level:2,title:"Olay Dinleme Servisleri (ODS)",slug:"olay-dinleme-servisleri-ods"},{level:2,title:"ADIM 1: Olay Dinleme",slug:"adim-1-olay-dinleme"},{level:2,title:"ADIM 2:  Sistem Olay Dinleme",slug:"adim-2-sistem-olay-dinleme"}],content:" 12.\tOlay Bildirim  \n Genel Bilgiler \n Olay Bildirim Abonelik API servisleri, HHS'lerin sunmuÅ olduklarÄ± olay bildirimlerini takip etmek amacÄ±yla abonelik akÄ±ÅlarÄ±nÄ± tanÄ±mlar. \n YÃS'ler olay bildirimlerini takip edebilmek iÃ§in talep ettikleri abonelik hizmetlerini belirterek HHS'ler Ã¶zelinde bir abonelik kaydÄ± oluÅtururlar. Bu abonelik kaydÄ±nÄ± okuyabilir, gÃ¼ncelleyebilir ya da silebilirler. \n Olay bildirimleri HHS'ler tarafÄ±ndan 2 yÃ¶ntem ile saÄlanÄ±r. Ä°lki olay bildirimlerinin anlÄ±k olarak iletilmesi, diÄeri ise anlÄ±k iletilemeyen olaylarÄ±n toplu olarak iletilmesidir. \n Olay Bildirimi 2 API ile yÃ¶netilecektir. \n 1 - Olay Abonelik Servisleri (OAS) \n2 - Olay Dinleme Servisleri  (ODS) \n Olay Abonelik ve Olay Dinleme API'lerinin istek ve yanÄ±t baÅlÄ±ÄÄ±nda beklenen parametreler ÃBH,HBH,GKD API'lerinden farklÄ±dÄ±r.\n 3.15. Ä°stek BaÅlÄ±ÄÄ±  ve  3.16. YanÄ±t BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mlerinde zorunlu parametreler ve aÃ§Ä±klamalarÄ± belirtilmiÅtir. \n Olay Abonelik Servisleri (OAS) \n Olay abonelik Servisleri; HHS'ler tarafÄ±ndan sunulacak olay bildirim abonelik servislerini ve iletilemeyen olaylar servisini iÃ§ermektedir. \n HHS'nin sunacaÄÄ± bu API ile YÃS'ler Åu adÄ±mlarÄ± gerÃ§ekleÅtirebilir. \n \n YÃS'Ã¼n olay bildirimlerini dinleyebilmek iÃ§in Ã¶ncelikle dinlemek istediÄi olaylara ait olay tipleri ve kaynak tiplerini belirlemesi gerekmektedir. \n Olay tipleri ve kaynak tiplerinin neler olacaÄÄ± \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda belirtilmiÅtir. \n YÃS, belirlediÄi olaylar iÃ§in HHS'ye olay abonelik endpointi aracÄ±lÄ±ÄÄ± ile abonelik baÅlatÄ±r. \n YÃS, abonelik numarasÄ± aracÄ±lÄ±ÄÄ± ile abonelik bilgilerini gÃ¶rÃ¼ntÃ¼leyebilir, gÃ¼ncelleyebilir, silebilir. \n YÃS, olay bildirimlerini bu abonelik sayesinde kendisinin sunacaÄÄ± Olay Dinleme API'si ile dinler. \n HHS anlÄ±k iletemediÄi olaylarÄ±nÄ± biriktirerek, iletilemeyen olaylar endpointi ile YÃS'e sunar. \n \n HHS'ler \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda belirlenen olay ve kaynak tiplerinin tÃ¼mÃ¼ iÃ§in YÃS'lere bildirim sunmak zorundadÄ±r. \n Olay Abonelik Servislerinde Idempotency kurallarÄ±nÄ±n iÅletilmesine gerek bulunmamaktadÄ±r. \n Nezdinde Ã¶deme hesabÄ± bulunduran bazÄ± hesap hizmeti saÄlayÄ±cÄ±lar(EPK, Ãdeme KuruluÅlarÄ±) mÃ¼Återilerine ait hesaplarÄ±, diÄer HHS'lerdeki havuz hesaplarÄ±nÄ± kullanarak yÃ¶netiyor olabilir. Bu durum ilgili hesap hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n, ÃHVPS kapsamÄ±nda HHS olduÄu rolde sunmasÄ± gereken olay bildirim servisleri ile ilgili uymasÄ± gereken kurallarÄ± deÄiÅtirmemektedir. Ä°lgili hesap hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n standartlara uygun Åekilde YÃS'lere bildirimleri yapmasÄ± gerekmektedir. \n YÃS'ler sahip olduklarÄ± rol Ã¶zelinde olay abonelik servislerinden faydalanabilir. Bu yÃ¼zden olay bildirim etki alanÄ± (scope) deÄerleri hesap_bilgisi ve/veya odeme_emri olarak belirlenmiÅtir. \n Olay Abonelik Servisine ait API Endpointleri aÅaÄÄ±daki tabloda listelenmiÅtir. \n Olay Abonelik Servisleri iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âhesap_b

16ilgisiâ  \"odeme_emri\" \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n olay-abonelik \n POST \n /olay-abonelik \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n OlayAbonelikÄ°stegi \n OlayAbonelik \n \n \n 2 \n olay-abonelik \n GET \n /olay-abonelik \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n \n - \n OlayAbonelik \n \n \n 3 \n olay-abonelik/{olayAbonelikNo} \n PUT \n /olay-abonelik/{olayAbonelikNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n \n OlayAbonelik \n OlayAbonelik \n \n \n 4 \n olay-abonelik/{olayAbonelikNo} \n DELETE \n /olay-abonelik/{olayAbonelikNo} \n Z \n Ä°stemci Kimlik Bilgileri \n - \n - \n - \n - \n \n \n 5 \n olay-abonelik/{olayAbonelikNo}/iletilemeyen-olaylar \n GET \n /olay-abonelik/{olayAbonelikNo}/iletilemeyen-olaylar \n Z \n Ä°stemci Kimlik Bilgileri \n - \n Sayfalama \n \n Olaylar \n \n \n 6 \n sistem-olay-dinleme \n POST \n sistem-olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n

16- \n - \n Olaylar \n - \n ADIM 1: Olay AboneliÄinin gerÃ§ekleÅtirilmesi \n POST /olay-abonelik \n HHS'nin olay abonelik hizmeti sunduÄu servistir.\nYÃS, seÃ§eceÄi olay-kaynak tipleri iÃ§in bu servis aracÄ±lÄ±ÄÄ± ile abone olabilir. HHS POST iÅlemi sonucunda, YÃS adÄ±na bir olay abonelik kaynaÄÄ± oluÅturur ve tekil tanÄ±mlayÄ±cÄ± olan olayAbonelikNo deÄerini dÃ¶ner. olayAbonelikNo Ã¼retilirken farklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. olayAbonelikNo evrensel tekil olmalÄ±dÄ±r. \n1 YÃS'Ã¼n 1 HHS'de 1 adet abonelik kaydÄ± olabilir. \nBaÅarÄ±lÄ± POST isteÄi sonucu HTTP 201 cevabÄ± ile iletilmelidir. \n YÃS tarafÄ±ndan daha Ã¶nce oluÅturulmuÅ olay abonelik kaydÄ± varsa  \"HTTP 400 -TR.OHVPS.Business.EventSubscriptionAlreadyExists\"  hatasÄ±yla uyarÄ± mesajÄ±nÄ± dÃ¶ner. \n Olay Abonelik kaydÄ± oluÅturmak isteyen YÃS'Ã¼n ODS API tanÄ±mÄ± HHS tarafÄ±ndan kontrol edilmelidir. YÃS'Ã¼n tanÄ±mÄ± olmamasÄ± halinde  \"HTTP 400-TR.OHVPS.Business.InvalidContent\"  hatasÄ± verilmelidir. \n Olay Abonelik kaydÄ± oluÅturmak isteyen YÃS tarafÄ±ndan olay tipi ve kaynak tipi iÃ§in iletilen deÄerler olmasÄ± gereken sÄ±ralÄ± veri tÃ¼lerinden(TR.OHVPS.DataCode.OlayTip ve TR.OHVPS.DataCode.KaynakTip) farklÄ± ise HHS tarafÄ±ndan   \"TR.OHVPS.Business.EventSubscriptionNotFound\"  hatasÄ± verilmelidir. \n Abonelik Ã¼zerinde gÃ¶rÃ¼ntÃ¼leme, gÃ¼ncelleme, silme iÅlemlerini gerÃ§ekleÅtirebilir.\nYÃS'Ã¼n AboneliÄi devam ettiÄi sÃ¼rece; YÃS'Ã¼n aÃ§acaÄÄ± Olay Dinleme API'sine, HHS tarafÄ±ndan abonelik kapsamÄ±nda olay bildirimleri iletilir. \n BKM'nin sunacaÄÄ± abonelik servisleri iÃ§in HHS ve YÃS'lerin abonelik isteÄi yapmasÄ±na gerek bulunmamaktadÄ±r. BKM Ã¼retim ortamÄ± tanÄ±mlarÄ± yapÄ±lÄ±rken katÄ±lÄ±mcÄ±larÄ± abonelik servislerine Ã¼ye yapacaktÄ±r. BKM'nin sunacaÄÄ± abonelik servislerinin olay tipi \"HHS_YOS_GUNCELLENDI\"dir. HHS ve YÃS API ile sunulan bilgilerde bir deÄiÅiklik olduÄunda yapÄ±lacak olay bildirimlerini saÄlar.\nÃrneÄin; HHS logo bilgilerinde yapÄ±lacak bir deÄiÅiklik sonrasÄ±nda, YÃS'lere yapÄ±lacak bildirim ile logo bilgisini deÄiÅen HHS'nin hhsKod deÄerini iletir. YÃS, HHS API'yi  hhsKod ile Ã§aÄÄ±rarak HHS'nin gÃ¼ncel bilgilerini alÄ±r. GÃ¼ncel bilgiler ile kendi sistemini gÃ¼nceller. \n Olay tipi ve kaynak tipine ekleme yapÄ±ldÄ±kÃ§a YÃS'lerin olay abonelik kayÄ±tlarÄ±nÄ± yeni tipleri iÃ§erecek Åekilde gÃ¼ncel tutmasÄ± gerekmektedir. \n OlayAbonelikIstegi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n \n \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n YÃS abone olmak istediÄi olay tiplerini TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄer ya da deÄerler ile doldurur. \n \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda \"Olay Bildirim Yapan\" kolonu \"HHS\" olan olay tipleri ile veri giriÅine izin verilir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n Olay tiplerinin tanÄ±mlanabildiÄi kaynak listesi bulunmaktadÄ±r. Bu listeye uygun kaynak tipleri iletilmelidir. \n HHS, YÃS API Ã¼zerinden YÃS'Ã¼n rollerini alarak uygun kaynak tiplerine kayÄ±t olmasÄ±nÄ± saÄlar. \n \n \n \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± iletilebilir. Ä°lk deÄeri olay abonelik oluÅturma zamanÄ± bilgisidir. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n \n \n \n \n Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi \n * AnlÄ±k : Olay gerÃ§ekleÅtikten sonra maksimum 5 saniye iÃ§erisindeki zaman \n \n \n \n Olay Tipleri \n YÃS RolÃ¼ \n Kaynak Tipleri \n Olay OluÅturulma durumu \n KaynakNo \n AsÄ±l verinin elde edileceÄi API \n Olay Bildirimini Yapan \n Olay Bildirim ZamanÄ± \n Retry Policy \n \n \n \n \n KAYNAK_GUNCELLENDI \n ÃBH \n ODEME_EMRI \n TÃ¼m Ã¶deme durum deÄiÅikliklerinde \n odmEmrNo \n GET /odeme-emri/{odemeEmriNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n ILERI_TARIHLI_ODEME_EMRI_RIZASI \n RÄ±za iptal detay kodu â02â : KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal durumunda \n rizaNo \n GET /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n ILERI_TARIHLI_ODEME_EMRI \n TÃ¼m Ã¶deme durum deÄiÅikliklerinde, Ã¶deme emri iÃ§erisinde yer alan tutar, talimat tarihi deÄiÅikliklerinde \n odmEmrNo \n GET /ileri-tarihli-odeme-emri/{odemeEmriNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n DUZENLI_ODEME_EMRI_RIZASI \n RÄ±za iptal detay kodu â02â : KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal durumunda \n rizaNo \n GET /duzenli-odeme-emri-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n DUZENLI_ODEME_PLANI \n DÃ¼zenli Ã¶deme planÄ± iÃ§erisinde yer alan herhangi bir alan iÃ§in deÄiÅiklik olduÄu durumda \n tlmtNo \n /duzenli-odeme-emri/{tlmtNo}/odeme-plani \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n ÃBH \n DUZENLI_ODEME_EMRI \n DÃ¼zenli Ã¶deme emri iÃ§erisinde gÃ¶nderen hesap ve aÃ§Ä±klama alanlarÄ±na dair deÄiÅiklik olduÄu durumda \n tlmtNo \n /duzenli-odeme-emri/{tlmtNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n RÄ±za iptal detay kodu â02â : KullanÄ±cÄ± Ä°steÄi ile HHS Ã¼zerinden Ä°ptal durumunda ve RÄ±za iptal detay kodu â09â : Uygun Ã¼rÃ¼nÃ¼ bulunmuyor durumunda \n rizaNo \n GET /hesap-bilgisi-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 30 Dakika - 3 Deneme \n \n \n \n HBH \n BAKIYE \n Bakiye nesnesindeki tutarla ilgili bir bilgi deÄiÅtiÄinde ve HBH rÄ±zasÄ± iÃ§erisinde \"06-AnlÄ±k Bakiye Bildirimi\" izin tÃ¼rÃ¼ varsa oluÅturulur. Mevcutta alÄ±nmÄ±Å rÄ±zalar iÃ§in  bakiye kaynak tipi Ã¶zelinde 06 izin tÃ¼rÃ¼ gerektiÄinden; mevcut rÄ±zanÄ±n yenilenmesine dair mÃ¼Återiye bilgilendirme yapÄ±larak 06 izin tÃ¼rÃ¼nÃ¼ kapsayan yeni rÄ±za alÄ±nmasÄ± sÃ¼reci YÃS tarafÄ±ndan gerÃ§ekleÅtirilebilir. Bloke tutar deÄiÅikliÄi iÃ§in olay oluÅturma ve bildirimi HHS inisiyatifindedir. KrdHsp iÃ§erisinde yer alan kulKrdTtr deÄerinin deÄiÅtiÄi durumda olay bildirim gÃ¶nderilmesi gerekmektedir. \n hspRef \n GET /hesaplar/{hspRef}/bakiye, GET /hesaplar/{hspRef}/islemler \n HHS \n Maksimum 10 dakika iÃ§erisinde \n Retry policy uygulanmamalÄ±dÄ±r. Ä°lk istek gÃ¶nderilemediÄi durumda Ä°letilemeyen Olaylara eklenmelidir. \n \n \n \n HBH \n KART_BILGILERI \n Kart bilgileri nesnesindeki kart statÃ¼sÃ¼ veya ekstre tÃ¼rleri iÃ§erisinde sadece yeni bir esktre tÃ¼rÃ¼ eklendiÄinde oluÅturulur. Ekstre tÃ¼rÃ¼nde azaltma yÃ¶nÃ¼nde gÃ¼ncelleme varsa olay bildirimi gÃ¶nderilmemelidir. YÃS'e kart statÃ¼sÃ¼nÃ¼n veya ekstre tÃ¼rlerinin deÄiÅtiÄine dair olay bildirimi gÃ¶nderilir. \n kartRef \n GET /kartlar,  GET /kartlar/{kartRef},   GET /kartlar/{kartRef}/kart-detay,  GET /kartlar/{kartRef}/kart-hareketleri \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n HBH \n COKLU_ISLEM_TALEBI ( bulk-data) \n Ä°lgili API Ä°lke ve kurallarÄ±na eklendiÄinde gÃ¼ncellenecektir. \n \n \n HHS \n \n 30 Dakika - 3 Deneme \n \n \n AYRIK_GKD_BASARILI \n ÃBH \n ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}}&rizaTip=O \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}&rizaTip=H \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n ÃBH \n ILERI_TARIHLI_ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}}&rizaTip=I \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n ÃBH \n DUZENLI_ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ÄÄ±nda rÄ±za oluÅturulur. YÃS'e rÄ±za oluÅturulduÄuna dair bildirim yapÄ±lÄ±r. YÃS yetkod deÄerini sorgulama sonucunda elde eder. \n RizaNo \n GET /yetkilendirme-kodu?rizaNo={rizaNo}}&rizaTip=D \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n AYRIK_GKD_BASARISIZ \n ÃBH \n ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /odeme-emri-rizasi/{RizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n HBH \n HESAP_BILGISI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /hesap-bilgisi-rizasi/{RizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n ÃBH \n ILERI_TARIHLI_ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n \n ÃBH \n DUZENLI_ODEME_EMRI_RIZASI \n HHS sisteminde ÃHK kendini doÄruladÄ±ktan sonra yaptÄ±ÄÄ± kontroller neticesinde logine izin vermez ise YÃS'e bildirim yapÄ±lÄ±r. YÃS rÄ±za durumunu sorgulayarak iÅlemin neden iletilmediÄine dair bilgi edinebilir. \n RizaNo \n GET /duzenli-odeme-emri-rizasi/{rizaNo} \n HHS \n *AnlÄ±k \n 1 Dakika 3 kez \n \n \n HHS_YOS_GUNCELLENDI \n \n \n BKM sistemi tarafÄ±ndan Ã¼retilecek olaylarÄ± dinlemek iÃ§in kullanÄ±lacak kaynak tipidir. YÃS ve HHS'lerin BKM'ye abonelik oluÅturmasÄ±na gerek bulunmamaktadÄ±r. BKM HHS ve YÃS Ã¼retim ortamÄ± tanÄ±mÄ± yaparken abonelikler

16ini baÅlatacaktÄ±r.   (HHS yaygÄ±nlaÅtÄ±rma durumundayken de aboneliÄi baÅlatÄ±lacaktÄ±r.) \n \n \n HHS \n \n \n \n \n \n YÃS \n HHS \n HHS bilgilerinde deÄiÅiklik olduÄunda, YÃS'Ã¼n hhsKod ile sorgulama yapmasÄ± ve deÄiÅen bilgiyi gÃ¼ncellemesi beklenmektedir. \n hhsKod \n GET /hhs/{hhsKod} \n BKM \n *AnlÄ±k \n 5 Dakika - 3 Deneme \n \n \n \n HHS \n YOS \n YÃS bilgilerinde deÄiÅiklik olduÄunda, HHS'nin yosKod ile sorgulama yapmasÄ± ve deÄiÅen bilgiyi gÃ¼ncellemesi beklenmektedir. \n yosKod \n GET /yos/{yosKod} \n BKM \n *AnlÄ±k \n 5 Dakika - 3 Deneme \n \n \n \n * AnlÄ±k : Olay gerÃ§ekleÅtikten sonra maksimum 5 saniye iÃ§erisindeki zaman \n ADIM 2: Olay AboneliÄinin gÃ¼ncellenmesi \n PUT\tolay-abonelik/{olayAbonelikNo} \n YÃS'Ã¼n olay aboneliÄine ait abonelik tiplerini gÃ¼ncelleyebildiÄi servistir. Olay aboneliÄi oluÅturulduÄu zaman HHS tarafÄ±ndan iletilen olayAbonelikNo aracÄ±lÄ±ÄÄ± ile gÃ¼ncelleme iÅlemi yapÄ±lÄ±r. YÃS abone olmak istediÄi olay-kayÄ±t tiplerininin son halini gÃ¼ncelleme servisi ile HHS'ye iletir. HHS bu bilgilerle eski abonelik tiplerinin yerini deÄiÅtirir. \n BaÅarÄ±lÄ± PUT isteÄi sonucu HTTP 200 cevabÄ± ile iletilmelidir. \n OlayAbonelikIstegi nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n HHS geÃ§erli bir olay abonelik numarasÄ± olduÄunun kontrolÃ¼nÃ¼ yapar. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n HHS Sisteminde, YÃS'Ã¼n eski abonelikleri yeni aboneliklerle gÃ¼ncellenmelidir. \n \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n YÃS abone olmak istediÄi olay tiplerini TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄer ya da deÄerler ile doldurur. \n \"Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi\" tablosunda \"Olay Bildirim Yapan\" kolonu \"HHS\" olan olay tipleri ile veri giriÅine izin verilir.  Olay tipi AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ iÃ§in, YÃS'Ã¼n ODS API'yi sunmasÄ± zorunludur. HHS, bu olay tipleri Ã¶zelinde YÃS API Ã¼zerinden YÃS'Ã¼n bu API'yi sunduÄunu kontrol eder ve eÄer sunmuyor ise TR.OHVPS.Business.InvalidContent hatasÄ± dÃ¶nerek kayÄ±t iÅlemini gerÃ§ekleÅtirmez. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n Olay tiplerinin tanÄ±mlanabildiÄi kaynak listesi bulunmaktadÄ±r. Bu listeye uygun kaynak tipleri iletilmelidir. \n HHS, YÃS API Ã¼zerinden YÃS'Ã¼n rollerini alarak uygun kaynak tiplerine kayÄ±t olmasÄ±na izin verir. \n \n \n \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n OlayAbonelikIstegi nesnesi iÃ§erisinde iletilen deÄerlerin yanÄ±t iÃ§erisinde dÃ¶nmesi beklenmektedir. \n ADIM 3: Olay AboneliÄinin sorgulanmasÄ± \n GET /olay-abonelik \n YÃS olay abonelik bilgilerini sorgulamak isteyebilir. HHS, YÃS'e ait aktif durumdaki abonelik bilgisini iletir.\nBaÅarÄ±lÄ± GET sonucu HTTP 200 kodu ile iletilmelidir. \n OlayAbonelik nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Olay Abonelik NumarasÄ± \n olayAbonelikNo \n AN1..64 \n Z \n YÃS Ã¶zelinde oluÅturulan tekil tanÄ±mlayÄ±cÄ±dÄ±r. FarklÄ± YÃS'ler iÃ§in aynÄ± deÄer kullanÄ±lamaz. \n \n \n Olay Abonelik OluÅturulma zamanÄ± \n olusturmaZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin oluÅturulma zaman damgasÄ± \n \n \n Olay Abonelik GÃ¼ncelleme zamanÄ± \n guncellemeZamani \n ISODateTime \n Z \n Olay Abonelik nesnesinin gÃ¼ncelleme zaman damgasÄ± \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Abonelik Tipleri \n abonelikTipleri \n Kompleks: abonelikTipleri[Array][1..N] \n Z \n YÃS'Ã¼n abone olduÄu olay - kaynak listesini dÃ¶ner. \n \n \n > Olay Tipi \n olayTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden deÄerler iÃ§erir. \n \n \n > Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden deÄerler iÃ§erir. \n ADIM 4: Olay AboneliÄinin iptali \n DELETE /olay-abonelik/olayAbonelikNo \n YÃS'Ã¼n abonelik kaydÄ±nÄ± silmesi iÃ§in HHS'nin sunduÄu servistir.  BaÅarÄ±lÄ± silme iÅlemi sonucu HTTP 204 ile YÃS'e iletilir. \n ADIM 5: Olay AboneliÄinin Ä°letilemeyen OlaylarÄ± \n GET /iletilemeyen-olaylar \n HHS kaynaklar Ã¼zerinde oluÅacak olaylarÄ± YÃS'e POST/olay-dinleme servisi ile gÃ¶nderim saÄlamaktadÄ±r. Bu gÃ¶nderim belli bir yeniden gÃ¶nderim politasÄ± (retry-policy) ile yapÄ±lmalÄ±dÄ±r.  Ancak yine de iletilemeyen olaylar olursa (YÃS servisinden HTTP 202 alamama durumu) YÃS'e iletilemeyen-olaylar servisi Ã¼zerinden sunulmalÄ±dÄ±r. Yani yeniden gÃ¶nderim politikasÄ± sonunda gÃ¶nderilemeyen olaylar bu servis ile sunulmalÄ±dÄ±r. \n AynÄ± kaynak numarasÄ± ile aynÄ± olay-kaynak tipinde, 1 YÃSâe ait, 1 adet iletilemeyen olay kaydÄ± olabilir. \n Bu serviste 1 gÃ¼n Ã¶ncesinden sorgu anÄ±na kadar tÃ¼m kayÄ±tlarÄ±na ait iletilemeyen olaylar listelenmelidir.\nÃrnek sorgu zamanÄ± : 2023-04-06T15:14:00+03:00\nHHS'nin sunacaÄÄ± veri 2023-04-05T00:00:00+03:00  ile 2023-04-06T15:14:00+03:00 arasÄ±nda olmalÄ±dÄ±r.\nSÄ±ralama yÃ¶nÃ¼ olay tarihine gÃ¶re artan Åekilde olmalÄ±dÄ±r. Sayfalama 100'er kayÄ±t dÃ¶nÃ¼lerek yapÄ±lmalÄ±dÄ±r. \n YÃS tarafÄ±ndan iletilemeyen olaylar isteÄi 10 dakikada bir olacak Åekilde yapÄ±labilir. HHS bu limite uygun iÅlem kÄ±sÄ±tÄ± uygulayabilir. \n Ä°Ålem Sorgu ÃrneÄi GET Ä°Ålem Sorgu ÃrneÄi  : /iletilemeyen-olaylar?syfNo=1&olyZmnBslTrh=2024-01-08T16:42:00+03:00&olyZmnBtsTrh=2024-01-09T17:09:00+03:00 \n ÃrneÄin; \n olyZmnBslTrh : 07/01/2024 10:00:00+03:00\n olyZmnBtsTrh : 09/01/2024 16:00:00+03:00\n Sorgu ZamanÄ± : 09/01/2024 10:15:00+03:00 \n YanÄ±t iÃ§erisinde yer alan veriye ait tarih aralÄ±ÄÄ± : 08/01/2024 00:00:00+03:00 - 09/01/2024 10:15:00+03:00 olmalÄ±dÄ±r. \n BaÅlangÄ±Ã§ ve bitiÅ zaman aralÄ±ÄÄ± Ã¶rnekte yer alan Åekilde seÃ§ilse dahi ilgili servis yanÄ±tÄ± iÃ§in Ã¶ncelikle sorgu zamanÄ±na bakÄ±lÄ±p 1 gÃ¼n Ã¶ncesinden sorgu anÄ±na kadar tÃ¼m kayÄ±tlarÄ±n iletilemeyen olaylar iÃ§erisinde listelenmesi saÄlanmalÄ±dÄ±r. \n Ä°lgili tarih aralÄ±ÄÄ±nda uygun veri olmamasÄ± halinde yanÄ±t gÃ¶vdesi boÅ olacak Åekilde dÃ¶nÃ¼lmelidir. \n Ä°letilemeyen Olaylar Sorgulama Ä°steÄi Sorgu Parametreleri \n \n \n \n Alan AdÄ± \n Parametre AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n Ä°stenen Sayfa Numarasi \n syfNo \n N3 \n Ä° \n Cevapta dÃ¶necek sayfa numarasÄ± 1âden baÅlayarak artan deÄerlerle iletilmelidir. \n Bu veri gÃ¶nderildiÄi durumda, HHS Ä°letilemeyen Olaylar listesine ait bu sayfadaki kayÄ±tlarÄ± gÃ¶ndermelidir. GÃ¶nderilmediÄinde, HHS ilk sayfadaki kayÄ±tlarÄ± gÃ¶ndermelidir. \n \n \n Olay ZamanÄ± BaÅlangÄ±Ã§ Tarihi \n olyZmnBslTrh \n ISODateTime \n Ä° \n Sorgulanacak Olay ZamanÄ±na ait baÅlangÄ±Ã§ tarihi \n HHS'ler iletilemeyen olaylar listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan tetiklenen sorgularda; olyZmnBslTrh iletilmediÄi durumda ya da 1 gÃ¼n Ã¶ncesinin baÅlangÄ±Ã§ saatine gÃ¶re daha geri bir zaman dilimi gÃ¶nderildiÄinde, baÅlangÄ±Ã§ zamanÄ±(olyZmnBslTrh) deÄeri sorgu zamanÄ±ndan 1 gÃ¼n Ã¶ncesine ait gÃ¼nÃ¼n baÅlangÄ±Ã§ zamanÄ± olarak kabul edilmelidir. \n \n \n Olay ZamanÄ± BitiÅ Tarihi \n olyZmnBtsTrh \n ISODateTime \n Ä° \n Sorgulanacak Olay ZamanÄ±na ait bitiÅ tarihi \n HHS'ler iletilemeyen olaylar listesi dÃ¶nÃ¼ÅÃ¼nÃ¼ bu kritere gÃ¶re filtreleyerek iletmek zorundadÄ±r. YÃS tarafÄ±ndan tetiklenen sorgularda;

16 olyZmnBtsTrh iletilmediÄi durumda ya da sorgu zamanÄ±ndan daha ileri bir zaman dilimi gÃ¶nderildiÄinde, bitiÅ zamanÄ±(olyZmnBtsTrh) deÄeri sorgu zamanÄ± olarak kabul edilmelidir. \n \n \n \n Tablo 17: Olaylar nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n Olaylar \n olaylar \n Kompleks: Olaylar \n Z \n \n \n \n >Olay No \n olayNo \n AN1..64 \n Z \n Olaya ait evrensel tekil numaradÄ±r. \n \n \n >Olay Zamani \n olayZamani \n ISODateTime \n Z \n OlayÄ±n oluÅtuÄu tarih bilgisidir. \n \n \n >Olay Tipi \n olayTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >Kaynak NumarasÄ± \n kaynakNo \n AN1..128 \n Z \n GÃ¼ncellenen kaynaÄa ait HHS sistemindeki tekil tanÄ±mlayÄ±cÄ±. \n \n \n \n Kaynak numarasÄ±nda gÃ¶nderilen deÄer ile ilgili kaynaÄÄ± sorgulayarak almak YÃS'Ã¼n insiyatifindedir. \n ADIM 6: Sistem Olay Dinleme \n POST /sistem-olay-dinleme \n HHS'lerin sistem olaylarÄ±nÄ± dinleme amacÄ±yla aÃ§masÄ± gereken endpoint bilgisidir. \n YÃS API iÃ§erisinde yapÄ±lan deÄiÅikliklerde, BKM tarafÄ±ndan HHS'lere olay bildirimlerini yapÄ±lÄ±r. \n Olaylar yanÄ±t nesnesi iÃ§erisinde 1 adet kayÄ±t yer almalÄ±dÄ±r. \n BaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted kodu ile dÃ¶nÃ¼lmelidir. \n HHS'den baÅarÄ±lÄ± yanÄ±t alÄ±namadÄ±ÄÄ± durumda, 5 dakika aralÄ±klarla 3 kez deneme yapÄ±lacaktÄ±r. Hata alÄ±nmaya devam edilmesi durumunda baÅka bir aksiyon alÄ±nmayacaktÄ±r. \n Olay Dinleme Servisleri (ODS) \n YÃS sunacaÄÄ± Olay Dinleme Servisi ile hem HHS'den hem de BKM'den gelen olaylarÄ±n bildirimini dinleyebilir. YÃS'ler HHS'de yer alan olay abonelik kayÄ±tlarÄ±nÄ± iptal edebilir ancak BKM Sistem Olay Dinleme servisinin ileteceÄi bildirimlerin alÄ±nmasÄ± zorunlu olduÄundan ODS API her zaman aktif olmalÄ±dÄ±r. \n HHS'den gelecek olay bildirimlerini olay-dinleme endpointi ile dinlerken, BKM'den gelecek olay bildirimlerini sistem-olay-dinleme endpointi ile dinlemelidir. \n Olay Dinleme Servislerinde Idempotency kurallarÄ±nÄ±n iÅletilmesine gerek bulunmamaktadÄ±r. \n Olay Dinleme Servisine ait API Endpointleri aÅaÄÄ±daki tabloda listelenmiÅtir. \n Olay Dinleme Servisleri iÃ§in EriÅim Adresleri (Endpoints) \n Etki AlanÄ± (Scope) =âolay_dinlemeâ \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu (Z)/ Ä°steÄe BaÄlÄ±(Ä°) \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Parametre \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n olay-dinleme \n POST \n /olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek \n - \n Olaylar \n - \n \n \n 2 \n sistem-olay-dinleme \n POST \n /olay-dinleme \n Z \n Ä°stemci Kimlik Bilgileri \n

16- \n - \n Olaylar \n - \n ADIM 1: Olay Dinleme \n POST /olay-dinleme \n Olay abonelik servisi ile abone olunan olaylar, olay dinleme servisi ile YÃS'e iletilir.\nOlaylar yanÄ±t nesnesi iÃ§erisinde en fazla 100 kayÄ±t gÃ¶nderilmelidir.\nBaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted ile dÃ¶nÃ¼lmelidir. \n HHS'nin iÅlem hata aldÄ±ÄÄ±nda, baÅarÄ±lÄ± iÅlem olana kadar 3 kez deneme yapÄ±lmasÄ± gerekmektedir.\nÄ°lk istekle son istek arasÄ±nda 30 dakika olacak Åekilde, zamana yayarak bu denemelerin yapÄ±lmasÄ± gerekmektedir. (Exponential backoff policy uygulanmasÄ± beklenmektedir. )\nHHS kendi sistemini yormayacak Åekilde, belirleyeceÄi kurallar dahilinde bu geliÅtirmeyi yapmalÄ±dÄ±r. \n Tablo 17: Olaylar nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format \n Zorunlu / KoÅullu /  Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n >KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >>Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n >> Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n >Olaylar \n olaylar \n Kompleks: Olaylar \n Z \n \n \n \n >>Olay NumarasÄ± \n olayNo \n AN1..64 \n Z \n Olaya ait atanmÄ±Å tekil kimlik numarasÄ± \n \n \n >>Olay ZamanÄ± \n olayZamani \n ISODateTime \n Z \n OlayÄ±n oluÅma zamanÄ± \n \n \n >>Olay Tipi \n olayTipi \n AN1..36 \n > \n TR.OHVPS.DataCode.OlayTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >>Kaynak Tipi \n kaynakTipi \n AN1..36 \n Z \n TR.OHVPS.DataCode.KaynakTip sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n >>Kaynak NumarasÄ± \n kaynakNo \n AN1..128 \n Z \n GÃ¼ncellenen kaynaÄa ait HHS sistemindeki tekil tanÄ±mlayÄ±cÄ±. \n ADIM 2:  Sistem Olay Dinleme \n POST /sistem-olay-dinleme \n YÃS'lerin sistem olaylarÄ±nÄ± dinleme amacÄ±yla aÃ§masÄ± gereken endpoint bilgisidir. \n HHS API iÃ§erisinde yapÄ±lan deÄiÅikliklerde, BKM tarafÄ±ndan YÃS'lere olay bildirimlerini yapÄ±lÄ±r. \n Olaylar yanÄ±t nesnesi iÃ§erisinde 1 adet kayÄ±t yer almalÄ±dÄ±r. \n BaÅarÄ±lÄ± POST isteÄi sonucu HTTP 202 Accepted kodu ile dÃ¶nÃ¼lmelidir. \n YÃS'ten baÅarÄ±lÄ± yanÄ±t alÄ±namadÄ±ÄÄ± durumda, 5 dakika aralÄ±klarla 3 kez deneme yapÄ±lacaktÄ±r. Hata alÄ±nmaya devam edilmesi durumunda baÅka bir aksiyon alÄ±nmayacaktÄ±r. \n"},{title:"6.\tÃdeme Emri BaÅlatma Hizmeti",frontmatter:{},regularPath:"/v2.0.1/contents/odeme-emri-baslatma-hizmeti.html",relativePath:"v2.0.1/contents/odeme-emri-baslatma-hizmeti.md",key:"v-4700a39d",path:"/v2.0.1/contents/odeme-emri-baslatma-hizmeti.html",headers:[{level:3,title:"Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints)",slug:"odeme-emri-baslatma-hizmeti-icin-erisim-adresleri-endpoints"},{level:2,title:"6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi",slug:"_6-1-adim-0-odeme-emri-baslatma-istegi"},{level:2,title:"6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ±",slug:"_6-2-adim-1-odeme-emri-rÄ±zasÄ±nÄ±n-hazÄ±rlanmasÄ±"},{level:2,title:"6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi",slug:"_6-3-adim-2-odeme-emri-rÄ±zasÄ±nÄ±n-yetkilendirilmesi"},{level:2,title:"6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±)",slug:"_6-4-adim-2-1-odeme-emri-rÄ±zasÄ±nÄ±n-sorgulanmasÄ±-istege-baglÄ±"},{level:2,title:"6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ±",slug:"_6-5-adim-3-odeme-emrinin-olusturulmasÄ±"},{level:2,title:"6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±)",slug:"_6-6-adim-3-1-odeme-emri-sorgusu-istege-baglÄ±"},{level:3,title:"GET /odeme-emri/{odemeEmriNo}",slug:"get-odeme-emri-odemeemrino"}],content:" 6.\tÃdeme Emri BaÅlatma Hizmeti \n Ãdeme emri baÅlatma iÅlemi havale, FAST ya da PÃS Ã¶demesiyle sonuÃ§lanabilir. Ãdeme iÅleminin amacÄ± kiÅiden kiÅiye para transferi, e-ticaret Ã¶demesi gibi farklÄ± Ã¶deme tÃ¼rleri olabilir. Ãdemenin amacÄ±na gÃ¶re ÃBHSânin ileteceÄi veri setinde farklÄ±laÅmalar olabilir. \n Ãdeme Emri BaÅlatma Hizmeti 5 temel akÄ±Ådan oluÅur: \n \n Ãdeme Emri BaÅlatma Ä°steÄinin tetiklenmesi:  ÃHK ÃBHS mobil uygulama ya da websitesinden Ã¶deme emrini baÅlatÄ±r. \n Ãdeme Emri RÄ±za HazÄ±rlanmasÄ±:  ÃBHS, âÃdeme Emri BaÅlatmaâ iÅlemi iÃ§in izin oluÅturulmasÄ± isteÄini HHSâye iletir. \n Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi:  HHS, gerekli gÃ¶rdÃ¼ÄÃ¼ durumlarda ÃHKâyÄ± GKD ile doÄrular ve Ã¶deme emri rÄ±zasÄ±na eriÅim iÃ§in eriÅim belirteci tanÄ±mlanmasÄ±nÄ± temin eder. \n Ãdeme Emrinin BaÅlatÄ±lmasÄ±:  ÃBHS, âÃ¶deme emriâni HHSâye iletir. \n Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± SorgularÄ±:  ÃBHS, Ãdeme Emri RÄ±za Durumu, Ãdeme Emri Durumu, Ãdeme Emri DetayÄ± bilgilerini isteÄe baÄlÄ± olarak sorgulayabilir. \n \n Nezdinde Ã¶deme hesabÄ± bulunduran hesap hizmeti saÄlayÄ±cÄ±lar(Banka, EPK, Ãdeme KuruluÅlarÄ±)  mÃ¼Återilerine ait hesaplarÄ± hesap referansÄ± ya da hesap numarasÄ± Ã¼zerinden takip etmektedir. YÃS'lerin hem HBH hem de ÃBH servisleri iÃ§in hesap referansÄ± veya hesap numarasÄ± Ã¼zerinden iÅlem yapÄ±labileceÄini bilmeleri, sistemlerini API dokÃ¼manÄ±nda belirtilen akÄ±Ålara gÃ¶re uyumlandÄ±rmalarÄ± ve mÃ¼Återi bilgilendirmesini(Ã¶nyÃ¼zlerinde hesap no ve hesap referansÄ± ayrÄ±mÄ±nÄ± gÃ¶zeterek) buna paralel yapmalarÄ± beklenmektedir. \n YÃS'ler gÃ¶nderen hesap seÃ§imini aÅaÄÄ±daki yÃ¶ntemlerden biri ya da birkaÃ§Ä± ile saÄlayabilirler: \n \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± HHS ekranÄ±ndan seÃ§tirebilir. \n YÃS, mÃ¼Återisinden Hesap Bilgisi rÄ±zasÄ± alÄ±r. RÄ±za aldÄ±ÄÄ± hesaplar Ã¼zerinden hesap referansÄ± aracÄ±lÄ±ÄÄ± ile Ã¶deme emri baÅlatabilir. \n YÃS, mÃ¼Återisinin Ã¶deme hesabÄ±nÄ± elle girmesine olanak tanÄ±yabilir. IBAN'Ä± olmayan HHS'ler Ã¶deme emri rÄ±zasÄ± adÄ±mÄ±nda  TR.OHVPS.Business.IBANNotSupported  hatasÄ±nÄ± vermelidir. IBAN'Ä± olan HHS'lerin bu akÄ±ÅÄ± desteklemesi zorunludur. \n YÃS; mÃ¼Återisinin hesap referansÄ±nÄ± elle girmesini saÄlayabilir. Hesap ReferansÄ± bilgisi ile baÅlatÄ±lan Ã¶deme emri iÅlemlerinde HHS seÃ§imi zorunludur. \n \n Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler, mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in, YÃS'ler hesap referansÄ± ile Ã¶deme baÅlatabilirler. Bu

16nlarÄ±n dÄ±ÅÄ±ndaki HHS'lerin, gÃ¶nderen IBAN veya hesap referansÄ± ile Ã¶deme akÄ±ÅÄ±nÄ± desteklemesi zorunludur. \n \n Åekil 4: Ãdeme Emri BaÅlatma Hizmeti Ãst DÃ¼zey Ä°Å AkÄ±ÅÄ± \n Ãdeme Emri BaÅlatma Hizmeti iÃ§in EriÅim Adresleri (Endpoints) \n Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adreslerinin Etki AlanÄ± (Scope) = âodeme_emriâ olarak belirtilmelidir. \n Tablo 6: Ãdeme Emri BaÅlatma Hizmeti Ä°Ã§in EriÅim Adresleri \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Zorunlu / Ä°steÄe BaÄlÄ± \n Yetkilendirme TÃ¼rÃ¼ \n Ä°mzalama \n Ä°stem Nesnesi \n YanÄ±t Nesnesi \n \n \n \n \n 1 \n odeme-emri-rizasi \n POST \n /odeme-emri-rizasi \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriRizasiIstegi \n OdemeEmriRizasi \n \n \n 2 \n erisim-belirteci (GKD iÃ§in) \n POST \n /erisim-belirteci \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n ErisimBelirteciIstegi \n ErisimBelirteci \n \n \n 2.1 \n odeme-emri-rizasi \n GET \n /odeme-emri-rizasi/{rizaNo} \n Z \n Ä°stemci Kimlik Bilgileri \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmriRizaYaniti \n \n \n 3 \n odeme-emri \n POST \n /odeme-emri \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± Ä°stek ve YanÄ±t \n OdemeEmriIstegi \n OdemeEmri \n \n \n 3.1 \n odeme-emri \n GET \n /odeme-emri/{odemeEmriNo} \n Z \n Ä°stemci Kimlik Bilgileri & Yetkilendirme Kodu (GKD) \n Ä°mzalÄ± YanÄ±t \n - \n OdemeEmri \n 6.1.\tADIM 0 - Ãdeme Emri BaÅlatma IsteÄi \n \n ÃHK, ÃBHS uygulamasÄ±nda (web arayÃ¼zÃ¼/mobil uygulama) Ã¶deme emri baÅlatma iÅlemine onay verir. \n GÃ¶nderen hesap detaylarÄ±nÄ±n bu aÅamada belirtilmesi zorunlu deÄildir. \n 6.2.\tADIM 1 - Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n   \n Åekil 5: Ãdeme Emri RÄ±zasÄ±nÄ±n HazÄ±rlanmasÄ± \n \n \n ÃBHS, Ã¶deme hizmeti kullanÄ±cÄ± hesabÄ±nÄ±n bulunduÄu HHSâye baÄlanarak Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n oluÅturulmasÄ±nÄ± (odemeEmriRizasi) saÄlar. \n \n \n POST isteÄi TLS protokolÃ¼ tesis edilen iletiÅim katmanÄ± Ã¼zerinden gerÃ§ekleÅtirilir. TLS iÃ§in nitelikli sertifikalar kullanÄ±lÄ±r. \n \n \n POST isteÄinin baÅlÄ±ÄÄ±ndaki alanlar ve istemcinin sertifikasÄ±ndaki Ã¶zel alanlar kullanÄ±larak istemcinin yetkilendirilmesi saÄlanÄ±r: \n \n Ä°stekte bulunan ÃBHS yetkilendirilmiÅ olduÄu geÃ§it tarafÄ±ndan kontrol edilir. \n Ä°stekte bulunan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± ÃBHS rolÃ¼ne sahipliÄi geÃ§it tarafÄ±ndan kontrol edilir. \n HHS tarafÄ±ndan, istek baÅlÄ±ÄÄ±ndaki x-aspsp-code ile katilimciBlg iÃ§erisinde yer alan hhsKod deÄeri ile aynÄ± olduÄunu kontrol edilir. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n \n POST baÅarÄ±lÄ± olursa, HHS, Ã¶deme emri iÃ§in iÃ§eride rÄ±za olup olmamasÄ±na bakÄ±lmaksÄ±zÄ±n yeni bir rÄ±za tanÄ±mlayÄ±cÄ±sÄ± RizaNo iÃ§eren odemeEmriRizasi  yanÄ±t olarak dÃ¶ner. \n \n \n 1 ÃHK'nÄ±n 1 YÃS iÃ§in 1HHS'de istediÄi kadar rÄ±zasÄ± olabilir. \n \n \n HHS tarafÄ±nda RizaDurumu deÄiÅkeninin durumu âYetki Bekleniyorâ olarak gÃ¼ncellenir. \n \n \n YÃSâÃ¼n doÄrulama ekranÄ± olarak ÃHKâya aÃ§acaÄÄ± URL adresini de ilgili rÄ±za numarasÄ±na gÃ¶re oluÅturur. Burada 2 farklÄ± yÃ¶ntemle URL oluÅturabilir. \n \n Statik URL  : \nHHSânin base pathi/alt-dizin/{rÄ±zaNo} \nÃrnek hhsYonAdr : https://xbank.com.tr/ohvps/cb54834e36f742d09af3d534ece3352a \nBu adres iÃ§in ilgili doÄrulama sayfasÄ± Ã¶nden hazÄ±rlanmalÄ± ve ÃHKânÄ±n doÄrulama sayfasÄ±na eriÅimi iÃ§in yayÄ±nlanmÄ±Å olmalÄ±dÄ±r (publish edilmelidir). \n Dinamik URL : \nHHSânin base pathi/alt-dizin/GKD KarÅÄ±lama EkranÄ±?rizano={rÄ±zano} \nÃrnek: https://xbank.com.tr/ohvps/gkd?rizano=cb54834e36f742d09af3d534ece3352a \n \n \n \n POST /odeme-emri-rizasi \n Ä°STEK: \n ÃBHS, bu API eriÅim adresinden HHSâye yeni bir OdemeEmriRizasi oluÅturulmasÄ± iÃ§in istekte bulunur: \n \n ÃBHS, Ã¶deme emri baÅlatma isteÄi olduÄunu HHSâye bildirir. \n ÃBHS, ÃHKânÄ±n, ÃBHS arayÃ¼zÃ¼nden verdiÄi rÄ±zanÄ±n (âÃn Onayâ) bir kopyasÄ±nÄ±n HHS nezdinde mÃ¼Återi tarafÄ±ndan onaylanmasÄ± iÃ§in HHSâye gÃ¶nderilmesini saÄlar. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini y

16apar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hata kodu iletilmeli ve fieldErrors dolu olacak Åekilde hatalÄ± alanÄ± belirten detaylÄ± aÃ§Ä±klama gÃ¶nderilmelidir. InvalidFormat hata kodlarÄ±nda fieldErrors iÃ§eriÄi gÃ¶nderilmeli ve anlaÅÄ±lÄ±r aÃ§Ä±klama ile message, messageTr alanlarÄ± doldurulmasÄ± zorunludur. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; YÃS API ile alÄ±nan ÃBHS bilgilerinin iÃ§erisinde yer alan yÃ¶nlendirme adresleri ile Ã¶deme emri rÄ±zasÄ± nesnesi request mesajÄ±nda paylaÅÄ±lan adreslerin uyumlu olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.TPPRedirectionAddressMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; kimlik bilgileri nesnesinde eÄer kimlik bilgileri iletilmiÅ ise; bu veri ile ÃHKânÄ±n HHS mÃ¼Återisi olup olmadÄ±ÄÄ±nÄ±n kontrollerini yapar. Bu kontrol hem bireysel hem de kurumsal ÃHKâlar iÃ§in yapÄ±lmalÄ±dÄ±r. (KoÅullu Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.CustomerNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. Kurumsal mÃ¼Återi ile baÅlatÄ±lan rÄ±zada yer alan mÃ¼Återi bilgisinin karÅÄ± kurumda Kurumsal mÃ¼Återi deÄil; bireysel mÃ¼Återi olduÄu durumda  TR.OHVPS.Business.BusinessCustomerMismatch  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Ãdeme Emri BaÅlatma Hizmeti rÄ±za isteÄinde bulunan ÃHKânÄ±n âAÃ§Ä±k BankacÄ±lÄ±k Kanal Yetkiâ tanÄ±mÄ± yok ise  \"TR.OHVPS.Business.OpenBankingChannelClosed\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. HHS insiyatifinde olup HHS bu kontrolÃ¼ GKD sonrasÄ± gerÃ§ekleÅtirebilir. \n HHS \"gkd\" nesnesi iÃ§in alan kontrollerini gerÃ§ekleÅtirir. \"yetYntm\" = \"A\" gÃ¶nderilmiÅ ise \"ayrikGkd\" nesnesinin dolu gÃ¶nderilmesi zorunludur. GÃ¶nderilmemesi durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n AyrÄ±k GKD desteklemeyen HHS'ye AyrÄ±k GKD yÃ¶ntemiyle rÄ±za baÅlatma isteÄi yapÄ±lmasÄ± durumunda HHS tarafÄ±ndan  \"TR.OHVPS.Business.DecoupledAuthenticationNotSupported\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder. YÃS iki olay tipine de abone olmak zorundadÄ±r. EÄer olay aboneliÄi yoksa HHS tarafÄ±ndan  \"TR.OHVPS.Business.EventSubscriptionNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za baÅlatma akÄ±ÅÄ± iÃ§erisinde kimlik bilgisinin olduÄu durumlarda; ÃHK'ya ait kimlik verisi(kmlk.kmlkVrs) ile ayrÄ±k GKD iÃ§erisinde yer alan OHK TanÄ±m DeÄer alanÄ± (ayrikGkd.ohkTanimDeger) birebir aynÄ± olmalÄ±dÄ±r. AynÄ± olmadÄ±ÄÄ± durumda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerInfoMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. Kimlik alanÄ± iÃ§ermeyen tek seferlik Ã¶deme emri akÄ±ÅlarÄ±nda bu kural geÃ§erli deÄildir. GSM ve IBAN deÄerleri sadece tek seferlik Ã¶demelerde kullanÄ±labilir. \n HHS tarafÄ±nda ÃHK'nÄ±n mobil uygulamasÄ± bulunmamasÄ± durumu tespit edilebildiÄi durumda AyrÄ±k GKD ile baÅlatÄ±lan rÄ±za akÄ±ÅlarÄ±nda HHS tarafÄ±ndan  \"TR.OHVPS.Business.CustomerMobileApplicationNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. YÃS ilgili iÅlemi âYÃ¶nlendirmeliâ akÄ±Åa Ã§ekip sÃ¼reci ilerletebilir. \n HHS kimlik bilgisi ile gÃ¶nderen Ã¼nvanÄ±nÄ±n uyumlu olduÄunu kontrol eder. HHS'ler EFT/FAST iÅlemlerinde kabul ettikleri kontrol kriterleri ile iÅleme izin verebilirler. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Business.IncorrectSenderTitle\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n GÃ¶nderen Hesap NumarasÄ± ÃBHS tarafÄ±ndan iletildiÄi durumda;\n \n IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.InvalidAccount\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼) kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountCodeMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.CustomerAccountMismatch\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. (Ä°lgili hesabÄ±n para transfer iÅlemine yetkisi olmamasÄ±) Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountUnauthorized\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHSâde gÃ¶nderen hesabÄ±n aktifliÄi kontrol edilir. Kontrollere istinaden hata oluÅmasÄ± durumunda   \"TR.OHVPS.Business.AccountInactive\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n GÃ¶nderen Hesap NumarasÄ± iÃ§in, He

16sap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir. EÄer aktif bir rÄ±zasÄ± yok ise  \"TR.OHVPS.Business.ActiveConsentNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Hesap bakiye kontrolÃ¼nÃ¼n rÄ±za aÅamasÄ±nda yapÄ±lmamasÄ± gerekmektedir. ÃÃ¼nkÃ¼ ÃHK Ã¶deme emri gerÃ§ekleÅene kadar hesabÄ±na para eklemesi yapabilir. \n AlÄ±cÄ± ve gÃ¶nderen hesabÄ±n aynÄ± olmasÄ± durumunda  âTR.OHVPS.Business.SenderRecipientSameâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n MÃ¼Återinin kendi hesaplarÄ± arasÄ±nda talimat veremeyeceÄi durumlarÄ±n kontrolÃ¼ iÃ§in  âTR.OHVPS.Business.SameAccountTransferRestrictedâ  hatasÄ± dÃ¶nmesi beklenmektedir. Bu hata HHS insiyatifindedir. \n \n Tek Seferlik Ãdeme \n \n Tek seferlik Ã¶deme akÄ±ÅÄ± YÃS'ten HHS'ye giden istekte, gÃ¶nderen kimlik bilgilerinin olmadÄ±ÄÄ± durumda gerÃ§ekleÅir. GÃ¶nderen kimlik bilgisi olmadÄ±ÄÄ±nda, KOLAS sorgusu yapÄ±lamayacaÄÄ±ndan Ã¶tÃ¼rÃ¼, HHS tarafÄ±ndan  \"TR.OHVPS.Resource.OneTimePaymentNotSupport\"  hatasÄ± dÃ¶nÃ¼lmelidir. ÃHK'nÄ±n YÃS'Ã¼n mÃ¼Återisi olmadÄ±ÄÄ± durumda tek seferlik Ã¶deme baÅlatÄ±labilir. \n Tek seferlik Ã¶deme akÄ±ÅÄ± hem iÅyeri Ã¶demelerinde hem de kiÅiden kiÅiye para transferlerinde kullanÄ±labilen bir akÄ±ÅtÄ±r. Ä°Åyeri tarafÄ±ndan baÅlatÄ±lan tek seferlik Ã¶deme iÅlemlerinde katÄ±lÄ±mcÄ±lar gÃ¶nderen ÃHK'dan Ã¼cret alÄ±namaz. \n Tek seferlik Ã¶deme akÄ±ÅÄ± sadece bireysel mÃ¼Återiler iÃ§in kullanÄ±labilir. Kurumsal mÃ¼Återi ile Ã¶deme emri baÅlatÄ±lmasÄ± durumunda  \"TR.OHVPS.Resource.OneTimePaymentNotSupport\"  hatasÄ± dÃ¶nÃ¼lÃ¼r.\nTek seferlik Ã¶deme akÄ±ÅÄ±nda hem yÃ¶nlendirmeli hem de ayrÄ±k GKD akÄ±ÅÄ± ile mÃ¼Återi yetkilendirmesi saÄlanabilir. \n AÅaÄÄ±daki senaryolar tek seferlik Ã¶demeye Ã¶rnek olarak gÃ¶sterilebilir. \nÄ°Åyeri Ãdemesi akÄ±ÅÄ± Ã¶rneÄi: Bir e-ticaret sitesinde, Ã¼ye olmadan alÄ±ÅveriÅ yapÄ±lmasÄ± ve Ã¶demenin YÃS tarafÄ±ndan kimlik bilgisi olmadan baÅlatÄ±lmasÄ± \nKiÅiden kiÅiye para transferi akÄ±ÅÄ± Ã¶rneÄi: QR veya diÄer yÃ¶ntemler ile alÄ±cÄ± bilgilerinin gÃ¶nderici ile paylaÅÄ±lmasÄ± ve YÃS Ã¼zerinden gÃ¶nderici bilgileri olmadan alÄ±cÄ±ya para transferi yapÄ±lmasÄ± iÃ§in rÄ±za verilmesi \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra HHS, Ã¶deme iÃ§in benzersiz âRizaNoâ ile âOdemeEmriRizasiâ nesnesi oluÅturur ve ÃBHSâye dÃ¶ner.  HHS, OdemeEmriRizasi oluÅturduÄu anda durumunu âYetki Bekleniyorâ olarak dÃ¼zenler. \n Tek seferlik Ã¶deme iÅlemlerinde (gÃ¶nderen kimlik bilgilerinin boÅ olduÄu durumda) ileri tarihli ve dÃ¼zenli Ã¶deme emri rÄ±zasÄ± baÅlatÄ±labilir; ancak bu iÅ modelleri hizmete sunulmadan Ã¶nce BKM ile paylaÅÄ±lmalÄ± ve onayÄ± alÄ±nmalÄ±dÄ±r. \n POST /odeme-emri-rizasi  isteÄinin (REQUEST) gÃ¶vdesinde (BODY)  âodemeEmriRizasiIstegiâ nesnesi (Tablo-7) kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda âodemeEmriRizasiâ (Tablo-8) nesnesi oluÅturulur. \n  BAÅARILI Ä°STEK: \n Tablo 7: âOdemeEmriRizasiIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri rÄ±zasÄ± oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Ä° \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. Yetkilendirme yÃ¶ntemi, ÃBHS tarafÄ±ndan belirtilmeyebilir. \n HHS, HBHSânin belirlediÄi yÃ¶ntemi dikkate alarak sÃ¼reci ilgili akÄ±Åa uygun olarak devam ettirir. DesteklemediÄi yÃ¶ntem iÃ§in (Ã¶rn: AyrÄ±k GKD) ayrÄ±ca hata mesajÄ± verilmelidir. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu.  YÃSâÃ¼n ileteceÄi adrestir.  Durum ko

16du(drmKod), yÃ¶nlendirme adresine parametre olarak eklenmelidir. \n HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± bu alanda belirtilen adrese yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur.   HHS, YÃS'Ã¼n AYRIK_GKD_BASARILI ve AYRIK_GKD_BASARISIZ olay tipleri iÃ§in olay aboneliÄinin varlÄ±ÄÄ±nÄ± kontrol eder.  Bknz: AyrÄ±k GKD \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir.  TR.OHVPS.DataCode.ohkTanimTip  sÄ±ralÄ± veri tiplerinden birini alÄ±r. \n \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir. \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS geÃ§erli bir Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir.  Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r.  Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS geÃ§erli bir Kurum Kimlik NumarasÄ± TÃ¼rÃ¼ olduÄunu kontrol eder. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur.  HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kurum Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ±dÄ±r. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n girilmiÅ olduÄu Ã§apraz olarak kontrol edilir. \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir para birimi olduÄu kontrol eder. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.  Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen Ã¼nvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n HHSânin bu veri ile kendi sistemlerindeki verinin farklÄ± olmasÄ± ve Kimlik NumarasÄ± ile eÅleÅmemesi durumunda Ã¶deme emri baÅlatma isteÄi reddedilir.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.  Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir. Hesap referansÄ± ile Ã¶deme emri rÄ±zasÄ± baÅlatÄ±lacak ise HHS hesap referansÄ± deÄeri ile iliÅkilendirilmiÅ mevcut bir hesap bilgisi rÄ±zasÄ± var mÄ± kontrol etmelidir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n ÃBHS tarafÄ±ndan iletildiÄi durumda; IBAN iÃ§erisindeki HHS kodunun istek baÅlÄ±ÄÄ±ndaki HHS kodu ile aynÄ± olduÄu (hesabÄ±n HHSâye aitliÄinin kontrolÃ¼), IBANâÄ±n doÄruluÄu (kontrol basamaÄÄ± doÄrulamasÄ±), Hesap numarasÄ±nÄ±n ÃHKâya ait olduÄu, HHSâye Ã¶zel Ã¶deme izni verilmeyen farklÄ± statÃ¼lerin bulunmasÄ± durumu kontrol edilir. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.  Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan HHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n HspRef'e baÄlÄ± IBAN deÄiÅtiÄinde yeni IBAN'Ä±n da ilgili HspRef ile iliÅkilendirilmesi beklenmektedir. Bu durumda, HBHS, Hs

16pRef ile sorguya geldiÄinde HHS'nin yeni IBAN ve hesap hareketlerini dÃ¶nebilmesi mÃ¼mkÃ¼n olacaktÄ±r. HspRefâin, IBAN deÄiÅtiÄinde deÄiÅtirilmemesi tavsiye edilmektedir. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  AlÄ±cÄ±nÄ±n Ã¼nvanÄ±dÄ±r. ÃBHS ekranlarÄ±ndan giriÅi yapÄ±labileceÄi gibi ÃBHSânin kayÄ±tlÄ± alÄ±cÄ±larÄ±ndan yapÄ±lan seÃ§imle de doldurup gÃ¶nderebildiÄi bilgi olabilir.  FAST-TR Karekod Veri Organizasyonunda;  Ä°Åyeri tarafÄ±ndan sunulan uzun karekod yapÄ±sÄ±nÄ±n  59:  alanÄ±nda tanÄ±mlÄ± Ä°Åyeri adÄ± alanÄ±dÄ±r, KiÅiden KiÅiye Ãdeme Karekod YapÄ±sÄ±nÄ±n  07:  alanÄ±nda tanÄ±mlÄ±    Ãdeme AlÄ±cÄ±sÄ±nÄ±n AdÄ± ve SoyadÄ±  alanÄ±dÄ±r.  FAST-TR Karekod dÄ±ÅÄ±ndaki iÅ yeri Ã¶demelerinde; yine Ã¼nvan alanÄ±nda iÅyeri adÄ± bilgisi gÃ¶nderilmelidir. \n \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± (IBAN)  alanÄ±dÄ±r.   Kolay Adres Sistemi  kullanÄ±lmÄ±yorsa zorunludur.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  30-01:  alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r.  AlÄ±cÄ±nÄ±n birden fazla hesabÄ±nÄ±n kullanÄ±labilir olduÄu durumlarda (Ã¶zellikle iÅyeri Ã¶demelerinde HHS nezdindeki hesap (on-us havale akÄ±ÅÄ±) tercih edilmelidir. \n HHS (GÃ¶nderen KatÄ±lÄ±mcÄ±) tarafÄ±ndan IBAN doÄrulamasÄ± (kontrol basamaÄÄ± doÄrulamasÄ±) yapÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n Tek seferlik Ã¶demelerde ( kimlik bilgileri boÅ iletildiÄinde) KOLAS nesnesi dolu iletiliyorsa; HHS tarafÄ±ndan hata dÃ¶nÃ¼lmelidir \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n HHS (GÃ¶nderen FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan KOLAS Servisine yapÄ±lan sorguda girdi olarak kullanÄ±lÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur.  Karekod ilke ve kurallar belgesinde tanÄ±mlandÄ±ÄÄ± Åekilde kullanÄ±lmasÄ± gerekmektedir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n HHS, YÃS'Ã¼n API deseninde \"O\" kodunu ilettiÄini kontrol eder. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n HHS geÃ§erli bir Ãdeme AmacÄ± kodu olduÄunu kontrol eder. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarÄ±nda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.   -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -\tÄ°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n YÃS bu deÄeri ÃHKâyÄ± HHSâye yÃ¶nlendirmeden Ã¶nceki ekranda gÃ¶stermeli, ve HHS bu deÄeri GKD iÃ§in kullandÄ±ÄÄ± Ã¶nyÃ¼zÃ¼nde âiÅlem doÄrulama kodununâ bir unsuru olarak yine ÃHKâya gÃ¶stermelidir. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi

16iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r.  Ä°Åyeri Ãdeme Bilgileri, YÃS uygulama Ã¶nyÃ¼zÃ¼nde ÃHKânÄ±n bildiÄi ve giriÅi yapÄ±lmasÄ± beklenen bir bilgi olmamalÄ±dÄ±r. YÃS tarafÄ±ndan sistemsel olarak doldurulmasÄ± gereklidir. \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir.  4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n  BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriRizasiâ nesnesi Tablo-8âdeki parametrelerden oluÅur: \n Tablo 8: âOdemeEmriRizasiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n > GÃ¼ncellenme ZamanÄ± \n gnclZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin gÃ¼ncellenme zamanÄ± \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n > RÄ±za Iptal Detay Kodu \n rizaIptDtyKod \n AN2 \n K \n RÄ±za durumunun iptal olduÄu durumda zorunludur. AlabileceÄi deÄerler 4. BÃ¶lÃ¼mde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  HHS, ÃBHSânin belirlediÄi yÃ¶ntemi dikkate alarak kendi belirlediÄi yÃ¶ntemi kullanÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n \n \n \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   HHS tarafÄ±ndan maksimum 5 dk iÃ§inde iÅlem tamamlanacak Åekil zaman damgasÄ± oluÅturulur. Zaman aÅÄ±mÄ± olduÄunda HHSânin GKDâye izin vermeyecek Åekilde hata mesajÄ± vermesi gerekmektedir.  RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n K \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n K \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >>

16 Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Ä° \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n K \n GÃ¶nderenin Ã¼nvanÄ±dÄ±r.  HHS, bu bilgiyi ÃBHS sisteminden gelen veri yerine FASTâa iletirken kendi sisteminden alabilir.   Tek seferlik Ã¶deme dÄ±ÅÄ±nda YÃS'Ã¼n gÃ¶nderen Ã¼nvanÄ±nÄ± gÃ¶ndermesi zorunludur. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Ä° \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden daha Ã¶nce kayÄ±t altÄ±na alÄ±nmÄ±Å hesaplar arasÄ±ndan seÃ§tirdiÄi veya mÃ¼Återiye girdiÄi IBANâdÄ±r.  ÃBHS tarafÄ±ndan iletilmediÄi durumda, gÃ¶nderen hesap bilgisini mÃ¼Återi tarafÄ±ndan HHSânin dijital kanalÄ±nda GKD sonrasÄ±nda seÃ§ilebilir. Bu amaÃ§la ÃBHS arayÃ¼zÃ¼nde HHS seÃ§tirilmelidir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap NumarasÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap ReferansÄ± kullanÄ±lÄ±yorsa Hesap NumarasÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n Ä° \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid). YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez.  ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir.   GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir.    Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.    Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilip doÄrulanan veya Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len alÄ±cÄ± maskeli IBAN bilgisidir. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n TR.OHVPS.DataCode.KareKodAksTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ±  gÃ¶sterir. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 62-08: alanÄ±nda tanÄ±mlÄ± Ãdeme AmacÄ± verisi kullanÄ±lÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisidir. Bu alan ileri vadeli Ã¶demeler iÃ§in dÃ¼ÅÃ¼nÃ¼lmÃ¼ÅtÃ¼r. Ä°lk fazda doldurulmasÄ±na gerek olmadÄ±ÄÄ± dÃ¼ÅÃ¼nÃ¼lmektedir. \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.3.\tADIM 2- Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n   \n Åekil 6: Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi \n ÃBHS, ÃHKânÄ±n Ã¶deme emrini yetkilendirmesi isteÄini iletir. Ãdeme emrinin yetkilendirilmesi, HHS tarafÄ±ndan gerÃ§ekleÅtirilen YÃ¶nlendirme veya AyrÄ±k GKD yÃ¶ntemiyle yapÄ±lÄ±r. \n \n \n YÃ¶nlendirmeli doÄrulama akÄ±ÅÄ±nda , ÃBHS ÃHKâyÄ± HHSâye yÃ¶nlendirir. \n \n ÃBHS tarafÄ±ndan yÃ¶nlendirme, bir Ã¶nceki adÄ±mdaki RizaNoâyu iÃ§erir. \n YÃ¶nlendirmenin RizaNoâyu iÃ§ermesi sayesinde, HHS hangi Ã¶deme emriyle iliÅkili olarak yÃ¶nlendirme yapÄ±ldÄ±ÄÄ±nÄ± iliÅkilendirebilir. \n HHS, ÃHK iÃ§in GKD sÃ¼recini iÅletir. \n \n ÃHKâyÄ± doÄrularsa, \n \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§lu hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n HHS, ÃHKâyÄ± âolumlu yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n \n \n \n yonAdr?rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n ÃHKâyÄ± doÄrulayamazsa, \n1. HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki Ä°ptalâ olarak gÃ¼nceller. \n2. HHS,

16ÃHKâyÄ± âolumsuz yÃ¶nlendirme akÄ±ÅÄ±â ile ÃBHS tarafÄ±ndan tanÄ±mlanan yÃ¶nlendirme adresine yÃ¶nlendirir: \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&drmKod=zzz\n \n HHS tarafÄ±nda oluÅabilecek bir hata durumunun YÃSâe aktarÄ±lmasÄ± gerektiÄi durumlar olabilir. Bu durumda yonlendirme adresinde hata kodu parametresi zorunlu olarak iletilmelidir. \nHata aÃ§Ä±klamalarÄ±nÄ±n neler olabileceÄi ve YÃSâÃ¼n kendi uygulamasÄ±nda bu hatayÄ± ne Åekilde gÃ¶stereceÄi aÅaÄÄ±da tariflenmiÅtir. \n yonAdr?rizaDrm=I&rizaNo=yy&rizaTip=O&rizaIptDtyKod=11&drmKod=zzz\n \n URLâde iletilen âRÄ±za Ä°ptal Detay Koduâ RÄ±za durumlarÄ± bÃ¶lÃ¼mÃ¼nde (4. BÃ¶lÃ¼m) belirtilen hata kodlarÄ± ile aynÄ± olacak Åekilde tasarlanmÄ±ÅtÄ±r. GKD sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontroller 5.3 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n \n AyrÄ±k doÄrulama akÄ±ÅÄ±nda , HHS, ÃHKânÄ±n Ã¶deme emrini baÅlattÄ±ÄÄ± uygulamadan farklÄ± olabilecek bir âdoÄrulamaâ uygulamasÄ±nda iÅlemi doÄrulamasÄ±nÄ± ister.\n \n AyrÄ±k akÄ±Å ÃBHSânin farklÄ± bir kanal kullanarak yetkilendirme isteÄi gÃ¶ndermesiyle baÅlatÄ±lÄ±r. \n Bu yetkilendirme isteÄi, yetkilendirilecek Ã¶deme emri rÄ±zasÄ±nÄ±n eÅleÅtirileceÄi ÃHKânÄ±n bulunmasÄ± iÃ§in ilgili veriyi taÅÄ±r. \n HHS, ÃHKâyÄ± doÄrular. \n ÃHK -bir Ã¶nceki adÄ±mda seÃ§mediyse- borÃ§landÄ±rÄ±lacak hesabÄ±nÄ± seÃ§er. \n HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetkilendirildiâ olarak gÃ¼nceller. \n \n \n \n BaÅarÄ±lÄ± GKD sonrasÄ±nda (rizaDrm=âYâ) ilgili rÄ±za nesnesi iÃ§in (belirli bir rizaNo) yetkilendirme kodunun (yetKod) alÄ±nmasÄ±nÄ±n ardÄ±ndan eriÅim belirteci eriÅim adresine POST Ã§aÄrÄ±sÄ± yapÄ±larak yetkilendirme kodu karÅÄ±lÄ±ÄÄ±nda eriÅim belirteci ve yenileme belirteci alÄ±nÄ±r. POST /eriÅim-belirteci eriÅim noktasÄ± EK-3âte aÃ§Ä±klanmÄ±ÅtÄ±r. \n EriÅim belirteci alÄ±ndÄ±ktan sonra; HHS, Ã¶deme emri rÄ±za kaynaÄÄ±nÄ±n durumunu âYetki KullanÄ±ldÄ±â olarak gÃ¼nceller. \n 6.4.\tADIM 2.1 â Ãdeme Emri RÄ±zasÄ±nÄ±n SorgulanmasÄ± (isteÄe baÄlÄ±) \n   \n Åekil 7: âodemeEmriRizasiâ nesnesinin sorgulanmasÄ± (isteÄe baÄlÄ±) \n GKD iÅleminin baÅarÄ±yla tamamlanÄ±p Ãdeme Emri RÄ±zasÄ±nÄ±n yetkilendirilmesi esnasÄ±nda, gÃ¶nderen hesap seÃ§iminin HHS ekranÄ±nda yapÄ±ldÄ±ÄÄ± durumlar olabilir. Bu durumlarda Ã¶deme emri isteÄinde gÃ¶nderen hesap bilgileri alanÄ±nÄ±n zorunlu olmasÄ± nedeniyle,  OdemeEmriRizasi  nesnesi sorgulanarak gÃ¶nderen hesap bilgileri (hesap numarasÄ± ve/veya hesap referansÄ±) alÄ±nmalÄ±dÄ±r. HHS, â ADIM 2 -Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi â akÄ±ÅÄ±nda ÃHKânÄ±n hesaplarÄ± arasÄ±nda seÃ§im yapmasÄ±nÄ± ve seÃ§ilen hesap bilgisinin  OdemeEmriRizasi  nesnesine iÅler. \n GET /odeme-emri-rizasi/{RizaNo} \n ÃBHS, mevcut durumunu kontrol etmek iÃ§in, oluÅturulan bir  OdemeEmriRizasi  kaynaÄÄ±nÄ±n durumunu isteÄe baÄlÄ± olarak alabilir. \n \n Sorgulama yapÄ±lan Ã¶deme emri rÄ±zasÄ± HHS tarafÄ±nda bulunmuyor ise  \"TR.OHVPS.ResourceNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n Servis baÅarÄ±lÄ± yanÄ±tÄ±nda Tablo 8âde belirtilen \"OdemeEmriRizasi\" nesnesini dÃ¶nmektedir. \n Durum \n OdemeEmriRizasi  kaynaÄÄ± iÃ§in kullanÄ±labilecek durum gÃ¶stergeleri Åu Åekildedir: \n \n Yetki Bekleniyor \n Yetkilendirildi \n Yetki KullanÄ±ldÄ± \n Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ \n Yetki SonlandÄ±rÄ±ldÄ± \n Yetki Ä°ptal \n \n Ãdeme Emri RÄ±zasÄ± sonlandÄ±rÄ±ldÄ± ve iptal statÃ¼sÃ¼nde olan rÄ±za'larÄ±n gÃ¼ncellenme zamanÄ±ndan(gnclZmn) 6 ay sonrasÄ±na kadar sorgulanabilir olmasÄ± beklenmektedir. HHS'ler ilgili sÃ¼re sonrasÄ±nda yapÄ±lacak rÄ±za sorgularÄ±na \" TR.OHVPS.Resource.NotFound\"  uyarÄ±sÄ± verebilir. YÃS'ler tarafÄ±ndan iptal ve sonlandÄ±rÄ±ldÄ± statÃ¼sÃ¼nde olan rÄ±zalar iÃ§in sorgulama yapmamalÄ±dÄ±r. \n Ãdeme emri rÄ±za durum deÄiÅiklikleri 4.2 bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n BAÅARILI YANIT: \n GET /odeme-emri-rizasi/{RizaNo}  yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriRizasiÄ°stegiâ nesnesi kullanÄ±lÄ±r. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-8âde yer alan parametreleri iÃ§eren âOdemeEmriRizasiâ oluÅturulur. \n GÃ¶nderen Hesap Bilgisinin, ADIM 2 (Ãdeme Emri RÄ±zasÄ±nÄ±n Yetkilendirilmesi) sonrasÄ±nda HHS ekranÄ±ndan seÃ§ildiÄi akÄ±Åta âOdemeEmriRizasiâ nesnesi gÃ¼ncellenir ve ÃBHS  GET /odeme-emri-rizasi/{RizaNo}  isteÄi yaparak gÃ¼ncel gÃ¶nderen hesap bilgisi bilgisini de iÃ§eren âOdemeEmriRizasiâ nesnesini Ã§ekmelidir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±nda olmayan tek seferlik Ã¶deme iÅlemlerinde, Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgilerinin Ã¶deme emri rÄ±zasÄ± sÄ±rasÄ±nda gÃ¶nderimi zorunlu deÄildir. BaÅarÄ±lÄ± GKD sonrasÄ±, yani eriÅim belirteci alÄ±ndÄ±ÄÄ±nda, Ã¶deme emri oluÅmadan Ã¶nce, YÃSâÃ¼n Ã¶deme emri rÄ±zasÄ±nÄ± sorgulayarak bu bilgileri almasÄ± ve Ã¶deme emrini oluÅtururken Kimlik TÃ¼rÃ¼, Kimlik Verisi ve GÃ¶nderen Ãnvan alanlarÄ±nÄ± dolu olarak gÃ¶ndermesi beklenmektedir.  Ancak rÄ±za durumu âYetki Bekleniyor - Bâ, âYetkilendirildi - Yâ ve âYetki Ä°ptal - Iâ statÃ¼lerinde ise, Ã¶deme emri rÄ±zasÄ± sorgulamasÄ±nda, HHSânin Kimlik TÃ¼rÃ¼ ve Kimlik Verisi bilgisini Y

16ÃS ile paylaÅmamasÄ± gerekmektedir. \n 6.5.\tADIM 3- Ãdeme Emrinin OluÅturulmasÄ± \n   \n Åekil 8: Ãdeme Emrinin OluÅturulmasÄ± \n POST /odeme-emri \n ÃHKânÄ±n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama ile iÅlemi yetkilendirmesi sonrasÄ±nda, ÃBHS OdemeEmri kaynaÄÄ±nÄ± oluÅturur. \n Ãdeme emri (OdemeEmri) uygun Ã¶deme kaynaÄÄ±na POST isteÄi yapÄ±larak baÅlatÄ±lÄ±r. \n \n EriÅim Belirteci kontrolÃ¼ yapÄ±lÄ±r. GeÃ§erli bir EriÅim Belirteci yok ise  \"TR.OHVPS.Connection.InvalidToken\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS; istek mesajÄ±nda yer alan alanlarÄ±n ÃHVPS API Ä°lke ve KurallarÄ± dÃ¶kÃ¼manÄ±nda belirtilen ÅartlarÄ± saÄlayacak Åekilde zorunluluk, uzunluk ve iÃ§erik kontrollerini yapar. (Zorunlu) Kontrollere istinaden hata oluÅmasÄ± durumunda  \"TR.OHVPS.Resource.InvalidFormat\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidASPSPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. FarklÄ± olmasÄ± durumunda  âTR.OHVPS.Connection.InvalidTPPâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RÄ±za durumu kontrol edilir.\n \n B: Yetki Bekleniyor, Y: Yetkilendirildi  ya da E: Yetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼ ise  âTR.OHVPS.Resource.ConsentMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n I: RÄ±za Ä°ptal ya da S: Yetki SonlandÄ±rÄ±ldÄ± ise  âTR.OHVPS.Resource.ConsentRevokedâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n RizaDurumu âK: Yetki KullanÄ±ldÄ±â ise kontrollere devam edilir. \n \n \n POST /odeme-emri-rizasi ile POST /odeme-emri isteklerinde istek alanlarÄ±n aynÄ± olmasÄ± beklenmektedir. HHS tarafÄ±ndan kontrolÃ¼ saÄlanmalÄ±dÄ±r. Ãdeme emri rÄ±zasÄ±nda gÃ¶nderilen deÄerlerden farklÄ± bir deÄer gÃ¶nderildiÄi durumda  âTR.OHVPS.Business.FieldMismatchâ  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n HHS tarafÄ±ndan Ãdeme Emrinin OluÅturulmasÄ± API'sine istek yapÄ±ldÄ±ÄÄ±nda mÃ¼Återinin bakiyesi kontrol edilir. Bakiye yetersiz ise HHS tarafÄ±ndan  \"TR.OHVPS.Business.BalanceInsufficient\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. MÃ¼Återinin hesabÄ±nda bakiye olmasÄ± ancak gÃ¼nlÃ¼k iÅlem limitine takÄ±lmasÄ± durumunda ise  TR.OHVPS.Business.ExceededTransactionLimit  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n YukarÄ±daki kontroller tamamlandÄ±ktan sonra, iÃ§erisinde OdemeEmriNo ve OdemeEmriDurumu deÄiÅkenleri de bulunan OdemeEmri nesnesi ÃBHSâye dÃ¶ner ve RizaDurumu deÄiÅkenin deÄeri âYetki Ãdeme Emrine DÃ¶nÃ¼ÅtÃ¼â olarak gÃ¼ncellenir. \n \n POST verisindeki GÃ¶nderen Hesap NumarasÄ± ve AlÄ±cÄ± Hesap NumarasÄ±nÄ±n aynÄ± bankaya aitse HAVALE deÄilse FAST veya PÃS iÅ akÄ±ÅÄ±na geÃ§ilir. \n OdemeEmriDurumu âGerÃ§ekleÅtiâ / âGÃ¶nderildiâ / âGerÃ§ekleÅmediâ olarak gÃ¼ncellenir. \n \n BAÅARILI Ä°STEK: \n Tablo 9: âOdemeEmriIstegiâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n HHS tarafÄ±ndan Ã¶deme emri oluÅturulmasÄ± sÄ±rasÄ±nda yapÄ±lmasÄ± gereken kontrol ve iÅlemler \n FAST A01 PÃS M01 mesaj mapping \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ± \n \n \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n \n \n >Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n HHS, hhsKodâun kendisine ait olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-aspsp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n GÃ¶nderen katÄ±lÄ±mcÄ± kodu (yani bankanÄ±n FAST/PÃSâteki KatÄ±lÄ±mcÄ± kodu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n HHS, yosKodâun geÃ§erli bir Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu olduÄunu ve istek baÅlÄ±ÄÄ±ndaki x-tpp-code deÄeri ile aynÄ± olduÄunu kontrol eder. \n YosKod \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n \n \n >Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n \n \n >YÃ¶nlendirme Adresi \n yonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunludur. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n \n \n \n \n \n \n \n \n \n \n \n >AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n yetYntm = A gÃ¶nderilmiÅ ise ayrikGkd nesnesinin dolu gÃ¶nderilmesi zorunludur. yetYntm = Y iÃ§in bu nesne iletilmemelidir. \n \n \n \n >>OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >>OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n \n \n >HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n \n \n >Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik tÃ¼rÃ¼nÃ¼n bu alanda gÃ¶nderilmesi zorunludur. \n \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n ÃerÃ§eve sÃ¶zleÅme kapsamÄ±ndaki Ã¶demelerde kullanÄ±mÄ± zorunludur. HHS, ÃBHS tarafÄ±ndan iletilmesi durumunda Kimlik Verisi Ã¼zeriden Ã§apraz kontroller uygulamalÄ± ve Kimlik Verisini temel alarak GKD gerÃ§ekleÅtirmelidir. Ãdeme Emri RizasÄ± Nesnesindeki Kimlik NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. GerÃ§ek kiÅi tarafÄ±ndan yapÄ±lan Ã¶demelerde,

161. HHS, GÃ¶nderen AdÄ± ve GÃ¶nderen Hesap NumarasÄ±nÄ± Ã¶deme emri isteÄinde (Havale/FAST/PÃS) gÃ¶nderir. - GÃ¶nderen AdÄ± ve diÄer tÃ¼m mÃ¼Återi bilgileri, Kimlik NumarasÄ± Ã¼zerinden elde edillir. Pasaport numarasÄ±na iliÅkin kontroller HHS'nin halihazÄ±rda kullandÄ±ÄÄ± veri, akÄ±Å ve tabi olduÄu diÄer dÃ¼zenlemelerdeki iÅleyiÅ ile aynÄ± Åekilde ele alÄ±nmalÄ±dÄ±r. Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde, kurum adÄ±na iÅlem yapan kullanÄ±cÄ±nÄ±n kimlik verisi bu alanda gÃ¶nderilebilmesi zorunludur. \n GonKimN / Psp \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n Kurum adÄ±na yapÄ±lan (ticari) Ã¶demelerde kullanÄ±mÄ± zorunludur. Ãdeme Emri RizasÄ± Nesnesindeki Kurum Kimlik Verisi ile aynÄ± olmalÄ±dÄ±r. \n GonKimN / VKN \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n Kurum adÄ±na yapÄ±lan Ã¶demelerde K deÄerini alÄ±r. Kurum Kimlik TÃ¼rÃ¼ ve Kurum Kimlik Verisi alanlarÄ±nÄ±n giilmiÅ olduÄu Ã§apraz olarak kontrol edilir.  Ãdeme Emri RizasÄ± Nesnesindeki ÃHK TÃ¼rÃ¼ ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Para Birimi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.   Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n Ãdeme Emri RizasÄ± Nesnesindeki Ä°Ålem TutarÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS iÅlem tutarÄ± Ã¶deme mesajÄ±nda (Havale/FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n Ttr \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n HHS ve ÃBHS verisi tutarlÄ± olmalÄ±dÄ±r.  ÃBHS verisi ile HHS verisinin farklÄ±laÅmasÄ± durumunun ise risk deÄerlendirme sistemlerine girdi olarak kullanmasÄ± tavsiye edilir. \n GonAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS'nin Ã¶n yÃ¼zÃ¼nden seÃ§tirdiÄi/kullanÄ±cÄ±ya girdiÄi IBAN Hesap numarasÄ± ya da Hesap ReferansÄ± alanlarÄ±ndan en az birinin dolu olarak gelmesi gerekmektedir. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki GÃ¶nderen Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r. \n GonHesN \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅlatÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.   Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n YÃSâten alÄ±cÄ± ad soyad bilgisi geliyorsa ve HHS'nin kontrolÃ¼nden baÅarÄ±lÄ± bir Åekilde geÃ§ti ise HHS'nin tekrar alÄ±cÄ± ad soyad bilgisi iÃ§in giriÅ yaptÄ±rmasÄ±na gerek bulunmamaktadÄ±r. \n AlAd \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki AlÄ±cÄ± Hesap NumarasÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  Kontroller baÅarÄ±yla sonuÃ§lanÄ±rsa, bilgi FAST/PÃS AlHesN alanÄ±na doÄrudan aktarÄ±r ve FAST/PÃS Alan KatÄ±lÄ±mcÄ± Kodu (AlKK) olarak AlÄ±cÄ± HHS Kodu kullanÄ±lÄ±r.  KOLAS sorgusu sonucunda Ã¶deme emrinde iletilen maskeli bilgi ile HHSânin kendi Ã¶deme emri rÄ±zasÄ± isteÄinde tuttuÄu KOLAS sorgusundan dÃ¶nÃ¼len bilgi maskelenerek karÅÄ±laÅtÄ±rÄ±lÄ±r. EÄer aynÄ± deÄilse uygun hata kodu dÃ¶nÃ¼lerek iÅlem sonlandÄ±rÄ±lÄ±r. \n AlHesN \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres Tipi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± YanÄ±tÄ± Nesnesindeki Kolay Adres DeÄeri verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST (KolasRef) \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n KolasRef ( hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n Ãdeme Emri RizasÄ± Nesnesindeki Kare Kod AkÄ±Å TÃ¼rÃ¼ verisi ile aynÄ± olmalÄ±dÄ±r. \n FAST: KrkdAksTur \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n Ãdeme Emri RizasÄ± Nesnesindeki Karekod ReferansÄ± verisi ile aynÄ± olmalÄ±dÄ±r.  ÃevrimiÃ§i doÄrulama hizmeti alÄ±nmayan statik karekodlar iÃ§in Referans numarasÄ±nÄ±n bulunmadÄ±ÄÄ± durumlarda HHS tarafÄ±ndan âNONREFâ ifadesi girilir. \n FAST: Karekod ReferansÄ± (KrkdRef) \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR K

16arekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ deÄeri atanarak iletilmelidir. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme KaynaÄÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST/PÃS: OdmKynk \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme AmacÄ± verisi ile aynÄ± olmalÄ±dÄ±r. HHS tarafÄ±ndan Ã¶deme mesajÄ±nda (FAST/PÃS) aynen taÅÄ±nmak durumundadÄ±r. \n FAST (OdmAmc)/PÃS(OdmAmaci) \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  -Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Referans Bilgisi verisi ile aynÄ± olmalÄ±dÄ±r. \n RefBlg (Hem FAST hem de PÃS iÃ§in aynÄ±) \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n FAST/PÃS Acklm \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n Ãdeme Emri RizasÄ± Nesnesindeki Ãdeme Sistemi verisi ile aynÄ± olmalÄ±dÄ±r. \n \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda istekte yer alÄ±r.  Ä°Åyeri Ãdeme Bilgileri, YÃS uygulama Ã¶nyÃ¼zÃ¼nde ÃHKânÄ±n bildiÄi ve giriÅi yapÄ±lmasÄ± beklenen bir bilgi olmamalÄ±dÄ±r. YÃS tarafÄ±ndan sistemsel olarak doldurulmasÄ± gereklidir. \n \n \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). 4 karakterden kÃ¼Ã§Ã¼k deÄerlerin baÅÄ±na 0 eklenerek iletilmesi gereklidir. \n \n \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n \n \n \n \n \n BAÅARILI YANIT: \n POST iÅleminin RESPONSE gÃ¶vdesini (BODY) oluÅturan âOdemeEmriâ nesnesi Tablo-10âdaki parametrelerden oluÅur: \n Tablo 10: âOdemeEmriâ nesnesi \n \n \n \n Alan AdÄ± \n JSON Alan AdÄ± \n Format: Veri modeli Ä°smi \n Zorunlu / KoÅullu / Ä°steÄe baÄlÄ± \n AÃ§Ä±klama \n \n \n \n \n Riza Bilgileri \n rzBlg \n Kompleks: RizaBilgileri \n Z \n \n \n \n > RÄ±za No \n rizaNo \n AN1..128 \n Z \n OdemeEmriRÄ±zasi nesnesinin oluÅturulmasÄ± esnasÄ±nda HHS kaynak sunucusu tarafÄ±ndan atanan biricik tanÄ±mlayÄ±cÄ± \n \n \n > OluÅturma ZamanÄ± \n olusZmn \n ISODateTime \n Z \n OdemeEmriRizasi nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n > RÄ±za Durumu \n rizaDrm \n AN1 \n Z \n TR.OHVPS.DataCode.RizaDurumu  sÄ±ralÄ± veri tipini deÄerlerinden birini alÄ±r. \n \n \n KatÄ±lÄ±mcÄ± Bilgisi \n katilimciBlg \n Kompleks:KatilimciBilgisi \n Z \n KatÄ±lÄ±mcÄ±lara atanmÄ±Å kod bilgileridir. \n \n \n >

16Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n hhsKod \n AN4 \n Z \n Ä°steÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n \n \n > Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± Kodu \n yosKod \n AN4 \n Z \n Ä°steÄi gÃ¶nderen Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur. \n \n \n GKD \n gkd \n Kompleks:Gkd \n Z \n \n \n \n > Yetkilendirme YÃ¶ntemi \n yetYntm \n AN1 \n Z \n TR.OHVPS.DataCode.GkdTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n > YÃ¶nlenme Adresi \n yonAdr \n AN1..1024 \n Z \n YÃ¶nlendirmeli gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. HHS, mÃ¼Återi uygulama / tarayÄ±cÄ±sÄ±nÄ± yÃ¶nlendirmeli akÄ±Åta bu alanda belirtilen YÃS adresine yÃ¶nlendirir. \n \n \n > AyrÄ±k GKD \n ayrikGkd \n Kompleks:AyrikGkd \n K \n AyrÄ±k gÃ¼Ã§lÃ¼ kimlik doÄrulama iÃ§in zorunlu. \n \n \n >> OHK TanÄ±m Tip \n ohkTanimTip \n AN8 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m tipleridir. Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n >> OHK TanÄ±m DeÄer \n ohkTanimDeger \n AN1..30 \n K \n ÃHK'nÄ±n HHS uygulamasÄ± tarafÄ±ndan tanÄ±nmasÄ±nÄ± saÄlayacak tanÄ±m deÄeridir. ohkTanimTip'i ile uyumlu deÄerdir.  Ä°stek iÃ§erisindeki veri deÄiÅtirilmeden iletilir. \n \n \n > HHS YÃ¶nlenme Adresi \n hhsYonAdr \n AN1..1024 \n K \n YÃ¶nlendirmeli akÄ±Å tÃ¼rÃ¼nde GKD doÄrulama bilgilerinin girilebilmesi iÃ§in uygulamadan aÃ§Ä±lacak yÃ¶nlendirme sayfasÄ±nÄ±n adresi. AyrÄ±k GKD akÄ±ÅÄ±nda bu alan dÃ¶nÃ¼lmemelidir. \n \n \n > Yetkilendirme Tamamlanma ZamanÄ± \n yetTmmZmn \n ISODateTime \n Z \n Yetkilendirme akÄ±ÅÄ±nÄ±n tamamlanmasÄ± gereken son zamanÄ± gÃ¶sterir.   RÄ±za durumu Yetkilendirildi statÃ¼sÃ¼ne geÃ§ene kadarki sÃ¼redir. \n \n \n Emir Bilgileri \n emrBlg \n Kompleks: EmirBilgileri \n Z \n \n \n \n > Ãdeme Emri NumarasÄ± \n odmEmriNo \n AN1..128 \n Z \n odemeEmri nesnesinin UID'sidir. OdemeEmrine Ä°liÅkin sorgular bu ID Ã¼zerinden yapÄ±lÄ±r. \n \n \n > Ãdeme Emri Zaman \n odmEmriZmn \n ISODateTime \n Z \n odemeEmri nesnesinin oluÅturulma zamanÄ±dÄ±r. \n \n \n Ãdeme BaÅlatma \n odmBsltm \n Kompleks: OdemeBaslatma \n Z \n \n \n \n > Kimlik \n kmlk \n Kompleks:Kimlik \n Z \n \n \n \n >> Kimlik TÃ¼rÃ¼ \n kmlkTur \n AN1 \n Z \n TR.OHVPS.DataCode.KimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kimlik Verisi \n kmlkVrs \n AN1..30 \n Z \n HHS nezdinde kullanÄ±cÄ± doÄrulamasÄ±nda kullanÄ±lan tanÄ±mlayÄ±cÄ±dÄ±r. TR.OHVPS.DataCode.KimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Kurum Kimlik TÃ¼rÃ¼ \n krmKmlkTur \n AN1 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik tÃ¼rÃ¼dÃ¼r. TR.OHVPS.DataCode.KurumKimlikTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r. \n \n \n >> Kurum Kimlik Verisi \n krmKmlkVrs \n AN1..30 \n K \n Kurum adÄ±na yapÄ±lan Ã¶demelerde ÃHKânÄ±n altÄ±nda tanÄ±mlÄ± olduÄu tÃ¼zel kiÅilik iÃ§in kullanÄ±lan kurum kimlik verisidir.   TR.OHVPS.DataCode.KurumKimlikTur  deÄerine gÃ¶re uzunluk ve formatÄ± deÄiÅir. \n \n \n >> Ãdeme Hizmeti KullanÄ±cÄ±sÄ± TÃ¼rÃ¼ \n ohkTur \n AN1 \n Z \n TR.OHVPS.DataCode.OhkTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r  (B: Bireysel, K:Kurumsal) \n \n \n > Ä°Ålem TutarÄ± \n islTtr \n Kompleks:Tutar \n Z \n \n \n \n >> Para Birimi \n prBrm \n AN3 \n Z \n Para Birimi.  Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  53: (Para Birimi)  alanÄ±nda tanÄ±mlÄ± Para Birimi verisi kullanÄ±lÄ±r. \n \n \n >> Tutar \n ttr \n AN1..24 \n Z \n ÃBHS'nin Ã¶n yÃ¼zde kullanÄ±cÄ±dan teyit aldÄ±ÄÄ± tutar.   Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  54: (Tutar)  alanÄ±nda tanÄ±mlÄ± Tutar verisi kullanÄ±lÄ±r.    Tutar alanÄ± regex patterni Åu Åekildedir: '^\\d{1,18}$|^\\d{1,18}\\.\\d{1,5}$' \n \n \n > GÃ¶nderen \n gon \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n GÃ¶nderen kiÅinin ad soyad ya da ticari Ã¼nvan bilgisi. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n K \n ÃBHS tarafÄ±ndan iletilip doÄrulanan veya HHS ekranÄ±nda seÃ§ilen GÃ¶nderen Hesap NumarasÄ± dÃ¶nÃ¼lÃ¼r. \n \n \n >> Hesap ReferansÄ± \n hspRef \n AN5..40 \n K \n HHS tarafÄ±ndan hesap iÃ§in atanan biricik tanÄ±mlÄ±yÄ±cÄ±dÄ±r (uuid)  YÃS bazÄ±nda farklÄ±laÅmasÄ± gerekmez. ÃBHSânin aynÄ± zamanda HBHS olduÄu durumda mÃ¼Återi rÄ±zasÄ± tesis edilmiÅ bir hesabÄ±n referansÄ± Ã¼zerinden de Ã¶deme baÅaltÄ±labilir. GKD sonrasÄ± HHS ekranÄ±nda seÃ§ilen Hesap ReferansÄ± POST iÅleminin yanÄ±tÄ±nda dÃ¶nÃ¼lemez ancak isteÄe baÄlÄ± GET sorgusu ile dÃ¶nÃ¼lebilir. Hesap NumarasÄ± kullanÄ±lÄ±yorsa Hesap ReferansÄ± kullanÄ±lmayabilir.  Ãdeme Sistemine doÄrudan katÄ±lÄ±mcÄ± olmayan ÃHS'ler mÃ¼Återilerine IBAN sunmadÄ±klarÄ± iÃ§in hspRef Ã¼zerinden Ã¶deme baÅlatabilirler. Bu durumda hesap numarasÄ± boÅ olacaktÄ±r. \n \n \n > AlÄ±cÄ± \n alc \n Kompleks:Hesap \n Z \n \n \n \n >> Ãnvan \n unv \n AN3..140 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ±

16sorgu sonucunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli ad-soyadÄ± veya maskeli ticari Ã¼nvan bilgisidir. Kolasâtan dÃ¶nen âaccount ownerâ alanÄ± kullanÄ±lmalÄ±dÄ±r. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen Ã¼nvan bilgisidir. \n \n \n >> Hesap NumarasÄ± \n hspNo \n AN26 \n Z \n AlÄ±cÄ±nÄ±n Hesap NumarasÄ± alanÄ±dÄ±r (IBAN). Kolay Adres  sorgusunda dÃ¶nÃ¼len adres kaydÄ± yaptÄ±rmÄ±Å olan alÄ±cÄ±nÄ±n maskeli IBAN bilgisidir. Kolay adres deÄil ise ÃBHS tarafÄ±ndan istek mesajÄ±nda iletilen IBAN bilgisidir. Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki 30-01: alanÄ±nda tanÄ±mlÄ± Ä°Å Yeri IBAN verisi kullanÄ±lÄ±r. \n \n \n >> Kolay Adres \n kolas \n Kompleks:Kolas \n K \n \n \n \n >>> Kolas TÃ¼rÃ¼ \n kolasTur \n AN1 \n Z \n MÃ¼Återinin sorgulamak istediÄi Kolay Adres Tipi deÄeridir.  TR.OHVPS.DataCode.KolasTur  sÄ±ralÄ± veri tÃ¼rÃ¼ deÄerlerinden birini alÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas DeÄeri \n kolasDgr \n AN7..50 \n Z \n MÃ¼Återinin eklediÄi, HHS (FAST katÄ±lÄ±mcÄ±sÄ±) tarafÄ±ndan doÄrulanmÄ±Å Kolay Adres deÄeridir. AlabileceÄi deÄerler BKM âKolay Adresleme Sistemi Uygulama KurallarÄ±â belgesinde tanÄ±mlÄ±dÄ±r.  AlÄ±cÄ± Hesap NumarasÄ± girilmediyse kullanÄ±mÄ± zorunludur ve  Kolay Adres Tipi  alanÄ±yla birlikte kullanÄ±lÄ±r. \n \n \n >>> Kolas Referans NumarasÄ± \n kolasRefNo \n N12 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± KOLAS tarafÄ±ndan ilgili sorguya Ã¶zel olarak Ã¼retilmiÅ referans numarasÄ±dÄ±r. \n \n \n >>> Kolas Hesap TÃ¼rÃ¼ \n kolasHspTur \n AN1 \n Z \n Kolay Adres AlÄ±cÄ± Sorgusunda baÅarÄ±lÄ± sorgu sonucunda dÃ¶nÃ¼len, BKM Kolay Adresleme Sistemi Uygulama KurallarÄ±ânda tanÄ±mlÄ± hesap tÃ¼rÃ¼ bilgisidir:   TR.OHVPS.DataCode.KolasHspTur  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n > Karekod \n kkod \n Kompleks:Karekod \n K \n \n \n \n >> AkÄ±Å TÃ¼rÃ¼ \n aksTur \n AN2 \n Z \n Karekod AkÄ±Å TÃ¼rÃ¼ Karekod Ã¶demesinin hangi akÄ±Åla gerÃ§ekleÅtirildiÄini gÃ¶sterir.  Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz.  01: FAST katÄ±lÄ±mcÄ±sÄ±ndan dinamik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi  02: FAST katÄ±lÄ±mcÄ±sÄ±ndan statik doÄrulama hizmeti alÄ±nan iÅyeri Ã¶demesi 03: KiÅiden kiÅiye Ã¶demeler \n \n \n >> ReferansÄ± \n kkodRef \n AN1..12 \n K \n Karekod referans numarasÄ±nÄ± gÃ¶sterir.  Okunan karekodda referans deÄeri varsa kullanÄ±lmasÄ± zorunludur. Kolay Adresi Sistemi ile birlikte kullanÄ±lmaz. \n \n \n >> Ãretici Kodu \n kkodUrtcKod \n AN4 \n Z \n Karekod Ã¼reticisinin kodu.  Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ± ve TCMB tarafÄ±ndan uygun gÃ¶rÃ¼len Ã¶deme sistemi iÅleticisi TR Karekod Ã¼retebilmek iÃ§in BKMâye kayÄ±t baÅvurusu yaparak karekod Ã¼retici kodu alabileceklerdir. Bankalar EFT kodlarÄ±nÄ± kullanacak olup ayrÄ±ca kayÄ±t yaptÄ±rmalarÄ±na gerek bulunmamaktadÄ±r. 4 haneden kÄ±sa deÄerlerin sol tarafÄ± â0â karakteri ile tamamlanmalÄ±dÄ±r. \n \n \n > Ãdeme AyrÄ±ntÄ±larÄ± \n odmAyr \n Kompleks: OdemeAyrintilari \n Z \n \n \n \n >> Ãdeme KaynaÄÄ± \n odmKynk \n AN1 \n Z \n Ãdemenin baÅlatÄ±ldÄ±ÄÄ± kaynaÄÄ± belirtir.  TR.OHVPS.DataCode.OdemeKaynak  sÄ±ralÄ± veri deÄerlerinden âOâ  deÄerini alÄ±r. âOâ deÄeri âAÃ§Ä±k bankacÄ±lÄ±k aracÄ±lÄ±ÄÄ± ile gÃ¶nderilen Ã¶demelerde kullanÄ±lÄ±r.â anlamÄ±nÄ± taÅÄ±maktadÄ±r. \n \n \n >> Ãdeme Durumu \n odmDrm \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeDurumu  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r.      Ãdeme Durumu alanÄ± ile ilgili olarak HHSâler tarafÄ±ndan YÃSâlere  OdemeEmri servisi yanÄ±tÄ±nda 02:GÃ¶nderildi, 04:Onayda Bekliyor,05:Ä°Åleme AlÄ±ndÄ± yanÄ±tlarÄ± gÃ¶nderilebilir.   05:Ä°Åleme AlÄ±ndÄ±  durumu YÃS tarafÄ±ndan mÃ¼Återiye gÃ¶sterilmeyen bir koddur. Bu kod dÃ¶nÃ¼ldÃ¼ÄÃ¼nde YÃS uygulamasÄ±nda ÃHKâya Ã¶deme durumu  02:GÃ¶nderildi  olarak gÃ¶sterilir. Ä°Ålemin son durumunun teyidi iÃ§in YÃS Ã¶deme emri sorgulamasÄ± yapmalÄ±dÄ±r.   02:GÃ¶nderildi  durumu oluÅtuktan sonra YÃS tarafÄ±ndan Ã¶deme emri sorgulamasÄ± yapÄ±larak Ã¶deme durumunun gÃ¼ncel deÄeri Ã¶Ärenilir. GÃ¼ncel deÄerler  01:GerÃ§ekleÅti,03:GerÃ§ekleÅmedi  durumlarÄ± olabilir. \n \n \n >> Ãdeme AmacÄ± \n odmAmc \n AN2 \n Z \n TR.OHVPS.DataCode.OdemeAmaci  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Referans Bilgisi \n refBlg \n AN1..140 \n K \n Ãdemeye Ã¶zel  Referans Bilgisi  alanÄ±dÄ±r. Karekod iÅlemi deÄil ise zorunludur.  -\tKiÅiden kiÅiye fon aktarÄ±mlarda: GÃ¼n iÃ§erisinde ÃHK Ã¶zelinde, her iÅleme Ã¶zel biricik olarak oluÅturulan referans bilgisidir.  Karekod P2P akÄ±ÅÄ± iÃ§in referans bilgisi (Karekod referans numarasÄ± deÄil, iÅleme Ã¶zel Ã¼retilecek referans bilgisidir.) YÃS tarafÄ±ndan atanacaktÄ±r.  -\tE-ticaret iÅlemlerinde sipariÅ/takip numarasÄ±/mÃ¼Återi/abone numarasÄ±  - Ä°Åyeri Ãdemesi Karekod akÄ±ÅÄ±nda, FAST Karekod Veri Organizasyonundaki  -\t62-01: alanÄ±nda tanÄ±mlÄ± Fatura NumarasÄ±   -\t62-06: alanÄ±nda tanÄ±mlÄ± MÃ¼Återi NumarasÄ±   verilerinden biri kullanÄ±lÄ±r. \n \n \n >> AÃ§Ä±klama \n odmAcklm \n AN1..200 \n Ä° \n ÃBHSânin ÃHKâdan aldÄ±ÄÄ± ya da kendisinin atadÄ±ÄÄ± iÅlem aÃ§Ä±klamasÄ± bilgisi.  FAST/PÃS sistemi Ã¼zerinden yapÄ±lan Ã¶demeler iÃ§in aÃ§Ä±klama bilgisi girilirse boÅluk karakteri girilerek geÃ§ilemez. En az bir alfasayÄ±sal karakter girilmesi zorunludur. \n \n \n >> ÃHK Mesaj AlanÄ± \n ohkMsj \n AN1..200 \n Ä° \n HHSânin ÃHKâya gÃ¶stermek Ã¼zere ilettiÄi mesaj. \n \n \n >> Ãdeme Sistemi \n odmStm \n AN1 \n Z \n TR.OHVPS.DataCode.OdemeSistemi  sÄ±ralÄ± veri deÄerlerinden birini alÄ±r. \n \n \n >> Ãdeme Sistem NumarasÄ± \n odmStmNo \n AN10..50 \n K \n Ãdeme baÅarÄ±lÄ± baÅlatÄ±ldÄ±ysa, Ã¶demenin baÅlatÄ±ldÄ±ÄÄ± sistemdeki referans numarasÄ±. GerektiÄinde ilgili Ã¶deme sisteminde/HHSâde sÃ¶z konusu Ã¶demeye karÅÄ±lÄ±k gelen mesajla baÄlantÄ± kurmada kullanÄ±lÄ±r.   Ãdeme Hizmeti kullanÄ±cÄ±sÄ±na iÅlemin takibi iÃ§in gÃ¶sterilebilir.  Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi FAST ya da PÃS ise sistemdeki ilgili mesajÄ±n Tarih, GÃ¶nderenKatilimKodu ve SorguNumarasi deÄerlerinin birleÅiminden oluÅur. Bu 3 alan mevcutta kullanÄ±ldÄ±ÄÄ± formatta aralarÄ±na dikey Ã§izgi (Unicode U+2223) iÅareti koyularak, birleÅtirmeli ve iletilmelidir. Ãrn : Tarih|GÃ¶nderenKatilimKodu|SorguNumarasi   Ãdeme Havale/Virman iÅlemi ise HHSânin Ã¼retmiÅ olduÄu havale/virman numarasÄ±nÄ± iÃ§erir. Buradaki format da Tarih|GÃ¶nderenKatilimKodu|Havale-virman numarasÄ± Åeklinde olmalÄ±dÄ±r. Havale/FAST/PÃS  Ã¶deme yÃ¶ntemleri iÃ§in tarih alanÄ± yyyy-aa-gg formatÄ±nda 10 karakter olarak

16iletilmelidir. \n \n \n >> Beklenen Ãdeme ZamanÄ± \n bekOdmZmn \n ISODateTime \n K \n Ä°Ålemin yÃ¶nlendirildiÄi Ã¶deme sistemi PÃS ise ve PÃS iÅlem saatleri dÄ±ÅÄ±nda ise iÅlemin yapÄ±labileceÄi ilk zaman bilgisi \n \n \n Ä°Åyeri Ãdeme Bilgileri \n isyOdmBlg \n Kompleks:IsyeriOdemeBilgileri \n K \n Ä°Åyeri Ã¶demelerinde kullanÄ±labilecek alanlardÄ±r. Karekodlu iÅyeri Ã¶demesi akÄ±ÅÄ±nda bu alanlar dolu geldiÄi iÃ§in isteÄe baÄlÄ± olarak gÃ¶nderilebilir. isyOdmBlg alanlarÄ±nÄ±n en az birinin dolu olmasÄ± durumunda yanÄ±tta yer alÄ±r. \n \n \n > Ä°Åyeri Kategori Kodu \n isyKtgKod \n AN4 \n K \n Ä°Ålemin, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). Ãdeme AmacÄ± = â06â ya da â04â olan Ã¶deme iÅlemleri iÃ§in doldurulabilir. \n \n \n > Alt Ä°Åyeri Kategori Kodu \n altIsyKtgKod \n AN4 \n K \n Ä°Ålem alt iÅyerinden gerÃ§ekleÅtiriliyorsa, ISO 18245:2003 uyumlu Ä°Åyeri Kategori Kodudur (Merchant Category Code, MCC). \n \n \n >Ãye Ä°Å Yeri Tekil Kimlik \n genelUyeIsyeriNo \n AN8 \n K \n Ä°Åyeri kayÄ±t sisteminde kayÄ±tlÄ± Ä°Åyeri iÃ§in BKM tarafÄ±ndan Ã¼retilmiÅ olan genel iÅyeri numarasÄ±dÄ±r (GlobalMerchantId) 8 haneden kÃ¼Ã§Ã¼k gÃ¶nderiminde baÅa â0â eklenmelidir. Ãrnek deÄer â01630618â \n 6.6.\tADIM 3.1- Ãdeme Emri Sorgusu (Ä°steÄe baÄlÄ±) \n   \n Åekil 9: Ãdeme Emri Sorgusu \n GET /odeme-emri/{odemeEmriNo} \n ÃBHS, bu eriÅim adresi aracÄ±lÄ±ÄÄ±yla Ã¶deme emrini sorgulayabilir. \n BAÅARILI YANIT: \n GET /odeme-emri/{odemeEmriNo} yanÄ±tÄ±nÄ±n (RESPONSE) gÃ¶vdesinde (BODY)  âOdemeEmriâ nesnesi bulunur. Ä°stek baÅarÄ±yla sonuÃ§lanÄ±rsa HHS kaynak sunucusunda Tablo-10âda yer alan parametreleri iÃ§eren âOdemeEmriâ nesnesi dÃ¶ner. \n \n Ä°stek baÅlÄ±ÄÄ±nda yer alan X-Access-Token ile iliÅkili rÄ±zada, yer alan odemeEmriNo iÃ§in, Ã¶deme emri sorgusundaki odemeEmriNo bilgisinin aynÄ± olup olmadÄ±ÄÄ± kontrol edilir. FarklÄ± olmasÄ± durumunda  \"TR.OHVPS.Resource.NotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n Sorgulama yapÄ±lan Ã¶deme emri numarasÄ± HHS tarafÄ±nda bulunmuyor ise  \"TR.OHVPS.ResourceNotFound\"  hatasÄ± dÃ¶nÃ¼lÃ¼r. \n \n"},{frontmatter:{},regularPath:"/v2.0.1/deneyalani/duzenli-odeme-emri-api.html",relativePath:"v2.0.1/deneyalani/duzenli-odeme-emri-api.md",key:"v-2b804dc9",path:"/v2.0.1/deneyalani/duzenli-odeme-emri-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.1/contents/tanim-ve-kisitlamalar.html",relativePath:"v2.0.1/contents/tanim-ve-kisitlamalar.md",key:"v-666ae106",path:"/v2.0.1/contents/tanim-ve-kisitlamalar.html",content:"  1.\tTanÄ±m ve KÄ±saltmalar   \n Tablo 1: TanÄ±m ve KÄ±saltmalar \n \n \n \n KÄ±saltma \n TanÄ±m \n AÃ§Ä±klama \n Ä°ngilizce AÃ§Ä±klama \n Ä°ngilizce KÄ±saltma \n \n \n \n \n ÃS \n ÃerÃ§eve SÃ¶zleÅme \n Ãdeme hizmeti saÄlayÄ±cÄ±sÄ± ile mÃ¼Återi arasÄ±nda tekil veya sÃ¼reklilik arz eden Ã¶deme iÅlemlerinin yÃ¼rÃ¼tÃ¼lmesine ve mÃ¼mkÃ¼n olan durumlarda Ã¶deme hesabÄ±nÄ±n aÃ§Ä±lmasÄ±na iliÅkin usul ve esaslarÄ± belirleyen sÃ¶zleÅme \n \n \n \n \n EPK \n Elektronik Para KuruluÅu \n Kanun kapsamÄ±nda elektronik para ihraÃ§ etme yetkisi verilen tÃ¼zel kiÅi \n Electronic Money Institution \n EMI \n \n \n FAST \n FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi \n TCMB tarafÄ±ndan iÅletilen FonlarÄ±n AnlÄ±k ve SÃ¼rekli Transferi Sistemi \n \n \n \n \n FAST TR-Karekod \n FAST-TR Karekod Teknik Ä°lke ve Kurallar Rehberi \n TR Karekodâun FAST Sistemi aracÄ±lÄ±ÄÄ±yla gerÃ§ekleÅecek iÅlemlerde kullanÄ±lmasÄ±na iliÅkin detaylÄ± teknik ilke ve kurallarÄ±nÄ± iÃ§eren dokÃ¼man \n \n \n \n \n GEÃÄ°T \n BKM API GeÃ§idi \n BankalararasÄ± Kart Merkezi (BKM) tarafÄ±ndan geliÅtirilen ve taraflara standart AÃ§Ä±k BankacÄ±lÄ±k iÅlemleri sunulmasÄ±nÄ± saÄlayan API GeÃ§idi uygulamasÄ± \n \n \n \n \n GKD \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama \n Kimlik doÄrulamada kullanÄ±lan ve bir bileÅenin ele geÃ§irilmesinin diÄer bileÅenin gÃ¼venliÄini tehlikeye atmayacaÄÄ± en az iki bileÅenden oluÅan, bu iki bileÅenin de mÃ¼Återinin bildiÄi, sahip olduÄu veya biyometrik bir karakteristiÄi olan bileÅen sÄ±nÄ±flarÄ±ndan farklÄ± ikisine ait olacak Åekilde seÃ§ildiÄi yÃ¶ntem \n Strong Customer Authentication \n SCA \n \n \n Ä°B \n Ä°Ålem Bilgisi \n GerÃ§ekleÅtirilen iÅleme iliÅkin iÅlem zamanÄ±nÄ±, iÅlemin niteliÄini ve Ã¶deme iÅlemi iÃ§in Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve Ã¶demenin gÃ¶ndereni ile alÄ±cÄ±sÄ±nÄ± veya toplu Ã¶deme emrinin masraf, komisyon ve Ã¼cretler de dahil hesabÄ±n borÃ§landÄ±rÄ±lacaÄÄ± toplam tutarÄ±nÄ± ve gÃ¶ndereni ile alÄ±cÄ±larÄ±nÄ± iÃ§eren bilgi \n \n \n \n \n Ä°DK \n Ä°Ålem DoÄrulama Kodu \n Kimlik doÄrulama yÃ¶ntemlerinden biriyle kendisini sisteme tanÄ±tan bir mÃ¼Återinin gerÃ§ekleÅtirmek istediÄi

16iÅleme Ã¶zgÃ¼ olmak ve belirli bir geÃ§erlilik sÃ¼resi iÃ§inde iÅlem onayÄ±nda kullanÄ±lmak Ã¼zere oluÅturulan, finansal sonuÃ§ doÄrunan iÅlemlerde kiÅiye onay anÄ±nda ilgili iÅlem bilgisi (Ä°B) ile birlikte gÃ¶sterilen, alÄ±cÄ± veya tutarÄ±n deÄiÅmesiyle geÃ§ersiz hale gelen bilgi \n Authentication Code \n AC \n \n \n KOLAS \n Kolay Adresleme Servisi \n Fon transferlerinde hesap numarasÄ± ile ad soyad yerine kullanÄ±lan ve belirli bir hesap ile eÅleÅtirilmiÅ telefon numarasÄ±, e-posta adresi, T.C. Kimlik NumarasÄ± (TCKN), Vergi Kimlik NumarasÄ± (VKN), YabancÄ± Kimlik NumarasÄ± veya Pasaport NumarasÄ± gibi Kolay Adres bilgilerinin kaydedilmesini, gÃ¼ncellenmesini ve sorgulamasÄ±nÄ± saÄlayan katman servis \n \n \n \n \n HBHS \n Hesap Bilgisi Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (g) bendinde tanÄ±mlanan Ã¶deme hizmetini (hesap bilgisi hizmetini) sunan tÃ¼zel kiÅi \n Account Information Service Provider \n AISP \n \n \n HHS \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ± \n Nezdinde Ã¶deme hesabÄ± bulunan Ã¶deme hizmeti saÄlayÄ±cÄ±sÄ± \n Account Servicing Payment Service Provider \n ASPSP \n \n \n ÃBHS \n Ãdeme Emri BaÅlatma Hizmeti SaÄlayÄ±cÄ±sÄ± \n Kanunun 12 inci maddesinin birinci fÄ±krasÄ±nÄ±n (f) bendinde tanÄ±mlanan Ã¶deme hizmetini (Ã¶deme emri baÅlatma hizmetini) sunan tÃ¼zel kiÅi \n Payment Initiation Service Provider \n PISP \n \n \n ÃDK \n Ãdeme KuruluÅu \n Ãdeme hizmeti saÄlamak ve gerÃ§ekleÅtirmek iÃ§in Kanun kapsamÄ±nda yetkilendirilmiÅ tÃ¼zel kiÅi \n Payment Institution \n PI \n \n \n ÃH \n Ãdeme HesabÄ± \n Ãdeme hizmeti kullanÄ±cÄ±sÄ± adÄ±na aÃ§Ä±lan ve Ã¶deme iÅleminin yÃ¼rÃ¼tÃ¼lmesinde kullanÄ±lan hesap \n Payment Account \n PA \n \n \n ÃHK \n Ãdeme Hizmeti KullanÄ±cÄ±sÄ± (MÃ¼Återi) \n GÃ¶nderen, alÄ±cÄ± veya her ikisi sÄ±fatÄ±yla belirli bir Ã¶deme hizmetinden faydalanan gerÃ§ek veya tÃ¼zel kiÅi \n Payment Service User \n PSU \n \n \n ÃHS \n Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n 5411 sayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar, EPK, ÃDK ve Posta ve Telgraf TeÅkilatÄ± Anonim Åirketi(PTT) \n Payment Service Provider \n PSP \n \n \n ÃHVPS \n Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri \n Kanunun 12ânci maddesinin birinci fÄ±krasÄ±nÄ±n (f) veya (g) bentlerinde yer alan Ã¶deme hizmetlerinde kullanÄ±lan veri paylaÅÄ±m servisleri \n \n \n \n \n PÃS \n Perakende Ãdeme Sistemi \n TCMB tarafÄ±ndan iÅletilen, iÅlemlerin TÃ¼rk LirasÄ± Ã¼zerinden gerÃ§ekleÅtiÄi MÃ¼Återiler ArasÄ± TÃ¼rk LirasÄ± AktarÄ±m Sistemi \n \n \n \n \n TR-Karekod \n TR-Karekod Ä°lke ve KurallarÄ± \n Ulusal karekod (TR Karekod) ilke ve kurallarÄ±nÄ±n belirlendiÄi belge \n \n \n \n \n YÃS \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± \n Ãdeme emri baÅlatma hizmeti ve/veya hesap bilgisi hizmeti sunan tÃ¼zel kiÅi \n Third Party Payment Service Providers \n TPP \n \n \n Temsilci \n Temsilci \n KuruluÅ adÄ±na ve hesabÄ±na hareket eden gerÃ§ek veya tÃ¼zel kiÅi. \n \n \n \n \n \n"},{title:"3. Temel Prensipler",frontmatter:{},regularPath:"/v2.0.1/contents/temel-prensipler.html",relativePath:"v2.0.1/contents/temel-prensipler.md",key:"v-5617815a",path:"/v2.0.1/contents/temel-prensipler.html",headers:[{level:2,title:"3.1 Genel",slug:"_3-1-genel"},{level:2,title:"3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum",slug:"_3-2-istem-cagrÄ±-ve-oturum"},{level:2,title:"3.3.\tRESTful API",slug:"_3-3-restful-api"},{level:2,title:"3.4.\tSÃ¼rÃ¼m YÃ¶netimi",slug:"_3-4-surum-yonetimi"},{level:2,title:"3.5.\tKaynak URI Yol YapÄ±sÄ±",slug:"_3-5-kaynak-uri-yol-yapÄ±sÄ±"},{level:2,title:"3.6.\tKarakter Kodlama",slug:"_3-6-karakter-kodlama"},{level:2,title:"3.7.\tVeri FormatÄ±",slug:"_3-7-veri-formatÄ±"},{level:2,title:"3.8.\tÄ°stemci Sertifika YÃ¶netimi",slug:"_3-8-istemci-sertifika-yonetimi"},{level:2,title:"3.9.\tYetkilendirme TÃ¼rleri",slug:"_3-9-yetkilendirme-turleri"},{level:2,title:"3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ±",slug:"_3-10-istek-cevap-mesajlarÄ±nda-kullanÄ±lan-nesne-yapÄ±larÄ±"},{level:2,title:"3.11. SayfalandÄ±rma ve Filtreleme",slug:"_3-11-sayfalandÄ±rma-ve-filtreleme"},{level:2,title:"3.12. Mesaj Ä°mzalama",slug:"_3-12-mesaj-imzalama"},{level:2,title:"3.13. Durum Kodu",slug:"_3-13-durum-kodu"},{level:2,title:"3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ±",slug:"_3-14-gereksinimlerinin-sÄ±nÄ±flandÄ±rÄ±lmasÄ±"},{level:2,title:"3.15. Ä°stek BaÅlÄ±ÄÄ±",slug:"_3-15-istek-baslÄ±gÄ±"},{level:2,title:"3.16. YanÄ±t BaÅlÄ±ÄÄ±",slug:"_3-16-yanÄ±t-baslÄ±gÄ±"},{level:2,title:"3.17. Idempotency KurallarÄ±",slug:"_3-17-idempotency-kurallarÄ±"},{level:2,title:"3.18. HTTP Durum KodlarÄ±",slug:"_3-18-http-durum-kodlarÄ±"},{level:2,title:"3.19. Maskeleme KurallarÄ±",slug:"_3-19-maskeleme-kurallarÄ±"},{level:2,title:"3.20. Fonksiyonel Olmayan Gereksinimler",slug:"_3-20-fonksiyonel-olmayan-gereksinimler"},{level:2,title:"3.21. Otomatik Sorgular",slug:"_3-21-otomatik-sorgular"}],content:' 3. Temel Prensipler  \n Bu bÃ¶lÃ¼mde Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri (Hesap Bilgisi Hizmeti, Ãdeme Emri BaÅlatma Hizmeti) iÃ§in tanÄ±mlanan temel prensipler aÃ§Ä±klanmaktadÄ±r. \n 3.1 Genel \n \n \n HHSâler YÃ¶netmeliÄin 59. maddesinin beÅinci fÄ±krasÄ± ve Ãdeme ve Elektronik Para KuruluÅlarÄ±nÄ±n Bilgi Sistemleri ile Ãdeme Hizmeti SaÄlayÄ±cÄ±larÄ±nÄ±n Ãdeme Hizmetleri AlanÄ±ndaki Veri PaylaÅÄ±m Servislerine Ä°liÅkin TebliÄin (TebliÄ) 23. maddesinin birinci fÄ±krasÄ± uyarÄ±nca, Ã¶deme hizmetleri veri paylaÅÄ±m servislerini GEÃÄ°T aracÄ±lÄ±ÄÄ±yla HBHS ve ÃBHSâye sunmakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n \n \n TebliÄin 23. maddesinin ikinci fÄ±krasÄ± uyarÄ±nca Ã¶deme emri baÅlatma hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± ÃBHS ile HHSâdir. \n \n \n TebliÄin 23. maddesinin Ã¼Ã§Ã¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca hesap bilgisi hizmetinde aÃ§Ä±k iletiÅim servisinin taraflarÄ± HBHS ile HHSâdir. \n \n \n YÃ¶netmeliÄin 60. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, Ã¶deme emri baÅlatma hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n YÃ¶netmeliÄin 61. maddesinin birinci fÄ±krasÄ± uyarÄ±nca mÃ¼Återi, hesap bilgisi hizmetini  Ã¶deme hesabÄ±nÄ±n Ã§evrim iÃ§i olarak eriÅilebilir olduÄu durumlarda , kullanmayÄ± tercih edebilir. \n \n \n TebliÄin 25. maddesi uyarÄ±nca HHS ve YÃS (ÃBHS ve HBHS) arasÄ±nda baÄlantÄ± uÃ§tan uca gÃ¼venli bir Åekilde saÄlanÄ±r. Bu amaÃ§la iletim katmanÄ±nda TLS (asgari 1.2 sÃ¼rÃ¼mÃ¼) ile Åifreli iletiÅim saÄlanÄ±r. \n \n \n TebliÄin 23. maddesinin dÃ¶rdÃ¼ncÃ¼ fÄ±krasÄ± uyarÄ±nca HHS tarafÄ±ndan sunulan Ã¶deme hizmetleri veri paylaÅÄ±m servislerini kullanan yetkilendirilmiÅ Ã¶deme hizmeti saÄlayÄ±cÄ±larÄ±nÄ±n TCMB tarafÄ±ndan ilgili Ã¶deme hizmeti iÃ§in yetkilendirilmiÅ olduÄu kontrol edilir. \n \n \n TebliÄin 25. maddesinin beÅinci fÄ±krasÄ± uyarÄ±nca zaman damgasÄ±, 15/1/2004 tarihli 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunu kapsamÄ±nda tanÄ±mlanan zaman damgasÄ±na dayanÄ±r. \n \n \n API alan isimleri TÃ¼rkÃ§e olarak tanÄ±mlanmÄ±ÅtÄ±r. Ancak API baÅlÄ±ÄÄ± (header) alanÄ±ndaki alan isimleri Ã¶zelinde, API GeÃ§itleri tarafÄ±ndan otomatik olarak tanÄ±nabilmesi gÃ¶zetilerek, Ä°ngilizce isimlendirme tercih edilmiÅtir. \n \n \n ÃHK halihazÄ±rda Ã¶deme hesaplarÄ±na, Ã§evrim iÃ§i (mobil bankacÄ±lÄ±k, internet bankacÄ±lÄ±ÄÄ± vb.) eriÅebilir durumda ise, HHS\'nin varsa AÃ§Ä±k BankacÄ±lÄ±k kanal veya yetki tanÄ±mÄ±nÄ± varsayÄ±lan deÄeri AÃIK olacak Åekilde sunmasÄ± gerekmektedir. HHSânin, Bireysel/Kurumsal/Ticari mÃ¼Återi ayrÄ±mÄ± yapmaksÄ±zÄ±n tÃ¼m mÃ¼Återileri iÃ§in, Ã§evrim iÃ§i kanallarda hesap hareketlerine eriÅim ve Ã¶deme yapabilme yetkisi bulunmasÄ± durumunda, yine aynÄ± Åekilde AÃ§Ä±k BankacÄ±lÄ±k kanal veya yetki tanÄ±mÄ±nÄ± da varsayÄ±lan deÄeri AÃIK olacak Åekilde sunmasÄ± gerekmektedir. HHS AÃ§Ä±k BankacÄ±lÄ±k hizmetini kanal/yetki tanÄ±mÄ± ile yÃ¶netmesi durumunda hizmeti verdiÄi ilgili kanallar(web,mobil) Ã¼zerinden mÃ¼Återisine AÃ§ma/Kapama olanaÄÄ± Åeklinde sunmasÄ± gerekmektedir. \n \n \n 5411 SayÄ±lÄ± Kanun kapsamÄ±ndaki bankalar, HHS API iÃ§erisinde Aktif durumda listelenmemiÅken, YÃS API iÃ§erisinde listelenemezler. \n \n \n Temsilci, YÃ¶netmelikâin 3âÃ¼ncÃ¼ maddesinin birinci fÄ±krasÄ±nÄ±n (tt) bendinde "KuruluÅ adÄ±na ve hesabÄ±na hareket eden gerÃ§ek veya tÃ¼zel kiÅi" olarak tanÄ±mlanmakta olup aynÄ± YÃ¶netmelikâin 18âinci maddesi uyarÄ±nca, KuruluÅlarÄ±n Ã¶deme hizmetlerini ele

16ktronik veya fiziki kanallar Ã¼zerinden temsilci aracÄ±lÄ±ÄÄ±yla yÃ¼rÃ¼tebilmesi mÃ¼mkÃ¼n kÄ±lÄ±nmaktadÄ±r. \n Bu kapsamda, KuruluÅlarÄ±n (YÃS\'lerin) ÃHVPS kapsamÄ±nda Yetkili Ãdeme SaÄlayÄ±cÄ± rolÃ¼nde vermiÅ olduÄu hizmetleri temsilcilik iliÅkisi kapsamÄ±nda 3. Taraflarca sunulabilmesi iÃ§in ilk olarak e-posta yolu ile BKMâye baÅvuruda bulunmasÄ± gereklidir. \n BaÅvuru sonrasÄ±nda temsilcilik iliÅkisi kurulacak 3.tarafa BKM tarafÄ±ndan bir kod atamasÄ± yapÄ±lacaktÄ±r. \n KuruluÅlar (YÃS\'ler) BKMânin ilgili temsilci iÃ§in belirleyeceÄi ve KuruluÅa ileteceÄi kodu, temsilci Ã¼zerinden baÅlatÄ±lan iÅlemlerde âX-Agent-Codeâ baÅlÄ±ÄÄ±nda iletecektir.\nÄ°stek baÅlÄ±ÄÄ±nda gÃ¶nderilen X-Agent-Code HHS\'ler tarafÄ±ndan baÅarÄ±lÄ± bir Åekilde yanÄ±t dÃ¶nÃ¼lmesi beklenmektedir. \n 3.2.\tÄ°stem (ÃaÄrÄ±) ve Oturum \n \n \n Her istek tekil istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) iÃ§erir. Birden fazla istek iÃ§eren iÅlem YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi (istek numarasÄ±: X-Request-ID) ve rÄ±za sÃ¼recine Ã¶zgÃ¼ talep kimliÄi (iÅlem grup numarasÄ±: X-Group-ID) deÄerleri kullanÄ±lmalÄ±dÄ±r. AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± X-Group-ID bilgisi deÄeri gÃ¶nderilmelidir. \n \n \n Oturum takibi ise PSU-Session-ID ile yapÄ±lÄ±r. Oturum numarasÄ± (PSU-Session-ID) ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) ile birlikte ilgili tÃ¼m iÅlem verilerini iÃ§erecek Åekilde kayÄ±t altÄ±na alÄ±nÄ±r. \n \n \n ÃrneÄin, bir Ã¶deme emri baÅlatma iÅlemi birden fazla istekten oluÅur. Her istek yukarÄ±da belirtildiÄi gibi biricik istek numarasÄ± ve ÃHKâlÄ± iÅlemler iÃ§in zaman damgasÄ± (PSU-Timestamp) iÃ§erir. Ancak iÅlemin oturum bÃ¼tÃ¼nlÃ¼ÄÃ¼ PSU-Session-ID ile saÄlanÄ±r. \n \n \n Taraflar aÃ§tÄ±klarÄ± oturumu iÅlem bÃ¼tÃ¼nlÃ¼ÄÃ¼nÃ¼ saÄlayacak sÃ¼re iÃ§erisinde aÃ§Ä±k tutar ve iÅlem biter bitmez kapatÄ±r. \n 3.3.\tRESTful API \n APIâler, dÃ¼nya Ã¶lÃ§eÄinde yaygÄ±n bir Åekilde kullanÄ±lan Temsili Durum Transferi (Representational State Transfer, REST) mimari tarzÄ± ve JavaScript Nesne Notasyonu (JavaScript Object Notation, JSON) veri formatlarÄ±na uygun olarak geliÅtirilir. En Ã¼st seviye Veri TanÄ±mlama Dili (Data Description Language) ve en iyi uygulama Ã¶rnekleri iÃ§in  ^JSON ÅemasÄ±  temel alÄ±nÄ±r. \n Ä°stek ve yanÄ±t mesajlarÄ±nda, isteÄe baÄlÄ± veya koÅullu bir alan, deÄer iÃ§ermiyorsa, bu alan JSON payloadunda yer almamalÄ±dÄ±r. \n Ãrnek kod bloÄu. \n "rzBlg":{\n         "rizaNo":"aa9bd7e7-0ccd-4edc-9639-5a358dbf2335",\n         "olusZmn":"2022-11-28T12:00:21+03:00",\n         "gnclZmn":null,    --\x3e hatalÄ±\n         "rizaDrm":"K",\n         "rizaIptDtyKod":"" --\x3e hatalÄ± \n      },\n \n Ãrnek kod bloÄu: \n \n         "alc":{\n            "hspNo": "TR800800004162387689546019",\n            "unv": "AHMET YILMAZ", \n            "kolas":{}  --\x3e nesne gÃ¶nderimi hatalÄ±\n         },\n 3.4.\tSÃ¼rÃ¼m YÃ¶netimi \n API sonraki aÅamalarda doÄabilecek gereksinimleri ve daha karmaÅÄ±k kullanÄ±m durumlarÄ±nÄ± karÅÄ±lamak iÃ§in sÃ¼rÃ¼mler halinde geliÅtirilir ve bu durum tasarÄ±m sÄ±rasÄ±nda gÃ¶z Ã¶nÃ¼nde bulundurulur. \n API v1.0.2 sÃ¼rÃ¼mÃ¼nde ; \n \n Kapsamdaki Ã¶deme hesaplarÄ± : Vadesiz TL, DÃ¶viz(yabancÄ± para hesaplarÄ±), AltÄ±n/GÃ¼mÃ¼Å/ Platin/Paladyum hesaplarÄ±, Kredili Mevduat HesaplarÄ± \n Tekil Ã¶deme (Virman/Havale/FAST/MÃ¼ÅterilerarasÄ± TL AktarÄ±m Sistemi)\n \n Virman ve havale iÅlemleri kapsamÄ±nda yabancÄ± para transferi yapÄ±labilir. \n \n \n Hesap bilgisi hizmetleri\n \n Temel veya ayrÄ±ntÄ±lÄ± hesap bilgisi \n Bakiye \n GerÃ§ekleÅen iÅlemler iÃ§in Hesap hareketleri \n \n \n Karekodlu Ã¶demelerdeki 01, 02 ve 03 akÄ±Å tÃ¼rleri\nyer almaktadÄ±r. \n \n API v1.1.0 sÃ¼rÃ¼mÃ¼nde ; \n \n \n API v1.0.2 sÃ¼rÃ¼mÃ¼ne ek Olay Bildirim ve AyrÄ±k GKD Ã¶zellikleri eklenmiÅtir. SÃ¼reÃ§lerin daha iyi iÅlemesi iÃ§in Ã§eÅitli gÃ¼ncellemeler yapÄ±lmÄ±ÅtÄ±r. \n \n \n API v2.0 sÃ¼rÃ¼mÃ¼nde ileri tarihli Ã¶deme emri, dÃ¼zenli Ã¶deme emri, hesap bilgisi hizmeti iÃ§erisinde kart hizmetleri, YÃS Ã¼zerinden rÄ±za gÃ¼ncelleme hizmetine dair gÃ¼ncellemeler eklenmiÅtir. \n \n \n Her sÃ¼rÃ¼m deÄiÅikliÄinde bir Ã¶nceki sÃ¼rÃ¼m belirli bir sÃ¼re desteklenecektir. DiÄer bir ifadeyle, sadece belirli bir sÃ¼re iÃ§in mevcut ve bir Ã¶nceki sÃ¼rÃ¼m aynÄ± anda eriÅilebilir olacaktÄ±r. \n 3.5.\tKaynak URI Yol YapÄ±sÄ± \n YÃSâlerin baÅlattÄ±ÄÄ± Ã§aÄrÄ±larda URI yolu aÅaÄÄ±daki yapÄ±yÄ± takip eder: \n [hhs-yol-Ã¶n-eki]/ohvps/ [kaynak-grubu]/ [sÃ¼rÃ¼m]/ [kaynak]/[kaynak-no]/[alt-kaynak] \n Bu, aÅaÄÄ±daki unsurlardan oluÅur: \n \n [hhs-yol-Ã¶n-eki] \nÄ°steÄe baÄlÄ±, HHS\'ye Ã¶zgÃ¼ yol Ã¶n ekini ifade eder. \nGEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda BKM tarafÄ±ndan belirlenen sistem adÄ± ve yol Ã¶n eki kullanÄ±lÄ±r. \n ohvps \nSabit metin âohvpsâ (Ãdeme Hizmetleri Veri PaylaÅÄ±m Servisleri kÄ±saltmasÄ±) \n [kaynak-grubu] \nKaynak grubu, APIâye eriÅmek iÃ§in kullanÄ±lan Ã¶deme hizmetine (HBH, ÃBH) gÃ¶re eriÅim adresi (end point) grubunu tanÄ±mlar (âhbhâ veya âobhâ). \n [sÃ¼rÃ¼m] \nAPI sÃ¼rÃ¼mÃ¼nÃ¼ ifade eder (â/s[ana-sÃ¼rÃ¼m].[alt-sÃ¼rÃ¼m]/â). \n [kaynak]/[kaynak-no] \nKaynak detaylarÄ±nÄ± ifade eder. \n [alt-kaynak] \nAlt kaynak detaylarÄ±nÄ± ifade eder. \n \n HHS, tÃ¼m kaynaklarÄ± iÃ§in aynÄ± katÄ±lÄ±mcÄ± yolu Ã¶n ekini ve sistem adÄ±nÄ± kullanmalÄ±dÄ±r. \n BKM APIâlerine eriÅmek isteyen uygulamalarÄ±n yetkilerine gÃ¶re aÅaÄÄ±daki APIâlere abone olmalarÄ± gerekmektedir: \n OBH: \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s2.0/odeme-emri-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s2.0/odeme-emri \nHBH: \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesap-bilgisi-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar/1234/islemler \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar/1234/bakiye \nGKD \n https://gecit-api.bkmtest.com.tr/ohvps/gkd/s2.0/erisim-belirteci \nHHS â YÃS - Temsilcil

16ik API \n https://gecit-api.bkmtest.com.tr/hhs-api/s2.0/hhs \n https://gecit-api.bkmtest.com.tr/hhs-api/s2.0/hhs/1234 \n https://gecit-api.bkmtest.com.tr/yos-api/s2.0/yos \n https://gecit-api.bkmtest.com.tr/yos-api/s2.0/yos/1234 \n https://gecit-api.bkmtest.com.tr/temsilcilik-api/s2.0/temsilcilik \n https://gecit-api.bkmtest.com.tr/temsilcilik-api/s2.0/temsilcilik/12345 \n HHSâlerin saÄlayacaklarÄ± APIâlerdeki URI Ã§evrimi Ã¶rnekleri aÅaÄÄ±daki gibidir. \n \n https://xbank.com.tr/api-portal/ohvps/obh/s2.0/odeme-emri \n https://gecit-api.bkmtest.com.tr/ohvps/obh/s2.0/odeme-emri  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s2.0/hesap-bilgisi-rizasi \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesap-bilgisi-rizasi  (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s2.0/hesaplar \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar   (BKM API) \n https://xbank.com.tr/api-portal/ohvps/hbh/s2.0/hesaplar/1234 \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesaplar/1234  (BKM API) \n \n GEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda, istek baÅlÄ±ÄÄ±nda bulunan âx-aspsp-codeâ (isteÄin iletildiÄi Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n kodu) deÄerine gÃ¶re HHS APIâde standart olarak tanÄ±mlanmÄ±Å olan âbasePathâ bilgisine servis uzantÄ±sÄ± eklenerek HHSâye yÃ¶nlendirme yapÄ±lÄ±r. \n ÃrneÄin, istek baÅlÄ±ÄÄ±nda  xbank âÄ±n kodu varsa, YÃS tarafÄ±ndan yapÄ±lan \n https://gecit-api.bkmtest.com.tr/ohvps/hbh/s2.0/hesap-bilgisi-rizasi \nÃ§aÄrÄ±sÄ± GEÃÄ°T tarafÄ±ndan karÅÄ±lanarak \n https://xbank.com.tr/api-portal/ohvps/hbh/s2.0/hesap-bilgisi-rizasi \nadresine yÃ¶nlendirilir. \n Bu Ã¶rnekte,  https://xbank.com.tr/api-portal  basePath bilgisi HHS tarafÄ±ndan HHS APIâye girilen deÄerdir. \n ÃNEMLÄ° :  URI Query parametreleri GET ile iletilirken deÄerlerde url-encode yapÄ±lmalÄ±dÄ±r. Ãrnek bir API isteÄi; \nGET /ohvps/hbh/s2.0/hesaplar/xxx/islemler?hesapIslemBslTrh=2023-02-07T16:42:38%2B03:00&hesapIslemBtsTrh=2023-02-07T17:09:18%2B03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfKytSayi=10&syfNo=1 \n Burada \'+\' karakterinin boÅluk olarak algÄ±lanmamasÄ± iÃ§in %2B deÄeri ile iletilmiÅtir. \n 3.6.\tKarakter Kodlama \n API istekleri ve yanÄ±tlarÄ±nÄ±n  BaÅlÄ±k  parametrelerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r.  3.15. Ä°stek BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. \n API istekleri ve yanÄ±tlarÄ±nda  GÃ¶vde  parametrelerinde UTF-8 karakter kodlamasÄ± kullanÄ±lÄ±r. Bu, JSON iÃ§in varsayÄ±lan karakter kodlamasÄ±dÄ±r. \n Ancak, bir HHS\'nin kendi uygulamalarÄ± ve Ã¶deme baÅlattÄ±ÄÄ± Ã¶deme sistemi (Havale vb.) bazÄ± UTF-8 karakterlerini kabul etmeyebilir. HHS, UTF-8 kodlamasÄ± iÃ§eren bir mesajÄ± iÅleyemez ve reddederse, HTTP 400 (HatalÄ± Ä°stek) durum kodu ile yanÄ±t vermelidir. \n ÃHVPS kapsamÄ±nda iletilen deÄerler iÃ§erisinde iÅlenemeyecek karakterler var ise  "TR.OHVPS.Business.InvalidCharacter"  hatasÄ± verilir. \n GÃ¶vde parametrelerinde desteklenen UTF-8 karakter kÃ¼mesi aÅaÄÄ±da listelenmiÅtir. \n \n \n \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n Karakter \n UTF 8   Hex. \n \n \n \n \n \n 20 \n = \n 3d \n X \n 58 \n r \n 72 \n \n \n ! \n 21 \n ? \n 3f \n Y \n 59 \n s \n 73 \n\n 23 \n @ \n 40 \n Z \n 5a \n t \n 74 \n \n \n % \n 25 \n A \n 41 \n [ \n 5b \n u \n 75 \n \n \n & \n 26 \n B \n 42 \n \\ \n 5c \n v \n 76 \n \n \n \' \n 27 \n C \n 43 \n ] \n 5d \n w \n 77 \n \n \n ( \n 28 \n D \n 44 \n ^ \n 5e \n x \n 78 \n \n \n ) \n 29 \n E \n 45 \n _ \n 5f \n y \n 79 \n \n \n * \n 2a \n F \n 46 \n a \n 61 \n z \n 7a \n \n \n + \n 2b \n G \n 47 \n b \n 62 \n { \n 7b \n \n \n , \n 2c \n H \n 48 \n c \n 63 \n } \n 7d \n \n \n - \n 2d \n I \n 49 \n d \n 64 \n Ã \n c3 87 \n \n \n . \n 2e \n J \n 4a \n e \n 65 \n Ã \n c3 96 \n \n \n / \n 2f \n K \n 4b \n f \n 66 \n Ã \n c3 9c \n \n \n 0 \n 30 \n L \n 4c \n g \n 67 \n Ã§ \n c3 a7 \n \n \n 1 \n 31 \n M \n 4d \n h \n 68 \n Ã¶ \n c3 b6 \n \n \n 2 \n 32 \n N \n 4e \n i \n 69 \n Ã¼ \n c3 bc \n \n \n 3 \n 33 \n O \n 4f \n j \n 6a \n Ä \n c4 9e \n \n \n 4 \n 34 \n P \n 50 \n k \n 6b \n Ä \n c4 9f \n \n \n 5 \n 35 \n Q \n 51 \n l \n 6c \n Ä° \n c4 b0 \n \n \n 6 \n 36 \n R \n 52 \n m \n 6d \n Ä± \n c4 b1 \n \n \n 7 \n 37 \n S \n 53 \n n \n 6e \n Å \n c5 9e \n \n \n 8 \n 38 \n T \n 54 \n o \n 6f \

16n Å \n c5 9f \n \n \n 9 \n 39 \n U \n 55 \n p \n 70 \n \n \n \n \n : \n 3a \n V \n 56 \n q \n 71 \n \n \n \n \n ; \n 3b \n W \n 57 \n \n \n \n \n \n \n \n Ancak  EriÅim belirteci, Yenileme belirteci ve Authorization  parametreleri daha dar bir karakter kÃ¼mesi ile doldurulmalÄ±dÄ±r. \n Bearer HTTP Authorization ÅemasÄ± RFC 6750\'de tanÄ±mlanmÄ±ÅtÄ±r.  https://www.rfc-editor.org/rfc/rfc6750#section-2.1  bÃ¶lÃ¼mÃ¼nde izin verilen karakterlerin gÃ¶nderilmesi beklenmektedir. Buradaki standartÄ±n her 3 parametre iÃ§in de uygulanmasÄ±na karar verilmiÅtir. \n RFC 6750 iÃ§erisinde bearer token formatÄ± Åu Åekildedir : 1*( ALPHA / DIGIT / "-" / "." / "_" / "~" / "+" / "/" ) *"=" \nAugmented BNF for Syntax Specifications (ABNF) ile ifade edilen bu formatta token en az 1 adet alfanumerik karakter veya Ã¶zel karakter ("-", "." , "_" , "~" , "+" , "/")  iÃ§ermeli ve 0 ya da daha Ã§ok sayÄ±da "=" karakteri ile bitmelidir. \n ALPHA = A-Z / a-z aralÄ±ÄÄ±ndaki harflerdir. \nDIGIT = 0-9 aralÄ±ÄÄ±ndaki rakamlardÄ±r. \n 3.7.\tVeri FormatÄ± \n \n AÃ§Ä±k bankacÄ±lÄ±k kapsamÄ±ndaki zaman damgasÄ±, ISO 8601 standartÄ±na uygun olarak yerel saat bilgisini ve timezone bilgisini de iÃ§erecek Åekilde " yyyy-MM-ddâTâHH:mm:ssXXX " formattaki haliyle hazÄ±rlanmalÄ±dÄ±r. \n \n Ãrnek:  "timestamp": "2021-05-30T20:34:15+03:00" \nyyyy : 4 hane yÄ±l \nMM : BaÅa â0â eklenmiÅ, toplam 2 hane ay \ndd    : BaÅa â0â eklenmiÅ, toplam 2 hane gÃ¼n \nHH    : BaÅa â0â eklenmiÅ, toplam 2 hane saat (0-23 arasÄ± deÄer alabilir.) \nmm : BaÅa â0â eklenmiÅ, toplam 2 hane dakika \nss    : BaÅa â0â eklenmiÅ, toplam 2 hane saniye \nXXX : ISO 8601 Time zone \n \n \n Zaman damgasÄ± hesaplamalarÄ±nda, yeni gÃ¼nÃ¼n baÅlangÄ±Ã§ saatinin 00:00:00 olduÄu kabul edilmiÅtir. \n \n \n JWT veri paketlerinde kullanÄ±lan zaman damgalarÄ±, 1 Ocak 1970 Saat 00:00:00 (UTC) anÄ±ndan itibaren geÃ§en saniye sayÄ±sÄ± deÄerini (Unix Time) kullanmalÄ±dÄ±r. \n \n \n Bir HHS, tarihi yanlÄ±Å biÃ§imlendirilmiÅ bir istek aldÄ±ÄÄ±nda, 400 (HatalÄ± Ä°stek) durum kodu ve ilgili hata kodu ile yanÄ±t vermelidir. \n \n \n ISO 4217 StandartÄ±nda para birimleri ve kaÃ§ basamak ondalÄ±k deÄer iÃ§erebilecekleri belirlenmiÅtir. \n https://www.iso.org/iso-4217-currency-codes.html   adresinden Ã¼cretsiz olarak listeye eriÅilebilir.  \nAPI StandartlarÄ±nda da para birimleri  ISO 4217âde tanÄ±mlanmÄ±Å olan 3 harfli kodlarla iletilir.   TÃ¼m tutar alanlarÄ± ISO 4217\'de tanÄ±mlanmÄ±Å para birimlerinin ondalÄ±k basamak deÄerleri de gÃ¶z Ã¶nÃ¼nde bulundurularak iletilmelidir. Tutar alanlarÄ± artÄ± ya da eksi deÄer alabileceÄi iÃ§in API deseninde tanÄ±mlanmÄ±Å regular expressionlar dikkate alÄ±nmalÄ±dÄ±r. \nÃrneÄin; Bakiye API\'sindeki "Kredili Mevduat HesabÄ± Bakiyesi" alanÄ± "-100.25" ve "Para Birimi" alanÄ± "TRY" olarak iletildiÄinde 25 deÄerinin kuruÅ olduÄu anlaÅÄ±lmalÄ±dÄ±r. \nÃdeme Emri RÄ±zasÄ± API\'sinde yer alan "Ä°Ålem TutarÄ±" alanÄ± "104.75" TRY olarak iletildiÄinde "75" deÄerinin kuruÅ olduÄu anlaÅÄ±lmalÄ±dÄ±r. \n"12000" Japon Yeni iÃ§in, ISO 4217âde JPY para biriminin ondalÄ±k kÄ±smÄ± olmadÄ±ÄÄ±ndan "Ä°Ålem TutarÄ±" alanÄ±nda "12000" ve "Para Birimi" alanÄ±nda "JPY" deÄeri  iletilmelidir. \n \n \n AltÄ±n para birimi Ã¶zelinde ISO 4217âye uygun olarak "XAU" cinsinde ve 2 basamak ondalÄ±k rakam iÃ§erecek Åekilde iletilmelidir. ÃrneÄin iÃ§erisinde "13,50 gr" altÄ±n olan hesap iÃ§in bakiye "13.50", para birimi "XAU" olarak gÃ¶nderilmelidir. \n \n \n DiÄer madenlerde ondalÄ±k basamak ISO 4217 standartÄ±nda tanÄ±mlandÄ±ÄÄ± gibi olmalÄ±dÄ±r. \n \n \n SÄ±ralÄ± veri tipleri bÃ¼yÃ¼k kÃ¼Ã§Ã¼k harfe duyarlÄ± olmalÄ±dÄ±r. \n 3.8.\tÄ°stemci Sertifika YÃ¶netimi \n ÃHVPS kapsamÄ±nda YÃS ve HHSâlerin gÃ¼venli bir Åekilde tanÄ±mlanmasÄ± amacÄ±yla elektronik sertifikalar kullanÄ±lÄ±r. \n ÃHVPS kapsamÄ±nda taraflarÄ±n gÃ¼venli bir Åekilde tanÄ±mlamasÄ±, uÃ§tan uca gÃ¼venli iletiÅim, mesaj Åifreleme ve mesaj imzalama iÅlevleri 15/1/2004 tarihli ve 5070 sayÄ±lÄ± Elektronik Ä°mza Kanunuânda aÃ§Ä±klanan elektronik sertifikalar kullanÄ±larak saÄlanÄ±r. Elektronik sertifikada TÃ¼rkiye Cumhuriyet Merkez BankasÄ± tarafÄ±ndan verilen kuruluÅ kodu ve kuruluÅun tÃ¼rÃ¼ne dair bilgiler bulunur. \n GEÃÄ°T Ã¼zerinden yapÄ±lan eriÅimlerde YÃS ve HHSâlere Ã¶nceden daÄÄ±tÄ±lmÄ±Å olan istemci sertifikalarÄ± kullanÄ±larak taraflarÄ±n (sunucu) kimlikler

16inin doÄrulanmasÄ± saÄlanacaktÄ±r. Ä°stemci sertifikalarÄ± hem test hem de Ã¼retim ortamÄ±nda kullanÄ±lacaktÄ±r. SertifikalarÄ±n iÅlevselliÄi ve geÃ§erliliÄi sertifikasyon sÃ¼recinde de sÄ±nanacaktÄ±r. SÃ¶z konusu sertifikalarÄ±n daÄÄ±tÄ±m prosedÃ¼rleri ve kullanÄ±mlara yÃ¶nelik aÃ§Ä±klamalar EK-3âte yer verilmiÅtir. \n 3.9.\tYetkilendirme TÃ¼rleri \n GEÃÄ°T Ã¼zerinden yapÄ±lan Ã§aÄrÄ±larda iki temel yetkilendirme tÃ¼rÃ¼ kullanÄ±lÄ±r: \n 1.\tÄ°stemci Kimlik Bilgileri:  MÃ¼Återi onayÄ±nÄ±n gerekmediÄi, sadece YÃSâÃ¼n tanÄ±mlanÄ±p doÄrulandÄ±ÄÄ± API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. YÃSâÃ¼n yetkilendirilmiÅ olduÄu ve faaliyet izninin yaptÄ±ÄÄ± hizmet Ã§aÄrÄ±sÄ±na uygun olduÄu kontrol edilir.  Bu amaÃ§la, YÃSâlere clientId ve clientSecret tahsis edilecektir. YÃSâler ilgili clientId ve clientSecret ile sadece yetkilendirilmiÅ olduklarÄ± servislere eriÅebileceklerdir. YÃSâler kendilerine BKM tarafÄ±ndan sunulacak APIâyi, kendi clientID ve clientSecret deÄerleri ile sorgulayarak âÄ°stemci Kimlik Bilgileriâ belirtecini (access token) elde edeceklerdir.\nHHSâler de GEÃÄ°T Ã¼zerindeki YÃS APIâsini sorgulama maksadÄ± ile GEÃÄ°T\'e geldiklerinde, kendilerine atanmÄ±Å olan clientID ve clientSecret bilgileri ile yetki kontrolleri yapÄ±lÄ±r.\nHHS ve YÃSâler ; ilettikleri client id ve secret deÄerleri kullanÄ±larak oluÅturulacak bearer authentication metodu ile servislerini sunacaklardÄ±r. \n 2.\tYetkilendirme Kodu:  YÃSâÃ¼n doÄrulanmasÄ±nÄ±n yanÄ±sÄ±ra mÃ¼Återinin GKD ile doÄrulanmasÄ± gereken API Ã§aÄrÄ±larÄ±nda kullanÄ±lÄ±r. MÃ¼Återi doÄrulanarak yetkilendirme kodu oluÅturulmasÄ± HHSânin yetkilendirme arayÃ¼zÃ¼ne yÃ¶nlendirilir. GKDânin baÅarÄ±yla tamamlanmasÄ± sonrasÄ±nda yetkilendirme kodu YÃSâe dÃ¶nÃ¼lÃ¼r. YÃS daha sonra HHSânin  eriÅim belirteci  (access token) eriÅim adresini (EK-3: POST /erisim-belirteci) Ã§aÄÄ±rmak suretiyle yetkilendirme kodunu bir eriÅim belirteci (access token) ile deÄiÅtirerek ilgili kaynaklarÄ± kullanabilir. \n Ãdeme emri baÅlatma ve hesap bilgisi hizmetlerinde hangi yetkilendirme tÃ¼rlerinin kullanÄ±lacaÄÄ± bilgisi, ilgili baÅlÄ±klardaki eriÅim adresleri (endpoints) tablolarÄ±nda yer almaktadÄ±r. \n erisim-belirteci  erisim noktasÄ±ndan elde edilen  erisimBelirteci  iliÅkilendirildiÄi nesne veya iÅlem iÃ§in gÃ¶nderilen POST isteÄi baÅlÄ±ÄÄ±nda  x-access-token  alanÄ±nda iletilir.\nBelirli bir sÃ¼re iÃ§in tanÄ±mlanan eriÅim belirteci (access token) deÄerinin yenileme belirteci (refresh token) ile yenilenmesi gerekir. \n EriÅim adreslerinde kullanÄ±lan yetkilendirme tÃ¼rÃ¼ ilgili eriÅim adresi tablolarÄ±nda belirtilmiÅtir. \n 3.10. Ä°stek/Cevap MesajlarÄ±nda KullanÄ±lan Nesne YapÄ±larÄ± \n Ä°stek ve Cevap mesajlarÄ±nda kullanÄ±lacak olan nesneler tÃ¼m elemanlarÄ±nÄ± kapsayacak Åekilde Ek-1 de listelenmiÅtir. TÃ¼m listelenen elemanlar aÃ§Ä±sÄ±ndan (UÃ§ nokta mesaj yapÄ±larÄ±nÄ±n belirtildiÄi tablolarda belirtildiÄi Ã¼zere) alanÄ±n Zorunlu (z) veya Ä°steÄe BaÄlÄ± (Ä°) olma durumlarÄ±na gÃ¶re bazÄ± alanlar gÃ¶nderilebilir veya gÃ¶nderilmeyebilir. \n 3.11. SayfalandÄ±rma ve Filtreleme \n SayfalandÄ±rma \n ÃaÄrÄ±ya dÃ¶nÃ¼len kaynak nesnesi iÃ§erisindeki kayÄ±tlar bir sayfalandÄ±rma yapÄ±sÄ± ile Ã§aÄrÄ±lacak Åekilde istek oluÅturulur. \n OluÅturulacak isteÄin iÃ§erisinde parametreler ile filtreleme, sayfa baÅÄ±na gÃ¶sterilecek kayÄ±t sayÄ±sÄ± ve hangi sayfanÄ±n Ã¶nyÃ¼zde gÃ¶sterileceÄi bilgileri eriÅim noktasÄ±na iletilir ve ilgili kayÄ±tlar cevap olarak alÄ±nÄ±r. \n Filtreleme \n HHS, birden Ã§ok kayÄ±t dÃ¶nÃ¼lmesi gereken GET Ã§aÄrÄ±larÄ±nda sÄ±nÄ±rlÄ± filtreleme desteÄi saÄlamalÄ±dÄ±r. Filtre parametreleri her zaman kaynak nesnesinin belirli alanlarÄ±na Ã¶zgÃ¼dÃ¼r ve nesne iÃ§in tanÄ±mlanan kurallara uymalÄ±dÄ±r. \n 3.12. Mesaj Ä°mzalama \n Elektronik imzalar, ÃHVPS APIâde gerÃ§ekleÅtirilen iÅlemlerin ve taÅÄ±nan verilerin bÃ¼tÃ¼nlÃ¼k ve inkÃ¢r edilemezliÄini destekler. Ä°mzalarÄ±n kaynak bazÄ±nda hangi istek ve yanÄ±tlara uygulandÄ±ÄÄ± belirlidir. \n API yalnÄ±zca TLS\'ye dayanÄ±rsa, dijital kayÄ±tlarÄ± ve inkÃ¢r edilemezlik kanÄ±tlarÄ±nÄ± tutmak zor olur. Bu nedenle, TLS\'ye dayanmayan bir inkÃ¢r edilemezlik Ã§Ã¶zÃ¼mÃ¼ olarak API isteÄinin HTTP baÅlÄ±ÄÄ±nda bir JWS kullanÄ±larak saÄlanabilir. \n HTTP isteÄinin gÃ¶vdesinin hash fonksiyonu (SHA256) ile Ã¶zeti alÄ±nacaktÄ±r. Elde edilen Ã¶zet, asimetrik anahtarlarÄ± de

16stekleyen bir algoritma kullanÄ±larak imzalanacak ve JWS elde edilecektir. Ä°steÄin kendinize geldiÄi durumda body Ã¼zerinde hiÃ§ bir deÄiÅikliÄe tabi tutmadan (serialize/deserialize, minify, trim, vb yapmadan) doÄrulama yapmanÄ±z gerekmektedir. AynÄ± Åekilde isteÄin kendinizden Ã§Ä±ktÄ±ÄÄ± aÅamada da response body Ã¼zerinde hiÃ§ bir deÄiÅikliÄe tabi tutmadan (serialize/deserialize, minify, trim, vb yapmadan) mesaj imzalama yapÄ±lmalÄ±dÄ±r. \n Bir istek, YÃS\'nin Ã¶zel anahtarÄ± ile imzalanacak ve bu isteÄe karÅÄ±lÄ±k gelen yanÄ±t, HHS\'nin Ã¶zel anahtarÄ± tarafÄ±ndan imzalanacaktÄ±r. \n TÃ¼m API istekleri ve yanÄ±tlarÄ± imzalanmaz. Mesaj imzalamanÄ±n zorunlu olup olmadÄ±ÄÄ±, desteklenip desteklenmediÄi her API Ã¶zelinde belirlenir. \n Anahtar Deposu \n HHS\'ler ve YÃS\'ler tarafÄ±ndan gÃ¼venilen bir GÃ¼ven Otoritesi (Trust Anchor), taraflar iÃ§in bir genel anahtar deposu saÄlamaktan sorumludur. \n GÃ¼ven Otoritesi, taraflardan herhangi birisinin oluÅturduÄu bir anahtar Ã§iftinin aÃ§Ä±k bÃ¶lÃ¼mÃ¼nÃ¼ saklayan merkezi bir dizin (BKM tarafÄ±ndan tutulan merkezi kayÄ±t sistemi vb.) olacaktÄ±r. \n MesajlarÄ± doÄrulamak iÃ§in taraflarÄ±n genel anahtarlarÄ±nÄ±n paylaÅÄ±lmasÄ± iÃ§in BKM bir servis saÄlayacaktÄ±r. HHS API olarak adlandÄ±rÄ±lÄ±mÄ±Å olan bu servis ile HHS ve YÃS listelerine ulaÅÄ±labildiÄi gibi doÄrulama iÅlemi iÃ§in ihtiyaÃ§ duyulacak olan genel anahtarlara da bu servis Ã¼zerinden eriÅilebilinecektir. \n Ä°lgili Mesaj Åifreleme iÃ§in genel akÄ±Å, Ek-5 bÃ¶lÃ¼mÃ¼nde detaylarÄ±yla paylaÅÄ±lmaktadÄ±r. \n 3.13. Durum Kodu \n APIâler, iki farklÄ± amaca hizmet eden iki durum kodu kullanÄ±r: \n \n HTTP Durum Kodu, API Ã§aÄrÄ±sÄ±nÄ±n (kaynaktaki HTTP iÅlemi) sonucunu yansÄ±tÄ±r. \n BazÄ± kaynak payloadâlarÄ±ndaki Durum alanÄ±, kaynaklarÄ±n durumunu yansÄ±tÄ±r. \n 3.14. Gereksinimlerinin SÄ±nÄ±flandÄ±rÄ±lmasÄ± \n EriÅim adreslerinin ve alanlarÄ±n kullanÄ±mÄ± Zorunlu(Z), Ä°steÄe BaÄlÄ±(Ä°) veya KoÅullu(K) olabilir. KullanÄ±mlara iliÅkin durumlar ve kullanÄ±mÄ±n (K) koÅullu olduÄu duruma iliÅkin aÃ§Ä±klamalar ilgili tablolarda belirtilmiÅtir. \n ÃHVPS API\'lerinin (HBH,ÃBH,GKD) istek ve yanÄ±tta kullanÄ±lacak baÅlÄ±k isimleri, ilgili RFC dokÃ¼manlarÄ±nda ve aÅaÄÄ±daki tabloda yer aldÄ±ÄÄ± Åekilde kullanÄ±lacaktÄ±r.  Uygulamaya Ã¶zelleÅmiÅ baÅlÄ±klar "X-" ile baÅlayacaktÄ±r. BaÅlÄ±k isimlerinde yer alacak kÄ±saltmalar (Ã¶rn. PSU, ASPSP gibi) tamamÄ± bÃ¼yÃ¼k harfle yazÄ±lacak Åekilde tanÄ±mlanacaktÄ±r. BaÅlÄ±k isimleri bÃ¼yÃ¼k â kÃ¼Ã§Ã¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin x-request-id ya da X-Request-ID olarak gÃ¶nderilmiÅ olan bir istek baÅlÄ±ÄÄ± deÄiÅkeni, sunucu tarafÄ±nda hata vermeyecek Åekilde iÅlenebilmelidir. \n 3.15. Ä°stek BaÅlÄ±ÄÄ± \n \n "BaÅlÄ±k isimleri" yorumlanÄ±rken kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin "x-ReQuEsT-Id" geÃ§erli bir baÅlÄ±k ismidir. \n "BaÅlÄ±k deÄerleri" yorumlanÄ±rken ise kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harf duyarlÄ±lÄ±ÄÄ± olmalÄ±dÄ±r. ÃrneÄin "xyz123" ile "XYZ123" deÄerleri farklÄ±dÄ±r. \n BaÅlÄ±k deÄerlerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r. ÃrneÄin "PSU-Device-Data" deÄerinde "Ä°OS12" yazmak, bÃ¼yÃ¼k "Ä°" harfinin ISO-8859-1 iÃ§erisinde yer almamasÄ±ndan dolayÄ±, hataya yol aÃ§acaktÄ±r. \n Ä°stek baÅlÄ±ÄÄ±nda aÅaÄÄ±daki tabloda belirtilen alanlar dÄ±ÅÄ±nda gÃ¶nderim yapÄ±lmamalÄ±dÄ±r. \n Ä°stek baÅlÄ±ÄÄ±nda boÅ deÄer iÃ§eren bir baÅlÄ±k ismiyle gÃ¶nderim yapÄ±lmamalÄ±dÄ±r. Ãrnek; "PSU-Initiated":"" \n Ä°stek ve YanÄ±t baÅlÄ±ÄÄ±nda yer alan alanlarÄ±n; POST GET DELETE methodlarÄ±nda, OBH,HBH,GKD,OAS,ODS API\'leri bazÄ±nda Zorunlu/KoÅullu/Ä°steÄe BaÄlÄ± kullanÄ±m durumlarÄ± aÅaÄÄ±daki tabloda listelenmiÅtir. \n \n Tablo 2: Ä°stek BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n POST \n GET \n DELETE \n POST \n GET \n DELETE \n \n \n \n \n \n \n \n OBH HBH GKD \n OBH HBH GKD \n OBH HBH GKD \n OAS ODS \n OAS ODS \n OAS ODS \n \n \n X-Request-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±.   Ãrnek: Ãdeme emri baÅlatma iÅ akÄ±ÅÄ±nÄ±n her adÄ±mda farklÄ± âx-request-idâ deÄeri kullanÄ±lÄ±r.   ÃaÄrÄ±larÄ±n aynÄ± yanÄ±tÄ± dÃ¶nmesinin beklendiÄi durumlarda (idempotent iÅlemlerde) aynÄ± deÄer ile Ã§aÄrÄ± yapÄ±lÄ±r. \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±.  AynÄ± rÄ±za noâya ait tÃ¼m isteklerde aynÄ± x-group-id bilgisi deÄeri gÃ¶nderilmelidir. Ãrnek: Ãdeme emri baÅlatma/hesap bilgisi iÅ akÄ±ÅÄ±nÄ±n her adÄ±mÄ±nda aynÄ± âx-group-idâ deÄeri kullanÄ±lÄ±r. \n Z \n Z \n Z \n - \n

16- \n - \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder. Bu deÄerin application/json olarak gÃ¶nderilmesi gerekmektedir. Hata durumlarÄ±nda application/problem+json da iletilebilir.  (BaÅka bir deÄere ayarlanÄ±rsa, HHS, 415 Desteklenmeyen Ortam TÃ¼rÃ¼ (Unsupported Media Type) ile yanÄ±t vermelidir) \n Z \n - \n - \n Z \n - \n - \n \n \n X-ASPSP-Code \n AN4 \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n (HHS) kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-TPP-Code \n AN4 \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n PSU-Auth-Date \n ISODateTime \n ÃHKânÄ±n YÃS Ã¼zerinde en son oturum aÃ§tÄ±ÄÄ± saat. [RFC7231] ÃrneÄin:  auth-date: Tue, 11 Sep 2012 19:43:31 GMT \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-IP-Address \n AN7..15 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n IP adresi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-IP-Port \n AN1..5 \n ÃHK YÃS Ã¼zerinde oturum aÃ§mÄ±Åsa, iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n Port adresi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-GEO-Location \n AN1..36 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n konum bilgisi. RFC2426 standartÄ±na uygun olarak paylaÅÄ±lmalÄ±dÄ±r. ÃrneÄin  GEO:"<enlem >, <boylam>GEO:52.506931,13.144558 \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-User-Agent \n AN 1.. 255 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n saÄladÄ±ÄÄ± user-agent bilgisi. (TarayÄ±cÄ±, versiyon, iÅletim sistemi bilgileri) \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Timestamp \n ISODateTime \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± cihazÄ±n tarih saat iÃ§eren zaman bilgisi. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Device-ID \n AN5..40 \n ÃHK iÅlemi mobil uygulama aracÄ±lÄ±ÄÄ±yla baÅlattÄ±ysa, kullanÄ±lan mobil uygulama ilk yÃ¼klendiÄinde oluÅturulan tekil cihaz veya uygulama belirteci. ÃHK cihazÄ±nÄ±n UUID deÄeri kullanÄ±labilir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Device-Data \n AN1..1024 \n ÃHKânÄ±n iÅlemi baÅlattÄ±ÄÄ± mobil cihaza ait veriler.  Ãrnek alanlar:   - Platform - (Android, iOS, Windows 10 Mobile)  - Device Model   - OS Name   - OS Version - Locale - Time zone \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n PSU-Initiated \n AN1 \n Ä°Ålemin ÃHK tarafÄ±ndan baÅlatÄ±lmasÄ± durumunda E , sistem tarafÄ±ndan baÅlatÄ±ldÄ±ÄÄ± durumda H deÄerini, olay bildirimine istinaden yapÄ±lacak isteklerde O deÄerini almasÄ± beklenir. Ä°Ålemler servisinde yapÄ±lacak sistemsel sorgulardaki iÅlem limitlerini kontrol amacÄ±yla kullanÄ±lÄ±r. O deÄerinin gÃ¶nderilebileceÄi API\'ler  AsÄ±l Verinin Elde EdileceÄi API  olarak ilgili sayfada yer alan Olay Tipleri ve Kaynak Tipleri Ä°liÅkisi tablosunda yer almaktadÄ±r. AsÄ±l verinin elde edileceÄi API\'ler Ã¶zelinde O gÃ¶nderimi yapÄ±labilir. O olarak yapÄ±lan her isteÄe HHS\'nin yanÄ±t vermesi gereklidir. Otomatik sorgularda uygulanan Ã¼st limitler, O gÃ¶nderimi durumunda geÃ§erli deÄildir. \n Z \n Z \n Z \n - \n - \n - \n \n \n PSU-Fraud-Check \n AN1..4096 \n YÃS\'lerin Ã§eÅitli gÃ¼venlik kontrollerini gerÃ§ekleÅtirerek, Ã¶nemli gÃ¶rÃ¼len aÅaÄÄ±daki bilgileri HHS\'ler ile paylaÅmalarÄ± gerekmektedir. Bu bilgiler Ä±ÅÄ±ÄÄ±nda mÃ¼Återinin profili oluÅturulmasÄ±na katkÄ± saÄlanacaktÄ±r.   ÃHKâlÄ± iÅlemlerde (PSU-Initiated = E gÃ¶nderildiÄi durumlarda) gÃ¶nderilmesi zorunludur.  Sistemsel yapÄ±lan API Ã§aÄrÄ±mlarÄ±mda, Olay Bildirim Servis ÃaÄrÄ±mlarÄ±nda ve HHS-YÃS API Ã§aÄrÄ±mlarÄ±nda gÃ¶nderilmesine gerek bulunmamaktadÄ±r.  PaylaÅÄ±lacak bilgiler Åu Åekildedir.   FirstLoginFlag  : ÃHK\'nÄ±n, mÃ¼Återilik Ã¶mrÃ¼nde ilgili YÃS sistemine (mobil ya da web uygulamasÄ±) ilk login olma sÃ¼resini ifade eden deÄer. ÃHK\'nÄ±n ilk yaptÄ±ÄÄ± HBH ya da ÃBH iÅlemi deÄil, YÃS sisteminde kendini aktifleÅtirme tarih aralÄ±ÄÄ± bilgisidir.   YÃS, kullanÄ±cÄ±nÄ±n ilk login bilgisini tutarak sonraki iÅlemlerinde bu bilgiyi belirlenen format ile HHS\'ye aktaracaktÄ±r. ÃrneÄin; YÃS\'Ã¼n 7 aydÄ±r mÃ¼Återisi olan bir kullanÄ±cÄ± iÃ§in bu alan "5" olarak YÃS tarafÄ±ndan beslenecektir. Burada amaÃ§; ilgili kullanÄ±cÄ±nÄ±n YÃS\'Ã¼n eski bir mÃ¼Återisi mi, yoksa yeni bir mÃ¼Återisi mi olup olmadÄ±ÄÄ±nÄ± anlamaktÄ±r.   GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   DeviceFirstLoginFlag  : ÃHK\'nÄ±n, mÃ¼Återilik Ã¶mrÃ¼nde iÅlem anÄ±nda kullandÄ±ÄÄ± cihazla YÃS uygulamasÄ±na (web ya da uygulama tabanlÄ±) ilk login olma sÃ¼resini ifade eden deÄer. ÃHK cihaz deÄiÅikliÄi yaparsa FirstLoginFlag deÄeri sabit kalmalÄ±  ancak DeviceFirstLoginFlag deÄeri deÄiÅmelidir.  FirstloginFlag deÄeri ile ÃHKânÄ±n YÃS uygulamasÄ±na ilk login tarih bilgisi ile ilgili bilgi verilirken, DeviceFirstLoginFlag ile de ÃHKânÄ±n YÃS uygulamasÄ±na farklÄ± bir cihaz aracÄ±lÄ±ÄÄ± ile ilk login tarihinin bilgisi verilmektedir.  ÃrneÄin; ÃHK 7 aydÄ±r YÃS\'Ã¼n mÃ¼Återisi olabilir, bÃ¶yle bir durumda FirstLoginFlag deÄeri "5" olacaktÄ±r. Ancak son iÅlemini daha Ã¶nce hiÃ§ kullanmadÄ±ÄÄ± bir cihazdan yapmÄ±ÅtÄ±r. Yeni cihazdaki login sÃ¼re aralÄ±ÄÄ± 0-2 sa

16at aralÄ±ÄÄ±nda  olduÄu iÃ§in DeviceFirstLoginFlag deÄeri "1" olacaktÄ±r.FirstLoginFlag deÄeri yine "5" olarak kalmaya devam edecektir.Bu bilgi ile YÃS, ilgili HHS\'ye ilk kez geliyor olsa bile; HHS, mÃ¼Återinin YÃS\'Ã¼ uzun sÃ¼redir kullandÄ±ÄÄ±nÄ± ama yeni bir cihazla iÅlemlerine devam ettiÄini anlayabilecektir. Bir ÃHK, farklÄ± cihazlar veya platformlar Ã¼zerinden YÃS ile etkileÅime girebilir.  KullanÄ±cÄ± ve YÃS arasÄ±nda bir oturum baÅlatÄ±lmÄ±Å ise YÃSâÃ¼n tutarlÄ± ve kalÄ±cÄ± bir kimlik (device id) atamasÄ± beklenmektedir.  Device ID: Web sitesi veya mobil uygulama kullanÄ±cÄ±larÄ± iÃ§in Ã¼retilen, tarayÄ±cÄ± ya da mobil uygulama tabanlÄ± benzersiz (tekil) tanÄ±mlayÄ±cÄ± deÄer. Mobil uygulamalar iÃ§in ÃHKânÄ±n ilk defa ilgili cihaza aktivasyon yaptÄ±ÄÄ± tarih bilgisi alÄ±nmalÄ±dÄ±r.   Device ID bilgileri YÃS uygulama ortamÄ± (web ya da uygulama tabanlÄ±) ve ÃHK cihazÄ± bazÄ±nda tutulmalÄ±dÄ±r. YÃSâten baÅlatÄ±lan iÅlem hangi uygulama ortamÄ±na ait ise ilgili ortamala iliÅkili tutulan Device IDânin ilk login tarihine bakÄ±larak gÃ¼ncel flag deÄeri hesaplanmalÄ±dÄ±r.  GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   LastPasswordChangeFlag  : ÃHK\'nÄ±n, YÃS (cihaz baÄÄ±msÄ±z)  uygulamasÄ±na login olduÄu Åifre bilgisinin en son deÄiÅtirildiÄi sÃ¼reyi ifade eden deÄer. MÃ¼Återinin en son ne zaman Åifre deÄiÅikliÄi yaptÄ±ÄÄ±nÄ± anlamak iÃ§in kullanÄ±lan alandÄ±r. Yeni mÃ¼Återi ve hiÃ§ Åifre deÄiÅikliÄi yapmamÄ±Å olabilir, bÃ¶yle bir durumda ilgili alan "0" olarak beslenecektir.   GÃ¶nderilmesi Zorunlu alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   BlacklistFlag  : ÃHK\'nÄ±n herhangi bir sebeple YÃS\'Ã¼n sakÄ±ncalÄ± mÃ¼Återiler listesinde bulunup bulunmadÄ±ÄÄ±nÄ± ifade eden deÄer.   Burada amaÃ§ herhangi bir sebeple YÃS tarafÄ±nda yasaklÄ± olarak kayÄ±tlÄ± olan ÃHK bilgisinin, dolandÄ±rÄ±cÄ±lÄ±ÄÄ± Ã¶nceden tespit etmek amaÃ§lÄ± HHS\'ye aktarÄ±lmasÄ± olarak aÃ§Ä±klanabilir. ÃrneÄin, YÃS tarafÄ±ndan tespit edilen dolandÄ±rÄ±cÄ± kullancÄ±lara ait device id bilgisi, bu kara listede tutulur daha sonra aynÄ± cihazla baÅka bir ÃHK iÅlem yapacak olsa bile bu alanda ilgili bilgi "1" deÄeri ile HHS\'ye aktarÄ±lÄ±r. HHS\'de olmayÄ±p YÃS tarafÄ±nda olan bu Ã¶rnekteki sakÄ±ncalÄ± mÃ¼Återi/cihaz bilgisinin, dolaylÄ± yoldan HHS\'ye aktarÄ±lmasÄ± amaÃ§lanmaktadÄ±r.  GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.VarYok sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   MalwareFlag  : YÃS uygulamasÄ±nÄ±n Ã§alÄ±ÅtÄ±ÄÄ± cihaz Ã¼zerindeki son 21 gÃ¼ne ait zararlÄ± yazÄ±lÄ±m tespit bilgisini ifade eden deÄer. ÃrneÄin ÃHK\'nÄ±n cihazÄ±nda zararlÄ± yazÄ±lÄ±m olduÄu ayÄ±n 1\'inde YÃS tarafÄ±ndan tespit edildi. ZararlÄ± yazÄ±lÄ±m tespitinden 2 saat sonra YÃS Ã¼zerinden login olan ÃHK\'nÄ±n durumu,  "1" olarak iletilecektir. Bir gÃ¼n sonra ayÄ±n 2\'sinde, yeni bir zararlÄ± yazÄ±lÄ±m tespiti yok ancak mevcut zararlÄ± yazÄ±lÄ±m aktifse alan "2" deÄeri ile iletilecektir. SÃ¼reler artarak 21 gÃ¼ne kadar TR.OHVPS.DataCode.ZmnAralik deÄerlerine gÃ¶re iletilecektir.Son 21 gÃ¼n iÃ§inde yeni bir tespit yoksa ayÄ±n 22\'sinden itibaren ilgili alan  "0" deÄeri ile beslenecektir. Not: ZararlÄ± yazÄ±lÄ±m, bankacÄ±lÄ±k iÅlemlerinin yapÄ±ldÄ±ÄÄ± uygulamalara giriÅte kullanÄ±lan bilgilerin (Åifre, kullanÄ±cÄ± kodu gibi) ele geÃ§irilmesi amacÄ±yla kullanÄ±lan bir uygulama ya da kod parÃ§acÄ±ÄÄ± olabilir. Bu amaÃ§lar dÄ±ÅÄ±nda kullanÄ±lan (bankacÄ±lÄ±Äa yÃ¶nelik bir zararlÄ± yazÄ±lÄ±m olmayan) yazÄ±lÄ±m tespitleri iletilmemelidir. YÃS kanallarÄ±na her bir loginde, kullanÄ±lan cihazda bir zararlÄ± yazÄ±lÄ±m var mÄ± yok mu kontrolÃ¼ yapÄ±lmalÄ±dÄ±r.   GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   AnomalyFlag  : DiÄer ÅÃ¼pheli durumlarÄ±n varlÄ±ÄÄ±nÄ± ifade eden deÄer. GÃ¶nderilmesi Opsiyonel alandÄ±r. TR.OHVPS.DataCode.VarYok sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.   UnsafeAccountFlag : HHS tarafÄ±ndan aktarÄ±lan bilgi ile son 21 gÃ¼n iÃ§inde ÃHK\'nÄ±n dolandÄ±rÄ±cÄ±lÄ±k maÄduru olmasÄ± durumunu ifade eden deÄer. ÃrneÄin; HHS 1, ayÄ±n 1\'inde sÃ¼phe veya sahtekarlÄ±k nedeniyle bir Ã¶deme iÅlemine izin vermediÄi durumda, bu bilgiyi rÄ±za iptal detay kodu ile YÃS\'e aktarmÄ±Å olur. Bu bilgiyi tutan YÃS, ilgili mÃ¼Återinin 15 dakika sonra HHS 2\'de yaptÄ±ÄÄ± iÅlem iÃ§in ilgili alanÄ± "1" deÄeri ile besler. BÃ¶ylece HHS 2, ÃHK\'nÄ±n farklÄ± bir HHS\'de son 15 dakika iÃ§inde ÅÃ¼pheli veya sahte bir iÅlemi olduÄunu anlayabilecektir. AyÄ±n 22\'sinde yeni bir tespit/kayÄ±t yoksa bu alan YÃS tarafÄ±ndan "0" olarak beslenecektir. GÃ¶nderilmesi Opsiyonel alandÄ±r.TR.OHVPS.DataCode.ZmnAralik sÄ±ralÄ± veri tipinin alabileceÄi deÄerleri alabilir.     Flaglar JWT claims iÃ§ine key value Åeklinde eklenerek gÃ¶nderilecektir. EK-5: Mesaj Ä°mzalama AkÄ±ÅÄ±\'nda belirtilen yÃ¶ntemle imzalanarak oluÅturulan JWT PSU-Fraud-Check alanÄ±na konularak YÃS\'ler tarafÄ±ndan HHS\'ye iletilmelidir. \n K \n K \n Z \n - \n

16- \n - \n \n \n PSU-Session-ID \n AN1..100 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen oturuma Ã¶zgÃ¼ talep kimliÄi. ÃHK\'nÄ±n YÃS uygulamasÄ± Ã¼zerinden kimlik doÄrulama mekanizmasÄ± ile bilgi sistemlerine dÃ¢hil olmalarÄ±ndan iÅlemlerini tamamlayÄ±p sistemden ayrÄ±lmalarÄ±na kadar geÃ§ecek tÃ¼m sÃ¼reci kapsayacak Åekilde aynÄ± deÄeri almalÄ±dÄ±r. Tek seferlik Ã¶deme gibi ÃHKânÄ±n tanÄ±nmadan baÅlatÄ±ldÄ±ÄÄ± iÅlemlerde bu deÄer boÅ olarak iletilmelidir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n Authorization \n AN1..4096 \n KatÄ±lÄ±mcÄ± ile GEÃÄ°T arasÄ±ndaki otorizasyon iÃ§in kullanÄ±lan token bilgisidir.  Yekilendirme tÃ¼rlerinden Ä°stemci Kimlik Bilgileriâni adresler.    BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. \n Z \n Z \n Z \n Z \n Z \n Z \n \n \n X-Access-Token \n AN1..4096 \n ÃHKânÄ±n GKD sÃ¼recinde doÄrulanmasÄ± sonrasÄ±nda kullanÄ±lan eriÅim simgesi. Yetkilendirme tÃ¼rlerinden Yetkilendirme Kodu (GKD)ânu adresler.  BÃ¶lÃ¼m 3.6 Karakter Kodlama  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanan karakter formatÄ±nda gÃ¶nderilmesi beklenmektedir. \n Ä° \n Ä° \n Ä° \n - \n - \n - \n \n \n X-JWS-Signature \n AN1..4096 \n Payload gÃ¶vdesinin ayrÄ±lmÄ±Å bir JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi.  Bu baÅlÄ±ÄÄ±n ne zaman belirtilmesi gerektiÄi hususu ilgili endpoint iÃ§in belirtilmiÅtir.  Mesaj imzalama kullanÄ±lan API ve methoda gÃ¶re gÃ¶nderimi zorunludur. \n K \n K \n K \n K \n - \n - \n \n \n X-Agent-Code \n AN5 \n Temsilci kodunu ifade etmektedir. Bu kod, YÃSâlerin ÃHVPS kapsamÄ±ndaki hizmetleri temsilcilik iliÅkisi Ã§erÃ§evesinde Ã¼Ã§Ã¼ncÃ¼ taraflar aracÄ±lÄ±ÄÄ±yla sunabilmesi amacÄ±yla BKMâye yapÄ±lan baÅvurunun uygun bulunmasÄ±nÄ±n ardÄ±ndan BKM tarafÄ±ndan atanÄ±r. Temsilci aracÄ±lÄ±ÄÄ±yla gerÃ§ekleÅtirilen tÃ¼m iÅlemlerde, ilgili temsilciye ait X-Agent-Code bilgisinin request headerâÄ±nda iletilmesi zorunludur. HHSâler, YÃSâler tarafÄ±ndan iletilen X-Agent-Code bilgisini kendi sistemlerinde saklayabilir ve iÅlem kayÄ±tlarÄ±yla iliÅkilendirebilir. \n K \n K \n K \n K \n K \n K \n 3.16. YanÄ±t BaÅlÄ±ÄÄ± \n \n "BaÅlÄ±k isimleri" yorumlanÄ±rken kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harfe duyarlÄ± olmamalÄ±dÄ±r. ÃrneÄin "x-ReQuEsT-Id" geÃ§erli bir baÅlÄ±k ismidir. \n "BaÅlÄ±k deÄerleri" yorumlanÄ±rken ise kÃ¼Ã§Ã¼k bÃ¼yÃ¼k harf duyarlÄ±lÄ±ÄÄ± olmalÄ±dÄ±r. ÃrneÄin "xyz123" ile "XYZ123" deÄerleri farklÄ±dÄ±r. \n BaÅlÄ±k deÄerlerinde ISO-8859-1 standartÄ±nda yer alan karakter kÃ¼mesi kullanÄ±lmalÄ±dÄ±r. ÃrneÄin "Link" deÄerinde "Ä°OS12" yazmak, bÃ¼yÃ¼k "Ä°" harfinin ISO-8859-1 iÃ§erisinde yer almamasÄ±ndan dolayÄ±, hataya yol aÃ§acaktÄ±r. \n YanÄ±t baÅlÄ±ÄÄ±nda aÅaÄÄ±daki tabloda belirtilen alanlar dÄ±ÅÄ±nda gÃ¶nderim yapÄ±lmamalÄ±dÄ±r. \n YanÄ±t baÅlÄ±ÄÄ±nda boÅ deÄer iÃ§eren bir baÅlÄ±k ismiyle gÃ¶nderim yapÄ±lmamalÄ±dÄ±r. Ãrnek; "PSU-Initiated":"" \n \n Tablo 3: YanÄ±t BaÅlÄ±ÄÄ±nda Yer Alan Veriler \n \n \n \n BaÅlÄ±k Ä°simleri \n Format \n Notlar \n KullanÄ±m Durumu  OBH HBH GKD \n KullanÄ±m Durumu  OAS ODS \n \n \n \n \n X-Request-ID \n AN1..36 \n YÃS tarafÄ±ndan belirlenen Ã§aÄrÄ±ya Ã¶zgÃ¼ talep kimliÄi. Ä°stek numarasÄ±    Ä°lgili istek baÅlÄ±ÄÄ±ndaki bilgi geri dÃ¶nÃ¼lÃ¼r. \n Z \n Z \n \n \n X-Group-ID \n AN1..36 \n Ä°steÄi baÅlatan YÃS tarafÄ±ndan belirlenen iÅlem akÄ±ÅÄ±na Ã¶zgÃ¼ talep kimliÄi. Ä°Ålem grup numarasÄ±. Ä°lgili istek baÅlÄ±ÄÄ±ndaki bu deÄer geri dÃ¶nÃ¼lÃ¼r. \n Z \n - \n \n \n X-ASPSP-Code \n AN4 \n Hesap Hizmeti SaÄlayÄ±cÄ±sÄ±nÄ±n (HHS) kodudur. (Nezdinde ÃH bulunduran kuruluÅ kodu. ÃrneÄin, Banka, Elektronik Para KuruluÅu ve Ãdeme KuruluÅu) \n Z \n Z \n \n \n X-TPP-Code \n AN4 \n Yetkili Ãdeme Hizmeti SaÄlayÄ±cÄ±sÄ± (YÃS) kodudur \n Z \n Z \n \n \n Content-Type \n AN1..20 \n Standart HTTP BaÅlÄ±ÄÄ±; Talepte saÄlanan payloadâÄ±n biÃ§imini temsil eder:  application/json \n Z \n Z \n \n \n X-JWS-Signature \n AN1..4096 \n JWS imzasÄ±nÄ± iÃ§eren Ã¼stbilgi. Bu baÅlÄ±ÄÄ±n hangi yanÄ±tlar iÃ§in kullanÄ±lmasÄ± gerektiÄi ilgili endpoint iÃ§in belirtilmiÅtir.  Hata durumlarÄ±nda, yanÄ±t gÃ¶vdesi deÄeri dÃ¶nÃ¼lÃ¼yor ise imzalanmalÄ± ve imza bilgisi x-jws-signature alanÄ±nda iletilmelidir.  Ancak uygulama katmanÄ± tarafÄ±ndan yakalanamayan dolayÄ±sÄ± ile imzalanamayan hata durumlarÄ±nda x-jws-signature alanÄ± HHS\'ler tarafÄ±ndan boÅ gÃ¶nderilebilir.  HatalÄ± yanÄ±t alÄ±ndÄ±ÄÄ± durumlarda ise X-JWS-Signature baÅlÄ±k deÄeri dolu ise doÄrulama yapÄ±lmalÄ±dÄ±r. (4**, 5**) \n K \n K \n \n \n X-RateLimit-Limit \n N 1..18 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde en fazla kaÃ§ adet istek yapÄ±labileceÄini gÃ¶sterir. KÄ±sÄ±t uygulanan servislerde bu baÅlÄ±ÄÄ±n dÃ¶nmesi zorunludur. \n K \n

16- \n \n \n X-RateLimit-Remaining \n N 1..18 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde kaÃ§ adet istek hakkÄ± kaldÄ±ÄÄ±nÄ± gÃ¶sterir. KÄ±sÄ±t uygulanan servislerde bu baÅlÄ±ÄÄ±n dÃ¶nmesi zorunludur. \n K \n - \n \n \n X-RateLimit-Reset \n AN 1..255 \n Ä°stek kÄ±sÄ±tÄ± uygulanan servislerde Ã§aÄrÄ±m hakkÄ± bittikten sonra yeniden denemeden Ã¶nce beklemesi gereken sÃ¼reyi (saniye cinsinden) gÃ¶sterir. HTTP 429 durum kodu (Too Many Requests) ile dÃ¶nÃ¼len yanÄ±tlarÄ±n baÅlÄ±ÄÄ±nda dÃ¶nÃ¼lmesi zorunludur.  YÃS olarak yaptÄ±ÄÄ±nÄ±z sistemsel sorgularda; HTTP 429 durum kodu (Too Many Requests) ile dÃ¶nÃ¼len yanÄ±t aldÄ±ÄÄ±nÄ±zda tekrar sorgu yapmadan Ã¶nce âX-RateLimit-Resetâ yanÄ±t baÅlÄ±ÄÄ±nÄ± kontrol ederek, bu baÅlÄ±ktaki sÃ¼re kadar bekledikten sonra yeniden sorgulama yapÄ±lmasÄ± gerekmektedir. \n K \n - \n \n \n x-total-count \n N 1..18 \n Hesaplar, Ä°Ålemler, Bakiye, Ä°letilemeyen Olaylar servislerinde sayfalama kullanÄ±ldÄ±ÄÄ± durumda, sorgu sonucu dÃ¶necek toplam kayÄ±t sayÄ±sÄ± bilgisi, bu alanda HHS isteÄine baÄlÄ± olarak gÃ¶nderilebilir.   KayÄ±t sayÄ±sÄ± 0 olduÄu durumda gÃ¶nderimi zorunludur. \n K \n K \n \n \n Link \n 1..4096 \n âLinkâ alanÄ±nÄ±n  Hesap Bilgisi Hizmeti iÃ§in EriÅim Adresleri    tablosundaki parametre  = Sayfalama olan APIâlerde ve Ä°letilemeyen Olaylar API\'sinde gÃ¶nderim yapÄ±lmasÄ± zorunludur.  Sayfalama yapÄ±sÄ± kullanÄ±ldÄ±ÄÄ±nda gelen yanÄ±tta birden fazla sayfa var ise; Ã¶nceki, sonraki, ilk, son sayfalara gitmek iÃ§in gerekli referanslar link headerÄ±nda aÅaÄÄ±daki Ã¶rnekteki gibi doldurulabilir.  x-total-count alanÄ±nÄ±n gÃ¶nderimi kayÄ±t sayÄ±sÄ± 0 olduÄu durum dÄ±ÅÄ±nda isteÄe baÄlÄ± olduÄu iÃ§in; Link iÃ§erisindeki son sayfa bilgisi  (last) isteÄe baÄlÄ± hale getirilmiÅtir. âÃncekiâ( prev) ve âSonrakiâ (next) adÄ±mlarÄ±nÄ±n uygun olan her durumda yer almasÄ± zorunludur. Ä°lk sayfada âÃncekiâ seÃ§eneÄi olmamalÄ±, son sayfada ise âSonrakiâ seÃ§eneÄi olmamalÄ±dÄ±r.    </ohvps/hbh/s2.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=6&syfKytSayi=100>; rel="next",  </ohvps/hbh/s2.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=4&syfKytSayi=100>; rel="prev",  </ohvps/hbh/s2.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=14&syfKytSayi=100>; rel="last",  </ohvps/hbh/s2.0/hesaplar/hspref/islemler?hesapIslemBslTrh=2022-01-01T00:00:00+03:00&hesapIslemBtsTrh=2023-12-12T23:59:59+03:00&srlmKrtr=islGrckZaman&srlmYon=Y&syfNo=0&syfKytSayi=100>; rel="first"    HiÃ§ hesap hareketinin olmadÄ±ÄÄ± durumda dÃ¶nen yanÄ±t baÅlÄ±ÄÄ±nÄ±zÄ±n Åu Åekilde olmasÄ± beklenmektedir.  Response body: [] Response header: Link: </ohvps/hbh/s2.0/hesaplar?srlmKrtr=hspRef&srlmYon=A&syfNo=1&syfKytSayi=100>; rel="last",</ohvps/hbh/s2.0/hesaplar?srlmKrtr=hspRef&srlmYon=A&syfNo=1&syfKytSayi=100>; rel="first"  x-total-count alanÄ± da 0 olarak iletilmelidir. \n K \n K \n 3.17. Idempotency KurallarÄ± \n YÃSâÃ¼n aÅaÄÄ±daki durumlarda aynÄ± istek numarasÄ± (x-request-id) ve aynÄ± veri gÃ¶vdesiyle Ã§aÄrÄ±yÄ± tekrarlamasÄ±; HHSânin de bu durumlarda aynÄ± yanÄ±tÄ± dÃ¶nmesi gereklidir. \n \n HHSânin yanÄ±tÄ± kesinti/arÄ±za nedeniyle YÃSâe ulaÅmaz ve zaman aÅÄ±mÄ± sÃ¶z konusu olmasÄ±, \n ÃHK, YÃS uygulamasÄ± Ã¼zerinden Ã§ift tÄ±klama ile mÃ¼kerrer defa HHS APIâlerini Ã§aÄÄ±rÄ±lmasÄ±,\n(API kontrollerinden Ã¶nce YÃS uygulamasÄ±nÄ±n, Ã§ift tÄ±klama kontrolÃ¼ yapmasÄ± Ã¶nerilmektedir.) \n YÃS, yanÄ±t almasÄ±na raÄmen iÅleyemeden kaybedilmesi, \n \n durumlarÄ±nda HHS aÅaÄÄ±daki kurallarÄ± iÅletir: \n \n HHS gelen istek numarasÄ±nÄ± ve veri gÃ¶vdesini birleÅtirerek checksum deÄeri Ã¼retir. \nchesksum deÄeri x-request-id|request.body ânin hash algoritmalarÄ±ndan (CRC32,MD5 vb)  geÃ§irilerek Ã¼retilebilir. \n HHS bu checksum deÄeri ile YÃSâe dÃ¶nmÃ¼Å olduÄu yanÄ±tÄ± 5 dk boyunca saklar.  Saklama yÃ¶ntemi olarak veri tabanÄ± veya Ã¶nbellek araÃ§larÄ± kullanÄ±labilir. \n YÃS aynÄ± istek numarasÄ± ve aynÄ± veri gÃ¶vdesi ile yeni bir Ã§aÄrÄ± yaptÄ±ÄÄ±nda, aynÄ± checksum deÄeri Ã¼retileceÄi iÃ§in 5dk boyunca bu deÄere karÅÄ±lÄ±k gelen yanÄ±tÄ± dÃ¶ner. \n 5 dk sonrasÄ±nda istek numarasÄ± veya veri gÃ¶vdesi deÄiÅmemiÅ olsa dahi bu HHS tarafÄ±ndan yeni istek olarak kabul edilir. \n \n AÅaÄÄ±daki Public Post iÅlemleri iÃ§in bu kural setinin iÅletilmesi gerekmektedir: \n 1- Ãdeme emri rÄ±zasÄ± oluÅturma \n2- EriÅim belirteci oluÅturma \n3- Ãdeme emri \n4- Hesap bilgisi rÄ±zasÄ± oluÅturma \n5- Ä°leri Tarihli Ãdeme Emri RÄ±zasÄ± oluÅturma \n6- Ä°leri Tarihli Ãdeme Emri \n7- DÃ¼zenli TekrarlÄ± Ãdeme Emri RÄ±zasÄ± oluÅturma \n8- DÃ¼zenli TekrarlÄ± Ãdeme Emri \n 3.18. HTTP Durum KodlarÄ± \n RFC 2616\'da belirlenmiÅ olan durum ko

16dlarÄ± (status code) gÃ¶nderilen isteÄin durumunu YÃSâa standart bir Åekilde ifade eder. EÄer bir hata varsa hatayÄ±, gÃ¶nderilen istek baÅarÄ±lÄ± bir Åekilde iÅlem gÃ¶rdÃ¼yse ona iliÅkin durumu aktarÄ±r. Durum kodlarÄ± genel olarak 5 kategoridedir. \n \n 1xx Bilgi \n 2xx BaÅarÄ±lÄ± \n 3xx YÃ¶nlendirme \n 4xx Ä°stemci HatasÄ± \n 5xx Sunucu HatasÄ± \n \n errorCode AlanÄ±nda KullanÄ±labilecek SÄ±ralÄ± Hata Tipleri : \n \n TR.OHVPS.Resource \n \n â¨\tInvalidFormat \n â¨\tConsentMismatch \n â¨\tNotFound \n â¨\tInvalidSignature \n â¨\tMissingSignature \n â¨\tMethodNotAllowed \n â¨\tNotAcceptable \n â¨\tUnsupportedMediaType \n â¨\tConsentRevoked \n \n \n \n TR.OHVPS.Business \n \n â¨\tInvalidContent \n â¨\tInvalidAccount \n \n \n \n TR.OHVPS.Connection \n \n â¨\tInvalidCertificate \n â¨\tExceededRate \n â¨\tInvalidTPP \n â¨\tInvalidASPSP \n â¨\tInvalidToken \n â¨\tInvalidTPPRole \n \n \n \n TR.OHVPS.Server \n \n â¨\tInternalError \n â¨\tServiceUnavailable \n \n \n TR.OHVPS.Resource.InvalidFormat hatasÄ± alÄ±ndÄ±ÄÄ± durumda; fieldErrors nesnesi iÃ§erisinde verilecek hata kodlarÄ± : \n \n TR.OHVPS.Field \n \n â¨\tMissing \n â¨\tInvalid \n \n \n Veri Tipi ÃrneÄi: \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "d8bd4e5f-f094-48a6-aee1-3a800e2709d9" , \n     "timestamp" :   "2022-12-22T10:33:15+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "fieldErrors" :   [ \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.islTtr.prBrm" , \n             "messageTr" :   "boÅ deÄer olamaz" , \n             "message" :   "must not be null" , \n             "code" :   "TR.OHVPS.Field.Missing" \n         } , \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.kmlk.kmlkVrs" , \n             "messageTr" :   "boyut \'1\' ile \'30\' arasÄ±nda olmalÄ±" , \n             "message" :   "size must be between 1 and 30" , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } \n     ] , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" \n }  \n \n Tablo 4: HTTP Durum KodlarÄ± \n \n \n \n HTTP Durum \n Ä°stek Sonucu ve AÃ§Ä±klamalar \n POST \n GET \n DELETE \n \n \n \n \n 200 OK \n Ä°stek BaÅarÄ±yla TamamlandÄ±. Kaynak gÃ¼ncellemek iÃ§in yapÄ±lan (Ã¶rneÄin, GET) ve baÅarÄ±yla tamamlanan isteklerinde kullanÄ±lÄ±r. \n H \n E \n H \n \n \n 201 Created \n Ä°stek BaÅarÄ±lÄ± Oldu. Kaynak yaratma isteÄi (Ã¶rneÄin, POST /Ã¶deme-emri-rizasi) baÅarÄ±yla sonuÃ§landÄ±. \n E \n H \n H \n \n \n 204 No Content \n Silme iÅlemi baÅarÄ±yla tamamlandÄ±. Kaynak silme isteÄi (Ã¶rneÄin,  DELETE /hesap-rizasi/{RizaNo} ) baÅarÄ±yla sonuÃ§landÄ±. \n H \n H \n E \n \n \n 400 Bad Request \n Ä°stekte bozuk, eksik veya uyumlu olmayan JSON gÃ¶vdesi, URL parametreleri veya baÅlÄ±k alanlarÄ± var.  Ä°stekle baÅlatÄ±lan iÅlem yapÄ±sal bozukluk, eksik veya tutarsÄ±z veri veya HHS tarafÄ±ndaki kontrollerin hatalÄ± sonuÃ§lanmasÄ± nedeniyle hata ile sonuÃ§lanÄ±r ve hataya iliÅkin veriler hata nesnesi iÃ§erisinde dÃ¶nÃ¼lÃ¼r. \n E \n E \n E \n \n \n 401 Unauthorized \n Yetkilendirme baÅlÄ±ÄÄ± eksik, hatalÄ± veya geÃ§ersiz olduÄundan istek yetkilendirilmediÄinde ve eriÅim reddedildiÄinde http 401 kodu dÃ¶nÃ¼lmelidir. \n E \n E \n E \n \n \n 403 Forbidden \n EriÅim belirtecinin veya rÄ±zanÄ±n kapsamÄ± uyuÅmuyor. YÃS bir hesaba/iÅlem kaynaÄÄ±na eriÅmeye Ã§alÄ±ÅÄ±r ve YÃS, istenen kaynaÄa eriÅmek iÃ§in geÃ§erli izinlere sahip bir rÄ±zasÄ± yoktur.  ÃrneÄin; hesap bilgisi rÄ±zasÄ± bakiye izni almamÄ±ÅtÄ±r ancak /bakiyeler adresinden istekte bulunmuÅtur. \n \n \n \n \n \n 404 Not Found \n **HHS geÃ§erli bir API eriÅim adresini saÄlamÄ±yorsa, o URL\'ye gelen istekler iÃ§in 404 (BulunamadÄ±) ile yanÄ±t vermelidir.**YÃS, uygulama esaslarÄ±nda tanÄ±mlanmayan bir

16kaynak iÃ§in bir URL\'ye eriÅmeye Ã§alÄ±ÅÄ±rsa (Ã¶rneÄin, GET /yurtdisi-odeme), HHS, 404 (BulunamadÄ±) ile yanÄ±t vermeyi seÃ§ebilir. \n E \n E \n E \n \n \n 405 Method Not Allowed \n YÃS, desteklenmeyen bir yÃ¶ntemle kaynaÄa eriÅmeye Ã§alÄ±ÅtÄ±. \n E \n E \n E \n \n \n 406 Not Acceptable \n Ä°stek, geÃ§ersiz bir karakter kÃ¼mesi iÃ§eriyor. \n E \n E \n E \n \n \n 415 Unsupported Media Type \n Ä°stek gÃ¶vdesi hedef kaynakta bu yÃ¶ntem tarafÄ±ndan desteklenmeyen bir biÃ§imde oluÅturulduÄu iÃ§in iÅlem reddedildi \n E \n H \n H \n \n \n 429 Too Many Requests \n Belirli bir sÃ¼re iÃ§inde Ã§ok fazla talepte bulunulduÄu iÃ§in iÅlem reddedildi.  HHSâler adil kullanÄ±m politikalarÄ±nÄ± aÅan talepleri kÄ±sÄ±tlayabilir. \n E \n E \n E \n \n \n 500 Internal Server Error \n API sunucu / servis katmanÄ±nda sorun oluÅtu. Ä°Ålem baÅarÄ±sÄ±z.  5XX hata durumlarÄ±nda yanÄ±t gÃ¶vde deÄeri olmadÄ±ÄÄ± iÃ§in mesaj imzalama yapÄ±lamaz ve x-jws-signature alanÄ± boÅ olarak iletilir.  Bu durumda x-jws-signature kontrolÃ¼ yapÄ±lmamalÄ±dÄ±r. \n E \n E \n E \n \n \n 503 Service Unavailable \n Hizmet sÃ¼rÃ¼mÃ¼ kullanÄ±mdan kaldÄ±rÄ±ldÄ±.  Bir API\'nin kullanÄ±mdan kaldÄ±rÄ±ldÄ±ÄÄ± ve artÄ±k bir HHS tarafÄ±ndan operasyonel olarak desteklenmediÄi durumlarda, URI yolu hala etkin olabilir ve API isteklerini kabul edebilir.  Bu durumda, YÃS\'Ã¼n API sÃ¼rÃ¼mÃ¼nÃ¼n Ã§evrimdÄ±ÅÄ± olduÄunun farkÄ±nda olmasÄ± iÃ§in 503 Hizmet KullanÄ±lamÄ±yor dÃ¶nmesi Ã¶nerilir. \n E \n E \n E \n \n \n \n Ä°Å kurallarÄ± nezdinde ilgili hata kodlarÄ± Ã¶zelleÅtirilmiÅ olup HHS tarafÄ±ndan verilecek olan hata kodlarÄ± ÃHVPS API Ä°lke ve KurallarÄ± dokÃ¼manÄ±nda ilgili alanlarda paylaÅÄ±lmÄ±ÅtÄ±r. Bu Ã§alÄ±Åmaya ek olarak, HHS\'lerin YÃS\'lere; YÃS\'lerin de ÃHK\'lara iletecekleri hata mesaj iÃ§eriklerinde standartlaÅmaya gidilmiÅtir. Bu Ã§alÄ±Åmaya TÃ¼rkiye\'nin Ä°letiÅim Platformu altÄ±nda yer alan ÃHVPS > DokÃ¼manlar alanÄ±ndan ulaÅabilirsiniz. HHS\'lerin ve YÃS\'lerin ilgili dokÃ¼manÄ± referans alarak mesaj iÃ§eriklerini, kurumlarÄ±n kendi mÃ¼Återi iletiÅim dili kapsamÄ±nda dÃ¼zenleyerek ÃHK\'lara gÃ¶sterebilir olmasÄ± beklenmektedir. \n Hata Ãrnekleri: \n 400 Bad Request \n TR.OHVPS.Resource.InvalidFormat  hatasÄ± Åema validasyonu, alan uzunluk ve varlÄ±k kontrollerinin baÅarÄ±sÄ±z olduÄu durumda verilmelidir. \n \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "7f115b9c-d7c2-4a2a-bc45-5a9891c79072" , \n     "timestamp" :   "2022-12-22T10:47:57+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "fieldErrors" :   [ \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.alc.unv" , \n             "messageTr" :   "boyut \'3\' ile \'140\' arasÄ±nda olmalÄ±" , \n             "message" :   "size must be between 3 and 140" , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } , \n         { \n             "objectName" :   "odemeEmriRizasiIstegi" , \n             "field" :   "odmBsltm.islTtr.ttr" , \n             "messageTr" :   "boÅ deÄer olamaz" , \n             "message" :   "must not be null" , \n             "code" :   "TR.OHVPS.Field.Missing" \n         } \n     ] , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" \n }  \n\n \n Zorunlu header alanlarÄ±ndan biri ya da birkaÃ§Ä± eksik olarak gÃ¶nderilirse aÅaÄÄ±daki gibi bir hata dÃ¶nÃ¼ÅÃ¼ gerÃ§ekleÅebilir. \n HHS uygulamasÄ± tarafÄ±ndan dÃ¶nÃ¼lebilecek hata Ã¶rnekleri: \n \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "2005515d-f0e6-4a07-a439-0ef3b0f56011" , \n     "timestamp" :   "2022-12-22T10:39:26+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Validation error" , \n     "moreInformationTr" :   "Åema kontrolleri baÅarÄ±sÄ±z" , \n     "errorCode" :   "TR.OHVPS.Resource.InvalidFormat" , \n     "fieldErrors" :   [ \n         {          \n             "field" :   "X-Request-ID" , \n             "messageTr" :   "X-Request-ID deÄeri boÅ olamaz." , \n             "message" :   "X-Request-ID cannot be null." , \n             "code" :   "TR.OHVPS.Field.Invalid" \n         } \n     ] \n }  \n\n \n Business hata Ã¶rneÄi - 1: \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "677cfd9d-77c1-4ea3-8bdf-74a6e9887177" , \n     "timestamp" :   "2022-12-22T11:05:59+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "gonUnvan wrong" , \n     "moreInformationTr" :   "GÃ¶nderen Ãnvan hatalÄ±" , \n     "errorCode" :   "TR.OHVPS.Business.IncorrectSenderTitle" \n }  \n \n Business hata Ã¶rneÄi - 2: \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "5df3b402-3aca-4305-a35b-5af0f3184b40" , \n     "timestamp" :   "2022-12-22T11:06:47+03:00" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" , \n     "moreInformation" :   "Sender account is disabled or not found." , \n     "moreInformationTr" :   "Gonderen hesap aktif deÄil veya bulunamadÄ±." , \n     "errorCode" :   "TR.OHVPS.Business.InvalidAccount" \n }  \n \n GEÃÄ°T\'te yapÄ±lan zorunlu header kontrollerinde aÅaÄÄ±daki hatalar dÃ¶nebilir: \n \n { \n     "timestamp" :   "2022-12-22T10:40:28+03:00" , \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "d4375748-6fc7-4f7e-94f3-6411cab1d59f" , \n     "moreInformationTr" :   "GeÃ§ersiz HHS kodu." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidASPSP" , \n     "moreInformation" :   "Invalid ASPSP Code" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" \n }  \n \n GEÃÄ°T tarafÄ±ndan dÃ¶nÃ¼lecek hata Ã¶rneÄi: \n \n { \n     "timestamp" :   "2022-12-22T10:40:28+03:00" , \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "d4375748-6fc7-4f7e-94f3-6411cab1d59f" , \n     "moreInformationTr" :   "GeÃ§ersiz HHS kodu." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidTPP" , \n     "moreInformation" :   "Invalid TPP Code" , \n     "httpCode" :   400 , \n     "httpMessage" :   "Bad Request" \n }  \n \n GEÃÄ°T tarafÄ±ndan dÃ¶nÃ¼lecek hata Ã¶rneÄi: \n \n { \n     "timestamp" :   "2022-12-22T11:14:05+03:00" , \n     "path" :   "/ohvps/hbh/s2.0/hesap-bilgisi-rizasi" , \n     "id" :   "ee1e3ea7-a5e5-468b-bb02-314148f84e6a" , \n     "moreInformationTr" :   "GeÃ§ersiz yÃ¶s rolÃ¼. Ä°lgili api Ã§aÄrÄ±sÄ± iÃ§in yetkisi yok." , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidTPPRole" , \n     "moreInformation" :   "Invalid TPP Role" , \n     "httpCode" :   403 , \n     "httpMessage" :   "Forbidden" \n }  \n\n \n 401 Unauthorized \n YÃS, sÃ¼resi dolmuÅ bir eriÅim belirteci kullandÄ±ÄÄ±nda, HHS 401 (Yetkisiz) http kodu ile aÅaÄÄ±daki hata kodunu dÃ¶nmelidir.  AÅaÄÄ±daki nedenlerden herhangi biri nedeniyle bir EriÅim Belirtecinin sÃ¼resi dolduÄunda bu durum ortaya Ã§Ä±kabilir: \n \n RÄ±zanÄ±n sÃ¼resi doldu (Son Kullanma Tarihi geÃ§ti) \n EriÅim Belirtecinin ÅÃ¼pheli kullanÄ±mÄ± veya sahtekarlÄ±k ÅÃ¼phesi \n RÄ±zada belirlenen gÃ¼n s

16ayÄ±sÄ±nÄ±n aÅÄ±mÄ±\nBu hata, mÃ¼Återiden doÄru izinlerle yeniden kimlik doÄrulamasÄ± isteyerek Ã§Ã¶zÃ¼lebilir. \n \n \n { \n     "path" :   "/ohvps/gkd/s2.0/erisim-belirteci" , \n     "id" :   "ed3fd667-fc58-40ad-a982-e8937faccd15" , \n     "timestamp" :   "2022-12-22T11:17:33+03:00" , \n     "httpCode" :   401 , \n     "httpMessage" :   "Unauthorized" , \n     "moreInformation" :   "Refresh token expired or not found in database" , \n     "moreInformationTr" :   "Yenileme belirteci zaman aÅÄ±mÄ±na uÄramÄ±Å veya veri tabanÄ±nda yok" , \n     "errorCode" :   "TR.OHVPS.Connection.InvalidToken" \n }  \n \n\n \n 403 Forbidden \n Ãrn; YÃS yetkisi olmayan rol(ÃBH/HBH) ile iÅlem yapmaya Ã§alÄ±ÅtÄ±ÄÄ± durumda 403 hatasÄ± alarak iÅleme devam edemez. \n { \n   "path" :   "/ohvps/hbh/s2.0/bakiye" , \n   "id" :   "3e48ea98-f889-48b9-aa6e-28aabc6cfb14" , \n   "timestamp" :   "2022-12-22T11:20:05+03:00" , \n   "httpCode" :   403 , \n   "httpMessage" :   "Forbidden" , \n   "moreInformation" :   "Forbidden" , \n   "moreInformationTr" :   "Bakiye Bilgileri iÃ§in ÃHK izni bulunmamaktadÄ±r." , \n   "errorCode" :   "TR.OHVPS.Resource.Forbidden" \n }  \n \n 404 Not Found \n Ãrn; GET /odeme-emri-rizasi/123456 Ã§aÄrÄ±sÄ± durumunda 123456 geÃ§erli bir Ã¶deme kaynaÄÄ± deÄilse, HHS, 404 koduyla cevap vermelidir. \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi/123456" , \n     "id" :   "22f52b2d-d442-4a6a-8f39-d23eba45a34b" , \n     "timestamp" :   "2022-12-22T10:53:53+03:00" , \n     "httpCode" :   404 , \n     "httpMessage" :   "Not Found" , \n     "moreInformation" :   "Resource not found" , \n     "errorCode" :   "TR.OHVPS.Resource.NotFound" , \n     "moreInformationTr" :   "Kaynak bulunamadÄ±" \n }  \n\n \n 405 Method Not Allowed \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "3e5c6b28-7ee4-4469-b541-843fb4a94eec" , \n     "timestamp" :   "2022-12-22T11:35:10+03:00" , \n     "httpCode" :   405 , \n     "httpMessage" :   "Method Not Allowed" , \n     "moreInformation" :   "Method not allowed" , \n     "errorCode" :   "TR.OHVPS.Resource.MethodNotAllowed" , \n     "moreInformationTr" :   "Ä°stek yapÄ±lan URL iÃ§in izin verilmeyen metot" \n }  \n \n 406 Not Acceptable \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "3e5c6b28-7ee4-4469-b541-843fb4a94eec" , \n     "timestamp" :   "2022-12-22T11:35:10+03:00" , \n     "httpCode" :   406 , \n     "httpMessage" :   "Not Acceptable" , \n     "moreInformation" :   "Not Acceptable" , \n     "errorCode" :   "TR.OHVPS.Resource.NotAcceptable" , \n     "moreInformationTr" :   "Kabul edilmedi" \n }  \n \n 415 Unsupported Media Type \n Ä°stek baÅlÄ±ÄÄ±nda content-type, JSON dÄ±ÅÄ±nda bir veri iletilirse bu hata verilebilir. \n \n { \n     "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n     "id" :   "63cc94b6-1b51-4648-9671-95e6e2e7e03d" , \n     "timestamp" :   "2022-12-22T11:37:12+03:00" , \n     "httpCode" :   415 , \n     "httpMessage" :   "Unsupported Media Type" , \n     "moreInformation" :   "Content type not supported" , \n     "errorCode" :   "TR.OHVPS.Resource.UnsupportedMediaType" , \n     "moreInformationTr" :   "Desteklenmeyen iÃ§erik tipiâ" \n }  \n \n 429 Too Many Requests \n { \n   "path" :   "/ohvps/hbh/s2.0/hesaplar/aef6061f-2978-4bb4-980d-b4c634c8055b/islemler" , \n   "id" :   "20473c5f-2f4f-4b2e-8b66-7978aec442f7" , \n   "timestamp" :   "2022-12-22T00:21:07+03:00" , \n   "httpCode" :   429 , \n   "httpMessage" :   "Too Many Requests" , \n   "moreInformation" :   "Exceeded rate" , \n   "moreInformationTr" :   "EriÅim sÄ±klÄ±ÄÄ± limiti aÅÄ±mÄ±" , \n   "errorCode" :   "TR.OHVPS.Connection.ExceededRate" \n }  \n \n 500 Internal Server Error \n { \n   "id" :   "1b90c6dc-0277-4755-8b05-9297ddfab743" , \n   "path" :   "/ohvps/obh/s2.0/odeme-emri-rizasi" , \n   "timestamp" :   "2022-12-22T11:41:34+03:00" , \n   "httpCode" :   500 , \n   "httpMessage" :   "Internal Server Error" , \n   "moreInformation" :   "Unexpected condition was encountered." , \n   "moreInformationTr" :   "Beklenmeyen bir durumla karÅÄ±laÅÄ±ldÄ±." , \n   "errorCode" :   "TR.OHVPS.Server.InternalError" \n }  \n\n \n 503 Service Unavailable \n \n   "timestamp" :   "2022-12-20T23:18:56+03:00" , \n   "path" :   "/ohvps/hbh/s2.0/hesap-bilgisi-rizasi/2a72678ee3d24de2be47887e4903a8c6" , \n   "id" :   "e76315b7-09f4-4295-b6d8-1f7fec632159" , \n   "moreInformationTr" :   "HHS Åu anda hizmet veremiyor." , \n   "errorCode" :   "TR.OHVPS.Server.ServiceUnavailable" , \n   "moreInformation" :   "HHS is currently unavailable" , \n   "httpCode" :   503 , \n   "httpMessage" :   "Service Unavailable" \n 3.19. Maskeleme KurallarÄ± \n Maskeli olarak iletilmesi gereken verilerin maskeleme kurallarÄ± Åu Åekildedir: \n \n IBAN verileri Hesap NumarasÄ± : Ä°lk 4 ve son 4 karakteri aÃ§Ä±k, diÄer karakterler maskeli olmalÄ±dÄ±r. Ãrnek: TR54******************4812 \n Ad-SoyadÄ± / Ticari Unvan : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet â â karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r.\nÃrneÄin: âFATÄ°H SERKAN ERENâ ifadesi âFA *** SE**** ER****â Åeklinde gÃ¶sterilmelidir. \n Tabela UnvanÄ± : Her kelimenin ilk 2 karakteri aÃ§Ä±k, sonraki karakterler yerine 4 adet \' \' karakteri konumlandÄ±rÄ±lmalÄ±dÄ±r. ÃrneÄin âBANKALARARASI KART MERKEZÄ° ANONÄ°M ÅÄ°RKETÄ°â ifadesi âBA *** KA**

16** ME**** AN**** ÅÄ°****â Åeklinde gÃ¶sterilmelidir. \n YÃSâten girilen alÄ±cÄ± unvan ve IBAN bilgileri Ã¶deme emri rÄ±zasÄ± ve Ã¶deme emri yanÄ±tÄ±nda aÃ§Ä±k dÃ¶nÃ¼lÃ¼r, Kolas akÄ±ÅÄ±nda Ã¶deme emri rÄ±zasÄ± yanÄ±tÄ± ve Ã¶deme emri istek ve yanÄ±tÄ±nda maskeli taÅÄ±nÄ±r. \n 3.20. Fonksiyonel Olmayan Gereksinimler \n \n \n HHSâlerin sunuyor olduklarÄ± servisleri en fazla 6000 ms iÃ§inde yanÄ±t dÃ¶necek Åekilde tasarlamalÄ±dÄ±r. \n \n \n HHS\'ler mevcut online iÅlem kanallarÄ±ndan sunduklarÄ± eriÅilebilirlik ve performans kriterlerinden daha dÃ¼ÅÃ¼k bir hizmet kalitesi sunmamalÄ±dÄ±r. \n \n \n HHSâlerin sunuyor olduklarÄ± servislere sistemin gÃ¼venlik ve sÃ¼rekliliÄini saÄlamak adÄ±na rate limit koyma ihtiyaÃ§larÄ± olur ise, standartlar ve ihtiyaÃ§lara uygun Åekilde bir konfigÃ¼rasyon yapabilirler.  \n \n \n HHS rate limit tanÄ±mÄ± uyguluyor ise; YÃS\'ler arasÄ±nda ayrÄ±m yapmadan, adil ve makul sÄ±nÄ±rlar dahilinde uygulamalÄ±dÄ±r.    \n \n \n YÃS tarafÄ±ndan kullanÄ±cÄ±nÄ±n baÅlatmadÄ±ÄÄ± otomatik sorgu limitleri  3.21 Otomatik Sorgular  bÃ¶lÃ¼mÃ¼nde detaylandÄ±rÄ±lmÄ±ÅtÄ±r. HHS\'lerin bu servisler iÃ§in minimumda cevap vermesi gereken sorgu sayÄ±larÄ± belirlenmiÅtir. Bu sayÄ±larÄ±n Ã¼zerinde yapÄ±lan servis Ã§aÄrÄ±sÄ±na yanÄ±t dÃ¶nmek HHS inisiyatifindedir. DiÄer taraftan kullanÄ±cÄ±nÄ±n baÅlattÄ±ÄÄ± istekler iÃ§in uygulanacak limitler, HHS\'nin online iÅlem kanallarÄ±ndan sunulan sorgu limitlerinden daha az olmamalÄ±dÄ±r. \n \n \n HHS\'ler, Ã§aÄrÄ±m limitlerini aÅan istekler iÃ§in HTTP 429 - Too Many Request hatasÄ±nÄ± dÃ¶nmelidir. Ãrnek hata mesajÄ±  3.18 HTTP Durum KodlarÄ±  bÃ¶lÃ¼mÃ¼nde bulunmaktadÄ±r. Rate Limit Ã¶zelinde tanÄ±mlanmÄ±Å parametreler olan X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset alanlarÄ± da   3.16 YanÄ±t BaÅlÄ±ÄÄ±  bÃ¶lÃ¼mÃ¼nde aÃ§Ä±klanmÄ±ÅtÄ±r. YÃS\'ler de HHS\'nin belirlediÄi rate limit kurallarÄ±na uymakla yÃ¼kÃ¼mlÃ¼dÃ¼r. \n 3.21. Otomatik Sorgular \n YÃS uygulamasÄ±, ÃHK\'nÄ±n baÅlattÄ±ÄÄ± iÅlemler neticesinde API Ã§aÄrÄ±mÄ± yapabileceÄi gibi, sistemsel bir Åekilde otomatik API Ã§aÄrÄ±mÄ± da yapabilir. \nHHS, API Ã§aÄrÄ±mÄ±nÄ±n ÃHK\'lÄ± ya da ÃHK\'sÄ±z olduÄunu istek parametreleri iÃ§erisinde yer alan PSU-Initiated parametresi ile anlar. Bu parametre âEâ ise ÃHKâlÄ±, âHâ ise sistemsel yapÄ±lmÄ±Å bir sorgu anlamÄ±na gelmektedir. \n ÃHK YÃS uygulamasÄ±na giriÅ yaptÄ±ÄÄ± andan Ã§Ä±kÄ±Å yaptÄ±ÄÄ± ana kadar yani ÃHK oturumu boyunca yapÄ±lan API Ã§aÄrÄ±mlarÄ±nda, PSU-Initiated  deÄerinin "E" olmasÄ± gerekmektedir.  YÃS uygulamasÄ±nda ÃHK oturumu boyunca,  ÃHK\'nÄ±n bilgilerinden minimumda "bakiye" bilgisinin, uygulama arayÃ¼zlerinde gÃ¼ncel deÄeri ile online sorgularla gÃ¶sterimi YÃS\'Ã¼n insiyatifindedir. \n ÃHKânÄ±n baÅlattÄ±ÄÄ± sorgular iÃ§in HHS tarafÄ±ndan belirlenen Ã¼st rate limitler dahilinde Ã§aÄrÄ±m yapÄ±labilir. \n YÃS, aÅaÄÄ±daki API\'leri sistemsel bir Åekilde Ã§aÄÄ±rabilir. \nHHS\'lerin bu servisler iÃ§in minimumda cevap vermesi gereken sorgu sayÄ±larÄ± belirlenmiÅtir. Bu sayÄ±larÄ±n Ã¼zerinde yapÄ±lan servis Ã§aÄrÄ±sÄ±na yanÄ±t dÃ¶nmek HHS inisiyatifindedir. \nHHS tarafÄ±ndan izin verilen sorgu sayÄ±sÄ±nÄ±n Ã¼zerinde yapÄ±lan bir sorgu iÃ§in HTTP 429 durum kodu (Too Many Requests) hatasÄ± dÃ¶nÃ¼lmelidir. YanÄ±t gÃ¶vdesinde tekrar hata nesnesinin oluÅturulmasÄ± HHS inisiyatifindedir.  HHS yanÄ±t headerÄ± alanÄ±nda iletilecek X-RateLimit-Reset (saniye cinsinden) deÄeri kadar sÃ¼re sonunda\nYÃS\'Ã¼n tekrar sorgulama yapmasÄ± beklenmektedir. \n \n \n \n No \n Kaynak \n HTTP iÅlemi \n EriÅim Adresi \n Otomatik Sorgu SayÄ±sÄ± \n \n \n \n \n 1 \n erisim-belirteci \n POST \n /erisim-belirteci \n --- \n \n \n 2 \n odeme-emri-rizasi \n GET \n /odeme-emri-rizasi/{rizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 3 \n odeme-emri \n GET \n /odeme-emri/{odemeEmriNo} \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 4 \n ileri-tarihli-odeme-emri-rizasi \n GET \n /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 5 \n ileri-tarihli-odeme-emri \n GET \n /ileri-tarihli-odeme-emri

16/{odemeEmriNo} \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 6 \n ileri-tarihli-odeme-emri-rizasi \n DELETE \n /ileri-tarihli-odeme-emri-rizasi/{rizaNo} \n --- \n \n \n 7 \n duzenli-odeme-emri-rizasi \n GET \n /duzenli-odeme-emri-rizasi/{rizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 8 \n duzenli-odeme-emri \n GET \n /duzenli-odeme-emri/{talimatNo} \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 9 \n duzenli-odeme-emri-rizasi \n DELETE \n /duzenli-odeme-emri-rizasi/{rizaNo}} \n --- \n \n \n 10 \n hesap-bilgisi-rizasi \n GET \n /hesap-bilgisi-rizasi/{RizaNo} \n RÄ±za bazÄ±nda gÃ¼nde 4 \n \n \n 11 \n duzenli-odeme-talimat-plani \n GET \n /duzenli-odeme-emri/{talimatNo}/odeme-plani \n RÄ±za bazÄ±nda gÃ¼nde 24 \n \n \n 12 \n hesap-bilgisi-rizasi \n DELETE \n /hesap-bilgisi-rizasi/{RizaNo} \n --- \n \n \n 13 \n hesaplar \n GET \n /hesaplar \n Bireysel gÃ¼nde 4  Kurumsal gÃ¼nde 4 \n \n \n 14 \n hesaplar \n GET \n /hesaplar/{hspRef} \n Bireysel gÃ¼nde 4 Kurumsal gÃ¼nde 4 \n \n \n 15 \n bakiye \n GET \n /hesaplar/{hspRef}/bakiye \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 16 \n bakiye \n GET \n /bakiye \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 17 \n islemler \n GET \n /hesaplar/{hspRef}/iÅlemler \n Bireysel gÃ¼nde 4 Kurumsal ÃHK - saatte 12 \n \n \n 18 \n kartlar \n GET \n /kartlar \n Bireysel gÃ¼nde 4  Kurumsal gÃ¼nde 4 \n \n \n 19 \n kartlar \n GET \n /kartlar/{kartRef} \n Bireysel gÃ¼nde 4 Kurumsal gÃ¼nde 4 \n \n \n 20 \n kart-detay \n GET \n /kartlar/{kartRef}/kart-detay \n Bireysel gÃ¼nde 24 Kurumsal ÃHK - gÃ¼nde 24 \n \n \n 21 \n kart-hareketleri \n GET \n /kartlar/{kartRef}/kart-hareketleri \n Bireysel gÃ¼nde 32 Kurumsal ÃHK - gÃ¼nde 32 \n \n \n \n YÃS ve HHS son 24 saat iÃ§erisindeki sorgu sayÄ±larÄ±nÄ± toplayarak elde ettiÄi sonuÃ§larla limit kontrolÃ¼ yapmalÄ±dÄ±r (Pencere yÃ¶ntemi). \n Ä°Ålemler servisinin Ã§aÄrÄ±m detaylarÄ±na  ^BÃ¶lÃ¼m 7.8  Ã¼zerinden ulaÅÄ±labilir. \n Hesap bilgisi rÄ±zasÄ±nÄ±n YÃS tarafÄ±ndan otomatik bir Åekilde iptal edilmesi durumu  ^BÃ¶lÃ¼m 9\'da  aÃ§Ä±klanmÄ±ÅtÄ±r. \n Kart hareketleri iÃ§in sistemsel sorgu yapÄ±ldÄ±ÄÄ± durumda aynÄ± ekstre tÃ¼rÃ¼ iÃ§in dÃ¶nem deÄeri deÄiÅtikÃ§e limit dÃ¼Åmeyecektir. Sayfalama yapÄ±ldÄ±ÄÄ± durumlarda ise deÄiÅen sayfa numaralarÄ± Ã¶zelinde de limit dÃ¼Åmeyecektir. AynÄ± sayfa ve aynÄ± dÃ¶nem Ã¶zelinde tekrar sorgu yapÄ±lmasÄ± halinde limit dÃ¼ÅÃ¼mÃ¼ gerÃ§ekleÅecektir. \n Ekstre tÃ¼rÃ¼ deÄiÅmesi durumunda da limit dÃ¼ÅÃ¼mÃ¼ olmalÄ±dÄ±r. \n'},{frontmatter:{},regularPath:"/v2.0.1/deneyalani/hesap-bilgisi-api.html",relativePath:"v2.0.1/deneyalani/hesap-bilgisi-api.md",key:"v-43c4777d",path:"/v2.0.1/deneyalani/hesap-bilgisi-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.1/deneyalani/genel-bilgiler.html",relativePath:"v2.0.1/deneyalani/genel-bilgiler.md",key:"v-6cd49697",path:"/v2.0.1/deneyalani/genel-bilgiler.html",content:" GENEL BiLGÄ°LER: \n ÃHVPS API Ä°lke ve KurallarÄ± dokÃ¼manÄ±na istinaden geliÅtirmelerini yapan/yapacak olan katÄ±lÄ±mcÄ±lar geliÅtirdikleri sÃ¼rÃ¼me ait APIâlerin nasÄ±l Ã§alÄ±ÅtÄ±klarÄ±nÄ± gÃ¶rmek istediklerinde âDeney AlanÄ±â Ã¼zerinden gÃ¶zlem yapabilirler. Bu kapsamda, Deney AlanÄ± katÄ±lÄ±mcÄ±lara tarayÄ±cÄ± Ã¼zerinden statik verilerle iÅlem baÅlatarak, dÃ¶nen yanÄ±tÄ± inceleme imkanÄ± sunar. \n Deney AlanÄ± ile sunulan imkanlar Åu Åekildedir: \n \n Servisler durum bilgisi iÃ§ermeyecek Åekilde (stateless) olarak sunulmaktadÄ±r. \n GÃ¼Ã§lÃ¼ Kimlik DoÄrulama akÄ±ÅlarÄ±nda kurum Ã¶zelinde oluÅturulan yetkilendirme kimlik bilgilerine ihtiyaÃ§ duyulmamaktadÄ±r. \n YanÄ±t veri kÃ¼mesi statiktir. Servislere yapÄ±lan istekler, her zaman aynÄ± yanÄ±tÄ± dÃ¶nmektedir. \n Yeni oluÅturma, gÃ¼ncelleme, silme iÅlemleri kaynak veri Ã¼zerinde deÄiÅiklik yapmamaktadÄ±r. \n Deney alanÄ± genelin kullanÄ±mÄ±na aÃ§Ä±ktÄ±r. Ãyelik kaydÄ± olmaksÄ±zÄ±n Deney AlanÄ± Ã¼zerinden API incelemeleri gerÃ§ekleÅtirilebilmektedir. \n API dokÃ¼manÄ±nda yapÄ±lacak minor deÄiÅiklikler deney alanÄ±na yansÄ±tÄ±lmayacaktÄ±r. \n \n Not: Deney AlanÄ±ânÄ±n kapsamÄ± geniÅletilmiÅ versiyonu â âBKM ÃHVPS SimÃ¼latÃ¶râ uygulamasÄ± hem HHS hem de YÃS katÄ±lÄ±mcÄ±larÄ±nÄ±n; test uygulamalarÄ±nÄ± uÃ§tan uca test edebilebileceÄi bir ortamdÄ±r. SimÃ¼latÃ¶r uygulamasÄ± Ã¼zerinden dinamik veri giriÅi yaparak, geliÅtirilen servisler ile zorunlu senaryolarÄ±n tÃ¼mÃ¼nÃ¼n simÃ¼lasyonu gerÃ§ekleÅtirilebilir. SimÃ¼latÃ¶r ortamÄ±ndaki APIâler, Ã¼retim ortamÄ±nÄ±n bir kopyasÄ± olacak Åekilde oluÅturulmuÅtur ve kurumlarÄ±n Ã¼retim ortamÄ±na hazÄ±r hale gelmelerine aracÄ±lÄ±k eder. Bu uygulama, pÃ¼rÃ¼zsÃ¼z bir Ã¼retim ortamÄ± geÃ§iÅi imkanÄ± saÄlar ve ÃHVPS BKM Teknik Sertifikasyonu geÃ§mek iÃ§in koÅulmasÄ± gereken sertifikasyon senaryolarÄ± BKM ÃHVPS SimÃ¼latÃ¶râÃ¼ Ã¼zerinden sunulmaktadÄ±r. BKM SimÃ¼latÃ¶r kullanÄ±mÄ± iÃ§in ayrÄ± bir sÃ¼reÃ§ iÅletilmekte olup daha fazla detaylÄ± bilgi almak iÃ§in [email protected] adresine taleplerinizi iletmeniz gerekmektedir. \n Ãdeme Emri BaÅlatma API Deney AlanÄ± \n"},{frontmatter:{},regularPath:"/v2.0.1/deneyalani/ileri-tarihli-odeme-emri-api.html",relativePath:"v2.0.1/deneyalani/ileri-tarihli-odeme-emri-api.md",key:"v-3f5d6285",path:"/v2.0.1/deneyalani/ileri-tarihli-odeme-emri-api.html",content:" \n   \

16n "},{frontmatter:{},regularPath:"/v2.0.1/deneyalani/odeme-emri-api.html",relativePath:"v2.0.1/deneyalani/odeme-emri-api.md",key:"v-09a8c185",path:"/v2.0.1/deneyalani/odeme-emri-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.1/deneyalani/hhs-yos-api.html",relativePath:"v2.0.1/deneyalani/hhs-yos-api.md",key:"v-512f5cfd",path:"/v2.0.1/deneyalani/hhs-yos-api.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.1/deneyalani/test.html",relativePath:"v2.0.1/deneyalani/test.md",key:"v-6b037b83",path:"/v2.0.1/deneyalani/test.html",content:" \n   \n "},{frontmatter:{},regularPath:"/v2.0.1/deneyalani/olay-bildirim-api.html",relativePath:"v2.0.1/deneyalani/olay-bildirim-api.md",key:"v-49107346",path:"/v2.0.1/deneyalani/olay-bildirim-api.html",content:" \n   \n "}],themeConfig:{searchMaxSuggestions:20,footer:'\n      &copy; <a href="https://github.com/Renovamen" target="_blank">Renovamen</a> 2018-2021\n      <br>\n      Powered by <a href="https://vuepress.vuejs.org" target="_blank">VuePress</a> &\n      <a href="https://github.com/Renovamen/vuepress-theme-gungnir" target="_blank">Gungnir</a>\n    ',sidebar:[{title:"SÃRÃM 2.0.1 - Taslak SÃ¼rÃ¼m",path:"/v2.0.1/contents/tanim-ve-kisitlamalar",children:[{title:"1. TanÄ±mlar ve KÄ±sÄ±tlamalar",path:"/v2.0.1/contents/tanim-ve-kisitlamalar"},{title:"2. Kapsam ve Dayanak",path:"/v2.0.1/contents/kapsam-ve-dayanak"},{title:"3. Temel Prensipler",path:"/v2.0.1/contents/temel-prensipler"},{title:"4. RÄ±za DurumlarÄ±",path:"/v2.0.1/contents/riza-durumlari"},{title:"5. GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",path:"/v2.0.1/contents/gkd"},{title:"6. Ãdeme Emri BaÅlatma Hizmeti",path:"/v2.0.1/contents/odeme-emri-baslatma-hizmeti"},{title:"7. Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti",path:"/v2.0.1/contents/ileri-tarihli-odeme-emri-hizmeti"},{title:"8. DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti",path:"/v2.0.1/contents/duzenli-odeme-emri-hizmeti"},{title:"9. Hesap Bilgisi Hizmeti",path:"/v2.0.1/contents/hesap-bilgisi-hizmeti"},{title:"10. HHS, YÃS ve Temsilcilik API",path:"/v2.0.1/contents/hhs-yos-api"},{title:"11. GÃ¼Ã§lÃ¼ Kimlik DoÄrulama API",path:"/v2.0.1/contents/erisim-belirteci"},{title:"12. Olay Bildirim",path:"/v2.0.1/contents/olay-bildirim"},{title:"13. Ekler",path:"/v2.0.1/contents/ekler"},{title:"14. Deney AlanÄ±",path:"/v2.0.1/deneyalani/genel-bilgiler",children:[{title:"1. Ãdeme Emri BaÅlatma API",path:"/v2.0.1/deneyalani/odeme-emri-api"},{title:"2. Ä°leri Tarihli Ãdeme Emri BaÅlatma API",path:"/v2.0.1/deneyalani/ileri-tarihli-odeme-emri-api"},{title:"3. DÃ¼zenli Ãdeme Emri BaÅlatma API",path:"/v2.0.1/deneyalani/duzenli-odeme-emri-api"},{title:"4. Hesap Bilgisi API",path:"/v2.0.1/deneyalani/hesap-bilgisi-api"},{title:"5. HHS - YÃS API",path:"/v2.0.1/deneyalani/hhs-yos-api"},{title:"6. Olay Bildirim",path:"/v2.0.1/deneyalani/olay-bildirim-api"}]}]},{title:"SÃRÃM 2.0.0 - Aktif SÃ¼rÃ¼m",path:"/v2.0.0/contents/tanim-ve-kisitlamalar",children:[{title:"1. TanÄ±mlar ve KÄ±sÄ±tlamalar",path:"/v2.0.0/contents/tanim-ve-kisitlamalar"},{title:"2. Kapsam ve Dayanak",path:"/v2.0.0/contents/kapsam-ve-dayanak"},{title:"3. Temel Prensipler",path:"/v2.0.0/contents/temel-prensipler"},{title:"4. RÄ±za DurumlarÄ±",path:"/v2.0.0/contents/riza-durumlari"},{title:"5. GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",path:"/v2.0.0/contents/gkd"},{title:"6. Ãdeme Emri BaÅlatma Hizmeti",path:"/v2.0.0/contents/odeme-emri-baslatma-hizmeti"},{title:"7. Ä°leri Tarihli Ãdeme Emri BaÅlatma Hizmeti",path:"/v2.0.0/contents/ileri-tarihli-odeme-emri-hizmeti"},{title:"8. DÃ¼zenli Ãdeme Emri BaÅlatma Hizmeti",path:"/v2.0.0/contents/duzenli-odeme-emri-hizmeti"},{title:"9. Hesap Bilgisi Hizmeti",path:"/v2.0.0/contents/hesap-bilgisi-hizmeti"},{title:"10. HHS ve YÃS API",path:"/v2.0.0/contents/hhs-yos-api"},{title:"11. GÃ¼Ã§lÃ¼ Kimlik DoÄrulama API",path:"/v2.0.0/contents/erisim-belirteci"},{title:"12. Olay Bildirim",path:"/v2.0.0/contents/olay-bildirim"},{title:"13. Ekler",path:"/v2.0.0/contents/ekler"},{title:"14. Deney AlanÄ±",path:"/v2.0.0/deneyalani/genel-bilgiler",children:[{title:"1. Ãdeme Emri BaÅlatma API",path:"/v2.0.0/deneyalani/odeme-emri-api"},{title:"2. Ä°leri Tarihli Ãdeme Emri BaÅlatma API",path:"/v2.0.0/deneyalani/ileri-tarihli-odeme-emri-api"},{title:"3. DÃ¼zenli Ãdeme Emri BaÅlatma API",path:"/v2.0.0/deneyalani/duzenli-odeme-emri-api"},{title:"4. Hesap Bilgisi API",path:"/v2.0.0/deneyalani/hesap-bilgisi-api"},{title:"5. HHS - YÃS API",path:"/v2.0.0/deneyalani/hhs-yos-api"},{title:"6. Olay Bildirim",path:"/v2.0.0/deneyalani/olay-bildirim-api"}]}]},{title:"Dijital CÃ¼zdanlardan TR Karekod ile Ãdeme",path:"/dijital-cuzdan"},{title:"SÃ¼rÃ¼m YÃ¶netimi",path:"/surum-yonetimi"},{title:"SÃRÃM 1.0.1",path:"/v1.0.1/contents/tanim-ve-kisitlamalar",children:[{title:"1. TanÄ±mlar ve KÄ±sÄ±tlamalar",path:"/v1.0.1/contents/tanim-ve-kisitlamalar"},{title:"2. Kapsam ve Dayanak",path:"/v1.0.1/contents/kapsam-ve-dayanak"},{title:"3. Temel Prensipler",path:"/v1.0.1/contents/temel-prensipler"},{title:"4. RÄ±za DurumlarÄ±",path:"/v1.0.1/contents/riza-durumlari"},{title:"5. GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",path:"/v1.0.1/contents/gkd"},{title:"6. Ãdeme Emri BaÅlatma Hizmeti",path:"/v1.0.1/contents/odeme-emri-baslatma-hizmeti"},{title:"7. Hesap Bilgisi Hizmeti",path:"/v1.0.1/contents/hesap-bilgisi-hizmeti"},{title:"8. HHS ve YÃS API",path:"/v1.0.1/contents/hhs-yos-api"},{title:"9. EriÅim Belirteci API",path:"/v1.0.1/contents/erisim-belirteci"},{title:"10. Ekler",path:"/v1.0.1/contents/ekler"}]},{title:"SÃRÃM 1.0.2",path:"/v1.0.2/contents/tanim-ve-kisitlamalar",children:[{title:"1. TanÄ±mlar ve KÄ±sÄ±tlamalar",path:"/v1.0.2/contents/tanim-ve-kisitlamalar"},{title:"2. Kapsam ve Dayanak",path:"/v1.0.2/contents/kapsam-ve-dayanak"},{title:"3. Temel Prensipler",path:"/v1.0.2/contents/temel-prensipler"},{title:"4. RÄ±za DurumlarÄ±",path:"/v1.0.2/contents/riza-durumlari"},{title:"5. GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",path:"/v1.0.2/contents/gkd"},{title:"6. Ãdeme Emri BaÅlatma Hizmeti",path:"/v1.0.2/contents/odeme-emri-baslatma-hizmeti"},{title:"7. Hesap Bilgisi Hizmeti",path:"/v1.0.2/contents/hesap-bilgisi-hizmeti"},{title:"8. HHS ve YÃS API",path:"/v1.0.2/contents/hhs-yos-api"},{title:"9. EriÅim Belirteci API",path:"/v1.0.2/contents/erisim-belirteci"},{title:"10. Ekler",path:"/v1.0.2/contents/ekler"}]},{title:"SÃRÃM 1.1.0",path:"/v1.1.0/contents/tanim-ve-kisitlamalar",children:[{title:"1. TanÄ±mlar ve KÄ±sÄ±tlamalar",path:"/v1.1.0/contents/tanim-ve-kisitlamalar"},{title:"2. Kapsam ve Dayanak",path:"/v1.1.0/contents/kapsam-ve-dayanak"},{title:"3. Temel Prensipler",path:"/v1.1.0/contents/temel-prensipler"},{title:"4. RÄ±za DurumlarÄ±",path:"/v1.1.0/contents/riza-durumlari"},{title:"5. GÃ¼Ã§lÃ¼ Kimlik DoÄrulama",path:"/v1.1.0/contents/gkd"},{title:"6. Ãdeme Emri BaÅlatma Hizmeti",path:"/v1.1.0/contents/odeme-emri-baslatma-hizmeti"},{title:"7. Hesap Bilgisi Hizmeti",path:"/v1.1.0/contents/hesap-bilgisi-hizmeti"},{title:"8. HHS ve YÃS API",path:"/v1.1.0/contents/hhs-yos-api"},{title:"9. GÃ¼Ã§lÃ¼ Kimlik DoÄrulama API",path:"/v1.1.0/contents/erisim-belirteci"},{title:"10. Olay Bildirim",path:"/v1.1.0/contents/olay-bildirim"},{title:"11. Ekler",path:"/v1.1.0/contents/ekler"},{title:"12. Deney AlanÄ±",path:"/v1.1.0/deneyalani/genel-bilgiler",children:[{title:"1. Ãdeme Emri BaÅlatma API",path:"/v1.1.0/deneyalani/odeme-emri-api"},{title:"2. Hesap Bilgisi API",path:"/v1.1.0/deneyalani/hesap-bilgisi-api"},{title:"3. HHS - YÃS API",path:"/v1.1.0/deneyalani/hhs-yos-api"},{title:"4. Olay Bildirim",path:"/v1.1.0/deneyalani/olay-bildirim-api"}]}]},{title:"ÃHVPS SÄ±kÃ§a Sorulan Sorular",path:"/sorulan-sorular"},{title:"ÃHVPS Uyum Tarihleri",path:"/uyum-tarihleri"}],logo:"/assets/TCMB_logo.svg.png"}};n(274);a.default.component("BodyBox",()=>Promise.all([n.e(0),n.e(1),n.e(2),n.e(6),n.e(42)]).then(n.bind(null,783))),a.default.component("DeleteBox",()=>Promise.all([n.e(0),n.e(53)]).then(n.bind(null,784))),a.default.component("DuzenliOdemeEmriAPIv20",()=>Promise.all([n.e(0),n.e(1),n.e(2),n.e(3),n.e(19)]).then(n.bind(null,771))),a.default.component("GetBox",()=>Promise.all([n.e(0),n.e(54)]).then(n.bind(null,785))),a.default.component("Gkd",()=>Promise.all([n.e(0),n.e(46)]).then(n.bind(null,786))),a.default.component("HesapBilgisiV11",()=>Promise.all([n.e(0),n.e(1),n.e(2),n.e(3),n.e(17)]).then(n.bind(null,772))),a.default.component("HesapBilgisiV20",()=>Promise.all([n.e(0),n.e(1),n.e(2),n.e(3),n.e(20)]).then(n.bind(null,773))),a.default.component("HhsYosAPIV11",()=>Promise.all([n.e(0),n.e(1),n.e(2),n.e(3),n.e(15)]).then(n.bind(null,774))),a.default.component("KeyValueGrid",()=>

16Promise.all([n.e(1),n.e(2),n.e(3),n.e(6),n.e(43)]).then(n.bind(null,787))),a.default.component("OdemeEmriAPIv11",()=>Promise.all([n.e(0),n.e(1),n.e(2),n.e(3),n.e(18)]).then(n.bind(null,775))),a.default.component("OlayDinlemeAPIV11",()=>Promise.all([n.e(0),n.e(1),n.e(2),n.e(3),n.e(16)]).then(n.bind(null,776))),a.default.component("PostBox",()=>Promise.all([n.e(0),n.e(55)]).then(n.bind(null,788))),a.default.component("ProcessButton",()=>Promise.all([n.e(1),n.e(63)]).then(n.bind(null,789))),a.default.component("ProcessTitle",()=>Promise.all([n.e(0),n.e(56)]).then(n.bind(null,790))),a.default.component("PutBox",()=>Promise.all([n.e(0),n.e(57)]).then(n.bind(null,791))),a.default.component("Request",()=>n.e(75).then(n.bind(null,395))),a.default.component("Response",()=>Promise.all([n.e(1),n.e(2),n.e(3),n.e(64)]).then(n.bind(null,792))),a.default.component("RizaOnay",()=>Promise.all([n.e(0),n.e(58)]).then(n.bind(null,793))),a.default.component("RizaOnayHesapBilgisi",()=>Promise.all([n.e(0),n.e(59)]).then(n.bind(null,794))),a.default.component("TitleBox",()=>Promise.all([n.e(0),n.e(60)]).then(n.bind(null,795))),a.default.component("ileriTarihliOdemeEmriAPIv20",()=>Promise.all([n.e(0),n.e(1),n.e(2),n.e(3),n.e(21)]).then(n.bind(null,777))),a.default.component("Badge",()=>Promise.all([n.e(0),n.e(9)]).then(n.bind(null,796))),a.default.component("CodeBlock",()=>Promise.all([n.e(0),n.e(10)]).then(n.bind(null,779))),a.default.component("CodeGroup",()=>Promise.all([n.e(0),n.e(11)]).then(n.bind(null,780)));n(275);var Di=[({Vue:e,options:i,router:n,siteData:a})=>{a.pages=a.pages.reverse().map(e=>(e.regularPath.includes("content")?e.title=`${e.title} -> ${e.regularPath.split("/")[1]}`:e.title=""+e.title,e))},{},({Vue:e})=>{e.mixin({computed:{$dataBlock(){return this.$options.__data__block__}}})},{},{}],Ii=[];class Ei extends class{constructor(){this.store=new a.default({data:{state:{}}})}$get(e){return this.store.state[e]}$set(e,i){a.default.set(this.store.state,e,i)}$emit(...e){this.store.$emit(...e)}$on(...e){this.store.$on(...e)}}{}Object.assign(Ei.prototype,{getPageAsyncComponent:mi,getLayoutAsyncComponent:si,getAsyncComponent:ui,getVueComponent:ki});var Zi={install(e){const i=new Ei;e.$vuepress=i,e.prototype.$vuepress=i}};function Gi(e,i){const n=i.toLowerCase();return e.options.routes.some(e=>e.path.toLowerCase()===n)}var Vi={props:{pageKey:String,slotKey:{type:String,default:"default"}},render(e){const i=this.pageKey||this.$parent.$page.key;return yi("pageKey",i),a.default.component(i)||a.default.component(i,mi(i)),a.default.component(i)?e(i):e("")}},Ci={functional:!0,props:{slotKey:String,required:!0},render:(e,{props:i,slots:n})=>e("div",{class:["content__"+i.slotKey]},n()[i.slotKey])},Mi={computed:{openInNewWindowTitle(){return this.$themeLocaleConfig.openNewWindowText||"(opens new window)"}}},Fi=(n(276),n(277),Object(Yi.a)(Mi,(function(){var e=this._self._c;return e("span",[e("svg",{staticClass:"icon outbound",attrs:{xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",focusable:"false",x:"0px",y:"0px",viewBox:"0 0 100 100",width:"15",height:"15"}},[e("path",{attrs:{fill:"currentColor",d:"M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"}}),this._v(" "),e("polygon",{attrs:{fill:"currentColor",points:"45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"}})]),this._v(" "),e("span",{staticClass:"sr-only"},[this._v(this._s(this.openInNewWindowTitle))])])}),[],!1,null,null,null).exports),_i={functional:!0,render(e,{parent:i,children:n}){if(i._isMounted)return n;i.$once("hook:mounted",()=>{i.$forceUpdate()})}};a.default.config.productionTip=!1,a.default.use(je),a.default.use(Zi),a.default.mixin(function(e,i,n=a.default){!function(e){e.locales&&Object.keys(e.locales).forEach(i=>{e.locales[i].path=i});Object.freeze(e)}(i),n.$vuepress.$set("siteData",i);const r=new(e(n.$vuepress.$get("siteData"))),l=Object.getOwnPropertyDescriptors(Object.getPrototypeOf(r)),t={};return Object.keys(l).reduce((e,i)=>(i.startsWith("$")&&(e[i]=l[i].get),e),t),{computed:t}}(e=>class{setPage(e){this.__page=e}get $site(){return e}get $themeConfig(){return this.$site.themeConfig}get $frontmatter(){return this.$page.frontmatter}get $localeConfig(){const{locales:e={}}=this.$site;let i,n;for(const a in e)"/"===a?n=e[a]:0===this.$page.path.indexOf(a)&&(i=e[a]);return i||n||{}}

16get $siteTitle(){return this.$localeConfig.title||this.$site.title||""}get $canonicalUrl(){const{canonicalUrl:e}=this.$page.frontmatter;return"string"==typeof e&&e}get $title(){const e=this.$page,{metaTitle:i}=this.$page.frontmatter;if("string"==typeof i)return i;const n=this.$siteTitle,a=e.frontmatter.home?null:e.frontmatter.title||e.title;return n?a?a+" | "+n:n:a||"VuePress"}get $description(){const e=function(e){if(e){const i=e.filter(e=>"description"===e.name)[0];if(i)return i.content}}(this.$page.frontmatter.meta);return e||(this.$page.frontmatter.description||this.$localeConfig.description||this.$site.description||"")}get $lang(){return this.$page.frontmatter.lang||this.$localeConfig.lang||"en-US"}get $localePath(){return this.$localeConfig.path||"/"}get $themeLocaleConfig(){return(this.$site.themeConfig.locales||{})[this.$localePath]||{}}get $page(){return this.__page?this.__page:function(e,i){for(let n=0;n<e.length;n++){const a=e[n];if(a.path.toLowerCase()===i.toLowerCase())return a}return{path:"",frontmatter:{}}}(this.$site.pages,this.$route.path)}},Oi)),a.default.component("Content",Vi),a.default.component("ContentSlotsDistributor",Ci),a.default.component("OutboundLink",Fi),a.default.component("ClientOnly",_i),a.default.component("Layout",si("Layout")),a.default.component("NotFound",si("NotFound")),a.default.prototype.$withBase=function(e){const i=this.$site.base;return"/"===e.charAt(0)?i+e.slice(1):e},window.__VUEPRESS__={version:"1.9.10",hash:"bf9a320"},async function(e){const i="undefined"!=typeof window&&window.__VUEPRESS_ROUTER_BASE__?window.__VUEPRESS_ROUTER_BASE__:Oi.routerBase||Oi.base,n=new je({base:i,mode:"history",fallback:!1,routes:Pi,scrollBehavior:(e,i,n)=>n||(e.hash?!a.default.$vuepress.$get("disableScrollBehavior")&&{selector:decodeURIComponent(e.hash)}:{x:0,y:0})});!function(e){e.beforeEach((i,n,a)=>{if(Gi(e,i.path))a();else if(/(\/|\.html)$/.test(i.path))if(/\/$/.test(i.path)){const n=i.path.replace(/\/$/,"")+".html";Gi(e,n)?a(n):a()}else a();else{const n=i.path+"/",r=i.path+".html";Gi(e,r)?a(r):Gi(e,n)?a(n):a()}})}(n);const r={};try{await Promise.all(Di.filter(e=>"function"==typeof e).map(i=>i({Vue:a.default,options:r,router:n,siteData:Oi,isServer:e})))}catch(e){console.error(e)}return{app:new a.default(Object.assign(r,{router:n,render:e=>e("div",{attrs:{id:"app"}},[e("RouterView",{ref:"layout"}),e("div",{class:"global-ui"},Ii.map(i=>e(i)))])})),router:n}}(!1).then(({app:e,router:i})=>{i.onReady(()=>{e.$mount("#app")})})}]);

Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.