Skip to main content
Hosted Payment Servisi, ödeme sürecinin 1000pay tarafından barındırılan güvenli bir ödeme sayfası üzerinden gerçekleştirilmesini sağlar. Bu servis HTTP Form POST yöntemiyle çalışır ve çağrı sonucunda bir paymentUrl üretilir. Oluşturulan paymentUrl aracılığıyla kullanıcı ödeme sayfasına yönlendirilir ve kart bilgileri doğrudan bu sayfa üzerinden girilerek ödeme işlemi güvenli şekilde tamamlanır. İstek Tipi: application/json

​
Tablo 5.51. Hosted Payment Servisi Girdi Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
orderIdstringİşlem benzersiz değeriEvet
amountdecimalİşlem tutarıEvet
currencyintPara birimiEvet
commissionFromCustomerboolean (true/false)Komisyonun müşteriden alınıp alınmayacağını gösteren değerEvet
is3dRequiredboolean (true/false)3D’li işlem durumuEvet
callbackUrlstringİşlemin sonuçlandığı bilgisinin iletileceği adresEvet
returnUrlstringİşlemin sonuçlandığı bilgisinin iletileceği adresEvet
namestringİşlem sahibi adıEvet
surnamestringİşlem sahibi soyadıEvet
emailstringİşlem sahibi emailiEvet
phoneNumerstringİşlem sahibi telefon numarasıEvet
clientIpAddressstringÜye iş yeri IP adresiEvet
languageCodestringCevabın alınacağı dil bilgisi (default: TR)Hayır
enableInstallmentsboolean (true/false)Taksit kullanım durumuHayır
installmentslistCardNetwork’e göre belirlenen taksit tutarları listesiHayır
(cardNetwork - amount - installment)
pageViewTypestringSayfa görüntüleme türüEvet

​
Tablo 5.48. LinkProvision Servisi Örnek Request

{
  "orderId": "123123123",
  "amount": 55,
  "currency": 949,
  "is3dRequired": false,
  "callbackUrl": "www.google.com",
  "returnUrl": "www.google.com",
  "name": "İsim",
  "surname": "Soyisim",
  "email": "[email protected]",
  "phoneNumer": "5555555555",
  "clientIpAddress": "127.0.0.1",
  "languageCode": "TR",
  "commissionFromCustomer": false,
  "enableInstallments": true,
  "installments": [
    {
      "cardNetwork": "Unknown",
      "amount": null,
      "installment": 3
    },
    {
      "cardNetwork": "Bonus",
      "amount": null,
      "installment": 4
    }
  ],
  "pageViewType": "Redirect"
}

​
Tablo 5.53. Hosted Payment Servis Çıktı Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
conversationIdstringÜye iş yeri benzersiz değeriEvet
isSucceededboolean (true/false)İşlem durumuEvet
errorCodestringHata koduEvet
errorMessagestringHata mesajıEvet
paymentUrlstringKullanıcıyı Hosted Payment sayfasına yönlendirecek URLEvet
trackingIdstringİşlemin takip edilmesi için kullanılacak IDEvet
expiryDatedatetimeİşlem için verilen URL’in geçerlilik süresiEvet
languageCodestringCevabın alınacağı dil bilgisi (default: TR)Evet
pageViewTypestringSayfa görüntüleme türüEvetHayır

​
Tablo 5.54. Hosted Payment Örnek Response

{
  "paymentUrl": "http://10.222.21.16:4203/hosted-payment/ThrbWZpgKyyzLqpbwKFJvHsD?pageView=Redirect",
  "trackingId": "ThrbWZpgKyyzLqpbwKFJvHsD",
  "expiryDate": "2024-04-19T17:20:59.1813451+03:00",
  "languageCode": "TR",
  "pageViewType": "Redirect",
  "isSucceeded": true,
  "errorCode": null,
  "errorMessage": null,
  "conversationId": "933207676"
}

​
Hosted Payment Sorgulama

Hosted Payment Sorgulama servisi, HTTP Form GET yöntemi ile çalışır ve başlatılmış bir Hosted Payment işleminin durumunu sorgulamak için kullanılır. Sorgulama işlemi, Hosted Payment başlatılırken oluşturulan trackingId üzerinden gerçekleştirilir. Örnek Kullanım: baseUrl/v1/HostedPayment/trackingId

​
Tablo 5.55. Hosted Payment Sorgulama Servisi Girdi Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
clientIpAddressstringÜye iş yeri IP adresiEvet
publicKeystringÜye iş yeri açık anahtarıEvet
noncestringZaman damgasıEvet
signaturestringKimlik anahtar değeriEvet
conversationIdstringÜye iş yeri benzersiz değeriEvet
merchantNumberstringÜye iş yeri numarasıEvet
trackingIdstringİşlem başlatılırken alınan trackingId değeriEvet

​
Tablo 5.56. Hosted Payment Sorgulama Servisi Header Örneği

