Ödeme işleminin yaşam döngüsü

Satıcıların ödeme uygulamalarını nasıl entegre ettiğini ve ödeme işlemlerinin Payment Request API ile nasıl çalıştığını öğrenin.

Web Payments API'leri, tarayıcıya ilk kez yerleştirilen özel ödeme özellikleridir. Web Payments ile satıcıların ödeme uygulamalarıyla entegrasyonu daha kolay hale gelirken müşteri deneyimi de daha sorunsuz ve güvenli hale gelir.

Web Payments'ı kullanmanın avantajları hakkında daha fazla bilgi edinmek için Web Payments ile ödeme uygulamalarını güçlendirme başlıklı makaleyi inceleyin.

Bu makalede, satıcı web sitesindeki bir ödeme işlemi adım adım açıklanmakta ve ödeme uygulaması entegrasyonunun işleyiş şekli anlatılmaktadır.

Süreç 6 adımdan oluşur:

  1. Satıcı bir ödeme işlemi başlatır.
  2. Satıcı, ödeme düğmesi gösterir.
  3. Müşteri, ödeme düğmesine basar.

    BobPay (ödeme uygulaması) düğmesi bulunan bir peynir dükkanı web sitesinin diyagramı.

  4. Tarayıcı, ödeme uygulamasını başlatır.

    BobPay uygulamasının bir kalıcı öğede başlatıldığı peynir dükkanı web sitesinin diyagramı. Modülde kargo seçenekleri ve toplam maliyet gösterilir.

  5. Müşteri herhangi bir ayrıntıyı (ör. kargo seçenekleri veya adresi) değiştirirse satıcı, değişikliği yansıtacak şekilde işlem ayrıntılarını günceller.

    BobPay uygulama modülünde farklı bir kargo seçeneği belirleyen müşteriyi gösteren diyagram. Satıcının BobPay'de gösterilen toplam maliyeti güncellediğini gösteren ikinci bir diyagram.

  6. Müşteri satın alma işlemini onayladıktan sonra satıcı ödemeyi doğrular ve işlemi tamamlar.

    Müşterinin, düğmeye basmasını gösteren bir diyagram

1. adım: Satıcı bir ödeme işlemi başlatır

Müşteri satın alma işlemine karar verdiğinde satıcı, bir PaymentRequest nesnesi oluşturarak ödeme işlemini başlatır. Bu nesne, işlemle ilgili önemli bilgiler içerir:

  • İşlemi gerçekleştirmek için kabul edilebilir ödeme yöntemleri ve bunların verileri.
  • Toplam fiyat (gerekli) ve öğelerle ilgili bilgiler gibi ayrıntılar.
  • Satıcıların kargo adresi ve kargo seçeneği gibi kargo bilgilerini isteyebileceği seçenekler.
  • Satıcılar ayrıca fatura adresini, ödeme yapan kişinin adını, e-posta adresini ve telefon numarasını da isteyebilir.
  • Satıcılar, PaymentRequest özelliğine isteğe bağlı kargo türü (shipping, delivery veya pickup) de ekleyebilir. Ödeme uygulaması, kullanıcı arayüzünde doğru etiketleri göstermek için bu bilgiyi kullanabilir.
const request = new PaymentRequest([{
  supportedMethods: 'https://bobpay.xyz/pay',
  data: {
    transactionId: '****'
  }
}], {
  displayItems: [{
    label: 'Anvil L/S Crew Neck - Grey M x1',
    amount: { currency: 'USD', value: '22.15' }
  }],
  total: {
    label: 'Total due',
    amount: { currency: 'USD', value : '22.15' }
  }
}, {
  requestShipping: true,
  requestBillingAddress: true,
  requestPayerEmail: true,
  requestPayerPhone: true,
  requestPayerName: true,
  shippingType: 'delivery'
});
İşlem kimliği ekleme

Bazı ödeme işleyiciler, satıcının işlem bilgilerinin bir parçası olarak önceden verdikleri işlem kimliğini sağlamasını gerektirebilir. Tipik bir entegrasyon, toplam fiyatı rezerve etmek için satıcının ve ödeme işleyicinin sunucusu arasındaki iletişimi içerir. Bu sayede, kötü amaçlı müşterilerin fiyatı değiştirmesi ve işlemin sonunda doğrulama yaparak satıcıyı aldatması önlenir.

Satıcı, PaymentMethodData nesnesinin data özelliğinin bir parçası olarak işlem kimliği iletebilir.

İşlem bilgileri sağlandıktan sonra tarayıcı, ödeme yöntemi tanımlayıcılarına göre PaymentRequest içinde belirtilen ödeme uygulamalarını keşfetme sürecinden geçer. Bu sayede tarayıcı, satıcı işlem yapmaya hazır olduğunda başlatılacak ödeme uygulamasını belirleyebilir.

Keşif sürecinin işleyiş şeklini ayrıntılı olarak öğrenmek için Ödeme yöntemi ayarlama başlıklı makaleyi inceleyin.

