Entegrasyon Tarifleri
Sık kullanılan entegrasyon kalıpları ve kısa örnekler.
Kopyala-yapıştır tarifleri; production’da doğrudan kullanmadan önce kendi domain modelinize uyarlayın.
Sipariş → ödeme
const order = await createOrder(cart);
const payment = await hsrcpay.payments.create({
amount: order.totalAmount,
currency: order.currency,
metadata: { orderId: order.id },
});
await hsrcpay.payments.confirm(payment.id, { paymentMethod: { id: pmId } });Webhook ile sipariş kapatma
if (event.type === "payment.succeeded") {
await markOrderPaid(event.data.paymentId ?? event.data.metadata?.orderId);
}Event payload şekli abonelik ettiğiniz sürüme göre değişebilir; her zaman payment GET ile doğrulayın.
Güvenli hata yüzeyi
try {
await hsrcpay.payments.confirm(paymentId, body);
} catch (error) {
logger.error({ error, paymentId }, "confirm_failed");
return { ok: false, reason: "PAYMENT_UNAVAILABLE" };
}Kullanıcıya ham provider mesajı göstermeyin.