### Query Account Balance Example

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hesap-bilgisi-hizmeti.md

Example of a query to retrieve account balance information, specifying pagination and sorting parameters.

```http
/bakiye?syfKytSayi=25&syfNo=1&srlmKrtr=hspRef&srlmYon=A
```

--------------------------------

### Link Header Pagination Example

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/temel-prensipler.md

Example of Link header values for navigating between pages in a paginated API response.

```http
</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"
```

--------------------------------

### HHS API Query Examples

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hhs-yos-api.md

Examples of GET requests for retrieving all HHS records, a specific HHS by code, and a sorted list of accounts.

```http
/hhs
```

```http
/hhs/2001
```

```http
/hhs?srlmKrtr=kod&srlmYon=A
```

--------------------------------

### GET /odeme-emri/{odemeEmriNo}

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/odeme-emri-baslatma-hizmeti.md

Belirli bir ödeme emrinin detaylarını sorgular.

```APIDOC
## GET /odeme-emri/{odemeEmriNo}

### Description
Ödeme Emri Durumu ve Ödeme Emri Detayı bilgilerini sorgular.

### Method
GET

### Endpoint
/odeme-emri/{odemeEmriNo}

### Parameters
#### Path Parameters
- **odemeEmriNo** (string) - Required - Sorgulanacak ödeme emri numarası.

### Response
#### Success Response (200)
- **OdemeEmri** (object) - Ödeme emri detay nesnesi.
```

--------------------------------

### GET /duzenli-odeme-emri/{talimatNo}/odeme-plani

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/duzenli-odeme-emri-hizmeti.md

Belirtilen talimat numarasına ait ödeme planını sorgular.

```APIDOC
## GET /duzenli-odeme-emri/{talimatNo}/odeme-plani

### Description
Düzenli ödeme emri planını sorgular.

### Method
GET

### Endpoint
/duzenli-odeme-emri/{talimatNo}/odeme-plani

### Parameters
#### Path Parameters
- **talimatNo** (string) - Required - Talimat numarası

### Response
#### Success Response (200)
- **DuzenliOdemeEmriPlani** (object) - Yanıt nesnesi
```

--------------------------------

### GET /kart-hareketleri

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hesap-bilgisi-hizmeti.md

Belirtilen kriterlere göre kart hareketlerini sorgular ve listeler.

```APIDOC
## GET /kart-hareketleri

### Description
Kart hareketlerini sorgulamak için kullanılan uç noktadır. Dönem, ekstre türü, sayfalama ve sıralama gibi kriterler ile filtreleme yapılabilir.

### Method
GET

### Endpoint
/kart-hareketleri

### Parameters
#### Query Parameters
- **donemDegeri** (N3) - Zorunlu - Kart hareketlerinin sorgulanacağı dönem değeri (Banka kartı: 0, -1; Kredi kartı: -12 ile 18 arası ve 99; Ön ödemeli: 0, -1).
- **ekstreTuru** (AN3) - İsteğe bağlı - Ekstre para birimi (TRY, USD, EUR, GBP). Varsayılan: TRY.
- **syfKytSayi** (N3) - İsteğe bağlı - Sayfa başına kayıt sayısı (Maksimum 100).
- **syfNo** (N3) - İsteğe bağlı - İstenen sayfa numarası.
- **brcAlc** (AN1) - İsteğe bağlı - Borç/Alacak göstergesi (B: Borç, A: Alacak, N: Finansal olmayan).
- **srlmYon** (AN1) - İsteğe bağlı - Sıralama yönü (A: Azalan, Y: Artan).

### Response
#### Success Response (200)
- **kartRef** (AN5..40) - Kart referans numarası.
- **donemDegeri** (N3) - Sorgulanan dönem değeri.
- **donemBaslangicTarihi** (ISODate) - Dönem başlangıç tarihi.
- **donemBitisTarihi** (ISODate) - Dönem bitiş tarihi.
- **ekstreTuru** (AN3) - Ekstre türü.
- **ekstreBorcu** (Kompleks) - Ekstre borç bilgisi (Tutar ve Para Birimi içerir).
```

--------------------------------

### GET /odeme-emri/{odmEmrNo}

Source: https://context7.com/ohvps/ohvps.github.io/llms.txt

Belirli bir ödeme emrinin güncel durumunu sorgular.

