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).
- Sipariş açma — Sunucunuz
create-orderçağırır. Yanıtorder.tokenveorder.checkout_urldöner; çekim yapılmaz. - Yönlendirme — Tarayıcıyı
order.checkout_urladresine yönlendirirsiniz. - Dönüş — Ödeme başarılı olursa tarayıcı
success_urladresinize bir formPOSTeder:transaction_token,reference(siparişin),successful. Bkz. Dönüş POST'u. Paneldeorder.paidolayına adres tanımladıysanız gateway sunucusu da o adrese webhook gönderir. - Sonuç — Sunucunuz
retrieve-ordersile siparişinstatusdeğerine ya datransaction_tokenileretrieve-paymentsyanı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_tokenya da varsayılan hesap) 3D ödeme almalıdır; almıyorsa422.
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ı).
Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.
- PHP
- Node.js
- Python
- Java
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);
const created = await client.createOrder({
reference: 'SIP-10233',
successUrl: 'https://magazam.com/tesekkurler',
items: [
{ name: 'Kahve makinesi', unitAmount: '450.00', quantity: 1, taxRate: '20', reference: 'KAHVE-MAKINESI' },
{ name: 'Kahve 500 g', unitAmount: '180.00', quantity: 2, taxRate: '10' },
],
customer: { reference: 'musteri-88' },
cancelUrl: 'https://magazam.com/sepet',
requiresShipping: true,
});
const orderToken = created.order.token; // sorgu ve değişiklik için saklayın
res.redirect(created.order.checkoutUrl!);
from odemehub.request import CreateOrder, Customer, Item
created = client.create_order(CreateOrder(
reference="SIP-10233",
success_url="https://magazam.com/tesekkurler",
items=[
Item(name="Kahve makinesi", unit_amount="450.00", quantity=1, tax_rate="20", reference="KAHVE-MAKINESI"),
Item(name="Kahve 500 g", unit_amount="180.00", quantity=2, tax_rate="10"),
],
customer=Customer(reference="musteri-88"),
cancel_url="https://magazam.com/sepet",
requires_shipping=True,
))
order_token = created.order.token # sorgu ve değişiklik için saklayın
return redirect(created.order.checkout_url)
import com.odemehub.request.CreateOrder;
import com.odemehub.request.Customer;
import com.odemehub.request.Item;
import java.util.List;
var created = client.createOrder(CreateOrder.builder()
.reference("SIP-10233")
.successUrl("https://magazam.com/tesekkurler")
.items(List.of(
Item.builder().name("Kahve makinesi").unitAmount("450.00").quantity(1).taxRate("20").reference("KAHVE-MAKINESI").build(),
Item.builder().name("Kahve 500 g").unitAmount("180.00").quantity(2).taxRate("10").build()
))
.customer(Customer.builder().reference("musteri-88").build())
.cancelUrl("https://magazam.com/sepet")
.requiresShipping(true)
.build());
var orderToken = created.getOrder().getToken(); // sorgu ve değişiklik için saklayın
return "redirect:" + created.getOrder().getCheckoutUrl();
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üş
| Olay | Davranış |
|---|---|
| Ödeme başarılı | Tarayıcı success_url adresine dönüş formunu POST eder. |
| Ödeme başarısız | success_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ç
- PHP
- Node.js
- Python
- Java
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
}
const [order] = (await client.retrieveOrders({ token: orderToken })).orders;
if (order?.isPaid()) {
order.transaction?.token; // iade ve iptalde kullanılır
}
from odemehub.request import RetrieveOrders
orders = client.retrieve_orders(RetrieveOrders(token=order_token)).orders
if orders and orders[0].is_paid():
orders[0].transaction # iade ve iptalde kullanılır
import com.odemehub.request.RetrieveOrders;
var orders = client.retrieveOrders(RetrieveOrders.byToken(orderToken)).getOrders();
if (!orders.isEmpty() && orders.get(0).isPaid()) {
orders.get(0).getTransaction().getToken(); // 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.paidwebhook'u tanımlayın. - Siparişi token'ıyla ya da referansıyla
retrieve-ordersile sorun. Referansla sorguda o referanstaki siparişlerin hepsi döner; ödenmiş olanstatus: "paid"ile ayırt edilir. - Siparişin bütün ödeme denemelerini (reddedilenler dahil) siparişin referansıyla
retrieve-paymentsile listeleyin; siparişe ait denemelerdeorder.tokendoludur. Aynı referansla birden çok sipariş açıldıysa hepsinin denemeleri döner; denemeleriorder.tokenile 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.