Para Transferi Ödeme Kodları

Public merchant API, /payment/v1/money-transfers ana yolunu ve belirtilen işlemlerde merchantId request header'ını kullanır.

Kod Oluşturma

POST /payment/v1/money-transfers/code çağrılır. JSON gövdesi price (zorunlu, pozitif, en fazla 2.000.000), currency (DTO'da zorunlu, varsayılan TRY), token (zorunlu), conversationId (isteğe bağlı, en fazla 255 karakter), orderId (isteğe bağlı, en fazla 50 karakter) ve items (zorunlu, 1–250 ödeme kırılımı) alanlarını içerir. Header'da merchantId gönderilir.

Kod Sorgulama

JSON gövdesinde token ile POST /payment/v1/money-transfers/retrieve çağrılır. Güncel controller bu endpointte merchant header istemez.

Kod Güncelleme

Gövdesinde requestId ve code, header'da merchantId ile POST /payment/v1/money-transfers/update çağrılır.

Üç işlem de requestId, code, token ve accountResult döndürür. accountResult.accounts öğeleri iban, bankCode ve bankName alanlarını içerir.

Oluşturma DTO'sunda Bean Validation kuralları tanımlıdır; ancak güncel controller request body parametrelerinde code>@Valid</code kullanmıyor. Entegrasyonlar yine de bu kurallara uymalıdır; runtime doğrulaması servis tarafında ayrıca gözden geçirilmelidir.