2. adım: Satıcı bir ödeme düğmesi gösterir

Satıcılar birçok ödeme yöntemini destekleyebilir ancak yalnızca müşterinin gerçekten kullanabileceği ödeme düğmelerini göstermelidir. Kullanılamayan bir ödeme düğmesi göstermek kötü bir kullanıcı deneyimine neden olur. Satıcı, PaymentRequest nesnesinde belirtilen bir ödeme yönteminin müşteri için çalışmayacağını tahmin edebiliyorsa yedek bir çözüm sunabilir veya bu düğmeyi hiç göstermeyebilir.

Satıcı, PaymentRequest örneğini kullanarak müşterinin ödeme uygulamasını kullanıp kullanamayacağını sorgulayabilir.

Müşterinin ödeme uygulaması var mı?

PaymentRequest'nin canMakePayment() yöntemi, müşterinin cihazında bir ödeme uygulaması varsa true değerini döndürür. "Kullanılabilir", ödeme yöntemini destekleyen bir ödeme uygulamasının bulunduğunu ve platforma özel ödeme uygulamasının yüklü olduğunu veya web tabanlı ödeme uygulamasının kaydedilmeye hazır olduğunu gösterir.

const canMakePayment = await request.canMakePayment();
if (!canMakePayment) {
  // Fallback to other means of payment or hide the button.
}

3. adım: Müşteri, ödeme düğmesine basar.

Müşteri ödeme düğmesine bastığında satıcı, PaymentRequest örneğinin show() yöntemini çağırır. Bu yöntem, ödeme kullanıcı arayüzünün başlatılmasını hemen tetikler.

Nihai toplam fiyat dinamik olarak ayarlanırsa (örneğin, bir sunucudan alınırsa) satıcı, toplam fiyat öğrenilene kadar ödeme kullanıcı arayüzünün başlatılmasını erteleyebilir.

Ödeme kullanıcı arayüzünün başlatılmasını erteleme

Nihai toplam fiyat belirlenene kadar ödeme kullanıcı arayüzünü erteleme ile ilgili demoya göz atın.

Satıcı, ödeme kullanıcı arayüzünü ertelemek için show() yöntemine bir promise iletir. Tarayıcı, promise çözülene ve işlem başlatılmaya hazır olana kadar bir yükleme göstergesi gösterir.

const getTotalAmount = async () => {
  // Fetch the total amount from the server, etc.
};

try {
  const result = await request.show(getTotalAmount());
  // Process the result…
} catch(e) {
  handleError(e);
}

show() için bağımsız değişken olarak belirtilen bir promise yoksa tarayıcı, ödeme kullanıcı arayüzünü hemen başlatır.

4. adım: Tarayıcı, ödeme uygulamasını başlatır