```APIDOC
## GET /odeme-emri/{odmEmrNo}

### Description
Ödeme emri numarası ile işlemin mevcut durumunu sorgular.

### Method
GET

### Endpoint
https://gecit-api.bkm.com.tr/ohvps/obh/s2.0/odeme-emri/{odmEmrNo}

### Parameters
#### Path Parameters
- **odmEmrNo** (string) - Required - Sorgulanacak ödeme emri numarası
```

--------------------------------

### Installment Data Structure

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hesap-bilgisi-hizmeti.md

Defines the structure for remaining installment totals and period-specific installment details.

```APIDOC
## Installment Data Structure

### Description
This structure provides the total remaining installment balance and a breakdown of installment amounts per period for credit card transactions.

### Fields
- **kalanToplamTaksitTutari** (Complex) - Required - Total remaining installment balance. Use (-) for debt, (+) for credit/refunds. Required for credit cards.
  - **tutar** (AN1..25) - Required - Amount value. Regex: `^[\-\+]?\d{1,18}$|^[\-\+]?\d{1,18}\.\d{1,5}$`
  - **paraBirimi** (AN3) - Required - Currency code.

- **donemTaksitTutarBilgisi** (Array) - Required - List of installment periods. Required for credit cards if installments exist.
  - **donemDegeri** (N3) - Required - Period value (minimum 1).
  - **donemTaksitTutari** (Complex) - Required - Total installment amount for the specific period.
    - **tutar** (AN1..25) - Required - Amount value. Regex: `^[\-\+]?\d{1,18}$|^[\-\+]?\d{1,18}\.\d{1,5}$`
    - **paraBirimi** (AN3) - Required - Currency code.
```

--------------------------------

### Özel Anahtarı PKCS8 Formatına Çevirme (openssl)

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/ekler.md

Java gibi bazı sistemlerin PKCS8 formatındaki özel anahtarlara ihtiyaç duyması durumunda kullanılır. Bu komut, mevcut özel anahtarı PKCS8 formatına dönüştürür ve 'private_key.pem' dosyasına kaydeder.

```bash
openssl pkcs8 -topk8 -inform PEM -in private.pem -out private_key.pem –nocrypt
```

--------------------------------

### POST /erisim-belirteci

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/duzenli-odeme-emri-hizmeti.md

GKD süreçleri için erişim belirteci oluşturur.

```APIDOC
## POST /erisim-belirteci

### Description
GKD için erişim belirteci oluşturma işlemini gerçekleştirir.

### Method
POST

### Endpoint
/erisim-belirteci

### Parameters
#### Request Body
- **ErisimBelirteciIstegi** (object) - Required - İstem nesnesi

### Response
#### Success Response (200)
- **ErisimBelirteci** (object) - Yanıt nesnesi
```

--------------------------------

### Account Balance Inquiry - Credit Not Included (Initial Balance > Withdrawal)

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hesap-bilgisi-hizmeti.md

Example response when the initial account balance is positive and 'Kredi Dahil Göstergesi' is 0. The 'Hesap Bakiye Tutarı' is reduced by the withdrawal amount.

```json
{
  "Hesap Bakiye Tutarı": 0,
  "Kredili Mevduat Hesabı Bakiyesi": 3000
}
```

--------------------------------

### YÖS Redirect Service Response Example

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/gkd.md

Example HTTP response for a YÖS redirect service initiating the SCA flow. This response uses a 302 status code and a Location header to redirect the customer's browser to the HHS address.

```http
HTTP/1.1 302 Found
Location: {{hhsYonAdr}}
```

--------------------------------

### Account Balance Inquiry - Credit Included (Initial Balance > Withdrawal)

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hesap-bilgisi-hizmeti.md

Example response when the initial account balance is positive and 'Kredi Dahil Göstergesi' is 1. The 'Hesap Bakiye Tutarı' reflects the withdrawal, considering the credit.

```json
{
  "Hesap Bakiye Tutarı": 3000,
  "Kredili Mevduat Hesabı Bakiyesi": 3000
}
```

--------------------------------

### HHS Redirect Service Response Example

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/gkd.md

Example HTTP response for an HHS redirect service after SCA completion. This response uses a 302 status code and a Location header to redirect the customer's browser back to the YÖS address with transaction details.

```http
HTTP/1.1 302 Found
Location: {{yosYonAdr}}&rizaDrm=Y&yetKod=xx&rizaNo=yy&rizaTip=O
```

--------------------------------

### GET /kartlar

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hesap-bilgisi-hizmeti.md

Kullanıcıya ait kart bilgilerini listeler.

