Ana içeriğe geç

Sipariş Ödemesi

create-order kart verisi almaz. Sipariş açılır ve ödeme, gateway'in ödeme sayfasında (order.checkout_url) 3D Secure ile alınır. Tutar gönderilmez: kalemlerden ve müşterinin seçtiği gönderim yönteminden hesaplanır; ödeme sayfasında kupon uygulanırsa indirim kalemlerden düşülür (Kupon).

  1. Sipariş açma — Sunucunuz create-order çağırır. Yanıt order.token ve order.checkout_url döner; çekim yapılmaz.
  2. Yönlendirme — Tarayıcıyı order.checkout_url adresine yönlendirirsiniz.
  3. Dönüş — Ödeme başarılı olursa tarayıcı success_url adresinize bir form POST eder: transaction_token, reference (siparişin), successful. Bkz. Dönüş POST'u. Panelde order.paid olayına adres tanımladıysanız gateway sunucusu da o adrese webhook gönderir.
  4. Sonuç — Sunucunuz retrieve-orders ile siparişin status değerine ya da transaction_token ile retrieve-payments yanıtına bakar.

Ön koşullar​

  • Çalışma alanınızda Siparişler modülü açık olmalıdır; değilse 403.
  • Siparişin ödeneceği hesap (gönderilen payment_provider_token ya da varsayılan hesap) 3D ödeme almalıdır; almıyorsa 422.

1. Sipariş açma​

Kalemler adı, KDV dahil birim fiyatı, adedi ve KDV oranıyla gönderilir (Kalemler). requires_shipping: true ödeme sayfasında gönderim adresi ister ve ödeyene, panelde Gönderim sayfasında tanımladığınız yöntemlerden o adrese gönderenleri sunar; seçilen yöntem order.shipping_method alanında döner ve ücreti tutara eklenir (Gönderim yöntemleri). customer.reference gönderirseniz sipariş ödendiğinde ödeyen bu referansla müşterileriniz arasına yazılır (Müşteri kaydı).

not

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

use Gurmehub\Odemehub\Request\{CreateOrder, Customer, Item};

$created = $client->createOrder(new CreateOrder(
reference: 'SIP-10233',
successUrl: 'https://magazam.com/tesekkurler',
items: [
new Item(name: 'Kahve makinesi', unitAmount: '450.00', quantity: 1, taxRate: '20', reference: 'KAHVE-MAKINESI'),
new Item(name: 'Kahve 500 g', unitAmount: '180.00', quantity: 2, taxRate: '10'),
],
customer: new Customer(reference: 'musteri-88'),
cancelUrl: 'https://magazam.com/sepet',
requiresShipping: true,
));

$orderToken = $created->order->token; // sorgu ve değişiklik için saklayın
header('Location: '.$created->order->checkoutUrl);

reference tekil değildir. Aynı reference ile create-order her çağrıldığında yeni bir sipariş ve yeni bir order.token açılır; önceki siparişler olduğu gibi kalır ve istek 422 dönmez. Yanıttaki order.token değerini kendi siparişinizle birlikte saklayın; sorgu, değişiklik ve webhook eşleştirmesi token'la yapılır. Bkz. Aynı referansla tekrarlanan create-* istekleri.

2–3. Ödeme sayfası ve dönüş​

OlayDavranış
Ödeme başarılıTarayıcı success_url adresine dönüş formunu POST eder.
Ödeme başarısızsuccess_url adresine bir şey gönderilmez; tarayıcı checkout_url?attempt={transaction.token} adresine döner.
cancel_urlÖdeme sayfasında geri dönüş bağlantısı olarak verilir. Gateway bu adrese istek göndermez.

Dönüş formundaki reference, siparişin reference değeridir (SIP-10233). Aynı referanslı birden çok sipariş olabileceği için ödemeyi transaction_token ile eşleştirin. Gönderilmeyen müşteri bilgileri ödeme sayfasında alınır.

Ödeme tamamlanmadıysa​

Ödeme tamamlanmadıysa aynı sipariş numarasıyla create-order yeniden çağrılabilir ve tarayıcı yeni yanıttaki order.checkout_url adresine yönlendirilir. Önceki sipariş open olarak kalır; iki sipariş order.token ile ayırt edilir.

4. Sonuç​

use Gurmehub\Odemehub\Request\RetrieveOrders;

$order = $client->retrieveOrders(RetrieveOrders::byToken($orderToken))->orders[0] ?? null;

if ($order?->isPaid()) {
$order->transaction->token; // iade ve iptalde kullanılır
}

Dönüş POST'u tarayıcıdan geldiği için gelmeyebilir. Sonucu sunucudan almak için:

  • Panelde Ödeme Ayarları → Webhook sayfasında order.paid webhook'u tanımlayın.
  • Siparişi token'ıyla ya da referansıyla retrieve-orders ile sorun. Referansla sorguda o referanstaki siparişlerin hepsi döner; ödenmiş olan status: "paid" ile ayırt edilir.
  • Siparişin bütün ödeme denemelerini (reddedilenler dahil) siparişin referansıyla retrieve-payments ile listeleyin; siparişe ait denemelerde order.token doludur. Aynı referansla birden çok sipariş açıldıysa hepsinin denemeleri döner; denemeleri order.token ile siparişe eşleştirin.

Kupon​

API'de kupon alanı yoktur; kupon kodu ödeme sayfasında girilir. Kupon uygulanan siparişin retrieve-orders yanıtında discount alanı {code, amount} olarak dolu gelir ve subtotal, tax_amount, amount indirim düşülmüş değerlerdir. İndirim gönderim ücretinden düşülmez. order.paid webhook gövdesi discount taşımaz; kupon bilgisi retrieve-orders ile alınır. Bkz. Kupon ve discount.

Siparişi değiştirmek​

Ödenmemiş sipariş token'ıyla update-order ile değiştirilir; yalnızca gönderilen alanlar yazılır, kalemler gönderilirse tamamı yenilenir. Ödenmiş sipariş ve ödeme sayfasında son 15 dakika içinde başlamış, sonuçlanmamış bir ödemesi olan sipariş değiştirilemez. Aynı referansla create-order çağırmak var olan siparişi değiştirmez, yeni sipariş açar.

İade ve iptal​

Sipariş ödemesi order.transaction.token üzerinden refund-payment ve cancel-payment ile geri verilir. Bkz. İade ve İptal.