Ödeme kırılımı onayını geri almak için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir.
| HTTP Metod | URL |
|---|---|
POST |
/payment/v1/payment-transactions/disapprove |
Ödeme kırılımı onayı geri almak için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.
| Parametre Adı | Tipi | Zorunlu | Açıklama |
|---|---|---|---|
paymentTransactionIds |
number[] |
Evet | Daha önce verilmiş olan onayı geri almak istenen ödeme kırılımlarının ID değerlerini barındırır |
isTransactional |
boolean |
Hayır | Onaylama işlemi sırasında eğer herhangi bir ödeme kırılımı süreçsel nedenlerden dolayı onay geri çekilemezse bu değer true ise hiçbir ödeme kırılımının onayı geri çekilmez. Eğer bu değer false ise onayı geri çekilebilen ödeme kırılımlarının onayları geri alınır onaylanamayanlar ise onaylanamamış durumda kalır. |
Ödeme işleminin sonucunda dönen parametreler de API dokümantasyonu giriş sayfasındaki Dönüş Formatları bölümünde belirtilen kurallara tabidir. Sistemsel ya da kurgusal bir hata bulunmadığı durumda data parametresinde dönen objenin alt parametreleri aşağıdaki gibidir:
| Parametre Adı | Tipi | Açıklama |
|---|---|---|
size |
number |
Onaylama işlemi sonucunda etkilenen ödeme kırılımı sayısı |
items |
PaymentTransactionApproval[] |
Onaylama işlemine dair bilgileri taşıyan obje bkz: Ödeme Kırılımı Onay Bilgileri |
Ödeme kırılımı onay ve onay geri çekme isteği yapılırken dönüş objesi içerisinde yapılan işleme ve ödeme kırılımına ait bilgiler içeren objedir.
| Parametre Adı | Tipi | Açıklama |
|---|---|---|
paymentTransactionId |
number |
Ödeme kırılımının ID'si |
approvalStatus |
string |
Ödeme kırılımı sonucu başarılı ise SUCCESS başarısız ise FAILURE değerini barındırır |
failedReason |
string |
Ödeme kırılımı onaylama ya da onay geri çekme sonucu hatalı ise hata detayına dair bilgi barındırır |
Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.