Payment3DWithEventRedirect

3D Secure kimlik doğrulama işlemi sırasında kullanıcı, bankanın kimlik doğrulama sayfasına yönlendirilir ve burada doğrulama bilgilerini girer. Bu bilgilerin doğrulanması sonrasında, bankadan gelen doğrulama sonucu FormPost yöntemiyle önceden belirlenmiş okUrl & failUrl iletilir.

İşlem sonucunda okUrl & failUrl direkt yönlendirme gerçekleşir.

URL

POST /api/Payment/Payment3DWithEventRedirect

Servise gönderilen parametreler şu şekildedir:

Parametre

Tip

Uzunluk

Zorunluluk

Açıklama

cardNumber

string

Evet

Kart numarası

expiryDateMonth

string

Evet

Kartın son kullanım tarihinin ayı

expiryDateYear

string

Evet

Kartın son kullanım tarihinin yılı

cvv

string

Evet

Kart güvenlik kodu

cardHolderName

string

Evet

Kart sahibinin adı/soyadı

merchantId

int

Evet

Üye işyeri numarası

totalAmount

string

Evet

Ödeme yapılacak tutar

memberId

int

Evet

Üye Id

userCode

string

Evet

Kullanıcı bilgisi

txnType

string

Evet

txnType

installmentCount

string

Evet

Taksit sayısı

currency

string

Evet

Ödemenin tahsil edileceği para birimi

orderId

string

Evet

Üye işyeri tarafındaki, ödemeye ilişkin sipariş numarasıdır. Sorgulama servislerinde bu id ile sorgulama yapabilirsiniz.

rnd

string

Evet

Hash hesaplamasında kullanılan random numaradır.

hash

string

2048

Evet

İşlemin güvenliği için oluşturulan hash bilgisidir.

webUrl

string

255

Evet

webUrl

description

string

255

Evet

Açıklama

requestIp

string

Evet

İstek Ip Adresi

okUrl

string

255

Evet

İşlem başarılı olursa yönlendirilecek url

failUrl

string

255

Evet

İşlem başarısız olursa yönlendirilecek url

Servisten dönen parametreler şu şekildedir:

Parametre

Tip

Uzunluk

Açıklama

isSuccess

boolean

İşlem başarılı (true) ; işlem başarısız (false) bilgisi döner

message

string

255

isSuccess: true olması durumunda "İşlem başarılıdır." ; false olması durumunda alınan hata mesajı gelmektedir.

errorCode

string

isSuccess: true olması durumunda null ; false olması durumunda alınan hata codu gelmektedir.

requestId

string

Sistem tarafından isteğe ait unique ID bilgisidir.

data

array

Dizi olarak aşağıdaki parametreler dönmektedir

Örnek JSON formatında istek ve cevap aşağıdaki gibidir:

İstek

{
"cardNumber": "4155650100416111",
  "expiryDateMonth": "01",
  "expiryDateYear": "2050",
  "cvv": "715",
  "cardHolderName": "Burak Altun",
  "merchantId": 97163,
  "totalAmount": "1000",
  "memberId": 1,
  "userCode": "asmglr17@gmail.com",
  "txnType": "Auth",
  "installmentCount": "0",
  "currency": "949",
  "orderId": "{{$guid}}",
  "rnd": "2023031321541332",
  "hash": "2023031321541332",
  "webUrl": "google.com",
  "description": "deneme",
  "requestIp": "string",
  "okUrl": "https://webhook.site/83dd8625-e5c2-40fb-8fda-0326bc4dcad9",
  "failUrl": "https://webhook.site/83dd8625-e5c2-40fb-8fda-0326bc4dcad9"
}

Cevap

Bankadan dönen html otp formu isteği başarılı olması durumunda okUrl'e; başarısız olması durumunda failUrl'e aşağıdaki istek gönderilmektedir.

