1. Ödeme Başlat
Parçalı ödeme işleminizi bu servis üzerinden başlatabilirsiniz. Tek sepet için çoklu kartla ödeme alabilirsiniz
Ödeme Başlat
POST {{Base Adres}}/api/paywall/payment/start/split
apikeypublic
string
Evet
Üye işyeri panelinden temin etmiş olduğunuz Public Key.
apiclientpublic
string
Evet
Üye işyeri panelinden temin etmiş olduğunuz Public Client.
Servise gönderilecek örnek JSON ve örnek kodlar aşağıdaki gibidir.
{
"PaymentDetail": {
"Amount": 200.00,
"MerchantUniqueCode": "{{$guid}}",
"CurrencyId": 1,
"Installment": 1,
"CallbackAddress": "https://webhook.site/6dbedd75-2e39-47cf-a389-4a2e4b1afdd4", // sadece rollback senaryosu için
"ClientIP": "1.1.1.1",
"Half2D": false,
"ProviderBased": false,
"ProviderKey": "test",
"PosBased": false,
"PosId": 4712,
"AutoRollback": false // İşlemlerden herhangi biri başarısız olursa, başarılı olanlar geri çekilsin mi?
},
"CardModel": 1, // 1: Ecommerce | 2: Insurance
"Payments": [
{
"Customer": {
"FullName": "FullName",
"Phone": "5336662211",
"Email": "[email protected]",
"Country": "Country",
"City": "City",
"Address": "Address",
"IdentityNumber": "11111111111",
"TaxNumber": "TaxNumber"
},
"Product": {
"ProductId": "ProductId",
"ProductName": "ProductName",
"ProductCategory": "ProductCategory",
"ProductDescription": "ProductDescription",
"ProductAmount": 150
},
"Card": {
"OwnerName": "Card Owner 1",
"Number": "5528790000000007", // CardModel 1 için
"ExpireMonth": "12", // CardModel 1 için
"ExpireYear": "2026", // CardModel 1 için
"Cvv": "000", // CardModel 1 için
"CardNoFirst": "", // CardModel 2 için
"CardNoLast": "", // CardModel 2 için
"IdentityNumber": "" // CardModel 2 için
}
},
{
"Customer": {
"FullName": "FullName",
"Phone": "5336662211",
"Email": "[email protected]",
"Country": "Country",
"City": "City",
"Address": "Address",
"IdentityNumber": "11111111111",
"TaxNumber": "TaxNumber"
},
"Product": {
"ProductId": "ProductId",
"ProductName": "ProductName",
"ProductCategory": "ProductCategory",
"ProductDescription": "ProductDescription",
"ProductAmount": 50
},
"Card": {
"OwnerName": "Card Owner 2",
"Number": "5528790000000008", // CardModel 1 için
"ExpireMonth": "12", // CardModel 1 için
"ExpireYear": "2027", // CardModel 1 için
"Cvv": "000", // CardModel 1 için
"CardNoFirst": "", // CardModel 2 için
"CardNoLast": "", // CardModel 2 için
"IdentityNumber": "" // CardModel 2 için
}
}
]
}Ana Dizin
PaymentDetail
PaymentDetail
Evet
Ödeme detaylarının konumlandırılacağı Json nesnesidir
Payments
List<Payment>
Evet
Parçalı ödeme kapsamında alınacak olan ödemelerin yer aldığı liste şeklinde Json nesnesidir
Ana Dizin: PaymentDetail
Amount
string
Evet
Ödeme işleminde tahsil edilecek toplam tutardır.
MerchantUniqueCode
decimal
Evet
Üye işyerine özgü olarak tanımlanan benzersiz bir koddur.
Installement
integer
Evet
Müşterinin ödeme planında seçtiği taksit adedini gösterir.
CallbackAddress
string
Evet
İşlem tamamlandıktan sonra sistemin sonuç bilgisini ileteceği adrestir.
ClientIP
string
Evet
İşlem yapan kullanıcının IP adresini ifade eder.
Half2D
bool
Hayır
Ödemelerinizi özel bir çağrı ile finansallaştırabilmeniz için size destek olacak parametredir. Half2D parametresini true göndermeniz durumunda ödeme bitirme çağrısını siz yapana kadar ödemeniz bankada provizyonda kalacaktır.
ProviderBased
bool
Hayır
Ödemenizin hangi sağlayıcıdan geçmesi gerektiğine kendi tarafınızda karar verdiğinizde kullanılır
ProviderKey
string
Koşullu
Ödemenizin geçmesini istediğiniz sağlayıcı anahtarı
PosBased
bool
Hayır
Ödemenizin hangi sağlayıcıdan geçmesi gerektiğine kendi tarafınızda karar verdiğinizde kullanılır
PosId
int
Koşullu
Ödemenizin geçmesini istediğiniz sağlayıcının bağlantı kimlik numarasıdır. Paywall panelinden temin bağlı sağlayıcılar listesinde yer almaktadır
AutoRollback
bool
Hayır
Parçalı işlemlerden herhangi biri başarısız olursa, başarılı olanlar otomatik olarak geri alınsın mı?
Ana Dizin: Payments
Customer > FullName
string
Evet
Müşteri tam adı
Customer > Phone
string
Evet
Müşteri telefon numarası
Customer > Email
string
Evet
Müşteri e-posta adresi
Customer > Country
string
Evet
Müşteri ülkesi
Customer > City
string
Evet
Müşteri şehir bilgisi
Customer > Address
string
Hayır
Müşteri adres bilgisi
Customer > IdentityNumber
string
Hayır
Müşteri kimlik bilgisi
Customer > TaxNumber
string
Hayır
Müşteri vergi no bilgisi
Product > ProductId
string
Evet
Satışı gerçekleşen ürün kimlik bilgisi
Product > ProductName
string
Evet
Satışı gerçekleşen ürün adı
Product > ProductCategory
string
Evet
Satışı gerçekleşen ürünün kategori bilgisi
Product > ProductDescription
string
Hayır
Satışı gerçekleşen ürünün açıklama bilgisi
Product > ProductAmount
decimal
Evet
Satışı gerçekleşen ürünün tutar bilgisi Not: Tüm ürünlerin tutar bilgilerinin toplamı ana tutara eşit olmalıdır
Card > OwnerName
string
Koşullu
Kart sahibi adı
Card > Number
string
Koşullu
Kart numarası
Card > IdentityNumber
string
Koşullu
Kart sahibi kimlik bilgisi
Card > CardNoFirst
string
Koşullu
Kartın ilk 8 hanesi
Card > CardNoLast
string
Koşullu
Kartın son 4 hanesi
Card > ExpireMonth
string
Koşullu
Kartın son kullanım ay bilgisi
Card > ExpireYear
string
Koşullu
Kartın son kullanım yıl bilgisi
Card > Cvv
string
Koşullu
Kartın CVV bilgisi
Servisten Dönen Cevap:
ErrorCode
int
Hata kodu. İşlem başarılı ise '0' değerini döner.
Result
bool
İşlem başarılı ise true, hatalı ise false döner.
Message
string
İşlemle ilgili bilgi veya hata mesajını içerir.
Body
json
Toplu ödeme işlemine ait detaylı bilgiler.
Servisten Dönen Cevap: Body
SplitPaymentId
int
Parçalı ödeme kimlik bilgisi
MerchantUniqueCode
string
Parçalı ödeme başlatma anında sizin tarafınızdan verilen tekil takip numarası
Status
int
Parçalı ödeme durum bilgisi
Payments
List<Payment>
Parçalı ödeme kapsamında gerçekleşen her işlemin detay bilgisi
Örnek Kod:
{
"ErrorCodeType": 1,
"ErrorMessage": null,
"ErrorCode": 0,
"Result": true,
"Message": "",
"Body": {
"SplitPaymentId": 238,
"MerchantUniqueCode": "65451a10-7e26-4df7-9149-7d6d3d35de56",
"Status": 5,
"Payments": [
{
"PaymentId": 4045720,
"UniqueCode": "90d0b03e-3ab8-418a-aedb-6d808437d43d",
"MerchantUniqueCode": "0c4f61e1-4ee7-4ad3-868a-f7b3e0558434",
"IsSuccessful": true,
"StatusMessage": "Success",
"Error": null
},
{
"PaymentId": 4045721,
"UniqueCode": "5db8b112-6554-48ab-b4f8-9e7b3f85393b",
"MerchantUniqueCode": "6a3c7464-5f9d-4ef3-a8cb-66e17327d743",
"IsSuccessful": false,
"StatusMessage": "Failed",
"Error": null
}
]
}
}Last updated