Başlangıç
Base URL https://odemev2.ersayazilim.com/
Ödeme Sistemi API Kullanımı
Bu API, ödeme işlemlerini gerçekleştirmek için kullanılır. API'yi kullanmadan önce, aşağıdaki adımları takip ederek hazırlık yapmanız gerekmektedir:
1- API Anahtarları: Ödeme sistemi API'sini kullanabilmek için gerekli olan MerchantId ve MerchantPassword bilgilerine sahip olmalısınız. Bu bilgiler, Ersa Yazılım tarafından sağlanır.
2-Güvenlik: API üzerinden yapılacak ödeme işlemleri hassas bilgiler içerdiğinden, güvenli bir bağlantı (HTTPS) kullanılmalıdır.
3-İstek Formatı: API'ye yapılacak isteklerin, belirtilen JSON formatında ve doğru parametrelerle oluşturulması gerekmektedir.
4-HTML Formu: API'den dönen HTML formu, müşterinin ödeme yapabilmesi için web sayfasına entegre edilmelidir. Bu form, müşteri tarafından doldurulup gönderildiğinde, ödeme işlemi başlatılır.
5-Sonuç Yönlendirmesi: İşlem sonucunda, müşteri otomatik olarak ReturnUrl'de belirtilen adrese yönlendirilir. Bu URL'de, ödeme sonucunun işlenmesi için gerekli işlemler yapılmalıdır.
Bu adımları tamamladıktan sonra, API'yi kullanarak ödeme işlemlerinizi gerçekleştirebilirsiniz.
Base URL
Methodarla kullanacağınız Base URL aşağıdadır :
https://odemev2.ersayazilim.com/
3D Ödeme
(POST)
https://odemev2.ersayazilim.com/Provizyon/OdemeYap
Ersayazılım ödeme entegrasyon sistemi, üye iş yerlerinin web siteleri üzerinden alınan siparişler için kredi kartı bilgilerini güvenli bir şekilde işlemek üzere tasarlanmıştır. Müşteriler, ödeme formunu doldurup gönderdikten sonra doğrudan bankanın ödeme sayfasına yönlendirilirler. Bu aşamada, ödemenin tamamlanması için bir SMS doğrulama kodu gerekebilir. Ödeme işlemi, bankanın ağ geçidi üzerinden güvenli bir şekilde gerçekleştirilir. İşlem başarıyla tamamlandığında ya da bir hata oluştuğunda, müşteriler otomatik olarak belirlenen bir ReturnURL'ye yönlendirilirler. Bu URL, işlem sonucunu (başarılı veya başarısız) üye iş yerine bildirir.
Request example :
{
"CardHolderName": "Ersa Yazılım",
"CardNumber": "5549601111111111",
"CVV": "159",
"ExpireDate": "0326",
"Amount": "1169,00",
"Installment": "2",
"Email": "[email protected]",
"OrderId": "202403111255522541",
"MerchantId": "ersayazilim",
"MerchantPassword": "ersayazilim",
"ReturnUrl": "https://sanalpos.ersayazilim.com.tr/payment/pay/return/202403111255522541/3"
}
Response example :
{
"IsBasarili": "2",
"KartNoMask": "111111******1111",
"IslemID": "someGUID",
"KartUzAd": "Er** Yazı***",
"Tutar": "1169,00",
"SiparisID": "202403111255522541",
"BankaHataID": "00",
"BankaHataMesaj": "İslem Basarili",
"Taksit": 1,
"BankaID": "8"
}
Parametreler
Alan | Tür | Açıklama |
---|---|---|
CardHolderName | String | Kart sahibinin adı soyadı. |
CardNumber | String | Kart numarası. |
CVV | String | Kartın arkasındaki güvenlik kodu. |
ExpireDate | String | Son kullanma tarihi (AyYıl formatında). |
Amount | String | Ödenecek miktar. |
Installment | String | Taksit sayısı. |
OrderId | String | Sipariş numarası. |
MerchantId | String | Mağaza kimliği (Sabit Değer). |
MerchantPassword | String | Mağaza şifresi (Sabit Değer). |
ReturnUrl | String | Ödeme sonrası yönlendirilecek URL. |
SubMerchantId | String | Alt mağaza kimliği (Sabit Değer). |
Ödeme Durumu
(GET)
İşlem durumu sorgulaması için url ve method bilgisi aşağıda verilmiştir.
https://odemev2.ersayazilim.com/Provizyon/PaymentStatus
Request example :
{
"MerchantId": "ErsaYazilim",
"MerchantPassword": "Ersa!*#159756",
"PaymentCode": "202403111255522541",
}
Response example :
{
"PaymentCode": "202403111255522541",
"status": true,
"bank": "Garanti Bankası",
"cardNo": "5440 #### #### 1111",
"cardHolder": "Er** Yaz****",
"installment": 1,
"amount": 6344.1500,
"date": "11.11.2023 00:46:55"
}
Parametreler
Alan | Tür | Açıklama |
---|---|---|
MerchantId | string | Kullanıcı adı. |
MerchantPassword | string | Şifre. |
PaymentCode | string | Ödeme yapılırken iletilen OrderId. |
Bankaları Listele
(GET)
Kayıtlı bankalar ve Id lerini listeler.
https://odemev2.ersayazilim.com/Provizyon/ListBanks
Request example :
{
"MerchantId": "ErsaYazilim",
"MerchantPassword": "Ersa!*#159756",
}
Response example :
{
{"BankId":3,"Bank":"Garanti Bankası"},
{"BankId":4,"Bank":"Akbank"},
{"BankId":5,"Bank":"Finansbank"},
{"BankId":6,"Bank":"İş Bankası"},
{"BankId":7,"Bank":"Yapı Kredi"},
{"BankId":8,"Bank":"Halk Bankası"},
{"BankId":9,"Bank":"Ziraat Bankası"},
{"BankId":33,"Bank":"Sipay"}
}
Parametreler
Alan | Tür | Açıklama |
---|---|---|
MerchantId | string | Kullanıcı adı. |
MerchantPassword | string | Şifre. |
Alternatif Bankaları Listele
(GET)
Ödeme kurumlarının yönlendirildiği kurumları listeler.
https://odemev2.ersayazilim.com/Provizyon/ListAlternativeBanks
Request example :
{
"MerchantId": "ErsaYazilim",
"MerchantPassword": "Ersa!*#159756",
}
Response example :
{
{"BankaId": 3, "AlternativeBankId": null},
{"BankaId": 4, "AlternativeBankId": null},
{"BankaId": 5, "AlternativeBankId": null},
{"BankaId": 6, "AlternativeBankId": null},
{"BankaId": 7, "AlternativeBankId": null},
{"BankaId": 8, "AlternativeBankId": null},
{"BankaId": 9, "AlternativeBankId": null},
{"BankaId": 10, "AlternativeBankId": 7}
}
Parametreler
Alan | Tür | Açıklama |
---|---|---|
MerchantId | string | Kullanıcı adı. |
MerchantPassword | string | Şifre. |
Alternatif Bankaı Güncelle
(POST)
Bİr bankayı başka bir banka veya kuruma yönlendirmek için kullanılır.
https://odemev2.ersayazilim.com/Provizyon/UpdateAlternativeBank
Request example :
{
"MerchantId": "ErsaYazilim",
"MerchantPassword": "Ersa!*#159756",
"bankaId": 7,
"alternativeBankId": 33
}
Response example :
{
{"BankaId": 7, "AlternativeBankId": 33, "Message":"Alternatif Banka Başarıyla Güncellendi"}
}
Parametreler
Alan | Tür | Açıklama |
---|---|---|
MerchantId | string | Kullanıcı adı. |
MerchantPassword | string | Şifre. |
MerchantPassword | GUID | Şifre. |
bankId | short | Yönlendirilmesini istediğiniz banka Id si. |
alternativeBankId | short | Yönlendirilecek banka/kurum Id'si |
Hatalar
The Westeros API uses the following error codes:
Error Code | Meaning |
---|---|
X000 | Some parameters are missing. This error appears when you don't pass every mandatory parameters. |
X001 |
Unknown or unvalid secret_key . This error appears if you use an unknow API key or if your API key expired.
|
X002 |
Unvalid secret_key for this domain. This error appears if you use an API key non specified for your domain. Developper or Universal API keys doesn't have domain checker.
|
X003 |
Unknown or unvalid user token . This error appears if you use an unknow user token or if the user token expired.
|