{
    "isSuccess": true,
    "message": "İşlem başarılıdır.",
    "errorCode": null,
    "requestId": "3c4aed99-0bb8-4067-8806-519f23acd4d5",
    "data": "\r\n\r\n<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\r\n<html xmlns=\"http://www.w3.org/1999/xhtml\">\r\n<head id=\"Head1\"><title>\r\n\tPayment MPI Service\r\n</title></head>\r\n<body>\r\n    <form method=\"post\" action=\"./Default.aspx\" id=\"step1Form\">\r\n<div class=\"aspNetHidden\">\r\n<input type=\"hidden\" name=\"PaReq\" id=\"PaReq\" value=\"eJxVUk1vgzAM/Suo54k4ISlQuZHYQBoHuqplhx4ZjVqmAS2Etd2vX9KWfUSK5Gc7z/ZzMN93SsVrVQ6dkpipvi92yqm288nUC0QIIgBBgXnAPTaRuIxW6ijxU3V91TaSuuAyJCM077tyXzRaYlEeH9OF5MCY7yO5Q6xVl8YSAuHB7YQiNOGbG5uiVtKLnTxZ587rJnHS9SZZpUiuASzbodHdRfqhqTkCHLoPudf6MCPkdDq5x+ZNq167ZVsjsTEkv10tB2v1hutcbWX2Hl0WccSzPD1neQmsuxrR1/yaI7EZuC20EoyYBwCyhxKZ5TPKEVy9WNR2yYkhQcAJ19tzJw3Dx5soWgMAyD560Gjdqea8iJDHppRRoTqfGgbZTLMgD82kt+2n56ttKU2anEqxFSAYed0Sik1awKfM+FZta8Zlq4yEgkAeuWzAInlIPdFkvvGjfXvJ3wDNHGpbw==\" />\r\n<input type=\"hidden\" name=\"TermUrl\" id=\"TermUrl\" value=\"https://vpostest.qnbfinansbank.com/Gateway/Mpi/FromMPIToGateway.aspx?AcctId=e574db4f74f34b78a6f7350e6f9f0a60\" />\r\n<input type=\"hidden\" name=\"MD\" id=\"MD\" value=\"UGF5bWVudFZQT1NEYXRhPUVCQjA5Q0U0QkE1MUU0QkVENEIyMkYxQjI4RTE1RUQw\" />\r\n\r\n</div>\r\n\r\n<script type='text/javascript'>var frm = document.getElementById('step1Form');frm.action = 'https://vpostest.qnbfinansbank.com/PayforACSSimulator/Default.aspx' ;frm.method = \"POST\";frm.submit();</script>\r\n    \r\n<div class=\"aspNetHidden\">\r\n\r\n\t<input type=\"hidden\" name=\"__VIEWSTATEGENERATOR\" id=\"__VIEWSTATEGENERATOR\" value=\"BFED9D85\" />\r\n</div></form>\r\n</body>\r\n</html>\r\n"
}

PreviousPayment 3d NextPayment3dBySecure

Last updated 8 months ago

Was this helpful?

URL

POST /api/Payment/Payment3DWithEventRedirect

Servise gönderilen parametreler şu şekildedir:

Parametre

Tip

Uzunluk

Zorunluluk

Açıklama

cardNumber

string

Evet

Kart numarası

expiryDateMonth

string

Evet

Kartın son kullanım tarihinin ayı

expiryDateYear

string

Evet

Kartın son kullanım tarihinin yılı

cvv

string

Evet

Kart güvenlik kodu

cardHolderName

string

Evet

Kart sahibinin adı/soyadı

merchantId

int

Evet

Üye işyeri numarası

totalAmount

string

Evet

Ödeme yapılacak tutar

memberId

int

Evet

Üye Id

userCode

string

Evet

Kullanıcı bilgisi

txnType

string

Evet

txnType

installmentCount

string

Evet

Taksit sayısı

currency

string

Evet

Ödemenin tahsil edileceği para birimi

orderId

string

Evet

Üye işyeri tarafındaki, ödemeye ilişkin sipariş numarasıdır. Sorgulama servislerinde bu id ile sorgulama yapabilirsiniz.

rnd

string

Evet

Hash hesaplamasında kullanılan random numaradır.

hash

string

2048

Evet

İşlemin güvenliği için oluşturulan hash bilgisidir.

webUrl

string

255

Evet

webUrl

description

string

255

Evet

Açıklama

requestIp

string

Evet

İstek Ip Adresi

okUrl

string

255

Evet

İşlem başarılı olursa yönlendirilecek url

failUrl

string

255

Evet

İşlem başarısız olursa yönlendirilecek url

Servisten dönen parametreler şu şekildedir:

Parametre

Tip

Uzunluk

Açıklama

isSuccess

boolean

İşlem başarılı (true) ; işlem başarısız (false) bilgisi döner

message

string

255

isSuccess: true olması durumunda "İşlem başarılıdır." ; false olması durumunda alınan hata mesajı gelmektedir.