KeyValue
clientIpAddress192.1.1.0
publicKeypublicKey
noncenonce
signaturesignature
conversationIdconversationId
merchantNumbermerchantNumber
trackingIdVDJxalkXbwUSFIMPrsAIbeM

​
Tablo 5.57. Hosted Payment Sorgulama Servisi Çıktı Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
conversationIdstringÜye iş yeri benzersiz değeriEvet
isSucceededboolean (true/false)İşlem durumuEvet
errorCodestringHata koduEvet
errorMessagestringHata mesajıEvet
trackingIdstringİşlemin takip edilmesi için kullanılacak IDEvet
expiryDatedate timeİşlem için verilen URL’in geçerlilik süresiEvet
hppStatusstringİşlemin aktif ya da pasif olma durumunu gösteren değerEvet
hppPaymentStatusstringİşlemin ödeme durumuEvet
webhookStatusstringWebhook durumuEvet
originalOrderIdstringOrijinal işlemin benzersiz değeriEvet
amountdecimalİşlem tutarıEvet
currencyintegerİşlem para birimiEvet
commissionFromCustomerboolean (true/false)Müşteriden komisyon alınma durumuEvet
is3dRequiredboolean (true/false)3D’li işlem durumuEvet
callbackUrlstringİşlemin sonuçlandığı bilgisinin iletileceği adresEvet
returnUrlstringİşlemin sonuçlandığı bilgisinin iletileceği adresEvet
namestringİşlem sahibi adıEvet
surnamestringİşlem sahibi soyadıEvet
emailstringİşlem sahibi emailiEvet
phoneNumerstringİşlem sahibi telefon numarasıEvet
clientIpAddressstringÜye iş yeri IP adresiEvet
merchantIdstringÜye iş yeri benzersiz değeriEvet
merchantNamestringÜye iş yeri ismiEvet
merchantNumberstringÜye iş yeri koduEvet
webhookRetryCountstringWebhook deneme sayısıEvet
pageViewTypestringSayfa görüntüleme türüEvet
merchantInstallmentsstringÜye iş yeri taksit bilgileriEvet
transactionTypestringİşlem tipiEvet
transactionDatestringİşlem tarihiEvet
languageCodestringCevabın alınacağı dil bilgisi (default: TR)Evet
orderIdstringİşlem benzersiz değeriEvet
installmentCountintegerİşleme ait taksit değeriHayır
transactionStatusstringİşlem durumu (Pending / Fail / Success / Returned / PartiallyReturned / Reversed / Closed / PartiallyClosed)Evet
cardNumberstringKart numarasıEvet
cardBrandstringKart markası (Undefined / JCB / UnionPay / Maestro / Amex / Visa / Troy / Master / Discover / Diners)Evet
cardNetworkstringKart ağı (Unknown / CardFinans / MilesSmiles / World / Paraf / Maximum / Axess / AsyaCard / Advantage / Bonus / BankKartCombo)Evet
cardTypestringKart tipi (Unknown / Credit / Debit / Prepaid)Evet
is3dsboolean (true/false)İşlemin 3D Secure bilgisiEvet
issuerBankCodeintegerKartın bankasına ait kodEvet
trackingIdstringİşlem başlatılırken alınan trackingId değeriEvet
{
  "trackingId": "VDJxqlkXbwUSFIMPprsAIbeM",
  "hppStatus": "Passive",
  "hppPaymentStatus": "Success",
  "webhookStatus": "Pending",
  "originalOrderId": "123723126",
  "amount": 12.0,
  "currency": 949,
  "commissionFromCustomer": false,
  "is3dRequired": false,
  "callbackUrl": "www.google.com",
  "returnUrl": "www.google.com",
  "name": "İsim",
  "surname": "Soyisim",
  "email": "[email protected]",
  "phoneNumer": "5555555555",
  "clientIpAddress": "127.0.0.1",
  "languageCode": "TR",
  "expiryDate": "2024-04-24T15:37:14.57945",
  "merchantId": "e7071911-320d-4c25-89e6-4bcd9a2ccaea",
  "merchantName": "OPET/BASPET PETROL TURIZM",
  "merchantNumber": "1100000204",
  "webhookRetryCount": 1,
  "pageViewType": "Redirect",
  "merchantInstallments": [],
  "transactionType": "Auth",
  "transactionDate": "2024-04-24T15:32:52.421869",
  "orderId": "123723126000001383405800",
  "installmentCount": 0,
  "paymentConversationId": "123723126000001383405800",
  "transactionStatus": "Success",
  "cardNumber": "411979******4284",
  "cardType": "Credit",
  "cardBrand": "Visa",
  "cardNetwork": "World",
  "is3ds": false,
  "issuerBankCode": 15,
  "isSucceeded": true,
  "errorCode": null,
  "errorMessage": null,
  "conversationId": null
}