Cari müqavilə: Sorğu
refundDestinationTypesahəsini dəstəkləyir (standartCARD). Ödəniş ID-si üzrə bölgüləri refund etmək üçünPOST /payment/v1/refund-transactions/byPaymentIdistifadə olunur. Cavaba cariisAfterSettlement, gift-card, point, money-box, loyalty, cashback, destination, host-reference və auth-code sahələri əlavə edilib.
URL
Ödənişin geri qaytarılma əməliyyatı üçün istifadə edilən endpoint və http metodu haqqında məlumat aşağıda verilmişdir:
| HTTP Metod | URL |
|---|---|
POST |
/payment/v1/refund-transactions |
Sorğu Parametrləri
Geri qaytarma əməliyyatını həyata keçirmək üçün sorğularda göndərilməsi gözlənilən parametrlər aşağıdakı cədvəl və alt başlıqlar altında sadalanmışdır.
| Parametrin Adı | Növü | Məcburi | Açıqlama |
|---|---|---|---|
paymentTransactionId |
number |
Bəli | Geri qaytarılması tələb olunan ödəniş bölgüsünün ID-si |
conversationId |
string |
Xeyr | Sorğu ilə göndərilə bilən və cavabla qəbul edilə bilən "bumeranq" dəyəri. Müxtəlif sorğuları bir-biri ilə əlaqələndirmək üçün istifadə edilə bilər. Adətən, üzv biznesin ödənişlə əlaqəli sifariş nömrəsi istifadə olunur. |
refundPrice |
number |
Xeyr | Geri qaytarılacaq məbləğ |
refundDestinationType |
string |
Xeyr | Geri qaytarma karta həyata keçirildikdə CARD pul kisəsinə həyata keçirildikdə isə WALLET daxil ediləcək sahə. Defolt dəyər CARD |
Qayıdış Parametrləri
| Parametrin Adı | Növü | Açıqlama |
|---|---|---|
id |
number |
Geri qaytarma əməliyyatı ilə bağlı yaradılan geri qaytarma ID-si |
conversationId |
string |
Sorğu ilə birlikdə göndərilən conversationId dəyəri |
createdDate |
date |
Geri qaytarılan tarix və saat |
status |
string |
Uğurlu geri qaytarma əməliyyatları üçün SUCCESS uğursuz geri qaytarma əməliyyatları üçün FAILURE qayıdır |
isAfterSettlement |
boolean |
Qaytarılan bölgünün qiyməti geri qaytarma əməliyyatı pulun göndərilməsindən sonra həyata keçirildikdə true pulun göndərilməsindən əvvəl həyata keçirildikdə false olur. |
refundPrice |
decimal |
Bölgü ilə əlaqədar qaytarılan məbləğ |
refundBankPrice |
decimal |
Bölgü ilə əlaqədar geri qaytarılan bank məbləği |
refundWalletPrice |
decimal |
Bölgü ilə əlaqədar geri qaytarılan pul kisəsi məbləği |
refundDestinationType |
string |
Qaytarılan pul kisəsi məbləği |
currency |
string |
Qaytarılan məbləğin valyutası |
paymentTransactionId |
number |
Qaytarılan ödənişin bölgüsünə aid ID |
paymentId |
number |
Geri qaytarılan ödənişə aid ID |
currency |
string |
Geri qaytarılan məbləğin valyutası |
refundDestinationType |
string |
Geri qaytarma karta həyata keçirildikdə CARD pul kisəsinə həyata keçirildikdə isə WALLET daxil ediləcək sahə. Default dəyər CARD |
Nümunəvi Kodlar
Açıq mənbə kodlu Odero API client-lərindəki nümunəvi kodları nəzərdən keçirə bilərsiniz
- .NET: https://github.com/TokenPayEng/tokenpay-dotnet-client/blob/master/Samples/PaymentSample.cs
- PHP: https://github.com/TokenPayEng/tokenpay-php-client/blob/master/samples/refund_payment_transaction.php
- Java: https://github.com/TokenPayEng/tokenpay-java-client/blob/master/src/test/java/tr/com/tokenpay/sample/PaymentSample.java
- Node.js: https://github.com/TokenPayEng/tokenpay-node-client/blob/master/samples/payment/RefundPaymentTransaction.js