errorCode

string

isSuccess: true olması durumunda null ; false olması durumunda alınan hata codu gelmektedir.

requestId

string

Sistem tarafından isteğe ait unique ID bilgisidir.

data

array

Dizi olarak aşağıdaki parametreler dönmektedir

Örnek JSON formatında istek ve cevap aşağıdaki gibidir:

İstek

{
"cardNumber": "4155650100416111",
  "expiryDateMonth": "01",
  "expiryDateYear": "2050",
  "cvv": "715",
  "cardHolderName": "Burak Altun",
  "merchantId": 97163,
  "totalAmount": "1000",
  "memberId": 1,
  "userCode": "asmglr17@gmail.com",
  "txnType": "Auth",
  "installmentCount": "0",
  "currency": "949",
  "orderId": "{{$guid}}",
  "rnd": "2023031321541332",
  "hash": "2023031321541332",
  "webUrl": "google.com",
  "description": "deneme",
  "requestIp": "string",
  "okUrl": "https://webhook.site/83dd8625-e5c2-40fb-8fda-0326bc4dcad9",
  "failUrl": "https://webhook.site/83dd8625-e5c2-40fb-8fda-0326bc4dcad9"
}

Cevap

Bankadan dönen html otp formu isteği başarılı olması durumunda okUrl'e; başarısız olması durumunda failUrl'e aşağıdaki istek gönderilmektedir.

{
    "isSuccess": true,
    "message": "İşlem başarılıdır.",
    "errorCode": null,
    "requestId": "3c4aed99-0bb8-4067-8806-519f23acd4d5",
    "data": "\r\n\r\n<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\r\n<html xmlns=\"http://www.w3.org/1999/xhtml\">\r\n<head id=\"Head1\"><title>\r\n\tPayment MPI Service\r\n</title></head>\r\n<body>\r\n    <form method=\"post\" action=\"./Default.aspx\" id=\"step1Form\">\r\n<div class=\"aspNetHidden\">\r\n<input type=\"hidden\" name=\"PaReq\" id=\"PaReq\" value=\"eJxVUk1vgzAM/Suo54k4ISlQuZHYQBoHuqplhx4ZjVqmAS2Etd2vX9KWfUSK5Gc7z/ZzMN93SsVrVQ6dkpipvi92yqm288nUC0QIIgBBgXnAPTaRuIxW6ijxU3V91TaSuuAyJCM077tyXzRaYlEeH9OF5MCY7yO5Q6xVl8YSAuHB7YQiNOGbG5uiVtKLnTxZ587rJnHS9SZZpUiuASzbodHdRfqhqTkCHLoPudf6MCPkdDq5x+ZNq167ZVsjsTEkv10tB2v1hutcbWX2Hl0WccSzPD1neQmsuxrR1/yaI7EZuC20EoyYBwCyhxKZ5TPKEVy9WNR2yYkhQcAJ19tzJw3Dx5soWgMAyD560Gjdqea8iJDHppRRoTqfGgbZTLMgD82kt+2n56ttKU2anEqxFSAYed0Sik1awKfM+FZta8Zlq4yEgkAeuWzAInlIPdFkvvGjfXvJ3wDNHGpbw==\" />\r\n<input type=\"hidden\" name=\"TermUrl\" id=\"TermUrl\" value=\"https://vpostest.qnbfinansbank.com/Gateway/Mpi/FromMPIToGateway.aspx?AcctId=e574db4f74f34b78a6f7350e6f9f0a60\" />\r\n<input type=\"hidden\" name=\"MD\" id=\"MD\" value=\"UGF5bWVudFZQT1NEYXRhPUVCQjA5Q0U0QkE1MUU0QkVENEIyMkYxQjI4RTE1RUQw\" />\r\n\r\n</div>\r\n\r\n<script type='text/javascript'>var frm = document.getElementById('step1Form');frm.action = 'https://vpostest.qnbfinansbank.com/PayforACSSimulator/Default.aspx' ;frm.method = \"POST\";frm.submit();</script>\r\n    \r\n<div class=\"aspNetHidden\">\r\n\r\n\t<input type=\"hidden\" name=\"__VIEWSTATEGENERATOR\" id=\"__VIEWSTATEGENERATOR\" value=\"BFED9D85\" />\r\n</div></form>\r\n</body>\r\n</html>\r\n"
}