Ana içeriğe atla
PapelShip JavaScript SDK, PapelPay kart formunu kendi ödeme sayfanızın içine yerleştirir; müşteri sitenizden ayrılmaz. Form PapelShip’ten bir çerçeve içinde yüklenir: kart bilgileri sunucunuza ya da sayfanıza hiç uğramaz.

Başlamadan önce

  • Kart ödemesini sunucunuzda POST /api/v1/invoices/{invoiceId}/papelpay ile başlatın ve payment.embed_url adresini sayfanıza iletin. Bkz. Genel bakış.
  • Ödeme sayfanızın alan adını panelde PapelPay > Alan adları bölümüne ekleyip doğrulayın. Mağazanızın doğrulanmış özel alan adı ve onun alt alan adları da çalışır.
  • Geliştirme sırasında localhost ve 127.0.0.1 ayar gerektirmeden çalışır.
Doğrulanmamış bir alan adında çerçeve formun yerine bir uyarı gösterir ve onError origin_not_allowed alır.

Formu yerleştirin

odeme.html
Çerçeve içeriğine göre büyüyüp küçülür. mount { iframe, destroy } döner; formu kaldırmak için, örneğin müşteri başka bir ödeme yöntemi seçtiğinde, card.destroy() çağırın.

Seçenekler

Olaylar

Aynı olaylar PapelShip.on("papelpay:paid", fn), papelpay:declined, papelpay:error ve papelpay:ready ile genel olarak da dinlenebilir; window üzerinde papelship:papelpay:paid gibi CustomEvent olarak da yayılır.

Ödemeyi sunucunuzda doğrulayın

onPaid sayfanıza kartın çekildiğini söyler. Kendiniz bir şey teslim etmeden önce siparişi sunucunuzda doğrulayın: order.completed webhook’unu bekleyin ya da GET /api/v1/invoices/{invoiceId} ile okuyup status değerinin completed olduğunu kontrol edin. Bkz. Webhook’lar.
Kendi iframe sandbox ya da izin politikanızı kullanıyorsanız ödeme özelliklerine izin verin: SDK, cüzdan ödemeleri için çerçevesine allow="payment *" ekler.