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ış | Adres | Ne zaman gönderilir |
|---|---|---|
secure-payment | transaction.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-order | order.success_url | Yalnızca ödeme başarılı olduğunda. |
create-subscription | subscription.success_url | Yalnı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
| Alan | Tip | Açıklama |
|---|---|---|
transaction_token | string | Ödemenin token'ı. |
reference | string | Ö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. |
successful | string | "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.
successfulalanına göre sipariş durumunu değiştirmeyin.- Ödemenin sonucunu
transaction_tokenileretrieve-paymentsuç noktasından alın; o yanıt imzalıdır. successful=0değ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
Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.
- PHP
- Node.js
- Python
- Java
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
}
app.post('/odeme/donus', express.urlencoded({ extended: false }), async (req, res) => {
const [payment] = (await client.retrievePayments({ token: req.body.transaction_token })).payments;
if (payment?.isSuccessful()) {
// payment.reference ile siparişi ödendi olarak işaretleyin
}
});
from odemehub.request import RetrievePayments
@app.post("/odeme/donus")
def odeme_donus():
payments = client.retrieve_payments(RetrievePayments(token=request.form["transaction_token"])).payments
if payments and payments[0].is_successful():
... # payments[0].reference ile siparişi ödendi olarak işaretleyin
import com.odemehub.request.RetrievePayments;
@PostMapping("/odeme/donus")
public String odemeDonus(@RequestParam("transaction_token") String transactionToken) {
var payments = client.retrievePayments(RetrievePayments.byToken(transactionToken)).getPayments();
if (!payments.isEmpty() && payments.get(0).isSuccessful()) {
// payments.get(0).getReference() ile siparişi ödendi olarak işaretleyin
}
// ...
}