```APIDOC
## GET /kartlar

### Description
Kullanıcının erişim izni verdiği kartları listeler.

### Method
GET

### Endpoint
/kartlar

### Parameters
#### Query Parameters
- **Sayfalama** (object) - Optional - Sayfalama parametreleri.
- **Filtreleme** (object) - Optional - Filtreleme parametreleri.

### Response
#### Success Response (200)
- **KartBilgileri** (array) - Kart listesi.
```

--------------------------------

### GET /hesaplar

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hesap-bilgisi-hizmeti.md

Kullanıcıya ait hesap bilgilerini listeler.

```APIDOC
## GET /hesaplar

### Description
Kullanıcının erişim izni verdiği hesapları listeler.

### Method
GET

### Endpoint
/hesaplar

### Parameters
#### Query Parameters
- **Sayfalama** (object) - Optional - Sayfalama parametreleri.

### Response
#### Success Response (200)
- **HesapBilgileri** (array) - Hesap listesi.
```

--------------------------------

### GET /olay-abonelik

Source: https://context7.com/ohvps/ohvps.github.io/llms.txt

Retrieves the current event subscription details.

```APIDOC
## GET /olay-abonelik

### Description
Retrieves the current event subscription configuration.

### Method
GET

### Endpoint
https://gecit-api.bkm.com.tr/ohvps/oas/s2.0/olay-abonelik

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer {client_credentials_token}
- **X-Request-ID** (string) - Required - Unique request identifier
- **X-ASPSP-Code** (string) - Required - ASPSP code
- **X-TPP-Code** (string) - Required - TPP code

### Response
#### Success Response (200)
- **olayAbonelikNo** (string) - Subscription number
- **olusturmaZamani** (string) - Creation timestamp
- **guncellemeZamani** (string) - Update timestamp
- **katilimciBlg** (object) - Participant information
- **abonelikTipleri** (array) - List of subscribed event types
```

--------------------------------

### GET /iletilemeyen-olaylar

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/olay-bildirim.md

Yeniden gönderim politikası sonunda YÖS'e iletilemeyen olayları listeler. Sorgu zamanından 1 gün öncesinden sorgu anına kadar olan kayıtları getirir. Sayfalama 100'er kayıt olacak şekilde yapılır.

```APIDOC
## GET /iletilemeyen-olaylar

### Description
Bu servis, HHS kaynaklarında oluşan ve YÖS'e gönderilemeyen olayları listelemek için kullanılır. Yeniden gönderim politikası uygulandıktan sonra hala iletilemeyen olaylar, bu endpoint aracılığıyla sunulur. Aynı kaynak numarası ve olay-kaynak tipi için bir YÖS'e ait yalnızca bir adet iletilemeyen olay kaydı bulunabilir.

### Method
GET

### Endpoint
/iletilemeyen-olaylar

### Query Parameters
- **syfNo** (N3) - İsteğe bağlı - Cevapta dönecek sayfa numarası. 1'den başlayarak artan değerlerle iletilmelidir. Gönderilmediğinde ilk sayfa kayıtları döner.
- **olyZmnBslTrh** (ISODateTime) - İsteğe bağlı - Sorgulanacak Olay Zamanına ait başlangıç tarihi. Gönderilmediği veya sorgu zamanından 1 gün öncesinin başlangıç saatinden daha geri bir zaman dilimi gönderildiği durumda, başlangıç zamanı sorgu zamanından 1 gün öncesinin başlangıç saati olarak kabul edilir.
- **olyZmnBtsTrh** (ISODateTime) - İsteğe bağlı - Sorgulanacak Olay Zamanına ait bitiş tarihi. Gönderilmediği veya sorgu zamanından daha ileri bir zaman dilimi gönderildiği durumda, bitiş zamanı sorgu zamanı olarak kabul edilir.

### Request Example
```
GET /iletilemeyen-olaylar?syfNo=1&olyZmnBslTrh=2024-01-08T16:42:00+03:00&olyZmnBtsTrh=2024-01-09T17:09:00+03:00
```

### Response
#### Success Response (200)
Yanıt gövdesi, belirtilen kriterlere uyan iletilemeyen olayların listesini içerir. Veri olmaması halinde boş döner.

- **katilimciBlg** (Kompleks:KatilimciBilgisi) - Zorunlu - Katılımcılara atanmış kod bilgileri.
  - **hhsKod** (AN4) - Zorunlu - Hesap Hizmeti Sağlayıcısının kodudur.
  - **yosKod** (AN4) - Zorunlu - Yetkili Ödeme Hizmeti Sağlayıcısı (YÖS) kodudur.
- **olaylar** (Kompleks: Olaylar) - Zorunlu - Olay listesi.
  - **olayNo** (AN1..64) - Zorunlu - Olaya ait evrensel tekil numaradır.
  - **olayZamani** (ISODateTime) - Zorunlu - Olayın oluştuğu tarih bilgisidir.
  - **olayTipi** (AN1..36) - Zorunlu - TR.OHVPS.DataCode.OlayTip sıralı veri tiplerinden birini alır.
  - **kaynakTipi** (AN1..36) - Zorunlu - TR.OHVPS.DataCode.KaynakTip sıralı veri tiplerinden birini alır.
  - **kaynakNo** (AN1..128) - Zorunlu - Güncellenen kaynağa ait HHS sistemindeki tekil tanımlayıcı.

#### Response Example
```json
{
  "katilimciBlg": {
    "hhsKod": "HHS123",
    "yosKod": "YOS456"
  },
  "olaylar": [
    {
      "olayNo": "evt-12345",
      "olayZamani": "2024-01-08T10:00:00+03:00",
      "olayTipi": "ODEME_BASARISIZ",
      "kaynakTipi": "HESAP",
      "kaynakNo": "ACC98765"
    }
  ]
}
```
```

