Ana içeriğe geç

Dönüş POST'u

secure-payment, create-order ve create-subscription akışlarında, ödeme tamamlandıktan sonra gateway müşterinin tarayıcısına otomatik gönderilen bir HTML formu döner. Form, sizin verdiğiniz adrese POST edilir.

AkışAdresNe zaman gönderilir
secure-paymenttransaction.callback_urlÖdeme başarılı ya da başarısız tamamlandığında; ayrıca süresi dolmuş bir redirect_url açıldığında.
create-orderorder.success_urlYalnızca ödeme başarılı olduğunda.
create-subscriptionsubscription.success_urlYalnızca ödeme başarılı olduğunda.

Ödeme sayfasında (create-order, create-subscription) başarısız olan bir denemeden sonra success_url adresine bir şey gönderilmez; tarayıcı checkout_url?attempt={transaction.token} adresine yönlendirilir.

Ödeme linkinde (create-payment-link) dönüş POST'u gönderilmez; ödemenin sonucunu webhook ve retrieve-link-payments ile öğrenirsiniz.

İstek​

POST /odeme/donus HTTP/1.1
Host: magazam.com
Content-Type: application/x-www-form-urlencoded

transaction_token=0b8f6c2d-3e41-4a7b-9c5d-1e2f3a4b5c6d&reference=SIP-10231&successful=1
AlanTipAçıklama
transaction_tokenstringÖdemenin token'ı.
referencestringÖdemenin reference değeri. Ödeme sayfası akışlarında siparişin ya da aboneliğin referansı. Referans tekil olmadığından kaydı transaction_token ile eşleştirin.
successfulstring"1" ya da "0".

Güvenlik​

Bu istek gateway sunucusundan değil, müşterinin tarayıcısından gelir. İmzası yoktur ve herhangi biri aynı alanlarla bir istek gönderebilir.

  • successful alanına göre sipariş durumunu değiştirmeyin.
  • Ödemenin sonucunu transaction_token ile retrieve-payments uç noktasından alın; o yanıt imzalıdır.
  • successful=0 değerini yalnızca gereksiz bir sorguyu atlamak için kullanabilirsiniz.
  • Müşteri sekmeyi kapatırsa bu istek hiç gelmez. Sunucudan sunucuya haber için panelde Ödeme Ayarları → Webhook sayfasında webhook adresi tanımlayın.

Tekrar gelen dönüşler​

Aynı ödeme için dönüş formu birden fazla kez gönderilebilir: bankanın ve tarayıcının dönüş adresine ikisinin de ulaşması ya da kullanıcının sayfayı yenilemesi durumunda form yeniden üretilir. Ödeme yalnızca bir kez tamamlanır; sonraki gönderimler aynı sonucu taşır. Dönüş işleyicinizi aynı transaction_token ile tekrar çalıştığında sonucu değiştirmeyecek şekilde yazın.

Örnek işleyici​

not

Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.

use Gurmehub\Odemehub\Request\RetrievePayments;

$payment = $client->retrievePayments(RetrievePayments::byToken($_POST['transaction_token']))->payments[0] ?? null;

if ($payment?->isSuccessful()) {
// $payment->reference ile siparişi ödendi olarak işaretleyin
}