Pul Köçürməsi Ödəniş Kodları

Public merchant API /payment/v1/money-transfers əsas yolundan və göstərilən əməliyyatlarda merchantId request header-dan istifadə edir.

Kod Yaratma

POST /payment/v1/money-transfers/code çağırılır. JSON gövdəsi price (məcburi, müsbət, maksimum 2.000.000), currency (DTO-da məcburi, standart TRY), token (məcburi), conversationId (istəyə bağlı, maksimum 255 simvol), orderId (istəyə bağlı, maksimum 50 simvol) və items (məcburi, 1–250 ödəniş bölgüsü) sahələrini ehtiva edir. Header-da merchantId göndərilir.

Kodun Sorğulanması

JSON gövdəsində token ilə POST /payment/v1/money-transfers/retrieve çağırılır. Cari controller bu endpoint üçün merchant header tələb etmir.

Kodun Yenilənməsi

Gövdədə requestId və code, header-da merchantId ilə POST /payment/v1/money-transfers/update çağırılır.

Hər üç əməliyyat requestId, code, token və accountResult qaytarır. accountResult.accounts elementləri iban, bankCode və bankName sahələrini ehtiva edir.

Yaratma DTO-sunda Bean Validation qaydaları müəyyən edilib, lakin cari controller request body parametrlərində code>@Valid</code istifadə etmir. İnteqrasiyalar yenə də bu qaydalara əməl etməlidir; runtime yoxlaması servis tərəfində ayrıca nəzərdən keçirilməlidir.