--------------------------------

### GET /yetkilendirme-kodu

Source: https://context7.com/ohvps/ohvps.github.io/llms.txt

Retrieves the authorization code for a specific consent process.

```APIDOC
## GET /yetkilendirme-kodu

### Description
Retrieves the authorization code after successful Strong Customer Authentication (GKD).

### Method
GET

### Endpoint
https://gecit-api.bkm.com.tr/ohvps/gkd/s2.0/yetkilendirme-kodu

### Parameters
#### Query Parameters
- **rizaNo** (string) - Required - Consent number
- **rizaTip** (string) - Required - Consent type (O, H, I, D)

### Response
#### Success Response (200)
- **yetKod** (string) - Authorization code
- **rizaNo** (string) - Consent number
- **rizaDrm** (string) - Consent status
```

--------------------------------

### Payment Initiation API

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/riza-durumlari.md

Explains the prerequisites and consent checks required before initiating a payment using the Payment Initiation API.

```APIDOC
## Payment Initiation API

### Description
This section details the process for initiating a payment using the Payment Initiation API, emphasizing the necessary access token and consent checks.

### Payment Initiation Process

1.  **Access Token Check**: First, check the validity of the access token. If the access token is not valid, return the error **TR.OHVPS.Connection.InvalidToken**.
2.  **Consent Status Check**: Perform consent checks.
    *   If the consent status is **Consent Revoked - I** or **Consent Terminated - S**, return the error **TR.OHVPS.Resource.ConsentRevoked**.
    *   If the consent status is **Pending Authorization - B**, **Authorized - Y**, or **Converted to Payment Order - E**, return the error **TR.OHVPS.Resource.ConsentMismatch**.
    *   If the consent status is **Usage Authorized - K**, the payment order is executed. The consent status should then be updated from **Usage Authorized - K** to **Converted to Payment Order - E**. (K &#8680; E)

### Querying Sender Account Information
During the successful completion of a GKD process and the authorization of a Payment Order Consent, if the sender account selection is made on the ASI screen, the sender account information (account number and/or account reference) must be retrieved by querying the `paymentEmriRizasi` object, as the sender account information field is mandatory in the payment order request.
```

--------------------------------

### GET /kartlar and GET /kartlar/{kartRef}

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/hesap-bilgisi-hizmeti.md

These endpoints allow querying for all cards or a specific card's information. The '07' permission type is sufficient for these queries. Only active/open status cards are listed in HHS screens. Special handling is required for virtual/supplementary cards to ensure proper consent is obtained.

