Skip to main content
Bu rehber API Store ile uçtan uca bir ödeme akışını anlatır: ödeme linki oluşturun, müşterinizi checkout’a yönlendirin ve ödemeyi doğrulayın.

Gereksinimler

  • En az bir mağazası olan bir PapelShip hesabı
  • Bir API anahtarı (psa_...), sayısal API Key ID değeri ve 12 karakterlik Store Hash ID
Üç değeri de PapelShip panelinde mağazanızın API ayarları altında bulabilirsiniz.
1

Ödeme linki oluşturun

Sipariş tutarını ödeme linki endpoint’ine gönderin. Tekrar denemelerde mükerrer fatura oluşmaması için Idempotency-Key header’ı ekleyin.
2

Müşterinizi yönlendirin

Yanıtta bir checkout_url döner. Müşterinizi kart, Papara, havale veya kripto ile ödeme yapması için bu adrese gönderin.
Yanıt
invoice.id değerini siparişinizle birlikte saklayın. Ödemeyi kontrol etmek için buna ihtiyacınız olacak.
3

Ödemeyi doğrulayın

Müşteri redirect_url adresinize döndüğünde ödemeyi sunucunuzda doğrulayın. Yalnızca yönlendirmeye güvenmeyin.
Siparişi yalnızca payment.is_paid değeri true olduğunda teslim edin.
API anahtarınızı sunucuda tutun. Asla tarayıcı koduna, mobil uygulamalara veya masaüstü istemcilere gömmeyin.

Sonraki adımlar

Kripto faturaları

Özel deposit adresi ve QR kod ile kendi checkout’unuzu gösterin.

API Store referansı

Tüm endpoint, parametre ve yanıtları inceleyin.