Tarayıcı, platforma özel veya web tabanlı bir ödeme uygulaması başlatabilir. (Chrome'un hangi ödeme uygulamasını başlatacağını nasıl belirlediği hakkında daha fazla bilgi edinebilirsiniz.)

Ödeme uygulamasının nasıl oluşturulacağı büyük ölçüde geliştiriciye bağlıdır ancak satıcıya ve satıcıdan gönderilen etkinliklerin yanı sıra bu etkinliklerle birlikte iletilen verilerin yapısı standartlaştırılmıştır.

Ödeme uygulaması başlatıldığında, 1. adımda PaymentRequest nesnesine iletilen işlem bilgilerini alır. Bu bilgiler şunları içerir:

  • Ödeme yöntemi verileri
  • Toplam fiyat
  • Ödeme seçenekleri

Ödeme uygulaması, kullanıcı arayüzünü etiketlemek için işlem bilgilerini kullanır.

5. adım: Satıcı, müşterinin işlemlerine bağlı olarak işlem ayrıntılarını nasıl güncelleyebilir?

Müşteriler, ödeme uygulamasında ödeme yöntemi ve kargo seçeneği gibi işlem ayrıntılarını değiştirebilir. Müşteri değişiklik yaparken satıcı, değişiklik etkinliklerini alır ve işlem ayrıntılarını günceller.

Satıcıların alabileceği dört tür etkinlik vardır:

  • Ödeme yöntemi değişikliği etkinliği
  • Kargo adresi değişikliği etkinliği
  • Kargo seçeneği değişikliği etkinliği
  • Satıcı doğrulama etkinliği

Ödeme yöntemi değişikliği etkinliği

Bir ödeme uygulaması birden fazla ödeme yöntemini destekleyebilir ve satıcı, müşterinin seçimine bağlı olarak özel bir indirim sunabilir. Bu kullanım alanını kapsamak için ödeme yöntemi değişikliği etkinliği, satıcıyı yeni ödeme yöntemi hakkında bilgilendirebilir. Böylece satıcı, toplam fiyatı indirimle güncelleyip ödeme uygulamasına geri gönderebilir.

request.addEventListener('paymentmethodchange', e => {
  e.updateWith({
    // Add discount etc.
  });
});

Kargo adresi değişikliği etkinliği

Ödeme uygulaması, isteğe bağlı olarak müşterinin kargo adresini sağlayabilir. Bu yöntem, müşteriler için kolaylık sağlar. Formlara manuel olarak bilgi girmeleri gerekmez ve kargo adreslerini birden fazla satıcı web sitesi yerine tercih ettikleri ödeme uygulamalarında saklayabilirler.

Müşteri, işlem başlatıldıktan sonra bir ödeme uygulamasında kargo adresini güncellerse satıcıya 'shippingaddresschange' etkinliği gönderilir. Bu etkinlik, satıcının yeni adrese göre kargo maliyetini belirlemesine, toplam fiyatı güncellemesine ve ödeme uygulamasına döndürmesine yardımcı olur.

request.addEventListener('shippingaddresschange', e => {
  e.updateWith({
    // Update the details
  });
});

Satıcı, güncellenen adrese gönderim yapamıyorsa ödeme uygulamasına döndürülen işlem ayrıntılarına bir hata parametresi ekleyerek hata mesajı verebilir.

Kargo seçeneği değişikliği etkinliği

Satıcı, müşteriye birden fazla kargo seçeneği sunabilir ve bu seçimi ödeme uygulamasına devredebilir. Kargo seçenekleri, müşterinin seçebileceği fiyatların ve hizmet adlarının listesi olarak gösterilir. Örneğin:

  • Standart kargo - Ücretsiz
  • Ekspres kargo: 5 ABD doları

Müşteri, ödeme uygulamasında kargo seçeneğini güncellediğinde satıcıya bir 'shippingoptionchange' etkinliği gönderilir. Satıcı, kargo maliyetini belirleyip toplam fiyatı güncelleyebilir ve ödeme uygulamasına geri gönderebilir.

request.addEventListener('shippingoptionchange', e => {
  e.updateWith({
    // Update the details
  });
});

Satıcı, kargo seçeneklerini müşterinin kargo adresine göre de dinamik olarak değiştirebilir. Bu özellik, satıcılar yurt içi ve yurt dışı müşterilerine farklı kargo seçenekleri sunmak istediğinde kullanışlıdır.

Satıcı doğrulama etkinliği

Ek güvenlik için ödeme uygulaması, ödeme akışına geçmeden önce satıcı doğrulaması yapabilir. Doğrulama mekanizmasının tasarımı ödeme uygulamasına bağlıdır ancak satıcı doğrulama etkinliği, satıcıyı kendisini doğrulamak için kullanabileceği URL hakkında bilgilendirmeye yarar.

request.addEventListener('merchantvalidation', e => {
  e.updateWith({
    // Use `e.validateURL` to validate
  });
});

6. adım: Satıcı, ödemeyi doğrular ve işlemi tamamlar.

Müşteri ödemeyi başarıyla yetkilendirdiğinde show() yöntemi, PaymentResponse olarak çözümlenen bir promise döndürür. PaymentResponse nesnesi aşağıdaki bilgileri içerir:

  • Ödeme sonucu ayrıntıları
  • Gönderim adresi
  • Kargo seçeneği
  • İletişim bilgileri

Bu noktada, tarayıcı kullanıcı arayüzünde işlemin henüz tamamlanmadığını belirten bir yükleme göstergesi gösterilebilir.

Ödeme uygulaması, ödeme hatası nedeniyle sonlandırılırsa show() tarafından döndürülen promise reddedilir ve tarayıcı, ödeme işlemini sonlandırır.

Ödeme işleniyor ve doğrulanıyor

PaymentResponse içindeki details, ödeme uygulamasından döndürülen ödeme kimlik bilgisi nesnesidir. Satıcı, ödemeyi işlemek veya doğrulamak için kimlik bilgisini kullanabilir. Bu kritik sürecin işleyiş şekli, ödeme işleyiciye bağlıdır.

İşlemi tamamlama veya yeniden deneme

Satıcı, işlemin başarılı olup olmadığını belirledikten sonra şunları yapabilir:

  • İşlemi tamamlamak ve yükleme göstergesini kapatmak için .complete() yöntemini çağırın.
  • retry() yöntemini çağırarak müşterinin tekrar denemesini sağlayın.
async function doPaymentRequest() {
  try {
    const request = new PaymentRequest(methodData, details, options);
    const response = await request.show();
    await validateResponse(response);
  } catch (err) {
    // AbortError, SecurityError
    console.error(err);
  }
}

async function validateResponse(response) {
  try {
    const errors = await checkAllValuesAreGood(response);
    if (errors.length) {
      await response.retry(errors);
      return validateResponse(response);
    }
    await response.complete("success");
  } catch (err) {
    // Something went wrong…
    await response.complete("fail");
  }
}
// Must be called as a result of a click
// or some explicit user action.
doPaymentRequest();

Sonraki adımlar