```APIDOC
## GET /kartlar and GET /kartlar/{kartRef}

### Description
Retrieves a list of all cards or details of a specific card. Requires '07' permission type. Only active/open status cards are displayed in HHS screens. Special rules apply to virtual and supplementary cards.

### Method
GET

### Endpoint
/kartlar
/kartlar/{kartRef}

### Parameters
#### Query Parameters
- **syfKytSayi** (integer) - Optional - Number of records per page.
- **syfNo** (integer) - Optional - Page number.
- **kartTipi** (string) - Optional - Type of card to filter (e.g., 'K' for credit card).

#### Path Parameters
- **kartRef** (string) - Required - The reference ID of the card to retrieve details for.

### Request Example
```json
GET /kartlar?syfKytSayi=25&syfNo=1&kartTipi=K
GET /kartlar/{kartRef}
```

### Response
#### Success Response (200)
- **KartBilgileri** (object) - Contains the details of the queried card(s).

#### Response Example
```json
{
  "KartBilgileri": [
    {
      "kartRef": "string",
      "kartTipi": "string",
      "kartDurumu": "string",
      "hesapRef": "string"
    }
  ]
}
```

### Error Handling
- **TR.OHVPS.Resource.InvalidFormat**: Invalid format for parameters.
- **TR.OHVPS.Connection.InvalidToken**: Invalid access token.
- **TR.OHVPS.Resource.ConsentMismatch**: Consent status mismatch (e.g., Pending or Authorized).
- **TR.OHVPS.Resource.ConsentRevoked**: Consent has been revoked or terminated.
- **TR.OHVPS.Business.PermissionTypeNotSupported**: The '07: Basic Card Information' permission type is not held.
- **TR.OHVPS.Business.RestrictedChannelAccess**: Restricted channel access for card information.
```

--------------------------------

### Yenileme Belirteci ile Erişim Belirteci Alma

Source: https://context7.com/ohvps/ohvps.github.io/llms.txt

Erişim belirtecinin süresi dolduğunda, yenileme belirteci kullanarak yeni bir erişim belirteci almak için bu cURL komutunu kullanın.

```bash
curl -X POST "https://gecit-api.bkm.com.tr/ohvps/gkd/s2.0/erisim-belirteci" \
  -H "Authorization: Bearer {client_credentials_token}" \
  -H "X-Request-ID: $(uuidgen)" \
  -H "X-ASPSP-Code: 2001" \
  -H "X-TPP-Code: 2501" \
  -H "Content-Type: application/json" \
  -H "X-JWS-Signature: {jws_signature}" \
  -d '{
    "rizaNo": "cb54834e-36f7-42d0-9af3-d534ece3352a",
    "rizaTip": "O",
    "yetTip": "yenileme_belirteci",
    "yenilemeBelirteci": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4..."
  }'
```

--------------------------------

### POST /duzenli-odeme-emri

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/duzenli-odeme-emri-hizmeti.md

Creates a regular payment order (DuzenliOdemeEmri) after the PSU authorizes the transaction with Strong Customer Authentication. The PSU (ÖHK) authorizes the transaction, and then the ASPSP (ÖBHS) creates the DuzenliOdemeEmri resource.

