Pazaryeri Entegrasyonu

Masterpass

Mastercard'ın dijital ödeme çözümü: kullanıcı kart bilgisi girmez, Masterpass'e kayıtlı kartıyla cep telefonu numarası ve SMS onayı üzerinden öder.

Avantajları

• Hızlı ödeme — kart bilgisi girilmez, yalnızca SMS onayı
• Güvenli — kart bilgileri Masterpass tarafından saklanır
• Mobil uyumlu — mobil cihazlarda kolay kullanım
• Kayıtlı kartlar — kullanıcının Masterpass'teki kartları otomatik gelir

CreatePayment (Masterpass)

İstek

Masterpass ödemesinde bankCard bilgileri gönderilmez; bunun yerine gsm zorunludur:

{
  "apiKey": "calculated_api_key",
  "apiSecretKey": "sx_value",
  "gsm": "5321234567",
  "trxCurrency": "TRY",
  "trxAmount": 150.00,
  "trxCode": "ORDER_12345",
  "trxType": "SALES",
  "callbackUrl": "https://yoursite.com/payment-callback",
  "sellerList": [
    { "sellerExternalId": "SELLER_001", "trxAmount": 100.00, "withholdingTax": 0.80 },
    { "sellerExternalId": "SELLER_002", "trxAmount": 50.00, "withholdingTax": 0.40 }
  ],
  "shippingCost": 0.00,
  "otherAmount": 0.00,
  "marketplaceCode": "MP12345"
}

✅ Doğru:  "5321234567"
❌ Yanlış: "+905321234567"
❌ Yanlış: "05321234567" 

Yanıt

Yanıt formatı standart CreatePayment ile aynıdır: refCode, trxCode ve Base64 kodlu form döner; formu decode edip kullanıcıya gösterirsiniz.

İşlem Akışı

1. 1GSM ile başlatınKullanıcı cep numarasını girer, siz CreatePayment/MASTERPASS çağırırsınız.
2. 2Formu gösterinDönen Base64 HTML'i decode edip kullanıcıya render edin.
3. 3Masterpass girişiKullanıcı Masterpass'e giriş yapar, kayıtlı kartları listelenir.
4. 4Kart seçimi + SMS onayıKullanıcı kartını seçer ve SMS kodunu onaylar.
5. 5CallbackSonuç callbackUrl adresinize POST edilir.
6. 6DoğrulamaHash'i doğrulayıp siparişi sonuçlandırırsınız.

const payment = await axios.post(BASE_URL + '/payment/create/MASTERPASS', {
  apiKey,
  apiSecretKey,
  gsm: '5321234567',
  trxCurrency: 'TRY',
  trxAmount: 250.00,
  trxCode: 'ORDER_789',
  trxType: 'SALES',
  callbackUrl: 'https://yoursite.com/payment-callback',
  sellerList: [{ sellerExternalId: 'SELLER_001', trxAmount: 250.00, withholdingTax: 2.00 }],
  shippingCost: 0,
  otherAmount: 0,
  marketplaceCode: 'MP12345'
});

if (payment.data.success && payment.data.data.form) {
  const htmlForm = Buffer.from(payment.data.data.form, 'base64').toString('utf-8');
  // formu kullanıcıya göster
}

Callback İşleme

Standart ödemeyle aynıdır; paymentSystem alanı MASTERPASS değeriyle gelir. Hash doğrulamasını atlamayın. Kullanıcının GSM numarası Masterpass'e kayıtlı değilse, ödeme ekranında kayıt olma seçeneği sunulur.

Masterpass vs Standart Kart

Test Etme

Test için Mastercard'ın sağladığı test GSM numaraları ve Masterpass test hesabına ekleyeceğiniz test kartları kullanılır; ortam olarak apitest.paynkolay.com.tr seçin. Masterpass test hesabı bilgileri için Paynkolay destek ekibine başvurun.

Son güncelleme: 5 Eylül 2026