```APIDOC
## POST /duzenli-odeme-emri

### Description
Creates a regular payment order (DuzenliOdemeEmri) after the PSU authorizes the transaction with Strong Customer Authentication. The PSU (ÖHK) authorizes the transaction, and then the ASPSP (ÖBHS) creates the DuzenliOdemeEmri resource.

### Method
POST

### Endpoint
/duzenli-odeme-emri

### Parameters
#### Request Body
- **rzBlg** (Complex: RizaBilgileri) - Required - Consent information.
  - **rizaNo** (AN1..128) - Required - Unique identifier assigned by the ASPSP during the creation of the OdemeEmriRizasi resource.
  - **olusZmn** (ISODateTime) - Required - Creation timestamp of the OdemeEmriRizasi resource.
  - **rizaDrm** (AN1) - Required - One of the values from the **TR.OHVPS.DataCode.RizaDurumu** enumerated data type.
- **katilimciBlg** (Complex:KatilimciBilgisi) - Required - Codes assigned to participants.
  - **hhsKod** (AN4) - Required - Code of the Account Servicing Institution (ASI) to which the request is sent. (Code of the institution holding the PSU, e.g., Bank, Electronic Money Institution, Payment Institution). The ASI checks if the hhsKod belongs to it and matches the x-aspsp-code in the request header.
  - **yosKod** (AN4) - Required - Code of the Authorized Payment Service Provider (APSP) sending the request. The ASI checks if the yosKod is a valid APSP code and matches the x-tpp-code in the request header.
- **gkd** (Complex:Gkd) - Required - Strong Customer Authentication (SCA) information.
  - **yetYntm** (AN1) - Required - One of the values from the **TR.OHVPS.DataCode.GkdTur** enumerated data type.
  - **yonAdr** (AN1..1024) - Optional - Mandatory for redirected strong customer authentication. The ASI redirects the PSU's application/browser to the APSP address specified in this field in a redirected flow.
  - **ayrikGkd** (Complex:AyrikGkd) - Optional - Mandatory for decoupled strong customer authentication. If yetYntm = A is sent, the ayrikGkd object must be populated. This object should not be sent for yetYntm = Y.
    - **ohkTanimTip** (AN8) - Optional - Definition types that allow the PSU to be recognized by the ASI application. Transmitted without modification from the request.
    - **ohkTanimDeger** (AN1..30) - Optional - Definition value that allows the PSU to be recognized by the ASI application. Must be compatible with ohkTanimTip. Transmitted without modification from the request.

### Request Example
{
  "rzBlg": {
    "rizaNo": "string",
    "olusZmn": "2023-10-27T10:00:00Z",
    "rizaDrm": "Y"
  },
  "katilimciBlg": {
    "hhsKod": "BANK",
    "yosKod": "APSP"
  },
  "gkd": {
    "yetYntm": "Y",
    "yonAdr": "https://example.com/redirect",
    "ayrikGkd": {
      "ohkTanimTip": "PSU_ID",
      "ohkTanimDeger": "1234567890"
    }
  }
}

### Response
#### Success Response (200)
- **tlmtNo** (string) - Transaction limit number.
- **DuzenliOdemeEmri** (object) - The created regular payment order object.
  - **rizaDrm** (string) - The status of the consent, updated to "Yetki Ödeme Emrine/Talimata Dönüştü".

#### Response Example
{
  "tlmtNo": "TLMT123456789",
  "DuzenliOdemeEmri": {
    "rizaDrm": "E"
  }
}

### Error Handling
- **TR.OHVPS.Connection.InvalidToken**: Returned if a valid Access Token is not present.
- **TR.OHVPS.Resource.InvalidFormat**: Returned if fields in the request message do not meet the requirements specified in the OHVPS API Policy and Rules document (mandatory, length, and content checks).
- **TR.OHVPS.Connection.InvalidASPSP**: Returned if the hhsKod does not belong to the ASI and does not match the x-aspsp-code in the request header.
- **TR.OHVPS.Connection.InvalidTPP**: Returned if the yosKod is not a valid APSP code or does not match the x-tpp-code in the request header.
- **TR.OHVPS.Resource.ConsentMismatch**: Returned if the consent status is 'B' (Awaiting Authorization), 'Y' (Authorized), or 'E' (Authorization Converted to Payment Order).
- **TR.OHVPS.Resource.ConsentRevoked**: Returned if the consent status is 'I' (Consent Revoked) or 'S' (Authorization Terminated).
- **TR.OHVPS.Business.FieldMismatch**: Returned if values sent in the POST /duzenli-odeme-emri-rizasi and POST /duzenli-odeme-emri requests differ, specifically when a value sent in the regular payment order request is different from the values sent in the regular payment order consent.
```

--------------------------------

### Payment Initiation Data Structures

Source: https://github.com/ohvps/ohvps.github.io/blob/master/docs/v2.0.0/contents/ileri-tarihli-odeme-emri-hizmeti.md

Defines the structure for payment initiation requests, including sender/receiver details, Kolay Adres (KOLAS) integration, and QR code parameters.

```APIDOC
## Payment Initiation Data Structures

### Description
This documentation outlines the complex data structures required for initiating payments, including sender and receiver account details, Kolay Adres (KOLAS) integration, and QR code specifications.

### Parameters
#### Request Body
- **gon** (Object) - Required - Sender information
  - **unv** (AN3..140) - Required - Sender title
  - **hspNo** (AN26) - Optional - Sender IBAN
  - **hspRef** (AN5..40) - Optional - Sender account reference (UUID)
- **alc** (Object) - Required - Receiver information
  - **unv** (AN3..140) - Required - Receiver title
  - **hspNo** (AN26) - Required - Receiver IBAN
  - **kolas** (Object) - Optional - Kolay Adres details
    - **kolasTur** (AN1) - Required - KOLAS type
    - **kolasDgr** (AN7..50) - Required - KOLAS value
    - **kolasRefNo** (N12) - Required - KOLAS reference number
    - **kolasHspTur** (AN1) - Required - KOLAS account type
- **kkod** (Object) - Optional - QR Code details
  - **aksTur** (AN2) - Required - Flow type
  - **kkodRef** (AN1..12) - Optional - QR reference number
  - **kkodUrtcKod** (AN4) - Required - QR producer code
- **odmAyr** (Object) - Required - Payment details
  - **odmKynk** (AN1) - Required - Payment source (Value: 'O')
  - **odmAmc** (AN2) - Required - Payment purpose
```